Struct BulkFetcherStatus 

pub struct BulkFetcherStatus { /* private fields */ }

A cheap, cloneable handle to a running bulk fetcher’s fallback state.

Returned alongside the fetcher by bulk_call_storage_fetcher_with_status; the handle and the fetcher closure share one counter, so polling the handle observes the live fetcher with no extra plumbing. Cloning is Arc-cheap and every clone reflects the same state.

It surfaces the one runtime silent-degradation signal the fetcher can hit: a bulk fetcher whose provider turns out not to support eth_call state overrides latches to its point-read fallback after latch_threshold consecutive batches in which every slot failed with a provider-level error (a warn! fires once at that point). Without observability a searcher can slide from “10,000 slots per call” to “10,000 point reads” and notice only via latency or CU spend; poll fallback_latched to alert on it directly.

Implementations

impl BulkFetcherStatus

pub fn consecutive_override_failures(&self) -> usize

Consecutive batches so far in which every slot failed with a provider-level error; any batch with at least one success resets it to zero. Equals latch_threshold once the fetcher has latched (and does not climb past it — latched batches skip the bulk attempt, so the counter is not touched again).

pub fn latch_threshold(&self) -> usize

The number of consecutive all-provider-error batches that trips the latch.

pub fn fallback_latched(&self) -> bool

Whether the fetcher has latched to its point-read fallback. Sticky: once true it stays true for the fetcher’s lifetime — install a fresh fetcher to retry bulk extraction. Only ever true for a fetcher built with a fallback (via bulk_call_storage_fetcher_with_status); without one there is nothing to latch to and the bulk path is always attempted.

Trait Implementations

impl Clone for BulkFetcherStatus

fn clone(&self) -> BulkFetcherStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BulkFetcherStatus

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

Formats the value using the given formatter.