# 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 mintedgenesis_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 factorreduction_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 tostaking
- Proportion of minted funds to incentivize staking OSMOpool_incentives
- Proportion of minted funds to incentivize pools on Osmosisdeveloper_rewards
- Proportion of minted funds to pay developers for their past and future workcommunity_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 receiveminting_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
Example
List all current min parameters in json format by:
osmosisd query mint params -o json | jq
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"
}
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
Example
List the current epoch provisions:
osmosisd query mint epoch-provisions
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%) |