transaction_entry

[ソース]

transaction_entryメソッドは、特定のレジャーバージョンから1つのトランザクションに関する情報を取得します。(これに対して、txメソッドはすべてのレジャーから指定のトランザクションを検索します。txメソッドの使用をお勧めします。)

要求フォーマット

要求フォーマットの例:

{
 "id":4,
 "command":"transaction_entry",
 "tx_hash":"E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
 "ledger_index":348734
}
{
   "method":"transaction_entry",
   "params":[
       {
           "tx_hash":"E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
           "ledger_index":348734
       }
   ]
}
#Syntax: transaction_entry transaction_hash ledger_index|ledger_hash
rippled transaction_entry E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7 348734

試してみる

要求には以下のパラメーターが含まれます。

Field 説明
ledger_hash 文字列 (省略可) 使用するレジャーバージョンの20バイトの16進文字列。(レジャーの指定を参照してください)
ledger_index 文字列または符号なし整数 (省略可) 使用するレジャーのシーケンス番号、またはレジャーを自動的に選択するためのショートカット文字列。(レジャーの指定を参照してください)
tx_hash 文字列 検索するトランザクションの一意のハッシュ

注記: このメソッドでは、現在進行中のレジャーから情報を取得する操作はサポートされていません。ledger_indexまたはledger_hashでレジャーバージョンを指定する必要があります。

応答フォーマット

処理が成功した応答の例:

{
   "id":4,
   "result":{
       "ledger_index":348734,
       "metadata":{
           "AffectedNodes":[
               {
                   "ModifiedNode":{
                       "FinalFields":{
                           "Account":"r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
                           "Balance":"59328999119",
                           "Flags":0,
                           "OwnerCount":11,
                           "Sequence":89
                       },
                       "LedgerEntryType":"AccountRoot",
                       "LedgerIndex":"E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06",
                       "PreviousFields":{
                           "Balance":"59328999129",
                           "Sequence":88
                       },
                       "PreviousTxnID":"C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E",
                       "PreviousTxnLgrSeq":348700
                   }
               },
               {
                   "ModifiedNode":{
                       "FinalFields":{
                           "Balance":{
                               "currency":"USD",
                               "issuer":"rrrrrrrrrrrrrrrrrrrrBZbvji",
                               "value":"-1"
                           },
                           "Flags":131072,
                           "HighLimit":{
                               "currency":"USD",
                               "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
                               "value":"100"
                           },
                           "HighNode":"0000000000000000",
                           "LowLimit":{
                               "currency":"USD",
                               "issuer":"r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
                               "value":"0"
                           },
                           "LowNode":"0000000000000000"
                       },
                       "LedgerEntryType":"RippleState",
                       "LedgerIndex":"EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959",
                       "PreviousFields":{
                           "Balance":{
                               "currency":"USD",
                               "issuer":"rrrrrrrrrrrrrrrrrrrrBZbvji",
                               "value":"0"
                           }
                       },
                       "PreviousTxnID":"53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8",
                       "PreviousTxnLgrSeq":343570
                   }
               }
           ],
           "TransactionIndex":0,
           "TransactionResult":"tesSUCCESS"
       },
       "tx_json":{
           "Account":"r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
           "Amount":{
               "currency":"USD",
               "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
               "value":"1"
           },
           "Destination":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
           "Fee":"10",
           "Flags":0,
           "Paths":[
               [
                   {
                       "account":"r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
                       "currency":"USD",
                       "issuer":"r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
                       "type":49,
                       "type_hex":"0000000000000031"
                   }
               ],
               [
                   {
                       "account":"rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
                       "currency":"USD",
                       "issuer":"rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
                       "type":49,
                       "type_hex":"0000000000000031"
                   },
                   {
                       "account":"rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY",
                       "currency":"USD",
                       "issuer":"rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY",
                       "type":49,
                       "type_hex":"0000000000000031"
                   },
                   {
                       "account":"r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
                       "currency":"USD",
                       "issuer":"r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
                       "type":49,
                       "type_hex":"0000000000000031"
                   }
               ]
           ],
           "SendMax":{
               "currency":"USD",
               "issuer":"r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH",
               "value":"1.01"
           },
           "Sequence":88,
           "SigningPubKey":"02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E",
           "TransactionType":"Payment",
           "TxnSignature":"30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0",
           "hash":"E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
           "inLedger":348734,
           "ledger_index":348734
       }
   },
   "status":"success",
   "type":"response"
}

この応答は標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれます。

Field 説明
ledger_index 符号なし整数 トランザクションが検出されたレジャーバージョンのシーケンス番号。これは要求のledger_indexと同じです。
ledger_hash 文字列 (省略される場合があります)トランザクションが検出されたレジャーバージョンの一意のハッシュ。これは要求のledger_hashと同じです。
metadata オブジェクト トランザクションに関する各種メタデータ。
tx_json オブジェクト TransactionオブジェクトのJSON表現。

サーバーがトランザクションの検出に失敗する原因として、次のようなものが考えられます。

  • トランザクションが存在しません。
  • トランザクションが存在しますが、指定のレジャーバージョンに含まれていません。
  • サーバーには、使用可能な指定のレジャーバージョンがありません。正しいバージョンを保管する別のサーバーからの応答は、異なる可能性があります。

考えられるエラー

  • 汎用エラータイプのすべて。
  • fieldNotFoundTransaction - tx_hashフィールドが要求で省略されています。
  • notYetImplemented - レジャーバージョンが要求に指定されていません。
  • lgrNotFound - ledger_hashまたはledger_indexで指定したレジャーが存在しないか、存在してはいるもののサーバーが保有していません。
  • transactionNotFound - 要求に指定されているトランザクションが指定のレジャーで見つかりませんでした。(トランザクションが異なるレジャーバージョンにあるか、またはトランザクションがまったく使用できない可能性があります。)