Last updated

validator_list_sites

[Source]

The validator_list_sites command returns status information of sites serving validator lists.

The validator_list_sites method is an admin method that cannot be run by unprivileged users!

Request Format

An example of the request format:

  1. WebSocket
  2. JSON-RPC
  3. Commandline
{
    "id": 1,
    "command": "validator_list_sites"
}

The request includes no parameters.

Response Format

An example of a successful response:

  1. WebSocket
  2. JSON-RPC
  3. Commandline
{
    "id":5,
    "status":"success",
    "type":"response",
    "result": {
        "validator_sites": [
            {
                "last_refresh_status": "accepted",
                "last_refresh_time": "2017-Oct-13 21:26:37",
                "refresh_interval_min": 5,
                "uri": "http://127.0.0.1:51447/validators"
            }
        ]
    }
}
}

The response follows the standard format, with a successful result containing the following field:

FieldTypeDescription
validator_sitesArrayArray of validator site objects.

Each member of the validator_sites field array is an object with the following fields:

FieldTypeDescription
last_refresh_statusStringIf present, shows the status of the most recent refresh of the site. If missing, the site has not yet been successfully queried. See Site Status Values below for possible states and their meanings.
last_refresh_timeStringHuman readable time when the site was last queried. If missing, the site has not yet been successfully queried.
refresh_interval_minUnsigned IntegerThe number of minutes between refresh attempts.
uriStringThe URI of the site.

Site Status Values

The last_refresh_status field can have the following values:

ValueMeaning
acceptedThe site provided a valid list, which your server is now using.
same_sequenceThe site provided a list with the same sequence number as your existing list, so your server continued using its existing list.
unsupported_versionThe site provided a list, but your server does not support the list format version number in the list. You might need to update rippled to a newer software version.
untrustedThe site provided a list from the site that is signed by a cryptographic key pair your server is not configured to trust. You may want to check for typos in your validators.txt file and check to see if the list publisher changed their cryptographic keys.
staleThe site provided a list with a lower sequence number than the list your server is already using.
invalidThe site provided a list or signature that was not validly formed.

Possible Errors