Last updated

validation_create

[Source]

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:

  1. WebSocket
  2. JSON-RPC
  3. Commandline
{
    "id": 0,
    "command": "validation_create",
    "secret": "BAWL MAN JADE MOON DOVE GEM SON NOW HAD ADEN GLOW TIRE"
}

The request includes the following parameters:

FieldTypeDescription
secretString(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:

  1. JSON-RPC
  2. Commandline
{
   "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:

FieldTypeDescription
validation_keyStringThe secret key for these validation credentials, in RFC-1751 format.
validation_public_keyStringThe public key for these validation credentials, in the XRP Ledger's base58 encoded string format.
validation_seedStringThe 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.