Struct RoutingTableAuditor 

pub struct RoutingTableAuditor {
    pub buckets: Vec<BucketInfo>,
    pub config: AuditorConfig,
}

Audits a DHT routing table represented as a collection of BucketInfo entries and produces AuditFinding items describing any health issues.

Fields

buckets: Vec<BucketInfo>

Up to 256 Kademlia k-buckets tracked by this auditor.

config: AuditorConfig

Configuration driving audit thresholds.

Implementations

impl RoutingTableAuditor

pub fn new(config: AuditorConfig) -> Self

Creates a new auditor with the given configuration and an empty bucket list.

pub fn add_bucket(&mut self, bucket: BucketInfo)

Appends a bucket to the auditor’s bucket list.

pub fn update_bucket( &mut self, bucket_index: usize, peer_count: usize, now_secs: u64, )

Updates an existing bucket identified by bucket_index. If no bucket with that index exists a new one is inserted with DEFAULT_MAX_CAPACITY.

pub fn audit(&self, now_secs: u64) -> Vec<AuditFinding>

Runs the full audit at time now_secs and returns all findings sorted by severity descending (most severe first).

Checks performed:

1. insufficient_peers (Error) – total peer count < min_total_peers.
2. empty_buckets (Warning) – count of empty buckets > max_empty_buckets.
3. stale_bucket (Warning) – each bucket whose last_refreshed_secs is older than stale_threshold_secs.
4. full_bucket (Info) – each bucket at maximum capacity.

pub fn total_peers(&self) -> usize

Returns the total number of peers across all tracked buckets.

pub fn empty_bucket_count(&self) -> usize

Returns the number of buckets that currently contain no peers.

pub fn stale_bucket_count(&self, now_secs: u64) -> usize

Returns the number of buckets that have not been refreshed within the configured stale_threshold_secs.

Trait Implementations

impl Clone for RoutingTableAuditor

fn clone(&self) -> RoutingTableAuditor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RoutingTableAuditor

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

Formats the value using the given formatter.