Struct LookupCache 

pub struct LookupCache { /* private fields */ }

TTL-based CID → providers cache for DHT lookups.

Implementations

impl LookupCache

pub fn new(config: LookupCacheConfig) -> Arc<Self>

Create a new LookupCache wrapped in an Arc.

pub fn get(&self, cid_str: &str, now_ms: u64) -> Option<Vec<String>>

Look up providers for a CID.

Returns None on a cache miss or when the entry has expired. On a hit the hit_count for the entry is incremented and the provider list is returned.

pub fn put( &self, cid_str: impl Into<String>, providers: Vec<String>, now_ms: u64, )

Store a positive result (providers found) for cid_str.

If the cache is at capacity the new entry still replaces any existing entry for the same CID; overall capacity enforcement is left to evict_expired.

pub fn put_negative(&self, cid_str: impl Into<String>, now_ms: u64)

Store a negative result (no providers found) for cid_str.

Negative entries use LookupCacheConfig::negative_ttl_ms as TTL and an empty provider list.

pub fn invalidate(&self, cid_str: &str) -> bool

Invalidate the entry for cid_str.

Returns true if an entry existed and was removed.

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

Remove all expired entries.

Returns the number of entries removed.

pub fn stats(&self) -> LookupCacheStats

Return a snapshot of current cache statistics.

pub fn len(&self) -> usize

Total number of cached entries (including expired ones not yet evicted).

pub fn is_empty(&self) -> bool

Whether the cache is empty.