Skip to content

docs: Node.js prerequisite and staking key security warning for operators - #25292

Open
benesjan wants to merge 2 commits into
merge-train/spartanfrom
docs/node-prerequisite
Open

docs: Node.js prerequisite and staking key security warning for operators#25292
benesjan wants to merge 2 commits into
merge-train/spartanfrom
docs/node-prerequisite

Conversation

@benesjan

@benesjan benesjan commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Was missing this when setting up my own sequencer:

  • Node.js prerequisite: Adds a Node.js section to the node operator prerequisites page, instructing operators to install Node.js 24.12.0 via nvm. Was installing aztec on Ubuntu server 24.04 and was missing this in the prerequisites.
  • Staking provider key security warning: Adds a warning to the key generation step of the staking provider guide covering how the generated keystore and mnemonic must be handled and what compromise or loss costs: holders can trigger slashing and redirect block rewards but cannot steal the delegated stake, lost keys cannot be rotated, and at most 5% of the stake can be slashed before ejection, which permanently ends the delegation.

@benesjan
benesjan requested a review from koenmtb1 August 24, 2026 05:47
@benesjan benesjan changed the title docs: add Node.js 24.12.0 to node operator prerequisites docs: Node.js prerequisite and staking key security warning for operators Aug 24, 2026
The public keystore file (`keyN_staker_output.json`) contains the data you'll use for provider registration.

:::warning Key security
The private keystore (`keyN.json`) and the mnemonic that generated it must stay secret. Anyone holding them can commit slashable offenses and redirect block rewards; they cannot steal the delegated stake itself. If you lose them, the keys cannot be rotated: the sequencer stays offline and is slashed for inactivity until it is ejected. At most 5% of the delegated stake can be slashed before ejection, but ejection permanently ends the delegation (see [Slashing](../concepts/slashing.md)).

@benesjan benesjan Aug 24, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not my sphere of knowledge so please check thoroughly if the numbers here are correct.

And I guess the block rewards here are still a lie, right? (since the eth address provided in the keys generation was zero)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant