Sulkta-Coop/mithril-go
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Pure Go client for the Cardano Mithril certified-snapshot protocol
1 commit 1 branch 2 tags 127 KiB
Find a file
Kayos f87b7fc3c4 initial scaffold 
- module layout: cmd/mithril-go, internal/{aggregator,artifact,verify,networks}
- aggregator REST client, list command working against mainnet
- download/extract/verify stubbed
- no deps yet, pure stdlib
2026-04-23 15:12:39 -07:00
cmd/mithril-go initial scaffold 2026-04-23 15:12:39 -07:00
internal initial scaffold 2026-04-23 15:12:39 -07:00
.gitignore initial scaffold 2026-04-23 15:12:39 -07:00
go.mod initial scaffold 2026-04-23 15:12:39 -07:00
README.md initial scaffold 2026-04-23 15:12:39 -07:00

README.md

mithril-go

Pure-Go client for the Cardano Mithril protocol.

Mithril is Cardano's stake-based certified-snapshot system — it lets a new node bootstrap the chain from a cryptographically-verified snapshot instead of replaying every block from genesis.

The official mithril-client is Rust. This project is a pure-Go reimplementation that produces a single static binary with no runtime dependencies — useful for:

  • Embedding a Mithril bootstrap into Go-based Cardano tooling (alongside gouroboros, dingo, and friends)
  • Running on constrained ARM/embedded targets where shipping the Rust binary + its deps is overkill
  • Operators who prefer a single go install-able helper

Status

Early development — not usable yet. Current state:

  • Module scaffold, network configs, aggregator REST client
  • list command hits the aggregator and enumerates cardano-database snapshots
  • download — range-chunk parallel HTTP, SHA-256 integrity, resume
  • extract — streamed zstd + tar decompression
  • Genesis Ed25519 verification (per-network bootstrap key)
  • STM BLS12-381 aggregate-signature verification (the hard part)
  • Incremental / ancillary artifact support

Usage (eventual)

mithril-go info     -network mainnet
mithril-go list     -network mainnet
mithril-go download -network mainnet -out ./db latest
mithril-go verify   -network mainnet ./db

License

TBD