RewardsDistributor
`RewardsDistributor`
Contract used to configure, track and distribute rewards to users based on their actions (borrows and supplies) in the protocol. Users can receive additional rewards through a RewardsDistributor
. Each RewardsDistributor
proxy is initialized with a specific reward token and Comptroller
, which can then distribute the reward token to users that supply or borrow in the associated pool. Authorized users can set the reward token borrow and supply speeds for each market in the pool. This sets a fixed amount of reward token to be released each block for borrowers and suppliers, which is distributed based on a user’s percentage of the borrows or supplies respectively. The owner can also set up reward distributions to contributor addresses (distinct from suppliers and borrowers) by setting their contributor reward token speed, which similarly allocates a fixed amount of reward token per block.
The owner has the ability to transfer any amount of reward tokens held by the contract to any other address. Rewards are not distributed automatically and must be claimed by a user calling claimRewardToken()
. Users should be aware that it is up to the owner and other centralized entities to ensure that the RewardsDistributor
holds enough tokens to distribute the accumulated rewards of users and contributors.
Solidity API
struct RewardToken {
uint224 index;
uint32 block;
uint32 lastRewardingBlock;
}
INITIAL_INDEX
The initial REWARD TOKEN index for a market
uint224 INITIAL_INDEX
rewardTokenSupplyState
The REWARD TOKEN market supply state for each market
mapping(address => struct RewardsDistributor.RewardToken) rewardTokenSupplyState
rewardTokenSupplierIndex
The REWARD TOKEN borrow index for each market for each supplier as of the last time they accrued REWARD TOKEN
mapping(address => mapping(address => uint256)) rewardTokenSupplierIndex
rewardTokenAccrued
The REWARD TOKEN accrued but not yet transferred to each user
mapping(address => uint256) rewardTokenAccrued
rewardTokenBorrowSpeeds
The rate at which rewardToken is distributed to the corresponding borrow market (per block)
mapping(address => uint256) rewardTokenBorrowSpeeds
rewardTokenSupplySpeeds
The rate at which rewardToken is distributed to the corresponding supply market (per block)
mapping(address => uint256) rewardTokenSupplySpeeds
rewardTokenBorrowState
The REWARD TOKEN market borrow state for each market
mapping(address => struct RewardsDistributor.RewardToken) rewardTokenBorrowState
rewardTokenContributorSpeeds
The portion of REWARD TOKEN that each contributor receives per block
mapping(address => uint256) rewardTokenContributorSpeeds
lastContributorBlock
Last block at which a contributor's REWARD TOKEN rewards have been allocated
mapping(address => uint256) lastContributorBlock
rewardTokenBorrowerIndex
The REWARD TOKEN borrow index for each market for each borrower as of the last time they accrued REWARD TOKEN
mapping(address => mapping(address => uint256)) rewardTokenBorrowerIndex
initialize
RewardsDistributor initializer
function initialize(contract Comptroller comptroller_, contract IERC20Upgradeable rewardToken_, uint256 loopsLimit_, address accessControlManager_) external
Parameters
comptroller_
contract Comptroller
Comptroller to attach the reward distributor to
rewardToken_
contract IERC20Upgradeable
Reward token to distribute
loopsLimit_
uint256
Maximum number of iterations for the loops in this contract
accessControlManager_
address
AccessControlManager contract address
distributeBorrowerRewardToken
Calculate reward token accrued by a borrower and possibly transfer it to them Borrowers will begin to accrue after the first interaction with the protocol.
function distributeBorrowerRewardToken(address vToken, address borrower, struct ExponentialNoError.Exp marketBorrowIndex) external
Parameters
vToken
address
The market in which the borrower is interacting
borrower
address
The address of the borrower to distribute REWARD TOKEN to
marketBorrowIndex
struct ExponentialNoError.Exp
The current global borrow index of vToken
grantRewardToken
Transfer REWARD TOKEN to the recipient
function grantRewardToken(address recipient, uint256 amount) external
Parameters
recipient
address
The address of the recipient to transfer REWARD TOKEN to
amount
uint256
The amount of REWARD TOKEN to (possibly) transfer
setRewardTokenSpeeds
Set REWARD TOKEN borrow and supply speeds for the specified markets
function setRewardTokenSpeeds(contract VToken[] vTokens, uint256[] supplySpeeds, uint256[] borrowSpeeds) external
Parameters
vTokens
contract VToken[]
The markets whose REWARD TOKEN speed to update
supplySpeeds
uint256[]
New supply-side REWARD TOKEN speed for the corresponding market
borrowSpeeds
uint256[]
New borrow-side REWARD TOKEN speed for the corresponding market
setLastRewardingBlocks
Set REWARD TOKEN last rewarding block for the specified markets
function setLastRewardingBlocks(contract VToken[] vTokens, uint32[] supplyLastRewardingBlocks, uint32[] borrowLastRewardingBlocks) external
Parameters
vTokens
contract VToken[]
The markets whose REWARD TOKEN last rewarding block to update
supplyLastRewardingBlocks
uint32[]
New supply-side REWARD TOKEN last rewarding block for the corresponding market
borrowLastRewardingBlocks
uint32[]
New borrow-side REWARD TOKEN last rewarding block for the corresponding market
setContributorRewardTokenSpeed
Set REWARD TOKEN speed for a single contributor
function setContributorRewardTokenSpeed(address contributor, uint256 rewardTokenSpeed) external
Parameters
contributor
address
The contributor whose REWARD TOKEN speed to update
rewardTokenSpeed
uint256
New REWARD TOKEN speed for contributor
claimRewardToken
Claim all the rewardToken accrued by holder in all markets
function claimRewardToken(address holder) external
Parameters
holder
address
The address to claim REWARD TOKEN for
setMaxLoopsLimit
Set the limit for the loops can iterate to avoid the DOS
function setMaxLoopsLimit(uint256 limit) external
Parameters
limit
uint256
Limit for the max loops can execute at a time
updateContributorRewards
Calculate additional accrued REWARD TOKEN for a contributor since last accrual
function updateContributorRewards(address contributor) public
Parameters
contributor
address
The address to calculate contributor rewards for
claimRewardToken
Claim all the rewardToken accrued by holder in the specified markets
function claimRewardToken(address holder, contract VToken[] vTokens) public
Parameters
holder
address
The address to claim REWARD TOKEN for
vTokens
contract VToken[]
The list of markets to claim REWARD TOKEN in
Last updated