docs(node): add ValidatorConfig V2 operator guide#190
Open
Conversation
Adds operator documentation for TIP-1017 ValidatorConfig V2: - Reading validator state (by address, pubkey, index) - Self-service operations: IP updates, fee recipient, key rotation, ownership transfer - V1 vs V2 comparison table - Migration walkthrough - Cross-references from existing operate-validator page Co-authored-by: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com> Amp-Thread-ID: https://ampcode.com/threads/T-019d0529-863c-737b-8027-db9e2a491918
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Co-authored-by: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com> Amp-Thread-ID: https://ampcode.com/threads/T-019d0529-863c-737b-8027-db9e2a491918
ValidatorConfig V2 activates with the T2 hardfork. Updated operator and validator docs to clearly distinguish pre-T2 (contact Tempo team) vs post-T2 (self-service via V2 precompile) behavior for key rotation, data reset, and signing share recovery. Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Leads with ValidatorConfig V2 as the primary key management interface (post-T2), with V1 procedures moved to a Legacy section below. Adds V2 sections for IP updates and ownership transfer alongside rotation and share recovery. Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Replaces the lifecycle diagram with a linear state progression chart matching the V1 chart style. Key difference: no syncer warmup step — validators become players immediately in the next epoch. Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Moves V1-specific content (validator states flowchart, key rotation, IP updates, signing share recovery) from operate-validator.mdx into a new validator-config-v1.mdx page. operate-validator.mdx now only contains version-agnostic operations: metrics, node lifecycle, logs, and Grafana dashboards. Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
V2 doc gets a 'Check if V2 is active' section with cast calls. V1 doc warning updated to mention migration completion and link to the check. Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
…s integration Rotation section now shows tempo consensus rotate-validator, create-rotate-validator-signature, and create-add-validator-signature instead of raw signature construction. Removes consensus integration section (not operator-relevant). Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
… of committee Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
jenpaff
reviewed
Mar 19, 2026
jenpaff
reviewed
Mar 19, 2026
Contributor
jenpaff
left a comment
jenpaff
left a comment
There was a problem hiding this comment.
Broken cross-reference: In validator-config-v2.mdx, the link [V1 validator states](/guide/node/operate-validator#validator-states) points to operate-validator.mdx, but this PR removes the validator states section from that page and moves it to validator-config-v1.mdx. This will be a dead anchor. Should be /guide/node/validator-config-v1#validator-states.
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
…or' dropdown Co-Authored-By: Richard Janis Goldschmidt <701177+SuperFluffy@users.noreply.github.com>
hamdiallam
reviewed
Mar 20, 2026
|
|
||
| ## Reading validator state | ||
|
|
||
| ### Query active validators |
There was a problem hiding this comment.
Is it worth noting here that active validators do not map to the active set of participants in the latest epoch
Fine leaving it out if it's an implementation detail
hamdiallam
reviewed
Mar 20, 2026
|
|
||
| The simplest way to rotate is using the `tempo` CLI, which handles signature creation and the on-chain transaction in one step: | ||
|
|
||
| ```bash |
There was a problem hiding this comment.
Prepend with the signature creation creation command as well?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds operator documentation for TIP-1017 (ValidatorConfig V2 precompile).
New page:
/guide/node/validator-config-v2— covers querying validator state, self-service operations (IP updates, fee recipient, key rotation, ownership transfer), V1 vs V2 comparison, and migration.Updated:
/guide/node/operate-validator— cross-references V2 rotation guide, wraps legacy V1 instructions in a collapsible section.Sidebar: Added entry under 'Run a Tempo Node' between 'Operating your validator' and 'Network Upgrades'.
Note: TIP page (
protocol/tips/tip-1017.mdx) is auto-generated from the tempo repo and gitignored, so it will appear once the TIP is merged there.Prompted by: Janis