Skip to content

Commit

Permalink
add a section on the new validator node key requirement (#5969)
Browse files Browse the repository at this point in the history
  • Loading branch information
PierreBesson authored Jun 18, 2024
1 parent fb733ed commit 696c6e4
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions docs/maintain/maintain-guides-how-to-validate-polkadot.md
Original file line number Diff line number Diff line change
Expand Up @@ -684,6 +684,28 @@ in the field and click "Set Session Key".

Submit this extrinsic and you are now ready to start validating.

### Setting the Node (aka Network) Key

Validators must use a static network key to maintain a stable node identity across restarts.
Starting with Polkadot version 1.11, a check is performed on startup, and the following error will be printed if a static node key is not set:

```
Error:
0: Starting an authority without network key
This is not a safe operation because other authorities in the network may depend on your node having a stable identity.
Otherwise these other authorities may not being able to reach you.
If it is the first time running your node you could use one of the following methods:
1. [Preferred] Separately generate the key with: <NODE_BINARY> key generate-node-key --base-path <YOUR_BASE_PATH>
2. [Preferred] Separately generate the key with: <NODE_BINARY> key generate-node-key --file <YOUR_PATH_TO_NODE_KEY>
3. [Preferred] Separately generate the key with: <NODE_BINARY> key generate-node-key --default-base-path
4. [Unsafe] Pass --unsafe-force-node-key-generation and make sure you remove it for subsequent node restarts"
```

The recommended solution is to generate a node key and save it to a file using `polkadot key generate-node-key --file <PATH_TO_NODE_KEY>`, then attach it to your node with `--node-key-file <PATH_TO_NODE_KEY>`.

Please see [polkadot-sdk#3852](https://github.com/paritytech/polkadot-sdk/pull/3852) for the rationale behind this change.

## Validate

To verify that your node is live and synchronized, head to
Expand Down

0 comments on commit 696c6e4

Please sign in to comment.