Elements侧链RPC API文档

listunspent - 查询未消费交易输出

listunspent调用返回钱包内的未消费交易输出数组。

Elements中的listunspent类似于Bitcoin Core的同名调用,但同时 包含有更多Elements的特定信息,例如资产类型以及私密交易信息。

调用参数

  • MinimumConfirmations:最小确认数,数值,可选,默认值:1
  • MaximumConfirmations:最大确认数,数值,可选,默认值:9999999
  • Addresses:地址过滤数组,可选,仅返回该数组中地址相关的UTXO, 默认值:空数组,表示返回所有钱包地址的UTXO
  • IncludeUnsafe:是否包含不安全的交易输出,布尔值,可选,默认值:false
  • AssetIdentifier:资产标识符,仅返回该资产相关的UTXO,字符串,可选,默认值为空

返回结果

listunspent调用返回UTXO数组,每个成员结构如下:

  • txid:交易ID
  • vout:输出序号
  • address:地址
  • account:账户
  • scriptPubKey:公钥脚本
  • redeemScript:赎回脚本
  • amount:金额
  • asset:资产标识符
  • assetcommitment:
  • assetlabel:资产标签
  • confirmations:该输出所在交易的确认数
  • spendable:消费该输出的私钥是否在钱包内,布尔值
  • solvable:钱包是否了解如何消费该输出,布尔值
  • serValue:
  • blinder:输出值盲化因子
  • assetblinder:资产盲化器

示例代码

请求:

~$ elements-cli listunspent

响应结果:

[
  {
    "txid": "389ced8ee87ebead8c4c3af49dc86be7e8f543ae3ca6956e319dee180e3a73f4",
    "vout": 99,
    "scriptPubKey": "51",
    "amount": 210000.00000000,
    "asset": "09f663de96be771f50cab5ded00256ffe63773e2eaa9a604092951cc3d7c6621",
    "assetlabel": "bitcoin",
    "confirmations": 120,
    "spendable": true,
    "solvable": true,
    "serValue": "00508a7119130000",
    "blinder": "0000000000000000000000000000000000000000000000000000000000000000"
  }
]