feat(client-cli): scaffold new command to convert ledger state snapshots

Author: dlachaume

mithril-client-cli/src/commands/mod.rs

@@ -9,6 +9,7 @@ pub mod cardano_stake_distribution;
 pub mod cardano_transaction;
 mod deprecation;
 pub mod mithril_stake_distribution;
+pub mod tools;
 
 pub use deprecation::{DeprecatedCommand, Deprecation};
 

mithril-client-cli/src/commands/tools/mod.rs

@@ -0,0 +1,45 @@
+//! Tools commands
+//!
+//! Provides utility subcommands such as converting restored InMemory UTxO-HD ledger snapshot
+//! to different flavors (Legacy, LMDB).
+
+mod snapshot_converter;
+
+use mithril_client::MithrilResult;
+pub use snapshot_converter::*;
+
+use clap::Subcommand;
+
+/// Tools commands
+#[derive(Subcommand, Debug, Clone)]
+pub enum ToolsCommands {
+    /// UTxO-HD related commands
+    #[clap(subcommand, name = "utxo-hd")]
+    UTxOHD(UTxOHDCommands),
+}
+
+impl ToolsCommands {
+    /// Execute Tools command
+    pub async fn execute(&self) -> MithrilResult<()> {
+        match self {
+            Self::UTxOHD(cmd) => cmd.execute().await,
+        }
+    }
+}
+
+/// UTxO-HD related commands
+#[derive(Subcommand, Debug, Clone)]
+pub enum UTxOHDCommands {
+    /// Convert a restored `InMemory` ledger snapshot to another flavor.
+    #[clap(arg_required_else_help = false)]
+    SnapshotConverter(SnapshotConverterCommand),
+}
+
+impl UTxOHDCommands {
+    /// Execute UTxO-HD command
+    pub async fn execute(&self) -> MithrilResult<()> {
+        match self {
+            Self::SnapshotConverter(cmd) => cmd.execute().await,
+        }
+    }
+}

mithril-client-cli/src/commands/tools/snapshot_converter.rs

@@ -0,0 +1,13 @@
+use clap::Parser;
+
+use mithril_client::MithrilResult;
+
+#[derive(Parser, Debug, Clone)]
+pub struct SnapshotConverterCommand {}
+
+impl SnapshotConverterCommand {
+    /// Main command execution
+    pub async fn execute(&self) -> MithrilResult<()> {
+        todo!()
+    }
+}

mithril-client-cli/src/main.rs

@@ -17,7 +17,8 @@ use mithril_client_cli::commands::{
     cardano_db::CardanoDbCommands, cardano_db_v2::CardanoDbV2Commands,
     cardano_stake_distribution::CardanoStakeDistributionCommands,
     cardano_transaction::CardanoTransactionCommands,
-    mithril_stake_distribution::MithrilStakeDistributionCommands, DeprecatedCommand, Deprecation,
+    mithril_stake_distribution::MithrilStakeDistributionCommands, tools::ToolsCommands,
+    DeprecatedCommand, Deprecation,
 };
 use mithril_client_cli::{ClapError, CommandContext};
 
@@ -209,6 +210,9 @@ enum ArtifactCommands {
 
     #[clap(alias("doc"), hide(true))]
     GenerateDoc(GenerateDocCommands),
+
+    #[clap(subcommand)]
+    Tools(ToolsCommands),
 }
 
 impl ArtifactCommands {
@@ -231,6 +235,7 @@ impl ArtifactCommands {
             Self::GenerateDoc(cmd) => cmd
                 .execute(&mut Args::command())
                 .map_err(|message| anyhow!(message)),
+            Self::Tools(cmd) => cmd.execute().await,
         }
     }