Distribution 2450 is now available​

We have released the 2450.0 distribution, which includes the following:

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

This new distribution has been deployed to the Mithril aggregator of the release-mainnet and release-preprod networks.

If you are running a Mithril signer on:

• the pre-release-preview network: there is nothing to do at the moment.
• the release-preprod network: you can upgrade the binary of your signer node to the version 0.2.221, no configuration update is needed.
• the release-mainnet network: you can upgrade the binary of your signer node to the version 0.2.221, no configuration update is needed.

You can easily update your Mithril signer with this one line command (it will be downloaded in the current directory, a custom folder can be specified with -p option):

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 2450.0 -p $(pwd)

For any inquiries or assistance, feel free to contact the team on the Discord channel.

Era switch to Pythagoras​

We have introduced the Pythagoras era in the Mithril networks. The era switch to Pythagoras is a significant milestone that brings new features and improvements to the Mithril protocol.

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 latest -p $(pwd)

The era switch to Pythagoras plan is the following:

• Era switch on pre-release-preview:
  • Create the era switch transaction (done at epoch 757).
  • Era switch to Pythagoras took place at the transition to epoch 759.
• Era switch on release-preprod:
  • Create the era switch transaction (done at epoch 184).
  • Era switch to Pythagoras took place at the transition to epoch 186.
• Era switch on release-mainnet:
  • Create the era switch transaction (to be done, expected early January 2025).
  • Era switch to Pythagoras.

For any inquiries or assistance, don't hesitate to contact the team on the Discord channel.

One line installer for Mithril binaries​

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.

The one line command is also displayed in the various Download the pre-built binary sections across the documentation.

Examples of the one line installer​

• Download the latest 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 latest -p $(pwd)

• Download the latest 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 latest -p $(pwd)

• Download the unstable 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)

• Download the Mithril client of distribution 2445.0 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 2445.0 -p $(pwd)

Installer usage​

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/input-output-hk/mithril/refs/heads/main/mithril-install.sh | sh -s -- -h

Install or upgrade a Mithril node
Usage: sh [-n node] [-v version] [-d distribution] [-p path]
  -c node          : Mithril node to install or upgrade (mithril-signer, mithril-aggregator, mithril-client)
  -d distribution  : Distribution to upgrade to (latest, unstable or distribution version e.g '2445.0')
  -p path          : Path to install the component

For any inquiries or assistance, feel free to contact the team on the Discord channel.

A new Protocol Insights Dashboard has been released​

We have released a new version of the Protocol Insights Dashboard, which provides a comprehensive view of the Mithril network and its performance metrics.

The Protocol Insights Dashboard is a valuable tool for monitoring the network and understanding its behavior:

• Participation metrics
• Usage metrics
• Health metrics
• Artifacts metrics
• Software metrics.

For any inquiries or assistance, don't hesitate to contact the team on the Discord channel.

Mithril aggregator Prometheus endpoint is available​

With the release of distribution 2445, the Mithril aggregator now includes an optional Prometheus endpoint for monitoring basic metrics.

After configuring the Prometheus endpoint, remember to restart the Mithril aggregator for the changes to take effect.

To make setup easier, a Grafana template is available for creating a dashboard to visualize metrics from the Prometheus endpoint (ID 22165): Grafana dashboard.

For questions or support, feel free to contact the team on the Discord channel.

Certification of Cardano stake distribution​

With the release of the new distribution 2437, we have started to roll out the certification of the Cardano stake distribution in the Mithril networks.

The Mithril network now provides certified Cardano stake distribution data without requiring a full Cardano node, a useful feature for applications such as bridges and layer 2 solutions. The key features include:

• Certification of the Cardano stake distribution of the ending epoch at each epoch transition
• New HTTP routes in the aggregator REST API to access this certified data
• Updates to the Mithril client library and CLI for retrieving and verifying Cardano stake distribution
• WASM client support for these functionalities
• Mithril Explorer now displays certified Cardano stake distribution.

The roll-out plan of the feature is the following:

• Distribution 2437:
  • Activation of the certification of Cardano stake distribution in the pre-release-preview network
  • Activation of the certification of Cardano stake distribution in the release-preprod network
• Distribution 2442:
  • Activation of the certification of Cardano stake distribution in the release-mainnet network.

For any inquiries or assistance, don't hesitate to contact the team on the Discord channel.

Breaking change introduced in the unstable features of the Mithril client WASM​

With the release of distribution 2437, we introduced a breaking change to the Mithril client WASM version 0.4.1. Unstable features are now activated using a configuration option instead of the .unstable property.

This change ensures a seamless transition when new unstable features become stable, eliminating breaking changes in developer code and enhancing the developer experience.

To activate unstable features, use the following code:

let client = new MithrilClient(aggregator_endpoint, genesis_verification_key, {
  // The following option activates the unstable features of the client.
  // Unstable features will trigger an error if this option is not set.
  unstable: true,
});

The previous client.unstable implementation is not supported anymore and must be replaced with client:

// Before
let mithril_stake_distributions_message =
  await client.unstable.compute_mithril_stake_distribution_message(
    last_stake_distribution,
  );

// After
let mithril_stake_distributions_message =
  await client.compute_mithril_stake_distribution_message(
    last_stake_distribution,
  );

The Mithril client WASM documentation is available here.

For questions or assistance, contact the team on the Discord channel.

Certification of Cardano transactions​

With the release of the new distribution 2430, we have started to roll-out the certification of the Cardano transactions in the Mithril networks.

The roll-out plan of the feature is the following:

• Distribution 2430 (before the Chang hardfork):
  • Activation of the certification of Cardano transactions in the pre-release-preview network.
  • Activation of the certification of Cardano transactions in the release-preprod network.
• Distribution 2437 (after the Chang hardfork):
  • Activation of the certification of Cardano transactions in the release-mainnet network.

For any inquiries or assistance, don't hesitate to reach out to the team on the Discord channel.

The 'snapshot' command of the client CLI is removed​

With the release of the new distribution 2423, we have removed the snapshot command of the client CLI.

The snapshot command has been superseded by the cardano-db snapshot command.

The snapshot command has been deprecated with the release 2412, and this has been announced in this post.

In order to proceed to the upgrade, install the latest stable client CLI, and replace the removed command with the new command, e.g.:

mithril-client -vvv snapshot download latest --json

Should be replaced with

mithril-client -vvv cardano-db snapshot download latest --json

The documentation of the client CLI has been updated accordingly and can be found here.

For any inquiries or assistance, don't hesitate to reach out to the team on the Discord channel.

The 'snapshot' command of the client CLI is deprecated​

With the release of the new distribution 2412, we have deprecated the snapshot command of the client CLI.

The snapshot command has been superseded by the cardano-db snapshot command. In order to give time to our users to use the new command, the now legacy snapshot command is still available, but it will be removed in a near future.

In order to proceed to the upgrade, install the latest stable client CLI, and replace the legacy command with the new command, e.g.:

mithril-client -vvv snapshot download latest --json

Should be replaced with

mithril-client -vvv cardano-db snapshot download latest --json

For any inquiries or assistance, don't hesitate to reach out to the team on the Discord channel.