Struct ContentAddressedCacheV2 

pub struct ContentAddressedCacheV2 { /* private fields */ }

Production-grade content-addressed cache with hot/warm tiering, Bloom-filter admission control, and rich eviction accounting.

Implementations

impl ContentAddressedCacheV2

pub fn new(config: Cac2CacheConfig) -> Self

Construct a new cache with the given configuration.

pub fn default_config() -> Self

Construct with default configuration.

pub fn bloom_probably_contains(&self, cid: &Cac2Cid) -> bool

Test whether cid probably exists in the admission filter.

pub fn insert(&mut self, cid: Cac2Cid, data: Vec<u8>)

Insert data under cid.

Admission control: if the Bloom filter does not contain cid yet (i.e., this is a cold first-time access), the entry is written only to the warm tier — bypassing the hot tier to protect it from one-hit wonders. If the Bloom filter does contain the CID (repeat access), the entry is routed to the hot tier directly.

Eviction cascade:

1. Hot full → demote the LRU hot entry to warm.
2. Warm full → evict the entry with the lowest access_count (LFU).

pub fn get(&mut self, cid: &Cac2Cid) -> Option<&[u8]>

Retrieve a cached payload.

Look-up order: hot tier first, then warm tier. A warm hit with access_count > admission_threshold triggers promotion to the hot tier.

pub fn evict(&mut self, cid: &Cac2Cid)

Forcibly remove cid from all tiers.

pub fn expire_stale(&mut self, now_ts: u64)

Remove all entries whose TTL has elapsed as of now_ts. Pass now_secs() for the current wall-clock time.

pub fn drain_warm_to_disk_simulation(&mut self) -> Vec<(Cac2Cid, Vec<u8>)>

Drain the lowest-frequency 25% of warm-tier entries, returning them as (Cac2Cid, Vec<u8>) pairs so the caller can write them to disk.

This simulates a write-back flush in a hierarchical storage system.

pub fn cache_stats(&self) -> Cac2CacheStats

Return a snapshot of the current cache statistics.

pub fn eviction_log(&self) -> &VecDeque<Cac2EvictionRecord>

Expose a reference to the eviction log.

pub fn config(&self) -> &Cac2CacheConfig

Return the current configuration.

pub fn hot_len(&self) -> usize

Number of entries in the hot tier.

pub fn warm_len(&self) -> usize

Number of entries in the warm tier.

pub fn total_len(&self) -> usize

Total number of cached entries across both tiers.

pub fn is_empty(&self) -> bool

Return true if neither tier contains any entry.

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

Check whether cid is present in either tier without updating stats.