Cardano CLI – ADA送金完全ガイド

このガイドでは、Cardano CLIを使ってADAを送金する完全なフローを提供します。各コマンドをコピー&ペーストして実行できます。

事前準備

以下のファイルが必要です：

• payment.addr – 送信元アドレス
• payment.skey – 秘密鍵
• payment.vkey – 公開鍵

⚠️ 注意: 秘密鍵（payment.skey）は絶対に他人と共有しないでください。

---

ステップ別コマンド

スクリプトを使わず、1つずつ実行したい場合は以下のコマンドを順番に実行してください。

Step 1: 送金情報の設定

destinationAddress="addr1_ここに送金先アドレスを入力"
amountToSend=5000000

Step 2: UTXO取得と残高計算

cardano-cli conway query utxo \
    --address $(cat payment.addr) \
    --mainnet > balance.out

tx_in=""
total_balance=0
while read -r utxo; do
    in_addr=$(awk '{ print $1 }' <<< "${utxo}")
    idx=$(awk '{ print $2 }' <<< "${utxo}")
    utxo_balance=$(awk '{ print $3 }' <<< "${utxo}")
    total_balance=$((${total_balance}+${utxo_balance}))
    tx_in="${tx_in} --tx-in ${in_addr}#${idx}"
done < balance.out
txcnt=$(cat balance.out | wc -l)

echo "残高: ${total_balance} lovelace"
echo "UTXO数: ${txcnt}"

Step 3: プロトコルパラメータ取得

cardano-cli conway query protocol-parameters \
    --mainnet \
    --out-file protocol.json

Step 4: 現在のスロット取得

currentSlot=$(cardano-cli conway query tip --mainnet | jq -r '.slot')
echo "現在のスロット: ${currentSlot}"

Step 5: トランザクション構築

cardano-cli conway transaction build \
    ${tx_in} \
    --tx-out ${destinationAddress}+${amountToSend} \
    --change-address $(cat payment.addr) \
    --invalid-hereafter $(( ${currentSlot} + 10000)) \
    --mainnet \
    --out-file tx.raw

Step 6: 署名

tx.raw を、エアギャップの cnode にコピーします。

cardano-cli conway transaction sign \
    --tx-body-file tx.raw \
    --signing-key-file payment.skey \
    --signing-key-file stake.skey \
    $NODE_NETWORK \
    --out-file tx.signed

Step 7: 送信

cardano-cli conway transaction submit \
    --tx-file tx.signed \
    --mainnet

Step 8: トランザクションID確認

txId=$(cardano-cli conway transaction txid --tx-file tx.signed)
echo "Transaction ID: ${txId}"
echo "https://cardanoscan.io/transaction/${txId}"

---

よくある操作

残高確認のみ

cardano-cli conway query utxo \
    --address $(cat payment.addr) \
    --mainnet

ADA⇔lovelace変換

5 ADA を lovelace に変換

echo "5 * 1000000" | bc

5000000 lovelace を ADA に変換

echo "scale=6; 5000000 / 1000000" | bc

現在のチェーン情報確認

cardano-cli conway query tip --mainnet

---

トラブルシューティング

エラー: FeeTooSmallUTxO

原因: 手数料不足

解決: transaction buildを使用している場合は自動計算されるため、このエラーは通常発生しません。build-rawを使用している場合は、手数料を再計算してください。

エラー: BadInputsUTxO

原因: 指定したUTXOが存在しないか既に使用済み

解決: コピー

# UTXOを再取得

cardano-cli conway query utxo \
    --address $(cat payment.addr) \
    --mainnet

エラー: OutsideValidityIntervalUTxO

原因: トランザクションの有効期限切れ

解決: コピー

# 現在のスロットを再取得してトランザクションを再構築

currentSlot=$(cardano-cli conway query tip --mainnet | jq -r '.slot')

エラー: ValueNotConservedUTxO

原因: input合計 ≠ output合計 + 手数料

解決: transaction buildを使用すれば自動的に計算されます。

---

注意事項

• 秘密鍵の保護: payment.skeyは絶対に他人と共有しないでください
• テストネット: 初めて試す場合は--mainnetを--testnet-magic 1に変更してテストネットで試すことをおすすめします
• 手数料: 通常0.17 ADA程度の手数料が発生します
• 最小送金額: 実用上、1 ADA以上の送金をおすすめします

参考リンク

• Cardano Explorer
• Cardano Documentation
• Cardano CLI Reference

このガイドは2025年3月時点の情報に基づいています。最新情報は公式ドキュメントをご確認ください。