Skip to content

doc: improve the page of setting up a validator node #2012

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
136 changes: 79 additions & 57 deletions how-to-guides/validator-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,60 +30,6 @@ First, follow the instructions on

Follow [the tutorial on creating a wallet](/how-to-guides/celestia-app-wallet.md).

### Delegate stake to a validator

Create an environment variable for the address:

```bash
VALIDATOR_WALLET=<validator-wallet-name>
```

If you want to delegate more stake to any validator, including your own you
will need the `celestiavaloper` address of the validator in question. You can run
the command below to get the `celestiavaloper` of your local validator wallet in
case you want to delegate more to it:

```bash
celestia-appd keys show $VALIDATOR_WALLET --bech val -a
```

After entering the wallet passphrase you should see a similar output:

```bash
Enter keyring passphrase:
celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u43cv6hd
```

To delegate tokens to the `celestiavaloper` validator, as an
example you can run:

```bash-vue
celestia-appd tx staking delegate \
celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p 1000000utia \
--from=$VALIDATOR_WALLET --chain-id={{constants.mochaChainId}} \
--fees=21000utia
```

If successful, you should see a similar output as:

```console
code: 0
codespace: ""
data: ""
gas_used: "0"
gas_wanted: "0"
height: "0"
info: ""
logs: []
raw_log: '[]'
timestamp: ""
tx: null
txhash: <tx-hash>
```

You can check if the TX hash went through using the block explorer by
inputting the `txhash` ID that was returned.

## Optional: Deploy the celestia-node

Running a bridge node is critical to the Celestia network as it enables
Expand Down Expand Up @@ -167,8 +113,7 @@ Keep in mind that these steps are necessary ONLY if you want to participate
in the consensus.

Pick a `moniker` name of your choice! This is the validator name that will show
up on public dashboards and explorers. `VALIDATOR_WALLET` must be the same you
defined previously. Parameter `--min-self-delegation=1000000` defines the
up on public dashboards and explorers. `VALIDATOR_WALLET` is the name of the validator's wallet you have created previously. Parameter `--min-self-delegation=1000000` defines the
amount of tokens that are self delegated from your validator wallet.

Now, connect to the network of your choice.
Expand All @@ -186,12 +131,16 @@ validator to Mocha:

```bash-vue
MONIKER="your_moniker"
VALIDATOR_WALLET="validator"
VALIDATOR_WALLET="<validator-wallet-name>"

celestia-appd tx staking create-validator \
--amount=1000000utia \
--pubkey=$(celestia-appd tendermint show-validator) \
--moniker=$MONIKER \
--identity=<optional_identity_signature> \
--website="<optional_validator_website>" \
--security-contact="<optional_email_address_for_security_contact>" \
--details="A short and optional description of the validator." \
--chain-id={{constants.mochaChainId}} \
--commission-rate=0.1 \
--commission-max-rate=0.2 \
Expand All @@ -203,6 +152,25 @@ celestia-appd tx staking create-validator \
--gas=220000
```

:::tip NOTE
The options `--identity`, `--website`, `--security-contact` and `--details` are optional. The `--identity` value is used to verify identity with systems like [Keybase](https://keybase.io/) or UPort. If you need to add or update the values of these descriptive fields when your validator is already created, you can use the following command (remove the options that you don't want to change the values for):

```bash
celestia-appd tx staking edit-validator \
--new-moniker=<new_validator_name> \
--identity=<identity_signature> \
--website="<validator_website>" \
--security-contact="<email_address_for_security_contact>" \
--details="New description of the validator." \
--chain-id={{constants.mochaChainId}} \
--from=$VALIDATOR_WALLET \
--keyring-backend=test \
--fees=21000utia \
--gas=220000
```

:::

You will be prompted to confirm the transaction:

```console
Expand Down Expand Up @@ -234,6 +202,60 @@ You should now be able to see your validator from
After starting your node, please submit your node as a seed and peer to the
[networks repository](https://github.com/celestiaorg/networks).

## Optional: Delegate stake to a validator

Create an environment variable for the address:

```bash
VALIDATOR_WALLET=<validator-wallet-name>
```

If you want to delegate more stake to any validator, including your own you
will need the `celestiavaloper` address of the validator in question. You can run
the command below to get the `celestiavaloper` of your local validator wallet in
case you want to delegate more to it:

```bash
celestia-appd keys show $VALIDATOR_WALLET --bech val -a
```

After entering the wallet passphrase you should see a similar output:

```bash
Enter keyring passphrase:
celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u43cv6hd
```

To delegate tokens to the `celestiavaloper` validator, as an
example you can run:

```bash-vue
celestia-appd tx staking delegate \
<the_valoper_address_starts_with_celestiavaloper1...> 1000000utia \
--from=$VALIDATOR_WALLET --chain-id={{constants.mochaChainId}} \
--fees=21000utia
```

If successful, you should see a similar output as:

```console
code: 0
codespace: ""
data: ""
gas_used: "0"
gas_wanted: "0"
height: "0"
info: ""
logs: []
raw_log: '[]'
timestamp: ""
tx: null
txhash: <tx-hash>
```

You can check if the TX hash went through using the block explorer by
inputting the `txhash` ID that was returned.

## Optional: Transaction indexer configuration options

Follow the instructions under
Expand Down
Loading