Skip to content

README.md

Latest commit

 

History

History
59 lines (39 loc) · 2.41 KB

README.md

File metadata and controls

59 lines (39 loc) · 2.41 KB
Raw

Staking Modules Logo

Lido Staking Modules

Intro

Smart contracts for the staking modules of the Lido protocol. Three modules ship from this repository and share a common code base:

  • Community Staking Module (CSM) — permissionless module for community stakers. See more in CSM docs.
  • CSM 0x02 — CSM dedicated to validators with the 0x02 withdrawal credentials prefix.
  • Curated Module v2 (CMv2) — next iteration of Lido's curated module. Reuses CSM components to introduce bond-based security, flexible operator classification, improved incentive alignment, and lower governance friction compared to the legacy curated module.

Repository layout

  • src/ — Solidity sources
  • script/ — deploy and helper scripts
  • test/ — Foundry tests
  • artifacts/ — per-chain deployment artifacts (mainnet/, hoodi/, plus latest/ and local/ working dirs)

Getting Started

Prerequisites:

  • Foundry — version pinned in .foundryref.
  • Just 1.24.0 or later.
  • Yarn — 4.1 or later.
  • jq 1.6 or later.
  • OpenBSD-flavored nc (netcat) on some Linux distributions (e.g. Arch) for local fork recipes.

Bootstrap

just deps

Build and run unit tests

just build
just test-unit

Run just --list to see all available recipes.

Utility contracts

The repository also ships a few utilities used for the modules:

  • TwoPhaseFrameConfigUpdate — shifts the Oracle report window by reconfiguring the HashConsensus in a safe manner
  • OneShotCurveSetup — atomically adds a new bond curve and applies its parameter overrides

ICS Assessment

Python utilities for assessing Identified Community Stakers (ICS) eligibility across engagement, experience, and humanity categories live in ics_assessment/. Methodology and scoring are described in the Research Forum post; see ics_assessment/README.md for usage.

Contributing

See the Contributing Guide and repository conventions in AGENTS.md.