Struct RecentProvers 

pub struct RecentProvers { /* private fields */ }

Per-key cache of recent provers, capped at MAX_PROVERS_PER_KEY.

Implementations

impl RecentProvers

pub fn new() -> Self

Empty cache.

pub fn record_proof( &mut self, key: XorName, peer_id: PeerId, commitment_hash: [u8; 32], proved_at: Instant, )

Record that peer_id proved storage of key under commitment commitment_hash at proved_at.

If the same (peer_id, commitment_hash) is already cached for this key, the entry is updated in place (refreshes proved_at). Otherwise a new entry is appended, evicting the oldest entry if the per-key cap would be exceeded.

pub fn is_credited_holder( &self, key: &XorName, peer_id: &PeerId, current_commitment_hash: &[u8; 32], ) -> bool

Is peer_id currently credited as a holder of key?

Returns true iff there is a non-stale cached entry with peer_id and commitment_hash == current_commitment_hash.

“Non-stale” means now - proved_at < PROVER_ENTRY_TTL. The hash binding is the v12 §6 lever: a peer that rotates their commitment must re-prove every key they want credit for. The TTL is a secondary safety net that revokes credit even if the hash happens to match (e.g. a peer who proved long ago but has been silent or offline since).

pub fn sweep_expired(&mut self, now: Instant) -> usize

Sweep entries older than PROVER_ENTRY_TTL across all keys.

Returns the number of entries dropped. Intended for periodic invocation by a background task; is_credited_holder already honours the TTL on read, so the sweep only reclaims memory.

pub fn forget_peer(&mut self, peer_id: &PeerId)

Drop every cached entry for peer_id across all keys.

Called when a peer leaves the routing table (RT-only invariant) or on explicit eviction.

pub fn forget_commitment(&mut self, stale_hash: &[u8; 32])

Drop every entry whose commitment_hash matches stale_hash (used when the auditor invalidates a peer’s last_commitment — e.g. on UnknownCommitmentHash rejection — to remove the cached proofs against that no-longer-valid commitment).

pub fn provers_for(&self, key: &XorName) -> usize

Number of cached entries for key. Test/observability helper.

pub fn total_entries(&self) -> usize

Total number of cached entries across all keys.

Trait Implementations

impl Clone for RecentProvers

fn clone(&self) -> RecentProvers

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecentProvers

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

Formats the value using the given formatter.

impl Default for RecentProvers

fn default() -> RecentProvers

Returns the “default value” for a type.