Architecture Map

20 module entries across 12 workspace crates, grouped by TCB color. Dependencies flow inward only — RED → GREEN → BLUE, never outward.

Dependency graph

BLUE coreGREEN glueRED shellmixedarrows point to dependencies · hover to isolate · click to open a module

BLUE  BLUE modules — 7

Deterministic, authoritative core — pure transitions, no I/O.

GREEN  GREEN modules — 7

Deterministic glue — may depend on BLUE, must not affect authoritative outputs.

ade_runtime::chaindb::reduced_utxo_checkpoint submodule
GREEN by content — DC-EVIEW-04 / DC-EPOCH-11

A disk-backed redb store of the reduced UTxO TxIn → (Coin, ReducedStakeRef) — the "minimal native state": the single ledger authority's own reduced-UTxO projection, a GREEN durab…

ade_runtime::chaindb::transient_epoch_view submodule
GREEN by content — transient replay-window lifecycle

The transient (GREEN, non-authoritative) disk-backed replay-window lifecycle over the dormant redb UtxoAnchor — a bounded materialization scratch (transient_root under a fixed …

ade_testkit crate
GREEN — deterministic test/corpus infrastructure; dev-dep / #[cfg(test)]-scoped

GREEN deterministic TEST / CORPUS infrastructure for the workspace — the oracle/differential harness, the validity & tx-validity corpora, the consensus & governance replay corpora,…

consensus_inputs::{cert_state_extract, protocol_params, canonical} subtree
in ade_runtime

Pure cardano-cli JSON → BLUE CertState / ProtocolParameters (era-aware MinUtxoRule); canonical_from_raw the single import funnel (S2: requires security_param, fail-closed…

forward_sync::reducer subtree
in ade_runtime
, `producer::{coordinator, chain_evolution, self_accepted_handoff}`, `clock`, `orchestrator::{mod,event,state,core}`, `rollback::{cadence,…}`, `seed_import`, `consensus_inputs`, `admission::`

Carried GREEN reducers/planners over BLUE (forward-sync lifecycle, producer coordinator, linear chain-evolution typestate, deterministic clock, orchestrator core, snapshot cadence,…

mithril_native_assembly::assemble_native_mithril_seed subtree
in ade_runtime
`DC-MITHRIL-03`

The PURE assembly half of the native Mithril authority transition — maps each seed field from its single declared source (verified manifest + S1a non-UTxO state + Stage-2 tables UT…

seed_consensus_merge subtree
in ade_runtime

Pure mapping (BTreeMap only) lifting a verified-bootstrap LiveConsensusInputsCanonical + minted anchor fp + seed epoch into the BLUE SeedEpochConsensusInputs (now carries `se…

RED  RED modules — 6

Imperative shell — I/O, network, storage, clocks, keys.

Closed semantic surfaces

SurfaceLocation
ade_types::CardanoEra

Byron=0 … Conway=7

ade_types::shelley::block::PrevHash

2-variant sum

ade_ledger::pparams::MinUtxoRule

2-variant LegacyAbsoluteMin \| PerByte

ade_ledger::wal::WalEntry

4-variant: AdmitBlock \| SeedEpochConsensusInputsImported \| RollBack \| EpochConsensusViewActivated