From fdf8765cdf80682d3e61366fe66812811594323c Mon Sep 17 00:00:00 2001 From: Long Zhang Date: Mon, 28 Apr 2025 11:15:52 +0200 Subject: [PATCH 1/2] doc: improve the page of setting up a validator node reorder the section about delegating state to the validator, and also explain how to add/update a validator's descriptive fields Signed-off-by: Long Zhang --- how-to-guides/validator-node.md | 136 +++++++++++++++++++------------- 1 file changed, 79 insertions(+), 57 deletions(-) diff --git a/how-to-guides/validator-node.md b/how-to-guides/validator-node.md index c27b388ab45..a7b4904d844 100644 --- a/how-to-guides/validator-node.md +++ b/how-to-guides/validator-node.md @@ -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= -``` - -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: -``` - -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 @@ -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. @@ -186,12 +131,16 @@ validator to Mocha: ```bash-vue MONIKER="your_moniker" -VALIDATOR_WALLET="validator" +VALIDATOR_WALLET="" celestia-appd tx staking create-validator \ --amount=1000000utia \ --pubkey=$(celestia-appd tendermint show-validator) \ --moniker=$MONIKER \ + --identity= \ + --website="" \ + --security-contact="" \ + --details="A short and optional description of the validator." \ --chain-id={{constants.mochaChainId}} \ --commission-rate=0.1 \ --commission-max-rate=0.2 \ @@ -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= \ + --identity= \ + --website="" \ + --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 @@ -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 more stake to a validator + +Create an environment variable for the address: + +```bash +VALIDATOR_WALLET= +``` + +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 \ + 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: +``` + +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 From 19587a1d848c55890cbf2a0149d2958877f6d3d8 Mon Sep 17 00:00:00 2001 From: Long Zhang Date: Fri, 2 May 2025 16:12:26 +0200 Subject: [PATCH 2/2] doc: use the original title, 'more' is not necessary here Signed-off-by: Long Zhang --- how-to-guides/validator-node.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/how-to-guides/validator-node.md b/how-to-guides/validator-node.md index a7b4904d844..748abbb4f82 100644 --- a/how-to-guides/validator-node.md +++ b/how-to-guides/validator-node.md @@ -202,7 +202,7 @@ 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 more stake to a validator +## Optional: Delegate stake to a validator Create an environment variable for the address: