RewardVault
The RewardVault contract is the main Proof of Liquidity integration point for network incentives, handling the staking (of LP tokens) and rewards accounting of $BGT.
Rewards calculation is inspired by the battle-tested Synthetix StakingRewards Contract.
Functions
distributor
Get the address that is allowed to distribute rewards.
function distributor() external view returns (address);Returns
| Name | Type | Description |
|---|---|---|
<none> | address | The address that is allowed to distribute rewards. |
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() external 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. |
initialize
Initialize the vault, this is only callable once and by the factory since its the deployer.
function initialize(address _berachef, address _bgt, address _distributor, address _stakingToken) external;Parameters
| Name | Type | Description |
|---|---|---|
_berachef | address | The address of the berachef. |
_bgt | address | The address of the BGT token. |
_distributor | address | The address of the distributor. |
_stakingToken | address | The address of the staking token. |
setDistributor
Allows the owner to set the contract that is allowed to distribute rewards.
function setDistributor(address _rewardDistribution) external;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;Parameters
| Name | Type | Description |
|---|---|---|
pubkey | bytes | The pubkey of the validator. |
reward | uint256 | The amount of reward to notify. |
recoverERC20
Allows the owner to recover any ERC20 token from the vault.
function recoverERC20(address tokenAddress, uint256 tokenAmount) external;Parameters
| Name | Type | Description |
|---|---|---|
tokenAddress | address | The address of the token to recover. |
tokenAmount | uint256 | The amount of token to recover. |
setRewardsDuration
Allows the owner to update the duration of the rewards.
function setRewardsDuration(uint256 _rewardsDuration) external;Parameters
| Name | Type | Description |
|---|---|---|
_rewardsDuration | uint256 | The new duration of the rewards. |
whitelistIncentiveToken
Allows the owner to whitelist a token to incentivize with.
function whitelistIncentiveToken(address token, uint256 minIncentiveRate, address manager) external;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 owner to remove a whitelisted incentive token.
function removeIncentiveToken(address token) external;Parameters
| Name | Type | Description |
|---|---|---|
token | address | The address of the token to remove. |
setMaxIncentiveTokensCount
Allows the owner to update the maxIncentiveTokensCount.
function setMaxIncentiveTokensCount(uint8 _maxIncentiveTokensCount) external;Parameters
| Name | Type | Description |
|---|---|---|
_maxIncentiveTokensCount | uint8 | The new maxIncentiveTokens count. |
pause
Allows the owner to pause the vault.
function pause() external;unpause
Allows the owner to unpause the vault.
function unpause() external;exit
Exit the vault with the staked tokens and claim the reward.
Only the account holder can call this function, not the operator.
Clears out the user self-staked balance and rewards.
function exit(address recipient) external;Parameters
| Name | Type | Description |
|---|---|---|
recipient | address | The address to send the 'BGT' reward to. |
getReward
Claim the reward.
The operator only handles BGT, not STAKING_TOKEN.
Callable by the operator or the account holder.
function getReward(address account, address recipient) external 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. |
stake
Stake tokens in the vault.
function stake(uint256 amount) external;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;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;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;Parameters
| Name | Type | Description |
|---|---|---|
account | address | The account to withdraw for. |
amount | uint256 | The amount of tokens to withdraw. |
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. |
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;Parameters
| Name | Type | Description |
|---|---|---|
token | address | The address of the incentive token. |
newManager | address | The new manager of the incentive token. |
addIncentive
Add an incentive token to the vault.
The incentive token's transfer should not exceed a gas usage of 500k units. In case the transfer exceeds 500k gas units, your incentive will fail to be transferred to the validator and its delegates.
Permissioned function, only callable by incentive token manager.
function addIncentive(address token, uint256 amount, uint256 incentiveRate) external;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. |
Events
DelegateStaked
Emitted when a delegate has staked on behalf of an account.
event DelegateStaked(address indexed account, address indexed delegate, uint256 amount);Parameters
| Name | Type | Description |
|---|---|---|
account | address | The account whose delegate has staked. |
delegate | address | The delegate that has staked. |
amount | uint256 | The amount of staked tokens. |
DelegateWithdrawn
Emitted when a delegate has withdrawn on behalf of an account.
event DelegateWithdrawn(address indexed account, address indexed delegate, uint256 amount);Parameters
| Name | Type | Description |
|---|---|---|
account | address | The account whose delegate has withdrawn. |
delegate | address | The delegate that has withdrawn. |
amount | uint256 | The amount of withdrawn tokens. |
Recovered
Emitted when a token has been recovered.
event Recovered(address token, uint256 amount);Parameters
| Name | Type | Description |
|---|---|---|
token | address | The token that has been recovered. |
amount | uint256 | The amount of token recovered. |
OperatorSet
Emitted when the msg.sender has set an operator to handle its rewards.
event OperatorSet(address account, address operator);Parameters
| Name | Type | Description |
|---|---|---|
account | address | The account that has set the operator. |
operator | address | The operator that has been set. |
DistributorSet
Emitted when the distributor is set.
event DistributorSet(address indexed distributor);Parameters
| Name | Type | Description |
|---|---|---|
distributor | address | The address of the distributor. |
IncentiveManagerChanged
Emitted when the manager of an incentive token is changed.
event IncentiveManagerChanged(address indexed token, address newManager, address oldManager);Parameters
| Name | Type | Description |
|---|---|---|
token | address | The address of the incentive token. |
newManager | address | The new manager of the incentive token. |
oldManager | address | The old manager of the incentive token. |
IncentiveTokenWhitelisted
Emitted when an incentive token is whitelisted.
event IncentiveTokenWhitelisted(address indexed token, uint256 minIncentiveRate, address manager);Parameters
| Name | Type | Description |
|---|---|---|
token | address | The address of the token that has been whitelisted. |
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 incentive token. |
IncentiveTokenRemoved
Emitted when an incentive token is removed.
event IncentiveTokenRemoved(address indexed token);Parameters
| Name | Type | Description |
|---|---|---|
token | address | The address of the token that has been removed. |
MaxIncentiveTokensCountUpdated
Emitted when maxIncentiveTokensCount is updated.
event MaxIncentiveTokensCountUpdated(uint8 maxIncentiveTokensCount);Parameters
| Name | Type | Description |
|---|---|---|
maxIncentiveTokensCount | uint8 | The max count of incentive tokens. |
IncentivesProcessed
Emitted when incentives are processed for the operator of a validator.
event IncentivesProcessed(bytes indexed pubkey, address indexed token, uint256 bgtEmitted, uint256 amount);IncentivesProcessFailed
Emitted when incentives fail to be processed for the operator of a validator.
event IncentivesProcessFailed(bytes indexed pubkey, address indexed token, uint256 bgtEmitted, uint256 amount);IncentiveAdded
Emitted when incentives are added to the vault.
event IncentiveAdded(address indexed token, address sender, uint256 amount, uint256 incentiveRate);Parameters
| Name | Type | Description |
|---|---|---|
token | address | The incentive token. |
sender | address | The address that added the incentive. |
amount | uint256 | The amount of the incentive. |
incentiveRate | uint256 | The amount of the token to incentivize per BGT emission. |