MultiMerkleDistributor

Storage

questRewardToken

mapping(uint256 => address) questRewardToken

Mapping listing the reward token associated to each Quest ID

rewardTokens

mapping(address => bool) rewardTokens

Mapping of tokens this contract is or was distributing

questClosedPeriods

mapping(uint256 => uint256[]) questClosedPeriods

List of Closed QuestPeriods by Quest ID

questMerkleRootPerPeriod

mapping(uint256 => mapping(uint256 => bytes32)) questMerkleRootPerPeriod

Merkle Root for each period of a Quest (indexed by Quest ID)

questRewardsPerPeriod

mapping(uint256 => mapping(uint256 => uint256)) questRewardsPerPeriod

Amount of rewards for each period of a Quest (indexed by Quest ID)

questBoard

address questBoard

Address of the QuestBoard contract

Events

Claimed

event Claimed(uint256 questID, uint256 period, uint256 index, uint256 amount, address rewardToken, address account)

Event emitted when a user Claims

NewQuest

event NewQuest(uint256 questID, address rewardToken)

Event emitted when a New Quest is added

QuestPeriodUpdated

event QuestPeriodUpdated(uint256 questID, uint256 period, bytes32 merkleRoot)

Event emitted when a Period of a Quest is updated (when the Merkle Root is added)

Modifiers

onlyAllowed

modifier onlyAllowed()

Check the caller is either the admin or the QuestBoard contract

Constructor

constructor(address _questBoard) public

View Methods

isClaimed

function isClaimed(uint256 questID, uint256 period, uint256 index) public view returns (bool)

Checks if the rewards were claimed for a user on a given period

Checks if the rewards were claimed for a user (based on the index) on a given period

Parameters

Return Values

getClosedPeriodsByQuests

function getClosedPeriodsByQuests(uint256 questID) external view returns (uint256[])

Returns all current Closed periods for the given Quest ID

Returns all current Closed periods for the given Quest ID

Parameters

Return Values

State-changing Methods

claim

function claim(uint256 questID, uint256 period, uint256 index, address account, uint256 amount, bytes32[] merkleProof) public

Claims the reward for a user for a given period of a Quest

Claims the reward for a user for a given period of a Quest if the correct proof was given

Parameters

ClaimParams

struct ClaimParams {
  uint256 questID;
  uint256 period;
  uint256 index;
  uint256 amount;
  bytes32[] merkleProof;
}

multiClaim

function multiClaim(address account, struct MultiMerkleDistributor.ClaimParams[] claims) external

Claims multiple rewards for a given list

Calls the claim() method for each entry in the claims array

Parameters

claimQuest

function claimQuest(address account, uint256 questID, struct MultiMerkleDistributor.ClaimParams[] claims) external

Claims the reward for all the given periods of a Quest, and transfer all the rewards at once

Sums up all the rewards for given periods of a Quest, and executes only one transfer

Parameters

addQuest

function addQuest(uint256 questID, address token) external returns (bool)

Adds a new Quest to the listing

Adds a new Quest ID and the associated reward token

Parameters

Return Values

addQuestPeriod

function addQuestPeriod(uint256 questID, uint256 period, uint256 totalRewardAmount) external returns (bool)

Adds a new period & the rewards of this period for a Quest

Adds a new period & the rewards of this period for a Quest

Parameters

Return Values

fixQuestPeriod

function fixQuestPeriod(uint256 questID, uint256 period, uint256 newTotalRewardAmount) external returns (bool)

updateQuestPeriod

function updateQuestPeriod(uint256 questID, uint256 period, uint256 totalAmount, bytes32 merkleRoot) external returns (bool)

Updates the period of a Quest by adding the Merkle Root

Add the Merkle Root for the eriod of the given Quest

Parameters

Return Values

recoverERC20

function recoverERC20(address token) external returns (bool)

Recovers ERC2O tokens sent by mistake to the contract

Recovers ERC2O tokens sent by mistake to the contract

Parameters

Return Values

emergencyUpdateQuestPeriod

function emergencyUpdateQuestPeriod(uint256 questID, uint256 period, uint256 addedRewardAmount, bytes32 merkleRoot) external returns (bool)

Allows to update the MerkleRoot for a given period of a Quest if the current Root is incorrect

Updates the MerkleRoot for the period of the Quest

Parameters

Return Values

Last updated