mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-21 12:15:50 +00:00
a87a06620c
* Initial migration and edits for EVM Sidechains documentation * Fix broken link * Incorporate review feedback and fix indentaton for code snippets and images within steps * Incorporate review feedback * Fix indentation within steps
107 lines
4.8 KiB
Markdown
107 lines
4.8 KiB
Markdown
---
|
||
html: evm-sidechain-run-a-validator-node.html
|
||
parent: evm-sidechains.html
|
||
blurb: Learn how to run a validator node on the EVM Sidechain Devnet.
|
||
labels:
|
||
- Development, Interoperability
|
||
status: not_enabled
|
||
---
|
||
# Run a Validator Node on an EVM Sidechain
|
||
|
||
## Create Your Validator
|
||
|
||
Use your node consensus public key (`exrpvalconspub...`) to create a new validator by staking XRP tokens. You can find your validator pubkey by running:
|
||
|
||
```bash
|
||
exrpd tendermint show-validator
|
||
```
|
||
|
||
To create your validator on Devnet, use the following command:
|
||
|
||
```bash
|
||
exrpd tx staking create-validator \
|
||
--amount=1000000000000000000000axrp \
|
||
--pubkey=$(exrpd tendermint show-validator) \
|
||
--moniker="<your_custom_moniker>" \
|
||
--chain-id=<chain_id> \
|
||
--commission-rate="0.05" \
|
||
--commission-max-rate="0.10" \
|
||
--commission-max-change-rate="0.01" \
|
||
--min-self-delegation="1000000" \
|
||
--gas="auto" \
|
||
--gas-prices="0.025aphoton" \
|
||
--from=<key_name>
|
||
```
|
||
|
||
**Note** When specifying commission parameters, the `commission-max-change-rate` is used to measure % *point* change over the `commission-rate`. For example, 1% to 2% is a 100% rate increase, but only 1 percentage point.
|
||
|
||
|
||
**Note** `Min-self-delegation` is a strictly positive integer that represents the minimum amount of self-delegated voting power your validator must always have. A `min-self-delegation` of `1000000` means your validator will never have a self-delegation lower than `1 axrp`.
|
||
|
||
You can confirm that you are in the validator set by using a third-party explorer.
|
||
|
||
## Edit Validator Description
|
||
|
||
You can edit your validator's public description. This info is to identify your validator, and is relied on by delegators when they decide to stake XRP tokens to a particular validator. Make sure to provide input for every flag below. If a flag is not included in the command, the field defaults to empty (`--moniker` defaults to the machine name), if the field has never been set, or remains the same, if it has been set in the past.
|
||
|
||
The <key_name> specifies which validator you are editing. If you choose to not include certain flags, remember that the --from flag must be included to identify the validator to update.
|
||
|
||
The `--identity` can be used as to verify identity with systems like Keybase or UPort. When using with Keybase `--identity` must be populated with a 16-digit string that is generated with a [keybase.io](https://keybase.io/) account. It is a cryptographically secure method of verifying your identity across multiple online networks. The Keybase API allows us to retrieve your Keybase avatar. This is how you can add a logo to your validator profile.
|
||
|
||
```bash
|
||
exrpd tx staking edit-validator
|
||
--moniker="<your_custom_moniker>" \
|
||
--website="https://xrpl.org" \
|
||
--identity=6A0D65E29A4CBC8E \
|
||
--details="<your_validator_description>" \
|
||
--chain-id=<chain_id> \
|
||
--gas="auto" \
|
||
--gas-prices="0.025axrp" \
|
||
--from=<key_name> \
|
||
--commission-rate="0.10"
|
||
```
|
||
|
||
Note that the `commission-rate` value must adhere to the following invariants:
|
||
|
||
* Must be between 0 and the validator's `commission-max-rate`
|
||
* Must not exceed the validator's `commission-max-change-rate` which is the maximum % point change rate **per day**. In other words, a validator can only change its commission once per day and within `commission-max-change-rate` bounds.
|
||
|
||
## View Validator Description
|
||
|
||
View the validator's information with this command:
|
||
|
||
```bash
|
||
exrpd query staking validator <account>
|
||
```
|
||
|
||
## Track Validator Signing Information
|
||
|
||
To track a validator's signatures from past transactions use the `signing-info` command.
|
||
|
||
```bash
|
||
exrpd query slashing signing-info <validator-pubkey> --chain-id=<chain_id>
|
||
```
|
||
|
||
## Unjail Validator
|
||
|
||
When a validator is "jailed" for downtime, you must submit an `Unjail` transaction from the operator account in order to restore block proposer awards (depending on the zone fee distribution).
|
||
|
||
```bash
|
||
exrpd tx slashing unjail --from=<key_name> --chain-id=<chain_id>
|
||
```
|
||
|
||
## Confirm Your Validator is Running
|
||
|
||
Your validator is active if the following command returns anything:
|
||
|
||
```bash
|
||
exrpd query tendermint-validator-set | grep "$(exrpd tendermint show-address)"
|
||
```
|
||
|
||
You should now see your validator in one of the Exrp explorers. You are looking for the `bech32` encoded `address` in the `~/.exprd/config/priv_validator.json` file.
|
||
|
||
**Note** To be in the validator set, you must have more total voting power than the 100th validator.
|
||
|
||
## Halting Your Validator
|
||
|
||
When attempting to perform routine maintenance or planning for an upcoming coordinated upgrade, it can be useful to have your validator systematically and gracefully halt. Set the `halt-height` to the height at which you want your node to shut down, or pass the `--halt-height` flag to `exrpd`. The node shuts down with a 0 exit code at that given height after committing the block. |