Struct AHashMapStore 

pub struct AHashMapStore { /* private fields */ }

High-performance state store using AHashMap for point lookups and BTreeMap for ordered scans.

This dual-structure design provides:

• O(1) point lookups (vs O(log n) for InMemoryStore)
• Zero-copy reads via get_ref
• Same O(log n + k) scan performance as InMemoryStore

Trade-off: ~2x memory for keys (stored in both maps) and slightly slower writes due to dual-map maintenance.

Implementations

impl AHashMapStore

pub fn new() -> Self

Creates a new empty store.

pub fn with_capacity(capacity: usize) -> Self

Creates a new store with pre-allocated capacity for the hash map.

Trait Implementations

impl Default for AHashMapStore

fn default() -> Self

Returns the “default value” for a type.

impl StateStore for AHashMapStore

fn get(&self, key: &[u8]) -> Option<Bytes>

Get a value by key.

fn get_ref(&self, key: &[u8]) -> Option<&[u8]>

Get a zero-copy reference to a value by key.

fn put(&mut self, key: &[u8], value: Bytes) -> Result<(), StateError>

Store a key-value pair.

fn delete(&mut self, key: &[u8]) -> Result<(), StateError>

Delete a key.

fn prefix_scan<'a>( &'a self, prefix: &'a [u8], ) -> Box<dyn Iterator<Item = (Bytes, Bytes)> + 'a>

Scan all keys with a given prefix.

fn range_scan<'a>( &'a self, range: Range<&'a [u8]>, ) -> Box<dyn Iterator<Item = (Bytes, Bytes)> + 'a>

Range scan between two keys (exclusive end).

fn contains(&self, key: &[u8]) -> bool

Check if a key exists.

fn size_bytes(&self) -> usize

Get approximate size in bytes.

fn len(&self) -> usize

Get the number of entries in the store.

fn snapshot(&self) -> StateSnapshot

Create a snapshot for checkpointing.

fn restore(&mut self, snapshot: StateSnapshot)

Restore from a snapshot.

fn clear(&mut self)

Clear all entries.

fn is_empty(&self) -> bool

Check if the store is empty.

fn flush(&mut self) -> Result<(), StateError>

Flush any pending writes to durable storage.

fn get_or_insert( &mut self, key: &[u8], default: &[u8], ) -> Result<Bytes, StateError>

Get a value or insert a default.