Struct RotatingExplorerClient 

pub struct RotatingExplorerClient {
    pub config: RotatingExplorerConfig,
    pub endpoints: Vec<ExplorerEndpoint>,
    /* private fields */
}

An explorer client that round-robins across multiple API endpoints.

On failure (when rotate_on_error is enabled), the client advances to the next available healthy endpoint automatically.

Fields

config: RotatingExplorerConfig

Configuration

endpoints: Vec<ExplorerEndpoint>

All tracked endpoints with health state

Implementations

impl RotatingExplorerClient

pub fn new(config: RotatingExplorerConfig) -> Self

Create a new RotatingExplorerClient from the given configuration.

pub fn current_endpoint(&self) -> Option<&str>

Return the URL of the current healthy endpoint, if any.

pub fn rotate(&self)

Advance the current index to the next endpoint (wraps around).

pub fn mark_unhealthy(&self, index: usize)

Mark endpoint at index as unhealthy.

pub async fn get_transaction( &self, txid: &str, ) -> Result<ExplorerTransaction, BitcoinError>

Retrieve a transaction from the current endpoint, rotating on failure.

Tries config.max_retries + 1 times before returning an error.

Trait Implementations

impl Debug for RotatingExplorerClient

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

Formats the value using the given formatter.