Struct CacheLayer 

pub struct CacheLayer { /* private fields */ }

Available on non-target_family=wasm only.

A provider layer that caches RPC responses and serves them on subsequent requests.

The cache is an in-memory LRU with a fixed maximum item count. Block-sensitive methods are cached only for explicit block numbers or hashes; dynamic tags such as latest and pending bypass the cache. Log queries are cached only when pinned to a block hash or a fixed numeric range. It also caches block receipts, included transactions, raw transactions, and transaction receipts; other Provider methods pass through to the inner provider.

Persistence is opt-in. Obtain a SharedCache with CacheLayer::cache before applying the layer, retain that handle, and use SharedCache::load_cache or SharedCache::save_cache. There is no automatic persistence or invalidation.

Implementations

impl CacheLayer

pub fn new(max_items: u32) -> Self

Instantiate a new cache layer with the maximum number of items to store.

pub const fn max_items(&self) -> u32

Returns the maximum number of items that can be stored in the cache, set at initialization.

pub fn cache(&self) -> SharedCache

Returns the shared cache.

Trait Implementations

impl Clone for CacheLayer

fn clone(&self) -> CacheLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheLayer

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

Formats the value using the given formatter.

impl<P, N> ProviderLayer<P, N> for CacheLayer

where P: Provider<N>, N: Network,

type Provider = CacheProvider<P, N>

The provider constructed by this layer.

fn layer(&self, inner: P) -> Self::Provider

Wrap the given provider in the layer’s provider.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 16 bytes