Struct TrustEngine 

pub struct TrustEngine { /* private fields */ }

Local trust engine based on direct peer observations.

Scores are an exponential moving average of success/failure observations that decays toward neutral (0.5) when idle. Bounded by MIN_TRUST_SCORE and MAX_TRUST_SCORE.

This is the sole authority on peer trust scores in the system.

Implementations

impl TrustEngine

pub fn new() -> Self

Create a new TrustEngine

pub fn update_node_stats(&self, node_id: &PeerId, update: NodeStatisticsUpdate)

Record a peer interaction outcome

pub fn update_node_stats_weighted( &self, node_id: &PeerId, update: NodeStatisticsUpdate, weight: f64, )

Record a peer interaction outcome with an explicit weight.

Weight 1.0 is equivalent to a single internal event. Higher weights amplify the observation’s influence on the EMA. The caller is responsible for validating/clamping the weight before calling this method.

pub fn score(&self, node_id: &PeerId) -> f64

Get current trust score for a peer (synchronous).

Applies time decay lazily — no background task needed. Returns DEFAULT_NEUTRAL_TRUST (0.5) for unknown peers.

Uses parking_lot::RwLock so this never falls back to a stale neutral value during write contention — it briefly blocks until the writer releases.

pub fn remove_node(&self, node_id: &PeerId)

Remove a peer from the trust system entirely

pub fn export_snapshot(&self) -> TrustSnapshot

Export current trust state as a serializable snapshot.

Applies decay to all scores before exporting so the snapshot reflects the current effective scores.

pub fn import_snapshot(&self, snapshot: &TrustSnapshot)

Import trust state from a persisted snapshot.

Scores are restored as-is with last_updated set to now. Decay does not run while our node is offline — we can’t observe peer behavior during downtime, so penalising peers for our absence would be wrong. Decay resumes naturally from the moment the node restarts.

Trait Implementations

impl Debug for TrustEngine

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

Formats the value using the given formatter.

impl Default for TrustEngine

fn default() -> Self

Returns the “default value” for a type.