最終更新:
編集

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サーバの概要。新規: rippled 0.30.1
peers配列peerオブジェクトからなる配列。

clusterオブジェクトの各フィールドは、該当するrippledサーバの識別用キーペアの公開鍵です。(これは、server_infoメソッドで当該サーバからpubkey_nodeとして返される値と同じです。)そのフィールドの内容は、以下のフィールドを持つオブジェクトです。

Field説明
tag文字列構成ファイルで定義されているこのクラスターメンバーの表示名。
fee数値(省略される場合があります)このクラスターメンバーがトランザクションコストに適用する負荷乗数。
age数値このクラスターメンバーからの最終クラスターレポート以降の経過秒数。

peers配列の各メンバーは、以下のフィールドを持つpeerオブジェクトです。

Field説明
address文字列このピアが接続しているIPアドレスとポート。
clusterブール値(省略される場合があります)trueの場合、現在のサーバとピアサーバは同じrippledクラスターに含まれています。
name文字列(省略される場合があります)ピアが同じクラスターに含まれている場合、この名前は構成ファイルで定義されているそのピアサーバの表示名です。
complete_ledgers文字列ピアrippledで利用可能なレジャーバージョンのシーケンス番号を示す範囲式
inboundブール値(省略される場合があります)trueの場合は、ピアはローカルサーバに接続しています。
latency数値ピアへのネットワーク遅延(ミリ秒単位)
ledger文字列最後に閉鎖されたピアのレジャーのハッシュ。
load数値ピアサーバによるローカルサーバへの負荷の測定値。この数値が大きいほど負荷が高くなります。(負荷の測定単位は正式には定義されていません。)
protocol文字列(省略される場合があります)ピアが使用しているプロトコルバージョン(ローカルサーバのプロトコルバージョンと異なる場合)。
public_key文字列(省略される場合があります)ピアのメッセージの整合性の検証に使用できる公開鍵。これは、検証に使用する公開鍵とは異なりますが、フォーマットは同じです。
sanity文字列(省略される場合があります)このピアが現行サーバと同じルールとレジャーシーケンスに従っているかどうか。値がinsaneの場合、ピアは並列ネットワークの一部である可能性があります。値がunknownの場合、現行サーバはピアに互換性があるかどうかを把握していません。
status文字列(省略される場合があります)ピアからの最新のステータスメッセージ。connectingconnectedmonitoringvalidatingshuttingのいずれかです。
uptime数値rippledサーバがこのピアに継続して接続していた秒数。新規: rippled 0.30.1
version文字列(省略される場合があります)ピアサーバのrippledバージョン番号

考えられるエラー