peers
peers
コマンドは、ピアプロトコルでこのサーバに現在接続されているその他のすべてのrippled
サーバのリスト(各サーバの接続状況と同期状況を含む)を返します。
peers
リクエストは、権限のないユーザは実行できない管理メソッドです。
リクエストのフォーマット
リクエストのフォーマットの例:
{ "id": 2, "command": "peers" }
このリクエストには追加パラメーターはありません。
レスポンスのフォーマット
処理が成功したレスポンスの例:
{ "id": 2, "status": "success", "type": "response", "result": { "cluster": {}, "peers": [ { "address": "184.172.237.226:51235", "complete_ledgers": "14534883 - 18828973", "latency": 117, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 54, "public_key": "n9KNYm52mgcUQ7R2RA4kyw9Nk1yc6S35PaiuyqjYsy6UjhCXpw12", "uptime": 55036, "version": "rippled-0.30.0-hf1" }, { "address": "54.186.248.91:51235", "complete_ledgers": "18827949 - 18828973", "latency": 91, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 62, "public_key": "n9MT5EjnV912KGuBUqPs4tpdhzMPGcnDBrTuWkD9sWQHJ1kDcUcz", "uptime": 83814, "version": "rippled-0.30.1" }, { "address": "54.84.21.230:51235", "complete_ledgers": "18827949 - 18828973", "latency": 202, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 60, "public_key": "n9KJb7NMxGySRcjCqh69xEPMUhwJx22qntYYXsnUqYgjsJhNoW7g", "uptime": 99625, "version": "rippled-0.30.1" }, { "address": "72.251.233.162:51235", "complete_ledgers": "18827949 - 18828973", "latency": 36, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 66, "public_key": "n9M8RSk6hrvXZKFQ6CxPbJsjt73xW1xsnjn7G69VAMbE2j4sBQNQ", "uptime": 99619, "version": "rippled-0.30.1" }, { "address": "162.217.98.136:51235", "complete_ledgers": "32570 - 18828973", "latency": 118, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 69, "public_key": "n944PcXEoZaiEHnwFD92xA4bxsS7jjYb27WcdDQwkHYyk1MWTEsX", "uptime": 99625, "version": "rippled-0.30.1" }, { "address": "72.251.233.163:51235", "complete_ledgers": "18827949 - 18828973", "latency": 51, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 61, "public_key": "n94ne2Z5dX8qcJNa8cPtAbtn21gEaCoEduS8TwdGAhi1iLfCUMDm", "uptime": 99625, "version": "rippled-0.30.1" }, { "address": "54.186.73.52:51235", "complete_ledgers": "18827949 - 18828973", "latency": 72, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 60, "public_key": "n9JySgyBVcQKvyDoeRKg7s2Mm6ZcFHk22vUZb3o1HSosWxcj9xPt", "uptime": 99625, "version": "rippled-0.30.1" }, { "address": "72.251.233.165:51235", "complete_ledgers": "18827949 - 18828973", "latency": 40, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 63, "public_key": "n9M77Uc9CSaSFZqt5V7sxPR4kFwbha7hwUFBD5v5kZt2SQjBeoDs", "uptime": 99625, "version": "rippled-0.30.1" }, { "address": "72.251.232.173:51235", "complete_ledgers": "32570 - 18828973", "latency": 40, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 71, "public_key": "n9JveA1hHDGjZECaYC7KM4JP8NXXzNXAxixbzcLTGnrsFZsA9AD1", "uptime": 99625, "version": "rippled-0.31.0-b6" }, { "address": "98.167.120.212:51235", "complete_ledgers": "18828845 - 18828973", "latency": 99, "ledger": "50A2577CE6EB8A92847C443BDA45F5C5F0A22B9C6F4B47DBA0C12BDA75001D01", "load": 60, "public_key": "n9LDBRoqPYY7RdkNXbX1dqZXVtUKcSqzs2CZPhTH7ymA9X7Xzmpj", "uptime": 99625, "version": "rippled-0.30.1-rc4" } ] } }
レスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドからなるJSONオブジェクトが含まれます。
Field | 型 | 説明 |
---|---|---|
cluster | オブジェクト | クラスターとして構成されている場合は、同じクラスター内の他のrippled サーバの概要。 |
peers | 配列 | peerオブジェクトからなる配列。 |
cluster
オブジェクトの各フィールドは、該当するrippled
サーバの識別用キーペアの公開鍵です。(これは、server_infoメソッドで当該サーバからpubkey_node
として返される値と同じです。)そのフィールドの内容は、以下のフィールドを持つオブジェクトです。
Field | 型 | 説明 |
---|---|---|
tag | 文字列 | 構成ファイルで定義されているこのクラスターメンバーの表示名。 |
fee | 数値 | (省略される場合があります)このクラスターメンバーがトランザクションコストに適用する負荷乗数。 |
age | 数値 | このクラスターメンバーからの最終クラスターレポート以降の経過秒数。 |
peers
配列の各メンバーは、以下のフィールドを持つpeerオブジェクトです。
考えられるエラー
- 汎用エラータイプのすべて。