Struct ClientConfig 

pub struct ClientConfig {

    pub url: String,
    pub bearer_token: Option<String>,
    pub max_num_retries: u32,
    pub retry_backoff_ms: u64,
    pub retry_base_ms: u64,
    pub retry_ceiling_ms: u64,
    pub req_timeout_millis: u64,
    pub compute_units_per_second: Option<u64>,
    pub batch_size: Option<usize>,
    pub trace_method: Option<TraceMethod>,
    pub stop_on_head: bool,
    pub head_poll_interval_millis: u64,
    pub buffer_size: usize,
    pub reorg_safe_distance: u64,
}

All configuration for the RPC client, including both connection settings and stream behaviour.

Fields

url: String

JSON-RPC endpoint URL.

bearer_token: Option<String>

Optional bearer token for authenticated providers.

max_num_retries: u32

Maximum number of retries for a single RPC call.

retry_backoff_ms: u64

Fixed per-retry delay in milliseconds used by alloy’s RetryBackoffLayer.

retry_base_ms: u64

Base delay for exponential backoff (used by per-block retry loops, not by alloy).

retry_ceiling_ms: u64

Maximum delay for exponential backoff (used by per-block retry loops, not by alloy).

req_timeout_millis: u64

Per-request HTTP timeout in milliseconds.

compute_units_per_second: Option<u64>

Compute-unit rate limit for alloy’s RetryBackoffLayer.

batch_size: Option<usize>

Initial number of blocks per batch in simple pipeline mode; Response size (in blocks) in multi-pipeline mode (impact memory usage).

trace_method: Option<TraceMethod>

Override the trace method for all trace requests.

stop_on_head: bool

When true, stop the stream after reaching the chain head instead of entering live-polling mode.

head_poll_interval_millis: u64

How often to poll for new blocks during live mode, in milliseconds.

buffer_size: usize

Bounded channel capacity for the ArrowResponse stream.

reorg_safe_distance: u64

Number of blocks behind the head to stay, to avoid reorged data.

Implementations

impl ClientConfig

pub fn new(url: String) -> Self

Create a new configuration with sensible defaults for the given RPC URL.

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

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

Formats the value using the given formatter.