IRISnet 文档

HTLC

HTLC 模块提供了与其他链进行原子交换的相关功能。

在 HTLC 生命周期中有下面的几种状态：

  • open：HTLC是可申领的
  • completed：HTLC已经被申领
  • expired：HTLC过期并且可退还
  • refunded：HTLC已退还

可用命令

Name Description
create 创建 HTLC
claim 将一个 OPEN 状态的 HTLC 中锁定的资金发放到收款人地址
refund 从过期的 HTLC 中取回退款
htlc 查询一个 HTLC 的详细信息

iris tx htlc create

创建一个 HTLC。

iris tx htlc create \
    --to=<recipient> \
    --receiver-on-other-chain=<receiver-on-other-chain> \
    --amount=<amount> \
    --secret=<secret> \
    --hash-lock=<hash-lock> \
    --timestamp=<timestamp> \
    --time-lock=<time-lock> \
    --from=mykey

标识：

名称，速记 类型 必须 默认 描述
--to string 是 Bech32 编码的收款人地址
--receiver-on-other-chain bytesHex 另一条链上的 HTLC 认领接收地址
--amount string 是 要发送的金额
--secret bytesHex 用于生成 hash lock 的 secret，缺省将随机生成
--hash-lock bytesHex 由 secret 和时间戳（如果提供）生成的 sha256 哈希，缺省将使用 secre 生成
--time-lock string 是 资金锁定的区块数
--timestamp uint 参与生成 hash lock 的 10 位时间戳（可选）

创建HTLC

iris tx htlc create \
--from=node0 \
--to=faa1zx6n0jussc3lx0dk0rax6zsk80vgzyy7kyfud5 \
--receiver-on-other-chain=0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826 \
--amount=10iris \
--secret=382aa2863398a31474616f1498d7a9feba132c4bcf9903940b8a5c72a46e4a41 \
--time-lock=50 \
--timestamp=1580000000 \
--fees=0.3iris \
--chain-id=irishub

iris tx htlc claim

将 HTLC 中锁定的资金发送到收款人地址。

iris tx htlc claim [hash-lock] [secret] [flags] --from=mykey

iris tx htlc refund

从过期的 HTLC 中取回退款。

iris tx htlc refund [hash-lock] [flags] --from=mykey

iris query htlc htlc

查询一个 HTLC 的详细信息。

iris query htlc htlc <hash-lock>

查询HTLC详细信息

iris query htlc htlc bae5acb11ad90a20cb07023f4bf0fcf4d38549feff486dd40a1fbe871b4aabdf

执行完命令后，获得 HTLC 的详细信息如下。

HTLC:
        Sender:               faa1a2g4k9w3v2d2l4c4q5rvvu7ggjcrfnynvrpqze
        To:                   faa1zx6n0jussc3lx0dk0rax6zsk80vgzyy7kyfud5
        ReceiverOnOtherChain: 0xcd2a3d9f938e13cd947ec05abc7fe734df8dd826
        Amount:               10iris
        Secret:               382aa2863398a31474616f1498d7a9feba132c4bcf9903940b8a5c72a46e4a41
        Timestamp:            1580000000
        ExpireHeight:         59
        State:                completed

← Keys →