Struct ContentRoutingTable 

pub struct ContentRoutingTable {
    pub local_peer_id: String,
    /* private fields */
}

DHT-aware content routing table with per-CID provider lists and affinity scoring.

Fields

local_peer_id: String

Peer ID of the local node (reserved for future self-announcement logic).

Implementations

impl ContentRoutingTable

pub fn new(local_peer_id: String, max_providers_per_cid: usize) -> Self

Create a new routing table.

Arguments

• local_peer_id – string peer ID of the local node.
• max_providers_per_cid – bucket capacity per CID.

pub fn with_defaults(local_peer_id: String) -> Self

Create a new routing table with DEFAULT_MAX_PROVIDERS.

pub fn add_provider( &self, cid: &str, entry: RoutingEntry, ) -> Result<(), RoutingError>

Register entry as a provider for cid.

Errors

• RoutingError::DuplicateProvider – the peer is already listed.
• RoutingError::CapacityExceeded – the bucket is full.

pub fn remove_provider(&self, cid: &str, peer_id: &str)

Remove the provider identified by peer_id from the bucket for cid.

This is a no-op if neither the CID nor the peer is found.

pub fn evict_expired(&self, now: Instant)

Evict all entries whose TTL has elapsed relative to now.

Empty buckets are removed, and the internal eviction counter is updated.

pub fn get_providers(&self, cid: &str) -> Vec<RoutingEntry>

Return all providers for cid sorted by affinity score (highest first).

pub fn best_provider(&self, cid: &str) -> Option<RoutingEntry>

Return the single provider with the highest affinity score, if any.

pub fn cid_count(&self) -> usize

Return the number of distinct CIDs tracked.

pub fn provider_count(&self) -> usize

Return the total number of provider entries across all CIDs.

pub fn stats(&self) -> RoutingTableStats

Return a snapshot of routing table statistics.