Mint

Generated from cosmos/cosmos-sdk@2086680ff8b0 on ref release/v0.55.x.

Queries

A node exposes only the services its application registers:

gRPC on port 9090
REST on port 1317, if the method has an HTTP binding

Run grpcurl -plaintext localhost:9090 list to see what a node serves. Queries are read-only and never pass through consensus. See Queries. Replace <string> placeholders with real values and omit unused filters. Payloads use protobuf JSON, and some string fields accept enum constants listed under Types. Field tables give the encoding each value takes. Examples assume a local node. For TLS endpoints, use port 443 and omit -plaintext. See gRPC services for reflection, address formats, and decimal encoding.

AnnualProvisions

AnnualProvisions current minting annual provisions value.


gRPC	`cosmos.mint.v1beta1.Query/AnnualProvisions`
REST	`GET /cosmos/mint/v1beta1/annual_provisions`

Request QueryAnnualProvisionsRequest: This message has no fields. Response QueryAnnualProvisionsResponse:

Field	Type	Description
`annual_provisions`	`bytes`	annual_provisions is the current minting annual provisions value. Encoded as cosmos.Dec, read back as base64 of an integer string scaled by 10^18 over gRPC.

grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/AnnualProvisions

Inflation

Inflation returns the current minting inflation value.


gRPC	`cosmos.mint.v1beta1.Query/Inflation`
REST	`GET /cosmos/mint/v1beta1/inflation`

Request QueryInflationRequest: This message has no fields. Response QueryInflationResponse:

Field	Type	Description
`inflation`	`bytes`	inflation is the current minting inflation value. Encoded as cosmos.Dec, read back as base64 of an integer string scaled by 10^18 over gRPC.

grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Inflation

Params

Params returns the total set of minting parameters.


gRPC	`cosmos.mint.v1beta1.Query/Params`
REST	`GET /cosmos/mint/v1beta1/params`

Request QueryParamsRequest: This message has no fields. Response QueryParamsResponse:

Field	Type	Description
`params`	`Params`	params defines the parameters of the module.

grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Params

Transaction messages

These messages are included in signed transactions, not called as endpoints. See Transactions for the execution model, and Sending transactions for the envelope they go into. Examples use CLI transaction JSON. Decimal fields use values such as "0.05", even when their proto type is bytes. The gRPC TxEncode method instead requires the scaled value "50000000000000000". See scalar encodings.

Handler: Generated client method
Signer: Account that must sign
Amino name: Legacy identifier used by hardware wallets and other Amino signers

UpdateParams

UpdateParams defines a governance operation for updating the x/mint module parameters. The authority is defaults to the x/gov module account.


Type URL	`/cosmos.mint.v1beta1.MsgUpdateParams`
Handler	`cosmos.mint.v1beta1.Msg/UpdateParams`
Signer	`authority`
Amino name	`cosmos-sdk/x/mint/MsgUpdateParams`

The signer is the governance module account, which no user holds a key for. This message executes only through a passed governance proposal, not as a transaction you submit directly.

Field	Type	Description
`authority`	`string`	authority is the address that controls the module (defaults to x/gov unless overwritten). Encoded as cosmos.AddressString.
`params`	`Params`	params defines the x/mint parameters to update. NOTE: All parameters must be supplied.

In a transaction:

{
  "@type": "/cosmos.mint.v1beta1.MsgUpdateParams",
  "authority": "<string>",
  "params": {
    "mint_denom": "<string>",
    "inflation_rate_change": "<string>",
    "inflation_max": "<string>",
    "inflation_min": "<string>",
    "goal_bonded": "<string>",
    "blocks_per_year": "1",
    "max_supply": "<string>"
  }
}

Response MsgUpdateParamsResponse: This message has no fields.

Types

Messages referenced by the fields above. Protocol buffers version 3 has no required fields, so every field is optional on the wire, and a [] suffix marks a repeated field.

cosmos.mint.v1beta1.Params

Params defines the parameters for the x/mint module.

Field	Type	Description
`mint_denom`	`string`	type of coin to mint
`inflation_rate_change`	`string`	maximum annual change in inflation rate Encoded as cosmos.Dec, read back as an integer string scaled by 10^18 over gRPC.
`inflation_max`	`string`	maximum inflation rate Encoded as cosmos.Dec, read back as an integer string scaled by 10^18 over gRPC.
`inflation_min`	`string`	minimum inflation rate Encoded as cosmos.Dec, read back as an integer string scaled by 10^18 over gRPC.
`goal_bonded`	`string`	goal of percent bonded atoms Encoded as cosmos.Dec, read back as an integer string scaled by 10^18 over gRPC.
`blocks_per_year`	`uint64`	expected blocks per year
`max_supply`	`string`	maximum supply for the token. A value of “0” indicates an unlimited (infinite) maximum supply. Encoded as cosmos.Int.

Overview

gRPC Services

REST (gRPC Gateway)

Queries

AnnualProvisions

Inflation

Params

Transaction messages

UpdateParams

Types

cosmos.mint.v1beta1.Params

​Queries

​AnnualProvisions

​Inflation

​Params

​Transaction messages

​UpdateParams

​Types

​cosmos.mint.v1beta1.Params

Queries

AnnualProvisions

Inflation

Params

Transaction messages

UpdateParams

Types

cosmos.mint.v1beta1.Params