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 等文件可以正常使用。
• 如果你有本地节点套接字，请在运行前设置 CARDANO_NODE_SOCKET_PATH，以便 query 命令正常工作。
• 使用 CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:<tag> 覆盖映像。

工作流

1. 确认网络

   • 询问是 mainnet 还是 preprod/preview，并确认 magic number
   • 通过 doctor 确定 CLI 风格（带 era 前缀或 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 文档：密钥和地址