docs: update CSM and CMv2 guides#943
Merged
Merged
Conversation
dgusakov
reviewed
Jul 24, 2026
dgusakov
left a comment
Contributor
There was a problem hiding this comment.
LGTM, but with small comments
dgusakov
previously approved these changes
Jul 24, 2026
karinamaulitova
previously approved these changes
Jul 24, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the CSM and Curated Module v2 (CMv2) operator documentation to reflect upcoming/current Mainnet reality, including new/expanded operator-facing guidance (penalties, key types, migration, and contract references) and aligning older spec docs to point to the updated operator guides.
Changes:
- Adds/expands CSM operator guidance (new Penalties page, new Context & Background page, updated rewards/bonds UI docs, and repeated “0x01 keys only” cautions).
- Updates CMv2 docs to reflect Mainnet Phase 1 status, revises key generation examples for Mainnet, and adds cross-links to “Deployed Contracts”.
- Removes the legacy staking-modules CSM penalties doc from the sidebar (and deletes the page), shifting penalties references to the operator guide.
Reviewed changes
Copilot reviewed 28 out of 29 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| sidebars.js | Removes the CSM “penalties” page from the Staking Modules (spec) sidebar. |
| run-on-lido/csm/useful-tools/extra-resources.md | Updates an external MEV-Boost guide link target. |
| run-on-lido/csm/penalties.md | Adds a new operator-facing overview of penalty/charge mechanics and parameters. |
| run-on-lido/csm/node-setup/index.md | Adds “0x01 keys only” note and minor formatting cleanup. |
| run-on-lido/csm/lido-csm-widget/rewards-and-bonds.md | Documents the Rewards Splitter feature and keeps portal links formatted consistently. |
| run-on-lido/csm/index.md | Adds link to new Context & Background; trims contact instructions. |
| run-on-lido/csm/generating-validator-keys/key-generation-for-testnet.md | Adds “0x01 keys only” warning and formatting cleanup. |
| run-on-lido/csm/generating-validator-keys/key-generation-for-mainnet/index.md | Adds “0x01 keys only” warning for Mainnet. |
| run-on-lido/csm/generating-validator-keys/index.md | Adds global “generate 0x01 keys” warning and minor wording updates. |
| run-on-lido/csm/context-and-background.md | Adds a new page explaining 0x01 vs planned 0x02 CSM and profiles/economics. |
| run-on-lido/csm/best-practices/slashing-prevention.md | Updates slashing consequence wording and fixes penalties link target. |
| run-on-lido/cm-v2/useful-tools/key-generation.md | Switches examples to Mainnet and clarifies how to adjust for Hoodi. |
| run-on-lido/cm-v2/useful-tools/index.md | Minor formatting change. |
| run-on-lido/cm-v2/roles.md | Adds pointer to deployed contract addresses for key role-changing contracts. |
| run-on-lido/cm-v2/rewards.md | Adds deployed-contract references for Accounting/FeeDistributor. |
| run-on-lido/cm-v2/penalties.md | Rewords penalties overview, renames late-exit penalty to Exit Delay Fee, and updates strike-system notes. |
| run-on-lido/cm-v2/node-operator-types.md | Updates for Mainnet reality, adds contract storage/address references, and clarifies IODC/IODC+. |
| run-on-lido/cm-v2/index.md | Adds Phase 1 live / Phase 2 timeline info and contract-address entry point. |
| run-on-lido/cm-v2/glossary.md | Removes pre-Mainnet warning and updates strike/phase wording and links. |
| run-on-lido/cm-v2/creating-and-managing-node-operators.md | Updates widget URLs for Mainnet/Hoodi and adds CuratedGate reference. |
| run-on-lido/cm-v2/context-and-background.md | Updates rollout plan and adds clarification footnote about CSM validator type. |
| run-on-lido/cm-v2/consolidations-and-migration.md | Updates migration guidance and replaces Hoodi-only consolidations references with Mainnet + Hoodi split. |
| run-on-lido/cm-v2/bond-and-key-management.md | Updates widget URLs, terminology, and adds Accounting/deployed-contract references. |
| docs/staking-modules/csm/validator-exits.md | Updates penalties/strikes links to point at the operator penalties guide. |
| docs/staking-modules/csm/rewards.md | Updates penalties link to the operator penalties guide. |
| docs/staking-modules/csm/permissions.md | Updates general-delayed-penalty link to the operator penalties guide. |
| docs/staking-modules/csm/penalties.md | Deletes the spec-level CSM penalties page entirely. |
| docs/staking-modules/csm/intro.md | Adds a CSM v3 / planned 0x02 note and updates withdrawal-balance penalty link. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
tamtamchik
previously approved these changes
Jul 24, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
eenti
dismissed stale reviews from tamtamchik, karinamaulitova, and dgusakov
via
July 24, 2026 14:42
680bdc5
tamtamchik
approved these changes
Jul 24, 2026
karinamaulitova
approved these changes
Jul 24, 2026
dgusakov
approved these changes
Jul 24, 2026
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
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.
Please, go through these steps before you request a review:
📝 Describe your changes
🔎 Attach a source of truth or evidence that allows reviewers to confirm the changes independently
N/A