最終更新:
編集

validators

[ソース]

validatorsコマンドは、サーバが使用する公開済みの信頼できるバリデータの最新リストに関する情報を、人間が読み取れる形式で返します。新規: rippled 0.80.1

validatorsリクエストは、権限のないユーザは実行できない管理メソッドです。

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

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

{
   "id": 1,
   "command": "validators"
}

リクエストにはパラメーターが含まれていません。

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

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

{
   "id":5,
   "status":"success",
   "type":"response",
   "result":{
       "local_static_keys": [],
       "publisher_lists":[
           {
               "available":true,
               "expiration":"2017-Oct-13 14:56:00",
               "list":[
                   "nHBtBkHGfL4NpB54H1AwBaaSJkSJLUSPvnUNAcuNpuffYB51VjH6",
                   "nHBe4vqSAzjpPRLKwSFzRFtmvzXaf5wPPmuVrQCAoJoS1zskgDA4"
               ],
               "pubkey_publisher":"ED58ED4AA543B524F16771F6E1367BAA220D99DCF22CD8CF7A11309E9EAB1B647B",
               "seq":1,
               "version":1
           }
       ],
       "signing_keys":{},
       "status":"success",
       "trusted_validator_keys":[
           "nHBe4vqSAzjpPRLKwSFzRFtmvzXaf5wPPmuVrQCAoJoS1zskgDA4",
           "nHBtBkHGfL4NpB54H1AwBaaSJkSJLUSPvnUNAcuNpuffYB51VjH6"
       ],
       "validation_quorum":2,
       "validator_list_expires":"2017-Oct-13 14:56:00"
   }
}

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

Field説明
listed_static_keys配列信頼リストに常に追加可能なバリデータの公開鍵の配列。
publisher_lists配列パブリッシャーリストオブジェクトの配列。
signing_keysオブジェクトバリデータマニフェストを使用している登録済みバリデータのマスター公開鍵から、現在の署名キーへのマッピング。
trusted_validator_keys配列現在信頼されているバリデータの公開鍵の配列。
validation_quorum数値1つのレジャーバージョンの検証に最低限必要となる信頼できる検証の数。状況によっては、サーバがさらに検証をリクエストする場合があります。
validator_list_expires文字列人間が読み取れる形式での現在のバリデータリストの有効期限、文字列unknown(サーバが公開済みバリデータリストを読み込む必要がある場合)、または文字列never(サーバが静的なバリデータリストを使用している場合)のいずれか。

publisher_lists配列の各メンバーは、以下のフィールドを有するオブジェクトです。

Field説明
availableブール値falseの場合、list内のバリデータキーはこのパブリッシャーによりサポートされていない可能性があります。
expiration文字列この公開済みリストの有効期限を人間が読み取れる形式で示します。
list配列公開済みバリデータキーからなる配列。
pubkey_publisher文字列リストパブリッシャーのEd25519またはECDSA公開鍵(16進数)。
seq符号なし整数公開済みリストのシーケンス番号。
version符号なし整数リストフォーマットのバージョン。

考えられるエラー