Unstable Development Builds

Crates Versions

Crate	Version
mithril-aggregator	0.7.40
mithril-client	0.11.22
mithril-client-cli	0.11.15
mithril-client-wasm	0.8.8
mithril-common	0.5.24
mithril-signer	0.2.239
mithril-stm	0.3.44

Networks Compatibility ⚠️

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

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

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

What's Changed

• feat: Separate location for ancillary for cardano database v1 by @Alenar in #2380
• refactor: prepare ancillary signing by @Alenar in #2393
• Chore: bump glibc requirement to 2.35+ in one-line installer by @jpraynaud in #2387
• Docs: rotate documentation for 2513 distribution by @jpraynaud in #2390
• docs: final CHANGELOG for 2513.0 distribution by @jpraynaud in #2395
• Docs: add dev blog post for distribution 2513 by @jpraynaud in #2396
• Feat(e2e): support multiple aggregators in the e2e tests by @jpraynaud in #2378
• Docs: fix website documentation by @dlachaume in #2397
• feat: Sign ancillary files in aggregator by @Alenar in #2394
• Fix(infra): fix aggregator crash at startup in testing-preview network by @jpraynaud in #2399
• chore: anticipate rust 1.86 by @Alenar in #2398
• Refactor: rename master/slave signer registration by @jpraynaud in #2400
• Feat(infra): split ssh keys for testing/production by @jpraynaud in #2401
• chore(infra): add ssh key for 'testing' and 'production' by @turmelclem in #2404
• Organize STM - Blst multi_sig module by @curiecrypt in #2405
• Feat: record origin of client requests in metrics by @sfauvel in #2411
• CI: include CardanoDatabase in the backward compatibility test by @dlachaume in #2413
• Feat: include origin tag header for aggregator prover benchmark by @dlachaume in #2416
• explorer: support latest ancillary & cardano database v2 developments by @Alenar in #2418
• fix(aggregator): incorrect immutable files average and total size in cardano database v2 by @Alenar in #2419
• Docs: blog post for the Cardano node database v2 certification by @dlachaume in #2417
• Feat(infra): support follower aggregator in infra by @jpraynaud in #2407
• Fix: signer infra volumes configuration by @jpraynaud in #2420
• feat: Verify ancillary artifacts in client by @Alenar in #2414
• Fix aggregator path in stress test by @sfauvel in #2421
• Refactor: Simplify the configuration of commands in aggregator by @dlachaume in #2423
• Refactor: Simplify the configuration of tools/era commands in aggregator by @dlachaume in #2434
• fix(aggregator): ancillary signing on evolving files by @Alenar in #2425
• feat(aggregator): Sign ancillary with GCP Kms by @Alenar in #2431
• Simplify injection container in aggregator by @sfauvel in #2435
• Refactor: Simplify the configuration of genesis command in aggregator by @dlachaume in #2432
• Doc: update Cardano node database v2 dev blog post by @jpraynaud in #2439
• Refactor: renaming and update aggregator node documentation by @dlachaume in #2438
• refactor: shared workspace dependencies by @Alenar in #2440
• Feat: support GCP KMS ancillary signature in infrastructure by @jpraynaud in #2433
• doc(website): update cardano node boostrap page with ancillary verification by @Alenar in #2441

New Contributors

• @turmelclem made their first contribution in #2404

Full Changelog: 2513.0...unstable

Mithril v2513.0

Highlights:

• ⚠️ Breaking changes in Mithril nodes:
  • Upgraded the minimum required glibc version from 2.31 to 2.35 for the pre-built Linux binaries
  • Mithril signer with versions <=0.2.200 must be updated following the cleanup of Thales era legacy code
  • Mithril client library with_snapshot_uploader function has been renamed to with_file_uploader.
• Support for Cardano node 10.2.1 in the signer and the aggregator
• End support for macOS x64 pre-built binaries for the client CLI
• Bug fixes and performance improvements.

What's Changed

• refactor(aggregator): simplify dependency builder by @Alenar in #2288
• Reduce e2e flakiness by changing protocol parameters by @sfauvel in #2301
• Fix mithril-aggregator genesis bootstrap flakiness in e2e tests by @Alenar in #2303
• Chore: update SSH keys in infra by @dlachaume in #2305
• fix: stm tests run time regression by @Alenar in #2307
• Docs: rotate documentation for 2506 distribution by @jpraynaud in #2283
• Docs: final CHANGELOG for '2506.0' distribution by @jpraynaud in #2311
• chore(ci): reactivate publish test for mithril-client by @Alenar in #2310
• explorer: use main mithril-client-wasm package by @Alenar in #2309
• Mithril dev blog review by @oduameh in #2302
• Docs: add dev blog post for distribution 2506 by @jpraynaud in #2312
• Docs: add dev blog post for certificate chain security advisory by @jpraynaud in #2313
• Use a unique name for the cloud location of digests artifacts Cardano database by @sfauvel in #2314
• Cleanup unused dependencies and auto CI check by @Alenar in #2315
• Split mithril-common crate by extracting some modules by @sfauvel in #2304
• Replace the TODO by a explanation of the limits by @sfauvel in #2308
• ci: Bump build runner to ubuntu 22.04 by @Alenar in #2317
• chore: upgrade dockerfiles base image version to Debian 12 by @Alenar in #2319
• testing-sanchonet network decommission by @dlachaume in #2300
• End support for MacOS x64 pre-built binaries by @dlachaume in #2277
• feat: client library for incremental Cardano database by @jpraynaud in #2289
• refactor(ci): use cache-version instead of 'v0-' in rust cache key prefix by @Alenar in #2323
• Fix wasm build in rust 1.85 by @Alenar in #2326
• feat: Implement an Unknown variant in the artifact locations by @sfauvel in #2320
• Docs: add new Mithril certification section in website by @jpraynaud in #2324
• Feat: Support Cardano node 10.2.1 pre-release by @jpraynaud in #2336
• feat: incremental cardano database restoration with client CLI by @dlachaume in #2318
• Minor editing/formatting improvements by @olgahryniuk in #2338
• Docs: add page for Cardano node database v2 certification by @jpraynaud in #2339
• Feat: add example crate for incremental Cardano database by @jpraynaud in #2337
• Cleanup legacy code from thales era by @Alenar in #2340
• Enhance artifact structure for incremental cardano db by @sfauvel in #2341
• Feat: improve disk space calculation for Incremental DB Restoration by @dlachaume in #2345
• fix: not blocking when computing size by @sfauvel in #2346
• Test: add integration test for incremental Cardano database in mithril-client by @dlachaume in #2344
• Fix: Hydra CI fails with OpenSSL error (Linux x86_64) by @dlachaume in #2348
• Fix: notify-on-failure job succeeds despite email sending failure by @dlachaume in #2349
• Code ADR for mithril-common by @Alenar in #2343
• Use consistent naming in the client cardano database api by @sfauvel in #2347
• Docs: update clients documentation for incremental Cardano DB by @dlachaume in #2350
• Chore: enhance versions bump script by @dlachaume in #2355
• Feat: implement aggregator slave signer registration mode by @jpraynaud in #2351
• Remove flakiness on should delay between retries tests by @sfauvel in #2352
• Docs: add features documentation for mithril-client library by @dlachaume in #2358
• refactor(mithril-client): Optimize cardano db artifacts download by @Alenar in #2359
• Fix BLST bindings: Error handling for infinite values of sigs and vks by @curiecrypt in #2322
• Compress the digests file uploaded on gcp by @sfauvel in #2367
• Feat: verify minimum node version with squash database migration by @dlachaume in #2368
• Reduce flakiness in the ci by @sfauvel in #2370
• Refactor(aggregator): groundwork for ancillary signature by @Alenar in #2372
• Feat: move database vacuum to aggregator startup to avoid API interruptions during epoch transitions by @dlachaume in #2375
• Organize STM code by @curiecrypt in #2373
• Macro to implement the source trait by @sfauvel in #2377
• Reduce flakiness in tests by @sfauvel in #2379
• Organize STM code - Merkle Tree Module by @curiecrypt in #2374
• Error messages as warning in signer by @sfauvel in #2381
• Feat: Support Cardano node 10.2.1 by @jpraynaud in #2386
• refactor(aggregator): remove deprecated configuration field from DependencyContainer by @Alenar in #2385
• Chore: update dependencies for distribution 2513 by @jpraynaud in #2388
• Docs: update CHANGELOG for 2513.0 distribution release by @jpraynaud in #2389

Full Changelog: 2506.0...2513.0

Crates Versions

Crate	Version
mithril-aggregator	0.7.23
mithril-client	0.11.17
mithril-client-cli	0.11.11
mithril-client-wasm	0.8.6
mithril-common	0.5.14
mithril-signer	0.2.237
mithril-stm	0.3.42

Networks Compatibility ⚠️

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

Distributions Compatibility ⚠️

Compatibility	mithril-signer	mithril-client
2506.0	✔️	✔️
2450.0	✔️	✔️
2445.0	✔️	⛔

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)).

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](https://github.com/input-output-hk/mithril/releases/download...

Mithril v2513.0-pre

Highlights:

• ⚠️ Breaking changes in Mithril nodes:
  • Upgraded the minimum required glibc version from 2.31 to 2.35 for the pre-built Linux binaries
  • Mithril signer with versions <=0.2.200 must be updated following the cleanup of Thales era legacy code
  • Mithril client library with_snapshot_uploader function has been renamed to with_file_uploader.
• Support for Cardano node 10.2.1 in the signer and the aggregator
• End support for macOS x64 pre-built binaries for the client CLI
• Bug fixes and performance improvements.

What's Changed

• refactor(aggregator): simplify dependency builder by @Alenar in #2288
• Reduce e2e flakiness by changing protocol parameters by @sfauvel in #2301
• Fix mithril-aggregator genesis bootstrap flakiness in e2e tests by @Alenar in #2303
• Chore: update SSH keys in infra by @dlachaume in #2305
• fix: stm tests run time regression by @Alenar in #2307
• Docs: rotate documentation for 2506 distribution by @jpraynaud in #2283
• Docs: final CHANGELOG for '2506.0' distribution by @jpraynaud in #2311
• chore(ci): reactivate publish test for mithril-client by @Alenar in #2310
• explorer: use main mithril-client-wasm package by @Alenar in #2309
• Mithril dev blog review by @oduameh in #2302
• Docs: add dev blog post for distribution 2506 by @jpraynaud in #2312
• Docs: add dev blog post for certificate chain security advisory by @jpraynaud in #2313
• Use a unique name for the cloud location of digests artifacts Cardano database by @sfauvel in #2314
• Cleanup unused dependencies and auto CI check by @Alenar in #2315
• Split mithril-common crate by extracting some modules by @sfauvel in #2304
• Replace the TODO by a explanation of the limits by @sfauvel in #2308
• ci: Bump build runner to ubuntu 22.04 by @Alenar in #2317
• chore: upgrade dockerfiles base image version to Debian 12 by @Alenar in #2319
• testing-sanchonet network decommission by @dlachaume in #2300
• End support for MacOS x64 pre-built binaries by @dlachaume in #2277
• feat: client library for incremental Cardano database by @jpraynaud in #2289
• refactor(ci): use cache-version instead of 'v0-' in rust cache key prefix by @Alenar in #2323
• Fix wasm build in rust 1.85 by @Alenar in #2326
• feat: Implement an Unknown variant in the artifact locations by @sfauvel in #2320
• Docs: add new Mithril certification section in website by @jpraynaud in #2324
• Feat: Support Cardano node 10.2.1 pre-release by @jpraynaud in #2336
• feat: incremental cardano database restoration with client CLI by @dlachaume in #2318
• Minor editing/formatting improvements by @olgahryniuk in #2338
• Docs: add page for Cardano node database v2 certification by @jpraynaud in #2339
• Feat: add example crate for incremental Cardano database by @jpraynaud in #2337
• Cleanup legacy code from thales era by @Alenar in #2340
• Enhance artifact structure for incremental cardano db by @sfauvel in #2341
• Feat: improve disk space calculation for Incremental DB Restoration by @dlachaume in #2345
• fix: not blocking when computing size by @sfauvel in #2346
• Test: add integration test for incremental Cardano database in mithril-client by @dlachaume in #2344
• Fix: Hydra CI fails with OpenSSL error (Linux x86_64) by @dlachaume in #2348
• Fix: notify-on-failure job succeeds despite email sending failure by @dlachaume in #2349
• Code ADR for mithril-common by @Alenar in #2343
• Use consistent naming in the client cardano database api by @sfauvel in #2347
• Docs: update clients documentation for incremental Cardano DB by @dlachaume in #2350
• Chore: enhance versions bump script by @dlachaume in #2355
• Feat: implement aggregator slave signer registration mode by @jpraynaud in #2351
• Remove flakiness on should delay between retries tests by @sfauvel in #2352
• Docs: add features documentation for mithril-client library by @dlachaume in #2358
• refactor(mithril-client): Optimize cardano db artifacts download by @Alenar in #2359
• Fix BLST bindings: Error handling for infinite values of sigs and vks by @curiecrypt in #2322
• Compress the digests file uploaded on gcp by @sfauvel in #2367
• Feat: verify minimum node version with squash database migration by @dlachaume in #2368
• Reduce flakiness in the ci by @sfauvel in #2370
• Refactor(aggregator): groundwork for ancillary signature by @Alenar in #2372
• Feat: move database vacuum to aggregator startup to avoid API interruptions during epoch transitions by @dlachaume in #2375
• Organize STM code by @curiecrypt in #2373
• Macro to implement the source trait by @sfauvel in #2377
• Reduce flakiness in tests by @sfauvel in #2379
• Organize STM code - Merkle Tree Module by @curiecrypt in #2374
• Error messages as warning in signer by @sfauvel in #2381
• Feat: Support Cardano node 10.2.1 by @jpraynaud in #2386
• refactor(aggregator): remove deprecated configuration field from DependencyContainer by @Alenar in #2385
• Chore: update dependencies for distribution 2513 by @jpraynaud in #2388
• Docs: update CHANGELOG for 2513.0 distribution release by @jpraynaud in #2389

Full Changelog: 2506.0...2513.0-pre

Crates Versions

Crate	Version
mithril-aggregator	0.7.23
mithril-client	0.11.17
mithril-client-cli	0.11.11
mithril-client-wasm	0.8.6
mithril-common	0.5.14
mithril-signer	0.2.237
mithril-stm	0.3.42

Networks Compatibility ⚠️

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

Distributions Compatibility ⚠️

Compatibility	mithril-signer	mithril-client
2506.0	✔️	✔️
2450.0	✔️	✔️
2445.0	✔️	⛔

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)).

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](https://github.com/input-output-hk/mithril/releases/...

Mithril v2506.0

Highlights:

• ⚠️ Security:
  • This distribution embeds a fix for the Mithril certificate chain could be manipulated by an adversarial signer security advisory GHSA-724h-fpm5-4qvr
  • All users running a client library, client CLI or client WASM are strongly encouraged to update them to the latest version.
• Stable support for Cardano node 10.1.4 in the signer and the aggregator
• Dropped support for Thales era in the signer and the aggregator
• Stable support for traffic compression in signer, aggregator and client
• Bug fixes and performance improvements.

What's Changed

• feat(ci): include explorer in packaged releases by @Alenar in #2167
• Fix: recompute certificate chain hash by @jpraynaud in #2168
• Refactor: rework snapshot_uploaders module to improve genericity by @dlachaume in #2165
• Fix explorer packaging in releases by @Alenar in #2170
• Docs: enhance recompute certificates hash runbook by @jpraynaud in #2171
• Feat: retryable devnet bootstrap errors in e2e tests by @jpraynaud in #2179
• Docs: rotate documentation for 2450 distribution by @jpraynaud in #2162
• Docs: final CHANGELOG for '2450.0' distribution by @jpraynaud in #2182
• Dev blog copy review main branch by @oduameh in #2169
• Docs: add dev blog post for distribution 2450 by @jpraynaud in #2183
• Build and publish an unstable explorer version by @Alenar in #2181
• Feat: implement the Ancillary sub builder for Incremental Cardano DB by @dlachaume in #2180
• Docs: add dev blog post for era switch to Pythagoras by @jpraynaud in #2184
• ci: publish packaged explorer in latest release by @Alenar in #2185
• ci: fix downloading of stable explorer when publishing to pages by @Alenar in #2186
• Experimental: Cache in client certificate verification (lib and wasm) by @Alenar in #2166
• Feat: implement CardanoDatabase artifact routes by @jpraynaud in #2187
• feat: extend Snapshotter to archive only specific files and directories by @dlachaume in #2189
• Fix: CardanoDatabase artifacts verification in e2e test by @jpraynaud in #2194
• Feat: add workflows to Nightly Dispatcher by @jpraynaud in #2188
• Chore: upgrade dependencies by @jpraynaud in #2195
• Fix: CardanoDatabase artifact identifier collisions by @jpraynaud in #2198
• Refactor: enhance inputs for nightly workflows by @jpraynaud in #2200
• Feat: ancillary archive creation by @dlachaume in #2191
• Fix: nightly dispatcher workflow by @jpraynaud in #2201
• Chore: update SSH keys in infra by @jpraynaud in #2203
• Threat model analysis and blog post review PR by @oduameh in #2202
• Feat: immutable file digests route for CardanoDatabase artifacts aggregator by @jpraynaud in #2204
• Fix: execute Wasm tests on node in CI by @dlachaume in #2205
• Chore: clean TODOs in repository by @jpraynaud in #2206
• Feat: Support Cardano node 10.1.4 by @jpraynaud in #2210
• Docs: dev blog post for activation of the Cardano stake distribution certification by @jpraynaud in #2219
• Chore: clean TODOs in repository (second round) by @jpraynaud in #2220
• Align messages golden master tests by @Alenar in #2221
• doc: add windows powershell commands in client cli documentation by @Alenar in #2228
• Fix: missing DEBUG logs release builds by @jpraynaud in #2231
• Feat: Create immutable builder for incremental Cardano DB by @sfauvel in #2223
• Fix: Signer node properly handles /register-signatures responses when the message has expired by @dlachaume in #2232
• Feat: GcpUploader implements synchronization for Cardano database artifacts by @jpraynaud in #2233
• Fix: support trailing whitespace in protocol key files by @jpraynaud in #2236
• Chore: upgrade release-preprod VM by @jpraynaud in #2224
• Feat(tests): integration testing for CardanoDatabase certification by @jpraynaud in #2237
• Incremental Cardano DB artifact production enhancements by @Alenar in #2239
• aggregator: fix flakiness of tests that uses the snapshotter and simplify http server tests by @Alenar in #2243
• Openapi examples check by @sfauvel in #2240
• refactor(aggregator): better url sanitization process by using a value object by @Alenar in #2241
• Feat: compress aggregator HTTP responses by @jpraynaud in #2226
• split snapshotter by @Alenar in #2245
• Feat: implement client for CardanoDatabase in client library (list and get) by @jpraynaud in #2255
• Implement a retry mechanism for the FileUploader by @sfauvel in #2244
• Permanent storage of immutables trio archives by @Alenar in #2256
• Feat: implement CardanoDatabase in mithril-client WASM by @dlachaume in #2258
• Use tls vendored from reqwest by @Alenar in #2260
• Do not delete an already existing archive on error by @sfauvel in #2257
• Refactor: improve variable and function names in fake aggregator by @dlachaume in #2261
• chore(ci): upgrade workflows running on ubuntu 22.04 to 24.04 by @Alenar in #2259
• CI: move notify-on-failure to a dedicated workflow by @dlachaume in #2262
• Fix: add missing workflow_call trigger on Test Notify on Failure workflow by @dlachaume in #2267
• docs: update Pythagoras era switch dev blog post by @jpraynaud in #2268
• Monitoring for incremental cardano db by @sfauvel in #2265
• Feat: Implement cardano-db-v2 command in client CLI (list and show) by @dlachaume in #2266
• explorer: Add cardano db v2 support & rework tabs layout by @Alenar in #2270
• Fix: use unstable Docker image ID in test-client workflow instead… by @dlachaume in #2272
• Chore: add Mithril client CLI version in debug logs by @dlachaume in #2273
• Remove mithril common circular dependencies and random feature by @sfauvel in #2269
• Add warning for linux requirements upgrade by @Alenar in #2275
• Add an era subcommand to create keypair by @sfauvel in #2274
• Feat: certify protocol parameters and epoch in certificate chain by @jpraynaud in #2276
• Restore release option for build in Makefile for aggregator … by @sfauvel in #2278
• Chore: upgrade dependencies by @Alenar in #2279
• Fix: prevent aggregator test conflicts by using unique temporary directories by @dlachaume in #2280
• Docs: bump minor versions of crates for 2506.0 distribution by @jpraynaud in #2285
• Feat: support compression in HTTP clients by @dlachaume in #2282
• docs: update era switch dev blog post by @jpraynaud in #2290
• Fix aggregator stress test by @dl...

Mithril v2506.0-pre

Highlights:

• Stable support for Cardano node 10.1.4 in the signer and the aggregator
• Dropped support for Thales era in the signer and the aggregator
• Stable support for traffic compression in signer, aggregator and client
• Bug fixes and performance improvements.

What's Changed

• feat(ci): include explorer in packaged releases by @Alenar in #2167
• Fix: recompute certificate chain hash by @jpraynaud in #2168
• Refactor: rework snapshot_uploaders module to improve genericity by @dlachaume in #2165
• Fix explorer packaging in releases by @Alenar in #2170
• Docs: enhance recompute certificates hash runbook by @jpraynaud in #2171
• Feat: retryable devnet bootstrap errors in e2e tests by @jpraynaud in #2179
• Docs: rotate documentation for 2450 distribution by @jpraynaud in #2162
• Docs: final CHANGELOG for '2450.0' distribution by @jpraynaud in #2182
• Dev blog copy review main branch by @oduameh in #2169
• Docs: add dev blog post for distribution 2450 by @jpraynaud in #2183
• Build and publish an unstable explorer version by @Alenar in #2181
• Feat: implement the Ancillary sub builder for Incremental Cardano DB by @dlachaume in #2180
• Docs: add dev blog post for era switch to Pythagoras by @jpraynaud in #2184
• ci: publish packaged explorer in latest release by @Alenar in #2185
• ci: fix downloading of stable explorer when publishing to pages by @Alenar in #2186
• Experimental: Cache in client certificate verification (lib and wasm) by @Alenar in #2166
• Feat: implement CardanoDatabase artifact routes by @jpraynaud in #2187
• feat: extend Snapshotter to archive only specific files and directories by @dlachaume in #2189
• Fix: CardanoDatabase artifacts verification in e2e test by @jpraynaud in #2194
• Feat: add workflows to Nightly Dispatcher by @jpraynaud in #2188
• Chore: upgrade dependencies by @jpraynaud in #2195
• Fix: CardanoDatabase artifact identifier collisions by @jpraynaud in #2198
• Refactor: enhance inputs for nightly workflows by @jpraynaud in #2200
• Feat: ancillary archive creation by @dlachaume in #2191
• Fix: nightly dispatcher workflow by @jpraynaud in #2201
• Chore: update SSH keys in infra by @jpraynaud in #2203
• Threat model analysis and blog post review PR by @oduameh in #2202
• Feat: immutable file digests route for CardanoDatabase artifacts aggregator by @jpraynaud in #2204
• Fix: execute Wasm tests on node in CI by @dlachaume in #2205
• Chore: clean TODOs in repository by @jpraynaud in #2206
• Feat: Support Cardano node 10.1.4 by @jpraynaud in #2210
• Docs: dev blog post for activation of the Cardano stake distribution certification by @jpraynaud in #2219
• Chore: clean TODOs in repository (second round) by @jpraynaud in #2220
• Align messages golden master tests by @Alenar in #2221
• doc: add windows powershell commands in client cli documentation by @Alenar in #2228
• Fix: missing DEBUG logs release builds by @jpraynaud in #2231
• Feat: Create immutable builder for incremental Cardano DB by @sfauvel in #2223
• Fix: Signer node properly handles /register-signatures responses when the message has expired by @dlachaume in #2232
• Feat: GcpUploader implements synchronization for Cardano database artifacts by @jpraynaud in #2233
• Fix: support trailing whitespace in protocol key files by @jpraynaud in #2236
• Chore: upgrade release-preprod VM by @jpraynaud in #2224
• Feat(tests): integration testing for CardanoDatabase certification by @jpraynaud in #2237
• Incremental Cardano DB artifact production enhancements by @Alenar in #2239
• aggregator: fix flakiness of tests that uses the snapshotter and simplify http server tests by @Alenar in #2243
• Openapi examples check by @sfauvel in #2240
• refactor(aggregator): better url sanitization process by using a value object by @Alenar in #2241
• Feat: compress aggregator HTTP responses by @jpraynaud in #2226
• split snapshotter by @Alenar in #2245
• Feat: implement client for CardanoDatabase in client library (list and get) by @jpraynaud in #2255
• Implement a retry mechanism for the FileUploader by @sfauvel in #2244
• Permanent storage of immutables trio archives by @Alenar in #2256
• Feat: implement CardanoDatabase in mithril-client WASM by @dlachaume in #2258
• Use tls vendored from reqwest by @Alenar in #2260
• Do not delete an already existing archive on error by @sfauvel in #2257
• Refactor: improve variable and function names in fake aggregator by @dlachaume in #2261
• chore(ci): upgrade workflows running on ubuntu 22.04 to 24.04 by @Alenar in #2259
• CI: move notify-on-failure to a dedicated workflow by @dlachaume in #2262
• Fix: add missing workflow_call trigger on Test Notify on Failure workflow by @dlachaume in #2267
• docs: update Pythagoras era switch dev blog post by @jpraynaud in #2268
• Monitoring for incremental cardano db by @sfauvel in #2265
• Feat: Implement cardano-db-v2 command in client CLI (list and show) by @dlachaume in #2266
• explorer: Add cardano db v2 support & rework tabs layout by @Alenar in #2270
• Fix: use unstable Docker image ID in test-client workflow instead… by @dlachaume in #2272
• Chore: add Mithril client CLI version in debug logs by @dlachaume in #2273
• Remove mithril common circular dependencies and random feature by @sfauvel in #2269
• Add warning for linux requirements upgrade by @Alenar in #2275
• Add an era subcommand to create keypair by @sfauvel in #2274
• Feat: certify protocol parameters and epoch in certificate chain by @jpraynaud in #2276
• Restore release option for build in Makefile for aggregator … by @sfauvel in #2278
• Chore: upgrade dependencies by @Alenar in #2279
• Fix: prevent aggregator test conflicts by using unique temporary directories by @dlachaume in #2280
• Docs: bump minor versions of crates for 2506.0 distribution by @jpraynaud in #2285
• Feat: support compression in HTTP clients by @dlachaume in #2282
• docs: update era switch dev blog post by @jpraynaud in #2290
• Fix aggregator stress test by @dlachaume in #2287
• Docs: update CHANGELOG for 2506.0 distribution release by @jpraynaud in #2284

New Contributors

• @oduameh made their first contribution in #2169

Full Changelog: 2450.0...250...

Mithril v2450.0

Highlights:

• 🔥 BREAKING changes in Mithril client library, CLI, and WASM:
  • Remove deprecated network field from the internal CardanoDbBeacon.
  • The Mithril certificates of type CardanoImmutableFilesFull can't be verified anymore with the previous clients.
  • Clients from distribution 2445 and earlier must be updated.
• Stable support for Cardano node 10.1.3 in the signer and the aggregator.
• Stable support for one line shell installation script of the Mithril nodes pre-built binaries.
• Bug fixes and performance improvements.

What's Changed

• Feat: custom signed entity types in backward compatibility test in CI by @jpraynaud in #2087
• Do not add unfollow files when commit with upgrade_crates_and_openapi_versions.sh by @sfauvel in #2088
• Simplify tests by @Alenar in #2090
• Refactor event message creation by @sfauvel in #2089
• Feat: add Cardano era retrieval in chain observer implementations by @dlachaume in #2094
• Docs: rotate documentation for 2445 distribution by @jpraynaud in #2079
• Docs: final CHANGELOG for '2445.0' distribution by @jpraynaud in #2096
• Docs: dev blog post for aggregator prometheus endpoint by @jpraynaud in #2095
• chore: add build target nodejs by @fabianbormann in #2082
• Prepare network removal from CardanoDbBeacon by @Alenar in #2097
• Feat: enhance certificate chain verification by @jpraynaud in #2098
• Docs: enhance runbook for aggregator metrics and signer registrations by @jpraynaud in #2099
• Feat: record informations in epoch service for status route by @dlachaume in #2100
• Docs: reorganize user manual section in docs website by @jpraynaud in #2102
• Refactor aggregator pruning with upkeep service by @sfauvel in #2103
• Refactor signer pruning with upkeep service by @sfauvel in #2108
• Feat: add genesis generate-keypair command in aggregator by @jpraynaud in #2106
• Feat: implement /status route to expose aggregator information by @dlachaume in #2107
• Remove network from CardanoDbBeacon by @Alenar in #2110
• Fix: adjust era offset in PallasChainObserver for correct display name by @dlachaume in #2112
• Add a database migration to remove network from cardano immutable files full beacons by @Alenar in #2113
• Docs: update Protocol Insights Dashboard links by @jpraynaud in #2119
• Display aggregator status information in explorer by @Alenar in #2128
• Fix for Failing STM Proptests by @curiecrypt in #2125
• fix(aggregator): properly handle 404 errors in http server by @Alenar in #2130
• Docs: dev blog post about new Protocol Insights Dashboard by @jpraynaud in #2127
• Explorer: Easier, more cohesive, aggregator controls by @Alenar in #2132
• CI: add workflow dispatcher for nightly GitHub workflows by @dlachaume in #2131
• Get rid of store adapter in signer by @sfauvel in #2126
• Docs: protocol security page on documentation website by @jpraynaud in #2133
• Feat: one line installation script for Mithril nodes by @jpraynaud in #2136
• Client wasm multiple targets by @Alenar in #2135
• Docs: dev blog post for one line installer by @jpraynaud in #2139
• Also bump versions of js packages in upgrade version script by @Alenar in #2137
• fix(ci): fix generation of swagger-ui page by @Alenar in #2141
• Feat: create new signed entity type for Incremental Cardano DB by @dlachaume in #2142
• Get rid of store adapter in aggregator by @sfauvel in #2143
• Fix Rust 1.83 clippy warnings by @Alenar in #2148
• Cardano network on aggregator status and explorer by @Alenar in #2149
• Chore: update aggregator in examples by @dlachaume in #2150
• Feat: support retries in e2e tests in CI by @jpraynaud in #2145
• Feat: implement signable builder for incremental Cardano DB by @dlachaume in #2146
• Fix: GPG verification command of released artifact by @jpraynaud in #2155
• Chore: upgrade to cardano node 10.1.3 by @jpraynaud in #2158
• Feat: add execute rights on pre-built binaries in CI by @jpraynaud in #2156
• Feat: implement artifact builder for CardanoDatabase by @dlachaume in #2159
• Docs: reorganize About Mithril section in docs website by @jpraynaud in #2160
• Chore: update dependencies for distribution 2450 by @jpraynaud in #2157
• Accelerate signer fixtures creation in tests by @sfauvel in #2161
• Chore: update dependencies for distribution 2450 by @jpraynaud in #2164
• Docs: update CHANGELOG for 2450.0 distribution release by @jpraynaud in #2163

New Contributors

• @fabianbormann made their first contribution in #2082

Full Changelog: 2445.0...2450.0

Crates Versions

Crate	Version
mithril-aggregator	0.6.0
mithril-client	0.10.4
mithril-client-cli	0.10.5
mithril-client-wasm	0.7.2
mithril-common	0.4.96
mithril-signer	0.2.221
mithril-stm	0.3.34

Networks Compatibility ⚠️

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

Distributions Compatibility ⚠️

Compatibility	mithril-signer	mithril-client
2445.0	✔️	⛔
2442.0	✔️	⛔
2437.1	✔️	⛔

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

Warning

mithril-explorer-2450.0.tar.gz checksum isn't included in the provided CHECKSUM.asc, it will be added with the next distribution.

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 ./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:...

Mithril v2450.0-pre

Highlights:

• 🔥 BREAKING changes in Mithril client library, CLI, and WASM:
  • Remove deprecated network field from the internal CardanoDbBeacon.
  • The Mithril certificates of type CardanoImmutableFilesFull can't be verified anymore with the previous clients.
  • Clients from distribution 2445 and earlier must be updated.
• Stable support for Cardano node 10.1.3 in the signer and the aggregator.
• Stable support for one line shell installation script of the Mithril nodes pre-built binaries.
• Bug fixes and performance improvements.

What's Changed

• Feat: custom signed entity types in backward compatibility test in CI by @jpraynaud in #2087
• Do not add unfollow files when commit with upgrade_crates_and_openapi_versions.sh by @sfauvel in #2088
• Simplify tests by @Alenar in #2090
• Refactor event message creation by @sfauvel in #2089
• Feat: add Cardano era retrieval in chain observer implementations by @dlachaume in #2094
• Docs: rotate documentation for 2445 distribution by @jpraynaud in #2079
• Docs: final CHANGELOG for '2445.0' distribution by @jpraynaud in #2096
• Docs: dev blog post for aggregator prometheus endpoint by @jpraynaud in #2095
• chore: add build target nodejs by @fabianbormann in #2082
• Prepare network removal from CardanoDbBeacon by @Alenar in #2097
• Feat: enhance certificate chain verification by @jpraynaud in #2098
• Docs: enhance runbook for aggregator metrics and signer registrations by @jpraynaud in #2099
• Feat: record informations in epoch service for status route by @dlachaume in #2100
• Docs: reorganize user manual section in docs website by @jpraynaud in #2102
• Refactor aggregator pruning with upkeep service by @sfauvel in #2103
• Refactor signer pruning with upkeep service by @sfauvel in #2108
• Feat: add genesis generate-keypair command in aggregator by @jpraynaud in #2106
• Feat: implement /status route to expose aggregator information by @dlachaume in #2107
• Remove network from CardanoDbBeacon by @Alenar in #2110
• Fix: adjust era offset in PallasChainObserver for correct display name by @dlachaume in #2112
• Add a database migration to remove network from cardano immutable files full beacons by @Alenar in #2113
• Docs: update Protocol Insights Dashboard links by @jpraynaud in #2119
• Display aggregator status information in explorer by @Alenar in #2128
• Fix for Failing STM Proptests by @curiecrypt in #2125
• fix(aggregator): properly handle 404 errors in http server by @Alenar in #2130
• Docs: dev blog post about new Protocol Insights Dashboard by @jpraynaud in #2127
• Explorer: Easier, more cohesive, aggregator controls by @Alenar in #2132
• CI: add workflow dispatcher for nightly GitHub workflows by @dlachaume in #2131
• Get rid of store adapter in signer by @sfauvel in #2126
• Docs: protocol security page on documentation website by @jpraynaud in #2133
• Feat: one line installation script for Mithril nodes by @jpraynaud in #2136
• Client wasm multiple targets by @Alenar in #2135
• Docs: dev blog post for one line installer by @jpraynaud in #2139
• Also bump versions of js packages in upgrade version script by @Alenar in #2137
• fix(ci): fix generation of swagger-ui page by @Alenar in #2141
• Feat: create new signed entity type for Incremental Cardano DB by @dlachaume in #2142
• Get rid of store adapter in aggregator by @sfauvel in #2143
• Fix Rust 1.83 clippy warnings by @Alenar in #2148
• Cardano network on aggregator status and explorer by @Alenar in #2149
• Chore: update aggregator in examples by @dlachaume in #2150
• Feat: support retries in e2e tests in CI by @jpraynaud in #2145
• Feat: implement signable builder for incremental Cardano DB by @dlachaume in #2146
• Fix: GPG verification command of released artifact by @jpraynaud in #2155
• Chore: upgrade to cardano node 10.1.3 by @jpraynaud in #2158
• Feat: add execute rights on pre-built binaries in CI by @jpraynaud in #2156
• Feat: implement artifact builder for CardanoDatabase by @dlachaume in #2159
• Docs: reorganize About Mithril section in docs website by @jpraynaud in #2160
• Chore: update dependencies for distribution 2450 by @jpraynaud in #2157
• Accelerate signer fixtures creation in tests by @sfauvel in #2161
• Chore: update dependencies for distribution 2450 by @jpraynaud in #2164
• Docs: update CHANGELOG for 2450.0 distribution release by @jpraynaud in #2163

New Contributors

• @fabianbormann made their first contribution in #2082

Full Changelog: 2445.0...2450.0-pre

Crates Versions

Crate	Version
mithril-aggregator	0.6.0
mithril-client	0.10.4
mithril-client-cli	0.10.5
mithril-client-wasm	0.7.2
mithril-common	0.4.96
mithril-signer	0.2.221
mithril-stm	0.3.34

Networks Compatibility ⚠️

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

Distributions Compatibility ⚠️

Compatibility	mithril-signer	mithril-client
2445.0	✔️	⛔
2442.0	✔️	⛔
2437.1	✔️	⛔

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 ./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...

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...

Mithril v2445.0-pre

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-pre

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 le...

Mithril v2442.0

Highlights

• Stable support for decentralized signature orchestration (the signer node computes autonomously the messages to sign).
• Stable support for Cardano transaction client library, CLI and WASM.
• Stable support for new Pythagoras Mithril era.
• Bug fixes and performance improvements.

What's Changed

• Refactor signer state machine by @dlachaume in #1931
• Aggregator single signatures buffer by @Alenar in #1934
• Retrieve custom signing configuration with epoch settings in Signer by @dlachaume in #1939
• Enhance mithril-common logging by @Alenar in #1940
• Docs: rotate documentation for 2437 distribution by @jpraynaud in #1930
• Docs: final CHANGELOG for '2437.1' distribution by @jpraynaud in #1947
• Feat: create new 'Pythagoras' Mithril era by @jpraynaud in #1948
• Update websites dependencies by @jpraynaud in #1937
• Refactor: standardize epoch settings naming by @dlachaume in #1949
• Feat: sign protocol parameters in Genesis certificate by @jpraynaud in #1950
• Refactor: signable builder services compute full protocol message by @jpraynaud in #1942
• Docs: dev blog posts for 2437 distribution by @jpraynaud in #1953
• Fix: hydra CI error when allow lint attribute specifies a reason by @dlachaume in #1960
• docs: improve clarity in "Verify your signer is registered" section by @dlachaume in #1962
• crane fix by @locallycompact in #1959
• Fix: swagger build step failing in CI by @jpraynaud in #1965
• Feat: sign protocol parameters and epoch in certificate by @jpraynaud in #1954
• Fix: discrepancy protocol parameters by @jpraynaud in #1967
• Make aggregator advertises constant signing configurations for an epoch by @dlachaume in #1964
• Fix: add migration to resolve deserialization issue with cardano_transactions_signing_config by @dlachaume in #1971
• Docs: dev blog post for activation of the Cardano transaction certification by @jpraynaud in #1973
• Signer self compute signed entity by @Alenar in #1970
• Deprecate certificate pending by @Alenar in #1972
• Feat: Support Cardano node 9.2.1 by @jpraynaud in #1969
• Fix signer stuck if signature already aggregated by @Alenar in #1977
• docs: update since signers now compute what to sign independently by @Alenar in #1975
• Chore: decommission testing-mainnet network by @jpraynaud in #1978
• Fix: topology computation of the Cardano nodes of the signers in infra by @jpraynaud in #1985
• Signer certifier service sign & send signatures by @Alenar in #1979
• Make epoch mandatory in RegisterSignerMessage by @Alenar in #1986
• Feat: sign epoch in genesis certificate by @jpraynaud in #1987
• Make Cardano transaction client stable by @dlachaume in #1989
• Optimize /register-signer route by replacing ticker service with epoch service by @dlachaume in #1991
• Feat: use stored signing configuration in aggregator when creating signed entity type by @dlachaume in #1988
• Feat: implement era switch in e2e tests by @jpraynaud in #1974
• Enhance logs in mithril-signer and mithril-persistence by @Alenar in #1992
• Better folder structure for End to End test by @Alenar in #1994
• Docs: add timeout troubleshooting macOS section in E2E README by @dlachaume in #1993
• Fix: aggregator panics in CI by @dlachaume in #1995
• Refactor(aggregator): simplify http server dependencies by @Alenar in #1996
• Use new GitHub action for creating releases by @dlachaume in #2000
• Enhance logs construction and usage in aggregator by @Alenar in #2002
• Chore: update signer preloader refresh interval by @jpraynaud in #2003
• Chore: update dependencies for distribution 2442 by @jpraynaud in #2004
• Docs: update CHANGELOG for 2442.0 distribution release by @jpraynaud in #2006
• setting benchmark path by @Fuma419 in #1951
• Fix: update dependencies runbook and script by @dlachaume in #2008
• Use new GitHub action for creating unstable release by @dlachaume in #2007
• Rework & harmonize aggregator log messages by @Alenar in #2009

New Contributors

• @locallycompact made their first contribution in #1959
• @Fuma419 made their first contribution in #1951

Full Changelog: 2437.1...2442.0

Crates Versions

Crate	Version
mithril-aggregator	0.5.83
mithril-client	0.9.2
mithril-client-cli	0.9.15
mithril-client-wasm	0.5.2
mithril-common	0.4.69
mithril-signer	0.2.200
mithril-stm	0.3.30

Networks Compatibility ⚠️

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

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 ⚠️