From 50a3d5e1d968edfcffa1aeeccf3455052fc27952 Mon Sep 17 00:00:00 2001 From: Michael McGee Date: Mon, 24 Feb 2025 20:15:23 +0000 Subject: [PATCH] docs: document config argument of set-identity --- book/api/cli.md | 9 +++++++++ book/snippets/commands/set-identity.ansi | 2 +- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/book/api/cli.md b/book/api/cli.md index 5ea87bebc0..d519a878c7 100644 --- a/book/api/cli.md +++ b/book/api/cli.md @@ -148,6 +148,15 @@ argument is required and must be the path to an Agave style `identity.json` keypair file. If the path is specified as `-` the key will instead be read from `stdin`. +::: warning WARNING + +`set-identity` must be called with the configuration file you started +the validator with, like `fdctl set-identity --config `, +if the `config` argument is not provided, the command may not update +the key on all tiles and your validator may start skipping slots. + +::: + It is not generally safe to call `set-identity`, as another validator might be running with the same identity, and if they both produce a block or vote concurrently, the validator may violate consensus and be diff --git a/book/snippets/commands/set-identity.ansi b/book/snippets/commands/set-identity.ansi index 2c1cadfbe4..93d9893813 100644 --- a/book/snippets/commands/set-identity.ansi +++ b/book/snippets/commands/set-identity.ansi @@ -1,2 +1,2 @@ -$ sudo fdctl set-identity ~/keys/validator-keypair.json +$ sudo fdctl set-identity --config ~/config.toml ~/keys/validator-keypair.json NOTICE  Validator identity key switched to `4UCZB7zfquCVN7GafWETFVLTceNH3nm2mndyHeDuSggC`