Struct libp2p::kad::kbucket::KBucketRef

pub struct KBucketRef<'a, TPeerId, TVal> { /* fields omitted */ }

A reference to a bucket in a KBucketsTable.

Methods

impl<'_, TKey, TVal> KBucketRef<'_, TKey, TVal> where
    TKey: Clone + AsRef<KeyBytes>,
    TVal: Clone, 

pub fn num_entries(&self) -> usize

Returns the number of entries in the bucket.

pub fn has_pending(&self) -> bool

Returns true if the bucket has a pending node.

pub fn contains(&self, d: &Distance) -> bool

Tests whether the given distance falls into this bucket.

pub fn rand_distance(&self, rng: &mut impl Rng) -> Distance

Generates a random distance that falls into this bucket.

Together with a known key a (e.g. the local key), a random distance d for this bucket w.r.t k gives rise to the corresponding (random) key b s.t. the XOR distance between a and b is d. In other words, it gives rise to a random key falling into this bucket. See [key::Key::for_distance].