[Story][CL]: Incentives

[p0mvn]

Background

As an LP, I want to earn liquidity rewards so that I am more incentivized to provide liquidity in the ranges closer to the price.

This story tracks the development of incentives for concentrated liquidity.
TBD: @czarcas7ic to provide more context

Tasks

Completed/closed

• feat: concentrated liquidity incentives #3894
• [CL]: CL Incentives Sumtree #3886
• [CL]: Join-time tracker sumtree #3898
• [CL Incentives] Uptime Accumulator Initialization #4112
• [accum][CL Incentives]: Track total shares for accumulators #4202
• [CL Incentives] Track relevant uptime accumulators in new positions #4134
• [CL Incentives] Implement setIncentiveRecords and getIncentiveRecords #4274
• [CL Incentives] Implement proto and helpers for global accumulator update logic #4215
• [CL Incentives][Tests]: Add further tests to uptime accumulator update logic #4339
• [CL Incentives]: Sync global uptime accumulators upon liquidity change #4113
• [CL Incentives]: Sync global uptime accumulators upon tick initialization #4277
• [CL Incentives]: Sync global uptime accumulators upon tick crossing #4278
• [CL Incentives] Remove duplicate state from key/value in IncentiveRecord #4284
• [CL Incentives] Implement GetUptimeGrowthInsideRange and GetUptimeGrowthOutsideRange for arbitrary tick ranges #4279
• [CL Incentives] Implement initOrUpdatePositionUptime #4454
• [CL Incentives][bugfix]: Replace all uses of frozenUntil with joinTime and freezeDuration #4457
• [CL Incentives] Claim incentives for all uptimes #4137
• [CL Incentives] Implement CreateIncentive message #4400
• [CL Incentives] Allow early withdrawals for frozen positions #4456
• [CL Incentives] Abstract common incentive/fee claiming logic #4514
• [CL Incentives] Delete uptime records when a position is closed #4183
• [CL Incentives] Re-add JoinTime and FreezeDuration to higher level position object #4578
• [CL Incentives] Key incentive records by owner address to prevent DoS/trolling #4515
• [CL Incentives] Allow incentives from governance proposals to bypass scaling gas costs #4662
• [CL Incentives] Align accumulator abstractions between incentives and fees #4453
• [CL Incentives] Add Ability to Freeze After Position Creation #4114
• [CL Incentives] Scale gas cost for new incentives by number of existing incentives #4517
• [CL Incentives] Clean up incentive records when they run out #4522
• [CL Incentives] Add 0 second to supported uptime #4640
• [CL Incentives] Remove ability to add to frozen positions #4482
• [CL Incentives] Remove freezeDuration as a parameter and key component for positions #4653

Ready for review

• [CL Incentives] Implement incentives wiring from governance-triggered emissions #4401

Remaining and launch-blocking

Non-launch blocking remaining tasks

• [CL Incentives] Add check to only sync uptime accums when necessary #4422
• [CL Incentives] Make collectIncentives return forfeited amount #4736
• [CL Incentives] Implement tick-level set and get functions for uptime trackers #4275

Acceptance Criteria

• Freeze-based incentives completed (MVP)
• Non-freeze-based incentives TBD
• Sublinear incentives TBD