Struct EsploraClient 

pub struct EsploraClient {
    client: AsyncClient,
    url: SafeUrl,
    cached_chain_id: OnceLock<ChainId>,
}

Fields

client: AsyncClient

url: SafeUrl

cached_chain_id: OnceLock<ChainId>

Implementations

impl EsploraClient

pub fn new(url: &SafeUrl) -> Result<Self>

Trait Implementations

impl Debug for EsploraClient

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

Formats the value using the given formatter.

impl IServerBitcoinRpc for EsploraClient

fn get_mempool_txids<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<Txid>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Esplora has no API for reading the mempool as a whole.

It exposes the full list of mempool txids, but nothing that returns their outputs in bulk, so filtering the mempool by script would take one request per transaction on every scan. Its other mempool endpoints are per-address, which is of no use to a guardian that deliberately does not know which addresses belong to which client.

Reporting no visibility is the honest answer; callers degrade to confirmation-only progress.

fn get_bitcoin_rpc_config(&self) -> BitcoinRpcConfig

Returns the Bitcoin RPC config

fn get_url(&self) -> SafeUrl

Returns the Bitcoin RPC url

fn get_block_count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the current block count

fn get_block_hash<'life0, 'async_trait>( &'life0 self, height: u64, ) -> Pin<Box<dyn Future<Output = Result<BlockHash>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the block hash at a given height

fn get_block<'life0, 'life1, 'async_trait>( &'life0 self, block_hash: &'life1 BlockHash, ) -> Pin<Box<dyn Future<Output = Result<Block>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn get_feerate<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<Feerate>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Estimates the fee rate for a given confirmation target. Make sure that all federation members use the same algorithm to avoid widely diverging results. If the node is not ready yet to return a fee rate estimation this function returns None.

fn submit_transaction<'life0, 'async_trait>( &'life0 self, transaction: Transaction, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Submits a transaction to the Bitcoin network

fn get_sync_progress<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<f64>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the node’s estimated chain sync percentage as a float between 0.0 and 1.0, or None if the node doesn’t support this feature.

fn get_chain_id<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ChainId>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the chain ID (block hash at height 1)

fn get_block_count_and_initial_block_download<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(u64, bool), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Returns the current block count and whether initial block download is still active.

fn get_mempool_tx<'life0, 'life1, 'async_trait>( &'life0 self, txid: &'life1 Txid, ) -> Pin<Box<dyn Future<Output = Result<Option<Transaction>, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: 'async_trait,

Returns a transaction from the node’s mempool.

fn into_dyn(self) -> Arc<dyn IServerBitcoinRpc>

where Self: Sized,