Guide for sending the trading and losses incentives and referral rewards

This guide will walk you through the process of generating the distribution CSV for the trading and loss incentives and referral rewards("rewards"), committing it to the repository, and executing the distribution.

Confirm pool sizes and referral reward percentage

Before running the scripts, confirm the following parameters with Jonathan:

  • Losses Pool Size: Typically set to 50000.
  • Fees Pool Size: Typically set to 50000.
  • Referee Rewards Percentage: Typically set to 50%.

Ensure that these values are accurate and approved by Jonathan before proceeding.

Generate the Distribution CSV File

Once you have confirmed the parameters, you can generate the distribution CSV file using the following command:

cargo run --bin perps-deploy util trading-incentives-csv --losses-pool-size 50000 --fees-pool-size 50000 --referee-rewards-percentage 50

This command will generate the CSV file with the specified parameters and automatically save it in the appropriate directory within the repository.

Troubleshoot

When the default osmosis grpc endpoint (https://grps.osmosis.zone) does not respond properly, it will throw an error when running the above command.

error-caused-by-osmosis-config.png

Here's the config for osmosis-mainnet to handle this issue.

osmosis-mainnet
Primary endpoint: https://osmo-priv-grpc.kingnodes.com
Fallback #1: https://c7f58ef9-1d78-4e15-a818-d02c8f50fc67.osmosis-1.mesa-grpc.newmetric.xyz
Fallback #2: https://grpc.osmosis.zone
Fallback #3: http://osmosis-grpc.polkachu.com:12590

If you install a recent version of the cosmos CLI, you can set these values by using cosmos config subcommand.

Output Example

The generated file typically saved as:

data/rewards/YYYY-MM-DD-trading-incentives.csv

Make sure to verify the contents of the generated CSV file to ensure accuracy.

Create a Pull Request (PR) for the New Incentives CSV File

After generating the csv file, make a PR for the change. We should setup and use git lfs to make the commit as the file size will exceed the storage limit of git.

Request Sufficient LVN from Michael Belote

Once the PR is approved and merged, need to ask Michael Belote to send the sufficient LVN to the hot wallet.

Execute the Gov-Distribution Script

With the LVN and proper amount of Osmo for fee in the hot wallet, execute the distribution using the following command:

COSMOS_WALLET="mnemonics of hot wallet" cargo run --bin perps-deploy util gov-distribute --network osmosis-mainnet data/rewards/YYYY-MM-DD-trading-incentives.csv

Once the transactions started to made, you can check it from mintscan.