Tick-Based Farming
Concentrated Liquidity Farms
Introduction
As a tick-based automated market maker (AMM), KyberSwap Elastic enables greater capital efficiency by allowing users to provide liquidity to a pool within a custom price range. This also means that liquidity contributed by an LP is no longer equally distributed across the same range as other LPs.
Liquidity: Measuring LP contributions
Please refer to this section on the liquidity concept if you would like to understand how concentrated liquidity AMM protocols keep track of LP contributions and how trading fees are distributed.
Therefore, this customizability makes the traditional liquidity mining mechanism (i.e. distributing farming rewards to all staking users in a pro-rata way) no longer reasonable as different proportions of each LP's contributed liquidity will support the active price. The risks taken by each user also varies greatly.
To tackle these challenges, KyberSwap Elastic introduced innovative liquidity mining (aka farming) mechanisms that are able to distribute farming rewards to users according to multiple factors:
Active time of liquidity (Dynamic Farms)
Supported trade volume (Dynamic Farms)
Liquidity contributed to operator-specified farm ranges (Static Farms)
Static Farms: Capital efficient rewards distribution
While both Dynamic and Static Farms achieves practical distribution of farming rewards, the core distribution mechanism differs between the two. Dynamic Farms takes an active position approach while Static Farms takes a weighted distribution approach based on fixed farming ranges. Based on this difference, Static Farms introduces the following benefits:
Operator (i.e. reward admin) configured farming ranges with weighted rewards distribution
Farming rewards for inactive ranges depending on operator defined farm ranges
Simpler user farming journey
The introduction of farming ranges enables more fine-grained control of reward incentives. Instead of allocating a fixed amount of rewards to a token pair and relying completely on market forces to determine the distribution, Static Farms allow reward operators to influence distribution of rewards between various price ranges. In effect, rewards can be utilized more effectively to incentivize liquidity provision to specific price ranges instead of just the current active price.
Dynamic Farms
In the first version of Elastic Farming, all farms were setup based on 2 types of farming mechanisms.
Dynamic Farms Type 1 - Active time of your liquidity
This type of Farm relies on a single factor:
Total time your liquidity position has been active (aka in range) in the pool and supporting the current price of the pool
Once you stake your liquidity position(s) into a Dynamic Farm, we will start calculating your farming rewards based on whether your liquidity position(s) is currently active (i.e. supporting the current price of the pool). You will continue to accumulate farming rewards as long as your position is active. You will of course accumulate rewards in proportion to the dollar value of your liquidity position relative to other farmers.
If your liquidity position goes out of range (aka becomes inactive), you will stop accumulating farming rewards. This can happen if the current price of the pool moves significantly due to market changes. You will have to adjust the price range of your liquidity position so that it is again in range (aka active) and is supporting the current price of the pool.
Dynamic Farms Type 2 - Active time of your liquidity & target volume
This type of Farm relies on an additional factor as compared to Type 1:
Total time your liquidity position has been active (aka in range) in the pool and supporting the current price of the pool
Trade volume supported by your liquidity position (indicated by the target Fee earned from the pool). The objective of Target Trade Volume is for the project that is giving out farming incentives to indicate the trading volume they would like each liquidity position to support before they receive farming rewards.
Once you stake your liquidity position(s) into a farm, we will start calculating your farming rewards based on:
Whether your liquidity position(s) is currently active and supporting the current price of the pool
Whether your liquidity position(s) has supported the required target volume by supporting the trading volume in the pool.
You will accumulate farming rewards at a reduced rate even if your liquidity position does not hit the full Target Volume. As soon as your position hits the full Target Volume, from thereafter, you will continue receiving 100% of the rewards for that liquidity position. You will of course accumulate rewards in proportion to the dollar value of your liquidity position relative to other farmers
If your liquidity position goes out of range (aka becomes inactive), you will stop accumulating farming rewards. This can happen if the current price of the pool moves significantly due to market changes. You will have to adjust the price range of your liquidity position so that it is again in range (aka active) and is supporting the current price of the pool.
In order to hit your full Target Volume faster, you may also have to adjust the price range of your liquidity position so that it is concentrated enough and consequently more trading volume of the pool is supported by your liquidity position.
Static Farms
In the earlier Dynamic Farms, one of the main tradeoffs of the design was that rewards were only distributed to liquidity positions supporting the active price of the pool. While this distribution is seemingly fair, it results in the following:
Reward distribution is entirely dictated by market prices. This meant reward operators were unable to utilize their capital efficiently to incentivize liquidity provision at specific price ranges.
LPs stopped earning any rewards on inactive positions. To continue earning rewards, LPs had to unstake and repeat the whole staking process again from scratch. This increases gas costs as well as the manual management overhead required.
To address the aforementioned pain points, Static Farms introduced a weighted farm range reward system which can be easily configured by the operator.
Farming range: Configurable range rewards
Static Farms enables operators to define specific price ranges (i.e. farming range) within which LPs will earn weighted shares of the reward pool. In other words, rewards only accrue to LPs who are supporting the operator specified farming range regardless of whether the price range is active. By allowing reward ranges to be customizable, operators have more fine-grained control over how their rewards are being utilized as incentives.
Given this customizability, operators are also provided the option to create multiple farming ranges, each with a separate weight. Instead of having to commit all the rewards to a single price range, the total rewards can be split across multiple price ranges. Operators now have the power to proportionally distribute rewards within the same pool. This means that both operators and liquidity providers no longer have to split their liquidity across different pools due to varying farming structures.
It is crucial to note that this weighted distribution of farming rewards is independent of the active range (i.e. the active time of liquidity and target volume concepts covered in Dynamic Farms no longer applies in Static Farms). Rewards will be distributed solely based on having a liquidity position (either active/inactive) that encompasses the farming range specified by the operator. Rewards distribution within a farming range will be based on the proportion of liquidity which an LP contributes towards the farm. LPs continue to earn trading fees for their underlying position but earn farming rewards based on the proportion of liquidity contributed to a farming range.
Static Farms concept in practice
Without diving too deep into the technicals, we can gain an appreciation of Static Farm concepts by walking through the farming process sequentially:
Farm operator configures a farm with multiple reward ranges, each with an assigned weight. Farming ranges can overlap based on the operator's discretion.
Liquidity providers are able to participate in farming rewards by staking their liquidity position to a specified farm range. The LPs underlying liquidity price range must cover the whole farm range in order to be eligible for rewards from that farm range. Each position can only be staked into a single farm range.
For each position that is staked in the farm, the farm assigns a proportional share of the rewards based on the liquidity contributed to the specific farm range as well as the total amount of time the position is staked in the farm. This calculation also takes into account the weight assigned for the selected farm range.
The rewards accrued to a LP are calculated at the point of withdrawal. To find the reward for each staked position, the total farming rewards is then multiplied by the shares that have accumulated to that position. (i.e. if a staked position has 10 shares and the total shares issued across all farm ranges in a farm is 100, the position gets 10% of total pool rewards).
Effectively, rewards calculation can be simplified via viewing farming rewards in terms of shares whereby each staked position accumulates a share of the total rewards pool based on:
Liquidity contributed to the farm range
Staking duration in farm range
Weight of selected farm range relative to other farm ranges in the farm
Static Farms example
The example below walks you through how farming rewards are calculated in the case whereby there is a single staker vs multiple stakers. Through this example, you will be able to understand how farming rewards are proportioned between various positions.
Static Farm setup
A farm operator setups a KNC-USDT farm which runs for 2 weeks (1,209,600 seconds) with total rewards of 100,000KNC. The rewards are spread across the following 2 ranges, each with a weight configured by the farm operator.
| Farm range ID | Farm range | Weight |
|---|---|---|
A | 0.75-0.80 | 2 |
B | 0.80-0.85 | 5 |
Based on the weights specified, the farm operator intends to incentivize more liquidity to be added to the higher price ranges (assuming current KNC price of 0.76). LPs providing liquidity to the higher price ranges can expect to get a larger share of the total rewards based on the operator assigned weight.
Single staker
Liquidity provision and staking in a farm range
Upon the farm becoming active, Alice decides to participate in the 0.75-0.80 farm range. Alice has an existing concentrated liquidity position worth USD1,000 in the KNC-USDT pool with a price range of 0.75-0.80 (assume tick-spacing of 0.01 for simplicity). Alice expects that KNC price will continue to trade within this range and hence does not change her position to continue earning trading fees.
Claiming rewards
For simplicity, we will assume that no other LPs entered the farm and hence Alice currently owns 100% of the farming reward share and is therefore eligible to all the farming rewards in proportion to the total time of her stake. If Alice stakes for the full period of the farm, she will get the full 100,000KNC farming rewards. Due to the time element of the farm, the rewards will also be proportioned based on the total amount of time that a position supports the farm range (i.e. if Alice enters the farm halfway through, she will only get half the rewards).
Multiple stakers
Liquidity provision and staking in a farm range
Halfway through the farming period, Bob decides to also participate in the KNC-USDT farm and sees that Farm Range B has a higher weight. Bob decides to create a new concentrated liquidity position worth USD1,000 with a range of 0.75-0.85. Based on his liquidity position, Bob is eligible to stake in both farm ranges but decides to go with Farm Range B as it has a comparatively higher weight.
Calculating shares
With multiple stakers in the farm, the farm now needs to track the proportion of rewards going to each of the position staked by Alice and Bob. Currently, we have the following staked positions.
| LP | Position Range | Position TVL | Farm Range staked |
|---|---|---|---|
Alice | 0.75-0.80 | USD1,000 | A (Range: 0.75-0.80, Weight: 2) |
Bob | 0.75-0.85 | USD1,000 | B (Range: 0.75-0.85, Weight: 5) |
To get the reward shares for each position, the protocol calculates the proportion of liquidity that the position has contributed to the farm.
This example glances over the exact calculation but the formula for the liquidity contributed, , can be found in the section or in the Elastic Whitepaper. For every concentrated liquidity position, the TVL is distributed across the selected price range in accordance to the pool's price curve. Consequently, what is important to note is that indicates the proportion of liquidity that a position has contributed within the specified price range.
To get the liquidity value, we have the following parameters:
KNCUSDT(current pool price)
, (position's lower range)
, (position's higher range)
,
Using the liquidity formula, we get the following liquidity values assuming the current market price remains within the position's range:
Notice that is higher than even though their positions are of similar dollar value. This is because the TVL of Bob's position is spread over a wider range when compared to Alice's position. In other words, for the price ranges where Alice's and Bob's position overlaps, Alice contributes significantly more liquidity to support trades within her selected price range.
To get the farming reward shares, we then need to factor in the weight assigned to each farming range whereby:
As such, we get the following:
Finally, to obtain the final reward payout at withdrawal, remember that Alice has staked for the whole 2 week duration of the farm (1,209,600 seconds) while Bob only entered halfway (604,800 seconds). For simplicity, we assume both Alice and Bob withdraws after the farm ends leading to the following parameters:
KNC
Using the above, we are then able to calculate the final rewards allocated to Alice:
Likewise for Bob:
Note that not all the rewards in the farm were distributed as the rewards have to take into account the time element of farm deposits and withdrawals.
Last updated