Module engine 

Cache engine: local iroh-blobs store fronted by an Origin for misses.

Structs

CacheEngine

Engine bundling a filesystem-backed iroh-blobs store with an optional origin backend. Lookups hit the store first; on miss and when an origin is configured, bytes are pulled and BLAKE3-verified. Insert-before-return is a property of the buffered path (Self::get / Self::populate), not of this type: Self::admit_bao commits only a verified sub-range.

EvictionCandidates

Snapshot of access times for blobs that are eligible for LRU eviction — i.e. pinned hashes are already excluded. Returned by CacheEngine::eviction_candidates.

EvictionPreview

Read-only snapshot of a hash’s local-cache state, returned by CacheEngine::inspect. Backs decdn node evict --dry-run (issue #379): operators running DMCA takedowns want to confirm the blob’s size, last-access time, pin status, and already-evicted flag before mutating state.

OriginHeldReport

The origin-held announce set plus what the rescan behind it could not resolve, read as one consistent view — see CacheEngine::origin_held_snapshot.

PresentRanges

The chunk ranges of a hash currently present in the store.

Enums

OriginPresence

A live origin-existence answer (#1766), distinguishing a genuine negative from a backend fault. It is the target of the two-way collapse in crate::origin_probe::Presence: Present/Absent map straight across, and Fault is folded into “don’t advertise” — see CacheEngine::origin_probe_size.

ServeAudit

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