Feat: add mithril-client CLI command for UTxO-HD ledger state snapshot conversion

[dlachaume]

Content

This PR includes a new mithril-client CLI command to convert a restored InMemory ledger state snapshot using the snapshot-converter tool from the Cardano node distribution.

The command mithril-client tools utxo-hd snapshot-converter is marked as unstable and must be used with the --unstable flag.

It supports selecting a target UTxO-HD flavor (LMDB or Legacy) and optionally replacing the current ledger state with the converted snapshot using the --commit flag.

Example:

mithril-client --unstable tools utxo-hd snapshot-converter --db-directory ./db --cardano-node-version 10.4.1 --utxo-hd-flavor LMDB --cardano-network preview --commit

Downloading Cardano node distribution for tag: '10.4.1'...
Distribution downloaded successfully. Archive location: ./db/tmp/cardano-node-distribution/cardano-node-10.4.1-macos.tar.gz
Unpacking distribution from archive: ./db/tmp/cardano-node-distribution/cardano-node-10.4.1-macos.tar.gz
Distribution unpacked successfully to: ./db/tmp/cardano-node-distribution
Converting ledger state snapshot to 'LMDB' flavor
Loading snapshot...
Loaded snapshot
Writing snapshot...
Written snapshot
Upgrading and replacing ledger state in ./db/ledger with converted snapshot: ./db/tmp/snapshots/82383798_lmdb

Pre-submit checklist

• Branch
  • Tests are provided (if possible)
  • Crates versions are updated (if relevant)
  • CHANGELOG file is updated (if relevant)
  • Commit sequence broadly makes sense
  • Key commits have useful messages
• PR
  • All check jobs of the CI have succeeded
  • Self-reviewed the diff
  • Useful pull request description
  • Reviewer requested
• Documentation
  • Update README file (if relevant)
  • Update documentation website (if relevant)
  • Add dev blog post (if relevant)
  • Add ADR blog post or Dev ADR entry (if relevant)
  • No new TODOs introduced

Issue(s)

Closes #2492

[github-actions]

Test Results

    3 files  ±  0     77 suites  ±0   13m 50s ⏱️ - 2m 27s
1 985 tests + 45  1 985 ✅ + 45  0 💤 ±0  0 ❌ ±0 
3 427 runs  +135  3 427 ✅ +135  0 💤 ±0  0 ❌ ±0 

Results for commit 5b39c59. ± Comparison against base commit 29be6f6.

♻️ This comment has been updated with latest results.