此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该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
该请求包含以下参数:
Field | Type | Description |
|---|---|---|
ledger_hash | String | (可选)要使用的分类帐版本的20字节十六进制字符串。(请参阅指定分类帐) |
ledger_index | String or Unsigned Integer | (可选)要使用的分类帐的序号或快捷字符串自动选择分类帐。(请参阅指定分类帐) |
tx_hash | String | 您正在查找的交易的唯一散列 |
注意:此方法不支持从当前正在进行的分类账中检索信息。您必须在
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"
}响应遵循标准格式,成功结果包含以下字段:
Field | Type | Description |
|---|---|---|
ledger_index | Unsigned Integer | 在该交易中找到的分类账版本的序列号; 这与请求中的一样。 |
ledger_hash | String | (可能被省略)发现该交易的分类帐版本的唯一散列; 这与请求中的一样。 |
metadata | Object | 关于交易的各种元数据。 |
tx_json | Object | Transaction对象的 JSON表示 |
服务器可能无法找到交易有几个可能的原因:
- 交易不存在
- 该交易存在,但不在指定的分类帐版本中
- 服务器没有可用的指定分类帐版本。另一台拥有正确版本的服务器可能会有不同的响应。
可能的错误:
- 任何通用错误类型。
fieldNotFoundTransaction-tx_hash请求中忽略了该字段notYetImplemented- 请求中未指定分类帐版本。lgrNotFound- 由ledger_hash或者ledger_index不存在的分类账,或者确实存在,但服务器没有。transactionNotFound- 在指定的分类帐中找不到请求中指定的交易。(它可能在不同的分类帐版本中,或根本不可用。)
