Struct PeerScoreboard 

pub struct PeerScoreboard { /* private fields */ }

Composite peer scoreboard.

Maintains per-peer scores across multiple weighted components and provides ranking, decay, and statistics.

Implementations

impl PeerScoreboard

pub fn new(decay_rate: f64) -> Self

Create a new scoreboard with the given per-tick decay rate.

decay_rate is clamped to [0.0, 1.0].

pub fn register_component(&mut self, name: &str, default_weight: f64)

Register (or update the default weight of) a scoring component.

pub fn update_score(&mut self, peer_id: &str, component: &str, value: f64)

Update a single component score for peer_id.

value is clamped to [0.0, 1.0]. If the component has not been registered the call is silently ignored.

pub fn get_score(&self, peer_id: &str) -> Option<f64>

Return the composite score for peer_id, if tracked.

pub fn get_component(&self, peer_id: &str, component: &str) -> Option<f64>

Return the value of a single component for peer_id.

pub fn rank_peers(&self) -> Vec<(String, f64)>

Return all peers ranked by composite score (descending).

pub fn top_peers(&self, n: usize) -> Vec<(String, f64)>

Return the top n peers by composite score (descending).

pub fn apply_decay(&mut self)

Multiply all component values by decay_rate and recompute composites.

pub fn remove_peer(&mut self, peer_id: &str) -> bool

Remove a peer from the scoreboard. Returns true if the peer existed.

pub fn peer_count(&self) -> usize

Number of tracked peers.

pub fn tick(&mut self)

Advance the internal tick counter by one and apply decay.

pub fn stats(&self) -> ScoreboardStats

Snapshot statistics for the entire scoreboard.

pub fn current_tick(&self) -> u64

Return the current tick value.

Trait Implementations

impl Clone for PeerScoreboard

fn clone(&self) -> PeerScoreboard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerScoreboard

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

Formats the value using the given formatter.