Struct MerkleCacheStore 

pub struct MerkleCacheStore { /* private fields */ }

Redis cache for SQL Merkle tree.

This is a dumb cache - no tree computation happens here. All tree logic (hashing, bubble-up) is handled by SqlMerkleStore.

Implementations

impl MerkleCacheStore

pub fn new(conn: ConnectionManager) -> Self

Create a new cache store without a prefix.

pub fn with_prefix(conn: ConnectionManager, prefix: Option<&str>) -> Self

Create a new cache store with an optional prefix.

pub fn key_prefix(&self) -> &str

Get the prefix used for all merkle keys.

pub async fn get_hash( &self, path: &str, ) -> Result<Option<[u8; 32]>, StorageError>

Get the hash for a path (root = “”).

pub async fn root_hash(&self) -> Result<Option<[u8; 32]>, StorageError>

Get the root hash (path = “”).

pub async fn get_children( &self, path: &str, ) -> Result<BTreeMap<String, [u8; 32]>, StorageError>

Get children of an interior node.

pub async fn get_node( &self, path: &str, ) -> Result<Option<MerkleNode>, StorageError>

Get a full node (hash + children).

pub async fn cache_node( &self, path: &str, hash: [u8; 32], children: &BTreeMap<String, [u8; 32]>, ) -> Result<(), StorageError>

Copy a node from SQL to this cache.

Called after SQL merkle batch completes. Copies both hash and children.

pub async fn delete_node(&self, path: &str) -> Result<(), StorageError>

Delete a node from cache.

pub async fn sync_from_sql( &self, sql_store: &SqlMerkleStore, ) -> Result<usize, StorageError>

Sync entire SQL merkle tree to cache.

Useful on startup or after cache invalidation. Reads all nodes from SQL and copies to Redis.

pub async fn sync_affected_from_sql( &self, sql_store: &SqlMerkleStore, affected_paths: &[String], ) -> Result<usize, StorageError>

Sync only affected paths from SQL to cache.

More efficient than full sync for incremental updates. Syncs the leaves, their ancestors, and the root.

pub async fn diff_children( &self, prefix: &str, their_children: &BTreeMap<String, [u8; 32]>, ) -> Result<Vec<String>, StorageError>

Compare hashes and find differing branches.

Returns prefixes where our hash differs from theirs.

Trait Implementations

impl Clone for MerkleCacheStore

fn clone(&self) -> MerkleCacheStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.