validator_list_sites

[Source]

The validator_list_sites command returns status information of sites serving validator lists. New in: rippled 0.80.1

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

Request Format

An example of the request format:

{
    "id": 1,
    "command": "validator_list_sites"
}
{
    "method": "validator_list_sites",
    "params": [
        {}
    ]
}
#Syntax: validator_list_sites
rippled validator_list_sites

The request includes no parameters.

Response Format

An example of a successful response:

{
    "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"
            }
        ]
    }
}
}
200 OK
{
    "result": {
        "status": "success",
        "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"
            }
        ]
    }
}
Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005
{
    "result": {
        "status": "success",
        "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:

Field Type Description
validator_sites Array Array of validator site objects.

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

Field Type Description
last_refresh_status String If 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_time String Human readable time when the site was last queried. If missing, the site has not yet been successfully queried.
refresh_interval_min Unsigned Integer The number of minutes between refresh attempts.
uri String The URI of the site.

Site Status Values

The last_refresh_status field can have the following values:

Value Meaning
accepted The site provided a valid list, which your server is now using.
same_sequence The site provided a list with the same sequence number as your existing list, so your server continued using its existing list.
unsupported_version The 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.
untrusted The site provided a list from the site that is signed by a cryptographic keypair 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.
stale The site provided a list with a lower sequence number than the list your server is already using.
invalid The site provided a list or signature that was not validly formed.

Possible Errors