2021-10-11 01:07:38 -07:00
|
|
|
<!--
|
|
|
|
order: 6
|
|
|
|
-->
|
|
|
|
|
|
|
|
# Client
|
|
|
|
|
|
|
|
## CLI
|
|
|
|
|
|
|
|
A user can query and interact with the `mint` module using the CLI.
|
|
|
|
|
|
|
|
### Query
|
|
|
|
|
|
|
|
The `query` commands allow users to query `mint` state.
|
|
|
|
|
|
|
|
```
|
|
|
|
simd query mint --help
|
|
|
|
```
|
|
|
|
|
|
|
|
#### annual-provisions
|
|
|
|
|
|
|
|
The `annual-provisions` command allow users to query the current minting annual provisions value
|
|
|
|
|
|
|
|
```
|
|
|
|
simd query mint annual-provisions [flags]
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
2021-10-30 06:43:04 -07:00
|
|
|
simd query mint annual-provisions
|
2021-10-11 01:07:38 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
22268504368893.612100895088410693
|
|
|
|
```
|
|
|
|
|
|
|
|
#### inflation
|
|
|
|
|
|
|
|
The `inflation` command allow users to query the current minting inflation value
|
|
|
|
|
|
|
|
```
|
|
|
|
simd query mint inflation [flags]
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
2021-10-30 06:43:04 -07:00
|
|
|
simd query mint inflation
|
2021-10-11 01:07:38 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
0.199200302563256955
|
|
|
|
```
|
|
|
|
|
|
|
|
#### params
|
|
|
|
|
|
|
|
The `params` command allow users to query the current minting parameters
|
|
|
|
|
|
|
|
```
|
|
|
|
simd query mint params [flags]
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
|
|
|
blocks_per_year: "4360000"
|
|
|
|
goal_bonded: "0.670000000000000000"
|
|
|
|
inflation_max: "0.200000000000000000"
|
|
|
|
inflation_min: "0.070000000000000000"
|
|
|
|
inflation_rate_change: "0.130000000000000000"
|
|
|
|
mint_denom: stake
|
|
|
|
```
|
|
|
|
|
|
|
|
## gRPC
|
|
|
|
|
|
|
|
A user can query the `mint` module using gRPC endpoints.
|
|
|
|
|
|
|
|
### AnnualProvisions
|
|
|
|
|
|
|
|
The `AnnualProvisions` endpoint allow users to query the current minting annual provisions value
|
|
|
|
|
|
|
|
```
|
|
|
|
/cosmos.mint.v1beta1.Query/AnnualProvisions
|
|
|
|
```
|
|
|
|
|
2021-10-30 06:43:04 -07:00
|
|
|
Example:
|
2021-10-11 01:07:38 -07:00
|
|
|
|
|
|
|
```
|
|
|
|
grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/AnnualProvisions
|
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"annualProvisions": "1432452520532626265712995618"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### Inflation
|
|
|
|
|
|
|
|
The `Inflation` endpoint allow users to query the current minting inflation value
|
|
|
|
|
|
|
|
```
|
|
|
|
/cosmos.mint.v1beta1.Query/Inflation
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
|
|
|
grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Inflation
|
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"inflation": "130197115720711261"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### Params
|
|
|
|
|
|
|
|
The `Params` endpoint allow users to query the current minting parameters
|
|
|
|
|
|
|
|
```
|
|
|
|
/cosmos.mint.v1beta1.Query/Params
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
|
|
|
grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Params
|
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"params": {
|
|
|
|
"mintDenom": "stake",
|
|
|
|
"inflationRateChange": "130000000000000000",
|
|
|
|
"inflationMax": "200000000000000000",
|
|
|
|
"inflationMin": "70000000000000000",
|
|
|
|
"goalBonded": "670000000000000000",
|
|
|
|
"blocksPerYear": "6311520"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## REST
|
|
|
|
|
|
|
|
A user can query the `mint` module using REST endpoints.
|
|
|
|
|
|
|
|
### annual-provisions
|
|
|
|
|
|
|
|
```
|
|
|
|
/cosmos/mint/v1beta1/annual_provisions
|
|
|
|
```
|
|
|
|
|
2021-10-30 06:43:04 -07:00
|
|
|
Example:
|
2021-10-11 01:07:38 -07:00
|
|
|
|
|
|
|
```
|
|
|
|
curl "localhost:1317/cosmos/mint/v1beta1/annual_provisions"
|
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"annualProvisions": "1432452520532626265712995618"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### inflation
|
|
|
|
|
|
|
|
```
|
|
|
|
/cosmos/mint/v1beta1/inflation
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
|
|
|
curl "localhost:1317/cosmos/mint/v1beta1/inflation"
|
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"inflation": "130197115720711261"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### params
|
|
|
|
|
|
|
|
```
|
|
|
|
/cosmos/mint/v1beta1/params
|
|
|
|
```
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
```
|
|
|
|
curl "localhost:1317/cosmos/mint/v1beta1/params"
|
|
|
|
```
|
|
|
|
|
|
|
|
Example Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
|
|
|
"params": {
|
|
|
|
"mintDenom": "stake",
|
|
|
|
"inflationRateChange": "130000000000000000",
|
|
|
|
"inflationMax": "200000000000000000",
|
|
|
|
"inflationMin": "70000000000000000",
|
|
|
|
"goalBonded": "670000000000000000",
|
|
|
|
"blocksPerYear": "6311520"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
```
|