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.

cosmos.base.node.v1beta1.Service

Service defines the gRPC querier service for node related queries.

Config

Config queries for the operator configuration. Request ConfigRequest: This message has no fields. Response ConfigResponse:

Status

Status queries for the node status. Request StatusRequest: This message has no fields. Response StatusResponse:

cosmos.base.reflection.v1beta1.ReflectionService

ReflectionService defines a service for interface reflection.

ListAllInterfaces

ListAllInterfaces lists all the interfaces registered in the interface registry. Request ListAllInterfacesRequest: This message has no fields. Response ListAllInterfacesResponse:

ListImplementations

ListImplementations list all the concrete types that implement a given interface. Request ListImplementationsRequest: Response ListImplementationsResponse:

cosmos.base.reflection.v2alpha1.ReflectionService

ReflectionService defines a service for application reflection.

GetAuthnDescriptor

GetAuthnDescriptor returns information on how to authenticate transactions in the application NOTE: this RPC is still experimental and might be subject to breaking changes or removal in future releases of the cosmos-sdk. Request GetAuthnDescriptorRequest: This message has no fields. Response GetAuthnDescriptorResponse:

GetChainDescriptor

GetChainDescriptor returns the description of the chain Request GetChainDescriptorRequest: This message has no fields. Response GetChainDescriptorResponse:

GetCodecDescriptor

GetCodecDescriptor returns the descriptor of the codec of the application Request GetCodecDescriptorRequest: This message has no fields. Response GetCodecDescriptorResponse:

GetConfigurationDescriptor

GetConfigurationDescriptor returns the descriptor for the sdk.Config of the application Request GetConfigurationDescriptorRequest: This message has no fields. Response GetConfigurationDescriptorResponse:

GetQueryServicesDescriptor

GetQueryServicesDescriptor returns the available gRPC queryable services of the application Request GetQueryServicesDescriptorRequest: This message has no fields. Response GetQueryServicesDescriptorResponse:

GetTxDescriptor

GetTxDescriptor returns information on the used transaction object and available msgs that can be used Request GetTxDescriptorRequest: This message has no fields. Response GetTxDescriptorResponse:

cosmos.base.tendermint.v1beta1.Service

Service defines the gRPC querier service for tendermint queries.

ABCIQuery

ABCIQuery defines a query handler that supports ABCI queries directly to the application, bypassing Tendermint completely. The ABCI query must contain a valid and supported path, including app, custom, p2p, and store. Request ABCIQueryRequest: Response ABCIQueryResponse:

GetBlockByHeight

GetBlockByHeight queries block for given height. Request GetBlockByHeightRequest: Response GetBlockByHeightResponse:

GetBlockResults

GetBlockResults queries block results for given height. Request GetBlockResultsRequest: Response GetBlockResultsResponse:

GetLatestBlock

GetLatestBlock returns the latest block. Request GetLatestBlockRequest: This message has no fields. Response GetLatestBlockResponse:

GetLatestBlockResults

GetLatestBlockResults returns the block results for the latest block. Block results contain finalize_block_events which include consensus-level events like slashing, jailing, and validator set updates. Request GetLatestBlockResultsRequest: This message has no fields. Response GetLatestBlockResultsResponse:

GetLatestValidatorSet

GetLatestValidatorSet queries latest validator-set. Request GetLatestValidatorSetRequest: Response GetLatestValidatorSetResponse:

GetNodeInfo

GetNodeInfo queries the current node info. Request GetNodeInfoRequest: This message has no fields. Response GetNodeInfoResponse:

GetSyncing

GetSyncing queries node syncing. Request GetSyncingRequest: This message has no fields. Response GetSyncingResponse:

GetValidatorSetByHeight

GetValidatorSetByHeight queries validator-set at a given height. Request GetValidatorSetByHeightRequest: Response GetValidatorSetByHeightResponse:

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.base.reflection.v2alpha1.AuthnDescriptor

AuthnDescriptor provides information on how to sign transactions without relying on the online RPCs GetTxMetadata and CombineUnsignedTxAndSignatures

cosmos.base.reflection.v2alpha1.ChainDescriptor

ChainDescriptor describes chain information of the application

cosmos.base.reflection.v2alpha1.CodecDescriptor

CodecDescriptor describes the registered interfaces and provides metadata information on the types

cosmos.base.reflection.v2alpha1.ConfigurationDescriptor

ConfigurationDescriptor contains metadata information on the sdk.Config

cosmos.base.reflection.v2alpha1.InterfaceAcceptingMessageDescriptor

InterfaceAcceptingMessageDescriptor describes a protobuf message which contains an interface represented as a google.protobuf.Any

cosmos.base.reflection.v2alpha1.InterfaceDescriptor

InterfaceDescriptor describes the implementation of an interface

cosmos.base.reflection.v2alpha1.InterfaceImplementerDescriptor

InterfaceImplementerDescriptor describes an interface implementer

cosmos.base.reflection.v2alpha1.MsgDescriptor

MsgDescriptor describes a cosmos-sdk message that can be delivered with a transaction

cosmos.base.reflection.v2alpha1.QueryMethodDescriptor

QueryMethodDescriptor describes a queryable method of a query service no other info is provided beside method name and tendermint queryable path because it would be redundant with the grpc reflection service

cosmos.base.reflection.v2alpha1.QueryServiceDescriptor

QueryServiceDescriptor describes a cosmos-sdk queryable service

cosmos.base.reflection.v2alpha1.QueryServicesDescriptor

QueryServicesDescriptor contains the list of cosmos-sdk queryable services

cosmos.base.reflection.v2alpha1.SigningModeDescriptor

SigningModeDescriptor provides information on a signing flow of the application NOTE(fdymylja): here we could go as far as providing an entire flow on how to sign a message given a SigningModeDescriptor, but it’s better to think about this another time

cosmos.base.reflection.v2alpha1.TxDescriptor

TxDescriptor describes the accepted transaction type

cosmos.base.tendermint.v1beta1.Block

Block is tendermint type Block, with the Header proposer address field converted to bech32 string.

cosmos.base.tendermint.v1beta1.Header

Header defines the structure of a Tendermint block header.

cosmos.base.tendermint.v1beta1.Module

Module is the type for VersionInfo

cosmos.base.tendermint.v1beta1.ProofOp

ProofOp defines an operation used for calculating Merkle root. The data could be arbitrary format, providing necessary data for example neighbouring node hash. Note: This type is a duplicate of the ProofOp proto type defined in Tendermint.

cosmos.base.tendermint.v1beta1.ProofOps

ProofOps is Merkle proof defined by the list of ProofOps. Note: This type is a duplicate of the ProofOps proto type defined in Tendermint.

cosmos.base.tendermint.v1beta1.Validator

Validator is the type for the validator-set.

cosmos.base.tendermint.v1beta1.VersionInfo

VersionInfo is the type for the GetNodeInfoResponse message.