The changes in this commit were auto-generated by running tool/migrate.sh Following this commit, the Dactyl build no longer works but the Redocly build (mostly) should.
3.5 KiB
html, parent, blurb, status, labels
| html | parent | blurb | status | labels | |
|---|---|---|---|---|---|
| validation_seed.html | server-control-methods.html | (Obsolete) Temporarily set key to be used for validating. | removed |
|
validation_seed
The validation_seed command temporarily sets the secret value that rippled uses to sign validations. This value resets based on the config file when you restart the server. {% badge href="https://github.com/XRPLF/rippled/releases/tag/0.29.1-rc1" %}Disabled since: rippled 0.29.1{% /badge %}
The validation_seed method is an admin method that cannot be run by unprivileged users!
Request Format
An example of the request format:
{% tabs %}
{% tab label="WebSocket" %}
{
"id": "set_seed_1",
"command": "validation_seed",
"secret": "BAWL MAN JADE MOON DOVE GEM SON NOW HAD ADEN GLOW TIRE"
}
{% /tab %}
{% tab label="Commandline" %}
#Syntax: validation_seed [secret]
rippled validation_seed 'BAWL MAN JADE MOON DOVE GEM SON NOW HAD ADEN GLOW TIRE'
{% /tab %}
{% /tabs %}
The request includes the following parameters:
Field |
Type | Description |
|---|---|---|
secret |
String | (Optional) If present, use this value as the secret value for the validating key pair. Valid formats include the XRP Ledger's [base58][] format, RFC-1751, or as a passphrase. If omitted, disables proposing validations to the network. |
Response Format
An example of a successful response:
{% tabs %}
{% tab label="JSON-RPC" %}
200 OK
{
"result" : {
"status" : "success",
"validation_key" : "BAWL MAN JADE MOON DOVE GEM SON NOW HAD ADEN GLOW TIRE",
"validation_public_key" : "n9Jx6RS6zSgqsgnuWJifNA9EqgjTKAywqYNReK5NRd1yLBbfC3ng",
"validation_seed" : "snjJkyBGogTem5dFGbcRaThKq2Rt3"
}
}
{% /tab %}
{% tab label="Commandline" %}
Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005
{
"result" : {
"status" : "success",
"validation_key" : "BAWL MAN JADE MOON DOVE GEM SON NOW HAD ADEN GLOW TIRE",
"validation_public_key" : "n9Jx6RS6zSgqsgnuWJifNA9EqgjTKAywqYNReK5NRd1yLBbfC3ng",
"validation_seed" : "snjJkyBGogTem5dFGbcRaThKq2Rt3"
}
}
{% /tab %}
{% /tabs %}
The response follows the [standard format][], with a successful result containing the following fields:
Field |
Type | Description |
|---|---|---|
validation_key |
String | (Omitted if proposing disabled) The secret key for these validation credentials, in RFC-1751 format. |
validation_public_key |
String | (Omitted if proposing disabled) The public key for these validation credentials, in the XRP Ledger's [base58][] encoded string format. |
validation_seed |
String | (Omitted if proposing disabled) The secret key for these validation credentials, in the XRP Ledger's [base58][] encoded string format. |
Possible Errors
- Any of the [universal error types][].
badSeed- The request provided an invalid secret value. This usually means that the secret value appears to be a valid string of a different format, such as an account address or validation public key.
{% raw-partial file="/_snippets/common-links.md" /%}