Enum bdk::blockchain::any::AnyBlockchain

source Â· [−]

pub enum AnyBlockchain {
     Electrum(Box<ElectrumBlockchain>),
     Esplora(Box<EsploraBlockchain>),
     CompactFilters(Box<CompactFiltersBlockchain>),
+    Rpc(Box<RpcBlockchain>),
 }

Expand description

Type that can contain any of the Blockchain types defined by the library

It allows switching backend at runtime

See this moduleâs documentation for a usage example.

Variants

`Electrum(Box<ElectrumBlockchain>)`

This is supported on crate feature electrum only.

Electrum client

`Esplora(Box<EsploraBlockchain>)`

This is supported on crate feature esplora only.

Esplora client

`CompactFilters(Box<CompactFiltersBlockchain>)`

This is supported on crate feature compact_filters only.

Compact filters client

`Rpc(Box<RpcBlockchain>)`

This is supported on crate feature rpc only.

RPC client

Trait Implementations

source

impl Blockchain for AnyBlockchain

source

fn get_capabilities(&self) -> HashSet<Capability>

Return the set of Capability supported by this backend

source

fn broadcast(&self, tx: &Transaction) -> Result<(), Error>

Broadcast a transaction

source

fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>

Estimate the fee rate required to confirm a transaction in a given target of blocks

@@ -24,6 +26,7 @@

source

impl From<CompactFiltersBlockchain> for AnyBlockchain

source

fn from(inner: CompactFiltersBlockchain) -> Self

Performs the conversion.

source

impl From<ElectrumBlockchain> for AnyBlockchain

source

fn from(inner: ElectrumBlockchain) -> Self

Performs the conversion.

source

impl From<EsploraBlockchain> for AnyBlockchain

source

fn from(inner: EsploraBlockchain) -> Self

Performs the conversion.

source

impl From<RpcBlockchain> for AnyBlockchain

source

fn from(inner: RpcBlockchain) -> Self

Performs the conversion.

source

impl GetBlockHash for AnyBlockchain

source

fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>

fetch block hash given its height

source

impl GetHeight for AnyBlockchain

source

fn get_height(&self) -> Result<u32, Error>

Return the current height

source

impl GetTx for AnyBlockchain

source

fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>

Fetch a transaction given its txid

@@ -32,7 +35,7 @@

Auto Trait Implementations

impl !RefUnwindSafe for AnyBlockchain

impl !UnwindSafe for AnyBlockchain

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable Â· source

pub fn into(self) -> U

Performs the conversion.

impl<T> Pointable for T

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/any/enum.AnyBlockchainConfig.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/any/enum.AnyBlockchainConfig.html index 79fca7faa6..a3a8b95eee 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/any/enum.AnyBlockchainConfig.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/any/enum.AnyBlockchainConfig.html @@ -4,12 +4,13 @@

AnyBlockchainConfig

Enum bdk::blockchain::any::AnyBlockchainConfig

source Â· [−]

pub enum AnyBlockchainConfig {
     Electrum(ElectrumBlockchainConfig),
     Esplora(EsploraBlockchainConfig),
     CompactFilters(CompactFiltersBlockchainConfig),
+    Rpc(RpcConfig),
 }

Expand description

Type that can contain any of the blockchain configurations defined by the library

This allows storing a single configuration that can be loaded into an AnyBlockchain instance. Wallets that plan to offer users the ability to switch blockchain backend at runtime @@ -39,6 +40,7 @@ will find this particularly useful.

Variants

`Electrum(ElectrumBlockchainConfig)`

This is supported on crate feature electrum only.

Electrum client

`Esplora(EsploraBlockchainConfig)`

This is supported on crate feature esplora only.

Esplora client

`CompactFilters(CompactFiltersBlockchainConfig)`

This is supported on crate feature compact_filters only.

Compact filters client

`Rpc(RpcConfig)`

This is supported on crate feature rpc only.

RPC client configuration

Trait Implementations

source

impl Clone for AnyBlockchainConfig

source

fn clone(&self) -> AnyBlockchainConfig

Returns a copy of the value. Read more

1.0.0 Â· source

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

source

impl Debug for AnyBlockchainConfig

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

@@ -46,6 +48,7 @@ will find this particularly useful.

source

impl From<CompactFiltersBlockchainConfig> for AnyBlockchainConfig

source

fn from(inner: CompactFiltersBlockchainConfig) -> Self

Performs the conversion.

source

impl From<ElectrumBlockchainConfig> for AnyBlockchainConfig

source

fn from(inner: ElectrumBlockchainConfig) -> Self

Performs the conversion.

source

impl From<EsploraBlockchainConfig> for AnyBlockchainConfig

source

fn from(inner: EsploraBlockchainConfig) -> Self

Performs the conversion.

source

impl From<RpcConfig> for AnyBlockchainConfig

source

fn from(inner: RpcConfig) -> Self

Performs the conversion.

source

impl PartialEq<AnyBlockchainConfig> for AnyBlockchainConfig

source

fn eq(&self, other: &AnyBlockchainConfig) -> bool

This method tests for self and other values to be equal, and is used by ==. Read more

source

fn ne(&self, other: &AnyBlockchainConfig) -> bool

This method tests for !=.

@@ -53,7 +56,7 @@ by ==.

source

impl StructuralPartialEq for AnyBlockchainConfig

Auto Trait Implementations

impl RefUnwindSafe for AnyBlockchainConfig

impl Send for AnyBlockchainConfig

impl Sync for AnyBlockchainConfig

impl Unpin for AnyBlockchainConfig

impl UnwindSafe for AnyBlockchainConfig

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable Â· source

pub fn into(self) -> U

Performs the conversion.

impl<T> Pointable for T

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/compact_filters/struct.Mempool.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/compact_filters/struct.Mempool.html index a8f5f069d5..10d2e44f5c 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/compact_filters/struct.Mempool.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/compact_filters/struct.Mempool.html @@ -15,7 +15,7 @@ duplicated in memory.

peers. To do that, broadcast should be used.

source

pub fn get_tx(&self, inventory: &Inventory) -> Option<Transaction>

Look-up a transaction in the mempool given an [Inventory] request

source

pub fn has_tx(&self, txid: &Txid) -> bool

Return whether or not the mempool contains a transaction with a given txid

source

pub fn iter_txs(&self) -> Vec<Transaction>

Return the list of transactions contained in the mempool

source

pub fn iter_txs(&self) -> Vec<Transaction>â
Notable traits for Vec<u8, A>
`impl<A> Write for Vec<u8, A> where A: Allocator,`

Return the list of transactions contained in the mempool

Trait Implementations

source

impl Debug for Mempool

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Default for Mempool

source

fn default() -> Mempool

Returns the âdefault valueâ for a type. Read more

Auto Trait Implementations

impl RefUnwindSafe for Mempool

impl Send for Mempool

impl Sync for Mempool

impl Unpin for Mempool

impl UnwindSafe for Mempool

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/blocking/struct.EsploraBlockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/blocking/struct.EsploraBlockchain.html new file mode 100644 index 0000000000..9e118ac7a5 --- /dev/null +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/blocking/struct.EsploraBlockchain.html @@ -0,0 +1,11 @@ + + + + + Redirection + + +

Redirecting to ../../../../bdk/blockchain/esplora/struct.EsploraBlockchain.html...

+ + + \ No newline at end of file diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/enum.EsploraError.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/enum.EsploraError.html index b48efd9211..303743dbda 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/enum.EsploraError.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/enum.EsploraError.html @@ -1,12 +1,12 @@ -EsploraError in bdk::blockchain::esplora - Rust +EsploraError in bdk::blockchain::esplora - Rust

EsploraError

Enum bdk::blockchain::esplora::EsploraError

source Â· [−]

pub enum EsploraError {
+    Enum bdk::blockchain::esplora::EsploraError
[−]

pub enum EsploraError {
     Ureq(Error),
     UreqTransport(Transport),
     HttpResponse(u16),
@@ -18,7 +18,7 @@
     TransactionNotFound(Txid),
     HeaderHeightNotFound(u32),
     HeaderHashNotFound(BlockHash),
-}

This is supported on crate feature esplora only.

Expand description

Errors that can happen during a sync with EsploraBlockchain

+}

This is supported on crate feature esplora only.

Expand description

Errors that can happen during a sync with Esplora

Variants

`Ureq(Error)`

Error during ureq HTTP request

`UreqTransport(Transport)`

Transport error during the ureq HTTP call

`HttpResponse(u16)`

HTTP response error

@@ -30,20 +30,20 @@

`TransactionNotFound(Txid)`

Transaction not found

`HeaderHeightNotFound(u32)`

Header height not found

`HeaderHashNotFound(BlockHash)`

Header hash not found

Trait Implementations

source

impl Debug for EsploraError

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Display for EsploraError

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Error for EsploraError

1.30.0 Â· source

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any. Read more

Trait Implementations

impl Debug for Error

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more

impl Display for Error

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more

impl Error for Error

1.30.0 Â· source

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any. Read more

source

fn backtrace(&self) -> Option<&Backtrace>

ð¬ This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred. Read more

1.0.0 Â· source

fn description(&self) -> &str

ð Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 Â· source

fn cause(&self) -> Option<&dyn Error>

ð Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

source

impl From<Error> for EsploraError

source

fn from(e: Error) -> Self

Performs the conversion.

source

impl From<Error> for EsploraError

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for EsploraError

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for EsploraError

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<EsploraError> for Error

source

fn from(other: EsploraError) -> Self

Performs the conversion.

source

impl From<ParseIntError> for EsploraError

source

fn from(err: ParseIntError) -> Self

Performs the conversion.

source

impl From<Transport> for EsploraError

source

fn from(err: Transport) -> Self

Performs the conversion.

Auto Trait Implementations

impl !RefUnwindSafe for EsploraError

impl Send for EsploraError

impl Sync for EsploraError

impl Unpin for EsploraError

impl !UnwindSafe for EsploraError

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl From<Error> for Error

pub fn from(err: Error) -> Error

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Error

Performs the conversion.

impl From<Error> for Error

pub fn from(err: Error) -> Error

Performs the conversion.

impl From<Error> for Error

pub fn from(e: Error) -> Error

Performs the conversion.

source

impl From<Error> for Error

source

fn from(other: EsploraError) -> Self

Performs the conversion.

impl From<ParseIntError> for Error

pub fn from(err: ParseIntError) -> Error

Performs the conversion.

impl From<Transport> for Error

pub fn from(err: Transport) -> Error

Performs the conversion.

Auto Trait Implementations

impl !RefUnwindSafe for Error

impl Send for Error

impl Sync for Error

impl Unpin for Error

impl !UnwindSafe for Error

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/index.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/index.html index 9bc954ef15..0131ee26aa 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/index.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/index.html @@ -6,7 +6,7 @@ logo

Module esplora

Module bdk::blockchain::esplora

source Â· [−]

This is supported on crate feature esplora only.

Expand description

Esplora

Module bdk::blockchain::esplora

source Â· [−]

This is supported on crate feature esplora only.

Expand description

Esplora

This module defines a EsploraBlockchain struct that can query an Esplora backend populate the walletâs database by:

Example

@@ -14,13 +14,12 @@ backend populate the walletâs dat

Esplora blockchain can use either ureq or reqwest for the HTTP client depending on your needs (blocking or async respectively).

Please note, to configure the Esplora HTTP client correctly use one of: -Blocking: âfeatures=âesplora,ureqâ -Async: âfeatures=âasync-interface,esplora,reqwestâ âno-default-features

+Blocking: âfeatures=âuse-esplora-blockingâ +Async: âfeatures=âasync-interface,use-esplora-asyncâ âno-default-features

Structs

EsploraBlockchain

Structure that implements the logic to sync with Esplora

EsploraBlockchainConfig

Configuration for an EsploraBlockchain

UrlClient

Structure encapsulates ureq Esplora client

Enums

EsploraError

Errors that can happen during a sync with EsploraBlockchain

EsploraError

Errors that can happen during a sync with Esplora

\ No newline at end of file diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/sidebar-items.js b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/sidebar-items.js index 85b2eb491f..963e464da0 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/sidebar-items.js +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/sidebar-items.js @@ -1 +1 @@ -initSidebarItems({"enum":[["EsploraError","Errors that can happen during a sync with [`EsploraBlockchain`]"]],"struct":[["EsploraBlockchain","Structure that implements the logic to sync with Esplora"],["EsploraBlockchainConfig","Configuration for an [`EsploraBlockchain`]"],["UrlClient","Structure encapsulates ureq Esplora client"]]}); \ No newline at end of file +initSidebarItems({"enum":[["EsploraError","Errors that can happen during a sync with `Esplora`"]],"struct":[["EsploraBlockchain","Structure that implements the logic to sync with Esplora"],["EsploraBlockchainConfig","Configuration for an [`EsploraBlockchain`]"]]}); \ No newline at end of file diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchain.html index a9c8b9319b..090e247bc0 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchain.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchain.html @@ -4,29 +4,44 @@

EsploraBlockchain

Struct bdk::blockchain::esplora::EsploraBlockchain

source Â· [−]

pub struct EsploraBlockchain { /* private fields */ }

This is supported on crate feature esplora only.

Expand description

Structure that implements the logic to sync with Esplora

Struct bdk::blockchain::esplora::EsploraBlockchain

source Â· [−]

pub struct EsploraBlockchain { /* private fields */ }

This is supported on crate feature esplora only.

Expand description

Structure that implements the logic to sync with Esplora

Example

See the blockchain::esplora module for a usage example.

Implementations

source

impl EsploraBlockchain

source

pub fn new(base_url: &str, stop_gap: usize) -> Self

Create a new instance of the client from a base URL and the stop_gap.

source

pub fn with_agent(self, agent: Agent) -> Self

Set the inner ureq agent.

source

pub fn with_concurrency(self, concurrency: u8) -> Self

Set the number of parallel requests the client can make.

Trait Implementations

source

impl Blockchain for EsploraBlockchain

source

fn get_capabilities(&self) -> HashSet<Capability>

Return the set of Capability supported by this backend

source

fn broadcast(&self, tx: &Transaction) -> Result<(), Error>

Broadcast a transaction

source

fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>

Estimate the fee rate required to confirm a transaction in a given target of blocks

source

impl ConfigurableBlockchain for EsploraBlockchain

type Config = EsploraBlockchainConfig

Type that contains the configuration

source

fn from_config(config: &Self::Config) -> Result<Self, Error>

Create a new instance given a configuration

source

impl Debug for EsploraBlockchain

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Deref for EsploraBlockchain

type Target = UrlClient

The resulting type after dereferencing.

source

fn deref(&self) -> &Self::Target

Dereferences the value.

Implementations

source

impl EsploraBlockchain

source

pub fn new(base_url: &str, stop_gap: usize) -> Self

Create a new instance of the client from a base URL and the stop_gap.

source

pub fn from_client(url_client: BlockingClient, stop_gap: usize) -> Self

Build a new instance given a client

source

pub fn with_concurrency(self, concurrency: u8) -> Self

Set the number of parallel requests the client can make.

Methods from Deref<Target = BlockingClient>

pub fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>

Get a [Transaction] option given its [Txid]

pub fn get_tx_no_opt(&self, txid: &Txid) -> Result<Transaction, Error>

Get a [Transaction] given its [Txid].

pub fn get_txid_at_block_index(
    &self,
    block_hash: &BlockHash,
    index: usize
) -> Result<Option<Txid>, Error>

Get a [Txid] of a transaction given its index in a block with a given hash.

pub fn get_tx_status(&self, txid: &Txid) -> Result<Option<TxStatus>, Error>

Get the status of a [Transaction] given its [Txid].

pub fn get_header(&self, block_height: u32) -> Result<BlockHeader, Error>

Get a [BlockHeader] given a particular block height.

pub fn get_merkle_proof(
&self,
txid: &Txid
) -> Result<Option<MerkleProof>, Error>

Get a merkle inclusion proof for a [Transaction] with the given [Txid].

pub fn get_output_status(
    &self,
    txid: &Txid,
    index: u64
) -> Result<Option<OutputStatus>, Error>

Get the spending status of an output given a [Txid] and the output index.

pub fn broadcast(&self, transaction: &Transaction) -> Result<(), Error>

Broadcast a [Transaction] to Esplora

pub fn get_height(&self) -> Result<u32, Error>

Get the height of the current blockchain tip.

pub fn get_tip_hash(&self) -> Result<BlockHash, Error>

Get the [BlockHash] of the current blockchain tip.

pub fn get_fee_estimates(
&self
) -> Result<HashMap<String, f64, RandomState>, Error>

Get an map where the key is the confirmation target (in number of blocks) +and the value is the estimated feerate (in sat/vB).

pub fn scripthash_txs(
    &self,
    script: &Script,
    last_seen: Option<Txid>
) -> Result<Vec<Tx, Global>, Error>

Get confirmed transaction history for the specified address/scripthash, +sorted with newest first. Returns 25 transactions per page. +More can be requested by specifying the last txid seen by the previous query.

Trait Implementations

source

impl Blockchain for EsploraBlockchain

source

fn get_capabilities(&self) -> HashSet<Capability>

Return the set of Capability supported by this backend

source

fn broadcast(&self, tx: &Transaction) -> Result<(), Error>

Broadcast a transaction

source

fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>

Estimate the fee rate required to confirm a transaction in a given target of blocks

source

impl ConfigurableBlockchain for EsploraBlockchain

type Config = EsploraBlockchainConfig

Type that contains the configuration

source

fn from_config(config: &Self::Config) -> Result<Self, Error>

Create a new instance given a configuration

source

impl Debug for EsploraBlockchain

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Deref for EsploraBlockchain

type Target = BlockingClient

The resulting type after dereferencing.

source

fn deref(&self) -> &Self::Target

Dereferences the value.

source

impl From<EsploraBlockchain> for AnyBlockchain

source

fn from(inner: EsploraBlockchain) -> Self

Performs the conversion.

source

impl GetBlockHash for EsploraBlockchain

source

fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>

fetch block hash given its height

source

impl GetHeight for EsploraBlockchain

source

fn get_height(&self) -> Result<u32, Error>

Return the current height

source

impl GetTx for EsploraBlockchain

source

fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>

Fetch a transaction given its txid

source

impl WalletSync for EsploraBlockchain

source

fn wallet_setup<D: BatchDatabase>(
    &self,
    database: &mut D,
    _progress_update: Box<dyn Progress>
) -> Result<(), Error>

Setup the backend and populate the internal database for the first time Read more

source

impl GetBlockHash for EsploraBlockchain

source

fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>

fetch block hash given its height

source

impl GetHeight for EsploraBlockchain

source

fn get_height(&self) -> Result<u32, Error>

Return the current height

source

impl GetTx for EsploraBlockchain

source

fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>

Fetch a transaction given its txid

source

impl WalletSync for EsploraBlockchain

source

fn wallet_setup<D: BatchDatabase>(
    &self,
    database: &mut D,
    _progress_update: Box<dyn Progress>
) -> Result<(), Error>

Setup the backend and populate the internal database for the first time Read more

source

fn wallet_sync<D: BatchDatabase>(
    &self,
    database: &mut D,
    progress_update: Box<dyn Progress>
) -> Result<(), Error>

If not overridden, it defaults to calling Self::wallet_setup internally. Read more

source

impl StatelessBlockchain for EsploraBlockchain

Auto Trait Implementations

impl !RefUnwindSafe for EsploraBlockchain

impl Send for EsploraBlockchain

impl Sync for EsploraBlockchain

impl Unpin for EsploraBlockchain

impl !UnwindSafe for EsploraBlockchain

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl StatelessBlockchain for EsploraBlockchain

Auto Trait Implementations

impl !RefUnwindSafe for EsploraBlockchain

impl Send for EsploraBlockchain

impl Sync for EsploraBlockchain

impl Unpin for EsploraBlockchain

impl !UnwindSafe for EsploraBlockchain

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchainConfig.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchainConfig.html index 3dd8784eb8..545b89df34 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchainConfig.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.EsploraBlockchainConfig.html @@ -6,7 +6,7 @@ logo

EsploraBlockchainConfig

Struct bdk::blockchain::esplora::EsploraBlockchainConfig

source Â· [−]

pub struct EsploraBlockchainConfig {
+    Struct bdk::blockchain::esplora::EsploraBlockchainConfig
source Â· [−]

pub struct EsploraBlockchainConfig {
     pub base_url: String,
     pub proxy: Option<String>,
     pub concurrency: Option<u8>,
@@ -25,17 +25,17 @@ the socks feature enabled.

concurrency: Option<u8>Number of parallel requests sent to the esplora service (default: 4)
 
stop_gap: usizeStop searching addresses for transactions after finding an unused gap of this length.
 
timeout: Option<u64>Socket timeout.
-
Implementations
source
impl EsploraBlockchainConfig
source
pub fn new(base_url: String, stop_gap: usize) -> Self
create a config with default values given the base url and stop gap
-
Trait Implementations
source
impl Clone for EsploraBlockchainConfig
source
fn clone(&self) -> EsploraBlockchainConfig
Returns a copy of the value. Read more
+
Implementations
source
impl EsploraBlockchainConfig
source
pub fn new(base_url: String, stop_gap: usize) -> Self
create a config with default values given the base url and stop gap
+
Trait Implementations
source
impl Clone for EsploraBlockchainConfig
source
fn clone(&self) -> EsploraBlockchainConfig
Returns a copy of the value. Read more
 
1.0.0 Â· source
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
-
source
impl Debug for EsploraBlockchainConfig
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
-
source
impl<'de> Deserialize<'de> for EsploraBlockchainConfig
source
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 
Deserialize this value from the given Serde deserializer. Read more
+
source
impl Debug for EsploraBlockchainConfig
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl<'de> Deserialize<'de> for EsploraBlockchainConfig
source
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 
Deserialize this value from the given Serde deserializer. Read more
 
source
impl From<EsploraBlockchainConfig> for AnyBlockchainConfig
source
fn from(inner: EsploraBlockchainConfig) -> Self
Performs the conversion.
-
source
impl PartialEq<EsploraBlockchainConfig> for EsploraBlockchainConfig
source
fn eq(&self, other: &EsploraBlockchainConfig) -> bool
This method tests for self and other values to be equal, and is used
+
source
impl PartialEq<EsploraBlockchainConfig> for EsploraBlockchainConfig
source
fn eq(&self, other: &EsploraBlockchainConfig) -> bool
This method tests for self and other values to be equal, and is used
 by ==. Read more
-
source
fn ne(&self, other: &EsploraBlockchainConfig) -> bool
This method tests for !=.
-
source
impl Serialize for EsploraBlockchainConfig
source
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 
Serialize this value into the given Serde serializer. Read more
-
source
impl StructuralPartialEq for EsploraBlockchainConfig
Auto Trait Implementations
impl RefUnwindSafe for EsploraBlockchainConfig
impl Send for EsploraBlockchainConfig
impl Sync for EsploraBlockchainConfig
impl Unpin for EsploraBlockchainConfig
impl UnwindSafe for EsploraBlockchainConfig
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
fn ne(&self, other: &EsploraBlockchainConfig) -> bool
This method tests for !=.
+
source
impl Serialize for EsploraBlockchainConfig
source
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 
Serialize this value into the given Serde serializer. Read more
+
source
impl StructuralPartialEq for EsploraBlockchainConfig
Auto Trait Implementations
impl RefUnwindSafe for EsploraBlockchainConfig
impl Send for EsploraBlockchainConfig
impl Sync for EsploraBlockchainConfig
impl Unpin for EsploraBlockchainConfig
impl UnwindSafe for EsploraBlockchainConfig
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
 
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
 
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
 
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.UrlClient.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.UrlClient.html
deleted file mode 100644
index 61f3c1746d..0000000000
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/struct.UrlClient.html
+++ /dev/null
@@ -1,32 +0,0 @@
-UrlClient in bdk::blockchain::esplora - Rust
-    
-        
-    
-    
-                    
-        UrlClient
Associated Constants
ALIGN
Trait Implementations
CloneDebug
Auto Trait Implementations
!RefUnwindSafeSendSyncUnpin!UnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableToOwnedTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain::esplora

-                        

-    Struct bdk::blockchain::esplora::UrlClient
source Â· [−]
pub struct UrlClient { /* private fields */ }
This is supported on crate feature esplora only.
Expand description
Structure encapsulates ureq Esplora client
-
Trait Implementations
source
impl Clone for UrlClient
source
fn clone(&self) -> UrlClient
Returns a copy of the value. Read more
-
1.0.0 Â· source
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
-
source
impl Debug for UrlClient
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
-
Auto Trait Implementations
impl !RefUnwindSafe for UrlClient
impl Send for UrlClient
impl Sync for UrlClient
impl Unpin for UrlClient
impl !UnwindSafe for UrlClient
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
-
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
-
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
-
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
-
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
-
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
-
type Init = T
The type for initializers.
-
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
-
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
-
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
-
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
-
source
impl<T> ToOwned for T where
    T: Clone, 
type Owned = T
The resulting type after obtaining ownership.
-
source
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
-
source
pub fn clone_into(&self, target: &mut T)
ð¬ This is a nightly-only experimental API. (toowned_clone_into)
Uses borrowed data to replace owned data, usually by cloning. Read more
-
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
-
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
-
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
-
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
-
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V

-
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/ureq/struct.EsploraBlockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/ureq/struct.EsploraBlockchain.html
deleted file mode 100644
index 9e118ac7a5..0000000000
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/ureq/struct.EsploraBlockchain.html
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
-
-    
-    Redirection
-
-
-    Redirecting to ../../../../bdk/blockchain/esplora/struct.EsploraBlockchain.html...
-    
-
-
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/ureq/struct.UrlClient.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/ureq/struct.UrlClient.html
deleted file mode 100644
index 3071bd64d1..0000000000
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/esplora/ureq/struct.UrlClient.html
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
-
-    
-    Redirection
-
-
-    Redirecting to ../../../../bdk/blockchain/esplora/struct.UrlClient.html...
-    
-
-
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/index.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/index.html
index 942a844403..080b1d25db 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/index.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/index.html
@@ -12,11 +12,12 @@
 Compact Filters/Neutrino, along with a generalized trait
 Blockchain that can be implemented to build customized backends.
 
Re-exports
-pub use any::AnyBlockchain;
pub use any::AnyBlockchainConfig;
pub use self::electrum::ElectrumBlockchain;
pub use self::electrum::ElectrumBlockchainConfig;
pub use self::compact_filters::CompactFiltersBlockchain;
Modules
+pub use any::AnyBlockchain;
pub use any::AnyBlockchainConfig;
pub use self::electrum::ElectrumBlockchain;
pub use self::electrum::ElectrumBlockchainConfig;
pub use self::rpc::RpcBlockchain;
pub use self::rpc::RpcConfig;
pub use self::compact_filters::CompactFiltersBlockchain;
Modules
 any
Runtime-checked blockchain types
 
compact_filterscompact_filters
Compact Filters
 
electrumelectrum
Electrum
 
esploraesplora
Esplora
+
rpcrpc
Rpc Blockchain
 
Structs
 EsploraBlockchain
Structure that implements the logic to sync with Esplora
 
LogProgress
Type that implements Progress and logs at level INFO every update received
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/enum.Auth.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/enum.Auth.html
new file mode 100644
index 0000000000..d4a9bd29ac
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/enum.Auth.html
@@ -0,0 +1,68 @@
+Auth in bdk::blockchain::rpc - Rust
+    
+        
+    
+    
+                    
+        Auth
Variants
CookieNoneUserPass
Associated Constants
ALIGN
Trait Implementations
CloneDebugDeserialize<'de>EqFrom<Auth>HashOrdPartialEq<Auth>PartialOrd<Auth>SerializeStructuralEqStructuralPartialEq
Auto Trait Implementations
RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>CallHasherDeserializeOwnedFrom<T>Into<U>PointableToOwnedTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain::rpc

+                        

+    Enum bdk::blockchain::rpc::Auth
source Â· [−]
pub enum Auth {
+    None,
+    UserPass {
+        username: String,
+        password: String,
+    },
+    Cookie {
+        file: PathBuf,
+    },
+}
This is supported on crate feature rpc only.
Expand description
This struct is equivalent to [bitcoincore_rpc::Auth] but it implements serde::Serialize
+To be removed once upstream equivalent is implementing Serialize (json serialization format
+should be the same), see rust-bitcoincore-rpc/pull/181
+
Variants
None
None authentication
+
UserPass
Fields
username: StringUsername
+
password: StringPassword
+
Authentication with username and password, usually Auth::Cookie should be preferred
+
Cookie
Fields
file: PathBufCookie file
+
Authentication with a cookie file
+
Trait Implementations
source
impl Clone for Auth
source
fn clone(&self) -> Auth
Returns a copy of the value. Read more
+
1.0.0 Â· source
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
+
source
impl Debug for Auth
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl<'de> Deserialize<'de> for Auth
source
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 
Deserialize this value from the given Serde deserializer. Read more
+
source
impl From<Auth> for RpcAuth
source
fn from(auth: Auth) -> Self
Performs the conversion.
+
source
impl Hash for Auth
source
fn hash<__H: Hasher>(&self, state: &mut __H)
Feeds this value into the given Hasher. Read more
+
1.3.0 Â· source
fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 
Feeds a slice of this type into the given Hasher. Read more
+
source
impl Ord for Auth
source
fn cmp(&self, other: &Auth) -> Ordering
This method returns an Ordering between self and other. Read more
+
1.21.0 Â· source
fn max(self, other: Self) -> Self
Compares and returns the maximum of two values. Read more
+
1.21.0 Â· source
fn min(self, other: Self) -> Self
Compares and returns the minimum of two values. Read more
+
1.50.0 Â· source
fn clamp(self, min: Self, max: Self) -> Self
Restrict a value to a certain interval. Read more
+
source
impl PartialEq<Auth> for Auth
source
fn eq(&self, other: &Auth) -> bool
This method tests for self and other values to be equal, and is used
+by ==. Read more
+
source
fn ne(&self, other: &Auth) -> bool
This method tests for !=.
+
source
impl PartialOrd<Auth> for Auth
source
fn partial_cmp(&self, other: &Auth) -> Option<Ordering>
This method returns an ordering between self and other values if one exists. Read more
+
1.0.0 Â· source
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self and other) and is used by the < operator. Read more
+
1.0.0 Â· source
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self and other) and is used by the <=
+operator. Read more
+
1.0.0 Â· source
fn gt(&self, other: &Rhs) -> bool
This method tests greater than (for self and other) and is used by the > operator. Read more
+
1.0.0 Â· source
fn ge(&self, other: &Rhs) -> bool
This method tests greater than or equal to (for self and other) and is used by the >=
+operator. Read more
+
source
impl Serialize for Auth
source
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 
Serialize this value into the given Serde serializer. Read more
+
source
impl Eq for Auth
source
impl StructuralEq for Auth
source
impl StructuralPartialEq for Auth
Auto Trait Implementations
impl RefUnwindSafe for Auth
impl Send for Auth
impl Sync for Auth
impl Unpin for Auth
impl UnwindSafe for Auth
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
+
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
+
impl<T> CallHasher for T where
    T: Hash + ?Sized, 
pub default fn get_hash<H, B>(value: &H, build_hasher: &B) -> u64 where
    H: Hash + ?Sized,
    B: BuildHasher, 
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
+
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
+
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
+
type Init = T
The type for initializers.
+
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
+
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
+
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
+
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
+
source
impl<T> ToOwned for T where
    T: Clone, 
type Owned = T
The resulting type after obtaining ownership.
+
source
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
+
source
pub fn clone_into(&self, target: &mut T)
ð¬ This is a nightly-only experimental API. (toowned_clone_into)
Uses borrowed data to replace owned data, usually by cloning. Read more
+
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
+
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
+
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V
source
impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>, 

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/index.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/index.html
new file mode 100644
index 0000000000..38aa20875c
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/index.html
@@ -0,0 +1,33 @@
+bdk::blockchain::rpc - Rust
+    
+        
+    
+    
+                    
+        Module rpc
Structs
Enums

+                        

+    Module bdk::blockchain::rpc
source Â· [−]
This is supported on crate feature rpc only.
Expand description
Rpc Blockchain
+Backend that gets blockchain data from Bitcoin Core RPC
+This is an EXPERIMENTAL feature, API and other major changes are expected.
+Example
+let config = RpcConfig {
+    url: "127.0.0.1:18332".to_string(),
+    auth: Auth::Cookie {
+        file: "/home/user/.bitcoin/.cookie".into(),
+    },
+    network: bdk::bitcoin::Network::Testnet,
+    wallet_name: "wallet_name".to_string(),
+    sync_params: None,
+};
+let blockchain = RpcBlockchain::from_config(&config);
+
Structs
+RpcBlockchain
The main struct for RPC backend implementing the crate::blockchain::Blockchain trait
+
RpcBlockchainFactory
Factory of RpcBlockchain instances, implements BlockchainFactory
+
RpcConfig
RpcBlockchain configuration options
+
RpcSyncParams
Sync parameters for Bitcoin Core RPC.
+
Enums
+Auth
This struct is equivalent to [bitcoincore_rpc::Auth] but it implements serde::Serialize
+To be removed once upstream equivalent is implementing Serialize (json serialization format
+should be the same), see rust-bitcoincore-rpc/pull/181
+

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/sidebar-items.js b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/sidebar-items.js
new file mode 100644
index 0000000000..0cf4ae23a5
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/sidebar-items.js
@@ -0,0 +1 @@
+initSidebarItems({"enum":[["Auth","This struct is equivalent to [bitcoincore_rpc::Auth] but it implements [serde::Serialize] To be removed once upstream equivalent is implementing Serialize (json serialization format should be the same), see rust-bitcoincore-rpc/pull/181"]],"struct":[["RpcBlockchain","The main struct for RPC backend implementing the [crate::blockchain::Blockchain] trait"],["RpcBlockchainFactory","Factory of [`RpcBlockchain`] instances, implements [`BlockchainFactory`]"],["RpcConfig","RpcBlockchain configuration options"],["RpcSyncParams","Sync parameters for Bitcoin Core RPC."]]});
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcBlockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcBlockchain.html
new file mode 100644
index 0000000000..19a02ec75a
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcBlockchain.html
@@ -0,0 +1,42 @@
+RpcBlockchain in bdk::blockchain::rpc - Rust
+    
+        
+    
+    
+                    
+        RpcBlockchain
Associated Constants
ALIGN
Methods from Deref<Target=Client>
get_jsonrpc_client
Trait Implementations
BlockchainConfigurableBlockchainDebugDerefFrom<RpcBlockchain>GetBlockHashGetHeightGetTxWalletSync
Auto Trait Implementations
!RefUnwindSafeSendSyncUnpin!UnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain::rpc

+                        

+    Struct bdk::blockchain::rpc::RpcBlockchain
source Â· [−]
pub struct RpcBlockchain { /* private fields */ }
This is supported on crate feature rpc only.
Expand description
The main struct for RPC backend implementing the crate::blockchain::Blockchain trait
+
Methods from Deref<Target = Client>
pub fn get_jsonrpc_client(&self) -> &Client
Get the underlying JSONRPC client.
+
Trait Implementations
source
impl Blockchain for RpcBlockchain
source
fn get_capabilities(&self) -> HashSet<Capability>
Return the set of Capability supported by this backend
+
source
fn broadcast(&self, tx: &Transaction) -> Result<(), Error>
Broadcast a transaction
+
source
fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>
Estimate the fee rate required to confirm a transaction in a given target of blocks
+
source
impl ConfigurableBlockchain for RpcBlockchain
source
fn from_config(config: &Self::Config) -> Result<Self, Error>
Returns RpcBlockchain backend creating an RPC client to a specific wallet named as the descriptorâs checksum
+if itâs the first time it creates the wallet in the node and upon return is granted the wallet is loaded
+
type Config = RpcConfig
Type that contains the configuration
+
source
impl Debug for RpcBlockchain
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl Deref for RpcBlockchain
type Target = Client
The resulting type after dereferencing.
+
source
fn deref(&self) -> &Self::Target
Dereferences the value.
+
source
impl From<RpcBlockchain> for AnyBlockchain
source
fn from(inner: RpcBlockchain) -> Self
Performs the conversion.
+
source
impl GetBlockHash for RpcBlockchain
source
fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>
fetch block hash given its height
+
source
impl GetHeight for RpcBlockchain
source
fn get_height(&self) -> Result<u32, Error>
Return the current height
+
source
impl GetTx for RpcBlockchain
source
fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>
Fetch a transaction given its txid
+
source
impl WalletSync for RpcBlockchain
source
fn wallet_setup<D>(
    &self, 
    db: &mut D, 
    prog: Box<dyn Progress>
) -> Result<(), Error> where
    D: BatchDatabase, 
Setup the backend and populate the internal database for the first time Read more
+
source
fn wallet_sync<D: BatchDatabase>(
    &self, 
    database: &mut D, 
    progress_update: Box<dyn Progress>
) -> Result<(), Error>
If not overridden, it defaults to calling Self::wallet_setup internally. Read more
+
Auto Trait Implementations
impl !RefUnwindSafe for RpcBlockchain
impl Send for RpcBlockchain
impl Sync for RpcBlockchain
impl Unpin for RpcBlockchain
impl !UnwindSafe for RpcBlockchain
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
+
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
+
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
+
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
+
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
+
type Init = T
The type for initializers.
+
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
+
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
+
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
+
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
+
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
+
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
+
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcBlockchainFactory.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcBlockchainFactory.html
new file mode 100644
index 0000000000..74629289a8
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcBlockchainFactory.html
@@ -0,0 +1,63 @@
+RpcBlockchainFactory in bdk::blockchain::rpc - Rust
+    
+        
+    
+    
+                    
+        RpcBlockchainFactory
Fields
authdefault_skip_blocksnetworksync_paramsurlwallet_name_prefix
Associated Constants
ALIGN
Trait Implementations
BlockchainFactoryCloneDebug
Auto Trait Implementations
RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableToOwnedTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain::rpc

+                        

+    Struct bdk::blockchain::rpc::RpcBlockchainFactory
source Â· [−]
pub struct RpcBlockchainFactory {
+    pub url: String,
+    pub auth: Auth,
+    pub network: Network,
+    pub wallet_name_prefix: Option<String>,
+    pub default_skip_blocks: u32,
+    pub sync_params: Option<RpcSyncParams>,
+}
This is supported on crate feature rpc only.
Expand description
Factory of RpcBlockchain instances, implements BlockchainFactory
+Internally caches the node url and authentication params and allows getting many different RpcBlockchain
+objects for different wallet names and with different rescan heights.
+Example
+let factory = RpcBlockchainFactory {
+    url: "http://127.0.0.1:18332".to_string(),
+    auth: Auth::Cookie {
+        file: "/home/user/.bitcoin/.cookie".into(),
+    },
+    network: Network::Testnet,
+    wallet_name_prefix: Some("prefix-".to_string()),
+    default_skip_blocks: 100_000,
+    sync_params: None,
+};
+let main_wallet_blockchain = factory.build("main_wallet", Some(200_000))?;
+
Fields
url: StringThe bitcoin node url
+
auth: AuthThe bitcoin node authentication mechanism
+
network: NetworkThe network we are using (it will be checked the bitcoin node network matches this)
+
wallet_name_prefix: Option<String>The optional prefix used to build the full wallet name for blockchains
+
default_skip_blocks: u32Default number of blocks to skip which will be inherited by blockchain unless overridden
+
sync_params: Option<RpcSyncParams>Sync parameters
+
Trait Implementations
source
impl BlockchainFactory for RpcBlockchainFactory
type Inner = RpcBlockchain
The type returned when building a blockchain from this factory
+
source
fn build(
    &self, 
    checksum: &str, 
    _override_skip_blocks: Option<u32>
) -> Result<Self::Inner, Error>
Build a new blockchain for the given descriptor wallet_name Read more
+
source
fn build_for_wallet<D: BatchDatabase>(
    &self, 
    wallet: &Wallet<D>, 
    override_skip_blocks: Option<u32>
) -> Result<Self::Inner, Error>
Build a new blockchain for a given wallet Read more
+
source
fn sync_wallet<D: BatchDatabase>(
    &self, 
    wallet: &Wallet<D>, 
    override_skip_blocks: Option<u32>, 
    sync_options: SyncOptions
) -> Result<(), Error>
This is supported on neither WebAssembly nor crate feature async-interface.
Use BlockchainFactory::build_for_wallet to get a blockchain, then sync the wallet Read more
+
source
impl Clone for RpcBlockchainFactory
source
fn clone(&self) -> RpcBlockchainFactory
Returns a copy of the value. Read more
+
1.0.0 Â· source
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
+
source
impl Debug for RpcBlockchainFactory
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
Auto Trait Implementations
impl RefUnwindSafe for RpcBlockchainFactory
impl Send for RpcBlockchainFactory
impl Sync for RpcBlockchainFactory
impl Unpin for RpcBlockchainFactory
impl UnwindSafe for RpcBlockchainFactory
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
+
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
+
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
+
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
+
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
+
type Init = T
The type for initializers.
+
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
+
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
+
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
+
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
+
source
impl<T> ToOwned for T where
    T: Clone, 
type Owned = T
The resulting type after obtaining ownership.
+
source
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
+
source
pub fn clone_into(&self, target: &mut T)
ð¬ This is a nightly-only experimental API. (toowned_clone_into)
Uses borrowed data to replace owned data, usually by cloning. Read more
+
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
+
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
+
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcConfig.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcConfig.html
new file mode 100644
index 0000000000..b2268fc701
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcConfig.html
@@ -0,0 +1,49 @@
+RpcConfig in bdk::blockchain::rpc - Rust
+    
+        
+    
+    
+                    
+        RpcConfig
Fields
authnetworksync_paramsurlwallet_name
Associated Constants
ALIGN
Trait Implementations
CloneDebugDeserialize<'de>From<RpcConfig>PartialEq<RpcConfig>SerializeStructuralPartialEq
Auto Trait Implementations
RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>DeserializeOwnedFrom<T>Into<U>PointableToOwnedTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain::rpc

+                        

+    Struct bdk::blockchain::rpc::RpcConfig
source Â· [−]
pub struct RpcConfig {
+    pub url: String,
+    pub auth: Auth,
+    pub network: Network,
+    pub wallet_name: String,
+    pub sync_params: Option<RpcSyncParams>,
+}
This is supported on crate feature rpc only.
Expand description
RpcBlockchain configuration options
+
Fields
url: StringThe bitcoin node url
+
auth: AuthThe bitcoin node authentication mechanism
+
network: NetworkThe network we are using (it will be checked the bitcoin node network matches this)
+
wallet_name: StringThe wallet name in the bitcoin node, consider using crate::wallet::wallet_name_from_descriptor for this
+
sync_params: Option<RpcSyncParams>Sync parameters
+
Trait Implementations
source
impl Clone for RpcConfig
source
fn clone(&self) -> RpcConfig
Returns a copy of the value. Read more
+
1.0.0 Â· source
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
+
source
impl Debug for RpcConfig
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl<'de> Deserialize<'de> for RpcConfig
source
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 
Deserialize this value from the given Serde deserializer. Read more
+
source
impl From<RpcConfig> for AnyBlockchainConfig
source
fn from(inner: RpcConfig) -> Self
Performs the conversion.
+
source
impl PartialEq<RpcConfig> for RpcConfig
source
fn eq(&self, other: &RpcConfig) -> bool
This method tests for self and other values to be equal, and is used
+by ==. Read more
+
source
fn ne(&self, other: &RpcConfig) -> bool
This method tests for !=.
+
source
impl Serialize for RpcConfig
source
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 
Serialize this value into the given Serde serializer. Read more
+
source
impl StructuralPartialEq for RpcConfig
Auto Trait Implementations
impl RefUnwindSafe for RpcConfig
impl Send for RpcConfig
impl Sync for RpcConfig
impl Unpin for RpcConfig
impl UnwindSafe for RpcConfig
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
+
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
+
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
+
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
+
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
+
type Init = T
The type for initializers.
+
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
+
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
+
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
+
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
+
source
impl<T> ToOwned for T where
    T: Clone, 
type Owned = T
The resulting type after obtaining ownership.
+
source
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
+
source
pub fn clone_into(&self, target: &mut T)
ð¬ This is a nightly-only experimental API. (toowned_clone_into)
Uses borrowed data to replace owned data, usually by cloning. Read more
+
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
+
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
+
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V
source
impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>, 

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcSyncParams.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcSyncParams.html
new file mode 100644
index 0000000000..dc07249001
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/rpc/struct.RpcSyncParams.html
@@ -0,0 +1,50 @@
+RpcSyncParams in bdk::blockchain::rpc - Rust
+    
+        
+    
+    
+                    
+        RpcSyncParams
Fields
force_start_timepoll_rate_secstart_script_countstart_time
Associated Constants
ALIGN
Trait Implementations
CloneDebugDefaultDeserialize<'de>PartialEq<RpcSyncParams>SerializeStructuralPartialEq
Auto Trait Implementations
RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>DeserializeOwnedFrom<T>Into<U>PointableToOwnedTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain::rpc

+                        

+    Struct bdk::blockchain::rpc::RpcSyncParams
source Â· [−]
pub struct RpcSyncParams {
+    pub start_script_count: usize,
+    pub start_time: u64,
+    pub force_start_time: bool,
+    pub poll_rate_sec: u64,
+}
This is supported on crate feature rpc only.
Expand description
Sync parameters for Bitcoin Core RPC.
+In general, BDK tries to sync scriptPubKeys cached in crate::database::Database with
+scriptPubKeys imported in the Bitcoin Core Wallet. These parameters are used for determining
+how the importdescriptors RPC calls are to be made.
+
Fields
start_script_count: usizeThe minimum number of scripts to scan for on initial sync.
+
start_time: u64Time in unix seconds in which initial sync will start scanning from (0 to start from genesis).
+
force_start_time: boolForces every sync to use start_time as import timestamp.
+
poll_rate_sec: u64RPC poll rate (in seconds) to get state updates.
+
Trait Implementations
source
impl Clone for RpcSyncParams
source
fn clone(&self) -> RpcSyncParams
Returns a copy of the value. Read more
+
1.0.0 Â· source
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source. Read more
+
source
impl Debug for RpcSyncParams
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl Default for RpcSyncParams
source
fn default() -> Self
Returns the âdefault valueâ for a type. Read more
+
source
impl<'de> Deserialize<'de> for RpcSyncParams
source
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 
Deserialize this value from the given Serde deserializer. Read more
+
source
impl PartialEq<RpcSyncParams> for RpcSyncParams
source
fn eq(&self, other: &RpcSyncParams) -> bool
This method tests for self and other values to be equal, and is used
+by ==. Read more
+
source
fn ne(&self, other: &RpcSyncParams) -> bool
This method tests for !=.
+
source
impl Serialize for RpcSyncParams
source
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 
Serialize this value into the given Serde serializer. Read more
+
source
impl StructuralPartialEq for RpcSyncParams
Auto Trait Implementations
impl RefUnwindSafe for RpcSyncParams
impl Send for RpcSyncParams
impl Sync for RpcSyncParams
impl Unpin for RpcSyncParams
impl UnwindSafe for RpcSyncParams
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
+
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
+
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
+
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
+
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
+
type Init = T
The type for initializers.
+
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
+
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
+
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
+
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
+
source
impl<T> ToOwned for T where
    T: Clone, 
type Owned = T
The resulting type after obtaining ownership.
+
source
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
+
source
pub fn clone_into(&self, target: &mut T)
ð¬ This is a nightly-only experimental API. (toowned_clone_into)
Uses borrowed data to replace owned data, usually by cloning. Read more
+
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
+
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
+
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V
source
impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>, 

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/sidebar-items.js b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/sidebar-items.js
index 47998f4e32..a11daf6513 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/sidebar-items.js
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/sidebar-items.js
@@ -1 +1 @@
-initSidebarItems({"enum":[["Capability","Capabilities that can be supported by a [`Blockchain`] backend"]],"fn":[["log_progress","Create a new instance of [`LogProgress`]"],["noop_progress","Create a new instance of [`NoopProgress`]"],["progress","Shortcut to create a [`channel`] (pair of [`Sender`] and [`Receiver`]) that can transport [`ProgressData`]"]],"mod":[["any","Runtime-checked blockchain types"],["compact_filters","Compact Filters"],["electrum","Electrum"],["esplora","Esplora"]],"struct":[["EsploraBlockchain","Structure that implements the logic to sync with Esplora"],["LogProgress","Type that implements [`Progress`] and logs at level `INFO` every update received"],["NoopProgress","Type that implements [`Progress`] and drops every update received"]],"trait":[["Blockchain","Trait that defines the actions that must be supported by a blockchain backend"],["BlockchainFactory","Trait for a factory of blockchains that share the underlying connection or configuration"],["ConfigurableBlockchain","Trait for [`Blockchain`] types that can be created given a configuration"],["GetBlockHash","Trait for getting block hash by block height"],["GetHeight","Trait for getting the current height of the blockchain."],["GetTx","Trait for getting a transaction by txid"],["Progress","Trait for types that can receive and process progress updates during [`WalletSync::wallet_sync`] and [`WalletSync::wallet_setup`]"],["StatelessBlockchain","Trait for blockchains that donât contain any state"],["WalletSync","Trait for blockchains that can sync by updating the database directly."]],"type":[["ProgressData","Data sent with a progress update over a [`channel`]"]]});
\ No newline at end of file
+initSidebarItems({"enum":[["Capability","Capabilities that can be supported by a [`Blockchain`] backend"]],"fn":[["log_progress","Create a new instance of [`LogProgress`]"],["noop_progress","Create a new instance of [`NoopProgress`]"],["progress","Shortcut to create a [`channel`] (pair of [`Sender`] and [`Receiver`]) that can transport [`ProgressData`]"]],"mod":[["any","Runtime-checked blockchain types"],["compact_filters","Compact Filters"],["electrum","Electrum"],["esplora","Esplora"],["rpc","Rpc Blockchain"]],"struct":[["EsploraBlockchain","Structure that implements the logic to sync with Esplora"],["LogProgress","Type that implements [`Progress`] and logs at level `INFO` every update received"],["NoopProgress","Type that implements [`Progress`] and drops every update received"]],"trait":[["Blockchain","Trait that defines the actions that must be supported by a blockchain backend"],["BlockchainFactory","Trait for a factory of blockchains that share the underlying connection or configuration"],["ConfigurableBlockchain","Trait for [`Blockchain`] types that can be created given a configuration"],["GetBlockHash","Trait for getting block hash by block height"],["GetHeight","Trait for getting the current height of the blockchain."],["GetTx","Trait for getting a transaction by txid"],["Progress","Trait for types that can receive and process progress updates during [`WalletSync::wallet_sync`] and [`WalletSync::wallet_setup`]"],["StatelessBlockchain","Trait for blockchains that donât contain any state"],["WalletSync","Trait for blockchains that can sync by updating the database directly."]],"type":[["ProgressData","Data sent with a progress update over a [`channel`]"]]});
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/struct.EsploraBlockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/struct.EsploraBlockchain.html
index e2361c26d3..e3e89a2200 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/struct.EsploraBlockchain.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/struct.EsploraBlockchain.html
@@ -4,29 +4,44 @@
     
     
                     
-        EsploraBlockchain
Associated Constants
ALIGN
Methods
newwith_agentwith_concurrency
Trait Implementations
BlockchainConfigurableBlockchainDebugDerefFrom<EsploraBlockchain>GetBlockHashGetHeightGetTxStatelessBlockchainWalletSync
Auto Trait Implementations
!RefUnwindSafeSendSyncUnpin!UnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain

+        EsploraBlockchain
Associated Constants
ALIGN
Methods
from_clientnewwith_concurrency
Methods from Deref<Target=BlockingClient>
broadcastget_fee_estimatesget_headerget_heightget_merkle_proofget_output_statusget_tip_hashget_txget_tx_no_optget_tx_statusget_txid_at_block_indexscripthash_txs
Trait Implementations
BlockchainConfigurableBlockchainDebugDerefFrom<EsploraBlockchain>GetBlockHashGetHeightGetTxStatelessBlockchainWalletSync
Auto Trait Implementations
!RefUnwindSafeSendSyncUnpin!UnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableTryFrom<U>TryInto<U>VZip<V>
In bdk::blockchain

                         

-    Struct bdk::blockchain::EsploraBlockchain
source Â· [−]
pub struct EsploraBlockchain { /* private fields */ }
Expand description
Structure that implements the logic to sync with Esplora
+    Struct bdk::blockchain::EsploraBlockchain
source Â· [−]
pub struct EsploraBlockchain { /* private fields */ }
Expand description
Structure that implements the logic to sync with Esplora
 Example
 See the blockchain::esplora module for a usage example.
-
Implementations
source
impl EsploraBlockchain
source
pub fn new(base_url: &str, stop_gap: usize) -> Self
This is supported on crate feature esplora only.
Create a new instance of the client from a base URL and the stop_gap.
-
source
pub fn with_agent(self, agent: Agent) -> Self
This is supported on crate feature esplora only.
Set the inner ureq agent.
-
source
pub fn with_concurrency(self, concurrency: u8) -> Self
This is supported on crate feature esplora only.
Set the number of parallel requests the client can make.
-
Trait Implementations
source
impl Blockchain for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_capabilities(&self) -> HashSet<Capability>
Return the set of Capability supported by this backend
-
source
fn broadcast(&self, tx: &Transaction) -> Result<(), Error>
Broadcast a transaction
-
source
fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>
Estimate the fee rate required to confirm a transaction in a given target of blocks
-
source
impl ConfigurableBlockchain for EsploraBlockchain
This is supported on crate feature esplora only.
type Config = EsploraBlockchainConfig
Type that contains the configuration
-
source
fn from_config(config: &Self::Config) -> Result<Self, Error>
Create a new instance given a configuration
-
source
impl Debug for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
-
source
impl Deref for EsploraBlockchain
This is supported on crate feature esplora only.
type Target = UrlClient
The resulting type after dereferencing.
-
source
fn deref(&self) -> &Self::Target
Dereferences the value.
+
Implementations
source
impl EsploraBlockchain
source
pub fn new(base_url: &str, stop_gap: usize) -> Self
This is supported on crate feature esplora only.
Create a new instance of the client from a base URL and the stop_gap.
+
source
pub fn from_client(url_client: BlockingClient, stop_gap: usize) -> Self
This is supported on crate feature esplora only.
Build a new instance given a client
+
source
pub fn with_concurrency(self, concurrency: u8) -> Self
This is supported on crate feature esplora only.
Set the number of parallel requests the client can make.
+
Methods from Deref<Target = BlockingClient>
pub fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>
Get a [Transaction] option given its [Txid]
+
pub fn get_tx_no_opt(&self, txid: &Txid) -> Result<Transaction, Error>
Get a [Transaction] given its [Txid].
+
pub fn get_txid_at_block_index(
    &self, 
    block_hash: &BlockHash, 
    index: usize
) -> Result<Option<Txid>, Error>
Get a [Txid] of a transaction given its index in a block with a given hash.
+
pub fn get_tx_status(&self, txid: &Txid) -> Result<Option<TxStatus>, Error>
Get the status of a [Transaction] given its [Txid].
+
pub fn get_header(&self, block_height: u32) -> Result<BlockHeader, Error>
Get a [BlockHeader] given a particular block height.
+
pub fn get_merkle_proof(
    &self, 
    txid: &Txid
) -> Result<Option<MerkleProof>, Error>
Get a merkle inclusion proof for a [Transaction] with the given [Txid].
+
pub fn get_output_status(
    &self, 
    txid: &Txid, 
    index: u64
) -> Result<Option<OutputStatus>, Error>
Get the spending status of an output given a [Txid] and the output index.
+
pub fn broadcast(&self, transaction: &Transaction) -> Result<(), Error>
Broadcast a [Transaction] to Esplora
+
pub fn get_height(&self) -> Result<u32, Error>
Get the height of the current blockchain tip.
+
pub fn get_tip_hash(&self) -> Result<BlockHash, Error>
Get the [BlockHash] of the current blockchain tip.
+
pub fn get_fee_estimates(
    &self
) -> Result<HashMap<String, f64, RandomState>, Error>
Get an map where the key is the confirmation target (in number of blocks)
+and the value is the estimated feerate (in sat/vB).
+
pub fn scripthash_txs(
    &self, 
    script: &Script, 
    last_seen: Option<Txid>
) -> Result<Vec<Tx, Global>, Error>
Get confirmed transaction history for the specified address/scripthash,
+sorted with newest first. Returns 25 transactions per page.
+More can be requested by specifying the last txid seen by the previous query.
+
Trait Implementations
source
impl Blockchain for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_capabilities(&self) -> HashSet<Capability>
Return the set of Capability supported by this backend
+
source
fn broadcast(&self, tx: &Transaction) -> Result<(), Error>
Broadcast a transaction
+
source
fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>
Estimate the fee rate required to confirm a transaction in a given target of blocks
+
source
impl ConfigurableBlockchain for EsploraBlockchain
This is supported on crate feature esplora only.
type Config = EsploraBlockchainConfig
Type that contains the configuration
+
source
fn from_config(config: &Self::Config) -> Result<Self, Error>
Create a new instance given a configuration
+
source
impl Debug for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl Deref for EsploraBlockchain
This is supported on crate feature esplora only.
type Target = BlockingClient
The resulting type after dereferencing.
+
source
fn deref(&self) -> &Self::Target
Dereferences the value.
 
source
impl From<EsploraBlockchain> for AnyBlockchain
source
fn from(inner: EsploraBlockchain) -> Self
Performs the conversion.
-
source
impl GetBlockHash for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>
fetch block hash given its height
-
source
impl GetHeight for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_height(&self) -> Result<u32, Error>
Return the current height
-
source
impl GetTx for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>
Fetch a transaction given its txid
-
source
impl WalletSync for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn wallet_setup<D: BatchDatabase>(
    &self, 
    database: &mut D, 
    _progress_update: Box<dyn Progress>
) -> Result<(), Error>
Setup the backend and populate the internal database for the first time Read more
+
source
impl GetBlockHash for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>
fetch block hash given its height
+
source
impl GetHeight for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_height(&self) -> Result<u32, Error>
Return the current height
+
source
impl GetTx for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>
Fetch a transaction given its txid
+
source
impl WalletSync for EsploraBlockchain
This is supported on crate feature esplora only.
source
fn wallet_setup<D: BatchDatabase>(
    &self, 
    database: &mut D, 
    _progress_update: Box<dyn Progress>
) -> Result<(), Error>
Setup the backend and populate the internal database for the first time Read more
 
source
fn wallet_sync<D: BatchDatabase>(
    &self, 
    database: &mut D, 
    progress_update: Box<dyn Progress>
) -> Result<(), Error>
If not overridden, it defaults to calling Self::wallet_setup internally. Read more
-
source
impl StatelessBlockchain for EsploraBlockchain
This is supported on crate feature esplora only.
Auto Trait Implementations
impl !RefUnwindSafe for EsploraBlockchain
impl Send for EsploraBlockchain
impl Sync for EsploraBlockchain
impl Unpin for EsploraBlockchain
impl !UnwindSafe for EsploraBlockchain
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl StatelessBlockchain for EsploraBlockchain
This is supported on crate feature esplora only.
Auto Trait Implementations
impl !RefUnwindSafe for EsploraBlockchain
impl Send for EsploraBlockchain
impl Sync for EsploraBlockchain
impl Unpin for EsploraBlockchain
impl !UnwindSafe for EsploraBlockchain
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
 
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
 
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
 
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.Blockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.Blockchain.html
index ddf4eac397..bce37063c1 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.Blockchain.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.Blockchain.html
@@ -14,5 +14,5 @@
 
Required methods
source
fn get_capabilities(&self) -> HashSet<Capability>
Return the set of Capability supported by this backend
 
source
fn broadcast(&self, tx: &Transaction) -> Result<(), Error>
Broadcast a transaction
 
source
fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>
Estimate the fee rate required to confirm a transaction in a given target of blocks
-
Implementations on Foreign Types
source
impl<T: Blockchain> Blockchain for Arc<T>
source
fn get_capabilities(&self) -> HashSet<Capability>
source
fn broadcast(&self, tx: &Transaction) -> Result<(), Error>
source
fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>
Implementors
source
impl Blockchain for AnyBlockchain
source
impl Blockchain for CompactFiltersBlockchain
This is supported on crate feature compact_filters only.
source
impl Blockchain for ElectrumBlockchain
This is supported on crate feature electrum only.
source
impl Blockchain for EsploraBlockchain
This is supported on crate feature esplora only.

+
Implementations on Foreign Types
source
impl<T: Blockchain> Blockchain for Arc<T>
source
fn get_capabilities(&self) -> HashSet<Capability>
source
fn broadcast(&self, tx: &Transaction) -> Result<(), Error>
source
fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>
Implementors
source
impl Blockchain for AnyBlockchain
source
impl Blockchain for CompactFiltersBlockchain
This is supported on crate feature compact_filters only.
source
impl Blockchain for ElectrumBlockchain
This is supported on crate feature electrum only.
source
impl Blockchain for EsploraBlockchain
This is supported on crate feature esplora only.
source
impl Blockchain for RpcBlockchain
This is supported on crate feature rpc only.


 
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.BlockchainFactory.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.BlockchainFactory.html
index 471e067d7e..4775acba9c 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.BlockchainFactory.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.BlockchainFactory.html
@@ -41,5 +41,5 @@ immediately dropped. Keep in mind that specific blockchain factories may perform
 operations to build a blockchain for a given wallet, so if a wallet needs to be synced
 often itâs recommended to use BlockchainFactory::build_for_wallet to reuse the same
 blockchain multiple times.
-

`Implementations on Foreign Types`

source

impl<T: StatelessBlockchain> BlockchainFactory for Arc<T>

type Inner = Self

source

fn build(
    &self, 
    _wallet_name: &str, 
    _override_skip_blocks: Option<u32>
) -> Result<Self, Error>

`Implementors`

`Implementations on Foreign Types`

source

impl<T: StatelessBlockchain> BlockchainFactory for Arc<T>

type Inner = Self

source

fn build(
    &self, 
    _wallet_name: &str, 
    _override_skip_blocks: Option<u32>
) -> Result<Self, Error>

`Implementors`

source

impl BlockchainFactory for RpcBlockchainFactory
This is supported on crate feature rpc only.

type Inner = RpcBlockchain


 
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.ConfigurableBlockchain.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.ConfigurableBlockchain.html
index aa025d4771..4d79814192 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.ConfigurableBlockchain.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.ConfigurableBlockchain.html
@@ -12,5 +12,5 @@
 }

Expand description

Trait for Blockchain types that can be created given a configuration

`Associated Types`

source

`type Config: Debug`

Type that contains the configuration

`Required methods`

source

`fn from_config(config: &Self::Config) -> Result<Self, Error>`

Create a new instance given a configuration

`Implementors`

source

impl ConfigurableBlockchain for AnyBlockchain

type Config = AnyBlockchainConfig

source

impl ConfigurableBlockchain for CompactFiltersBlockchain
This is supported on crate feature compact_filters only.

type Config = CompactFiltersBlockchainConfig

source

impl ConfigurableBlockchain for ElectrumBlockchain
This is supported on crate feature electrum only.

type Config = ElectrumBlockchainConfig

source

impl ConfigurableBlockchain for EsploraBlockchain
This is supported on crate feature esplora only.

type Config = EsploraBlockchainConfig

`Implementors`

source

impl ConfigurableBlockchain for AnyBlockchain

type Config = AnyBlockchainConfig

source

impl ConfigurableBlockchain for CompactFiltersBlockchain
This is supported on crate feature compact_filters only.

type Config = CompactFiltersBlockchainConfig

source

impl ConfigurableBlockchain for ElectrumBlockchain
This is supported on crate feature electrum only.

type Config = ElectrumBlockchainConfig

source

impl ConfigurableBlockchain for EsploraBlockchain
This is supported on crate feature esplora only.

type Config = EsploraBlockchainConfig

source

impl ConfigurableBlockchain for RpcBlockchain
This is supported on crate feature rpc only.

type Config = RpcConfig


 
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.GetBlockHash.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.GetBlockHash.html
index e101b8d8e5..160f8ec21f 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.GetBlockHash.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/blockchain/trait.GetBlockHash.html
@@ -10,5 +10,5 @@
     fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>;
 }

Expand description

Trait for getting block hash by block height

Required methods

source

fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>

fetch block hash given its height

Implementations on Foreign Types

source

impl<T: GetBlockHash> GetBlockHash for Arc<T>

source

fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>

Implementors

source

impl GetBlockHash for AnyBlockchain

source

impl GetBlockHash for CompactFiltersBlockchain

This is supported on crate feature compact_filters only.

source

impl GetBlockHash for ElectrumBlockchain

This is supported on crate feature electrum only.

source

impl GetBlockHash for EsploraBlockchain

This is supported on crate feature esplora only.

Implementations on Foreign Types

Implementors

Required methods

Implementations on Foreign Types

Implementors

Implementations on Foreign Types

Implementors

Required methods

Implementations on Foreign Types

Implementors

Implementations on Foreign Types

Implementors

Statless blockchains can be used to sync multiple wallets with different descriptors.

BlockchainFactory is automatically implemented for Arc<T> where T is a stateless blockchain.

Implementors

The progress_update object can be used to give the caller updates about the progress by using Progress::update.

Implementations on Foreign Types

Implementors

Implementations on Foreign Types

Implementors

Implementations on Foreign Types

Implementors

Error

Enum bdk::Error

source Â· [−]

pub enum Error {
-Show 42 variants
    InvalidU32Bytes(Vec<u8>),
+Show 44 variants
    InvalidU32Bytes(Vec<u8>),
     Generic(String),
     ScriptDoesntHaveAddressForm,
     NoRecipients,
@@ -40,6 +40,7 @@
         requested: Network,
         found: Network,
     },
+    Verification(VerifyError),
     InvalidProgressValue(f32),
     ProgressUpdateError,
     InvalidOutpoint(OutPoint),
@@ -58,6 +59,7 @@
     Esplora(Box<EsploraError>),
     CompactFilters(CompactFiltersError),
     Sled(Error),
+    Rpc(Error),
     Rusqlite(Error),
 
}

Expand description

Errors that can be thrown by the Wallet

Variants

`InvalidU32Bytes(Vec<u8>)`

Wrong number of bytes found when trying to convert to u32

@@ -93,6 +95,7 @@ explicit origin provided

`InvalidNetwork`

Fields

requested: Network

requested network, for example what is given as bdk-cli option

found: Network

found network, for example the network of the bitcoin node

Invalid network

`Verification(VerifyError)`

Transaction verification error

`InvalidProgressValue(f32)`

Progress value must be between 0.0 (included) and 100.0 (included)

`ProgressUpdateError`

Progress update error (maybe the channel has been closed)

`InvalidOutpoint(OutPoint)`

Requested outpoint doesnât exist in the tx (vout greater than available outputs)

@@ -112,6 +115,7 @@ are needed to satisfy stop_gap.

`Esplora(Box<EsploraError>)`

Esplora client error

`CompactFilters(CompactFiltersError)`

Compact filters client error)

`Sled(Error)`

Sled database error

`Rpc(Error)`

Rpc client error

`Rusqlite(Error)`

Rusqlite client error

Trait Implementations

source

impl Debug for Error

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Display for Error

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

@@ -120,11 +124,14 @@ are needed to satisfy stop_gap.

1.0.0 Â· source

fn description(&self) -> &str

ð Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 Â· source

fn cause(&self) -> Option<&dyn Error>

ð Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

source

impl From<AddressValidatorError> for Error

source

fn from(err: AddressValidatorError) -> Self

Performs the conversion.

source

impl From<CompactFiltersError> for Error

source

fn from(other: CompactFiltersError) -> Self

Performs the conversion.

source

impl From<CompactFiltersError> for Error

source

fn from(other: CompactFiltersError) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for CompactFiltersError

This is supported on crate feature compact_filters only.

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(other: EsploraError) -> Self

Performs the conversion.

source

impl From<Error> for CompactFiltersError

This is supported on crate feature compact_filters only.

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for VerifyError

This is supported on crate feature verify only.

source

fn from(other: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

@@ -133,15 +140,15 @@ are needed to satisfy stop_gap.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<Error> for Error

source

fn from(err: Error) -> Self

Performs the conversion.

source

impl From<EsploraError> for Error

source

fn from(other: EsploraError) -> Self

Performs the conversion.

source

impl From<KeyError> for Error

source

fn from(key_error: KeyError) -> Error

Performs the conversion.

source

impl From<PolicyError> for Error

source

fn from(err: PolicyError) -> Self

Performs the conversion.

source

impl From<PsbtParseError> for Error

source

fn from(err: PsbtParseError) -> Self

Performs the conversion.

source

impl From<SignerError> for Error

source

fn from(err: SignerError) -> Self

Performs the conversion.

source

impl From<VerifyError> for Error

source

fn from(other: VerifyError) -> Self

Performs the conversion.

Auto Trait Implementations

impl !RefUnwindSafe for Error

impl Send for Error

impl Sync for Error

impl Unpin for Error

impl !UnwindSafe for Error

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable Â· source

pub fn into(self) -> U

Performs the conversion.

impl<T> Pointable for T

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/enum.KeychainKind.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/enum.KeychainKind.html index b23bcb8f20..2481300b39 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/enum.KeychainKind.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/enum.KeychainKind.html @@ -40,7 +40,7 @@ by ==.

pub unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> ToBase32 for T where
T: AsRef<[u8 ]>,

pub fn write_base32<W>(
    &self,
    writer: &mut W
) -> Result<(), <W as WriteBase32>::Err> where
    W: WriteBase32,

Encode as base32 and write it to the supplied writer Implementations shouldnât allocate. Read more

fn to_base32(&self) -> Vec<u5, Global>

Convert Self to base32 vector

fn to_base32(&self) -> Vec<u5, Global>â
Notable traits for Vec<u8, A>
`impl<A> Write for Vec<u8, A> where A: Allocator,`

Convert Self to base32 vector

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

pub fn clone_into(&self, target: &mut T)

ð¬ This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/fn.version.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/fn.version.html index 91b68dbc81..b5a3aab062 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/fn.version.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/fn.version.html @@ -6,6 +6,6 @@ logo

Function bdk::version

source Â· [−]

pub fn version() -> &'static str

Expand description

Get the version of BDK at runtime

Function bdk::version

source Â· [−]

pub fn version() -> &'static str

Expand description

Get the version of BDK at runtime

\ No newline at end of file diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/index.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/index.html index ea8d338337..38689f00f4 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/index.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/index.html @@ -6,7 +6,7 @@ logo

Crate bdk

source Â· [−]

Expand description

A modern, lightweight, descriptor-based wallet library written in Rust.

Crate bdk

source Â· [−]

Expand description

A modern, lightweight, descriptor-based wallet library written in Rust.

About

The BDK library aims to be the core building block for Bitcoin wallets of any kind.

key-value-db: key value database based on sled for caching blockchain data

Re-exports

pub extern crate bitcoin;

pub extern crate electrum_client;

pub extern crate miniscript;

pub extern crate rusqlite;

pub extern crate sled;

pub use descriptor::template;

pub use descriptor::HdKeyPaths;

pub use wallet::address_validator;

pub use wallet::signer;

pub use wallet::signer::SignOptions;

pub use wallet::tx_builder::TxBuilder;

pub use wallet::SyncOptions;

pub use wallet::Wallet;

Modules

pub extern crate bitcoin;

pub extern crate bitcoincore_rpc;

pub extern crate electrum_client;

pub extern crate esplora_client;

pub extern crate miniscript;

pub extern crate rusqlite;

pub extern crate sled;

pub use descriptor::template;

pub use descriptor::HdKeyPaths;

pub use wallet::address_validator;

pub use wallet::signer;

pub use wallet::signer::SignOptions;

pub use wallet::tx_builder::TxBuilder;

pub use wallet::SyncOptions;

pub use wallet::Wallet;

Modules

blockchain

Blockchain backends

database

Database types

descriptor

Descriptors

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/bip39/struct.Mnemonic.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/bip39/struct.Mnemonic.html index 844a3783d3..b1e53011ee 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/bip39/struct.Mnemonic.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/bip39/struct.Mnemonic.html @@ -47,7 +47,7 @@ returned, containing the possible languages.

pub fn to_entropy_array(&self) -> ([u8 ; 33], usize )

Convert the mnemonic back to the entropy used to generate it. The return value is a byte array and the size. Use Mnemonic::to_entropy (needs std) to get a Vec.

pub fn to_entropy(&self) -> Vec<u8, Global>

Convert the mnemonic back to the entropy used to generate it.

pub fn to_entropy(&self) -> Vec<u8, Global>â
Notable traits for Vec<u8, A>
`impl<A> Write for Vec<u8, A> where A: Allocator,`

Convert the mnemonic back to the entropy used to generate it.

Trait Implementations

impl Clone for Mnemonic

pub fn clone(&self) -> Mnemonic

Returns a copy of the value. Read more

1.0.0 Â· source

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

impl Debug for Mnemonic

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more

diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/trait.ScriptContext.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/trait.ScriptContext.html index 3302f52e2f..0561acb6fb 100644 --- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/trait.ScriptContext.html +++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/keys/trait.ScriptContext.html @@ -91,5 +91,5 @@ ones for satisfaction

fn top_level_type_check<Pk>(ms: &Miniscript<Pk, Self>) -> Result<(), Error> where
Pk: MiniscriptKey,

Check whether the top-level is type B

fn other_top_level_checks<Pk>(_ms: &Miniscript<Pk, Self>) -> Result<(), Error> where
Pk: MiniscriptKey,

Other top level checks that are context specific

fn top_level_checks<Pk>(ms: &Miniscript<Pk, Self>) -> Result<(), Error> where
Pk: MiniscriptKey,

Check top level consensus rules.

Implementations on Foreign Types

impl ScriptContext for Tap

type Key = XOnlyPublicKey

pub fn check_terminal_non_malleable<Pk>(
_frag: &Terminal<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_witness<Pk>(
witness: &[Vec<u8, Global>]
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_global_consensus_validity<Pk>(
ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_local_consensus_validity<Pk>(
ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_global_policy_validity<Pk>(
_ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_local_policy_validity<Pk>(
_ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn max_satisfaction_size<Pk>(ms: &Miniscript<Pk, Tap>) -> Option<usize> where
Pk: MiniscriptKey,

pub fn sig_type() -> SigType

pub fn pk_len<Pk>(_pk: &Pk) -> usize where
Pk: MiniscriptKey,

pub fn name_str() -> &'static str

impl ScriptContext for BareCtx

type Key = PublicKey

pub fn check_terminal_non_malleable<Pk>(
_frag: &Terminal<Pk, BareCtx>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_global_consensus_validity<Pk>(
ms: &Miniscript<Pk, BareCtx>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_local_consensus_validity<Pk>(
ms: &Miniscript<Pk, BareCtx>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn other_top_level_checks<Pk>(
ms: &Miniscript<Pk, BareCtx>
) -> Result<(), Error> where
Pk: MiniscriptKey,

pub fn max_satisfaction_size<Pk>(ms: &Miniscript<Pk, BareCtx>) -> Option<usize> where
Pk: MiniscriptKey,

pub fn pk_len<Pk>(pk: &Pk) -> usize where
Pk: MiniscriptKey,

pub fn name_str() -> &'static str

pub fn sig_type() -> SigType

Implementors

impl ScriptContext for Legacy

type Key = PublicKey

impl ScriptContext for Segwitv0

type Key = PublicKey

Implementations on Foreign Types

impl ScriptContext for BareCtx

type Key = PublicKey

pub fn check_terminal_non_malleable<Pk>(
_frag: &Terminal<Pk, BareCtx>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_global_consensus_validity<Pk>(
ms: &Miniscript<Pk, BareCtx>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_local_consensus_validity<Pk>(
ms: &Miniscript<Pk, BareCtx>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn other_top_level_checks<Pk>(
ms: &Miniscript<Pk, BareCtx>
) -> Result<(), Error> where
Pk: MiniscriptKey,

pub fn max_satisfaction_size<Pk>(ms: &Miniscript<Pk, BareCtx>) -> Option<usize> where
Pk: MiniscriptKey,

pub fn pk_len<Pk>(pk: &Pk) -> usize where
Pk: MiniscriptKey,

pub fn name_str() -> &'static str

pub fn sig_type() -> SigType

impl ScriptContext for Tap

type Key = XOnlyPublicKey

pub fn check_terminal_non_malleable<Pk>(
_frag: &Terminal<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_witness<Pk>(
witness: &[Vec<u8, Global>]
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_global_consensus_validity<Pk>(
ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_local_consensus_validity<Pk>(
ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_global_policy_validity<Pk>(
_ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn check_local_policy_validity<Pk>(
_ms: &Miniscript<Pk, Tap>
) -> Result<(), ScriptContextError> where
Pk: MiniscriptKey,

pub fn max_satisfaction_size<Pk>(ms: &Miniscript<Pk, Tap>) -> Option<usize> where
Pk: MiniscriptKey,

pub fn sig_type() -> SigType

pub fn pk_len<Pk>(_pk: &Pk) -> usize where
Pk: MiniscriptKey,

pub fn name_str() -> &'static str

Implementors

impl ScriptContext for Legacy

type Key = PublicKey

impl ScriptContext for Segwitv0

type Key = PublicKey

BlockTime

Struct bdk::BlockTime

source Â· [−]

pub struct BlockTime {
     pub height: u32,
@@ -18,6 +18,7 @@

source

impl Debug for BlockTime

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

source

impl Default for BlockTime

source

fn default() -> BlockTime

Returns the âdefault valueâ for a type. Read more

source

impl<'de> Deserialize<'de> for BlockTime

source

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

source

impl From<BlockTime> for BlockTime
This is supported on crate feature esplora only.

source

fn from(_: BlockTime) -> Self

Performs the conversion.

source

impl PartialEq<BlockTime> for BlockTime

source

fn eq(&self, other: &BlockTime) -> bool

This method tests for self and other values to be equal, and is used by ==. Read more

source

fn ne(&self, other: &BlockTime) -> bool

This method tests for !=.


@@ -25,7 +26,7 @@ by ==. source
impl Eq for BlockTime

source

impl StructuralEq for BlockTime

source

impl StructuralPartialEq for BlockTime

`Auto Trait Implementations`

impl RefUnwindSafe for BlockTime

impl Send for BlockTime

impl Sync for BlockTime

impl Unpin for BlockTime

impl UnwindSafe for BlockTime

`Blanket Implementations`

source

impl<T> Any for T where
    T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
    T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
    T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T, U> Into<U> for T where
    U: From<T>,

const: unstable Â· source

pub fn into(self) -> U

Performs the conversion.

impl<T> Pointable for T

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.


diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/index.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/index.html
new file mode 100644
index 0000000000..b215321a49
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/index.html
@@ -0,0 +1,14 @@
+bdk::wallet::hardwaresigner - Rust
+    
+        
+    
+    
+                    
+        Module hardwaresigner
Structs

+                        

+    Module bdk::wallet::hardwaresigner
source Â· [−]
This is supported on crate feature hardware-signer only.
Expand description
HWI Signer
+This module contains a simple implementation of a Custom signer for rust-hwi
+
Structs
+HWISigner
Custom signer for Hardware Wallets
+

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/sidebar-items.js b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/sidebar-items.js
new file mode 100644
index 0000000000..3fd6588450
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/sidebar-items.js
@@ -0,0 +1 @@
+initSidebarItems({"struct":[["HWISigner","Custom signer for Hardware Wallets"]]});
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/struct.HWISigner.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/struct.HWISigner.html
new file mode 100644
index 0000000000..ed459eb787
--- /dev/null
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/hardwaresigner/struct.HWISigner.html
@@ -0,0 +1,33 @@
+HWISigner in bdk::wallet::hardwaresigner - Rust
+    
+        
+    
+    
+                    
+        HWISigner
Associated Constants
ALIGN
Methods
from_device
Trait Implementations
DebugSignerCommonTransactionSigner
Auto Trait Implementations
!RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableTryFrom<U>TryInto<U>VZip<V>
In bdk::wallet::hardwaresigner

+                        

+    Struct bdk::wallet::hardwaresigner::HWISigner
source Â· [−]
pub struct HWISigner { /* private fields */ }
This is supported on crate feature hardware-signer only.
Expand description
Custom signer for Hardware Wallets
+This ignores sign_options and leaves the decisions up to the hardware wallet.
+
Implementations
source
impl HWISigner
source
pub fn from_device(
    device: &HWIDevice, 
    chain: HWIChain
) -> Result<HWISigner, Error>
Create a instance from the specified device and chain
+
Trait Implementations
source
impl Debug for HWISigner
source
fn fmt(&self, f: &mut Formatter<'_>) -> Result
Formats the value using the given formatter. Read more
+
source
impl SignerCommon for HWISigner
source
fn id(&self, _secp: &Secp256k1<All>) -> SignerId
Return the SignerId for this signer Read more
+
source
fn descriptor_secret_key(&self) -> Option<DescriptorSecretKey>
Return the secret key for the signer Read more
+
source
impl TransactionSigner for HWISigner
This implementation ignores sign_options
+
source
fn sign_transaction(
    &self, 
    psbt: &mut PartiallySignedTransaction, 
    _sign_options: &SignOptions, 
    _secp: &Secp256k1<All>
) -> Result<(), SignerError>
Sign all the inputs of the psbt
+
Auto Trait Implementations
impl !RefUnwindSafe for HWISigner
impl Send for HWISigner
impl Sync for HWISigner
impl Unpin for HWISigner
impl UnwindSafe for HWISigner
Blanket Implementations
source
impl<T> Any for T where
    T: 'static + ?Sized, 
source
pub fn type_id(&self) -> TypeId
Gets the TypeId of self. Read more
+
source
impl<T> Borrow<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow(&self) -> &T
Immutably borrows from an owned value. Read more
+
source
impl<T> BorrowMut<T> for T where
    T: ?Sized, 
const: unstable Â· source
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
+
source
impl<T> From<T> for T
const: unstable Â· source
pub fn from(t: T) -> T
Performs the conversion.
+
source
impl<T, U> Into<U> for T where
    U: From<T>, 
const: unstable Â· source
pub fn into(self) -> U
Performs the conversion.
+
impl<T> Pointable for T
pub const ALIGN: usize
The alignment of pointer.
+
type Init = T
The type for initializers.
+
pub unsafe fn init(init: <T as Pointable>::Init) -> usize
Initializes a with the given initializer. Read more
+
pub unsafe fn deref<'a>(ptr: usize) -> &'a T
Dereferences the given pointer. Read more
+
pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T
Mutably dereferences the given pointer. Read more
+
pub unsafe fn drop(ptr: usize)
Drops the object pointed to by the given pointer. Read more
+
source
impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
type Error = Infallible
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
Performs the conversion.
+
source
impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
+
const: unstable Â· source
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
Performs the conversion.
+
impl<V, T> VZip<V> for T where
    V: MultiLane<T>, 
pub fn vzip(self) -> V

+
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/index.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/index.html
index 2bffd1d53e..dc42bce114 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/index.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/index.html
@@ -12,9 +12,11 @@
 address_validator
Address validation callbacks
 
coin_selection
Coin selection
 
export
Wallet export
+
hardwaresignerhardware-signer
HWI Signer
 
signer
Generalized signers
 
time
Cross-platform time
 
tx_builder
Transaction builder
+
verifyverify
Verify transactions against the consensus rules
 
Structs

AddressInfo

A derived address and the index it was found at
 For convenience this automatically derefs to Address
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/sidebar-items.js b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/sidebar-items.js
index 84881bfbb6..82f860a114 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/sidebar-items.js
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/sidebar-items.js
@@ -1 +1 @@
-initSidebarItems({"enum":[["AddressIndex","The address index selection strategy to use to derived an address from the walletâs external descriptor. See [`Wallet::get_address`]. If youâre unsure which one to use use `WalletIndex::New`."]],"fn":[["get_funded_wallet","Return a fake wallet that appears to be funded for testing."],["wallet_name_from_descriptor","Deterministically generate a unique name given the descriptors defining the wallet"]],"mod":[["address_validator","Address validation callbacks"],["coin_selection","Coin selection"],["export","Wallet export"],["signer","Generalized signers"],["time","Cross-platform time"],["tx_builder","Transaction builder"]],"struct":[["AddressInfo","A derived address and the index it was found at For convenience this automatically derefs to `Address`"],["SyncOptions","Options to a `sync`."],["Wallet","A Bitcoin wallet"]],"trait":[["IsDust","Trait to check if a value is below the dust limit. We are performing dust value calculation for a given script public key using rust-bitcoin to keep it compatible with network dust rate"]]});
\ No newline at end of file
+initSidebarItems({"enum":[["AddressIndex","The address index selection strategy to use to derived an address from the walletâs external descriptor. See [`Wallet::get_address`]. If youâre unsure which one to use use `WalletIndex::New`."]],"fn":[["get_funded_wallet","Return a fake wallet that appears to be funded for testing."],["wallet_name_from_descriptor","Deterministically generate a unique name given the descriptors defining the wallet"]],"mod":[["address_validator","Address validation callbacks"],["coin_selection","Coin selection"],["export","Wallet export"],["hardwaresigner","HWI Signer"],["signer","Generalized signers"],["time","Cross-platform time"],["tx_builder","Transaction builder"],["verify","Verify transactions against the consensus rules"]],"struct":[["AddressInfo","A derived address and the index it was found at For convenience this automatically derefs to `Address`"],["SyncOptions","Options to a `sync`."],["Wallet","A Bitcoin wallet"]],"trait":[["IsDust","Trait to check if a value is below the dust limit. We are performing dust value calculation for a given script public key using rust-bitcoin to keep it compatible with network dust rate"]]});
\ No newline at end of file
diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/enum.SignerError.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/enum.SignerError.html
index 473cc910bc..9d19b8fdc5 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/enum.SignerError.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/enum.SignerError.html
@@ -4,10 +4,10 @@
     
     
                     
-        SignerError
Variants
InputIndexOutOfRangeInvalidKeyInvalidNonWitnessUtxoInvalidSighashMissingHdKeypathMissingKeyMissingNonWitnessUtxoMissingWitnessScriptMissingWitnessUtxoNonStandardSighashSighashErrorUserCanceled
Associated Constants
ALIGN
Trait Implementations
CloneDebugDisplayEqErrorFrom<Error>From<SignerError>PartialEq<SignerError>StructuralEqStructuralPartialEq
Auto Trait Implementations
RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableToOwnedToStringTryFrom<U>TryInto<U>VZip<V>
In bdk::wallet::signer


+        SignerError
Variants
HWIErrorInputIndexOutOfRangeInvalidKeyInvalidNonWitnessUtxoInvalidSighashMissingHdKeypathMissingKeyMissingNonWitnessUtxoMissingWitnessScriptMissingWitnessUtxoNonStandardSighashSighashErrorUserCanceled
Associated Constants
ALIGN
Trait Implementations
CloneDebugDisplayEqErrorFrom<Error>From<SignerError>PartialEq<SignerError>StructuralEqStructuralPartialEq
Auto Trait Implementations
RefUnwindSafeSendSyncUnpinUnwindSafe
Blanket Implementations
AnyBorrow<T>BorrowMut<T>From<T>Into<U>PointableToOwnedToStringTryFrom<U>TryInto<U>VZip<V>
In bdk::wallet::signer


                         

     Enum bdk::wallet::signer::SignerError
source Â· [−]
pub enum SignerError {
-    MissingKey,
+Show 13 variants    MissingKey,
     InvalidKey,
     UserCanceled,
     InputIndexOutOfRange,
@@ -19,7 +19,8 @@
     NonStandardSighash,
     InvalidSighash,
     SighashError(Error),
-}
Expand description
Signing error
+    HWIError(Error),
+
}

Expand description

Signing error

`Variants`

`MissingKey`

The private key is missing for the required public key

`InvalidKey`

The private key in use has the right fingerprint but derives differently than expected

`UserCanceled`

The user canceled the operation


@@ -35,6 +36,7 @@ explicitly allowed them
 SignOptions::allow_all_sighashes to true.

`InvalidSighash`

Invalid SIGHASH for the signing context in use

`SighashError(Error)`

Error while computing the hash to sign

`HWIError(Error)`

Error while signing using hardware wallets

`Trait Implementations`

source

impl Clone for SignerError

source

fn clone(&self) -> SignerError

Returns a copy of the value. Read more

1.0.0 Â· source

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

source

impl Debug for SignerError

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more


@@ -43,7 +45,8 @@ explicitly allowed them

source

fn backtrace(&self) -> Option<&Backtrace>

ð¬ This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred. Read more

1.0.0 Â· source

fn description(&self) -> &str

ð Deprecated since 1.42.0: use the Display impl or to_string()

Read more

1.0.0 Â· source

fn cause(&self) -> Option<&dyn Error>

ð Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
-

source

impl From<Error> for SignerError

source

fn from(e: Error) -> Self

Performs the conversion.

source

impl From<Error> for SignerError

source

fn from(e: Error) -> Self

Performs the conversion.

source

impl From<Error> for SignerError

source

fn from(e: Error) -> Self

Performs the conversion.

source

impl From<SignerError> for Error

source

fn from(err: SignerError) -> Self

Performs the conversion.

source

impl PartialEq<SignerError> for SignerError

source

fn eq(&self, other: &SignerError) -> bool

This method tests for self and other values to be equal, and is used by ==. Read more


@@ -51,7 +54,7 @@ by ==. source
impl Eq for SignerError

source

impl StructuralEq for SignerError

source

impl StructuralPartialEq for SignerError

`Auto Trait Implementations`

impl RefUnwindSafe for SignerError

impl Send for SignerError

impl Sync for SignerError

impl Unpin for SignerError

impl UnwindSafe for SignerError

`Blanket Implementations`

source

impl<T> Any for T where
    T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
    T: ?Sized,

const: unstable Â· source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
    T: ?Sized,

const: unstable Â· source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T> From<T> for T

const: unstable Â· source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T, U> Into<U> for T where
    U: From<T>,

const: unstable Â· source

pub fn into(self) -> U

Performs the conversion.

impl<T> Pointable for T

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.


diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/struct.SignersContainer.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/struct.SignersContainer.html
index 863470af1e..9563d5b83c 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/struct.SignersContainer.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/struct.SignersContainer.html
@@ -15,8 +15,8 @@ the signers

source

pub fn add_external(
    &mut self, 
    id: SignerId, 
    ordering: SignerOrdering, 
    signer: Arc<dyn TransactionSigner>
) -> Option<Arc<dyn TransactionSigner>>

Adds an external signer to the container for the specified id. Optionally returns the signer that was previously in the container, if any

source

pub fn remove(
    &mut self, 
    id: SignerId, 
    ordering: SignerOrdering
) -> Option<Arc<dyn TransactionSigner>>

Removes a signer from the container and returns it

source

pub fn ids(&self) -> Vec<&SignerId>

Returns the list of identifiers of all the signers in the container

source

pub fn signers(&self) -> Vec<&Arc<dyn TransactionSigner>>

Returns the list of signers in the container, sorted by lowest to highest ordering

source

pub fn ids(&self) -> Vec<&SignerId>âNotable traits for Vec<u8, A>
impl<A> Write for Vec<u8, A> where
    A: Allocator,

Returns the list of identifiers of all the signers in the container

source

pub fn signers(&self) -> Vec<&Arc<dyn TransactionSigner>>âNotable traits for Vec<u8, A>
impl<A> Write for Vec<u8, A> where
    A: Allocator,

Returns the list of signers in the container, sorted by lowest to highest ordering

source

pub fn find(&self, id: SignerId) -> Option<&Arc<dyn TransactionSigner>>

Finds the signer with lowest ordering for a given id in the container.

`Trait Implementations`

source

impl Clone for SignersContainer

source

fn clone(&self) -> SignersContainer

Returns a copy of the value. Read more

1.0.0 Â· source

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more


diff --git a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/trait.SignerCommon.html b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/trait.SignerCommon.html
index 36fb3821c4..826d44f3f1 100644
--- a/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/trait.SignerCommon.html
+++ b/docs/.vuepress/public/docs-rs/bdk/nightly/latest/bdk/wallet/signer/trait.SignerCommon.html
@@ -18,5 +18,5 @@ compare two signers.
 This is used internally to reconstruct the original descriptor that may contain secrets.
 External signers that are meant to keep key isolated should just return None here (which
 is the default for this method, if not overridden).
-

`Implementors`

source

impl SignerCommon for SignerWrapper<DescriptorXKey<ExtendedPrivKey>>

source

impl SignerCommon for SignerWrapper<PrivateKey>

`Implementors`

source

impl SignerCommon for HWISigner
This is supported on crate feature hardware-signer only.

source

impl SignerCommon for SignerWrapper<DescriptorXKey<ExtendedPrivKey>>

source

impl SignerCommon for SignerWrapper<PrivateKey>

// Bitcoin Dev Kit
+// Written in 2021 by Riccardo Casatta <riccardo@casatta.it>
+//
+// Copyright (c) 2020-2021 Bitcoin Dev Kit Developers
+//
+// This file is licensed under the Apache License, Version 2.0 <LICENSE-APACHE
+// or http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
+// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your option.
+// You may not use this file except in accordance with one or both of these
+// licenses.
+
+//! Rpc Blockchain
+//!
+//! Backend that gets blockchain data from Bitcoin Core RPC
+//!
+//! This is an **EXPERIMENTAL** feature, API and other major changes are expected.
+//!
+//! ## Example
+//!
+//! ```no_run
+//! # use bdk::blockchain::{RpcConfig, RpcBlockchain, ConfigurableBlockchain, rpc::Auth};
+//! let config = RpcConfig {
+//!     url: "127.0.0.1:18332".to_string(),
+//!     auth: Auth::Cookie {
+//!         file: "/home/user/.bitcoin/.cookie".into(),
+//!     },
+//!     network: bdk::bitcoin::Network::Testnet,
+//!     wallet_name: "wallet_name".to_string(),
+//!     sync_params: None,
+//! };
+//! let blockchain = RpcBlockchain::from_config(&config);
+//! ```
+
+use crate::bitcoin::hashes::hex::ToHex;
+use crate::bitcoin::{Network, OutPoint, Transaction, TxOut, Txid};
+use crate::blockchain::*;
+use crate::database::{BatchDatabase, BatchOperations, DatabaseUtils};
+use crate::descriptor::get_checksum;
+use crate::error::MissingCachedScripts;
+use crate::{BlockTime, Error, FeeRate, KeychainKind, LocalUtxo, TransactionDetails};
+use bitcoin::Script;
+use bitcoincore_rpc::json::{
+    GetTransactionResultDetailCategory, ImportMultiOptions, ImportMultiRequest,
+    ImportMultiRequestScriptPubkey, ImportMultiRescanSince, ListTransactionResult,
+    ListUnspentResultEntry, ScanningDetails,
+};
+use bitcoincore_rpc::jsonrpc::serde_json::{json, Value};
+use bitcoincore_rpc::Auth as RpcAuth;
+use bitcoincore_rpc::{Client, RpcApi};
+use log::{debug, info};
+use serde::{Deserialize, Serialize};
+use std::collections::{HashMap, HashSet};
+use std::ops::Deref;
+use std::path::PathBuf;
+use std::thread;
+use std::time::Duration;
+
+/// The main struct for RPC backend implementing the [crate::blockchain::Blockchain] trait
+#[derive(Debug)]
+pub struct RpcBlockchain {
+    /// Rpc client to the node, includes the wallet name
+    client: Client,
+    /// Whether the wallet is a "descriptor" or "legacy" wallet in Core
+    is_descriptors: bool,
+    /// Blockchain capabilities, cached here at startup
+    capabilities: HashSet<Capability>,
+    /// Sync parameters.
+    sync_params: RpcSyncParams,
+}
+
+impl Deref for RpcBlockchain {
+    type Target = Client;
+
+    fn deref(&self) -> &Self::Target {
+        &self.client
+    }
+}
+
+/// RpcBlockchain configuration options
+#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
+pub struct RpcConfig {
+    /// The bitcoin node url
+    pub url: String,
+    /// The bitcoin node authentication mechanism
+    pub auth: Auth,
+    /// The network we are using (it will be checked the bitcoin node network matches this)
+    pub network: Network,
+    /// The wallet name in the bitcoin node, consider using [crate::wallet::wallet_name_from_descriptor] for this
+    pub wallet_name: String,
+    /// Sync parameters
+    pub sync_params: Option<RpcSyncParams>,
+}
+
+/// Sync parameters for Bitcoin Core RPC.
+///
+/// In general, BDK tries to sync `scriptPubKey`s cached in [`crate::database::Database`] with
+/// `scriptPubKey`s imported in the Bitcoin Core Wallet. These parameters are used for determining
+/// how the `importdescriptors` RPC calls are to be made.
+#[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
+pub struct RpcSyncParams {
+    /// The minimum number of scripts to scan for on initial sync.
+    pub start_script_count: usize,
+    /// Time in unix seconds in which initial sync will start scanning from (0 to start from genesis).
+    pub start_time: u64,
+    /// Forces every sync to use `start_time` as import timestamp.
+    pub force_start_time: bool,
+    /// RPC poll rate (in seconds) to get state updates.
+    pub poll_rate_sec: u64,
+}
+
+impl Default for RpcSyncParams {
+    fn default() -> Self {
+        Self {
+            start_script_count: 100,
+            start_time: 0,
+            force_start_time: false,
+            poll_rate_sec: 3,
+        }
+    }
+}
+
+/// This struct is equivalent to [bitcoincore_rpc::Auth] but it implements [serde::Serialize]
+/// To be removed once upstream equivalent is implementing Serialize (json serialization format
+/// should be the same), see [rust-bitcoincore-rpc/pull/181](https://github.com/rust-bitcoin/rust-bitcoincore-rpc/pull/181)
+#[derive(Clone, Debug, Hash, Eq, PartialEq, Ord, PartialOrd, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+#[serde(untagged)]
+pub enum Auth {
+    /// None authentication
+    None,
+    /// Authentication with username and password, usually [Auth::Cookie] should be preferred
+    UserPass {
+        /// Username
+        username: String,
+        /// Password
+        password: String,
+    },
+    /// Authentication with a cookie file
+    Cookie {
+        /// Cookie file
+        file: PathBuf,
+    },
+}
+
+impl From<Auth> for RpcAuth {
+    fn from(auth: Auth) -> Self {
+        match auth {
+            Auth::None => RpcAuth::None,
+            Auth::UserPass { username, password } => RpcAuth::UserPass(username, password),
+            Auth::Cookie { file } => RpcAuth::CookieFile(file),
+        }
+    }
+}
+
+impl Blockchain for RpcBlockchain {
+    fn get_capabilities(&self) -> HashSet<Capability> {
+        self.capabilities.clone()
+    }
+
+    fn broadcast(&self, tx: &Transaction) -> Result<(), Error> {
+        Ok(self.client.send_raw_transaction(tx).map(|_| ())?)
+    }
+
+    fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error> {
+        let sat_per_kb = self
+            .client
+            .estimate_smart_fee(target as u16, None)?
+            .fee_rate
+            .ok_or(Error::FeeRateUnavailable)?
+            .as_sat() as f64;
+
+        Ok(FeeRate::from_sat_per_vb((sat_per_kb / 1000f64) as f32))
+    }
+}
+
+impl GetTx for RpcBlockchain {
+    fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error> {
+        Ok(Some(self.client.get_raw_transaction(txid, None)?))
+    }
+}
+
+impl GetHeight for RpcBlockchain {
+    fn get_height(&self) -> Result<u32, Error> {
+        Ok(self.client.get_blockchain_info().map(|i| i.blocks as u32)?)
+    }
+}
+
+impl GetBlockHash for RpcBlockchain {
+    fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error> {
+        Ok(self.client.get_block_hash(height)?)
+    }
+}
+
+impl WalletSync for RpcBlockchain {
+    fn wallet_setup<D>(&self, db: &mut D, prog: Box<dyn Progress>) -> Result<(), Error>
+    where
+        D: BatchDatabase,
+    {
+        let batch = DbState::new(db, &self.sync_params, &*prog)?
+            .sync_with_core(&self.client, self.is_descriptors)?
+            .as_db_batch()?;
+
+        db.commit_batch(batch)
+    }
+}
+
+impl ConfigurableBlockchain for RpcBlockchain {
+    type Config = RpcConfig;
+
+    /// Returns RpcBlockchain backend creating an RPC client to a specific wallet named as the descriptor's checksum
+    /// if it's the first time it creates the wallet in the node and upon return is granted the wallet is loaded
+    fn from_config(config: &Self::Config) -> Result<Self, Error> {
+        let wallet_url = format!("{}/wallet/{}", config.url, &config.wallet_name);
+
+        let client = Client::new(wallet_url.as_str(), config.auth.clone().into())?;
+        let rpc_version = client.version()?;
+
+        info!("connected to '{}' with auth: {:?}", wallet_url, config.auth);
+
+        if client.list_wallets()?.contains(&config.wallet_name) {
+            info!("wallet already loaded: {}", config.wallet_name);
+        } else if list_wallet_dir(&client)?.contains(&config.wallet_name) {
+            client.load_wallet(&config.wallet_name)?;
+            info!("wallet loaded: {}", config.wallet_name);
+        } else {
+            // pre-0.21 use legacy wallets
+            if rpc_version < 210_000 {
+                client.create_wallet(&config.wallet_name, Some(true), None, None, None)?;
+            } else {
+                // TODO: move back to api call when https://github.com/rust-bitcoin/rust-bitcoincore-rpc/issues/225 is closed
+                let args = [
+                    Value::String(config.wallet_name.clone()),
+                    Value::Bool(true),
+                    Value::Bool(false),
+                    Value::Null,
+                    Value::Bool(false),
+                    Value::Bool(true),
+                ];
+                let _: Value = client.call("createwallet", &args)?;
+            }
+
+            info!("wallet created: {}", config.wallet_name);
+        }
+
+        let is_descriptors = is_wallet_descriptor(&client)?;
+
+        let blockchain_info = client.get_blockchain_info()?;
+        let network = match blockchain_info.chain.as_str() {
+            "main" => Network::Bitcoin,
+            "test" => Network::Testnet,
+            "regtest" => Network::Regtest,
+            "signet" => Network::Signet,
+            _ => return Err(Error::Generic("Invalid network".to_string())),
+        };
+        if network != config.network {
+            return Err(Error::InvalidNetwork {
+                requested: config.network,
+                found: network,
+            });
+        }
+
+        let mut capabilities: HashSet<_> = vec![Capability::FullHistory].into_iter().collect();
+        if rpc_version >= 210_000 {
+            let info: HashMap<String, Value> = client.call("getindexinfo", &[]).unwrap();
+            if info.contains_key("txindex") {
+                capabilities.insert(Capability::GetAnyTx);
+                capabilities.insert(Capability::AccurateFees);
+            }
+        }
+
+        Ok(RpcBlockchain {
+            client,
+            capabilities,
+            is_descriptors,
+            sync_params: config.sync_params.clone().unwrap_or_default(),
+        })
+    }
+}
+
+/// return the wallets available in default wallet directory
+//TODO use bitcoincore_rpc method when PR #179 lands
+fn list_wallet_dir(client: &Client) -> Result<Vec<String>, Error> {
+    #[derive(Deserialize)]
+    struct Name {
+        name: String,
+    }
+    #[derive(Deserialize)]
+    struct CallResult {
+        wallets: Vec<Name>,
+    }
+
+    let result: CallResult = client.call("listwalletdir", &[])?;
+    Ok(result.wallets.into_iter().map(|n| n.name).collect())
+}
+
+/// Represents the state of the [`crate::database::Database`].
+struct DbState<'a, D> {
+    db: &'a D,
+    params: &'a RpcSyncParams,
+    prog: &'a dyn Progress,
+
+    ext_spks: Vec<Script>,
+    int_spks: Vec<Script>,
+    txs: HashMap<Txid, TransactionDetails>,
+    utxos: HashSet<LocalUtxo>,
+    last_indexes: HashMap<KeychainKind, u32>,
+
+    // "deltas" to apply to database
+    retained_txs: HashSet<Txid>, // txs to retain (everything else should be deleted)
+    updated_txs: HashSet<Txid>,  // txs to update
+    updated_utxos: HashSet<LocalUtxo>, // utxos to update
+}
+
+impl<'a, D: BatchDatabase> DbState<'a, D> {
+    /// Obtain [DbState] from [crate::database::Database].
+    fn new(db: &'a D, params: &'a RpcSyncParams, prog: &'a dyn Progress) -> Result<Self, Error> {
+        let ext_spks = db.iter_script_pubkeys(Some(KeychainKind::External))?;
+        let int_spks = db.iter_script_pubkeys(Some(KeychainKind::Internal))?;
+
+        // This is a hack to see whether atleast one of the keychains comes from a derivable
+        // descriptor. We assume that non-derivable descriptors always has a script count of 1.
+        let last_count = std::cmp::max(ext_spks.len(), int_spks.len());
+        let has_derivable = last_count > 1;
+
+        // If at least one descriptor is derivable, we need to ensure scriptPubKeys are sufficiently
+        // cached.
+        if has_derivable && last_count < params.start_script_count {
+            let inner_err = MissingCachedScripts {
+                last_count,
+                missing_count: params.start_script_count - last_count,
+            };
+            debug!("requesting more spks with: {:?}", inner_err);
+            return Err(Error::MissingCachedScripts(inner_err));
+        }
+
+        let txs = db
+            .iter_txs(true)?
+            .into_iter()
+            .map(|tx| (tx.txid, tx))
+            .collect::<HashMap<_, _>>();
+
+        let utxos = db.iter_utxos()?.into_iter().collect::<HashSet<_>>();
+
+        let last_indexes = [KeychainKind::External, KeychainKind::Internal]
+            .iter()
+            .filter_map(|keychain| match db.get_last_index(*keychain) {
+                Ok(li_opt) => li_opt.map(|li| Ok((*keychain, li))),
+                Err(err) => Some(Err(err)),
+            })
+            .collect::<Result<HashMap<_, _>, Error>>()?;
+
+        info!("initial db state: txs={} utxos={}", txs.len(), utxos.len());
+
+        // "delta" fields
+        let retained_txs = HashSet::with_capacity(txs.len());
+        let updated_txs = HashSet::with_capacity(txs.len());
+        let updated_utxos = HashSet::with_capacity(utxos.len());
+
+        Ok(Self {
+            db,
+            params,
+            prog,
+            ext_spks,
+            int_spks,
+            txs,
+            utxos,
+            last_indexes,
+            retained_txs,
+            updated_txs,
+            updated_utxos,
+        })
+    }
+
+    /// Sync states of [BatchDatabase] and Core wallet.
+    /// First we import all `scriptPubKey`s from database into core wallet
+    fn sync_with_core(&mut self, client: &Client, is_descriptor: bool) -> Result<&mut Self, Error> {
+        // this tells Core wallet where to sync from for imported scripts
+        let start_epoch = if self.params.force_start_time {
+            self.params.start_time
+        } else {
+            self.db
+                .get_sync_time()?
+                .map_or(self.params.start_time, |st| st.block_time.timestamp)
+        };
+
+        // sync scriptPubKeys from Database to Core wallet
+        let scripts_iter = self.ext_spks.iter().chain(&self.int_spks);
+        if is_descriptor {
+            import_descriptors(client, start_epoch, scripts_iter)?;
+        } else {
+            import_multi(client, start_epoch, scripts_iter)?;
+        }
+
+        // wait for Core wallet to rescan (TODO: maybe make this async)
+        await_wallet_scan(client, self.params.poll_rate_sec, self.prog)?;
+
+        // obtain iterator of pagenated `listtransactions` RPC calls
+        const LIST_TX_PAGE_SIZE: usize = 100; // item count per page
+        let tx_iter = list_transactions(client, LIST_TX_PAGE_SIZE)?.filter(|item| {
+            // filter out conflicting transactions - only accept transactions that are already
+            // confirmed, or exists in mempool
+            item.info.confirmations > 0 || client.get_mempool_entry(&item.info.txid).is_ok()
+        });
+
+        // iterate through chronological results of `listtransactions`
+        for tx_res in tx_iter {
+            let mut updated = false;
+
+            let db_tx = self.txs.entry(tx_res.info.txid).or_insert_with(|| {
+                updated = true;
+                TransactionDetails {
+                    txid: tx_res.info.txid,
+                    ..Default::default()
+                }
+            });
+
+            // update raw tx (if needed)
+            let raw_tx =
+                &*match &mut db_tx.transaction {
+                    Some(raw_tx) => raw_tx,
+                    db_tx_opt => {
+                        updated = true;
+                        db_tx_opt.insert(client.get_raw_transaction(
+                            &tx_res.info.txid,
+                            tx_res.info.blockhash.as_ref(),
+                        )?)
+                    }
+                };
+
+            // update fee (if needed)
+            if let (None, Some(new_fee)) = (db_tx.fee, tx_res.detail.fee) {
+                updated = true;
+                db_tx.fee = Some(new_fee.as_sat().unsigned_abs());
+            }
+
+            // update confirmation time (if needed)
+            let conf_time = BlockTime::new(tx_res.info.blockheight, tx_res.info.blocktime);
+            if db_tx.confirmation_time != conf_time {
+                updated = true;
+                db_tx.confirmation_time = conf_time;
+            }
+
+            // update received (if needed)
+            let received = Self::received_from_raw_tx(self.db, raw_tx)?;
+            if db_tx.received != received {
+                updated = true;
+                db_tx.received = received;
+            }
+
+            // check if tx has an immature coinbase output (add to updated UTXOs)
+            // this is required because `listunspent` does not include immature coinbase outputs
+            if tx_res.detail.category == GetTransactionResultDetailCategory::Immature {
+                let txout = raw_tx
+                    .output
+                    .get(tx_res.detail.vout as usize)
+                    .cloned()
+                    .ok_or_else(|| {
+                        Error::Generic(format!(
+                            "Core RPC returned detail with invalid vout '{}' for tx '{}'",
+                            tx_res.detail.vout, tx_res.info.txid,
+                        ))
+                    })?;
+
+                if let Some((keychain, index)) =
+                    self.db.get_path_from_script_pubkey(&txout.script_pubkey)?
+                {
+                    let utxo = LocalUtxo {
+                        outpoint: OutPoint::new(tx_res.info.txid, tx_res.detail.vout),
+                        txout,
+                        keychain,
+                        is_spent: false,
+                    };
+                    self.updated_utxos.insert(utxo);
+                    self.update_last_index(keychain, index);
+                }
+            }
+
+            // update tx deltas
+            self.retained_txs.insert(tx_res.info.txid);
+            if updated {
+                self.updated_txs.insert(tx_res.info.txid);
+            }
+        }
+
+        // obtain vector of `TransactionDetails::sent` changes
+        let sent_updates = self
+            .txs
+            .values()
+            // only bother to update txs that are retained
+            .filter(|db_tx| self.retained_txs.contains(&db_tx.txid))
+            // only bother to update txs where the raw tx is accessable
+            .filter_map(|db_tx| (db_tx.transaction.as_ref().map(|tx| (tx, db_tx.sent))))
+            // recalcuate sent value, only update txs in which sent value is changed
+            .filter_map(|(raw_tx, old_sent)| {
+                self.sent_from_raw_tx(raw_tx)
+                    .map(|sent| {
+                        if sent != old_sent {
+                            Some((raw_tx.txid(), sent))
+                        } else {
+                            None
+                        }
+                    })
+                    .transpose()
+            })
+            .collect::<Result<Vec<_>, _>>()?;
+
+        // record send updates
+        sent_updates.iter().for_each(|&(txid, sent)| {
+            // apply sent field changes
+            self.txs.entry(txid).and_modify(|db_tx| db_tx.sent = sent);
+            // mark tx as modified
+            self.updated_txs.insert(txid);
+        });
+
+        // obtain UTXOs from Core wallet
+        let core_utxos = client
+            .list_unspent(Some(0), None, None, Some(true), None)?
+            .into_iter()
+            .filter_map(|utxo_entry| {
+                let path_result = self
+                    .db
+                    .get_path_from_script_pubkey(&utxo_entry.script_pub_key)
+                    .transpose()?;
+
+                let utxo_result = match path_result {
+                    Ok((keychain, index)) => {
+                        self.update_last_index(keychain, index);
+                        Ok(Self::make_local_utxo(utxo_entry, keychain, false))
+                    }
+                    Err(err) => Err(err),
+                };
+
+                Some(utxo_result)
+            })
+            .collect::<Result<HashSet<_>, Error>>()?;
+
+        // mark "spent utxos" to be updated in database
+        let spent_utxos = self.utxos.difference(&core_utxos).cloned().map(|mut utxo| {
+            utxo.is_spent = true;
+            utxo
+        });
+
+        // mark new utxos to be added in database
+        let new_utxos = core_utxos.difference(&self.utxos).cloned();
+
+        // add to updated utxos
+        self.updated_utxos.extend(spent_utxos.chain(new_utxos));
+
+        Ok(self)
+    }
+
+    /// Calculates received amount from raw tx.
+    fn received_from_raw_tx(db: &D, raw_tx: &Transaction) -> Result<u64, Error> {
+        raw_tx.output.iter().try_fold(0_u64, |recv, txo| {
+            let v = if db.is_mine(&txo.script_pubkey)? {
+                txo.value
+            } else {
+                0
+            };
+            Ok(recv + v)
+        })
+    }
+
+    /// Calculates sent from raw tx.
+    fn sent_from_raw_tx(&self, raw_tx: &Transaction) -> Result<u64, Error> {
+        let get_output = |outpoint: &OutPoint| {
+            let raw_tx = self.txs.get(&outpoint.txid)?.transaction.as_ref()?;
+            raw_tx.output.get(outpoint.vout as usize)
+        };
+
+        raw_tx.input.iter().try_fold(0_u64, |sent, txin| {
+            let v = match get_output(&txin.previous_output) {
+                Some(prev_txo) => {
+                    if self.db.is_mine(&prev_txo.script_pubkey)? {
+                        prev_txo.value
+                    } else {
+                        0
+                    }
+                }
+                None => 0_u64,
+            };
+            Ok(sent + v)
+        })
+    }
+
+    // updates the db state's last_index for the given keychain (if larger than current last_index)
+    fn update_last_index(&mut self, keychain: KeychainKind, index: u32) {
+        self.last_indexes
+            .entry(keychain)
+            .and_modify(|last| {
+                if *last < index {
+                    *last = index;
+                }
+            })
+            .or_insert_with(|| index);
+    }
+
+    fn make_local_utxo(
+        entry: ListUnspentResultEntry,
+        keychain: KeychainKind,
+        is_spent: bool,
+    ) -> LocalUtxo {
+        LocalUtxo {
+            outpoint: OutPoint::new(entry.txid, entry.vout),
+            txout: TxOut {
+                value: entry.amount.as_sat(),
+                script_pubkey: entry.script_pub_key,
+            },
+            keychain,
+            is_spent,
+        }
+    }
+
+    /// Prepare db batch operations.
+    fn as_db_batch(&self) -> Result<D::Batch, Error> {
+        let mut batch = self.db.begin_batch();
+        let mut del_txs = 0_u32;
+
+        // delete stale (not retained) txs from db
+        self.txs
+            .keys()
+            .filter(|&txid| !self.retained_txs.contains(txid))
+            .try_for_each(|txid| -> Result<(), Error> {
+                batch.del_tx(txid, false)?;
+                del_txs += 1;
+                Ok(())
+            })?;
+
+        // update txs
+        self.updated_txs
+            .iter()
+            .inspect(|&txid| debug!("updating tx: {}", txid))
+            .try_for_each(|txid| batch.set_tx(self.txs.get(txid).unwrap()))?;
+
+        // update utxos
+        self.updated_utxos
+            .iter()
+            .inspect(|&utxo| debug!("updating utxo: {}", utxo.outpoint))
+            .try_for_each(|utxo| batch.set_utxo(utxo))?;
+
+        // update last indexes
+        self.last_indexes
+            .iter()
+            .try_for_each(|(&keychain, &index)| batch.set_last_index(keychain, index))?;
+
+        info!(
+            "db batch updates: del_txs={}, update_txs={}, update_utxos={}",
+            del_txs,
+            self.updated_txs.len(),
+            self.updated_utxos.len()
+        );
+
+        Ok(batch)
+    }
+}
+
+fn import_descriptors<'a, S>(
+    client: &Client,
+    start_epoch: u64,
+    scripts_iter: S,
+) -> Result<(), Error>
+where
+    S: Iterator<Item = &'a Script>,
+{
+    let requests = Value::Array(
+        scripts_iter
+            .map(|script| {
+                let desc = descriptor_from_script_pubkey(script);
+                json!({ "timestamp": start_epoch, "desc": desc })
+            })
+            .collect(),
+    );
+    for v in client.call::<Vec<Value>>("importdescriptors", &[requests])? {
+        match v["success"].as_bool() {
+            Some(true) => continue,
+            Some(false) => {
+                return Err(Error::Generic(
+                    v["error"]["message"]
+                        .as_str()
+                        .map_or("unknown error".into(), ToString::to_string),
+                ))
+            }
+            _ => return Err(Error::Generic("Unexpected response form Core".to_string())),
+        }
+    }
+    Ok(())
+}
+
+fn import_multi<'a, S>(client: &Client, start_epoch: u64, scripts_iter: S) -> Result<(), Error>
+where
+    S: Iterator<Item = &'a Script>,
+{
+    let requests = scripts_iter
+        .map(|script| ImportMultiRequest {
+            timestamp: ImportMultiRescanSince::Timestamp(start_epoch),
+            script_pubkey: Some(ImportMultiRequestScriptPubkey::Script(script)),
+            watchonly: Some(true),
+            ..Default::default()
+        })
+        .collect::<Vec<_>>();
+    let options = ImportMultiOptions { rescan: Some(true) };
+    for v in client.import_multi(&requests, Some(&options))? {
+        if let Some(err) = v.error {
+            return Err(Error::Generic(format!(
+                "{} (code: {})",
+                err.message, err.code
+            )));
+        }
+    }
+    Ok(())
+}
+
+/// Calls the `listtransactions` RPC method in `page_size`s and returns iterator of the tx results
+/// in chronological order.
+///
+/// `page_size` cannot be less than 1 and cannot be greater than 1000.
+fn list_transactions(
+    client: &Client,
+    page_size: usize,
+) -> Result<impl Iterator<Item = ListTransactionResult>, Error> {
+    if !(1..=1000).contains(&page_size) {
+        return Err(Error::Generic(format!(
+            "Core RPC method `listtransactions` must have `page_size` in range [1 to 1000]: got {}",
+            page_size
+        )));
+    }
+
+    // `.take_while` helper to obtain the first error (TODO: remove when we can use `.map_while`)
+    let mut got_err = false;
+
+    // obtain results in batches (of `page_size`)
+    let nested_list = (0_usize..)
+        .map(|page_index| {
+            client.list_transactions(
+                None,
+                Some(page_size),
+                Some(page_size * page_index),
+                Some(true),
+            )
+        })
+        // take until returned rpc call is empty or until error
+        // TODO: replace with the following when MSRV is 1.57.0:
+        // `.map_while(|res| res.map(|l| if l.is_empty() { None } else { Some(l) }).transpose())`
+        .take_while(|res| {
+            if got_err || matches!(res, Ok(list) if list.is_empty()) {
+                // break if last iteration was an error, or if the current result is empty
+                false
+            } else {
+                // record whether result is error or not
+                got_err = res.is_err();
+                // continue on non-empty result or first error
+                true
+            }
+        })
+        .collect::<Result<Vec<_>, _>>()
+        .map_err(Error::Rpc)?;
+
+    // reverse here to have txs in chronological order
+    Ok(nested_list.into_iter().rev().flatten())
+}
+
+fn await_wallet_scan(client: &Client, rate_sec: u64, progress: &dyn Progress) -> Result<(), Error> {
+    #[derive(Deserialize)]
+    struct CallResult {
+        scanning: ScanningDetails,
+    }
+
+    let dur = Duration::from_secs(rate_sec);
+    loop {
+        match client.call::<CallResult>("getwalletinfo", &[])?.scanning {
+            ScanningDetails::Scanning {
+                duration,
+                progress: pc,
+            } => {
+                debug!("scanning: duration={}, progress={}", duration, pc);
+                progress.update(pc, Some(format!("elapsed for {} seconds", duration)))?;
+                thread::sleep(dur);
+            }
+            ScanningDetails::NotScanning(_) => {
+                progress.update(1.0, None)?;
+                info!("scanning: done!");
+                return Ok(());
+            }
+        };
+    }
+}
+
+/// Returns whether a wallet is legacy or descriptors by calling `getwalletinfo`.
+///
+/// This API is mapped by bitcoincore_rpc, but it doesn't have the fields we need (either
+/// "descriptors" or "format") so we have to call the RPC manually
+fn is_wallet_descriptor(client: &Client) -> Result<bool, Error> {
+    #[derive(Deserialize)]
+    struct CallResult {
+        descriptors: Option<bool>,
+    }
+
+    let result: CallResult = client.call("getwalletinfo", &[])?;
+    Ok(result.descriptors.unwrap_or(false))
+}
+
+fn descriptor_from_script_pubkey(script: &Script) -> String {
+    let desc = format!("raw({})", script.to_hex());
+    format!("{}#{}", desc, get_checksum(&desc).unwrap())
+}
+
+/// Factory of [`RpcBlockchain`] instances, implements [`BlockchainFactory`]
+///
+/// Internally caches the node url and authentication params and allows getting many different [`RpcBlockchain`]
+/// objects for different wallet names and with different rescan heights.
+///
+/// ## Example
+///
+/// ```no_run
+/// # use bdk::bitcoin::Network;
+/// # use bdk::blockchain::BlockchainFactory;
+/// # use bdk::blockchain::rpc::{Auth, RpcBlockchainFactory};
+/// # fn main() -> Result<(), Box<dyn std::error::Error>> {
+/// let factory = RpcBlockchainFactory {
+///     url: "http://127.0.0.1:18332".to_string(),
+///     auth: Auth::Cookie {
+///         file: "/home/user/.bitcoin/.cookie".into(),
+///     },
+///     network: Network::Testnet,
+///     wallet_name_prefix: Some("prefix-".to_string()),
+///     default_skip_blocks: 100_000,
+///     sync_params: None,
+/// };
+/// let main_wallet_blockchain = factory.build("main_wallet", Some(200_000))?;
+/// # Ok(())
+/// # }
+/// ```
+#[derive(Debug, Clone)]
+pub struct RpcBlockchainFactory {
+    /// The bitcoin node url
+    pub url: String,
+    /// The bitcoin node authentication mechanism
+    pub auth: Auth,
+    /// The network we are using (it will be checked the bitcoin node network matches this)
+    pub network: Network,
+    /// The optional prefix used to build the full wallet name for blockchains
+    pub wallet_name_prefix: Option<String>,
+    /// Default number of blocks to skip which will be inherited by blockchain unless overridden
+    pub default_skip_blocks: u32,
+    /// Sync parameters
+    pub sync_params: Option<RpcSyncParams>,
+}
+
+impl BlockchainFactory for RpcBlockchainFactory {
+    type Inner = RpcBlockchain;
+
+    fn build(
+        &self,
+        checksum: &str,
+        _override_skip_blocks: Option<u32>,
+    ) -> Result<Self::Inner, Error> {
+        RpcBlockchain::from_config(&RpcConfig {
+            url: self.url.clone(),
+            auth: self.auth.clone(),
+            network: self.network,
+            wallet_name: format!(
+                "{}{}",
+                self.wallet_name_prefix.as_ref().unwrap_or(&String::new()),
+                checksum
+            ),
+            sync_params: self.sync_params.clone(),
+        })
+    }
+}
+
+#[cfg(test)]
+#[cfg(any(feature = "test-rpc", feature = "test-rpc-legacy"))]
+mod test {
+    use super::*;
+    use crate::{
+        descriptor::{into_wallet_descriptor_checked, AsDerived},
+        testutils::blockchain_tests::TestClient,
+        wallet::utils::SecpCtx,
+    };
+
+    use bitcoin::{Address, Network};
+    use bitcoincore_rpc::RpcApi;
+    use log::LevelFilter;
+    use miniscript::DescriptorTrait;
+
+    crate::bdk_blockchain_tests! {
+        fn test_instance(test_client: &TestClient) -> RpcBlockchain {
+            let config = RpcConfig {
+                url: test_client.bitcoind.rpc_url(),
+                auth: Auth::Cookie { file: test_client.bitcoind.params.cookie_file.clone() },
+                network: Network::Regtest,
+                wallet_name: format!("client-wallet-test-{}", std::time::SystemTime::now().duration_since(std::time::UNIX_EPOCH).unwrap().as_nanos() ),
+                sync_params: None,
+            };
+            RpcBlockchain::from_config(&config).unwrap()
+        }
+    }
+
+    fn get_factory() -> (TestClient, RpcBlockchainFactory) {
+        let test_client = TestClient::default();
+
+        let factory = RpcBlockchainFactory {
+            url: test_client.bitcoind.rpc_url(),
+            auth: Auth::Cookie {
+                file: test_client.bitcoind.params.cookie_file.clone(),
+            },
+            network: Network::Regtest,
+            wallet_name_prefix: Some("prefix-".into()),
+            default_skip_blocks: 0,
+            sync_params: None,
+        };
+
+        (test_client, factory)
+    }
+
+    #[test]
+    fn test_rpc_blockchain_factory() {
+        let (_test_client, factory) = get_factory();
+
+        let a = factory.build("aaaaaa", None).unwrap();
+        assert_eq!(
+            a.client
+                .get_wallet_info()
+                .expect("Node connection isn't working")
+                .wallet_name,
+            "prefix-aaaaaa"
+        );
+
+        let b = factory.build("bbbbbb", Some(100)).unwrap();
+        assert_eq!(
+            b.client
+                .get_wallet_info()
+                .expect("Node connection isn't working")
+                .wallet_name,
+            "prefix-bbbbbb"
+        );
+    }
+
+    /// This test ensures that [list_transactions] always iterates through transactions in
+    /// chronological order, independent of the `page_size`.
+    #[test]
+    fn test_list_transactions() {
+        let _ = env_logger::builder()
+            .filter_level(LevelFilter::Info)
+            .default_format()
+            .try_init();
+
+        const DESC: &'static str = "wpkh(tpubD9zMNV59kgbWgKK55SHJugmKKSt6wQXczxpucGYqNKwGmJp1x7Ar2nrLUXYHDdCctXmyDoSCn2JVMzMUDfib3FaDhwxCEMUELoq19xLSx66/*)";
+        const AMOUNT_PER_TX: u64 = 10_000;
+        const TX_COUNT: u32 = 50;
+
+        let secp = SecpCtx::default();
+        let network = Network::Regtest;
+        let (desc, ..) = into_wallet_descriptor_checked(DESC, &secp, network).unwrap();
+
+        let (mut test_client, factory) = get_factory();
+        let bc = factory.build("itertest", None).unwrap();
+
+        // generate scripts (1 tx per script)
+        let scripts = (0..TX_COUNT)
+            .map(|index| desc.as_derived(index, &secp).script_pubkey())
+            .collect::<Vec<_>>();
+
+        // import scripts and wait
+        if bc.is_descriptors {
+            import_descriptors(&bc.client, 0, scripts.iter()).unwrap();
+        } else {
+            import_multi(&bc.client, 0, scripts.iter()).unwrap();
+        }
+        await_wallet_scan(&bc.client, 2, &NoopProgress).unwrap();
+
+        // create and broadcast txs
+        let expected_txids = scripts
+            .iter()
+            .map(|script| {
+                let addr = Address::from_script(script, network).unwrap();
+                let txid =
+                    test_client.receive(testutils! { @tx ( (@addr addr) => AMOUNT_PER_TX ) });
+                test_client.generate(1, None);
+                txid
+            })
+            .collect::<Vec<_>>();
+
+        // iterate through different page sizes - should always return txs in chronological order
+        [1000, 1, 2, 6, 25, 49, 50].iter().for_each(|page_size| {
+            println!("trying with page_size: {}", page_size);
+
+            let txids = list_transactions(&bc.client, *page_size)
+                .unwrap()
+                .map(|res| res.info.txid)
+                .collect::<Vec<_>>();
+
+            assert_eq!(txids.len(), expected_txids.len());
+            assert_eq!(txids, expected_txids);
+        });
+    }
+}
+

List of all items

Structs

Enums

Traits

Macros

Functions

Typedefs

List of all items

Structs

Enums

Traits

Macros

Functions

Typedefs

In bdk::blockchain::any

Enum bdk::blockchain::any::AnyBlockchain

Variants

Electrum(Box<ElectrumBlockchain>)

Esplora(Box<EsploraBlockchain>)

CompactFilters(Box<CompactFiltersBlockchain>)

Rpc(Box<RpcBlockchain>)

Trait Implementations

impl Blockchain for AnyBlockchain

fn get_capabilities(&self) -> HashSet<Capability>

fn broadcast(&self, tx: &Transaction) -> Result<(), Error>

fn estimate_fee(&self, target: usize) -> Result<FeeRate, Error>

impl From<CompactFiltersBlockchain> for AnyBlockchain

fn from(inner: CompactFiltersBlockchain) -> Self

impl From<ElectrumBlockchain> for AnyBlockchain

fn from(inner: ElectrumBlockchain) -> Self

impl From<EsploraBlockchain> for AnyBlockchain

fn from(inner: EsploraBlockchain) -> Self

impl From<RpcBlockchain> for AnyBlockchain

fn from(inner: RpcBlockchain) -> Self

impl GetBlockHash for AnyBlockchain

fn get_block_hash(&self, height: u64) -> Result<BlockHash, Error>

impl GetHeight for AnyBlockchain

fn get_height(&self) -> Result<u32, Error>

impl GetTx for AnyBlockchain

fn get_tx(&self, txid: &Txid) -> Result<Option<Transaction>, Error>

Auto Trait Implementations

impl !RefUnwindSafe for AnyBlockchain

impl Send for AnyBlockchain

impl Sync for AnyBlockchain

impl Unpin for AnyBlockchain

impl !UnwindSafe for AnyBlockchain

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T> Pointable for T

pub const ALIGN: usize

type Init = T

In bdk::blockchain::any

Enum bdk::blockchain::any::AnyBlockchainConfig

Variants

Electrum(ElectrumBlockchainConfig)

Esplora(EsploraBlockchainConfig)

CompactFilters(CompactFiltersBlockchainConfig)

Rpc(RpcConfig)

Trait Implementations

impl Clone for AnyBlockchainConfig

fn clone(&self) -> AnyBlockchainConfig

fn clone_from(&mut self, source: &Self)

impl Debug for AnyBlockchainConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl From<CompactFiltersBlockchainConfig> for AnyBlockchainConfig

fn from(inner: CompactFiltersBlockchainConfig) -> Self

impl From<ElectrumBlockchainConfig> for AnyBlockchainConfig

fn from(inner: ElectrumBlockchainConfig) -> Self

impl From<EsploraBlockchainConfig> for AnyBlockchainConfig

`Electrum(Box<ElectrumBlockchain>)`

`Esplora(Box<EsploraBlockchain>)`

`CompactFilters(Box<CompactFiltersBlockchain>)`

`Rpc(Box<RpcBlockchain>)`

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

`Electrum(ElectrumBlockchainConfig)`

`Esplora(EsploraBlockchainConfig)`

`CompactFilters(CompactFiltersBlockchainConfig)`

`Rpc(RpcConfig)`

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

pub fn iter_txs(&self) -> Vec<Transaction>â
Notable traits for Vec<u8, A>
`impl<A> Write for Vec<u8, A> where A: Allocator,`