Skip to main content
Generated from cosmos/cosmos-sdk@c1126e4e5460 on ref main.

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.

Allowance

Allowance returns granted allowance to the grantee by the granter. Request QueryAllowanceRequest: Response QueryAllowanceResponse:

Allowances

Allowances returns all the grants for the given grantee address. Request QueryAllowancesRequest: Response QueryAllowancesResponse:

AllowancesByGranter

AllowancesByGranter returns all the grants given by an address Request QueryAllowancesByGranterRequest: Response QueryAllowancesByGranterResponse:

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

GrantAllowance

GrantAllowance grants fee allowance to the grantee on the granter’s account with the provided expiration time. In a transaction:
Response MsgGrantAllowanceResponse: This message has no fields.

PruneAllowances

PruneAllowances prunes expired fee allowances, currently up to 75 at a time. In a transaction:
Response MsgPruneAllowancesResponse: This message has no fields.

RevokeAllowance

RevokeAllowance revokes any fee allowance of granter’s account that has been granted to the grantee. In a transaction:
Response MsgRevokeAllowanceResponse: 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.base.query.v1beta1.PageRequest

PageRequest is to be embedded in gRPC request messages for efficient pagination. Ex: message SomeRequest { Foo some_parameter = 1; PageRequest pagination = 2; }

cosmos.base.query.v1beta1.PageResponse

PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }

cosmos.feegrant.v1beta1.Grant

Grant is stored in the KVStore to record a grant with full context