Modules / ade_runtime::chaindb::transient_epoch_view

ade_runtime::chaindb::transient_epoch_view

GREEN
GREEN submodule GREEN by content — transient replay-window lifecycle
Purpose

The transient (GREEN, non-authoritative) disk-backed replay-window lifecycle over the dormant redb UtxoAnchor — a bounded materialization scratch (transient_root under a fixed owned subtree, a deterministic Blake2b window_key, fail-closed purge_transient_root on startup) that may accelerate bounded materialization but never survives as authority.

Creates

The transient-window lifecycle types + transient_root / window_key / is_valid_window_key / purge_transient_root. GREEN — not canonical-counted.

MUST NOT

Affect authoritative outputs; introduce nondeterminism (deterministic Blake2b key, no rand/uuid). MUST NOT survive as authority, influence BLUE outputs, or become a fallback for follow/forge/recovery/snapshot activation; MUST NEVER live under any durable-artifact directory; purge_transient_root fails closed (a delete / dir-fsync / name-validation failure is a STRUCTURED TERMINAL failure) and MUST NEVER weaken redb's Immediate durability for an authoritative artifact. Gated by ci_check_transient_view_not_live.sh, ci_check_transient_view_no_fallback.sh, ci_check_transient_view_memory_ceiling.sh.

Inbound deps

ade_runtime::chaindb, ade_node.

Outbound deps

ade_crypto::blake2b::blake2b_256, redb, the storage config + UtxoAnchor.

Entry points

ade_runtime::chaindb::transient_epoch_view::{transient_root, window_key, is_valid_window_key, purge_transient_root}.

Depends on

—

Depended on by

—