Permissionless Rewards

Newer Liquidity Gauges allow the addition of permissionless rewards to a gauge by a distributor. When deploying a gauge through the OwnershipProxy, the deployer is automatically designated as the gauge manager. This address can then call add_rewards within the OwnershipProxy contract to add reward tokens and distributors. These can subsequently be deposited into the gauge.

If the gauge wasn't deployed through the OwnershipProxy, a migration is required first before adding permissionless rewards.

On sidechains, permissionless rewards are directly built into the gauges. Whoever deploys the gauge can call add_rewards on the gauge contract itself (no need to migrate or do it via proxy).

NG Gauges

Gauges for NG (stableswap-ng, tricrypto-ng, or twocrypto-ng) pools offer the possibility to add external rewards unlocked from the start, without deploying the gauge from an OwnershipProxy or doing any migration.

Contract Source & Deployment

OwnerProxy for StableSwap pools (Ownership- and GaugeProxy): 0x742C3cF9Af45f91B109a81EfEaf11535ECDe9571
OldManagerProxy (need to migrate from this to the one above): 0x201798B679859DDF129651d6B58a5C32527EA04c
GaugeManagerProxy for CryptoSwap (two-coin) pools: 0x9f99FDe2ED3997EAfE52b78E3981b349fD2Eb8C9

Setting Reward Token and Distributor¶

Before being able to deposit rewards, both the reward token and the distributor need to be set using the add_rewards function.

If the gauge was deployed through the old GaugeProxy, there needs to be a migration to the new OwnerProxy through the migrate_gauge_manager function.

Warning

add_reward and migrate_gauge_manager function needs to be called from the OwnerProxy, as these function are only callable by the admin or gauge manager. set_reward_distributor can also be either called from the Proxy or straight from the gauge itself.

`add_reward`¶

OwnerProxy.add_reward(_reward_token: address, _distributor: address):

Guard

This function can only be called by the ownership_admin or gauge_manager.

Function to add a reward token and distributor.

Input	Type	Description
`_reward_token`	`address`	Reward Token
`_distributor`	`address`	Distributor Address

Source code

OwnerProxy.vyGaugeV4.vy

ownership_admin: public(address)
gauge_manager: public(HashMap[address, address])

@external
def add_reward(_gauge: address, _reward_token: address, _distributor: address):
    assert msg.sender in [self.ownership_admin, self.gauge_manager[_gauge]]
    Gauge(_gauge).add_reward(_reward_token, _distributor)

MAX_REWARDS: constant(uint256) = 8

admin: public(address)

@external
def add_reward(_reward_token: address, _distributor: address):
    """
    @notice Set the active reward contract
    """
    assert msg.sender == self.admin  # dev: only owne

    reward_count: uint256 = self.reward_count
    assert reward_count < MAX_REWARDS
    assert self.reward_data[_reward_token].distributor == ZERO_ADDRESS

    self.reward_data[_reward_token].distributor = _distributor
    self.reward_tokens[reward_count] = _reward_token
    self.reward_count = reward_count + 1

Example

>>> OwnerProxy.add_reward("0xD533a949740bb3306d119CC777fa900bA034cd52", "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"):

`set_reward_distributor`¶

OwnerProxy.set_reward_distributor(_reward_token: address, _distributor: address):

Function to reassign the reward distributor of reward token _reward_token to _distributor.

Input	Type	Description
`_reward_token`	`address`	Reward Token
`_distributor`	`address`	New Distributor Address

Note

This function can only be called by the ownership_admin or the gauge_manager.

Source code

OwnerProxy.vyGaugeV4.vy

ownership_admin: public(address)
gauge_manager: public(HashMap[address, address])

@external
def set_reward_distributor(_gauge: address, _reward_token: address, _distributor: address):
    assert msg.sender in [self.ownership_admin, self.gauge_manager[_gauge]]
    Gauge(_gauge).set_reward_distributor(_reward_token, _distributor)

admin: public(address)

@external
def set_reward_distributor(_reward_token: address, _distributor: address):
    current_distributor: address = self.reward_data[_reward_token].distributor

    assert msg.sender == current_distributor or msg.sender == self.admin
    assert current_distributor != ZERO_ADDRESS
    assert _distributor != ZERO_ADDRESS

    self.reward_data[_reward_token].distributor = _distributor

Example

>>> OwnerProxy.set_reward_distributor("0xD533a949740bb3306d119CC777fa900bA034cd52", "0x7a16ff8270133f063aab6c9977183d9e72835428")

`migrate_gauge_manager`¶

OwnerProxy.migrate_gauge_manager(_gauge: address):

Function to migrate the gauge manager from _gauge to the new proxy.

Note

This migration must be completed before gaining the capability to add permissionless rewards.

Input	Type	Description
`_gauge`	`address`	Gauge to migrate

Source code

@external
def migrate_gauge_manager(_gauge: address):
    manager: address = ManagerProxy(OLD_MANAGER_PROXY).gauge_manager(_gauge)
    if manager != empty(address) and self.gauge_manager[_gauge] == empty(address):
        self.gauge_manager[_gauge] = manager

Example

>>> OwnerProxy.migrate_gauge_manager("0x4647aF642408AF64fD3Cd5d9C8366f56f4dF3dd2"):

Deposit Rewards¶

Depositing reward tokens is done directly via the individual gauges after the reward token and distributor has been set.

`deposit_reward_token`¶

LiquidityGauge.deposit_reward_token(_reward_token: address, _amount: uint256):

Function to deposit _amount of _reward_token into the gauge.

Deposited tokens will be streamed over a period of seven days. If additional rewards from the same token are added before the previous ones have fully ran out, the remaining balance will be rolled into the new seven-day stream.

Input	Type	Description
`_reward_token`	`address`	Reward Token
`_amount`	`uint256`	Amount of Reward Token

Note

This function can only be called by the distributor of the reward token.

Source code

WEEK: constant(uint256) = 604800

@external
@nonreentrant("lock")
def deposit_reward_token(_reward_token: address, _amount: uint256):
    assert msg.sender == self.reward_data[_reward_token].distributor

    self._checkpoint_rewards(ZERO_ADDRESS, self.totalSupply, False, ZERO_ADDRESS)

    response: Bytes[32] = raw_call(
        _reward_token,
        concat(
            method_id("transferFrom(address,address,uint256)"),
            convert(msg.sender, bytes32),
            convert(self, bytes32),
            convert(_amount, bytes32),
        ),
        max_outsize=32,
    )
    if len(response) != 0:
        assert convert(response, bool)

    period_finish: uint256 = self.reward_data[_reward_token].period_finish
    if block.timestamp >= period_finish:
        self.reward_data[_reward_token].rate = _amount / WEEK
    else:
        remaining: uint256 = period_finish - block.timestamp
        leftover: uint256 = remaining * self.reward_data[_reward_token].rate
        self.reward_data[_reward_token].rate = (_amount + leftover) / WEEK

    self.reward_data[_reward_token].last_update = block.timestamp
    self.reward_data[_reward_token].period_finish = block.timestamp + WEEK

Example

>>> LiquidityGauge.deposit_reward_token('0xD533a949740bb3306d119CC777fa900bA034cd52', 100000000000000):

Query Reward Informations¶

These methods are queried directly from the individual gauge contracts.

`rewards_token`¶

LiquidityGauge.rewards_token(arg0: uint256) -> address: view

Getter for the reward tokens for the gauge.

Returns: reward token (address).

Input	Type	Description
`arg0`	`uint256`	Reward Token Index

Source code

reward_tokens: public(address[MAX_REWARDS])

@external
def add_reward(_reward_token: address, _distributor: address):
    """
    @notice Set the active reward contract
    """
    assert msg.sender == self.admin  # dev: only owner

    reward_count: uint256 = self.reward_count
    assert reward_count < MAX_REWARDS
    assert self.reward_data[_reward_token].distributor == ZERO_ADDRESS

    self.reward_data[_reward_token].distributor = _distributor
    self.reward_tokens[reward_count] = _reward_token
    self.reward_count = reward_count + 1

Example

>>> LiquidityGauge.rewards_token(0):
'0xD533a949740bb3306d119CC777fa900bA034cd52'

`reward_count`¶

LiquidityGauge.reward_count() -> uint256: view

Getter for the amount of reward tokens added.

Returns: amount (uint256).

Source code

reward_count: public(uint256)

@external
def add_reward(_reward_token: address, _distributor: address):
    """
    @notice Set the active reward contract
    """
    assert msg.sender == self.admin  # dev: only owner

    reward_count: uint256 = self.reward_count
    assert reward_count < MAX_REWARDS
    assert self.reward_data[_reward_token].distributor == ZERO_ADDRESS

    self.reward_data[_reward_token].distributor = _distributor
    self.reward_tokens[reward_count] = _reward_token
    self.reward_count = reward_count + 1

Example

>>> LiquidityGauge.reward_count():
1

`reward_data`¶

LiquidityGauge.reward_data(arg0: uint256) -> token: address, distributor: address, period_finish_ uint256, rate: uint256, last_update: uint256, integral: uint256:

Getter for the reward data for reward token arg0.

Returns: token (address), distributor (address), period_finish_ (uint256), rate (uint256), last_update (uint256) and integral (uint256).

Input	Type	Description
`arg0`	`uint256`	Reward Data Index

Source code

reward_data: public(HashMap[address, Reward])

Example

>>> LiquidityGauge.reward_data("0xD533a949740bb3306d119CC777fa900bA034cd52"):
'0x0000000000000000000000000000000000000000', '0x7a16fF8270133F063aAb6C9977183D9e72835428', 1686408827, 82671957671957671, 1686408827, 709433824539444151212

Permissionless Rewards

Setting Reward Token and Distributor¶

add_reward¶

set_reward_distributor¶

migrate_gauge_manager¶

Deposit Rewards¶

deposit_reward_token¶

Query Reward Informations¶

rewards_token¶

reward_count¶

reward_data¶

`add_reward`¶

`set_reward_distributor`¶

`migrate_gauge_manager`¶

`deposit_reward_token`¶

`rewards_token`¶

`reward_count`¶

`reward_data`¶