SetRegularKey
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 SetRegularKey JSON
{
"Flags": 0,
"TransactionType": "SetRegularKey",
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
"Fee": "12",
"RegularKey": "rAR8rR8sUkBoCZFawhkWzY4Y5YoyuznwD"
}
SetRegularKey Fields
In addition to the common fields, a SetRegularKey transaction uses the following fields:
Field | JSON Type | Internal Type | Description |
---|---|---|---|
RegularKey |
String | AccountID | (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 XAG for the transaction cost and reserve.