Enum ServeAudit 

pub enum ServeAudit {
    Serveable {
        size: u64,
    },
    Unavailable {
        withdrawn: bool,
    },
}

Serve-path verdict for one hash, from a single store status() call.

Answers in one store contact what the delivery path asks in two — CacheEngine::has for presence and CacheEngine::inspect for size (#1789 item 7 part B). The variants are the delivery path’s own branches, so a size is reachable only where it is serveable and a refusal can never be paired with a wire size.

Variants

Serveable

The store reports the blob complete and no gate refuses it (denied / chain-denied / evicted) — the same condition CacheEngine::has reports. size is the whole-blob wire size, and 0 means a genuinely empty blob.

Fields

size: u64

Whole-blob byte size to advertise on the wire.

Unavailable

Nothing serveable from the local store: the blob is absent, partial, or refused by a gate.

Fields

withdrawn: bool

Whether this node withdrew the hash on its own authority: an operator eviction (CacheEngine::is_evicted, #279) or a stored-corruption quarantine (CacheEngine::is_quarantined). The miss path must not fill a withdrawn hash: a fill of an evicted hash would undo the takedown, and a fill of a quarantined hash would land on the corrupt entry and pay for bytes it can never serve. A quarantined hash becomes fillable again only after GC reclaims the entry and the quarantine lifts; an evicted hash never does.

Implementations

impl ServeAudit

pub const fn hit_size(&self) -> Option<u64>

Wire size for a warm hit; None when the delivery path must fill and then size the blob itself.

pub const fn is_serveable(&self) -> bool

Whether the blob can be served from the local store right now.

pub const fn is_withdrawn(&self) -> bool

Whether this node withdrew the hash: evicted or quarantined. false for a serveable hash, since both are gates that refuse a serve.

Trait Implementations

impl Clone for ServeAudit

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServeAudit

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

Formats the value using the given formatter.

impl Eq for ServeAudit

impl PartialEq for ServeAudit

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ServeAudit