Skip to main content

开始之前

以下命令组需要一个已启动并解锁的节点:
本页的单位约定。 wallet 的金额以聪为单位,asset 与 payment 的金额以原始整数单位表示,换算关系由资产精度决定 —— 用 kaleido asset metadata <asset-id> 查看。--from-amount 0.001 这类显示单位只出现在市场与交换命令中。

BTC 钱包

常用钱包命令

示例

染色 UTXO

RGB 的分配绑定在特定的比特币输出上,因此节点必须先有空闲 UTXO,才能发行、接收或发送资产:

备份与恢复

backup 与 restore 都接受 --password、-p。恢复会覆盖当前的节点数据,请谨慎使用。

RGB 资产

核心资产命令

发行新资产

issue 子命令组支持三种受支持的 schema:
用法:
  • nia 用于固定供应量的同质化资产
  • cfa 用于可收藏的同质化资产
  • uda 用于独一无二的数字资产
三者都接受 --precision 指定小数位数,--supply 以最小的原始单位表示。cfa 与 uda 还接受 --description。

资产发票与发送示例

asset send 值得关注的选项:
  • --fee-rate
  • --min-confirmations
  • --donation
  • --transport-endpoint
  • --witness-amount-sat 与 --witness-blinding
  • --skip-sync

批量发送

asset send-batch 接收的是一个描述收款方的 JSON 文件路径,而不是内联标志:

让转账继续推进

用 refresh 推进待处理的转账,用 sync 重新同步 RGB 钱包。只有当某笔转账确实失效时,才用 kaleido asset fail-transfers 释放它占用的分配;该命令接受 --batch-idx 指定单个批次、--no-asset-only 只处理无资产的转账,以及 --skip-sync。

闪电与 RGB+LN 支付

支付命令

示例

支付零金额发票时,需要提供 --amount-msat。对于 RGB+LN 支付,需要提供 --asset-id 和 --asset-amount。

使用习惯

  • 需要机器可读的响应时,使用 --json。
  • 只有在可以接受钱包或转账状态陈旧时,才使用 --skip-sync。
  • 在进行大量 RGB 操作之前先创建额外的 UTXO,以免可用的染色输出耗尽。
如果你要管理通道或订购入向流动性,请接着阅读通道与 LSP 流程;如果余额、转账或发送出现异常,请查阅故障排查。