Permissionless Token Rewards

This section explains the process of setting any token reward using Etherscan. It's assumed that the user possess some familiarity with Etherscan or are competent in executing the transaction through an alternative tool.

Permissionless rewards are added in the following flow:

1. Set reward token and distributor address.
2. Approve reward token.
3. Add rewards.

Setting the Reward Token and Distributor Address¶

Specify the reward token and the distributor address. The distributor address is the source from which the reward token will be sent to the gauge.

To identify the manager, check the manager/admin in the "Read Contract" section on Etherscan. Some versions of this contract may also allow the factory owner to execute this call.

The deployer of the gauge is usually the manager of the gauge if the gauge was deployed via the Proxy of the Factory. If the gauge was deployed directly through the Factory contract itself, a quick migration needs to occur (see here).

add_reward()¶

This function should be called only once for a specific reward token. A repeated call to add_reward using a previously set reward token will fail. However, the distributor address for an already added reward token can be updated using the set_reward_distributor function. Over the lifetime of a gauge, a total of 8 different reward tokens can be set.

As add_reward() is an admin guarded function, you might need to call it from a ProxyContract. More information here.

Approving the Reward Token for Deposit¶

Visit the reward token contract address on Etherscan and switch to the "Write Contract" tab. Use the approve function, setting the spender as the gauge contract address and specifying the desired amount.

approve()¶

Depositing the Reward Token¶

Deposit the reward token to the contract. This action initiates the first reward epoch, lasting one week (defined as 604,800 seconds or 7 * 24 * 3600). If no additional reward token is deposited using the same function, this reward epoch ends after the week.

If you additionally add a currently streaming token, both the newly added ones and all the remaining ones are combined, triggering a fresh week-long epoch.

For consistent reward distributions, it's advisable to deposit near the end of an epoch. If replenishing mid-epoch, ensure you compute the appropriate amount for a steady distribution rate.

deposit_reward_token()¶