> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmos.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Mint

> gRPC queries and transaction messages defined by the mint module in Cosmos SDK v0.55.

<Info>
  Generated from [`cosmos/cosmos-sdk@2086680ff8b0`](https://github.com/cosmos/cosmos-sdk/tree/2086680ff8b08fd269ee653e087ea577bab79534/proto) on ref `release/v0.55.x`.
</Info>

## 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](/sdk/latest/learn/concepts/transactions#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](/sdk/latest/api-reference/grpc/index) 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. |

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
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. |

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
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`](#cosmos-mint-v1beta1-params) | params defines the parameters of the module. |

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Params
```

## Transaction messages

These messages are included in signed transactions, not called as endpoints. See [Transactions](/sdk/latest/learn/concepts/transactions#transactions) for the execution model, and [Sending transactions](/sdk/latest/api-reference/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](/sdk/latest/api-reference/grpc/index#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`    |

<Note>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.</Note>

| 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`](#cosmos-mint-v1beta1-params) | params defines the x/mint parameters to update. NOTE: All parameters must be supplied.                                     |

In a transaction:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "@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.    |