A SetRegularKey transaction assigns, changes, or removes the regular key pair associated with an account.


You can protect your account by assigning a regular key pair to it and using it instead of the master key pair to sign transactions whenever possible. If your regular key pair is compromised, but your master key pair is not, you can use a SetRegularKey transaction to regain control of your account.

Example {{}} JSON

    "Flags": 0,
    "TransactionType": "SetRegularKey",
    "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "Fee": "12",
    "RegularKey": "rAR8rR8sUkBoCZFawhkWzY4Y5YoyuznwD"
FieldJSON Type[Internal Type][]Description




(Optional) A base-58-encoded [Address][] that indicates the regular key pair to be assigned to the account. If omitted, removes any existing regular key pair from the account. Must not match the master key pair for the address.

See Also

For more information about regular and master key pairs, see Cryptographic Keys.

For a tutorial on assigning a regular key pair to an account, see Working with a Regular Key Pair.

For even greater security, you can use multi-signing, but multi-signing requires additional XAH for the [transaction cost][] and reserve.

Last updated