validation_create
Use the validation_create
command to generate cryptographic keys a rippled
server can use to identify itself to the network. Similar to the wallet_propose method, this method only generates a set of keys in the proper format. It does not any makes changes to the XRP Ledger data or server configuration.
The validation_create
method is an admin method that cannot be run by unprivileged users.
You can configure your server to use the generated key pair to sign validations (validation key pair) or regular peer-to-peer communications (node key pair).
Tip: For configuring a robust validator, you should use the validator-keys
tool (included in the rippled
RPM) to generate validator tokens (which can be rotated) with an offline master key. For more information, see Validator Setup.
Request Format
An example of the request format:
{ "id": 0, "command": "validation_create", "secret": "BAWL MAN JADE MOON DOVE GEM SON NOW HAD ADEN GLOW TIRE" }
The request includes the following parameters:
Field | Type | Description |
---|---|---|
secret | String | (Optional) Use this value as a seed to generate the credentials. The same secret always generates the same credentials. You can provide the seed in RFC-1751 format or the XRP Ledger's base58 format. If omitted, generate a random seed. |
Note: The security of your validator depends on the entropy of your seed. Do not use a secret value for real business purposes unless it is generated with a strong source of randomness. Ripple recommends omitting the secret
when generating new credentials for the first time.
Response Format
An example of a successful response:
{ "result" : { "status" : "success", "validation_key" : "FAWN JAVA JADE HEAL VARY HER REEL SHAW GAIL ARCH BEN IRMA", "validation_public_key" : "n9Mxf6qD4J55XeLSCEpqaePW4GjoCR5U1ZeGZGJUCNe3bQa4yQbG", "validation_seed" : "ssZkdwURFMBXenJPbrpE14b6noJSu" } }
The response follows the standard format, with a successful result containing the following fields:
Field | Type | Description |
---|---|---|
validation_key | String | The secret key for these validation credentials, in RFC-1751 format. |
validation_public_key | String | The public key for these validation credentials, in the XRP Ledger's base58 encoded string format. |
validation_seed | String | 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 seed value. This usually means that the seed value appears to be a valid string of a different format, such as an account address or validation public key.