🧑‍🌾Farm an incentive

How to earn juicy yields as an LP

-> Our Incentives Table can be seen at https://www.taraswap.app/#/farms/incentives

-> To interact with an incentive, click on its table entry, this will take you to an url similar to https://www.taraswap.app/#/pool/6?incentive=0xc219e9b2ea410092321e9359eae8caa2b7f4b662331610aadda314527239eecf

Incentives section

The main incentive section is just an added subsection filled with buttons to the main pool page where you can interact with the incentive itself.

example incentive section

Let's try to break this down and understand what's happening here:

-> On the top of the page you can see 2 information cards:

1. Whether you deposited your LP NFT to the staker contract or not

2. Whether you have pending rewards or not

-> Below that you can see 3 main sections:

1. Incentive management:

   1. The "end incentive" button: this can be called to end the incentive and return the incentive tokens to the refundee address after the incentive ended.

2. LP NFT deposit section:

   1. First, before you're able to stake your LP into incentives(opt into incentive programs), you need to deposit the LP token into the v3-staker contract. You can do this by clicking "Approve and Deposit LP Token"

   2. To withdraw your token, you can click "Withdraw Token". This is enabled only if you deposited your LP token and you haven't staked it.

When you deposited your LP Token

Once you deposited your LP token to the v3-staker, the UI will turn on the Incentives management section.

Incentives management section

Here, you have 3 important actions:

1. Stake - you need to stake your token into a specific incentive in order to accrue rewards. If you didn't stake it, you won't receive any incentives.

2. Claim Reward - this can be called as soon as you accrue any rewards.

3. Unstake - if you want to opt out of this reward, unstake your LP token.

LP tokens can be staked into multiple incentives, so if there are more incentives for the pool you LP into, you can earn tokens from all of them!

When you stake your LP Token you can't withdraw it until you unstaked it from every incentive(if you staked into more than one).

As long as you deposit your LP Token to the Incentives Module, the Pools page at https://www.taraswap.app/#/pool won't show your position anymore and you won't be able to make changes to it. If you want to stop LPing, you first need to unstake from all incentives and withdraw your Position LP Token. After that it will show up as it should in the Pools page.

Pending vs Accrued Rewards

When you stake your position NFT, you opt into the incentive. Once you do that, you will start accruing Pending Rewards.

However, since we're interacting with directl on-chain incentives here, we need a way of updating the smart contract with claimable rewards.

Pending vs accrued rewards

When you hit the "Claim Rewards" button, you can claim your accrued rewards. These rewards, regardless of you accumulating pending rewards or not, are not set until you unstake your tokens.

Therefore, if you want to claim rewards, you need to:

1. Check if you have pending rewards

2. Hit "Unstake"

3. This will transfer your pending rewards into the "accrued rewards", effectively making it claimable from the Incentives Module.

4. Hit "Claim Rewards"

In order to accrue new rewards, you need to hit "Stake" and stake your LP token back into the incentive after doing this.