开发文档

transaction_entry

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。

该transaction_entry方法从特定分类帐版本检索单个事务的信息。(tx相比之下,该命令将搜索指定事务的所有分类帐,我们建议使用该方法。)

请求格式的示例:

{
  "id": 4,
  "command": "transaction_entry",
  "tx_hash": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
  "ledger_index": 155512
}
{
    "method": "transaction_entry",
    "params": [
        {
            "tx_hash": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
            "ledger_index": 155512
        }
    ]
}
#Syntax: transaction_entry transaction_hash ledger_index|ledger_hash
streamd transaction_entry 17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D 155512

该请求包含以下参数:

FieldTypeDescription
ledger_hashString(可选)要使用的分类帐版本的20字节十六进制字符串。(请参阅指定分类帐)
ledger_indexString or Unsigned Integer(可选)要使用的分类帐的序号或快捷字符串自动选择分类帐。(请参阅指定分类帐)
tx_hashString您正在查找的交易的唯一散列

 

注意:此方法不支持从当前正在进行的分类账中检索信息。您必须在ledger_index或ledger_hash中指定一个分类帐版本。

一个成功回应的例子:

{
  "id": 4,
  "result": {
    "ledger_index": 155512,
    "metadata": {
      "AffectedNodes": [{
        "ModifiedNode": {
          "FinalFields": {
            "Account": "vfq4sckDNcNcyfrDQed6FBqqDfEgTgsjtJ",
            "Balance": "21492361",
            "Flags": 8388608,
            "OwnerCount": 14,
            "Sequence": 78
          },
          "LedgerEntryType": "AccountRoot",
          "LedgerIndex": "ADEFE0B5A676E5431444ADA797634C65B963A00B9B79DBFA4821DA786DD6C8B4",
          "PreviousFields": {
            "Balance": "22492373",
            "Sequence": 77
          },
          "PreviousTxnID": "BEE1FD0E440416A4CFD29663ADB2BAB5356CBE3FE2AF7659C69B4153612BBD52",
          "PreviousTxnLgrSeq": 153524
        }
      }, {
        "ModifiedNode": {
          "FinalFields": {
            "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
            "Balance": "99999986730672448",
            "Flags": 0,
            "OwnerCount": 15,
            "Sequence": 293
          },
          "LedgerEntryType": "AccountRoot",
          "LedgerIndex": "C2FA6D77327E553B9D611CA7BE4CC0CB33817EE23919EC09C48D10E4C5653037",
          "PreviousFields": {
            "Balance": "99999986729672448"
          },
          "PreviousTxnID": "BEE1FD0E440416A4CFD29663ADB2BAB5356CBE3FE2AF7659C69B4153612BBD52",
          "PreviousTxnLgrSeq": 153524
        }
      }],
      "TransactionIndex": 0,
      "TransactionResult": "tesSUCCESS"
    },
    "tx_json": {
      "Account": "vfq4sckDNcNcyfrDQed6FBqqDfEgTgsjtJ",
      "Amount": "1000000",
      "Destination": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": "12",
      "Flags": 2147483648,
      "LastLedgerSequence": 155520,
      "Memos": [{
        "Memo": {
          "MemoData": "68616861",
          "MemoType": "6D656D6F"
        }
      }],
      "Sequence": 77,
      "SigningPubKey": "021ADD58CB32BFD8F3F24A027081CE3928CEE072E85692123DE4DF92EFCF2CE2BC",
      "TransactionType": "Payment",
      "TxnSignature": "304402200C8B73E45DD5C43D6C10ECF26BE1D0212BA121BC0EB090441B09AE21FAD2F17C02206143819F8B15F4C8C83A4735E56E971E7465A76C2116443092E8E7179B4A7AFD",
      "hash": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
      "inLedger": 155512,
      "ledger_index": 155512
    },
    "validated": false
  },
  "status": "success",
  "type": "response"
}

响应遵循标准格式,成功结果包含以下字段:

FieldTypeDescription
ledger_indexUnsigned Integer在该交易中找到的分类账版本的序列号; 这与请求中的一样。
ledger_hashString(可能被省略)发现该交易的分类帐版本的唯一散列; 这与请求中的一样。
metadataObject关于交易的各种元数据。
tx_jsonObjectTransaction对象的 JSON表示

服务器可能无法找到交易有几个可能的原因:

  • 交易不存在
  • 该交易存在,但不在指定的分类帐版本中
  • 服务器没有可用的指定分类帐版本。另一台拥有正确版本的服务器可能会有不同的响应。

可能的错误:

  • 任何通用错误类型。
  • fieldNotFoundTransaction- tx_hash请求中忽略了该字段
  • notYetImplemented - 请求中未指定分类帐版本。
  • lgrNotFound- 由ledger_hash或者ledger_index不存在的分类账,或者确实存在,但服务器没有。
  • transactionNotFound - 在指定的分类帐中找不到请求中指定的交易。(它可能在不同的分类帐版本中,或根本不可用。)
THE NEXT CONNECTION

下一次连接,从这里开始。

加入 Stream 社区,一起探索价值互联。

联系我们