Mithril v2445.0

Highlights:

• 🔥 BREAKING changes in Mithril client library, CLI, and WASM:
  • Remove deprecated beacon field from Mithril certificates.
  • Clients from distribution 2430 and above are compatible with this change.
• Stable support for Cardano node 10.1.2 in the signer and the aggregator.
• Stable support for Cardano stake distribution client library, CLI and WASM.
• Stable support for Prometheus metrics endpoint in aggregator.
• Bug fixes and performance improvements.

What's Changed

• Fix: add missing automatically generated release note section for unstable releases by @dlachaume in #2011
• Standardize logs in common, signer, and persistence by @Alenar in #2010
• Sfauvel/1990/refactor prometheus metrics using struct by @sfauvel in #1998
• Feat: implement certificate chain builder for tests by @jpraynaud in #1999
• Refactor client cli command parameters by @Alenar in #2012
• Enhance logs in client and client-cli by @Alenar in #2013
• Fix clippy warnings from Rust 1.82 by @Alenar in #2015
• Enhance logs in mithril-relay by @Alenar in #2014
• Upgrade mac runner + Fix incorrect param by @Alenar in #2019
• Upgrade actions to latest by @Alenar in #2020
• Docs: rotate documentation for 2442 distribution by @jpraynaud in #2005
• Docs: final CHANGELOG for '2442.0' distribution by @jpraynaud in #2031
• Create dev blog post for certification of Cardano stake distribution by @dlachaume in #1892
• Activate metrics endpoint on aggregator by @dlachaume in #2022
• Fix: clap arguments are always overriding configuration by @dlachaume in #2038
• Docs: enhance era markers runbook by @jpraynaud in #2033
• Fix: monitoring configuration in infra by @jpraynaud in #2039
• Fix: rename certificate_total_produced_since_startup metric name in aggregator by @dlachaume in #2040
• Fix unneeded rescan when importing transactions in chunk by @Alenar in #2035
• Fix: remove _counter suffix from aggregator metrics by @dlachaume in #2041
• Fix: computation of the chaining of the certificates in tests by @jpraynaud in #2032
• Devbook: upgrade crates and openapi script by @Alenar in #2042
• Fix: ensure epoch consistency during epoch changes when signer is signing by @dlachaume in #2046
• Respin testing-sanchonet with Cardano 10.1.0-pre by @jpraynaud in #2048
• Refactor event store to use migration mechanism by @sfauvel in #2043
• Enhance end-to-end tests termination by @Alenar in #2050
• Refactor ChainPoint conversion from pallas Point by @Alenar in #2049
• Feat: Make Cardano stake distribution stable in client by @dlachaume in #2052
• Fix: era markers and pool tools for Cardano 10.1 by @jpraynaud in #2053
• Remove beacon from certificate by @Alenar in #2055
• Ensemble/1958/fix explorer by @Alenar in #2056
• Feat: add aggregator metric to record the number of restoration of the Cardano database by @dlachaume in #2057
• Refactor: rename protocol parameters for consistency in signer and aggregator by @dlachaume in #2058
• CI: add scheduled Docker builds workflow by @dlachaume in #2060
• ci: add nightly backward compatibility testing with e2e tests by @dlachaume in #2063
• Record aggregator metrics in event store by @sfauvel in #2059
• Remove pending certificate from explorer by @Alenar in #2061
• Access registered signers for latest epoch in explorer by @Alenar in #2062
• Upgrade mithril explorer to Next 15 by @Alenar in #2065
• Fix metrics_per_day view and improve test by building the real Metric… by @sfauvel in #2068
• ci: update cron schedule expression with co-authors to enable notifications by @dlachaume in #2066
• Feat: Support Cardano node 10.1.1 by @jpraynaud in #2070
• Streamline configurations usage in aggregator by @Alenar in #2081
• Chore: update dependencies for distribution 2445 by @jpraynaud in #2078
• CI: enhance nightly backward compatibility testing workflow by @dlachaume in #2083
• Chore: upgrade to Cardano '10.1.2' by @jpraynaud in #2084
• Feat: add latest shortcut as targeted era for Cardano CLI commands by @dlachaume in #2085
• Create view for registrations monitoring by @sfauvel in #2086
• Docs: update CHANGELOG for 2445.0 distribution release by @jpraynaud in #2080

Full Changelog: 2442.0...2445.0

Crates Versions

Crate	Version
mithril-aggregator	0.5.102
mithril-client	0.10.1
mithril-client-cli	0.10.1
mithril-client-wasm	0.6.1
mithril-common	0.4.79
mithril-signer	0.2.209
mithril-stm	0.3.31

Networks Compatibility ⚠️

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

Distributions Compatibility ⚠️

Compatibility	mithril-signer	mithril-client
2442.0	✔	✔
2437.1	✔	✔
2430.0	✔	✔
2428.0	⛔	⛔
2423.0	⛔	⛔

Linux Requirements

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

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 <mithril@iohk.io>" imported
gpg: Total number processed: 1
gpg:               imported: 1

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

gpg --verify ./public-key.gpg ./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 <mithril@iohk.io>" [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 <mithril@iohk.io>"
• there is a line with Primary key fingerprint: 2AC0 7B11 8B23 1443 F544 2D0C 6E2C 1160 3E79 0021

• 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 [mithril@iohk.io] and let us know of the outcome of your run of this process ⚠️