Skip to content

Commit a3af030

Browse files
authored
chore: update val config v2 to only use the cli (#205)
* val.config.cli * add deactivated validator * nit * nit * include fee recipient
1 parent 21dccb9 commit a3af030

1 file changed

Lines changed: 34 additions & 33 deletions

File tree

src/pages/guide/node/validator-config-v2.mdx

Lines changed: 34 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -75,26 +75,10 @@ committee members in the next epoch. So adding, deactivating, or rotating valida
7575

7676
### Look up your validator
7777

78-
You can query your validator by address, public key, or index:
78+
You can query your validator by ethereum address, ed25519 public key, or index:
7979

8080
```bash
81-
# By address
82-
cast call 0xCCCCCCCC00000000000000000000000000000001 \
83-
"validatorByAddress(address)(bytes32,address,string,string,uint64,uint64,uint64,address)" \
84-
<YOUR_VALIDATOR_ADDRESS> \
85-
--rpc-url https://rpc.tempo.xyz
86-
87-
# By public key
88-
cast call 0xCCCCCCCC00000000000000000000000000000001 \
89-
"validatorByPublicKey(bytes32)(bytes32,address,string,string,uint64,uint64,uint64,address)" \
90-
<YOUR_PUBLIC_KEY> \
91-
--rpc-url https://rpc.tempo.xyz
92-
93-
# By index
94-
cast call 0xCCCCCCCC00000000000000000000000000000001 \
95-
"validatorByIndex(uint64)(bytes32,address,string,string,uint64,uint64,uint64,address)" \
96-
<INDEX> \
97-
--rpc-url https://rpc.tempo.xyz
81+
tempo consensus validator <address/public_key/index> --rpc-url https://rpc.tempo.xyz
9882
```
9983

10084
The returned `Validator` struct fields are:
@@ -112,24 +96,31 @@ The returned `Validator` struct fields are:
11296

11397
## Operator guide
11498

99+
### Update the Fee Recipient
100+
101+
The fee recipient used by your validator when constructing block proposals is managed on-chain. This can be updated and takes effect on the next finalized block
102+
103+
```bash
104+
tempo consensus set-validator-fee-recipient <address/pubkey/index>
105+
--fee-recipient <ETHEREUM_ADDRESS>
106+
--rpc-url https://rpc.tempo.xyz
107+
--private-key <PATH_TO_VALIDATOR_PRIVATE_KEY>
108+
```
109+
115110
### Update IP addresses
116111

117112
If your node's network endpoints change, update them on-chain. The change takes effect at the next finalized block.
118113

119-
Unlike V1, V2 supports asymmetric ingress and egress IPs — they no longer need to share the same address. If you only want to update one, pass the current value for the other.
114+
Unlike V1, V2 supports asymmetric ingress and egress IPs — they no longer need to share the same address. Both can be updated together or individually by supplying only `--ingress` or `--egress`. The values not supplied will pulled from the chain and left unchanged in the submitted transaction.
120115

121116
```bash
122-
cast send 0xCCCCCCCC00000000000000000000000000000001 \
123-
"setIpAddresses(uint64,string,string)" \
124-
<YOUR_VALIDATOR_INDEX> \
125-
"<NEW_IP>:<NEW_PORT>" \
126-
"<NEW_EGRESS_IP>" \
127-
--rpc-url https://rpc.tempo.xyz \
128-
--private-key <YOUR_VALIDATOR_PRIVATE_KEY>
117+
tempo consensus set-validator-ip-address <address/pubkey/index>
118+
--ingress <NEW_IP>:NEW_PROT>
119+
--egress <NEW_IP>
120+
--rpc-url https://rpc.tempo.xyz
121+
--private-key <PATH_TO_VALIDATOR_PRIVATE_KEY>
129122
```
130123

131-
`<NEW_IP>:<NEW_PORT>` and `<NEW_EGRESS_IP>` may remain unchanged if you only need to update one of the two.
132-
133124
:::warning
134125
Ingress addresses must be unique across all active validators. The transaction will revert if another active validator already uses the same `IP:port`.
135126
:::
@@ -179,16 +170,26 @@ tempo consensus create-add-validator-signature \
179170
Rebind your validator entry to a new control address:
180171

181172
```bash
182-
cast send 0xCCCCCCCC00000000000000000000000000000001 \
183-
"transferValidatorOwnership(uint64,address)" \
184-
<YOUR_VALIDATOR_INDEX> \
185-
<NEW_ADDRESS> \
173+
tempo consensus transfer-validator-ownership <address/pubkey/index>
186174
--rpc-url https://rpc.tempo.xyz \
187-
--private-key <YOUR_VALIDATOR_PRIVATE_KEY>
175+
--private-key <PATH_TO_VALIDATOR_PRIVATE_KEY>
176+
--new-private-key <PATH_TO_NEW_VALIDATOR_PRIVATE_KEY>
188177
```
189178

190179
The new address must not already be used by another active validator.
191180

181+
### Deactivate your validator
182+
183+
Deactivate your validator. Once deactivated, please keep your the node. The validator is only removed from the commitee once reaching the end of an epoch where the DKG was successful, thus the validator is no longer dealt any new shares.
184+
185+
See the [validators-info](#query-active-validators) command which lists active validators. It is safe to shut down the node once the deactivated validator is no longer present in this list.
186+
187+
```bash
188+
tempo consensus deactivate-validator <address/pubkey/index>
189+
--rpc-url https://rpc.tempo.xyz \
190+
--private-key <PATH_TO_VALIDATOR_PRIVATE_KEY>
191+
```
192+
192193
## Differences from V1
193194

194195
| | V1 | V2 |

0 commit comments

Comments
 (0)