Elements侧链RPC API文档

在线工具推荐: Three.js AI纹理开发包 - YOLO合成数据生成器 - GLTF/GLB在线编辑 - 3D模型格式在线转换 - 可编程3D场景编辑器

getrawtransaction - 查询裸交易

getrawtransaction调用返回指定交易的序列化表示或JSON表示。默认 情况下,Elements仅保存UTXO交易以及自有交易的完整数据,因此对 历史交易的查询可能失败,除非在启动节点时启用txindex=1配置。

注意:如果你在下载区块链数据后启用txindex=1,那么需要用-reindex 参数来启动节点以便重建索引,这需要执行相当长时间,在此期间你的 节点将无法处理新的区块或交易。索引重建只需要执行一次。

Elements中的getrawtransaction类似于比特币中的同名调用,但是 可以输出Elements特有的额外信息,例如私密交易输出、多种资产类型 以及额外的Elements脚本操作码。

调用参数

  • TXID:交易ID,16进制字符串
  • Format:是否解码为JSON对象。默认值:false

返回结果

当未找到指定的交易时,返回null。

当Format参数为false时,返回序列化表示的交易字符串。

当Format参数为True时,返回JSON格式的交易,结构如下:

  • hex:序列化交易表示
  • txid:交易ID
  • hash:交易哈希
  • withash:见证哈希
  • size:交易大小
  • vsize:虚拟交易大小
  • version:版本
  • locktime:锁定时间
  • vin:交易输入
    • txid:交易ID
    • vout:输出序号
    • scriptSig:签名脚本
      • asm:汇编码表示
      • hex:16进制表示
    • sequence:输入序列号
    • txinwitness:隔离见证交易的见证数据,16进制编码
  • vout:交易输出
    • value:输出金额
    • value-minimum:盲化输出的最小支付值
    • value-maximum:盲化输出的最大支付值
    • ct-exponent:用于盲化输出的指数
    • ct-bits:用于盲化输出的位数
    • asset:非盲化资产的标识符
    • assetcommit:盲化资产的标签
    • serValue:
    • n:交易输出序号
    • scriptPubKey:公钥脚本
      • asm:公钥脚本的汇编表示
      • hex:公钥脚本的16进制字符串表示
      • reqSigs:需要的签名数量
      • type:脚本类型,字符串
      • addresses:交易地址数组
  • blockhash:交易所在区块的哈希
  • confirmations:交易所在区块确认数
  • time:交易所在区块头时间戳
  • blocktime:目前与time字段一致

示例代码

请求:

~$ elements-cli getrawtransaction f4f30db53238a7529bc51fcda04ea22bd8f8b188622a6488da12281874b71f72 1

响应结果:

{
  "hex": "01000000000101[...]00003a000000",
  "txid": "f4f30db53238a7529bc51fcda04ea22bd8f8b188622a6488da12281874b71f72",
  "hash": "de1d75703f06a379d4e7a4286ac4049b1455463c79d0aff7c1d48718a2702486",
  "withash": "a7c367d101036b25a9bd3301fb7f299b2fe2b2454896a38b45ebf5aa2274b6fd",
  "size": 6855,
  "vsize": 1973,
  "version": 1,
  "locktime": 58,
  "vin": [
    {
      "txid": "389ced8ee87ebead8c4c3af49dc86be7e8f543ae3ca6956e319dee180e3a73f4",
      "vout": 57,
      "scriptSig": {
        "asm": "",
        "hex": ""
      },
      "sequence": 4294967293
    }
  ],
  "vout": [
    {
      "value-minimum": 0.00000001,
      "value-maximum": 351843.72088832,
      "ct-exponent": 0,
      "ct-bits": 45,
      "assetcommitment": "0a84e9d4f529885885acb98af9fbe7ca733e79a0e149727d32c4d6b924e63b59f6",
      "serValue": "08a5cfa07cd85a4ac50c3f7d50be553d963000e51abcb0f12725f327b944e100fc",
      "n": 0,
      "scriptPubKey": {
        "asm": "OP_DUP OP_HASH160 724e8a79568e237d1c0d9ab78665a97498d273e7 OP_EQUALVERIFY OP_CHECKSIG",
        "hex": "76a914724e8a79568e237d1c0d9ab78665a97498d273e788ac",
        "reqSigs": 1,
        "type": "pubkeyhash",
        "addresses": [
          "2djr9WWJ7GjF7Pc1syTjg5z3o883EYe4prc"
        ]
      }
    }, 
    {
      "value-minimum": 0.00000001,
      "value-maximum": 171.79869184,
      "ct-exponent": 0,
      "ct-bits": 34,
      "assetcommitment": "0b097d9e48b9c5da0cd83f1ed632771d6388c3aab7cced6610da48e40fa136b44c",
      "serValue": "08b82a8da224cf5afb65e039908b8b7f18b59e740c946cba598490b742d6670abd",
      "n": 1,
      "scriptPubKey": {
        "asm": "OP_DUP OP_HASH160 812b108ccae333e235ca9a9a5fc14d436df20d30 OP_EQUALVERIFY OP_CHECKSIG",
        "hex": "76a914812b108ccae333e235ca9a9a5fc14d436df20d3088ac",
        "reqSigs": 1,
        "type": "pubkeyhash",
        "addresses": [
          "2dmCj9T1PZ2osmWDjsaFsaoToCK2wyGkscT"
        ]
      }
    }, 
    {
      "value": 0.00039460,
      "asset": "09f663de96be771f50cab5ded00256ffe63773e2eaa9a604092951cc3d7c6621",
      "serValue": "010000000000009a24",
      "n": 2,
      "scriptPubKey": {
        "asm": "",
        "hex": "",
        "type": "fee"
      }
    }
  ],
  "blockhash": "5c81a92979fdc82a40d0aa8c1e39976a4fdcd890bf864794243052aae4ddb514",
  "confirmations": 2,
  "time": 1497552832,
  "blocktime": 1497552832
}