-
Notifications
You must be signed in to change notification settings - Fork 52
Labels
feature 🚀New implemented featureNew implemented feature
Description
Why
We need to provide a convenient way for Mithril client CLI users to convert a restored InMemory UTxO-HD snapshot (with Cardano DB v1 or Cardano DB v2) to another flavor (e.g. Legacy, LMDB). This conversion must be available for Linux, MacOS and Windows. It will leverage the new snapshot-converter CLI tool distributed with the Cardano Node in the GitHub release. Migration guide is available here.
What
Add a conversion command to the client CLI that will do the conversion of the UTxO-HD InMemory snapshot to another flavor.
How
- Display a guidance message (with the Mithril client CLI command) when restoring a Cardano database snapshot with
--include-ancillaryoption (iif Cardano node version used for snapshotting is):10.4+- Cardano DB v1
- Cardano DB v2
- Add a new tooling command that does the conversion
tools utxo-hd snapshot-converter:- Make the command unstable
- Parameters:
--cardano-node-version,--cardano-network,--utxo-hd-flavor,--db-directoryand--commit - Download files from the associated Cardano node distribution on GitHub (select the asset for the target platform, download and unpack the converter CLI):
-
snapshot-converterCLI - Cardano config file
-
- Support
latest(andpre-release) distribution of the Cardano node - Execute converter command:
- Convert from
InMemoryflavor - On the less recent ledger state snapshot
- Replace the ledger state when the
--commitoption is set - Otherwise display a message with its location
- Convert from
- Cleanup converter (and all downloaded files) after command execution
- Update documentation:
- Mithril client node
- Bootstrap Cardano node tutorial
- Add tests in the
Mithril Client multi-platform testworkflow in the CI- Binaries
- Docker
- Add dev blog post
Metadata
Metadata
Assignees
Labels
feature 🚀New implemented featureNew implemented feature