Skip to content

Releases: input-output-hk/mithril

Unstable Development Builds

20 Nov 16:06
@github-actions github-actions
unstable
2943337
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Unstable Development Builds Pre-release
Pre-release

Crates Versions

Crate Version
mithril-aggregator 0.7.95
mithril-client 0.12.34
mithril-client-cli 0.12.33
mithril-client-wasm 0.9.7
mithril-common 0.6.29
mithril-signer 0.2.280
mithril-stm 0.6.0

Networks Compatibility ⚠️

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

Cardano Node Compatibility

Network Mithril Aggregator Mithril Signer
release-mainnet Cardano 10.4.1+(*) Cardano 10.4.1+(*)
release-preprod Cardano 10.4.1+(*) Cardano 10.4.1+(*)
pre-release-preview Cardano 10.4.1+(*) Cardano 10.4.1+(*)
testing-preview Cardano 10.4.1+(*) Cardano 10.4.1+(*)

*: Up to the latest Cardano node version released at the time of this release.

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 provided on a best-effort basis and are not officially supported.

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-2943337 ghcr.io/input-output-hk/mithril-aggregator:main-2943337
mithril-signer mithril-signer:main-2943337 ghcr.io/input-output-hk/mithril-signer:main-2943337
mithril-client mithril-client:main-2943337 ghcr.io/input-output-hk/mithril-client:main-2943337

What's Changed

  • Decentralization of configuration parameters phase 1 - new aggregator route by @turmelclem in #2741
  • fix: Rust 1.91 clippy warnings by @Alenar in #2757
  • refactor: use shared aggregator client for signer and aggregrator by @Alenar in #2755
  • docs: rotate documentation for 2543 distribution by @jpraynaud in #2748
  • docs: final CHANGELOG for '2543.0' distribution by @jpraynaud in #2751
  • docs: add dev blog posts for distribution 2543 by @jpraynaud in #2752
  • ci: enhance npm publish workflow by @Alenar in #2753
  • docs: update blog post distribution 2543 by @jpraynaud in #2774
  • fix: apply hotfix of 2345.1-hotfix by @jpraynaud in #2773
  • fix: install on aarch64 by @SupernaviX in #2776
  • fix: syntax error in shell script by @SupernaviX in #2777
  • refactor(signer): split signer aggregator client into several small business services by @Alenar in #2775
  • Decentralization of configuration parameters phase 1 - Aggregator local parameters by @turmelclem in #2736
  • chore: remove uneeded crates type from most Cargo.toml by @Alenar in #2783
  • ci(test-client): check fast bootstrap after lmdb conversion by @Alenar in #2778
  • chore(ci): upgrade actions versions by @Alenar in #2784
  • fix(ci): support hotfix branches in backcompat workflow by @Alenar in #2787
  • fix: docs and explorer websites vulnerabilities by @jpraynaud in #2788
  • Stm error handling with anyhow by @curiecrypt in #2765
  • refactor: support optional cardano transaction signing config by @Alenar in #2789

New Contributors

Full Changelog: 2543.0...unstable

Contributors

Alenar, SupernaviX, and 3 other contributors
Loading