This repository contains the code and data needed to implement the currently approved Osmosis incentives process. It also acts as a way to track changes to this process over time.
The main branch contains the process and data for the most recent proposal.
The staging branch contains the process for the next proposal.
Throughout the week, PRs are made to staging corresponding to on chain text proposals, such as adding pools to onboarding, matching external incentives, or changing the adjustment process.
A view branch off of staging is continually updated with new data, so that we can see what we expect the next proposal to look like.
As on chain text proposals pass, their PRs are merged to staging (and then merged to the view branch).
When it's time for a new adjustment proposal, the view branch is merged back into staging (giving it up to date market data). And the staging branch is then merged into main (with the commit message documenting the set of changes since the last adjustment proposal).
The data in the main branch is then used to create the on chain adjustment proposal.
- Params.py - Values set via text proposals, such as parameters (scale limit, matching limit, etc.), incentivized pool IDs and matched externals.
- Query.py - Functions to get data from Blockapsis and Imperator APIs
- Pools.py/Pool.py - Methods to do the calculations and generate csvs / proposal data
- Update.py - Code to update csv files with new data/calculations
- data/ - csv outputs which are auto imported into Current Proposal and Prospective Proposal spreadsheets and which are used to generate a proposal
- Propose.py - Takes
data/new_gauges.csvand generates and submits an onchain poolincentives proposal
- external incentives matching
- biased subsidy targets
- scale limiting
- maturity based scale bypass