Struct PeerRegistry 

pub struct PeerRegistry<const N: usize> { /* private fields */ }

Fixed-capacity registry of remote peers.

Implementations

impl<const N: usize> PeerRegistry<N>

pub fn new() -> Self

Create an empty peer registry.

pub fn lookup_by_hint( &self, hint: &NodeHint, ) -> impl Iterator<Item = (PeerId, &PeerInfo)>

Iterate over peers whose derived hint matches hint.

pub fn lookup_by_key(&self, key: &PublicKey) -> Option<(PeerId, &PeerInfo)>

Look up a peer by full public key.

pub fn get(&self, id: PeerId) -> Option<&PeerInfo>

Borrow peer metadata by identifier.

pub fn get_mut(&mut self, id: PeerId) -> Option<&mut PeerInfo>

Mutably borrow peer metadata by identifier.

pub fn try_insert_or_update( &mut self, key: PublicKey, ) -> Result<PeerId, CapacityError>

Insert or refresh an explicitly configured peer entry.

pub fn try_insert_or_update_auto( &mut self, key: PublicKey, now_ms: u64, ) -> Result<AutoPeerUpdate, CapacityError>

Insert or refresh an opportunistically learned peer entry.

When the registry is full, this may recycle the oldest non-pinned entry in place rather than failing. Explicitly configured (pinned) peers are never displaced.

pub fn update_route(&mut self, id: PeerId, route: CachedRoute)

Update the cached route for id.

pub fn touch(&mut self, id: PeerId, now_ms: u64)

Refresh the last-seen timestamp for id.

Trait Implementations

impl<const N: usize> Clone for PeerRegistry<N>

fn clone(&self) -> PeerRegistry<N>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const N: usize> Debug for PeerRegistry<N>

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

Formats the value using the given formatter.

impl<const N: usize> Default for PeerRegistry<N>

fn default() -> Self

Returns the “default value” for a type.