RewardVault

This contract is the vault for the Berachain rewards, it handles the staking and rewards accounting of BGT.

This contract is taken from the stable and tested: https://github.com/Synthetixio/synthetix/blob/develop/contracts/StakingRewards.sol We are using this model instead of 4626 because we want to incentivize staying in the vault for x period of time to to be considered a 'miner' and not a 'trader'.

State Variables

MAX_INCENTIVE_RATE

uint256 private constant MAX_INCENTIVE_RATE = 1e36;

SAFE_GAS_LIMIT

uint256 private constant SAFE_GAS_LIMIT = 500_000;

maxIncentiveTokensCount

The maximum count of incentive tokens that can be stored.

uint8 public maxIncentiveTokensCount;

distributor

The address of the distributor contract.

address public distributor;

beaconDepositContract

The BeaconDeposit contract.

IBeaconDeposit public beaconDepositContract;

_delegateStake

mapping(address account => DelegateStake) internal _delegateStake;

_operators

The mapping of accounts to their operators.

mapping(address account => address operator) internal _operators;

incentives

the mapping of incentive token to its incentive data.

mapping(address token => Incentive) public incentives;

whitelistedTokens

The list of whitelisted tokens.

address[] public whitelistedTokens;

Functions

constructor

Note: oz-upgrades-unsafe-allow: constructor

constructor();

initialize

Initialize the vault, this is only callable once and by the factory since its the deployer.

function initialize(
    address _beaconDepositContract,
    address _bgt,
    address _distributor,
    address _stakingToken
)
    external
    initializer;

Parameters

Name	Type	Description
_beaconDepositContract	address
_bgt	address	The address of the BGT token.
_distributor	address	The address of the distributor.
_stakingToken	address	The address of the staking token.

onlyDistributor

modifier onlyDistributor();

onlyOperatorOrUser

modifier onlyOperatorOrUser(address account);

checkSelfStakedBalance

modifier checkSelfStakedBalance(address account, uint256 amount);

onlyWhitelistedToken

modifier onlyWhitelistedToken(address token);

setDistributor

Allows the factory owner to set the contract that is allowed to distribute rewards.

function setDistributor(address _rewardDistribution) external onlyFactoryOwner;

Parameters

Name	Type	Description
_rewardDistribution	address	The address that is allowed to distribute rewards.

notifyRewardAmount

Allows the distributor to notify the reward amount.

function notifyRewardAmount(bytes calldata pubkey, uint256 reward) external onlyDistributor;

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator.
reward	uint256	The amount of reward to notify.

recoverERC20

Allows the factory owner to recover any ERC20 token from the vault.

function recoverERC20(address tokenAddress, uint256 tokenAmount) external onlyFactoryOwner;

Parameters

Name	Type	Description
tokenAddress	address	The address of the token to recover.
tokenAmount	uint256	The amount of token to recover.

setRewardsDuration

Allows the factory owner to update the duration of the rewards.

function setRewardsDuration(uint256 _rewardsDuration) external onlyFactoryOwner;

Parameters

Name	Type	Description
_rewardsDuration	uint256	The new duration of the rewards.

whitelistIncentiveToken

Allows the factory owner to whitelist a token to incentivize with.

function whitelistIncentiveToken(address token, uint256 minIncentiveRate, address manager) external onlyFactoryOwner;

Parameters

Name	Type	Description
token	address	The address of the token to whitelist.
minIncentiveRate	uint256	The minimum amount of the token to incentivize per BGT emission.
manager	address	The address of the manager that can addIncentive for this token.

removeIncentiveToken

Allows the factory vault manager to remove a whitelisted incentive token.

function removeIncentiveToken(address token) external onlyFactoryVaultManager onlyWhitelistedToken(token);

Parameters

Name	Type	Description
token	address	The address of the token to remove.

updateIncentiveManager

Update the manager of an incentive token.

Permissioned function, only allow factory owner to update the manager.

function updateIncentiveManager(
    address token,
    address newManager
)
    external
    onlyFactoryOwner
    onlyWhitelistedToken(token);

Parameters

Name	Type	Description
token	address	The address of the incentive token.
newManager	address	The new manager of the incentive token.

setMaxIncentiveTokensCount

Allows the factory owner to update the maxIncentiveTokensCount.

function setMaxIncentiveTokensCount(uint8 _maxIncentiveTokensCount) external onlyFactoryOwner;

Parameters

Name	Type	Description
_maxIncentiveTokensCount	uint8	The new maxIncentiveTokens count.

pause

Allows the factory vault pauser to pause the vault.

function pause() external onlyFactoryVaultPauser;

unpause

Allows the factory vault manager to unpause the vault.

function unpause() external onlyFactoryVaultManager;

operator

Get the operator for an account.

function operator(address account) external view returns (address);

Parameters

Name	Type	Description
account	address	The account to get the operator for.

Returns

Name	Type	Description
<none>	address	The operator for the account.

getWhitelistedTokensCount

Get the count of active incentive tokens.

function getWhitelistedTokensCount() external view returns (uint256);

Returns

Name	Type	Description
<none>	uint256	The count of active incentive tokens.

getWhitelistedTokens

Get the list of whitelisted tokens.

function getWhitelistedTokens() public view returns (address[] memory);

Returns

Name	Type	Description
<none>	address[]	The list of whitelisted tokens.

getTotalDelegateStaked

Get the total amount staked by delegates.

function getTotalDelegateStaked(address account) external view returns (uint256);

Returns

Name	Type	Description
<none>	uint256	The total amount staked by delegates.

getDelegateStake

Get the amount staked by a delegate on behalf of an account.

function getDelegateStake(address account, address delegate) external view returns (uint256);

Returns

Name	Type	Description
<none>	uint256	The amount staked by a delegate.

stake

Stake tokens in the vault.

function stake(uint256 amount) external nonReentrant whenNotPaused;

Parameters

Name	Type	Description
amount	uint256	The amount of tokens to stake.

delegateStake

Stake tokens on behalf of another account.

function delegateStake(address account, uint256 amount) external nonReentrant whenNotPaused;

Parameters

Name	Type	Description
account	address	The account to stake for.
amount	uint256	The amount of tokens to stake.

withdraw

Withdraw the staked tokens from the vault.

function withdraw(uint256 amount) external nonReentrant checkSelfStakedBalance(msg.sender, amount);

Parameters

Name	Type	Description
amount	uint256	The amount of tokens to withdraw.

delegateWithdraw

Withdraw tokens staked on behalf of another account by the delegate (msg.sender).

function delegateWithdraw(address account, uint256 amount) external nonReentrant;

Parameters

Name	Type	Description
account	address	The account to withdraw for.
amount	uint256	The amount of tokens to withdraw.

getReward

Claim the reward.

The operator only handles BGT, not STAKING_TOKEN.

function getReward(
    address account,
    address recipient
)
    external
    nonReentrant
    onlyOperatorOrUser(account)
    returns (uint256);

Parameters

Name	Type	Description
account	address	The account to get the reward for.
recipient	address	The address to send the reward to.

Returns

Name	Type	Description
<none>	uint256	The amount of the reward claimed.

exit

Exit the vault with the staked tokens and claim the reward.

Only the account holder can call this function, not the operator.

function exit(address recipient) external nonReentrant;

Parameters

Name	Type	Description
recipient	address	The address to send the 'BGT' reward to.

setOperator

Allows msg.sender to set another address to claim and manage their rewards.

function setOperator(address _operator) external;

Parameters

Name	Type	Description
_operator	address	The address that will be allowed to claim and manage rewards.

addIncentive

Add an incentive token to the vault.

Permissioned function, only callable by incentive token manager.

function addIncentive(
    address token,
    uint256 amount,
    uint256 incentiveRate
)
    external
    nonReentrant
    onlyWhitelistedToken(token);

Parameters

Name	Type	Description
token	address	The address of the token to add as an incentive.
amount	uint256	The amount of the token to add as an incentive.
incentiveRate	uint256	The amount of the token to incentivize per BGT emission.

_checkSelfStakedBalance

Check if the account has enough self-staked balance.

function _checkSelfStakedBalance(address account, uint256 amount) internal view;

Parameters

Name	Type	Description
account	address	The account to check the self-staked balance for.
amount	uint256	The amount being withdrawn.

_safeTransferRewardToken

The Distributor grants this contract the allowance to transfer the BGT in its balance.

function _safeTransferRewardToken(address to, uint256 amount) internal override;

_checkRewardSolvency

function _checkRewardSolvency() internal view override;

_processIncentives

process the incentives for a validator.

If a token transfer consumes more than 500k gas units, the transfer alone will fail.

function _processIncentives(bytes calldata pubkey, uint256 bgtEmitted) internal;

Parameters

Name	Type	Description
pubkey	bytes	The pubkey of the validator to process the incentives for.
bgtEmitted	uint256	The amount of BGT emitted by the validator.

_deleteWhitelistedTokenFromList

function _deleteWhitelistedTokenFromList(address token) internal;

Structs

DelegateStake

Struct to hold delegate stake data.

struct DelegateStake {
    uint256 delegateTotalStaked;
    mapping(address delegate => uint256 amount) stakedByDelegate;
}

Properties

Name	Type	Description
delegateTotalStaked	uint256	The total amount staked by delegates.
stakedByDelegate	mapping(address delegate => uint256 amount)	The mapping of the amount staked by each delegate.

Incentive

Struct to hold an incentive data.

struct Incentive {
    uint256 minIncentiveRate;
    uint256 incentiveRate;
    uint256 amountRemaining;
    address manager;
}

Properties

Name	Type	Description
minIncentiveRate	uint256	The minimum amount of the token to incentivize per BGT emission.
incentiveRate	uint256	The amount of the token to incentivize per BGT emission.
amountRemaining	uint256	The amount of the token remaining to incentivize.
manager	address	The address of the manager that can addIncentive for this incentive token.