Struct EsploraClient 

pub struct EsploraClient { /* private fields */ }

A blockchain backend implementation based on the esplora HTTP API But can also use the waterfalls endpoint to speed up the scan if supported by the server.

Implementations

impl EsploraClient

pub fn new(url: &str, network: &Network) -> Result<Arc<Self>, LwkError>

Construct an Esplora Client

pub fn new_waterfalls( url: &str, network: &Network, ) -> Result<Arc<Self>, LwkError>

Construct an Esplora Client using Waterfalls endpoint

pub fn from_builder( builder: EsploraClientBuilder, ) -> Result<Arc<Self>, LwkError>

Construct an Esplora Client from an EsploraClientBuilder

pub fn broadcast(&self, tx: &Transaction) -> Result<Arc<Txid>, LwkError>

Broadcast a transaction to the network so that a miner can include it in a block.

pub fn full_scan( &self, wollet: &Wollet, ) -> Result<Option<Arc<Update>>, LwkError>

Scan the blockchain for the scripts generated by a watch-only wallet

This method scans both external and internal address chains, stopping after finding 20 consecutive unused addresses (the gap limit) as recommended by BIP44.

Returns Some(Update) if any changes were found during scanning, or None if no changes were detected.

To scan beyond the gap limit use full_scan_to_index() instead.

pub fn full_scan_to_index( &self, wollet: &Wollet, index: u32, ) -> Result<Option<Arc<Update>>, LwkError>

Scan the blockchain for the scripts generated by a watch-only wallet up to a specified derivation index

While full_scan() stops after finding 20 consecutive unused addresses (the gap limit), this method will scan at least up to the given derivation index. This is useful to prevent missing funds in cases where outputs exist beyond the gap limit.

Will scan both external and internal address chains up to the given index for maximum safety, even though internal addresses may not need such deep scanning.

If transactions are found beyond the gap limit during this scan, subsequent calls to full_scan() will automatically scan up to the highest used index, preventing any previously-found transactions from being missed.

pub fn tip(&self) -> Result<Arc<BlockHeader>, LwkError>

See BlockchainBackend::tip

Trait Implementations

impl Debug for EsploraClient

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

Formats the value using the given formatter.

impl<UT> LiftRef<UT> for EsploraClient

type LiftType = Arc<EsploraClient>

impl<UT> LowerError<UT> for EsploraClient

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for EsploraClient

type ReturnType = <Arc<EsploraClient> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for EsploraClient

const TYPE_ID_META: MetadataBuffer