最終更新:
編集

ledger

[ソース]

公開レジャーに関する情報を取得します。

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

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

{
   "id":14,
   "command":"ledger",
   "ledger_index":"validated",
   "transactions": false,
   "expand": false,
   "owner_funds": false
}

試してみる >

リクエストには以下のパラメーターを含めることができます。

Field必須?説明
ledger_hashハッシュいいえ使用するレジャーバージョンの32バイトの16進文字列。(レジャーの指定ご覧ください。)
ledger_indexレジャーインデックスいいえ使用するレジャーのレジャーインデックス、またはレジャーを自動的に選択するためのショートカット文字列。(レジャーの指定をご覧ください)
transactions真偽値いいえtrueの場合、指定されたレジャーバージョンのトランザクションに関する情報が返されます。デフォルトではfalseです。レジャーバージョンを指定しない場合は無視されます。
expand真偽値いいえハッシュのみではなく、トランザクション/アカウントの完全な情報がJSONフォーマットで提供されます。デフォルトではfalseです。トランザクション、アカウント、またはその両方をリクエストしない場合は無視されます。
owner_funds真偽値いいえtrueの場合、レスポンスのOfferCreateトランザクションのメタデータにowner_fundsフィールドが含まれます。デフォルトではfalseです。トランザクションが含まれておらず、expandがtrueではない場合には無視されます。
binary真偽値いいえtrueで、かつtransactionsexpandが両方ともtrueの場合、JSONフォーマットではなくバイナリフォーマット(16進文字列)でトランザクション情報が返されます。
queue真偽値いいえtrueで、かつコマンドがcurrentレジャーをリクエストしている場合、キューに入れらているトランザクションの配列が結果に含まれます。

ledgerフィールドは廃止予定であり、今後予告なしに削除される可能性があります。fullaccountstypeフィールド(管理者専用)も非推奨です。

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

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

{
    "id": "example_ledger_req",
    "result": {
      "ledger": {
        "account_hash": "B8B2C0C3F9E75E3AEE31D467B2544AB56244E618890BA58679707D6BFC0AF41D",
        "close_flags": 0,
        "close_time": 752188602,
        "close_time_human": "2023-Nov-01 21:16:42.000000000 UTC",
        "close_time_resolution": 10,
        "closed": true,
        "ledger_hash": "1BEECD5D21592EABDEF98D8E4BC038AD10B5700FF7E98011870DF5D6C2A2F39B",
        "ledger_index": "83626901",
        "parent_close_time": 752188601,
        "parent_hash": "6B32CFC42B32C5FB90019AE17F701D96B499A4C8E148A002E18135A434A19D98",
        "total_coins": "99988256314388830",
        "transaction_hash": "21586C664DC47E12AF34F22EBF1DB55D23F8C98972542BAC0C39B1009CAC84D4"
      },
      "ledger_hash": "1BEECD5D21592EABDEF98D8E4BC038AD10B5700FF7E98011870DF5D6C2A2F39B",
      "ledger_index": 83626901,
      "validated": true
    },
    "status": "success",
    "type": "response"
}

レスポンスは標準フォーマットに従っており、正常に完了した場合は結果にレジャーに関する情報を表す次のフィールドが含まれています。

Field説明
ledgerオブジェクトこのレジャーの完全なレジャーヘッダのデータで、便宜上いくつかのフィールドが追加されています。
ledger.account_hash文字列このレジャーのすべてのアカウント状態情報のハッシュ(16進数)
ledger.accountState配列このレジャーのすべてのアカウント状態情報(16進数)。
ledger.close_flags整数このレジャーのクローズに関するフラグのビットマップ。
ledger.close_time整数レジャーが閉鎖された時刻(Rippleエポック以降の経過秒数)。
ledger.close_time_human文字列人間が読めるフォーマットでのこのレジャーが閉鎖された時刻。常にUTCタイムゾーンを使用します。
ledger.close_time_resolution整数レジャー閉鎖時刻が丸められる秒数の範囲。
ledger.closed真偽値このレジャーが閉鎖されているかどうか。
ledger.ledger_hash文字列レジャー全体の一意の識別用ハッシュ。
ledger.ledger_index文字列このレジャーのレジャーインデックス。整数を引用符で囲んだ形式で示されます。
ledger.parent_close_time整数前のレジャーが閉鎖された時刻。
ledger.parent_hash文字列このレジャーの直前のレジャーの一意の識別用ハッシュ。
ledger.total_coins文字列ネットワークのXRPの合計(drop数)。整数を引用符で囲んだ形式で示されます。(トランザクションコストによりXRPが焼却されると、この値は減少します。)
ledger.transaction_hash文字列このレジャーに記録されているトランザクション情報のハッシュ(16進数)
ledger.transactions配列(リクエストされていない場合は省略)このレジャーバージョンで適用されたトランザクション。デフォルトでは、メンバーはトランザクションの識別用ハッシュ文字列です。リクエストでexpandがtrueとして指定されている場合は、メンバーはJSONフォーマットまたはバイナリフォーマットでのトランザクションの完全な表現です。フォーマットは、リクエストでbinaryがtrueとして指定されていたかどうかに応じて決まります。
ledger_hash文字列レジャー全体の一意の識別用ハッシュ。
ledger_index数値このレジャーのレジャーインデックス
queue_data配列queueパラメーターでリクエストされている場合を除いて省略)キューに入れられたトランザクションをキューと同じ順序で記述するオブジェクトの配列。リクエストでexpandがtrueに指定されている場合は、メンバーにはJSONフォーマットまたはバイナリフォーマットでのトランザクションの完全な表現が含まれています。フォーマットは、リクエストでbinaryがtrueとして指定されていたかどうかによって決まります。

ledger.accountStateフィールド("full": trueまたは"accounts": trueでリクエストされない限り省略)は廃止予定です。

次のフィールドは廃止予定であり、今後予告なしに削除される可能性があります。acceptedhash(代わりにledger_hashを使用)、seqNum(代わりにledger_indexを使用)、totalCoins(代わりにtotal_coinsを使用)。更新: rippled 1.12.0

queue_data配列の各メンバーは、キュー内の1つのトランザクションを表します。このオブジェクトの一部フィールドは、まだ計算されていないために省略されることがあります。このオブジェクトのフィールドを次に示します。

フィールド説明
account文字列このキューに入れられたトランザクションの送信者のアドレス
tx文字列またはオブジェクトデフォルトでは、これはトランザクションの識別用ハッシュを含む文字列です。トランザクションがバイナリフォーマットで展開されている場合、これはtx_blobが唯一のフィールドであるオブジェクトであり、バイナリー形式のトランザクションが10進文字列として含まれています。トランザクションがJSONフォーマットで展開されている場合、これはhashフィールドにトランザクションの識別用ハッシュが指定されているトランザクションオブジェクトを含むオブジェクトです。
retries_remaining数値このトランザクションの再試行可能回数。この回数を超えるとトランザクションが除外されます。
preflight_result文字列初期トランザクションチェックの一時的な結果。これは常にtesSUCCESSです。
last_result文字列(省略される場合があります)再試行可能な(ter)の結果を取得した後でこのトランザクションがキューに残っている場合、これは取得した正確なter結果コードです。
auth_change真偽値(省略される場合があります) このトランザクションがこのアドレスのトランザクション承認方法を変更するかどうかを示します。
fee文字列(省略される場合があります) このトランザクションのトランザクションコストXRPのdrop数)。
fee_level文字列(省略される場合があります) このタイプのトランザクションの最少コストと比較した、このトランザクションのトランザクションコスト(手数料レベル)。
max_spend_drops文字列(省略される場合があります) このトランザクションで送信または消却できるXRP、drop単位の最高額。

リクエストに"owner_funds": trueが指定されておりトランザクションが展開されている場合、レスポンスには、各OfferCreateトランザクションmetaDataオブジェクトのowner_fundsフィールドが含まれています。このフィールドの目的は、新しい検証済みレジャーごとにオファーの資金化ステータスを容易に追跡できるようにすることです。このフィールドの定義は、オーダーブックサブスクリプションストリームでのこのフィールドのバージョンとはわずかに異なります。

Field説明
owner_funds文字列このレジャーのすべてのトランザクションの実行後に、このOfferCreateトランザクションを送信するAccountが保有するTakerGets通貨の額。この通貨額が凍結されているかどうかはチェックされません。

考えられるエラー

  • 汎用エラータイプのすべて。
  • invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
  • lgrNotFound - ledger_hashまたはledger_indexで指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。
  • noPermission - fullまたはaccountsをtrueとして指定したが、管理者としてサーバに接続していない場合(通常、管理者はローカルポートで接続する必要があります)。