コンテンツへスキップ
ドキュメント/
/
/
tx
最終更新:
編集

tx

[ソース]

txメソッドは1つのトランザクションに関する情報を取得します。

リクエストのフォーマット

リクエストのフォーマットの例:

{
  "id": 1,
  "command": "tx",
  "transaction": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
  "binary": false,
  "api_version": 2
}
試してみる

リクエストには以下のパラメーターが含まれます。

フィールド型必須?説明
ctid文字列いいえ検索するトランザクションのコンパクトトランザクション識別子。大文字の16進数のみを使用する必要があります。 新規: rippled 1.12.0 (Clio v2.0以前では対応していません)
transaction文字列いいえ検索するトランザクションの16進数の256ビットハッシュ
binary真偽値いいえtrue の場合、トランザクションデータとメタデータを16進数文字列へのバイナリシリアライズとして返します。false の場合、トランザクションデータとメタデータを JSON で返します。デフォルトは false 。
min_ledger数値いいえmax_ledgerと一緒に使うことで、このレジャーを起点として最大1000件までのレジャーインデックスの範囲を指定することができます(自身を含む)。サーバーがトランザクションを見つけられない場合、この範囲内のいずれのレジャーにも存在しないことになります。
max_ledger数値いいえmin_ledgerと一緒に使うと、このレジャーで終わる最大1000個のレジャーインデックスの範囲を指定できます(自身を含む)。サーバーがトランザクションを見つけられない場合、この範囲内のいずれのレジャーにも存在しないことになります。

ctidまたはtransactionのいずれか一方のみを提供する必要があります。

注意
このコマンドは、トランザクションがmin_ledgerからmax_ledgerの範囲外のレジャーに含まれている場合でも、トランザクションを見つけることができる場合があります。

レスポンスのフォーマット

処理が成功したレスポンスの例:

{
  "result": {
    "tx_json": {
      "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM",
      "Fee": "12",
      "Flags": 0,
      "LastLedgerSequence": 56865248,
      "OfferSequence": 5037708,
      "Sequence": 5037710,
      "SigningPubKey": "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE",
      "TakerGets": "15000000000",
      "TakerPays": {
        "currency": "CNY",
        "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
        "value": "20160.75"
      },
      "TransactionType": "OfferCreate",
      "TxnSignature": "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9",
      "ledger_index": 56865245,
      "ctid": "C363B1DD00000000",
      "date": 648248020
    },
    "hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
    "meta": {
      "AffectedNodes": [
        {
          "ModifiedNode": {
            "FinalFields": {
              "ExchangeRate": "4f04c66806cf7400",
              "Flags": 0,
              "RootIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400",
              "TakerGetsCurrency": "0000000000000000000000000000000000000000",
              "TakerGetsIssuer": "0000000000000000000000000000000000000000",
              "TakerPaysCurrency": "000000000000000000000000434E590000000000",
              "TakerPaysIssuer": "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A"
            },
            "LedgerEntryType": "DirectoryNode",
            "LedgerIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400"
          }
        },
        {
          "ModifiedNode": {
            "FinalFields": {
              "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM",
              "Balance": "10404767991",
              "Flags": 0,
              "OwnerCount": 3,
              "Sequence": 5037711
            },
            "LedgerEntryType": "AccountRoot",
            "LedgerIndex": "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2",
            "PreviousFields": {
              "Balance": "10404768003",
              "Sequence": 5037710
            },
            "PreviousTxnID": "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008",
            "PreviousTxnLgrSeq": 56865244
          }
        },
        {
          "DeletedNode": {
            "FinalFields": {
              "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM",
              "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400",
              "BookNode": "0",
              "Flags": 0,
              "OwnerNode": "0",
              "PreviousTxnID": "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C",
              "PreviousTxnLgrSeq": 56865244,
              "Sequence": 5037708,
              "TakerGets": "15000000000",
              "TakerPays": {
                "currency": "CNY",
                "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
                "value": "20160.75"
              }
            },
            "LedgerEntryType": "Offer",
            "LedgerIndex": "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B"
          }
        },
        {
          "ModifiedNode": {
            "FinalFields": {
              "Flags": 0,
              "IndexNext": "0",
              "IndexPrevious": "0",
              "Owner": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM",
              "RootIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548"
            },
            "LedgerEntryType": "DirectoryNode",
            "LedgerIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548"
          }
        },
        {
          "CreatedNode": {
            "LedgerEntryType": "Offer",
            "LedgerIndex": "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B",
            "NewFields": {
              "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM",
              "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400",
              "Sequence": 5037710,
              "TakerGets": "15000000000",
              "TakerPays": {
                "currency": "CNY",
                "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
                "value": "20160.75"
              }
            }
          }
        }
      ],
      "TransactionIndex": 0,
      "TransactionResult": "tesSUCCESS"
    },
    "validated": true,
    "ledger_index": 56865245,
    "ledger_hash": "793E56131D8D4ABFB27FA383BFC44F2978B046E023FF46C588D7E0C874C2472A",
    "close_time_iso": "2020-07-16T20:53:40Z",
    "ctid": "C363B1DD00000000"
  },
  "id": "example_tx_hash",
  "api_version": 2,
  "status": "success",
  "type": "response"
}

このレスポンスは標準フォーマットに従っており、正常に完了した場合は結果にTransactionオブジェクトフィールドと以下の追加のフィールドが含まれています。

Field型説明
ctid文字列検索するトランザクションのコンパクトトランザクション識別子。大文字の16進数のみを使用する必要があります。 新規: rippled 1.12.0 (Clio v2.0以前では対応していません)
date数値トランザクションが適用されたレジャーの閉鎖時間。[Ripple Epoch][]からの秒数で表されます。
hash文字列トランザクションの一意の[識別ハッシュ][]
inLedger数値(非推奨) ledger_indexの別名。
ledger_index数値トランザクションが含まれるレジャーのレジャーインデックス。
metaオブジェクト (JSON)(JSONモード) Transaction metadata。トランザクションの結果を詳細に表示します。
meta_blob文字列 (バイナリ)(バイナリモード) Transaction metadata。トランザクションの結果を詳細に表示します。
tx_blob文字列 (バイナリ)(バイナリモード) トランザクションデータを16進数の文字列で表したもの。
tx_jsonオブジェクト (JSON)(JSONモード) トランザクションデータをJSONで表したもの。
validated真偽値trueの場合、このデータは検証済みのレジャーバージョンからのものです。falseの場合、このデータはまだ検証されていません。

Not Foundレスポンス

サーバがトランザクションを見つけられない場合、txnNotFoundエラーを返します。これは2つのことを意味する可能性があります。

  • トランザクションはどのレジャーバージョンにも含まれておらず、送信されていません。
  • トランザクションは、サーバが保持していないレジャーバージョンに含まれていました。

txnNotFound単体では、トランザクションの最終的な結果を知るためには不十分です。

さらに可能性を絞り込むために、リクエストにmin_ledgerとmax_ledgerフィールドを指定してレジャーの範囲を指定することができます。リクエストにmin_ledgerとmax_ledgerフィールドを指定した場合、txnNotFoundレスポンスには以下のフィールドが含まれます。

フィールド型説明
searched_all真偽値(リクエストにmin_ledgerとmax_ledgerが指定されていない場合は省略) サーバが指定されたすべてのレジャーバージョンを検索できた場合はtrue。サーバが指定されたすべてのレジャーバージョンを持っていないため、トランザクションがそれらのいずれかに含まれているかどうかを確認できない場合はfalse。

リクエストされたレジャー範囲を完全に検索したtxnNotFoundレスポンスの例:

{
  "error": "txnNotFound",
  "error_code": 29,
  "error_message": "Transaction not found.",
  "id": 1,
  "request": {
    "binary": false,
    "command": "tx",
    "id": 1,
    "max_ledger": 54368673,
    "min_ledger": 54368573,
    "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7"
  },
  "searched_all": true,
  "status": "error",
  "type": "response"
}

考えられるエラー

  • 汎用エラータイプのすべて。
  • invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
  • txnNotFound - トランザクションが存在しないか、またはrippledで使用できない古いレジャーバージョンのトランザクションです。
  • excessiveLgrRange - リクエストのmin_ledgerとmax_ledgerフィールドの差が1000を超えています。
  • invalidLgrRange - 指定されたmin_ledgerがmax_ledgerより大きいか、それらのパラメータのいずれかが有効なレジャーインデックスではありません。
前のページ
次のページ