Struct MempoolHttpClient 

pub struct MempoolHttpClient { /* private fields */ }

A MempoolLookup backed by the mempool.space REST API over reqwest.

Cheap to clone (holds an Arc-internal reqwest::Client and the base URL). Construct with MempoolHttpClient::from_env to honour JSS_PAY_MEMPOOL_URL, or MempoolHttpClient::new for an explicit base.

Implementations

impl MempoolHttpClient

pub fn new(base_url: impl Into<String>) -> Self

Construct a client against an explicit base URL (e.g. https://mempool.space/testnet4). A trailing / is trimmed.

pub fn from_selection(selection: MempoolSelection) -> Self

Construct from an already-resolved MempoolSelection. Does not log — the caller owns whether this choice is recorded (see log_mempool_selection).

pub fn from_env() -> Self

Construct from JSS_PAY_MEMPOOL_URL, falling back to DEFAULT_MEMPOOL_URL (testnet4).

The resolved endpoint is logged exactly once via log_mempool_selection, so the startup log always records which explorer — and therefore which Bitcoin network — the pod is using, with a warning when that endpoint was defaulted or is unclassifiable.

pub fn base_url(&self) -> &str

The configured base URL (trailing slash trimmed).

pub fn selection(&self) -> &MempoolSelection

The resolved endpoint selection: base URL, inferred Bitcoin network, and whether the URL was operator-supplied or defaulted.

pub async fn transaction_exists(&self, txid: &str) -> Result<bool, PaymentError>

Check whether a transaction is known without collapsing an HTTP 404 into the same result as an ambiguous transport/server failure. Payment intent recovery may compensate a debit only for Ok(false).

Trait Implementations

impl Clone for MempoolHttpClient

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MempoolHttpClient

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

Formats the value using the given formatter.

impl MempoolBroadcast for MempoolHttpClient

fn broadcast_tx<'life0, 'life1, 'async_trait>( &'life0 self, raw_hex: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String, PaymentError>> + 'async_trait>>

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

POST raw_hex to the mempool’s broadcast endpoint; return the txid.

impl MempoolLookup for MempoolHttpClient

fn address_utxos<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<Utxo>, PaymentError>> + 'async_trait>>

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

Return every UTXO currently at address (confirmed or in-mempool).

fn tx<'life0, 'life1, 'async_trait>( &'life0 self, txid: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<TxInfo, PaymentError>> + 'async_trait>>

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

Fetch a transaction by id (for scriptPubKey / confirmation reads).