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`で、かつ`transactions`と`expand`が両方とも`true`の場合、JSONフォーマットではなくバイナリフォーマット（16進文字列）でトランザクション情報が返されます。
`queue`	真偽値	いいえ	`true`で、かつコマンドが`current`レジャーをリクエストしている場合、キューに入れらているトランザクションの配列が結果に含まれます。

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

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

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

{
    "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でリクエストされない限り省略）は廃止予定です。

次のフィールドは廃止予定であり、今後予告なしに削除される可能性があります。accepted、hash（代わりにledger_hashを使用）、seqNum（代わりにledger_indexを使用）、totalCoins（代わりにtotal_coinsを使用）。

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として指定したが、管理者としてサーバに接続していない場合（通常、管理者はローカルポートで接続する必要があります）。