Skip to content

Commit 8ddfda3

Browse files
authored
Merge pull request #2697 from input-output-hk/jpraynaud/2625-dev-blog-posts
docs: add dev blog posts for distribution `2537`
2 parents 75ea4c7 + 34eb87b commit 8ddfda3

File tree

5 files changed

+68
-6
lines changed

5 files changed

+68
-6
lines changed

.github/workflows/actions/prepare-distribution/action.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ runs:
123123
| mithril-signer | ✔ | ✔ ⁽\*⁾ | ⛔ | ⛔ |
124124
| mithril-client | ✔ | ✔ ⁽\*⁾ | ✔ | ✔ |
125125
126-
⁽\*⁾⚠️ Linux arm64 builds are not guaranteed, use at your own risk.
126+
⁽\*⁾⚠️ Linux arm64 builds are provided on a best-effort basis and are not officially supported.
127127
128128
### Linux Requirements
129129
The Linux binaries target \`glibc\`: to run them or install the \`.deb\` packages you must have \`glibc\` version \`2.35+\` installed.

docs/website/blog/2025-06-16-client-cli-utxo-snapshot-converter-command.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ authors:
55
tags: [mithril client, cli, command, utxo-hd, conversion]
66
---
77

8+
**Update 2025/09/17**: The command has been promoted to `stable` and is now available without the `--unstable` flag.
9+
810
### Introducing the UTXO-HD ledger state snapshot converter command in the Mithril client CLI
911

1012
With the release of the new [2524](https://github.com/input-output-hk/mithril/releases/tag/2524.0) distribution, the **tools** command has been added to the **Mithril client CLI**.
@@ -22,15 +24,14 @@ It operates using the `snapshot-converter` binary included with the Cardano node
2224
Usage:
2325

2426
```bash
25-
mithril-client --unstable tools utxo-hd snapshot-converter --db-directory $DB_DIRECTORY --cardano-node-version 10.1.4 --utxo-hd-flavor $UTXO_HD_FLAVOR --cardano-network $CARDANO_NETWORK
27+
mithril-client tools utxo-hd snapshot-converter --db-directory $DB_DIRECTORY --cardano-node-version 10.1.4 --utxo-hd-flavor $UTXO_HD_FLAVOR
2628
```
2729

2830
Parameters:
2931

3032
- `--db-directory`: path to the Cardano database directory
3133
- `--cardano-node-version`: version used to download the `snapshot-converter` binary (specific version, eg, `10.1.4`, `latest`, or `prerelease`)
3234
- `--utxo-hd-flavor`: target UTXO-HD flavor (`LMDB` or `Legacy`)
33-
- `--cardano-network`: Cardano network (`preview`, `preprod` or `mainnet`).
3435

3536
The 'Bootstrap a Cardano node' guide now includes a new optional [step](https://mithril.network/doc/manual/getting-started/bootstrap-cardano-node#step-5-optional-convert-the-ledger-state-snapshot-to-another-flavor) that describes how to use the command.
3637

docs/website/blog/2025-06-17-client-cli-cardano-database-backends.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,9 @@ To support this transition, both certification versions will remain available du
4040
- No breaking changes in the client CLI
4141
- The `v2` backend is accessible via the `cardano_database_v2` function in the client library.
4242

43-
- [ ] **Distribution +1**:
44-
- The `v2` backend will be promoted to **stable** status but will remain optional
45-
- The `v1` backend will continue to be the default.
43+
- [x] **Distribution [2537](https://github.com/input-output-hk/mithril/releases/tag/2537.0)**:
44+
- The `v2` backend is promoted to **stable** status but will remain optional
45+
- The `v1` backend is still the default.
4646

4747
- [ ] **Distribution +2**:
4848
- The `v2` backend will become the default
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
title: Distribution `2537` is now available
3+
authors:
4+
- name: Mithril Team
5+
tags: [release, distribution, 2537]
6+
---
7+
8+
### Distribution `2537` is now available
9+
10+
The [`2537.0`](https://github.com/input-output-hk/mithril/releases/tag/2537.0) distribution has been released, introducing the following changes:
11+
12+
- Added support for Cardano node `v.10.5.1` in the signer and aggregator
13+
- Added support for the stable `cardano_database_v2` backend in the `mithril-client` library
14+
- Added support for the stable `v2` backend of the `cardano-db` command, with the decommissioning of the `cardano-db-v2` command in the client CLI
15+
- Added support for the stable `verify` command to validate an existing Cardano database in the client CLI
16+
- Added support for the stable UTXO-HD snapshot converter via the tools `utxo-hd snapshot-converter` command in the client CLI
17+
- Provided pre-built Linux ARM binaries for the signer, client CLI, and aggregator
18+
- Migrated to the Rust `2024` edition (from the `2021` edition)
19+
- General bug fixes and performance improvements.
20+
21+
This new distribution has been deployed to the **Mithril aggregator** on the `release-mainnet` and `release-preprod` networks.
22+
23+
For those running a **Mithril signer**:
24+
25+
- **pre-release-preview** network: no action is required at this time
26+
- **release-preprod** network: upgrade the signer node binary to version `0.2.268` – no configuration changes are required
27+
- **release-mainnet** network: upgrade the signer node binary to version `0.2.268`– no configuration changes are required.
28+
29+
You can update the Mithril signer using the one-line command below. By default, it downloads to the current directory, but you can specify a custom folder with the -p option:
30+
31+
```bash
32+
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 2537.0 -p $(pwd)
33+
```
34+
35+
For any inquiries or assistance, contact the team on the [Discord channel](https://discord.gg/5kaErDKDRq).
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: Pre-built Linux ARM binaries are now available
3+
authors:
4+
- name: Mithril Team
5+
tags: [release, distribution, 2537, arm, linux, pre-built, binaries]
6+
---
7+
8+
### Pre-built Linux ARM binaries are now available
9+
10+
With the release of the [`2537.0`](https://github.com/input-output-hk/mithril/releases/tag/2537.0) distribution, **pre-built Linux ARM binaries** are now available for Mithril nodes:
11+
12+
- Download the binaries directly (files attached to the GitHub release with the suffix `-linux-arm64.tar.gz`)
13+
- Download the Debian package (files attached to the GitHub release with the suffix `-arm64.deb`)
14+
- Use the [one-liner installer](https://mithril.network/doc/dev-blog/2024/11/25/one-line-binaries-installer) to install them.
15+
16+
To provide a clear overview of supported platforms, the team has added a new 'Platform support' section in the release notes, reproduced below for convenience (note that it may change in the future).
17+
18+
| Binary | Linux x64 | Linux arm64 | macOS arm64 | Windows x64 |
19+
| ------------------ | :-------: | :---------: | :---------: | :---------: |
20+
| mithril-aggregator || ✔ ⁽\*|||
21+
| mithril-signer || ✔ ⁽\*|||
22+
| mithril-client || ✔ ⁽\*|||
23+
24+
\*⁾⚠️ Linux arm64 builds are provided on a best-effort basis and are not officially supported.
25+
26+
For any inquiries or assistance, contact the team on the [Discord channel](https://discord.gg/5kaErDKDRq).

0 commit comments

Comments
 (0)