Skip to content

RewardsDistribution

Description

This contract distributes the inflationary supply rewards after they have been minted. The primary recipient remains the population of OKS stakers, but new ones can be added to receive an allocation of tokens first. These entries can then be modified or removed.

The actual quantity of tokens to inject into the supply each week is passed into distributeRewards by Oikos.mint; how much the quantity is on any given week is determined by the SupplySchedule contract.

Incentivising activities other than staking was first trialed with UniSwap, which was then formalised into SIP-8, resulting in this contract.

Source: RewardsDistribution.sol

Architecture


Inheritance Graph

RewardsDistribution inheritance graph



Libraries


Structs


DistributionData

Stores an address and a quantity of the inflationary tokens to send to it.

Fields

Field Type Description
destination address The address to send a portion of the inflationary supply to.
amount uint The quantity of tokens to send.

Variables


authority

The address authorised to call distributeRewards, which is used only by Oikos.mint.

Type: address public


oikosProxy

The address of the Oikos ProxyERC20 for transferring OKS to distribution recipients and the RewardEscrow contract.

Type: address public


rewardEscrow

The address of the RewardEscrow, where all remaining tokens are sent once other distributions have been made.

Type: address public


feePoolProxy

The address of the FeePool Proxy, which has to be informed how many rewards it has left to distribute once distributions have been made.

Type: address public


distributions

An array of distribution recipients and the amount of OKS each will receive from the weekly inflationary supply.

Type: DistributionData[] public


Functions


constructor

Initialises the addresses of various related contracts, as well as the inherited Owned instance.

Details

Signature

constructor(address _owner, address _authority, address _oikosProxy, address _rewardEscrow, address _feePoolProxy) public

Superconstructors


setOikosProxy

Allows the owner to set the address of the Oikos ProxyERC20.

Details

Signature

setOikosProxy(address _oikosProxy) external

Modifiers


setRewardEscrow

Allows the owner to set the address of the RewardEscrow contract.

Details

Signature

setRewardEscrow(address _rewardEscrow) external

Modifiers


setFeePoolProxy

Allows the owner to set the address of the FeePool Proxy.

Details

Signature

setFeePoolProxy(address _feePoolProxy) external

Modifiers


setAuthority

Allows the owner to set the address of the fee authority.

Details

Signature

setAuthority(address _authority) external

Modifiers


addRewardDistribution

Allows the owner to add new reward distribution recipients.

This function always returns true if it does not revert.

Details

Signature

addRewardDistribution(address destination, uint amount) external returns (bool)

Modifiers

Preconditions

  • destination cannot be the zero address.
  • amount cannot be zero.

Emits


removeRewardDistribution

Removes a distribution recipient from the distributions list at the specified index.

Details

Signature

removeRewardDistribution(uint index) external

Modifiers

Preconditions

  • index must not be past the end of the list.

editRewardDistribution

Modifies a distribution recipient or the quantity to be released to them in the distributions list at the specified index.

This function always returns true if it does not revert.

Details

Signature

editRewardDistribution(uint index, address destination, uint amount) external returns (bool)

Modifiers

Preconditions

  • index must not be past the end of the list.

distributeRewards

Distributes a quantity of new OKS among stakers and other reward recipients as part of supply inflation.

First, for each element d in the distributions list, d.amount OKS is sent to d.destination. The remaining tokens are then transferred to the RewardEscrow contract to be claimed by stakers, and the FeePool is notified of the updated claimable supply.

This function always returns true if it does not revert.

Sufficient OKS Balance

There will always be sufficient OKS in the RewardsDistribution contract to support this operation, since its OKS balance is directly credited the correct number of tokens by Oikos.mint immediately before the only call to this function. Only the Synthetix contract is authorised to execute rewards distribution, and this is the only place new OKS finds its way into the system.

Details

Signature

distributeRewards(uint amount) external returns (bool)

Preconditions

  • msg.sender must be the authority; i.e. the Oikos contract.
  • The rewardEscrow, oikosProxy, and feePoolProxy addresses must all be initialised.
  • The amount to distribute must be nonzero.
  • The OKS balance in RewardsDistribution must not be less than the amount to distribute.

Emits

RewardsDistributed(amount)


distributionsLength

The number of recipients receiving distributions. This is an alias for distributions.length.

Details

Signature

distributionsLength() external view returns (uint)


Events


RewardDistributionAdded

Records that a new recipient was added to the distributions list, and the index they were added at.

Signature: RewardDistributionAdded(uint index, address destination, uint amount)


RewardsDistributed

Records that a quantity of the inflationary rewards have been dispersed among the distributions recipients and the pool of stakers.

Signature: RewardsDistributed(uint amount)