Skip to content

docs: update CSM and CMv2 guides#943

Merged
dgusakov merged 3 commits into
lidofinance:mainfrom
eenti:main
Jul 24, 2026
Merged

docs: update CSM and CMv2 guides#943
dgusakov merged 3 commits into
lidofinance:mainfrom
eenti:main

Conversation

@eenti

@eenti eenti commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Please, go through these steps before you request a review:

📝 Describe your changes

  1. Updated the CSM and CMv2 operator guides for the upcoming Mainnet release, including migration, bonding, penalties, rewards, validator keys, and relevant contract references.

🔎 Attach a source of truth or evidence that allows reviewers to confirm the changes independently

N/A

@eenti
eenti requested review from a team as code owners July 23, 2026 12:48
@eenti
eenti requested review from dgusakov and skhomuti July 23, 2026 12:48

@dgusakov dgusakov left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM, but with small comments

Comment thread docs/staking-modules/csm/intro.md Outdated
Comment thread run-on-lido/cm-v2/consolidations-and-migration.md Outdated
Comment thread run-on-lido/cm-v2/context-and-background.md Outdated
Comment thread run-on-lido/cm-v2/context-and-background.md Outdated
Comment thread run-on-lido/cm-v2/index.md Outdated
dgusakov
dgusakov previously approved these changes Jul 24, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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.

Comment thread run-on-lido/cm-v2/context-and-background.md
Comment thread sidebars.js
Comment thread run-on-lido/csm/useful-tools/extra-resources.md Outdated
tamtamchik
tamtamchik previously approved these changes Jul 24, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@eenti
eenti dismissed stale reviews from tamtamchik, karinamaulitova, and dgusakov via 680bdc5 July 24, 2026 14:42
@dgusakov
dgusakov merged commit 1f8aaad into lidofinance:main Jul 24, 2026
1 check passed
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.

5 participants