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
2 commits 1 branch 2 tags 127 KiB
Find a file
Kayos e557d85d5a download + extract pipeline 
- artifact.Download: resumable HTTP with optional SHA256 check + progress cb
- artifact.ExtractZstdTar: streamed zstd+tar with tar-slip defense
- aggregator client matches real API shape (digests/immutables/ancillary blocks
  with URIHolder polymorphism for templated immutable URIs)
- cmd: show + download subcommands wired up
- end-to-end verified against preprod: digests archive pulls cleanly, yields
  16836-entry SHA manifest ready for verification sprint

deps: github.com/klauspost/compress (pure-go zstd)
2026-04-23 15:16:48 -07:00
cmd/mithril-go download + extract pipeline 2026-04-23 15:16:48 -07:00
internal download + extract pipeline 2026-04-23 15:16:48 -07:00
.gitignore initial scaffold 2026-04-23 15:12:39 -07:00
go.mod download + extract pipeline 2026-04-23 15:16:48 -07:00
go.sum download + extract pipeline 2026-04-23 15:16:48 -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