Struct ContentRoutingCache 

pub struct ContentRoutingCache {
    pub config: CacheConfig,
    pub total_provider_lookups: u64,
    pub total_hint_lookups: u64,
    pub cache_hits: u64,
    pub cache_misses: u64,
    /* private fields */
}

Multi-tier cache for DHT content routing.

Three independent tiers:

1. Provider tier – stores CrcProviderRecords (multiple per CID).
2. Hint tier – stores one RoutingHint per CID.
3. Negative tier – stores one NegativeCacheEntry per CID.

Fields

config: CacheConfig

Cache configuration.

total_provider_lookups: u64

Cumulative provider-tier lookup count.

total_hint_lookups: u64

Cumulative hint-tier lookup count.

cache_hits: u64

Cumulative cache hits (provider + hint tiers combined).

cache_misses: u64

Cumulative cache misses (provider + hint tiers combined).

Implementations

impl ContentRoutingCache

pub fn new(config: CacheConfig) -> Self

Create a new cache with the given configuration.

pub fn add_provider(&mut self, record: CrcProviderRecord)

Insert a provider record.

If the per-CID limit (MAX_PROVIDERS_PER_CID) would be exceeded the oldest record (smallest last_provided) is evicted first. If the global provider-CID limit would be exceeded the CID whose most-recent provider record is oldest is removed entirely.

pub fn get_providers(&mut self, cid: &str, now: u64) -> Vec<&CrcProviderRecord>

Return all non-expired provider records for cid.

Expired records are removed in place. Updates lookup and hit/miss counters.

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

Remove a specific provider record identified by (cid, peer_id).

Returns true if a record was removed.

pub fn add_hint(&mut self, hint: RoutingHint)

Insert a routing hint.

If the hint-tier capacity would be exceeded the oldest hint (smallest cached_at) is evicted first.

pub fn get_hint(&mut self, cid: &str, now: u64) -> Option<&RoutingHint>

Return the routing hint for cid if it exists and has not expired.

If the hint exists but is expired it is removed and None is returned. Updates lookup and hit/miss counters.

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

Remove the hint for cid. Returns true if a hint was present.

pub fn add_negative(&mut self, entry: NegativeCacheEntry)

Insert a negative cache entry.

If the negative-tier capacity would be exceeded the oldest entry (smallest not_found_at) is evicted first.

pub fn is_negative(&mut self, cid: &str, now: u64) -> bool

Returns true if there is a live (non-expired) negative entry for cid.

If the entry is expired it is removed.

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

Remove the negative entry for cid. Returns true if one existed.

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

Sweep all three tiers and remove expired entries.

Returns the total number of items removed.

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

Returns true if the provider tier holds at least one record for cid.

Note: this does not check expiry; call evict_expired or get_providers to prune first if freshness matters.

pub fn cache_stats(&self) -> CacheStats

Return a statistics snapshot.

Trait Implementations

impl Debug for ContentRoutingCache

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

Formats the value using the given formatter.