Struct EsploraProvider 

pub struct EsploraProvider {
    pub esplora_url: String,
    pub network: SimplicityNetwork,
    pub timeout: Duration,
}

A provider implementation that interacts with the Esplora REST API backend.

Fields

esplora_url: String

The base URL of the Esplora REST API.

network: SimplicityNetwork

The currently configured Simplicity network (e.g. Liquid, Testnet, Regtest).

timeout: Duration

Timeout duration used in underlying HTTP requests.

Implementations

impl EsploraProvider

pub fn new(url: String, network: SimplicityNetwork) -> EsploraProvider

Creates a new EsploraProvider connected to the provided endpoint targeting the specific network.

Trait Implementations

impl Debug for EsploraProvider

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

Formats the value using the given formatter.

impl ProviderTrait for EsploraProvider

fn get_network(&self) -> &SimplicityNetwork

Retrieves the network configured for this provider.

fn broadcast_transaction( &self, tx: &Transaction, ) -> Result<TxReceipt<'_>, ProviderError>

Attempts to broadcast a fully compiled transaction to the configured backend.

fn wait(&self, txid: &Txid) -> Result<(), ProviderError>

Blocks and repeatedly polls the network until the specified transaction receives its first confirmation.

fn fetch_tip_height(&self) -> Result<u32, ProviderError>

Retrieves the current block height of the network tip.

fn fetch_tip_timestamp(&self) -> Result<u64, ProviderError>

Retrieves the block timestamp representing network consensus clock tip.

fn fetch_transaction(&self, txid: &Txid) -> Result<Transaction, ProviderError>

Retrieves the serialized transaction payload given its hex transaction ID.

fn fetch_address_utxos( &self, address: &Address, ) -> Result<Vec<UTXO>, ProviderError>

Fetches all active unspent transaction outputs correlated to a particular public Address.

fn fetch_scripthash_utxos( &self, script: &Script, ) -> Result<Vec<UTXO>, ProviderError>

Fetches all active unspent transaction outputs correlated to a given custom Script mapping.

fn fetch_fee_estimates(&self) -> Result<HashMap<String, f64>, ProviderError>

Fetches network fee estimation models based on varying target confirmation block delays.

fn fetch_fee_rate(&self, target_blocks: u32) -> Result<f32, ProviderError>

Attempts to extract the specific fee rate (in sats/kvb) necessary for the transaction to be confirmed within target_blocks.