# Mint

The mint module is responsible for creating tokens in a flexible way to reward validators, incentivize providing pool liquidity, provide funds for Osmosis governance, and pay developers to maintain and improve Osmosis.

The module is also responsible for reducing the token creation and distribution by a set amount and a set period of time until it reaches its maximum supply (see reduction_factor and reduction_period_in_epochs)



# Overview

# Network Parameters

Below are all the network parameters for the mint module:

  • mint_denom - Token type being minted
  • genesis_epoch_provisions - Amount of tokens generated at epoch to the distribution categories (see distribution_proportions)
  • epoch_identifier - Type of epoch that triggers token issuance (day, week, etc.)
  • reduction_period_in_epochs - How many epochs must occur before implementing the reduction factor
  • reduction_factor - What the total token issuance factor will reduce by after reduction period passes (if set to 66.66%, token issuance will reduce by 1/3)
  • distribution_proportions - Categories in which the specified proportion of newly released tokens are distributed to
    • staking - Proportion of minted funds to incentivize staking OSMO
    • pool_incentives - Proportion of minted funds to incentivize pools on Osmosis
    • developer_rewards - Proportion of minted funds to pay developers for their past and future work
    • community_pool - Proportion of minted funds to be set aside for the community pool
  • weighted_developer_rewards_receivers - Addresses that developer rewards will go to. The weight attached to an address is the percent of the developer rewards that the specific address will receive
  • minting_rewards_distribution_start_epoch - What epoch will start the rewards distribution to the aforementioned distribution categories


# Queries

# params

Query all the current mint parameter values

query mint params
1
Example

List all current min parameters in json format by:

osmosisd query mint params -o json | jq
1

An example of the output:

{
  "mint_denom": "uosmo",
  "genesis_epoch_provisions": "821917808219.178082191780821917",
  "epoch_identifier": "day",
  "reduction_period_in_epochs": "365",
  "reduction_factor": "0.666666666666666666",
  "distribution_proportions": {
    "staking": "0.250000000000000000",
    "pool_incentives": "0.450000000000000000",
    "developer_rewards": "0.250000000000000000",
    "community_pool": "0.050000000000000000"
  },
  "weighted_developer_rewards_receivers": [
    {
      "address": "osmo14kjcwdwcqsujkdt8n5qwpd8x8ty2rys5rjrdjj",
      "weight": "0.288700000000000000"
    },
    {
      "address": "osmo1gw445ta0aqn26suz2rg3tkqfpxnq2hs224d7gq",
      "weight": "0.229000000000000000"
    },
    {
      "address": "osmo13lt0hzc6u3htsk7z5rs6vuurmgg4hh2ecgxqkf",
      "weight": "0.162500000000000000"
    },
    {
      "address": "osmo1kvc3he93ygc0us3ycslwlv2gdqry4ta73vk9hu",
      "weight": "0.109000000000000000"
    },
    {
      "address": "osmo19qgldlsk7hdv3ddtwwpvzff30pxqe9phq9evxf",
      "weight": "0.099500000000000000"
    },
    {
      "address": "osmo19fs55cx4594een7qr8tglrjtt5h9jrxg458htd",
      "weight": "0.060000000000000000"
    },
    {
      "address": "osmo1ssp6px3fs3kwreles3ft6c07mfvj89a544yj9k",
      "weight": "0.015000000000000000"
    },
    {
      "address": "osmo1c5yu8498yzqte9cmfv5zcgtl07lhpjrj0skqdx",
      "weight": "0.010000000000000000"
    },
    {
      "address": "osmo1yhj3r9t9vw7qgeg22cehfzj7enwgklw5k5v7lj",
      "weight": "0.007500000000000000"
    },
    {
      "address": "osmo18nzmtyn5vy5y45dmcdnta8askldyvehx66lqgm",
      "weight": "0.007000000000000000"
    },
    {
      "address": "osmo1z2x9z58cg96ujvhvu6ga07yv9edq2mvkxpgwmc",
      "weight": "0.005000000000000000"
    },
    {
      "address": "osmo1tvf3373skua8e6480eyy38avv8mw3hnt8jcxg9",
      "weight": "0.002500000000000000"
    },
    {
      "address": "osmo1zs0txy03pv5crj2rvty8wemd3zhrka2ne8u05n",
      "weight": "0.002500000000000000"
    },
    {
      "address": "osmo1djgf9p53n7m5a55hcn6gg0cm5mue4r5g3fadee",
      "weight": "0.001000000000000000"
    },
    {
      "address": "osmo1488zldkrn8xcjh3z40v2mexq7d088qkna8ceze",
      "weight": "0.000800000000000000"
    }
  ],
  "minting_rewards_distribution_start_epoch": "1"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# epoch-provisions

Query the current epoch provisions

query mint epoch-provisions
1
Example

List the current epoch provisions:

osmosisd query mint epoch-provisions
1

As of this writing, this number will be equal to the genesis-epoch-provisions. Once the reduction_period_in_epochs is reached, the reduction_factor will be initiated and reduce the amount of OSMO minted per epoch.

# Appendix

# Current Configuration

mint module: Network Parameter effects and current configuration

The following tables show overall effects on different configurations of the mint related network parameters:

mint_denom epoch_provisions epoch_identifier
Type string string (dec) string
Higher N/A Higher inflation rate Increases time to reduction_period
Lower N/A Lower inflation rate Decreases time to reduction_period
Constraints N/A Value has to be a positive integer String must be day, week, month, or year
Current configuration uosmo 821917808219.178 (821,9178 OSMO) day
reduction_period_in_epochs reduction_factor staking
Type string string (dec) string (dec)
Higher Longer period of time until reduction_factor implemented Reduces time until maximum supply is reached More epoch provisions go to staking rewards than other categories
Lower Shorter period of time until reduction_factor implemented Increases time until maximum supply is reached Less epoch provisions go to staking rewards than other categories
Constraints Value has to be a whole number greater than or equal to 1 Value has to be less or equal to 1 Value has to be less or equal to 1 and all distribution categories combined must equal 1
Current configuration 365 (epochs) 0.666666666666666666 (66.66%) 0.250000000000000000 (25%)
pool_incentives developer_rewards community_pool
Type string (dec) string (dec) string (dec)
Higher More epoch provisions go to pool incentives than other categories More epoch provisions go to developer rewards than other categories More epoch provisions go to community pool than other categories
Lower Less epoch provisions go to pool incentives than other categories Less epoch provisions go to developer rewards than other categories Less epoch provisions go to community pool than other categories
Constraints Value has to be less or equal to 1 and all distribution categories combined must equal 1 Value has to be less or equal to 1 and all distribution categories combined must equal 1 Value has to be less or equal to 1 and all distribution categories combined must equal 1
Current configuration 0.450000000000000000 (45%) 0.250000000000000000 (25%) 0.050000000000000000 (5%)