Add "Run on Lido" section and CSM guide for NOs #612

eenti · 2025-05-21T18:54:33Z

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

📝 Describe your changes

Added a link to the new "Run on Lido" section at the introduction page, so folks can access it from there.
Created a "Run on Lido" section with Docusaurus' multi-instance feature.
Inside "Run on Lido" we added a complete CSM Guide with multiple integration guides, key generation and more.

🔎 Include source of truth for all changes that reference on-chain data (addresses, etc.)

Only references to onchain addresses are to the Lido Execution Layer and Withdrawal Vaults, of both Mainnet and Hoodi.

feat(docs): add CSM Guide multi-instance

Need to proof-read and solve minor issues. But al pages are imported.

dgusakov

We need to trink about what stuff from http://localhost:3000/staking-modules/csm/guides/ should be moved (to avoid duplicates) and how this new guide will be linked from that section

package.json

dgusakov · 2025-05-22T07:43:40Z

Also review build errors and fix them

eenti · 2025-05-22T18:30:08Z

We need to trink about what stuff from http://localhost:3000/staking-modules/csm/guides/ should be moved (to avoid duplicates) and how this new guide will be linked from that section

This first one does not include anything repeated from the main guides. In fact some of them are referenced and linked, but I agree. We can discuss later and move some of them.

eenti · 2025-05-22T19:06:58Z

Reverted package.json and fixed build errors. Please check again @dgusakov.

run-on-lido/csm/alerts-and-monitoring/beginner-csm-widget-ethseer-beaconcha.in.md

run-on-lido/csm/alerts-and-monitoring/intermediate-other-external-dashboards.md

run-on-lido/csm/best-practices/index.md

dgusakov · 2025-06-11T06:35:58Z

run-on-lido/csm/lido-csm-widget/rewards-and-bonds.md

+
+Here, you will see your net rewards and bond claimable in aggregate and broken down into its individual parts. Note that `Locked bond` is also deducted from your aggregate rewards here.
+
+You will also be able to claim your net rewards + bond in total or in individual parts if you wish, and select among 3 token types to receive: ETH / stETH / wstETH.


ETH is not claimable directly. Add a note that to get ETH you need to get Withdrawal NFT first

dgusakov · 2025-06-11T06:37:32Z

run-on-lido/csm/lido-csm-widget/rewards-and-bonds.md

+
+![Unbonded Keys](/img/csm-guide/bond-4.png)
+
+:::info


This is not fully accurate. Bond is required to cover both deposited and uploaded keys. To release bond you should either exit deposited keys or remove undeposited ones

Thanks for catching this. This statement "Exiting your CSM-deposited keys will not unlock your Locked bonds" is meant for the "Unlock Bond" section.

run-on-lido/csm/lido-csm-widget/upload-remove-view-validator-keys.md

dgusakov · 2025-06-11T06:41:36Z

run-on-lido/csm/generating-validator-keys/key-generation-for-mainnet/index.md

@@ -0,0 +1,249 @@
+import Tabs from '@theme/Tabs';


We should also mention somewhere here that you need to use 0x01 WC and set deposit amount to 32 ETH

Co-authored-by: Dmitry Gusakov <[email protected]>

Replace ls with find to capture more edge cases

…ent.md updated validator keystore file paths

…ent.md

dgusakov · 2025-06-13T15:48:07Z

docs/staking-modules/csm/intro.md

@@ -1,5 +1,8 @@
 # Intro

+:::info


Suggested change

:::info

:::tip

dgusakov · 2025-06-13T15:49:01Z

run-on-lido/intro.md

+
+# Run on Lido
+
+This section of the Lido documentation is for users wanting to run any of the Lido products, whether Node Operators, Vault managers or Oracle Operators.


Suggested change

This section of the Lido documentation is for users wanting to run any of the Lido products, whether Node Operators, Vault managers or Oracle Operators.

This section of the Lido documentation is for users who want to run any of the Lido products, whether Node Operators, Vault managers, or Oracle Operators.

dgusakov · 2025-06-13T15:51:33Z

run-on-lido/csm/index.md

+| ---- | ------- |
+| [Lido CSM Operator Portal](https://operatorportal.lido.fi/modules/community-staking-module) | Concepts and requirements of participating in the Lido CSM. Useful for getting up to speed quickly for new CSM operators. |
+| [Lido CSM Documentation](https://docs.lido.fi/staking-modules/csm/intro) | Contracts and detailed specifications of the Lido CSM and guides for advanced users. |
+| Mainnet: [csm.lido.fi](https://csm.lido.fi/)<br />Hoodi Testnet: [csm.testnet.fi](https://csm.testnet.fi/) | This is where you connect your wallet, upload keys, provide and withdraw bonds, and claim rewards. |


Suggested change

| Mainnet: [csm.lido.fi](https://csm.lido.fi/)<br />Hoodi Testnet: [csm.testnet.fi](https://csm.testnet.fi/) | This is where you connect your wallet, upload keys, provide and withdraw bonds, and claim rewards. |

| [CSM UI on Mainnet](https://csm.lido.fi/)<br /> [CSM UI on Hoodi Testnet](https://csm.testnet.fi/) | This is where you connect your wallet, upload keys, provide and withdraw bonds, and claim rewards. |

dgusakov · 2025-06-13T15:54:06Z

run-on-lido/csm/node-setup/beginner/dappnode.md

+## Full Node Setup
+
+:::info
+Machines purchased from the Dappnode store are plug-and-play. If you’re installing on your own hardware, it must run Debian. Follow the official Debian installer guide [here](https://www.debian.org/devel/debian-installer/).


Suggested change

Machines purchased from the Dappnode store are plug-and-play. If you’re installing on your own hardware, it must run Debian. Follow the official Debian installer guide [here](https://www.debian.org/devel/debian-installer/).

Machines purchased from the [Dappnode store](https://dappnode.com/) are plug-and-play. If you’re installing it on your own hardware, it must run on Debian. Follow the official Debian installer guide [here](https://www.debian.org/devel/debian-installer/).

dgusakov · 2025-06-13T16:06:12Z

run-on-lido/csm/lido-csm-widget/upload-remove-view-validator-keys.md

+:::info
+**DO NOT DEPOSIT 32 ETH** using the deposit data file generated this way as the Lido CSM will make the deposit for you. _**Doing so will result in a loss of funds.**_
+:::


Suggested change

:::info

**DO NOT DEPOSIT 32 ETH** using the deposit data file generated this way as the Lido CSM will make the deposit for you. _**Doing so will result in a loss of funds.**_

:::

:::warning

**DO NOT DEPOSIT 32 ETH** using the deposit data file generated this way, as the Lido CSM will make a deposit for you.

_**Doing so will result in a loss of funds.**_

:::

dgusakov · 2025-06-13T16:08:07Z

run-on-lido/csm/lido-csm-widget/upload-remove-view-validator-keys.md

+![Post-remove status](/img/csm-guide/keys-4.png)
+
+:::warning
+Keys that have been deposited cannot be deleted and only can be exited.


And add a link to the corresponding section

Suggested change

Keys that have been deposited cannot be deleted and only can be exited.

Keys that have been deposited cannot be deleted and can only be exited from the Consensus Layer.

dgusakov · 2025-06-13T16:13:21Z

run-on-lido/csm/lido-csm-widget/exiting-csm-validators/index.md

+
+There are 2 reasons why CSM operators can receive exit request from the Lido Protocol:
+1. If the protocol needs ETH to fulfill stETH withdrawal requests. Note that because of how the protocol works withdrawal requests will, for the most part, be requested from bigger modules like the Curated Module first.
+2. If the validator is performing below the Performance Threshold for 3 frames within 6 months.


This is only true for v2 and should be framed differently for v2. So remove it for now

Add the case about unbonded validators. Basically all unbonded validators are required to exit

dgusakov · 2025-06-13T16:15:06Z

run-on-lido/csm/lido-csm-widget/exiting-csm-validators/index.md

+1. To use the hosted version, click [here for Mainnet](https://t.me/CSMSentinel_bot) or here for [Hoodi](https://t.me/CSMSentinelHoodi_bot)
+Search for the **"CSM Sentinel"** bot on Telegram and open a chat with it


Suggested change

1. To use the hosted version, click [here for Mainnet](https://t.me/CSMSentinel_bot) or here for [Hoodi](https://t.me/CSMSentinelHoodi_bot)

Search for the **"CSM Sentinel"** bot on Telegram and open a chat with it

1. To use the hosted version, click [here for Mainnet](https://t.me/CSMSentinel_bot) or here for [Hoodi](https://t.me/CSMSentinelHoodi_bot). Alternatively, search for the **"CSM Sentinel"** bot on Telegram and open a chat with it

dgusakov · 2025-06-13T16:15:55Z

run-on-lido/csm/lido-csm-widget/exiting-csm-validators/index.md

+## How to Exit Keys and Withdraw Your Bond
+
+1. Sign & broadcast an exit message for each validator key you want to exit. Refer to the sub-sections/pages below.
+2. Wait for the validator key to be fully exited on the beacon chain. Check your validator ID pubkey on [beaconcha.in](https://beaconcha.in/).


Suggested change

2. Wait for the validator key to be fully exited on the beacon chain. Check your validator ID pubkey on [beaconcha.in](https://beaconcha.in/).

2. Wait for the validator key to be fully exited on the beacon chain. Check your validator pubkey on [beaconcha.in](https://beaconcha.in/).

dgusakov · 2025-06-13T16:23:57Z

run-on-lido/csm/updates-and-maintenance/patching-your-os.md

+sidebar_position: 1
+---
+
+# Patching your OS


I really think that chrony belongs here. Can we add a section?

enti and others added 7 commits May 13, 2025 22:52

feat(docs): add CSM Guide multi-instance

9a1038c

Merge pull request #1 from eenti/feature/csm-guide

82271f9

feat(docs): add CSM Guide multi-instance

new pages

f4cef0d

Import al pages

7a24f6e

Need to proof-read and solve minor issues. But al pages are imported.

Removed unused pictures

184eb26

QA fixes

5f5721c

cosmetic changes and fixes to system2 method 2

3a20db2

eenti requested a review from a team as a code owner May 21, 2025 18:54

dgusakov reviewed May 22, 2025

View reviewed changes

package.json Outdated Show resolved Hide resolved

eenti added 2 commits May 22, 2025 14:35

Update package.json

66fac1d

Fix broken CSM links in key-generation-for-testnet and intro

da6d3a0

samuelclk and others added 3 commits May 23, 2025 12:50

Update community-tips.md

95c2b1e

migrate guides from main to guides

738c2aa

Merge branch 'main' of github.com:eenti/lido-docs

3c8c57f

dgusakov requested changes Jun 11, 2025

View reviewed changes

eenti and others added 8 commits June 11, 2025 09:26

Apply suggestions from code review

16ebdef

Co-authored-by: Dmitry Gusakov <[email protected]>

Update upload-remove-view-validator-keys.md

f7fee02

Replace ls with find to capture more edge cases

Update method-2-configure-csm-fee-recipient-on-separate-validator-cli…

3fc6d52

…ent.md updated validator keystore file paths

Update method-2-configure-csm-fee-recipient-on-separate-validator-cli…

7bc4845

…ent.md

Update method-1-configure-csm-fee-recipient-on-validator-keys.md

7f7b60c

Update method-1-configure-csm-fee-recipient-on-validator-keys.md

31257f7

fix multiple comments

284e0db

small fix for page key generation for mainnet

e1079af

dgusakov reviewed Jun 13, 2025

View reviewed changes


		Here, you will see your net rewards and bond claimable in aggregate and broken down into its individual parts. Note that `Locked bond` is also deducted from your aggregate rewards here.

		You will also be able to claim your net rewards + bond in total or in individual parts if you wish, and select among 3 token types to receive: ETH / stETH / wstETH.


		# Run on Lido

		This section of the Lido documentation is for users wanting to run any of the Lido products, whether Node Operators, Vault managers or Oracle Operators.

	\| Mainnet: [csm.lido.fi](https://csm.lido.fi/)<br />Hoodi Testnet: [csm.testnet.fi](https://csm.testnet.fi/) \| This is where you connect your wallet, upload keys, provide and withdraw bonds, and claim rewards. \|
	\| [CSM UI on Mainnet](https://csm.lido.fi/)<br /> [CSM UI on Hoodi Testnet](https://csm.testnet.fi/) \| This is where you connect your wallet, upload keys, provide and withdraw bonds, and claim rewards. \|

	Machines purchased from the Dappnode store are plug-and-play. If you’re installing on your own hardware, it must run Debian. Follow the official Debian installer guide [here](https://www.debian.org/devel/debian-installer/).
	Machines purchased from the [Dappnode store](https://dappnode.com/) are plug-and-play. If you’re installing it on your own hardware, it must run on Debian. Follow the official Debian installer guide [here](https://www.debian.org/devel/debian-installer/).

	Keys that have been deposited cannot be deleted and only can be exited.
	Keys that have been deposited cannot be deleted and can only be exited from the Consensus Layer.

		1. To use the hosted version, click [here for Mainnet](https://t.me/CSMSentinel_bot) or here for [Hoodi](https://t.me/CSMSentinelHoodi_bot)
		Search for the "CSM Sentinel" bot on Telegram and open a chat with it

	2. Wait for the validator key to be fully exited on the beacon chain. Check your validator ID pubkey on [beaconcha.in](https://beaconcha.in/).
	2. Wait for the validator key to be fully exited on the beacon chain. Check your validator pubkey on [beaconcha.in](https://beaconcha.in/).

Add "Run on Lido" section and CSM guide for NOs #612

Are you sure you want to change the base?

Add "Run on Lido" section and CSM guide for NOs #612

Conversation

eenti commented May 21, 2025

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

📝 Describe your changes

🔎 Include source of truth for all changes that reference on-chain data (addresses, etc.)

Uh oh!

dgusakov left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

dgusakov commented May 22, 2025

Uh oh!

eenti commented May 22, 2025

Uh oh!

eenti commented May 22, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!