Struct StateCache 

pub struct StateCache { /* private fields */ }

Multi-layer TTL cache for on-chain state.

Keyed by address ([u8; 20]) for per-market data, or by perp ID ([u8; 32]) for per-perp data. The USDC balance is a singleton.

Implementations

impl StateCache

pub fn new(config: StateCacheConfig) -> Self

Create a new cache with the given TTL configuration.

pub fn get_fees(&self, addr: &[u8; 20], now_ts: u64) -> Option<&CachedFees>

Get cached fees for a market address, or None if stale/absent.

pub fn put_fees(&mut self, addr: [u8; 20], value: CachedFees, now_ts: u64)

Cache fees for a market address.

pub fn get_bounds(&self, addr: &[u8; 20], now_ts: u64) -> Option<&CachedBounds>

Get cached bounds for a market address, or None if stale/absent.

pub fn put_bounds(&mut self, addr: [u8; 20], value: CachedBounds, now_ts: u64)

Cache bounds for a market address.

pub fn get_mark_price(&self, perp_id: &[u8; 32], now_ts: u64) -> Option<f64>

Get cached mark price for a perp, or None if stale/absent.

pub fn put_mark_price(&mut self, perp_id: [u8; 32], price: f64, now_ts: u64)

Cache a mark price for a perp.

pub fn get_funding_rate(&self, perp_id: &[u8; 32], now_ts: u64) -> Option<f64>

Get cached funding rate for a perp, or None if stale/absent.

pub fn put_funding_rate(&mut self, perp_id: [u8; 32], rate: f64, now_ts: u64)

Cache a funding rate for a perp.

pub fn get_usdc_balance(&self, now_ts: u64) -> Option<f64>

Get cached USDC balance, or None if stale/absent.

pub fn put_usdc_balance(&mut self, balance: f64, now_ts: u64)

Cache the USDC balance.

pub fn invalidate_fast_layer(&mut self)

Invalidate all fast-layer data (prices, funding, balance).

Call on new-block events. The slow layer (fees, bounds) is preserved.

pub fn invalidate_all(&mut self)

Invalidate everything (both layers).

Trait Implementations

impl Debug for StateCache

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

Formats the value using the given formatter.