Struct CoordCache 

pub struct CoordCache { /* private fields */ }

Coordinate cache for routing decisions.

Maps node addresses to their tree coordinates, enabling data packets to be routed without carrying coordinates in every packet. Populated by SessionSetup packets.

Implementations

impl CoordCache

pub fn new(max_entries: usize, default_ttl_ms: u64) -> Self

Create a new coordinate cache.

pub fn with_defaults() -> Self

Create a cache with default parameters.

pub fn max_entries(&self) -> usize

Get the maximum capacity.

pub fn default_ttl_ms(&self) -> u64

Get the default TTL.

pub fn set_default_ttl_ms(&mut self, ttl_ms: u64)

Set the default TTL.

pub fn insert( &mut self, addr: NodeAddr, coords: TreeCoordinate, current_time_ms: u64, )

Insert or update a cache entry.

pub fn insert_with_path_mtu( &mut self, addr: NodeAddr, coords: TreeCoordinate, current_time_ms: u64, path_mtu: u16, )

Insert or update a cache entry with path MTU information.

Used by discovery response handling to store the discovered path MTU alongside the target’s coordinates.

pub fn insert_with_ttl( &mut self, addr: NodeAddr, coords: TreeCoordinate, current_time_ms: u64, ttl_ms: u64, )

Insert with a custom TTL.

pub fn get( &self, addr: &NodeAddr, current_time_ms: u64, ) -> Option<&TreeCoordinate>

Look up coordinates for an address (without touching).

pub fn get_and_touch( &mut self, addr: &NodeAddr, current_time_ms: u64, ) -> Option<&TreeCoordinate>

Look up coordinates and refresh (update last_used and extend TTL).

pub fn get_entry(&self, addr: &NodeAddr) -> Option<&CacheEntry>

Get the full cache entry.

pub fn remove(&mut self, addr: &NodeAddr) -> Option<CacheEntry>

Remove an entry.

pub fn contains(&self, addr: &NodeAddr, current_time_ms: u64) -> bool

Check if an address is cached (and not expired).

pub fn len(&self) -> usize

Number of entries (including expired).

pub fn is_empty(&self) -> bool

Check if empty.

pub fn iter( &self, current_time_ms: u64, ) -> impl Iterator<Item = (&NodeAddr, &CacheEntry)>

Iterate over non-expired entries.

pub fn purge_expired(&mut self, current_time_ms: u64) -> usize

Remove all expired entries.

pub fn clear(&mut self)

Clear all entries.

pub fn stats(&self, current_time_ms: u64) -> CacheStats

Get cache statistics.

Trait Implementations

impl Clone for CoordCache

fn clone(&self) -> CoordCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CoordCache

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

Formats the value using the given formatter.

impl Default for CoordCache

fn default() -> Self

Returns the “default value” for a type.