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
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.
CommunityPool
CommunityPool queries the community pool coins.
Request
QueryCommunityPoolRequest:
This message has no fields.
Response QueryCommunityPoolResponse:
DelegationRewards
DelegationRewards queries the total rewards accrued by a delegation.
Request
QueryDelegationRewardsRequest:
Response
QueryDelegationRewardsResponse:
DelegationTotalRewards
DelegationTotalRewards queries the total rewards accrued by each validator.
Request
QueryDelegationTotalRewardsRequest:
Response
QueryDelegationTotalRewardsResponse:
DelegatorStartingInfo
DelegatorStartingInfo queries the starting info for a delegator.
Request
QueryDelegatorStartingInfoRequest:
Response
QueryDelegatorStartingInfoResponse:
DelegatorValidators
DelegatorValidators queries the validators of a delegator.
Request
QueryDelegatorValidatorsRequest:
Response
QueryDelegatorValidatorsResponse:
DelegatorWithdrawAddress
DelegatorWithdrawAddress queries withdraw address of a delegator.
Request
QueryDelegatorWithdrawAddressRequest:
Response
QueryDelegatorWithdrawAddressResponse:
Params
Params queries params of the distribution module.
Request
QueryParamsRequest:
This message has no fields.
Response QueryParamsResponse:
ValidatorCommission
ValidatorCommission queries accumulated commission for a validator.
Request
QueryValidatorCommissionRequest:
Response
QueryValidatorCommissionResponse:
ValidatorCurrentRewards
ValidatorCurrentRewards queries current rewards for a validator.
Request
QueryValidatorCurrentRewardsRequest:
Response
QueryValidatorCurrentRewardsResponse:
ValidatorDistributionInfo
ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator
Request
QueryValidatorDistributionInfoRequest:
Response
QueryValidatorDistributionInfoResponse:
ValidatorHistoricalRewards
ValidatorHistoricalRewards queries historical rewards for a validator at a specific period.
Request
QueryValidatorHistoricalRewardsRequest:
Response
QueryValidatorHistoricalRewardsResponse:
ValidatorOutstandingRewards
ValidatorOutstandingRewards queries rewards of a validator address.
Request
QueryValidatorOutstandingRewardsRequest:
Response
QueryValidatorOutstandingRewardsResponse:
ValidatorSlashes
ValidatorSlashes queries slash events of a validator.
Request
QueryValidatorSlashesRequest:
Response
QueryValidatorSlashesResponse:
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
CommunityPoolSpend
CommunityPoolSpend defines a governance operation for sending tokens from the community pool in the x/distribution module to another account, which could be the governance module itself. The authority is defined in the keeper.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.
In a transaction:
MsgCommunityPoolSpendResponse:
This message has no fields.
DepositValidatorRewardsPool
DepositValidatorRewardsPool defines a method to provide additional rewards to delegators to a specific validator.
In a transaction:
MsgDepositValidatorRewardsPoolResponse:
This message has no fields.
FundCommunityPool
FundCommunityPool defines a method to allow an account to directly fund the community pool.
In a transaction:
MsgFundCommunityPoolResponse:
This message has no fields.
SetWithdrawAddress
SetWithdrawAddress defines a method to change the withdraw address for a delegator (or validator self-delegation).
In a transaction:
MsgSetWithdrawAddressResponse:
This message has no fields.
UpdateParams
UpdateParams defines a governance operation for updating the x/distribution module parameters. The authority is defined in the keeper.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.
In a transaction:
MsgUpdateParamsResponse:
This message has no fields.
WithdrawDelegatorReward
WithdrawDelegatorReward defines a method to withdraw rewards of delegator from a single validator.
In a transaction:
MsgWithdrawDelegatorRewardResponse:
WithdrawValidatorCommission
WithdrawValidatorCommission defines a method to withdraw the full commission to the validator address.
In a transaction:
MsgWithdrawValidatorCommissionResponse:
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; }