Struct CacheDb 

pub struct CacheDb { /* private fields */ }

Encrypted cache database wrapper.

Stores non-authoritative, regenerable data (proof cache, session keys, replay guard). Wraps walletkit_db::Vault.

Unlike the credential vault, cache corruption is recoverable: open failures or integrity failures trigger a wipe-and-rebuild rather than a fatal error.

Implementations

impl CacheDb

pub fn new( path: &Path, k_intermediate: &SecretBox<[u8; 32]>, ) -> StorageResult<Self>

Opens or rebuilds the encrypted cache database at path.

If the database is corrupted or unreadable, the file is deleted and a fresh empty cache is created.

Errors

Returns an error if the database cannot be opened or rebuilt.

pub fn merkle_cache_get( &self, valid_until: u64, ) -> StorageResult<Option<Vec<u8>>>

Fetches a cached Merkle proof if it remains valid beyond valid_until.

Returns None when missing or expired so callers can refetch from the indexer without relying on stale proofs.

Errors

Returns an error if the query fails.

pub fn merkle_cache_put( &self, proof_bytes: &[u8], now: u64, ttl_seconds: u64, ) -> StorageResult<()>

Inserts a cached Merkle proof with a TTL. Existing entries for the same key are replaced.

Errors

Returns an error if the insert fails.

pub fn session_seed_get( &self, oprf_seed: [u8; 32], now: u64, ) -> StorageResult<Option<[u8; 32]>>

Fetches a cached session_id_r_seed for the given oprf_seed.

Returns None when missing or expired.

Errors

Returns an error if the query fails.

pub fn session_seed_put( &self, oprf_seed: [u8; 32], session_id_r_seed: [u8; 32], now: u64, ttl_seconds: u64, ) -> StorageResult<()>

Stores a session_id_r_seed keyed by oprf_seed with a TTL.

Errors

Returns an error if the insert fails.

pub fn is_nullifier_replay( &self, nullifier: [u8; 32], now: u64, ) -> StorageResult<bool>

Checks whether a replay guard entry exists for the given nullifier.

Returns

• true if a replay guard entry exists (nullifier replay).
• false otherwise.

Errors

Returns an error if the query to the cache unexpectedly fails.

pub fn replay_guard_set( &self, nullifier: [u8; 32], now: u64, ) -> StorageResult<()>

After a proof has been successfully generated, creates a replay guard entry locally to avoid future replays of the same nullifier.

Errors

Returns an error if the query to the cache unexpectedly fails.

Trait Implementations

impl Debug for CacheDb

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

Formats the value using the given formatter.