Struct VerifiedCache 

pub struct VerifiedCache { /* private fields */ }

LRU cache for verified XorName values.

This cache stores XorName values that have been verified to exist on the autonomi network, avoiding repeated network queries for the same data.

Each entry carries a flag recording whether the verification that inserted it ran the full client-PUT check set (true) or only the receipt-authenticity subset used for replication (false). A replication-verified entry must not satisfy a later client-PUT fast-path — the context-gated checks (own-quote freshness, local recipient, merkle candidate closeness) were never run for it — while either kind of entry satisfies a later replication check.

Implementations

impl VerifiedCache

pub fn new() -> Self

Create a new cache with default capacity.

pub fn with_capacity(capacity: usize) -> Self

Create a new cache with the specified capacity.

If capacity is 0, defaults to 1.

pub fn contains(&self, xorname: &XorName) -> bool

Check if a XorName is in the cache (verified under either check set).

Returns true if the XorName is cached (verified to exist on autonomi). Sufficient for replication-context lookups; client-PUT lookups must use Self::contains_client_put_verified.

pub fn contains_client_put_verified(&self, xorname: &XorName) -> bool

Check if a XorName is cached AND its verification ran the full client-PUT check set.

A replication-verified entry returns false here: it never passed the client-PUT-only checks, so it must not let a later client PUT skip them.

pub fn insert(&self, xorname: XorName)

Add a XorName verified under the full client-PUT check set.

This should be called after verifying that data exists on the autonomi network. Also upgrades an existing replication-verified entry.

pub fn insert_replication_verified(&self, xorname: XorName)

Add a XorName verified under the replication (receipt-authenticity) subset only.

Never downgrades an existing client-PUT-verified entry — the stronger verification already happened, and replication re-offers of the same key are routine.

pub fn stats(&self) -> CacheStats

Get current cache statistics.

pub fn len(&self) -> usize

Get the current number of entries in the cache.

pub fn is_empty(&self) -> bool

Check if the cache is empty.

pub fn clear(&self)

Clear all entries from the cache.

Trait Implementations

impl Clone for VerifiedCache

fn clone(&self) -> VerifiedCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for VerifiedCache

fn default() -> Self

Returns the “default value” for a type.