Skip to content

Latest commit

 

History

History
642 lines (430 loc) · 16.9 KB

File metadata and controls

642 lines (430 loc) · 16.9 KB
layout title
default
RewardControl

RewardControl.sol

View Source: contracts/RewardControl.sol

↗ Extends: RewardControlStorage, RewardControlInterface, ExponentialNoError

****

Events

event AlkSpeedUpdated(address indexed market, uint256  newSpeed, bool  isVerified);
event DistributedSupplierAlk(address indexed market, address indexed supplier, uint256  supplierDelta, uint256  supplierAccruedAlk, uint256  supplyIndexMantissa, bool  isVerified);
event DistributedBorrowerAlk(address indexed market, address indexed borrower, uint256  borrowerDelta, uint256  borrowerAccruedAlk, uint256  borrowIndexMantissa, bool  isVerified);
event TransferredAlk(address indexed participant, uint256  participantAccrued, address  market, bool  isVerified);
event OwnerUpdate(address indexed owner, address indexed newOwner);
event MarketAdded(address indexed market, uint256  numberOfMarkets, bool  isVerified);
event MarketRemoved(address indexed market, uint256  numberOfMarkets, bool  isVerified);

Modifiers

  • onlyOwner

onlyOwner

Make sure that the sender is only the owner of the contract

modifier onlyOwner() internal

Arguments

Name Type Description

Functions

  • initializer(address _owner, address _alkemiEarnVerified, address _alkemiEarnPublic, address _alkAddress)
  • refreshAlkSupplyIndex(address market, address supplier, bool isVerified)
  • refreshAlkBorrowIndex(address market, address borrower, bool isVerified)
  • claimAlk(address holder)
  • claimAlk(address holder, address market, bool isVerified)
  • refreshMarketLiquidity()
  • refreshAlkSpeeds()
  • updateAlkSupplyIndex(address market, bool isVerified)
  • updateAlkBorrowIndex(address market, bool isVerified)
  • distributeSupplierAlk(address market, address supplier, bool isVerified)
  • distributeBorrowerAlk(address market, address borrower, bool isVerified)
  • claimAlk(address holder, address[] markets, bool isVerified)
  • transferAlk(address participant, uint256 participantAccrued, address market, bool isVerified)
  • getBlockNumber()
  • getAlkAccrued(address participant)
  • getAlkAddress()
  • getAlkemiEarnAddress()
  • getMarketStats(address market, bool isVerified)
  • getMarketTotalSupply(address market, bool isVerified)
  • getMarketTotalBorrows(address market, bool isVerified)
  • getSupplyBalance(address market, address supplier, bool isVerified)
  • getBorrowBalance(address market, address borrower, bool isVerified)
  • transferOwnership(address _newOwner)
  • acceptOwnership()
  • addMarket(address market, bool isVerified)
  • removeMarket(uint256 id, bool isVerified)
  • setAlkAddress(address _alkAddress)
  • setAlkemiEarnVerifiedAddress(address _alkemiEarnVerified)
  • setAlkemiEarnPublicAddress(address _alkemiEarnPublic)
  • setAlkRate(uint256 _alkRate)
  • getAlkRewards(address user)
  • getSupplyAlkRewards(struct ExponentialNoError.Exp totalLiquidity, struct ExponentialNoError.Exp[] marketTotalLiquidity, address user, uint256 i, uint256 j, bool isVerified)
  • getBorrowAlkRewards(struct ExponentialNoError.Exp totalLiquidity, struct ExponentialNoError.Exp[] marketTotalLiquidity, address user, uint256 i, uint256 j, bool isVerified)

initializer

RewardControl is the contract to calculate and distribute reward tokens

function initializer(address _owner, address _alkemiEarnVerified, address _alkemiEarnPublic, address _alkAddress) public nonpayable

Arguments

Name Type Description
_owner address
_alkemiEarnVerified address
_alkemiEarnPublic address
_alkAddress address

refreshAlkSupplyIndex

⤾ overrides RewardControlInterface.refreshAlkSupplyIndex

Refresh ALK supply index for the specified market and supplier

function refreshAlkSupplyIndex(address market, address supplier, bool isVerified) external nonpayable

Arguments

Name Type Description
market address The market whose supply index to update
supplier address The address of the supplier to distribute ALK to
isVerified bool Specifies if the market is from verified or public protocol

refreshAlkBorrowIndex

⤾ overrides RewardControlInterface.refreshAlkBorrowIndex

Refresh ALK borrow index for the specified market and borrower

function refreshAlkBorrowIndex(address market, address borrower, bool isVerified) external nonpayable

Arguments

Name Type Description
market address The market whose borrow index to update
borrower address The address of the borrower to distribute ALK to
isVerified bool Specifies if the market is from verified or public protocol

claimAlk

⤾ overrides RewardControlInterface.claimAlk

Claim all the ALK accrued by holder in all markets

function claimAlk(address holder) external nonpayable

Arguments

Name Type Description
holder address The address to claim ALK for

claimAlk

⤾ overrides RewardControlInterface.claimAlk

Claim all the ALK accrued by holder by refreshing the indexes on the specified market only

function claimAlk(address holder, address market, bool isVerified) external nonpayable

Arguments

Name Type Description
holder address The address to claim ALK for
market address The address of the market to refresh the indexes for
isVerified bool Specifies if the market is from verified or public protocol

refreshMarketLiquidity

Recalculate and update ALK speeds for all markets

function refreshMarketLiquidity() internal view
returns(struct ExponentialNoError.Exp[], struct ExponentialNoError.Exp)

Arguments

Name Type Description

refreshAlkSpeeds

Recalculate and update ALK speeds for all markets

function refreshAlkSpeeds() public nonpayable

Arguments

Name Type Description

updateAlkSupplyIndex

Accrue ALK to the market by updating the supply index

function updateAlkSupplyIndex(address market, bool isVerified) public nonpayable

Arguments

Name Type Description
market address The market whose supply index to update
isVerified bool Verified / Public protocol

updateAlkBorrowIndex

Accrue ALK to the market by updating the borrow index

function updateAlkBorrowIndex(address market, bool isVerified) public nonpayable

Arguments

Name Type Description
market address The market whose borrow index to update
isVerified bool Verified / Public protocol

distributeSupplierAlk

Calculate ALK accrued by a supplier and add it on top of alkAccrued[supplier]

function distributeSupplierAlk(address market, address supplier, bool isVerified) public nonpayable

Arguments

Name Type Description
market address The market in which the supplier is interacting
supplier address The address of the supplier to distribute ALK to
isVerified bool Verified / Public protocol

distributeBorrowerAlk

Calculate ALK accrued by a borrower and add it on top of alkAccrued[borrower]

function distributeBorrowerAlk(address market, address borrower, bool isVerified) public nonpayable

Arguments

Name Type Description
market address The market in which the borrower is interacting
borrower address The address of the borrower to distribute ALK to
isVerified bool Verified / Public protocol

claimAlk

Claim all the ALK accrued by holder in the specified markets

function claimAlk(address holder, address[] markets, bool isVerified) internal nonpayable

Arguments

Name Type Description
holder address The address to claim ALK for
markets address[] The list of markets to claim ALK in
isVerified bool Verified / Public protocol

transferAlk

Transfer ALK to the participant

function transferAlk(address participant, uint256 participantAccrued, address market, bool isVerified) internal nonpayable
returns(uint256)

Returns

The amount of ALK which was NOT transferred to the participant

Arguments

Name Type Description
participant address The address of the participant to transfer ALK to
participantAccrued uint256 The amount of ALK to (possibly) transfer
market address Market for which ALK is transferred
isVerified bool Verified / Public Protocol

getBlockNumber

Get the current block number

function getBlockNumber() public view
returns(uint256)

Returns

The current block number

Arguments

Name Type Description

getAlkAccrued

Get the current accrued ALK for a participant

function getAlkAccrued(address participant) public view
returns(uint256)

Returns

The amount of accrued ALK for the participant

Arguments

Name Type Description
participant address The address of the participant

getAlkAddress

Get the address of the ALK token

function getAlkAddress() public view
returns(address)

Returns

The address of ALK token

Arguments

Name Type Description

getAlkemiEarnAddress

Get the address of the underlying AlkemiEarnVerified and AlkemiEarnPublic contract

function getAlkemiEarnAddress() public view
returns(address, address)

Returns

The address of the underlying AlkemiEarnVerified and AlkemiEarnPublic contract

Arguments

Name Type Description

getMarketStats

Get market statistics from the AlkemiEarnVerified contract

function getMarketStats(address market, bool isVerified) public view
returns(isSupported bool, blockNumber uint256, interestRateModel address, totalSupply uint256, supplyRateMantissa uint256, supplyIndex uint256, totalBorrows uint256, borrowRateMantissa uint256, borrowIndex uint256)

Returns

Market statistics for the given market

Arguments

Name Type Description
market address The address of the market
isVerified bool Verified / Public protocol

getMarketTotalSupply

Get market total supply from the AlkemiEarnVerified / AlkemiEarnPublic contract

function getMarketTotalSupply(address market, bool isVerified) public view
returns(uint256)

Returns

Market total supply for the given market

Arguments

Name Type Description
market address The address of the market
isVerified bool Verified / Public protocol

getMarketTotalBorrows

Get market total borrows from the AlkemiEarnVerified contract

function getMarketTotalBorrows(address market, bool isVerified) public view
returns(uint256)

Returns

Market total borrows for the given market

Arguments

Name Type Description
market address The address of the market
isVerified bool Verified / Public protocol

getSupplyBalance

Get supply balance of the specified market and supplier

function getSupplyBalance(address market, address supplier, bool isVerified) public view
returns(uint256)

Returns

Supply balance of the specified market and supplier

Arguments

Name Type Description
market address The address of the market
supplier address The address of the supplier
isVerified bool Verified / Public protocol

getBorrowBalance

Get borrow balance of the specified market and borrower

function getBorrowBalance(address market, address borrower, bool isVerified) public view
returns(uint256)

Returns

Borrow balance of the specified market and borrower

Arguments

Name Type Description
market address The address of the market
borrower address The address of the borrower
isVerified bool Verified / Public protocol

transferOwnership

Transfer the ownership of this contract to the new owner. The ownership will not be transferred until the new owner accept it.

function transferOwnership(address _newOwner) external nonpayable onlyOwner

Arguments

Name Type Description
_newOwner address The address of the new owner

acceptOwnership

Accept the ownership of this contract by the new owner

function acceptOwnership() external nonpayable

Arguments

Name Type Description

addMarket

Add new market to the reward program

function addMarket(address market, bool isVerified) external nonpayable onlyOwner

Arguments

Name Type Description
market address The address of the new market to be added to the reward program
isVerified bool Verified / Public protocol

removeMarket

Remove a market from the reward program based on array index

function removeMarket(uint256 id, bool isVerified) external nonpayable onlyOwner

Arguments

Name Type Description
id uint256 The index of the allMarkets array to be removed
isVerified bool Verified / Public protocol

setAlkAddress

Set ALK token address

function setAlkAddress(address _alkAddress) external nonpayable onlyOwner

Arguments

Name Type Description
_alkAddress address The ALK token address

setAlkemiEarnVerifiedAddress

Set AlkemiEarnVerified contract address

function setAlkemiEarnVerifiedAddress(address _alkemiEarnVerified) external nonpayable onlyOwner

Arguments

Name Type Description
_alkemiEarnVerified address The AlkemiEarnVerified contract address

setAlkemiEarnPublicAddress

Set AlkemiEarnPublic contract address

function setAlkemiEarnPublicAddress(address _alkemiEarnPublic) external nonpayable onlyOwner

Arguments

Name Type Description
_alkemiEarnPublic address The AlkemiEarnVerified contract address

setAlkRate

Set ALK rate

function setAlkRate(uint256 _alkRate) external nonpayable onlyOwner

Arguments

Name Type Description
_alkRate uint256 The ALK rate

getAlkRewards

Get latest ALK rewards

function getAlkRewards(address user) external view
returns(uint256)

Arguments

Name Type Description
user address the supplier/borrower

getSupplyAlkRewards

Get latest Supply ALK rewards

function getSupplyAlkRewards(struct ExponentialNoError.Exp totalLiquidity, struct ExponentialNoError.Exp[] marketTotalLiquidity, address user, uint256 i, uint256 j, bool isVerified) internal view
returns(uint256)

Arguments

Name Type Description
totalLiquidity struct ExponentialNoError.Exp Total Liquidity of all markets
marketTotalLiquidity struct ExponentialNoError.Exp[] Array of individual market liquidity
user address the supplier
i uint256 index of the market in marketTotalLiquidity array
j uint256 index of the market in the verified/public allMarkets array
isVerified bool Verified / Public protocol

getBorrowAlkRewards

Get latest Borrow ALK rewards

function getBorrowAlkRewards(struct ExponentialNoError.Exp totalLiquidity, struct ExponentialNoError.Exp[] marketTotalLiquidity, address user, uint256 i, uint256 j, bool isVerified) internal view
returns(uint256)

Arguments

Name Type Description
totalLiquidity struct ExponentialNoError.Exp Total Liquidity of all markets
marketTotalLiquidity struct ExponentialNoError.Exp[] Array of individual market liquidity
user address the borrower
i uint256 index of the market in marketTotalLiquidity array
j uint256 index of the market in the verified/public allMarkets array
isVerified bool Verified / Public protocol