NodeSet Constellation

Made w/ <3 by {::}

We use Hardhat for development.

Dev Setup

Install dependencies via npm install
nvm use 20 stops Hardhat's warnings about an unsupported NPM version
npx hardhat test runs the test suite. Mocha Test Explorer extension for VSCode is recommended for a better UX while developing.

[!WARNING]
Third-party security reviews for the code in this repository are ongoing. We do not recommend using it in production until after audits are complete.

A brief overview...

This repository contains Solidity smart contracts and assocated tests for Constellation, a second layer liquid staking protocol built on top of Rocket Pool. The protocol involves the creation and management of node operators, minipools, and token vaults, with integrated staking and reward distribution mechanisms.

Protocol Contracts

PriceFetcher.sol

Fetches and provides the price of ETH denominated in RPL using Uniswap V3 and a fallback mechanism to an oracle

Whitelist.sol

Manages a list of approved node operators and their controllers

PoAConstellationOracle.sol

Uses proof-of-authority to allow updates to the total yield accrued using ECDSA signatures

RocketpoolEncoder.sol

A library for generating keccak256 identifiers for Rocket Pool contracts

Errors.sol

Defines custom error messages for the protocol

Constants.sol

Defines constants for roles, directory errors, whitelist errors, treasury errors, and operator distributor errors

Directory.sol

Holds references to all protocol contracts and manages role mechanisms

WETHVault.sol

An ERC4626 vault for WETH tokens, managing deposits, withdrawals, and rewards distribution

RPLVault.sol

An ERC4626 vault for RPL tokens, managing deposits, withdrawals, and rewards distribution

SuperNodeAccount.sol

Manages node operators and their minipools

OperatorDistributor.sol

Manages distribution and staking of ETH and RPL tokens for node operators

MerkleClaimStreamer.sol

Allows for Rocket Pool merkle claim submission on behalf of Constellation and
"Streams" the rewards from these claims to the rest of the protocol upon receipt

External Contracts

These contracts are not part of the Constellation protocol but still serve important purposes of their own

Treasury.sol

An example contract that a Treasurer might use to manage the earned income
Constellation's contracts do not assume a particular treasury contract -- they only require a payable contract such as this

NodeSetOperatorRewardDistributor.sol

Distributes rewards to a decentralized swarm of operators. Can take in income from any source, not just Constellation
Constellation's contracts do not assume a particular operator reward distribution contract -- they only require a payable contract such as this

Actors

The protocol involves several actors, each with specific roles and incentives to ensure the smooth operation and security of the system.

Node Operators or alternitivaly refered to as Sub-Node Operators

May add themselves to the operator whitelist with the Admin's approval
May remove themselves from the operator whitelist (if they have no active minipools)
Create and manage minipools
Responsible for uptime and performance of their individual node
Collects fees from staking

Admin

Manage protocol configuration to ensure stability
Oversee reward distributions
Ensure security and compliance within the protocol
Develop and update smart contracts
Ensure security and efficiency of the code
Implement new features and upgrades
May set a new Admin
May set a new Oracle provider
Assumed to be a service provider for the Treasurer

Liquid Stakers (Depositors)

Exchange their ETH and RPL for liquid staking tokens
These LSTs earn staking rewards from ETH and RPL

Oracle Providers

Provide accurate and reliable external data to the protocol
Ensure timely updates of the data feeds

Treasurer

Receives protocol-wide fees
May set a new Treasurer
Responsible for using the protocol-wide income to grow the protocol and its ecosystem
The "protocol owner"

nodeset-org / constellation

readme