Update 2025-12 - ImportHelper Script for ConwayEra

The 0x_importHelper.sh script was updated to be compatible with latest cardano-cli release 10.12.0.0. The script was also lacking the requirement to set the correct stakeaddress-deposit-fee value while generating the xxx.deleg.cert file during the import process. Also some minor changes in the calling commands for cardano-cli.

Other changes:
- Minimum cardano-hw-cli version is not set to 1.19.0 to be in line with the new trezor message signing functions.

Author: gitmachtl

cardano/mainnet/00_common.sh

@@ -334,7 +334,7 @@ maxNodeVersion="99.99.9"  		#maximum allowed node version, 99.99.9 = no limit so
 minLedgerCardanoAppVersion=${ENV_MINLEDGERCARDANOAPPVERSION:-"7.1.4"}  	#minimum version for the cardano-app on the Ledger HW-Wallet
 minTrezorCardanoAppVersion="2.7.2"  	#minimum version for the firmware on the Trezor HW-Wallet
 minKeystoneCardanoAppVersion="1.7.7"  	#minimum version for the firmware on the Keystone HW-Wallet
-minHardwareCliVersion="1.18.2" 		#minimum version for the cardano-hw-cli
+minHardwareCliVersion="1.19.0" 		#minimum version for the cardano-hw-cli
 minCardanoSignerVersion="1.27.0"	#minimum version for the cardano-signer binary
 minCatalystToolboxVersion="0.5.0"	#minimum version for the catalyst-toolbox binary
 

cardano/mainnet/0x_importHelper.sh

@@ -288,7 +288,7 @@ importNodeSkey() {
 
         #Generate the pairing Vkey file from the Skey file
         echo -ne "\e[0mGenerating file '\e[32m${poolName}/${poolName}.node.vkey\e[0m' ... " >&2;
-        ${cardanocli} key verification-key --signing-key-file "${poolName}/${poolName}.node.skey" --verification-key-file "${poolName}/${poolName}.node.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
+        ${cardanocli} ${cliEra} key verification-key --signing-key-file "${poolName}/${poolName}.node.skey" --verification-key-file "${poolName}/${poolName}.node.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
         file_lock "${poolName}/${poolName}.node.vkey"
         echo -e "\e[32mOK\e[0m" >&2;
 
@@ -298,7 +298,7 @@ importNodeSkey() {
 	poolNodeCounter=$((${poolNodeCounter}+1))
 	echo -e "\e[0mNew OpCertCounter for this import: \e[32m${poolNodeCounter}\e[0m" >&2;
         echo -ne "\e[0mGenerating file '\e[32m${poolName}/${poolName}.node.counter\e[0m' ... " >&2;
-	${cardanocli} node new-counter --cold-verification-key-file "${poolName}/${poolName}.node.vkey" --counter-value ${poolNodeCounter} --operational-certificate-issue-counter-file "${poolName}/${poolName}.node.counter"
+	${cardanocli} ${cliEra} node new-counter --cold-verification-key-file "${poolName}/${poolName}.node.vkey" --counter-value ${poolNodeCounter} --operational-certificate-issue-counter-file "${poolName}/${poolName}.node.counter"
         checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
         #NodeCounter file was written, now add the description in the file to reflect the next node counter number
         newCounterJSON=$(jq ".description = \"Next certificate issue number: ${poolNodeCounter}\"" < "${poolName}/${poolName}.node.counter")
@@ -339,8 +339,8 @@ importVrfSkey() {
         if [[ ! "$(jq -r .type $1)" == *"SigningKey"* ]]; then echo -e "\n\e[35mERROR - \"$1\" is not a valid vrf.skey file.\e[0m\n" >&2; exit 1; fi;
 
 	#Probe the given VRF key hash with the one that is online
-	newVRFstring=$(${cardanocli} key verification-key --signing-key-file "${1}" --verification-key-file /dev/stdout | jq -r .cborHex) #the maybe new vrf string
-	newVRFhash=$(${cardanocli} node key-hash-VRF --verification-key "${newVRFstring:4}") #crop the first 4 chars before handing over the string
+	newVRFstring=$(${cardanocli} ${cliEra} key verification-key --signing-key-file "${1}" --verification-key-file /dev/stdout | jq -r .cborHex) #the maybe new vrf string
+	newVRFhash=$(${cardanocli} ${cliEra} node key-hash-VRF --verification-key "${newVRFstring:4}") #crop the first 4 chars before handing over the string
 	oldVRFhash=$(jq -r ".vrf_key_hash" 2> /dev/null <<< ${importJSON} )
 	if [[ ! "${newVRFhash}" == "${oldVRFhash}" ]]; then echo -e "\n\e[35mWARNING - VRF KeyHash does not match up with the one that is online right now!\e[0m\n" >&2; exit 1; fi;
 
@@ -353,7 +353,7 @@ importVrfSkey() {
 
         #Generate the pairing Vkey file from the Skey file
         echo -ne "\e[0mGenerating file '\e[32m${poolName}/${poolName}.vrf.vkey\e[0m' ... " >&2;
-        ${cardanocli} key verification-key --signing-key-file "${poolName}/${poolName}.vrf.skey" --verification-key-file "${poolName}/${poolName}.vrf.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
+        ${cardanocli} ${cliEra} key verification-key --signing-key-file "${poolName}/${poolName}.vrf.skey" --verification-key-file "${poolName}/${poolName}.vrf.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
         file_lock ${poolName}/${poolName}.vrf.vkey
         echo -e "\e[32mOK\e[0m\n" >&2;
 
@@ -394,12 +394,12 @@ importPaymentSkey() {
 
         #Generate the pairing Vkey file from the Skey file
         echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.payment.vkey\e[0m' ... " >&2;
-        ${cardanocli} key verification-key --signing-key-file "${poolName}/${ownerName}.payment.skey" --verification-key-file "${poolName}/${ownerName}.payment.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
+        ${cardanocli} ${cliEra} key verification-key --signing-key-file "${poolName}/${ownerName}.payment.skey" --verification-key-file "${poolName}/${ownerName}.payment.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
 
 	#If the verification key is an extended one, convert it into a non-extended one
 	tmp=$(jq -r .type "${poolName}/${ownerName}.payment.vkey" 2> /dev/null)
         if [[ "${tmp^^}" == *"EXTENDED"* ]]; then
-		${cardanocli} key non-extended-key --extended-verification-key-file "${poolName}/${ownerName}.payment.vkey" --verification-key-file "${poolName}/${ownerName}.payment.vkey";
+		${cardanocli} ${cliEra} key non-extended-key --extended-verification-key-file "${poolName}/${ownerName}.payment.vkey" --verification-key-file "${poolName}/${ownerName}.payment.vkey";
   		checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi;
 	fi
 
@@ -430,12 +430,12 @@ importStakingSkey() {
 
         #Generate the pairing Vkey file from the Skey file
         echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.staking.vkey\e[0m' ... " >&2;
-        ${cardanocli} key verification-key --signing-key-file "${poolName}/${ownerName}.staking.skey" --verification-key-file "${poolName}/${ownerName}.staking.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
+        ${cardanocli} ${cliEra} key verification-key --signing-key-file "${poolName}/${ownerName}.staking.skey" --verification-key-file "${poolName}/${ownerName}.staking.vkey"; checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
 
         #If the verification key is an extended one, convert it into a non-extended one
         tmp=$(jq -r .type "${poolName}/${ownerName}.staking.vkey" 2> /dev/null)
         if [[ "${tmp^^}" == *"EXTENDED"* ]]; then
-                ${cardanocli} key non-extended-key --extended-verification-key-file "${poolName}/${ownerName}.staking.vkey" --verification-key-file "${poolName}/${ownerName}.staking.vkey";
+                ${cardanocli} ${cliEra} key non-extended-key --extended-verification-key-file "${poolName}/${ownerName}.staking.vkey" --verification-key-file "${poolName}/${ownerName}.staking.vkey";
                 checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi;
         fi
 
@@ -491,29 +491,39 @@ while [[ ! "${ownerName}" == "" ]]; do
 
 			#Building a Payment Address
 		        echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.payment.addr\e[0m' ... ";
-			${cardanocli} address build --payment-verification-key-file "${poolName}/${ownerName}.payment.vkey" --staking-verification-key-file "${poolName}/${ownerName}.staking.vkey" ${addrformat} > "${poolName}/${ownerName}.payment.addr"
+			${cardanocli} ${cliEra} address build --payment-verification-key-file "${poolName}/${ownerName}.payment.vkey" --staking-verification-key-file "${poolName}/${ownerName}.staking.vkey" ${addrformat} > "${poolName}/${ownerName}.payment.addr"
 			checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
 			file_lock "${poolName}/${ownerName}.payment.addr"
 		        echo -e "\e[32mOK\e[0m";
 
 			#Building a Staking Address
 		        echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.staking.addr\e[0m' ... ";
-			${cardanocli} stake-address build --staking-verification-key-file "${poolName}/${ownerName}.staking.vkey" ${addrformat} > "${poolName}/${ownerName}.staking.addr"
+			${cardanocli} ${cliEra} stake-address build --staking-verification-key-file "${poolName}/${ownerName}.staking.vkey" ${addrformat} > "${poolName}/${ownerName}.staking.addr"
 			checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
 			file_lock "${poolName}/${ownerName}.staking.addr"
 		        echo -e "\e[32mOK\e[0m";
 
 			#Create an address registration certificate
-		        echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.staking.cert\e[0m' ... ";
-			${cardanocli} stake-address registration-certificate --staking-verification-key-file "${poolName}/${ownerName}.staking.vkey" --out-file "${poolName}/${ownerName}.staking.cert"
+			#Read ProtocolParameters
+			case ${workMode} in
+			        "online")       protocolParametersJSON=$(${cardanocli} ${cliEra} query protocol-parameters);; #onlinemode
+			        "light")        protocolParametersJSON=${lightModeParametersJSON};; #lightmode
+			        "offline")      readOfflineFile;        #Reads the offlinefile into the offlineJSON variable
+			                        protocolParametersJSON=$(jq ".protocol.parameters" <<< ${offlineJSON});; #offlinemode
+			esac
+			checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
+			#Lets use the currently set keyDeposit amount
+			stakeAddressDepositFee=$(jq -r .stakeAddressDeposit <<< ${protocolParametersJSON})
+		        echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.staking.cert\e[0m' with ${stakeAddressDepositFee} lovelace deposit fee ... ";
+			${cardanocli} ${cliEra} stake-address registration-certificate --staking-verification-key-file "${poolName}/${ownerName}.staking.vkey" --key-reg-deposit-amt "${stakeAddressDepositFee}" --out-file "${poolName}/${ownerName}.staking.cert"
 			checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
 			file_lock "${poolName}/${ownerName}.staking.cert"
 		        echo -e "\e[32mOK\e[0m";
 
                         #Create the delegation certificate to this pool
 			if [ -f "${poolName}/${poolName}.node.vkey" ] && [ -f "${poolName}/${ownerName}.staking.vkey" ]; then
 	                        echo -ne "\t\e[0mGenerating file '\e[32m${poolName}/${ownerName}.deleg.cert\e[0m' ... ";
-	 			${cardanocli} stake-address delegation-certificate --stake-verification-key-file "${poolName}/${ownerName}.staking.vkey" --cold-verification-key-file "${poolName}/${poolName}.node.vkey" --out-file "${poolName}/${ownerName}.deleg.cert"
+				${cardanocli} ${cliEra} stake-address stake-delegation-certificate --stake-verification-key-file "${poolName}/${ownerName}.staking.vkey" --cold-verification-key-file "${poolName}/${poolName}.node.vkey" --out-file "${poolName}/${ownerName}.deleg.cert"
 				checkError "$?"; if [ $? -ne 0 ]; then exit $?; fi
 				file_lock "${poolName}/${ownerName}.deleg.cert"
 			        echo -e "\e[32mOK\e[0m";

cardano/mainnet/sha256sum_sposcripts.txt

@@ -1,4 +1,4 @@
-577f23191b6adf251bf5a691d1ae6e42851f488ceb5bf6c112b5e8564efaadd4  00_common.sh
+bae3604732da0b3c54872adbeb78f7962f73dffb872b220a18868ac358a67c80  00_common.sh
 3f5685d008f29a31085082f72670de881ecb89b7c549b260e1a0771bd6c69ecf  01_claimRewards.sh
 8f98ef3f0983ed12ba714390b9a528ccf06b41f51dfcd1d52c50d86f038455c8  01_protectKey.sh
 0bf24a499ccc8f6665cc9b5b2e40f8af3f653656b23cd5e3eb99e27ac9279678  01_queryAddress.sh
@@ -25,7 +25,7 @@ f6cc27f6f8ad0f1714c271a97b9ed5f7c655ceaf82a92f57e26d1231e9017413  06_regDelegati
 f37a0edc7816884e9ad79cd5200017b7acccdc01b7ba5c2402ef09903601b078  08a_genStakingAddrRetireCert.sh
 d3eb0567ef878e6cea9d34bd96f4a62eaee8b207cf3a43f3b79ce6f08f7d7e35  08b_deregStakingAddrCert.sh
 8796e9d0c061982ea91e58d2a9644a88aa5f64c33efbb6a96df9a158c5ee59b9  09a_catalystVote.sh
-3034f216530fb9f8500dc5080dc5011269fe62f6c972e624cf997c8580fa0948  0x_importHelper.sh
+c53c3c3da63a07738652e0a7aad7f6eebe0999948307ae26a67aca2985eeaaf5  0x_importHelper.sh
 c419a6ba2b60619d09fde60b6709ea9d60550048c358ab3773565d2ba7a1b8bd  10_genPolicy.sh
 6dcee638d97cb9ad859eb464cf0194ef11521102fdfb5492b4b06d84498265bb  11a_mintAsset.sh
 852d63be0b4985a974c295ca073b8d8bfd7d84118d739730005fba6ec19fc99b  11b_burnAsset.sh

cardano/testnet/00_common.sh

@@ -334,7 +334,7 @@ maxNodeVersion="99.99.9"  		#maximum allowed node version, 99.99.9 = no limit so
 minLedgerCardanoAppVersion=${ENV_MINLEDGERCARDANOAPPVERSION:-"7.1.4"}  	#minimum version for the cardano-app on the Ledger HW-Wallet
 minTrezorCardanoAppVersion="2.7.2"  	#minimum version for the firmware on the Trezor HW-Wallet
 minKeystoneCardanoAppVersion="1.7.7"  	#minimum version for the firmware on the Keystone HW-Wallet
-minHardwareCliVersion="1.18.2" 		#minimum version for the cardano-hw-cli
+minHardwareCliVersion="1.19.0" 		#minimum version for the cardano-hw-cli
 minCardanoSignerVersion="1.27.0"	#minimum version for the cardano-signer binary
 minCatalystToolboxVersion="0.5.0"	#minimum version for the catalyst-toolbox binary