github.com/Finschia/finschia-sdk@v0.48.1/x/mint/spec/06_client.md (about)

     1  <!--
     2  order: 6
     3  -->
     4  
     5  # Client
     6  
     7  ## CLI
     8  
     9  A user can query and interact with the `mint` module using the CLI.
    10  
    11  ### Query
    12  
    13  The `query` commands allow users to query `mint` state.
    14  
    15  ```
    16  simd query mint --help
    17  ```
    18  
    19  #### annual-provisions
    20  
    21  The `annual-provisions` command allow users to query the current minting annual provisions value
    22  
    23  ```
    24  simd query mint annual-provisions [flags]
    25  ```
    26  
    27  Example:
    28  
    29  ```
    30  simd query mint annual-provisions
    31  ```
    32  
    33  Example Output:
    34  
    35  ```
    36  22268504368893.612100895088410693
    37  ```
    38  
    39  #### inflation
    40  
    41  The `inflation` command allow users to query the current minting inflation value
    42  
    43  ```
    44  simd query mint inflation [flags]
    45  ```
    46  
    47  Example:
    48  
    49  ```
    50  simd query mint inflation
    51  ```
    52  
    53  Example Output:
    54  
    55  ```
    56  0.199200302563256955
    57  ```
    58  
    59  #### params
    60  
    61  The `params` command allow users to query the current minting parameters
    62  
    63  ```
    64  simd query mint params [flags]
    65  ```
    66  
    67  Example:
    68  
    69  ```
    70  blocks_per_year: "4360000"
    71  goal_bonded: "0.670000000000000000"
    72  inflation_max: "0.200000000000000000"
    73  inflation_min: "0.070000000000000000"
    74  inflation_rate_change: "0.130000000000000000"
    75  mint_denom: stake
    76  ```
    77  
    78  ## gRPC
    79  
    80  A user can query the `mint` module using gRPC endpoints.
    81  
    82  ### AnnualProvisions
    83  
    84  The `AnnualProvisions` endpoint allow users to query the current minting annual provisions value
    85  
    86  ```
    87  /cosmos.mint.v1beta1.Query/AnnualProvisions
    88  ```
    89  
    90  Example:
    91  
    92  ```
    93  grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/AnnualProvisions
    94  ```
    95  
    96  Example Output:
    97  
    98  ```
    99  {
   100    "annualProvisions": "1432452520532626265712995618"
   101  }
   102  ```
   103  
   104  ### Inflation
   105  
   106  The `Inflation` endpoint allow users to query the current minting inflation value
   107  
   108  ```
   109  /cosmos.mint.v1beta1.Query/Inflation
   110  ```
   111  
   112  Example:
   113  
   114  ```
   115  grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Inflation
   116  ```
   117  
   118  Example Output:
   119  
   120  ```
   121  {
   122    "inflation": "130197115720711261"
   123  }
   124  ```
   125  
   126  ### Params
   127  
   128  The `Params` endpoint allow users to query the current minting parameters
   129  
   130  ```
   131  /cosmos.mint.v1beta1.Query/Params
   132  ```
   133  
   134  Example:
   135  
   136  ```
   137  grpcurl -plaintext localhost:9090 cosmos.mint.v1beta1.Query/Params
   138  ```
   139  
   140  Example Output:
   141  
   142  ```
   143  {
   144    "params": {
   145      "mintDenom": "stake",
   146      "inflationRateChange": "130000000000000000",
   147      "inflationMax": "200000000000000000",
   148      "inflationMin": "70000000000000000",
   149      "goalBonded": "670000000000000000",
   150      "blocksPerYear": "6311520"
   151    }
   152  }
   153  ```
   154  
   155  ## REST
   156  
   157  A user can query the `mint` module using REST endpoints.
   158  
   159  ### annual-provisions
   160  
   161  ```
   162  /cosmos/mint/v1beta1/annual_provisions
   163  ```
   164  
   165  Example:
   166  
   167  ```
   168  curl "localhost:1317/cosmos/mint/v1beta1/annual_provisions"
   169  ```
   170  
   171  Example Output:
   172  
   173  ```
   174  {
   175    "annualProvisions": "1432452520532626265712995618"
   176  }
   177  ```
   178  
   179  ### inflation
   180  
   181  ```
   182  /cosmos/mint/v1beta1/inflation
   183  ```
   184  
   185  Example:
   186  
   187  ```
   188  curl "localhost:1317/cosmos/mint/v1beta1/inflation"
   189  ```
   190  
   191  Example Output:
   192  
   193  ```
   194  {
   195    "inflation": "130197115720711261"
   196  }
   197  ```
   198  
   199  ### params
   200  
   201  ```
   202  /cosmos/mint/v1beta1/params
   203  ```
   204  
   205  Example:
   206  
   207  ```
   208  curl "localhost:1317/cosmos/mint/v1beta1/params"
   209  ```
   210  
   211  Example Output:
   212  
   213  ```
   214  {
   215    "params": {
   216      "mintDenom": "stake",
   217      "inflationRateChange": "130000000000000000",
   218      "inflationMax": "200000000000000000",
   219      "inflationMin": "70000000000000000",
   220      "goalBonded": "670000000000000000",
   221      "blocksPerYear": "6311520"
   222    }
   223  }
   224  ```