XRP Ledger Apex is back in Amsterdam

Register Now
Last updated
Edit

server_info

[ソース]

server_infoコマンドはClioサーバにクエリされるClioサーバに関する様々な情報を人間が読める形で問い合わせます。rippledサーバについては、代わりにserver_info (rippled)をご覧ください。新規: Clio v1.0.0

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

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

  1. WebSocket
  2. JSON-RPC
{
  "id": 1,
  "command": "server_info"
}

リクエストにパラメーターは含みません。

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

クライアントがlocalhost経由でClioサーバに接続すると、レスポンスにはcountersオブジェクトとetlオブジェクトが含まれます。クライアントが同じサーバに存在せず、localhost経由で接続しない場合、これらのオブジェクトはレスポンスから省略されます。

クライアントがlocalhost経由で接続した場合の成功したレスポンスの例:

  1. WebSocket
  2. JSON-RPC
{
    "id": 1,
    "result": {
        "info": {
            "complete_ledgers": "19499132-19977628",
            "counters": {
                "rpc": {
                    "account_objects": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "991"
                    },
                    "account_tx": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "91633"
                    },
                    "account_lines": {
                        "started": "5",
                        "finished": "5",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "4915159"
                    },
                    "submit_multisigned": {
                        "started": "2",
                        "finished": "2",
                        "errored": "0",
                        "forwarded": "2",
                        "duration_us": "4823"
                    },
                    "ledger_entry": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "17806"
                    },
                    "server_info": {
                        "started": "5",
                        "finished": "5",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "2375580"
                    },
                    "account_info": {
                        "started": "5",
                        "finished": "5",
                        "errored": "0",
                        "forwarded": "5",
                        "duration_us": "9256"
                    },
                    "account_currencies": {
                        "started": "4",
                        "finished": "4",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "517302"
                    },
                    "noripple_check": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "1",
                        "duration_us": "2218"
                    },
                    "tx": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "562"
                    },
                    "gateway_balances": {
                        "started": "6",
                        "finished": "6",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "1395156"
                    },
                    "channel_authorize": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "1",
                        "duration_us": "2017"
                    },
                    "manifest": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "1",
                        "duration_us": "1707"
                    },
                    "subscribe": {
                        "started": "6",
                        "finished": "6",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "116"
                    },
                    "random": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "111"
                    },
                    "ledger_data": {
                        "started": "14",
                        "finished": "3",
                        "errored": "11",
                        "forwarded": "0",
                        "duration_us": "6179145"
                    },
                    "ripple_path_find": {
                        "started": "1",
                        "finished": "1",
                        "errored": "0",
                        "forwarded": "1",
                        "duration_us": "1409563"
                    },
                    "account_channels": {
                        "started": "14",
                        "finished": "14",
                        "errored": "0",
                        "forwarded": "0",
                        "duration_us": "1062692"
                    },
                    "submit": {
                        "started": "6",
                        "finished": "6",
                        "errored": "0",
                        "forwarded": "6",
                        "duration_us": "11383"
                    },
                    "transaction_entry": {
                        "started": "8",
                        "finished": "5",
                        "errored": "3",
                        "forwarded": "0",
                        "duration_us": "494131"
                    }
                },
                "subscriptions": {
                    "ledger": 0,
                    "transactions": 0,
                    "transactions_proposed": 0,
                    "manifests": 2,
                    "validations": 2,
                    "account": 0,
                    "accounts_proposed": 0,
                    "books": 0
                }
            },
            "load_factor": 1,
            "clio_version": "0.3.0-b2",
            "validation_quorum": 8,
            "rippled_version": "1.9.1-rc1",
            "validated_ledger": {
                "age": 4,
                "hash": "4CD25FB70D45646EE5822E76E58B66D39D5AE6BA0F70491FA803DA0DA218F434",
                "seq": 19977628,
                "base_fee_xrp": 1E-5,
                "reserve_base_xrp": 1E1,
                "reserve_inc_xrp": 2E0
            }
        },
        "cache": {
            "size": 8812733,
            "is_full": true,
            "latest_ledger_seq": 19977629
        },
        "etl": {
            "etl_sources": [
                {
                    "validated_range": "19405538-19977629",
                    "is_connected": "1",
                    "ip": "52.36.182.38",
                    "ws_port": "6005",
                    "grpc_port": "50051",
                    "last_msg_age_seconds": "0"
                }
            ],
            "is_writer": true,
            "read_only": false,
            "last_publish_age_seconds": "2"
        },
        "validated": true
    },
    "status": "success",
    "type": "response",
    "warnings": [
        {
            "id": 2001,
            "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include ledger_index:current in your request"
        },
        {
            "id": 2002,
            "message": "This server may be out of date"
        }
    ]
}

クライアントがlocalhost経由で接続しなかった場合の成功レスポンスの例:

  1. WebSocket
  2. JSON-RPC
{
    "id": 1,
    "result": {
        "info": {
            "complete_ledgers":"32570-73737719",
            "load_factor":1,
            "clio_version":"1.0.2",
            "validation_quorum":28,
            "rippled_version":"1.9.1",
            "validated_ledger": {
                "age":7,
                "hash":"4ECDEAF9E6F8B37EFDE297953168AAB42DEED1082A565639EBB2D29E047341B4",
                "seq":73737719,
                "base_fee_xrp":1E-5,
                "reserve_base_xrp":1E1,
                "reserve_inc_xrp":2E0
            },
            "cache": {
                "size":15258947,
                "is_full":true,
                "latest_ledger_seq":73737719
            }
        },
        "validated":true,
        "status":"success"
    },
    "warnings": [
        {
            "id":2001,
            "message":"This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
        }
    ]
}

レスポンスは標準フォーマットに従い、結果が正常な場合infoオブジェクトが唯一のフィールドとして含まれます。

infoオブジェクトは以下のフィールドを含むことがあります。

Field説明
complete_ledgers文字列ローカルrippledがデータベース内に有するレジャーのバージョンのシーケンス番号の範囲を示す表現。例えば、24900901-24900984,24901116-24901158のように、互いに素なシーケンスの場合があります。サーバに完全なレジャーがない場合(例えば、ネットワークとの同期を始めたばかりの場合)、文字列emptyになります。
countersオブジェクト(省略される場合があります) サーバ起動以降に処理されたAPIコールの統計。クライアントがlocalhost経由でClioサーバに接続した場合のみ表示されます。
rpcオブジェクト(省略される場合があります) 起動時からClioサーバが処理した各API呼び出しの統計情報。これはcountersオブジェクトの中にネストされているので、クライアントがlocalhost経由でClioサーバに接続した場合のみ存在します。
rpc.*.started数値Clioサーバが起動後に処理を開始した、このタイプのAPIコールの数。
rpc.*.finished数値Clioサーバが起動以降に処理を終了した、このタイプのAPIコールの数。
rpc.*.errored数値起動後に何らかのエラーが発生した、このタイプのAPIコールの数。
rpc.*.forwarded数値起動してからClioサーバがrippledP2Pサーバに転送したAPI呼び出しの数。
rpc.*.duration_us数値起動時からこのタイプのAPIコールの処理に費やされたマイクロ秒数の合計。
subscriptionsオブジェクト(省略される場合があります) 各ストリームタイプの現在の接続者数。これはcountersオブジェクトの中にネストされているので、クライアントがlocalhost経由でClioサーバに接続した場合のみ存在します。
subscriptions.ledger
subscriptions.transactions
subscriptions.transactions_proposed
subscriptions.manifests
subscriptions.validations
subscriptions.account
subscriptions.accounts_proposed
subscriptions.books
time文字列サーバの時計によるUTCでの現在時刻。新規: Clio v2.0
uptime数値サーバが連続して稼働している秒数。新規: Clio v2.0
amendment_blocked真偽値(省略される場合があります) ClioサーバがAmendmentブロックがされているかどうか。新規: Clio v2.0
load_factor数値サーバが現在実行中の、負荷スケーリングされたオープンレジャートランザクションコストを、基本トランザクションコストに適用される乗数として示したもの。例えば、負荷係数1000でリファレンストランザクションコストが10 dropである場合、負荷スケーリングされたトランザクションコストは10,000 drop(0.01 XRP)です。負荷係数は、個々のサーバの負荷係数の最高値、クラスターの負荷係数、オープンレジャーコスト、ネットワーク全体の負荷係数によって決まります。
clio_version文字列実行中のClioサーバのバージョン番号。
libxrpl_version文字列このClioサーバがビルドされたlibxrplライブラリのバージョン番号。新規: Clio v2.0
validation_quorum数値(省略される場合があります) レジャーバージョンを検証するために必要な、信頼できる検証の最小数。状況によっては、サーバがより多くの検証をリクエストすることもあります。この値はrippledから取得します。何らかの理由でClioサーバがrippledに接続できない場合、このフィールドはレスポンスから省略されることがあります。
rippled_version文字列(省略される場合があります) Clioサーバが接続しているrippledサーバのバージョン番号。何らかの理由でClioサーバがrippledに接続できない場合、このフィールドはレスポンスから省略されることがあります。
network_id文字列(省略される場合があります) このClioサーバが接続しているrippledが動作しているネットワークのネットワークID。何らかの理由でClioサーバがrippledに接続できない場合、このフィールドはレスポンスから省略されることがあります。新規: Clio v2.0
validated_ledgerオブジェクト(省略される場合があります) 完全に検証された最新のレジャーに関する情報。検証済みの最新のレジャーがない場合、レスポンスではこのフィールドは省略され、代わりにclosed_ledgerが含まれます。
validated_ledgerオブジェクト(省略される場合があります)完全に検証された最新のレジャーについての情報。最新の検証済みレジャーが使用できない場合、このフィールドはレスポンスにて省略され、代わりにclosed_ledgerが含まれます。
validated_ledger.age数値レジャーの閉鎖以降の秒数。
validated_ledger.base_fee_xrp数値XRP単位の基本手数料。0.00005の場合は、1e-05などの科学的記数法で表すことができます。
validated_ledger.hash文字列16進数で表された、レジャーの一意のハッシュ
validated_ledger.reserve_base_xrp数値すべてのアカウントで準備金として保有しておく必要があるXRPの最少額(drop数ではありません)
validated_ledger.reserve_inc_xrp数値アカウントがレジャー内に保有するオブジェクトごとのアカウント準備金に追加するXRP額(drop数ではありません)
validated_ledger.seq数値最新の検証済みレジャーのレジャーインデックス
validation_quorum数値レジャーバージョンの検証に、最低限必要となる信頼できる検証の数。場合によっては、サーバがさらに検証をリクエストする場合があります。
validator_list_expires文字列(管理者のみ) 現在のバリデータリストの有効期限が切れるタイミングを人間が読み取れる時間でを表示、または、サーバが発行済みのバリデータリストをロードしていない場合は文字列unknown、サーバが静的なバリデータリストを使用する場合は文字列neverのいずれかを表示します。
cacheオブジェクトClioの状態データのキャッシュに関する情報。
cache.size数値現在キャッシュ内にある状態データオブジェクトの数。
cache.is_full真偽値キャッシュに特定のレジャーのすべての状態データが含まれている場合はtrue、そうでない場合はfalse。book_offersメソッド などの一部の API 呼び出しは、キャッシュが完全な場合、より高速に処理されます。
cache.latest_ledger_seq数値キャッシュに保存されている、検証済みの最新のレジャーのレジャーインデックス
etlオブジェクトClioサーバが接続しているrippledソース(ETLソース)。クライアントがlocalhost経由で Clioサーバに接続した場合のみ表示されます。
etl.etl_sourcesオブジェクト配列Clioサーバが接続され、データを抽出するrippledソース(ETLソース)を表示します。
etl.etl_sources.validated_range文字列P2Pのrippledサーバから取得した有効なレジャーの範囲。
etl.etl_sources.is_connected真偽値ClioがWebSocket経由でこのソースに接続されていればTrue、そうでなければFalse。ここでfalseが指定された場合は、ネットワークの問題や rippledが実行されていないことなどが考えられます。
etl.etl_sources.ip数値rippledサーバのIP。
etl.etl_sources.ws_port数値rippledサーバのWebSocketポート。
etl.etl_sources.grpc_port数値Clioサーバが接続しているP2PrippledサーバのgRPC接続ポート。
etl.etl_sources.last_msg_age_seconds数値Clioが最後にrippledから何かを取得してからの経過秒数の合計。これは8より大きくなってはいけません。
etl.is_writer真偽値このClioサーバが現在データベースにデータを書き込んでいる場合はtrue、そうでない場合はfalse。
etl.read_only真偽値このClioサーバが読み込み専用モードで設定されている場合はtrue、そうでない場合はfalse。
etl.last_publish_age_seconds数値このClioサーバが最後にレジャーを公開してからの経過時間(秒)。これは8以上であってはなりません。
validated真偽値Trueの場合、レスポンスがコンセンサスによって検証されたレジャーバージョンを使用していることを示します。Clioでは、検証済みのレジャーデータを保存して返すため、これは常にtrueです。リクエストがrippledに転送され、サーバが現在のデータを返した場合、値がないかfalseの場合は、このレジャーのデータが確定でないことを示します。
status文字列APIリクエストのステータスを返します。リクエストが正常に完了した場合はsuccessを返します。

考えられるエラー