ci(test-client): allow verification of node startup with lmdb ledger

Author: Alenar

.github/workflows/scripts/verify-cardano-db-restoration.sh

@@ -14,8 +14,17 @@ if [[ ! -f "$1" ]]; then
   exit 1
 fi
 
-CLIENT_CMD_OUTPUT=$(cat "$1")
-INCLUDE_ANCILLARY="$2"
+CLIENT_CMD_OUTPUT=$(cat "$1"); shift
+INCLUDE_ANCILLARY="false"
+LEDGER_BACKEND="in-memory"
+
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --include-ancillary) INCLUDE_ANCILLARY="true" ;;
+        --ledger-backend) LEDGER_BACKEND="$2"; shift ;;
+    esac
+    shift
+done
 
 DOCKER_CMD=$(echo "$CLIENT_CMD_OUTPUT" | grep -E '^\s*docker run')
 if [[ -z "$DOCKER_CMD" ]]; then
@@ -26,6 +35,11 @@ fi
 echo "Extracted Docker command:"
 echo "$DOCKER_CMD"
 
+# Note: ledger conversion to lmdb can only be executed if ancillary files are included
+if [[ ${LEDGER_BACKEND,,} == "lmdb" && "$INCLUDE_ANCILLARY" == "true" ]]; then
+  DOCKER_CMD="${DOCKER_CMD/ ghcr/" -e CARDANO_CONFIG_JSON_MERGE='{\"LedgerDB\":{\"Backend\":\"V1LMDB\"}}' ghcr"}"
+fi
+
 DOCKER_CMD_DETACHED="${DOCKER_CMD/docker run/docker run -d}"
 echo "Running Docker command in detached mode:"
 echo "$DOCKER_CMD_DETACHED"
@@ -58,7 +72,7 @@ else
   exit 1
 fi
 
-if [[ "$INCLUDE_ANCILLARY" == "--include-ancillary" ]]; then
+if [[ "$INCLUDE_ANCILLARY" == "true" ]]; then
   echo "Parameter '--include-ancillary' is set."
   if wait_for_log "$CONTAINER_ID" 30 "Chain extended, new tip"; then
     echo "✅ The Cardano node started successfully from the Mithril snapshot with the ancillary files."

.github/workflows/test-client.yml

@@ -88,6 +88,7 @@ jobs:
       cardano_stake_distribution_enabled: ${{ steps.prepare.outputs.cardano_stake_distribution_enabled }}
       cardano_database_v2_enabled: ${{ steps.prepare.outputs.cardano_database_v2_enabled }}
       available_cardano_database_backends: ${{ steps.prepare.outputs.available_cardano_database_backends }}
+      bin-cdb-download-matrix-include: ${{ steps.prepare.outputs.bin-cdb-download-matrix-include }}
     steps:
       - name: Prepare
         id: prepare
@@ -115,8 +116,10 @@ jobs:
 
           if [[ $CARDANO_DATABASE_V2_CAPABILITY == "true" ]]; then
             echo 'available_cardano_database_backends=["v1","v2"]' >> $GITHUB_OUTPUT
+            echo 'bin-cdb-download-matrix-include=[{"backend":"v2","os":"ubuntu-24.04","ledger_backend":"lmdb","extra_args":"--include-ancillary"}]' >> $GITHUB_OUTPUT
           else
             echo 'available_cardano_database_backends=["v1"]' >> $GITHUB_OUTPUT
+            echo 'bin-cdb-download-matrix-include=[]' >> $GITHUB_OUTPUT
           fi
 
   bin:
@@ -247,8 +250,11 @@ jobs:
       matrix:
         backend: ${{ fromJson(needs.prepare.outputs.available_cardano_database_backends) }}
         os: [ubuntu-24.04, ubuntu-24.04-arm, macos-14, windows-latest]
+        ledger_backend: ["in-memory"]
         extra_args: ["", "--include-ancillary"]
 
+        include: ${{ fromJson(needs.prepare.outputs.bin-cdb-download-matrix-include) }}
+
     runs-on: ${{ matrix.os }}
     env:
       GENESIS_VERIFICATION_KEY: ${{ needs.prepare.outputs.genesis_verification_key }}
@@ -291,12 +297,12 @@ jobs:
 
       - name: Ledger state snapshot conversion from InMemory to LMDB
         # The 'snapshot-converter' binary is not currently supported on Linux ARM64 platforms.
-        if: matrix.os != 'ubuntu-24.04-arm' && matrix.extra_args == '--include-ancillary' && matrix.backend == 'v2'
+        if: matrix.os != 'ubuntu-24.04-arm' && matrix.extra_args == '--include-ancillary' && matrix.ledger_backend == 'lmdb'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         working-directory: ./bin
-        run: ./mithril-client ${{ needs.prepare.outputs.debug_level }} tools utxo-hd snapshot-converter --db-directory v2/db --cardano-node-version latest --utxo-hd-flavor LMDB --commit
+        run: ./mithril-client ${{ needs.prepare.outputs.debug_level }} tools utxo-hd snapshot-converter --db-directory ${{ matrix.backend }}/db --cardano-node-version latest --utxo-hd-flavor LMDB --commit
 
       - name: Cardano Database V2 Snapshot / verify immutables
         if: matrix.backend == 'v2'
@@ -307,7 +313,7 @@ jobs:
       - name: Cardano Database Snapshot / verify Cardano node starts successfully
         if: matrix.os == 'ubuntu-24.04'
         shell: bash
-        run: .github/workflows/scripts/verify-cardano-db-restoration.sh ./bin/cdb-${{ matrix.backend }}-download-output.txt "${{ matrix.extra_args }}"
+        run: .github/workflows/scripts/verify-cardano-db-restoration.sh ./bin/cdb-${{ matrix.backend }}-download-output.txt --ledger-backend ${{ matrix.ledger_backend }} ${{ matrix.extra_args }}
 
       - name: Cardano Database V2 Snapshot / verify tampered and missing immutables from a specific range
         if: matrix.backend == 'v2'