Unstable Development Builds

Crates Versions

Crate	Version
mithril-aggregator	0.7.83
mithril-client	0.12.27
mithril-client-cli	0.12.26
mithril-client-wasm	0.9.4
mithril-common	0.6.15
mithril-signer	0.2.267
mithril-stm	0.4.11

Networks Compatibility ⚠️

Network	Compatible
release-mainnet	⛔
release-preprod	⛔
pre-release-preview	⛔
testing-preview	✔

Platform Support

Summary of the platforms for which pre-built binaries are provided.

Binary	Linux x64	Linux arm64	macOS arm64	Windows x64
mithril-aggregator	✔	✔ ⁽*⁾	⛔	⛔
mithril-signer	✔	✔ ⁽*⁾	⛔	⛔
mithril-client	✔	✔ ⁽*⁾	✔	✔

⁽*⁾⚠️ Linux arm64 builds are not guaranteed, use at your own risk.

Linux Requirements

The Linux binaries target glibc: to run them or install the .deb packages you must have glibc version 2.35+ installed.
Compatible systems include, but are not limited to, Ubuntu 22.04+ or Debian 12+ (Bookworm)).

Fetch the latest version of the unstable tag

The unstable tag is updated with a new commit id when a new unstable release is published.
To fetch the latest version of the unstable tag, execute the command:
git tag -d unstable && git fetch origin tag unstable

Download a binary asset

To simplify the installation and updating of Mithril binaries, we have created a one line installer that downloads and installs the Mithril binaries for you.
This installer is available for Linux and macOS and supports the Mithril signer, Mithril aggregator, and Mithril client CLI.

Use the following commands to install the Mithril nodes:

• Download the Mithril signer in the current directory:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/input-output-hk/mithril/refs/heads/main/mithril-install.sh | sh -s -- -c mithril-signer -d unstable -p $(pwd)

• Download the Mithril client CLI in the current directory:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/input-output-hk/mithril/refs/heads/main/mithril-install.sh | sh -s -- -c mithril-client -d unstable -p $(pwd)

• Download the Mithril aggregator in the current directory:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/input-output-hk/mithril/refs/heads/main/mithril-install.sh | sh -s -- -c mithril-aggregator -d unstable -p $(pwd)

Verify the authenticity of a downloaded asset

Detailed procedure to verify an asset

• Step 1: Identify the downloaded asset on your computer YOUR_ASSET_FILE
• Step 2: Download the signed checksum file from this link CHECKSUM.asc and save it in the same folder as the asset
• Step 3: In your terminal, go to the asset folder by running:

cd ***YOUR_ASSET_FOLDER***

• Step 4: Then verify the checksum of the asset by running:

sha256sum -c ./CHECKSUM.asc 2>/dev/null | grep ***YOUR_ASSET_FILE***

You must see:

./***YOUR_ASSET_FILE***: OK

• Step 5: Download the public key file from this link public-key.gpg and save it in the same folder as the asset
• Step 6: Then import the GPG public key:

gpg --import ./public-key.gpg

You must see something like:

gpg: key : public key "Input Output / Mithril <[email protected]>" imported
gpg: Total number processed: 1
gpg:               imported: 1

• Step 7: Then verify the GPG signature of the checksum file:

gpg --verify ./CHECKSUM.asc

You must see something like:

gpg: Signature made Mon 05 Dec 2022 04:53:54 PM CET
gpg:                using RSA key 35EDE9D47BBA62A2F388E655899ACD26B8BCA0D2
gpg: Good signature from "Input Output / Mithril <[email protected]>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 35ED E9D4 7BBA 62A2 F388  E655 899A CD26 B8BC A0D2

The signature is valid if and only if:

• there is a line with gpg: Good signature from "Input Output / Mithril <[email protected]>"
• there is a line with Primary key fingerprint: 73FC 4C3D FD55 DBDC 428A D2B5 BE04 3B79 FDA4 C2EE

• Step 8:
  If you successfully validated all the steps of this process, then you have successfully verified the authenticity of the asset ✔️
  If not, contact us at [[email protected]] and let us know of the outcome of your run of this process ⚠️

Download a Docker image

You can directly pull prebuilt Mithril Docker images:

Binary	Image name	URL
mithril-aggregator	mithril-aggregator:main-0461172	ghcr.io/input-output-hk/mithril-aggregator:main-0461172
mithril-signer	mithril-signer:main-0461172	ghcr.io/input-output-hk/mithril-signer:main-0461172
mithril-client	mithril-client:main-0461172	ghcr.io/input-output-hk/mithril-client:main-0461172

What's Changed

• Organize STM - Module Parameters by @curiecrypt in #2553
• fix: rename artifact on wasm test failure in Mithril Client multi-platform test workflow. by @dlachaume in #2566
• fix: bytes codec in STM library by @jpraynaud in #2556
• feat(mithril-client lib): stabilize cardano-database-v2 by @Alenar in #2563
• Split mithril-common phase 2: extract Mithril ticker by @Alenar in #2565
• Split mithril-common phase 2: extract Mithril era by @Alenar in #2569
• Split mithril-common phase 2: extract Mithril cardano node chain by @Alenar in #2570
• ci: add --locked to clippy in check step by @Alenar in #2573
• feat: revise OpenAPI compatibility enforcement by @dlachaume in #2572
• docs: rotate documentation for 2524 distribution by @jpraynaud in #2564
• docs: final CHANGELOG for '2524.0' distribution by @jpraynaud in #2575
• docs: add dev blog post for distribution 2524 by @jpraynaud in #2576
• Docs: add blog post for UTxO-HD ledger state snapshot conversion by @dlachaume in #2560
• chore: bump mithril-stm dependency version constraint in mithril-common by @jpraynaud in #2584
• fix: add missing .md file extension by @dlachaume in #2587
• Docs: dev blog post for Cardano database backend switch by @jpraynaud in #2583
• fix(ci): publish of wasm packages to npm when Cargo.toml version dont match package.json by @Alenar in #2588
• docs: update post for UTxO-HD ledger state snapshot converter by @jpraynaud in #2591
• feat: support bytes codec in ProtocolKey by @jpraynaud in #2557
• feat: enhance tools utxo-hd snapshot-converter Mithril client CLI command by @dlachaume in #2589
• ci: split Cardano DB download and ledger state snapshot conversion in test-docker job by @dlachaume in #2592
• Adding command to verify cardano database by @turmelclem in #2574
• Split mithril-common phase 2: extract Mithril cardano node internal database by @Alenar in #2586
• Split mithril-common phase 2: extract Mithril api spec by @Alenar in #2593
• Split mithril-common phase 2: extract Mithril test http server by @Alenar in #2594
• Remove cardano-db-v2 and make cardano-db --backend v2 stable by @turmelclem in #2595
• prettier 3.6 by @Alenar in #2601
• filip(feat): docs site redesign by @fstoqnov-iohk in #2597
• aggregator: add /certificate/genesis endpoint by @Alenar in #2600
• ci: reactivate action-gh-release v2 in CI and pre-release workflows by @dlachaume in #2603
• chore: anticipate rust 1.88 by @Alenar in #2604
• remove batch verify aggr and rename gen to generate by @curiecrypt in #2598
• filip(fix): add client side wrapper to homepage by @fstoqnov-iohk in #2605
• filip(fix): force re-render to initialise scrollY framer motion hooks by @fstoqnov-iohk in #2607
• feat: abstract KES signature process by @jpraynaud in #2606
• docsite & explorer: add serve_static makefile target by @Alenar in #2611
• Prepare project upgrade to Rust 2024 edition by @dlachaume in #2608
• filip(fix): rewrite scroll-based animation with pure css/js to exclude framer by @fstoqnov-iohk in #2612
• ci: improve test-mithril-client-wasm job debugging by uploading logs as artifacts by @dlachaume in #2614
• Enhance STM library readability - Rename Structs by @curiecrypt in #2602
• test:enhance certificate chain builder and mock build by @Alenar in #2615
• feat: add DMQ publisher/consumer in signer/aggregator by @jpraynaud in #2599
• ci: replace Sendgrid usage in Test Notify on Failure GitHub workflow by @dlachaume in #2626
• Stabilization of cardano db v2 (aggregator) by @turmelclem in #2610
• Upgrade to Rust 2024 edition by @dlachaume in #2613
• ci: add Linux arm64 support by @dlachaume in #2628
• fix: formatting issues with cargo fmt by @dlachaume in #2631
• Enhance STM library readability - Deprecate Old Structs by @curiecrypt in #2629
• Add print in output of the client CLI version at each command execution by @turmelclem in #2630
• feat: add support for Mithril era transition in clients by @dlachaume in #2633
• Enhance STM library readability - Rename functions by @curiecrypt in #2632
• feat: Add CertificateChainSynchronizer and make follower aggregators start their chain by synchronising with their leader by @Alenar in #2634
• fix(dmq): add missing KES period in 'DmqMsg' by @jpraynaud in #2636
• make website more future-proof by @Alenar in #2641
• refactor: unify and extend CardanoNetwork implementation by @dlachaume in #2643
• Chore: update dependencies for distribution 2530 by @jpraynaud in #2644
• ci: add extra information to release notes by @dlachaume in #2646
• fix: escape $(pwd) and format installation commands by @dlachaume in #2648
• refactor: rethink dummies test doubles by @Alenar in #2647
• chore: replace serde_yaml with serde_yml by @dlachaume in #2649
• refactor: common test utils by @Alenar in #2650
• fix: mithril metric tests build by @Alenar in #2654
• chore: add a link to the CI badge and Crates by @Olexandr88 in #2645
• refactor: use TryFrom for Certificate and CertificateRecord conversions by @dlachaume in #2652
• chore: add and unify badges to all published projects by @Alenar in #2655
• Document immutables folder discovery is recursive by @turmelclem in #2656
• fix: restore missing section in unstable release notes by @dlachaume in #2659
• ci: add support for testing a specific release in Backward compatibility workflow by @dlachaume in #2658
• fix: add write access check for install path in one-line installer by @dlachaume in #2660
• add shared aggregator client by @Alenar in #2661
• chore: update nightly workflow schedule by @jpraynaud in #2663
• fix: Rust 1.89 clippy warnings by @jpraynaud in #2665
• feat: support Cardano node 10.5 by @jpraynaud in #2664
• fix: infra for Cardano node 10.5 by @jpraynaud in #2666
• chore: add dev adr for guidelines on writting test utilities + remove test_tools and full features from mithril-common by @Alenar in #2653
• fix: block producer infrastructure configuration by @jpraynaud in #2667
• fix: Operational Certificate circular dependency in KES signature by @jpraynaud in #2669
• feat: implement fake DMQ node by @jpraynaud in #2635

New Contributors

• @fstoqnov-iohk made their first contribution in #2597
• @Olexandr88 made their first contribution in #2645

Full Changelog: 2524.0...unstable