Struct NodeFactsCache 

pub struct NodeFactsCache { /* private fields */ }

Verified node facts with TTL.

Implementations

impl NodeFactsCache

pub fn new() -> Self

Empty cache.

pub fn insert( &self, signed: SignedNodeFacts, trust_tier: TrustTier, now: u64, ) -> Result<InsertOutcome, CacheError>

Verify and cache a signed facts block with a receiver-assigned tier.

pub fn insert_remote( &self, signed: SignedNodeFacts, mesh_tier: TrustTier, max_provenance: Provenance, origin: u64, now: u64, ) -> Result<InsertOutcome, CacheError>

Self::insert for facts a peer sent. Every capability’s provenance is capped at max_provenance in the cached copy: the receiver did not probe or measure remote data, so a peer’s measured claim is never held as measured. The signed envelope is kept as received.

mesh_tier is derived from the connection that sent the facts and is re-derived on every frame; a tier the operator set is kept. origin names the connection (see Self::discovered_from). When the cache is full, the oldest mesh-derived Discovered entry makes room before the insert is refused, so Paired and Pinned entries are never pushed out by Discovered ones.

pub fn discovered_from(&self, origin: u64, now: u64) -> usize

Fresh mesh-derived Discovered entries that connection origin supplied.

pub fn demote_mesh_tier(&self, node_id: &str) -> bool

Lower a mesh-derived tier to Discovered (the node’s admission was revoked or its verified connection is gone). An operator-set tier is left alone. True if the tier changed.

pub fn apply_delta( &self, signed: &SignedFactsDelta, now: u64, ) -> Result<(), CacheError>

Verify a signed delta and apply it to the cached base.

pub fn set_trust_tier(&self, node_id: &str, trust_tier: TrustTier) -> bool

Re-assign the receiver-side trust tier of a held node (an operator changed it; the signed facts are unchanged). False if not held.

pub fn get(&self, node_id: &str, now: u64) -> Option<CachedNodeFacts>

Fresh facts for one node.

pub fn list(&self, now: u64) -> Vec<CachedNodeFacts>

All fresh facts, sorted by node id.

pub fn evict_expired(&self, now: u64) -> usize

Drop expired entries; returns how many were removed.

pub fn len(&self) -> usize

Entries held (fresh or not yet evicted).

pub fn is_empty(&self) -> bool

True if nothing is held.

Trait Implementations

impl Debug for NodeFactsCache

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

Formats the value using the given formatter.

impl Default for NodeFactsCache

fn default() -> Self

Returns the “default value” for a type.