Rocketpool Rewards

Rocket Pool — Rewards

Quick Start

Check Current Reward Index

cast call 0xCba5951fc706Fc783b7C142DaE8576Ebe29c41FD "getRewardIndex()(uint256)" --rpc-url https://ethereum-rpc.publicnode.com

Check Pending RPL Rewards

cast call 0xCba5951fc706Fc783b7C142DaE8576Ebe29c41FD "getPendingRPLRewards()(uint256)" --rpc-url https://ethereum-rpc.publicnode.com

Check Smoothing Pool Balance

cast balance 0xd4E96eF8eee8678dBFf4d535E033Ed1a4F7605b7 --rpc-url https://ethereum-rpc.publicnode.com

Workflow

1. Look up the contract address from references/addresses.json
2. Find the function signature below
3. Load the ABI from assets/abis/<contractName>.json if needed for complex types
4. Execute via cast call (read) or cast send (write)

Network Configuration

Architecture

• RocketStorage is the central registry — all contracts resolve each other's addresses through it
• All ETH values are in wei (18 decimals); all percentages are 18-decimal fixed point (1e18 = 100%)
• Merkle proofs are generated off-chain by the oDAO and published to IPFS

rocketRewardsPool

Manages the periodic RPL and ETH rewards distribution to node operators, the oDAO, and the protocol DAO.

Functions

Reward cycle info:

getRewardIndex() → uint256 [view]
getClaimIntervalTime() → uint256 [view]
getClaimIntervalTimeStart() → uint256 [view]
getClaimIntervalsPassed() → uint256 [view]

Pending rewards:

getPendingRPLRewards() → uint256 [view]
getPendingETHRewards() → uint256 [view]
getPendingVoterShare() → uint256 [view]
getRPLBalance() → uint256 [view]
getEthBalance() → uint256 [view]

Claiming percentages:

getClaimingContractPerc(string _claimingContract) → uint256 [view]
getClaimingContractsPerc(string[] _claimingContracts) → uint256[] [view]

Oracle DAO submission:

submitRewardSnapshot(tuple _submission)
executeRewardSnapshot(tuple _submission)
getTrustedNodeSubmitted(address _trustedNodeAddress, uint256 _rewardIndex) → bool [view]

Examples

cast call $REWARDS_POOL "getRewardIndex()(uint256)" --rpc-url $RPC_URL
cast call $REWARDS_POOL "getPendingRPLRewards()(uint256)" --rpc-url $RPC_URL
cast call $REWARDS_POOL "getPendingETHRewards()(uint256)" --rpc-url $RPC_URL
cast call $REWARDS_POOL "getClaimIntervalTime()(uint256)" --rpc-url $RPC_URL

rocketMerkleDistributorMainnet

Distributes rewards to node operators via Merkle proofs. Each reward interval generates a Merkle tree.

Functions

claim(address _nodeAddress, tuple[] _claims)
claimAndStake(address _nodeAddress, tuple[] _claims, uint256 _stakeAmount)
isClaimed(uint256 _rewardIndex, address _claimer) → bool [view]
claimOutstandingEth()
getOutstandingEth(address _address) → uint256 [view]

The _claims tuple: (uint256 rewardIndex, uint256 amountRPL, uint256 amountSmoothingPoolETH, uint256 amountVoterETH, bytes32[] merkleProof).

claimAndStake claims rewards and immediately stakes the RPL portion in a single transaction.

Examples

cast call $MERKLE_DIST "isClaimed(uint256,address)(bool)" 42 $NODE_ADDR --rpc-url $RPC_URL

Gotchas

• Multiple reward intervals can be claimed in a single transaction
• claimAndStake is gas-efficient for operators who want to restake RPL rewards

rocketSmoothingPool

Collects MEV and priority fees from opted-in node operators for fair distribution.

Functions

withdrawEther(address _to, uint256 _amount)
version() → uint8 [view]

The smoothing pool receives ETH directly from validators' fee recipients. Distribution is handled by the Merkle distributor.

Examples

cast balance $SMOOTHING_POOL --rpc-url $RPC_URL

rocketClaimDAO

Manages the protocol DAO treasury. Handles recurring payment contracts and one-time spends.

Functions

spend(string _invoiceID, address _recipientAddress, uint256 _amount)
newContract(string _contractName, address _recipientAddress, uint256 _amountPerPeriod, uint256 _periodLength, uint256 _startTime, uint256 _numPeriods)
updateContract(string _contractName, address _recipientAddress, uint256 _amountPerPeriod, uint256 _periodLength, uint256 _numPeriods)
payOutContracts(string[] _contractNames)
payOutContractsAndWithdraw(string[] _contractNames)
getBalance(address _recipientAddress) → uint256 [view]
getContract(string _contractName) → tuple [view]
getContractExists(string _contractName) → bool [view]
withdrawBalance(address _recipientAddress)

rocketDAOProtocolSettingsRewards

Key reward parameters:

getRewardsClaimIntervalTime() → uint256 [view]
getRewardsClaimIntervalPeriods() → uint256 [view]
getRewardsClaimersPerc() → (uint256, uint256, uint256) [view]
getRewardsClaimersNodePerc() → uint256 [view]
getRewardsClaimersTrustedNodePerc() → uint256 [view]
getRewardsClaimersProtocolPerc() → uint256 [view]