Struct StateStore 

pub struct StateStore<S: StateStorage> { /* private fields */ }

StateStore wraps a persistent storage backend with an optional in-memory cache. It is Clone when the underlying storage S is Clone (e.g., ReDb with Arc).

For deterministic simulation testing, use new_uncached() to bypass the moka cache which uses TinyLFU admission and may introduce non-determinism.

Implementations

impl<S> StateStore<S>

where S: StateStorage + Send + 'static, <S as StateStorage>::Error: Into<Error>,

pub fn new(store: S, max_size: u32) -> Result<Self, StateStoreError>

Create a StateStore with moka caching enabled.

Arguments

• max_size: max number of bytes for the mem cache

pub fn new_uncached(store: S) -> Self

Create a StateStore without caching for deterministic simulation.

This bypasses the moka cache which uses TinyLFU admission and may introduce non-determinism in tests.

Use this constructor for deterministic simulation testing under turmoil.

pub async fn update( &mut self, key: &ContractKey, state: WrappedState, ) -> Result<(), StateStoreError>

pub async fn store( &mut self, key: ContractKey, state: WrappedState, params: Parameters<'static>, ) -> Result<(), StateStoreError>

pub async fn get( &self, key: &ContractKey, ) -> Result<WrappedState, StateStoreError>

pub async fn get_params<'a>( &'a self, key: &'a ContractKey, ) -> Result<Option<Parameters<'static>>, StateStoreError>

pub async fn ensure_params( &self, key: ContractKey, params: Parameters<'static>, ) -> Result<(), StateStoreError>

Persist contract parameters to the backing store, unconditionally.

This is idempotent — safe to call even if params are already stored. Used to ensure params survive node restarts: the initial PUT path writes params via store(), but subsequent code paths (merge, update) go through update() which only writes state. Calling ensure_params closes the gap where params could be lost after restart.

pub fn inner(&self) -> &S

Get a reference to the underlying storage backend. Used for hosting metadata persistence operations.

pub fn storage(&self) -> S

where S: Clone,

Get a clone of the underlying storage backend. Used when the storage needs to be shared with other components (e.g., ContractStore, DelegateStore, SecretsStore).

Trait Implementations

impl<S: Clone + StateStorage> Clone for StateStore<S>

fn clone(&self) -> StateStore<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.