Struct BlockCache 

pub struct BlockCache { /* private fields */ }

An in-memory cache for raw block data with LRU/LFU/TTL eviction and size-based capacity limits.

Implementations

impl BlockCache

pub fn new(config: CacheConfig) -> Self

Creates a new BlockCache with the given CacheConfig.

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

Looks up a block by CID.

• Hit (fresh): updates last_accessed_secs and access_count, increments stats.hits, and returns a slice of the data.
• Hit (expired): removes the entry, increments stats.misses and stats.expired_evictions, and returns None.
• Miss: increments stats.misses and returns None.

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

Inserts a new block into the cache.

If the cache is at or above capacity (entry count or byte budget), entries are evicted according to CacheConfig::policy until the new block fits. If the block itself exceeds max_bytes on its own, all existing entries are evicted and the oversized block is still inserted (single-block cache).

pub fn evict_one(&mut self, now_secs: u64) -> bool

Evicts a single entry according to the configured policy.

Returns true if an entry was removed, false if the cache was already empty.

pub fn evict_expired(&mut self, now_secs: u64) -> usize

Removes all expired entries from the cache in one pass.

Returns the number of entries that were removed.

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

Explicitly removes a cached entry by CID.

Returns true if the entry existed and was removed.

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

Returns true if a non-expired entry for cid is currently in the cache. Unlike get this method does not update any access metadata and does not remove expired entries.

pub fn stats(&self) -> &CacheStats

Returns a reference to the cumulative CacheStats.

pub fn clear(&mut self)

Removes all entries and resets all statistics.

Trait Implementations

impl Debug for BlockCache

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

Formats the value using the given formatter.