Technical reference
Architecture, parity, and contribution.
Material for engineers and auditors evaluating the Yggdrasil implementation against the upstream Haskell node — not for operators running a node. For installation and operation, see the User Manual.
Architecture & parity
- → Architecture Workspace structure, dependency direction, mini-protocol layering, multi-peer dispatch, rollback sidecars.
- → Parity proof Operational verification reference: 25/25 cardano-cli LSQ subcommands, consensus sidecar persistence, remaining gaps, runbook.
- → Parity summary Subsystem status table + per-function inventory + cumulative round audit history (management + stakeholder facing).
- → Upstream parity matrix Pinned IntersectMBO commit SHAs, subsystem-reference table, drift snapshot, open gaps.
- → Completion roadmap Forward-looking backlog of remaining work to fully complete the project — executable now, operator-soak gated, and running-Haskell-node gated.
Archived planning docs
These documents drove the project’s planning + audit cycles before the R273-rename + Phase A–F (R274–R301) execution arc shipped. They are preserved as audit-trail evidence; for current state, follow the live links above.
- → Parity plan (2026-03 archive) Original 2026-03-26 pre-execution planning doc. Phases A–F shipped via R274–R298 — see live successors above.
- → 2026-Q2 audit (archive) 2026-Q2 sanity audit. R287 confirmed every C-1/H-1/H-2/M-1..M-8/L-1..L-9 finding closed in the 2026-Q3 operational pass.
- → Upstream research (archive) Pre-plan Haskell node research (2026-05-01). Superseded by Architecture, Parity proof, and the per-file strict-mirror audit TSV.
Specs & dependencies
- → Specifications Pinned CDDL fixtures and their provenance.
- → Dependencies Third-party crate audit and the rules for adding new ones.
Validation & release
- → Manual test runbook Operator wallclock validation: preprod/mainnet sync, hash compare, restart resilience, parallel-fetch §6.5.
- → Preprod pool verification Preprod block-production rehearsal record.
- → Contributing Coding style, AGENTS.md operational rules, PR workflow.
- → Changelog Release notes and the release process.