Adding pool incentives

Incentives are added to Osmosis pools using the osmosisd commandline tool.

Specifically, it's the tx incentives create-gauge subcommand.

Official documentation is here: https://docs.osmosis.zone/overview/integrate/incentives/#creating-an-external-incentives-gauge

The values you need to know are:

  • Pool ID
  • Pool type ("supercharged" or "classic")
    • note: "supercharged" is sometimes called "concentrated liquidity"
  • Start date
  • Duration, in days (or more accurately, "epochs")
  • Amount of LVN
  • For "classic" pools only: lockup duration (Osmosis recommendation is 14 days)

You also need to have setup osmosisd to target mainnet with a valid wallet.

We typically use the shared "pool-creator" wallet, so make sure enough LVN has been sent to osmo13etjyg0xusvf2leu7zljndvvavyjdq74gs6hw0

Current pool ids

  • LVN/OSMO (supercharged): 1325
  • LVN/USDC (supercharged): 1337
  • LVN/ATOM (classic): 1389

Epoch conversion

Aim for 16:30 UTC on the given date, which is a bit before the epoch. This needs to be converted into a Unix Timestamp. A good site for this is https://www.timestamp-converter.com/

Here's how to use it:

alt text

LVN Amount

The LVN amount is denoted as:

{AMOUNT}factory/osmo1mlng7pz4pnyxtpq0akfwall37czyk9lukaucsrn30ameplhhshtqdvfm5c/ulvn

Where amount is in micro-units, i.e. there are no decimals, rather it's an integer with the decimal shifted over 6 places

For example, 37.5K LVN would be expressed as: 

37500000000factory/osmo1mlng7pz4pnyxtpq0akfwall37czyk9lukaucsrn30ameplhhshtqdvfm5c/ulvn

Example commands

Ultimately, the idea is just to follow the official Osmosis documentation. But be careful of the difference between "classic" and "supercharged"

Let's say we want the following values:

  1. Start date: March 5th
  2. Duration: 90 days (i.e. 3 months)
  3. Amount of LVN: 150K
  4. Lockup (for classic only): 14 days (the recommended amount)

First we go to the epoch converter and figure out that 16:30 UTC on March 5th is 1709656200

Note that supercharged has 0 for the lockup_denom, while classic has 0 for the poolId

That gives us the following

LVN/OSMO:

osmosisd tx incentives create-gauge 0 150000000000factory/osmo1mlng7pz4pnyxtpq0akfwall37czyk9lukaucsrn30ameplhhshtqdvfm5c/ulvn 1325 --epochs 90 --start-time 1709656200 --from pool-creator --gas=auto --gas-prices 0.01uosmo --gas-adjustment 1.5

LVN/USDC:

osmosisd tx incentives create-gauge 0 150000000000factory/osmo1mlng7pz4pnyxtpq0akfwall37czyk9lukaucsrn30ameplhhshtqdvfm5c/ulvn 1337 --epochs 90 --start-time 1709656200 --from pool-creator --gas=auto --gas-prices 0.01uosmo --gas-adjustment 1.5

LVN/ATOM:

osmosisd tx incentives create-gauge gamm/pool/1389 150000000000factory/osmo1mlng7pz4pnyxtpq0akfwall37czyk9lukaucsrn30ameplhhshtqdvfm5c/ulvn 0 --duration 336h --epochs 90 --start-time 1709656200 --from pool-creator --gas=auto --gas-prices 0.01uosmo --gas-adjustment 1.5