A pure-Rust Cardano node, built for parity.
Yggdrasil is a from-scratch Rust implementation of the Cardano node, targeting long-term protocol and serialization parity with the upstream Haskell IntersectMBO node. No FFI cryptography. No hidden native dependencies. Just Rust.
Where to start
- → Quick Start Sync a mainnet relay in five commands. The fastest path from a fresh machine to a working node.
- → Installation Prerequisites, build from source, sanity-check the binary, install system-wide.
-
→
Docker
Run as a container with
docker compose— relay or block producer. - → Block Production KES, VRF, and OpCert credential setup for stake pool operators.
- → Monitoring Prometheus metrics, structured tracing, suggested alerts, Grafana dashboards.
- → Troubleshooting Common errors, their causes, and the resolutions that work.
What’s implemented
Every confirmed-active code-level parity slice is closed, including the R273-rename strict naming-parity fix-up, the R274–R288 strict 1:1 file-mirror arc, the R285 Phase 6 multi-peer BlockFetch closure, and the R289–R297 cardano-cli surface expansion. See the parity proof for operational verification (25/25 cardano-cli LSQ subcommands, consensus sidecar persistence, runbook) and the parity summary for the subsystem status table. The 2026-Q2 audit (archived) drove the original closure cycle and is preserved as audit-trail evidence.
| Subsystem | Status |
|---|---|
| Crypto — Blake2b, Ed25519, VRF (std + batchcompat), KES (Simple + Sum 0–6+), BLS12-381, secp256k1 | Complete |
| Ledger — eras Byron through Conway, multi-era UTxO, governance, PPUP, MIR, ratification | Complete |
Storage — file-backed ImmutableStore / VolatileStore / LedgerStore + ChainDb + ChainDepState sidecars |
Complete |
Consensus — Praos leader election, KES/OpCert, ChainState, nonce evolution |
Complete |
| Mempool — fee-ordered queue, TTL admission, ledger revalidation, eviction | Complete |
| Network — mux, all 5 mini-protocols, governor, ledger peers, diffusion types | Complete |
| Plutus — CEK machine, builtins, calibrated cost model | Complete |
| Node binary — sync runtime, inbound server, NtC, block production | Complete |
Reference material
- → Architecture Workspace layout, dependency direction, mini-protocol layering.
- → Parity summary High-level parity status against upstream IntersectMBO.
- → Manual test runbook Operator wallclock validation: preprod/mainnet sync, hash compare, restart resilience.
- → Changelog Release-by-release record of what changed.
Getting help
- File an issue on GitHub.
- For protocol-level questions, consult the Cardano Operations Book.
- For network status, see Cardano Explorer or Pool.pm.