feat: incremental cardano database restoration with client CLI

.github/workflows/test-client.yml

@@ -218,6 +218,12 @@ jobs:
         working-directory: ./bin
         run: ./mithril-client --unstable cardano-db-v2 snapshot show $CARDANO_DATABASE_V2_SNAPSHOT_HASH
 
+      - name: Cardano Database V2 Snapshot / download & restore latest (Full restoration)
+        if: steps.aggregator_capability_unix.outputs.cardano_database_v2_enabled == 'true' || steps.aggregator_capability_windows.outputs.cardano_database_v2_enabled == 'true'
+        shell: bash
+        working-directory: ./bin
+        run: ./mithril-client ${{ steps.prepare.outputs.debug_level }} --unstable cardano-db-v2 download $CARDANO_DATABASE_V2_SNAPSHOT_HASH
+
   test-docker:
     strategy:
       fail-fast: false
@@ -328,6 +334,11 @@ jobs:
         shell: bash
         run: ${{ steps.command.outputs.mithril_client }} --unstable cardano-db-v2 snapshot show $CARDANO_DATABASE_V2_SNAPSHOT_HASH
 
+      - name: Cardano Database V2 Snapshot / download & restore latest (Full restoration)
+        if: steps.aggregator_capability.outputs.cardano_database_v2_enabled == 'true'
+        shell: bash
+        run: ${{ steps.command.outputs.mithril_client }} ${{ steps.prepare.outputs.debug_level }} --unstable cardano-db-v2 download $CARDANO_DATABASE_V2_SNAPSHOT_HASH --download-dir /app
+
   test-mithril-client-wasm:
     strategy:
       fail-fast: false

CHANGELOG.md

@@ -18,6 +18,7 @@ As a minor extension, we have adopted a slightly different versioning convention
 - **UNSTABLE** Cardano database incremental certification:
 
   - Implement the client library for the the signed entity type `CardanoDatabase` (download and prove snapshot).
+  - Implement the client CLI commands for the signed entity type `CardanoDatabase` (snapshot list, snapshot show and download commands).
 
 - Crates versions:
 

mithril-client-cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "mithril-client-cli"
-version = "0.11.2"
+version = "0.11.3"
 description = "A Mithril Client"
 authors = { workspace = true }
 edition = { workspace = true }

mithril-client-cli/src/commands/cardano_db/download.rs

@@ -13,7 +13,7 @@ use crate::{
     commands::{client_builder, SharedArgs},
     configuration::{ConfigError, ConfigSource},
     utils::{
-        CardanoDbDownloadChecker, CardanoDbUtils, ExpanderUtils, IndicatifFeedbackReceiver,
+        self, CardanoDbDownloadChecker, CardanoDbUtils, ExpanderUtils, IndicatifFeedbackReceiver,
         ProgressOutputType, ProgressPrinter,
     },
     CommandContext,
@@ -149,7 +149,7 @@ impl CardanoDbDownloadCommand {
         progress_printer.report_step(step_number, "Checking local disk info…")?;
 
         CardanoDbDownloadChecker::ensure_dir_exist(db_dir)?;
-        if let Err(e) = CardanoDbDownloadChecker::check_prerequisites(
+        if let Err(e) = CardanoDbDownloadChecker::check_prerequisites_for_archive(
             db_dir,
             cardano_db.size,
             cardano_db.compression_algorithm,
@@ -319,17 +319,11 @@ impl ConfigSource for CardanoDbDownloadCommand {
         let mut map = HashMap::new();
 
         if let Some(download_dir) = self.download_dir.clone() {
+            let param = "download_dir".to_string();
             map.insert(
-                "download_dir".to_string(),
-                download_dir
-                    .to_str()
-                    .ok_or_else(|| {
-                        ConfigError::Conversion(format!(
-                            "Could not read download directory: '{}'.",
-                            download_dir.display()
-                        ))
-                    })?
-                    .to_string(),
+                param.clone(),
+                utils::path_to_string(&download_dir)
+                    .map_err(|e| ConfigError::Conversion(param, e))?,
             );
         }