StakeWise
Search…
StakeWise
Introduction to StakeWise
FAQ
StakeWise Pool
StakeWise Solo
Tokens
Governance
StakeWise DAO
DAO Treasury
Early Adopters Campaign
Node Operator
Onboarding Process
Generate Deposit Data
StakeWise Infra Package
How to:
Deposit from Ledger
Generate withdrawal credentials
Top-up solo billing account
Verify Pool withdrawal address
Add tokens to wallets like MetaMask
Connect MetaMask to hardware wallets
1INCH: Provide liquidity and farm 1INCH/SWISE
StakeWise Audits
StakeWise Bug Bounty
StakeWise Discord
StakeWise Telegram
StakeWise Twitter
Internals
Smart Contracts
Smart Contracts (Permissioned)
WhiteListManager
Pool
PoolValidators
StakedEthToken
RewardEthToken
MerkleDistributor
Powered By GitBook
RewardEthToken
StakeWise RewardEthToken smart contract details.
The RewardEthToken is an ERC-20 contract. It reflects the rewards accumulated by the stakers in the form of prETH tokens. The tokens are mapped 1 to 1 to ETH.
The total supply of prETH is the amount that is above the effective balance of all the validators registered for the StakeWise Permissioned Pool. ​ ​
Interactions with the RewardEthToken contract are limited only to the addresses included in the WhiteListManager contract.

Checkpoints

Checkpoints are used to keep track of the staker's previously accumulated rewards and calculate the current reward. The checkpoint is updated in the following scenarios:
  • psETH amount has changed. The staker starts earning a bigger or smaller portion of the rewards because he now holds more/less psETH.
  • The staker has transferred the prETH tokens to a different address. The staker will continue earning rewards as usual but his prETH balance will decrease by the amount of transferred prETH.
Every checkpoint stores:
  • rewardPerToken - the number of earned prETH tokens per every psETH token
  • reward - the staker's total prETH balance calculated based on the rewardPerToken

Emission

The Permissioned Pool's rewards are updated periodically by the Oracles contract using the updateTotalRewards function in the RewardEthToken contract. When the total rewards are updated, the new value of rewardPerToken is calculated.
If the rewardPerToken is smaller than the previous value, it means that the Permissioned Pool's validators have received a penalty. Every staker's current reward gets reduced proportionally to their share of the total supply of psETH.
If the rewardPerToken is greater than the previous value, it means that the Permissioned Pool's rewards have increased. The amount of prETH tokens of every psETH holder is then increased based on their share of the total supply of psETH.
The total amount of prETH tokens for each individual staker is calculated based on the following formula when calling the balanceOf function:
rt=rp+rcrc=bc∗(ratec−ratep)r_{t} = r_{p} + r_{c}\\ r_{c} = b_{c} * (rate_{c} - rate_{p})\\
where:

Set Rewards Disabled

In situations where psETH lands in a contract that does not support the redistribution of prETH that it begins to accumulate, StakeWise governance (or Admin) can disable the accrual of prETH to that contract by calling the setRewardsDisabled function in the RewardEthToken contract. The function will divert all the prETH that would be accruing (and unclaimable) from the contract with psETH into the MerkleDistributor contract.
Previous
StakedEthToken
Next
MerkleDistributor
Last modified 1mo ago
Copy link
Contents
Checkpoints
Emission
Set Rewards Disabled