How ssvlabs/ssv-network works
This repository implements the SSV Network v2.0.0 Solidity protocol. The principal user workflow is interaction with the network proxy to manage operator-backed clusters and validators; the protocol also supports ETH-based cluster accounting, effective-balance updates, SSV staking, and one-way migration of legacy SSV clusters. The README identifies the modular contract layout and capabilities, but no Solidity source excerpts were provided, so internal dispatch and call relationships are not asserted beyond that documentation.
Main entry points: SSVNetwork.sol Network core · SSVClusters.sol Cluster accounting · SSVValidators.sol Validator management · SSVProxy.sol Network proxy
Components 18
Network entry
- Network proxy
contracts/SSVProxy.sol - Network core
contracts/SSVNetwork.sol - Network views
contracts/SSVNetworkViews.sol
Protocol modules
- Cluster accounting
contracts/modules/SSVClusters.sol - Validator management
contracts/modules/SSVValidators.sol - Operator management
contracts/modules/SSVOperators.sol - Operator whitelisting
contracts/modules/SSVOperatorsWhitelist.sol - DAO governance
contracts/modules/SSVDAO.sol - Read views
contracts/modules/SSVViews.sol
Staking and assets
- SSV staking
contracts/modules/SSVStaking.sol - cSSV token
contracts/token/CSSVToken.sol - SSV token
contracts/token/SSVToken.sol - Basic whitelist
contracts/whitelisting/BasicWhitelisting.sol
Shared internals
- Protocol storage
contracts/libraries/storage/SSVStorage.sol - Core library
contracts/libraries/CoreLib.sol - Cluster library
contracts/libraries/ClusterLib.sol - Validator library
contracts/libraries/ValidatorLib.sol
Other components
- Cluster owner
Connections 14
- Cluster owner → Network proxy: calls
README.md - Network proxy → Network core: routes through
README.md - Network core → Cluster accounting: modular logic
README.md - Network core → Validator management: modular logic
README.md - Network core → Operator management: modular logic
README.md - Network core → Operator whitelisting: modular logic
README.md - Network core → DAO governance: modular logic
README.md - Network core → Read views: modular logic
README.md - Network core → SSV staking: modular logic
README.md - Cluster owner → Cluster accounting: manages clusters
README.md - Cluster owner → Validator management: manages validators
README.md - SSV staking → cSSV token: uses staking token
README.md - Cluster accounting → Cluster library: supports accounting
- Validator management → Validator library: supports validation