Struct ContentAddressableCache 

pub struct ContentAddressableCache { /* private fields */ }

High-performance content-addressable cache.

Keyed by FNV-1a-derived CIDs; supports LRU, LFU, TTL-first, size-weighted, and tag-targeted eviction policies. Thread-safety must be provided by the caller.

Implementations

impl ContentAddressableCache

pub fn new(config: CacheConfig) -> Self

Create a new cache with the given configuration.

pub fn insert( &mut self, data: Vec<u8>, ttl_us: Option<u64>, tags: Vec<String>, ) -> Result<String, CacheError>

Insert data into the cache.

Computes the CID automatically; applies ttl_us (or the configured default) and the given tags. Returns the derived CID on success.

pub fn insert_with_cid( &mut self, cid: String, data: Vec<u8>, ttl_us: Option<u64>, tags: Vec<String>, ) -> Result<(), CacheError>

Insert data under a caller-supplied cid.

Verifies that the CID matches the data; returns CacheError::CidMismatch otherwise.

pub fn get(&mut self, cid: &str) -> Result<&[u8], CacheError>

Retrieve the data payload for cid.

Updates LRU position and increments access_count. Returns CacheError::TtlExpired (and removes the entry) if the entry has expired.

pub fn get_entry(&self, cid: &str) -> Result<&CacheEntry, CacheError>

Retrieve the full CacheEntry for cid (read-only, does NOT update LRU or access counts).

pub fn contains(&self, cid: &str) -> bool

Return true when an entry for cid exists and has not expired. Does not update LRU position.

pub fn remove(&mut self, cid: &str) -> Result<CacheEntry, CacheError>

Remove and return the entry for cid.

pub fn remove_by_tag(&mut self, tag: &str) -> Vec<String>

Remove all entries bearing tag and return their CIDs.

pub fn expire_ttl(&mut self) -> Vec<String>

Scan the cache and remove all TTL-expired entries.

Returns the CIDs that were removed.

pub fn evict_to_fit(&mut self, needed_bytes: usize) -> Vec<String>

Evict entries per policy until needed_bytes additional bytes can be accommodated without exceeding max_bytes.

Returns the CIDs evicted.

pub fn stats(&self) -> CacheStats

Return a snapshot of current cache statistics.

pub fn clear(&mut self) -> usize

Remove all entries and return how many were cleared.

pub fn cids(&self) -> Vec<String>

Return the CIDs of all currently-cached entries.