cardano-cli-wallets

cardano-cli-wallets

これはガイダンス用スキルです。 テンプレートと説明を提供しますが、コマンドは実行しません。実行する場合は、cardano-cli-wallets-operator を使用してください。

使用するタイミング

• 支払いキー／ステークキーとアドレスの作成方法を学ぶ
• ウォレットの構造と UTxO モデルを理解する
• コピー＆ペーストできるコマンドテンプレートを取得する

運用ルール（必ず守ること）

• コマンドを提供する前に、ネットワーク（mainnet と preprod／preview）を確認してください
• コマンドは実行せず、テンプレートのみを提供してください
• すべてのテンプレートに検証手順を含めてください
• 例に秘密情報を含めないでください

Docker フォールバックモード

cardano-cli がローカルにインストールされていない場合は、このスキルフォルダー内のラッパースクリプトを使用して、Docker 内で cardano-cli を実行してください（Cardano ノードのコンテナーイメージには CLI が含まれています）。

chmod +x {baseDir}/scripts/cardano-cli.sh
{baseDir}/scripts/cardano-cli.sh version

注：

• ラッパーは現在のディレクトリを /work としてコンテナーにマウントするため、pparams.json、tx.body、datum.json などのファイルを通常どおり使用できます。
• ローカルノードのソケットがある場合は、query コマンドが機能するように、実行前に CARDANO_NODE_SOCKET_PATH を設定してください。
• CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:<tag> でイメージを上書きできます。

ワークフロー

1. ネットワークを特定する

   • mainnet または preprod/preview とマジックナンバーを尋ねる
   • doctor を使用して CLI の形式（era-prefixed または legacy）を判定する

2. キー生成テンプレートを提供する

   # Create wallet directory
   mkdir -p wallet && cd wallet
   
   # Generate payment keys
   cardano-cli conway address key-gen \
     --verification-key-file payment.vkey \
     --signing-key-file payment.skey
   
   # Generate stake keys
   cardano-cli conway stake-address key-gen \
     --verification-key-file stake.vkey \
     --signing-key-file stake.skey
   
   # Secure keys
   chmod 600 *.skey
   

3. アドレス作成テンプレートを提供する

   # Build base address (payment + stake)
   cardano-cli conway address build \
     --payment-verification-key-file payment.vkey \
     --stake-verification-key-file stake.vkey \
     --out-file base.addr \
     --testnet-magic 1  # or --mainnet
   
   # Build enterprise address (payment only)
   cardano-cli conway address build \
     --payment-verification-key-file payment.vkey \
     --out-file enterprise.addr \
     --testnet-magic 1
   

4. UTxO 照会テンプレートを提供する

   cardano-cli conway query utxo \
     --address $(cat base.addr) \
     --testnet-magic 1
   

5. ウォレット概要の出力形式

   === Wallet Dossier ===
   Network: preprod (magic 1)
   Base Address: addr_test1...
   Enterprise Address: addr_test1...
   Payment VKey Hash: abc123...
   Stake VKey Hash: def456...
   Files: payment.vkey, payment.skey, stake.vkey, stake.skey
   

例

例：preprod ウォレットを作成する

ユーザーのリクエスト：「preprod テスト用のウォレットを作成してください」

応答：

# === Preprod Wallet Setup ===

# 1. Create directory
mkdir -p ~/cardano/preprod-wallet && cd ~/cardano/preprod-wallet

# 2. Generate payment keypair
cardano-cli conway address key-gen \
  --verification-key-file payment.vkey \
  --signing-key-file payment.skey

# 3. Generate stake keypair
cardano-cli conway stake-address key-gen \
  --verification-key-file stake.vkey \
  --signing-key-file stake.skey

# 4. Build base address
cardano-cli conway address build \
  --payment-verification-key-file payment.vkey \
  --stake-verification-key-file stake.vkey \
  --out-file base.addr \
  --testnet-magic 1

# 5. Secure keys
chmod 600 *.skey

# 6. Display address for funding
echo "Fund this address from faucet:"
cat base.addr

# 7. Verify (after funding)
cardano-cli conway query utxo \
  --address $(cat base.addr) \
  --testnet-magic 1

安全性／キーの取り扱い

• .skey の内容をチャットに貼り付けないでください
• 実際の資金を扱う場合は、オフラインでのキー生成を優先してください
• アクセス許可を制限してください：chmod 600 *.skey
• キーディレクトリのクラウド同期は避けてください

参考資料

• shared/PRINCIPLES.md（リポジトリ）
• Cardano ドキュメント：キーとアドレス