Protocol Documentation

elems

MultiSignature

MultiSignature wraps the signatures from a multisig.LegacyAminoPubKey. See cosmos.tx.v1betata1.ModeInfo.Multi for how to specify which signers signed and with which modes.

Field

Type

Label

Description

signatures

repeated

cosmos/crypto/multisig/keys.proto

LegacyAminoPubKey

LegacyAminoPubKey specifies a public key type which nests multiple public keys and a threshold, it uses legacy amino address rules.

Field

Type

Label

Description

threshold

public_keys

repeated

cosmos/crypto/secp256k1/keys.proto

PrivKey

PrivKey defines a secp256k1 private key.

Field

Type

Label

Description

key

PubKey

PubKey defines a secp256k1 public key Key is the compressed form of the pubkey. The first byte depends is a 0x02 byte if the y-coordinate is the lexicographically largest of the two associated with the x-coordinate. Otherwise the first byte is a 0x03. This prefix is followed with the x-coordinate.

Field

Type

Label

Description

key

cosmos/crypto/ed25519/keys.proto

PrivKey

PrivKey defines a ed25519 private key.

Field

Type

Label

Description

key

PubKey

PubKey defines a ed25519 public key Key is the compressed form of the pubkey. The first byte depends is a 0x02 byte if the y-coordinate is the lexicographically largest of the two associated with the x-coordinate. Otherwise the first byte is a 0x03. This prefix is followed with the x-coordinate.

Field

Type

Label

Description

key

cosmos/upgrade/v1beta1/upgrade.proto

CancelSoftwareUpgradeProposal

CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade.

Field

Type

Label

Description

title

description

Plan

Plan specifies information about a planned upgrade and when it should occur.

Field

Type

Label

Description

name

Sets the name for the upgrade. This name will be used by the upgraded version of the software to apply any special "on-upgrade" commands during the first BeginBlock method after the upgrade is applied. It is also used to detect whether a software version can handle a given upgrade. If no upgrade handler with this name has been set in the software, it will be assumed that the software is out-of-date when the upgrade Time or Height is reached and the software will exit.

time

The time after which the upgrade must be performed. Leave set to its zero value to use a pre-defined Height instead.

height

The height at which the upgrade must be performed. Only used if Time is not set.

info

Any application specific upgrade info to be included on-chain such as a git commit that validators could automatically upgrade to

upgraded_client_state

IBC-enabled chains can opt-in to including the upgraded client state in its upgrade plan This will make the chain commit to the correct upgraded (self) client state before the upgrade occurs, so that connecting chains can verify that the new upgraded client is valid by verifying a proof on the previous version of the chain. This will allow IBC connections to persist smoothly across planned chain upgrades

SoftwareUpgradeProposal

SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade.

Field

Type

Label

Description

title

description

plan

cosmos/upgrade/v1beta1/query.proto

QueryAppliedPlanRequest

QueryCurrentPlanRequest is the request type for the Query/AppliedPlan RPC method.

Field

Type

Label

Description

name

name is the name of the applied plan to query for.

QueryAppliedPlanResponse

QueryAppliedPlanResponse is the response type for the Query/AppliedPlan RPC method.

Field

Type

Label

Description

height

height is the block height at which the plan was applied.

QueryCurrentPlanRequest

QueryCurrentPlanRequest is the request type for the Query/CurrentPlan RPC method.

QueryCurrentPlanResponse

QueryCurrentPlanResponse is the response type for the Query/CurrentPlan RPC method.

Field

Type

Label

Description

plan

Plan

plan is the current upgrade plan.

Query

Query defines the gRPC upgrade querier service.

Method Name

Request Type

Response Type

Description

CurrentPlan

QueryCurrentPlanRequest

QueryCurrentPlanResponse

CurrentPlan queries the current upgrade plan.

AppliedPlan

QueryAppliedPlanRequest

QueryAppliedPlanResponse

AppliedPlan queries a previously applied upgrade plan by its name.

cosmos/mint/v1beta1/query.proto

QueryAnnualProvisionsRequest

QueryAnnualProvisionsRequest is the request type for the Query/AnnualProvisions RPC method.

QueryAnnualProvisionsResponse

QueryAnnualProvisionsResponse is the response type for the Query/AnnualProvisions RPC method.

Field

Type

Label

Description

annual_provisions

annual_provisions is the current minting annual provisions value.

QueryInflationRequest

QueryInflationRequest is the request type for the Query/Inflation RPC method.

QueryInflationResponse

QueryInflationResponse is the response type for the Query/Inflation RPC method.

Field

Type

Label

Description

inflation

inflation is the current minting inflation value.

QueryParamsRequest

QueryParamsRequest is the request type for the Query/Params RPC method.

QueryParamsResponse

QueryParamsResponse is the response type for the Query/Params RPC method.

Field

Type

Label

Description

params

params defines the parameters of the module.

Query

Query provides defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

Params

QueryAnnualProvisionsRequest

Params returns the total set of minting parameters.

Inflation

QueryInflationRequest

QueryInflationResponse

Inflation returns the current minting inflation value.

AnnualProvisions

QueryAnnualProvisionsResponse

AnnualProvisions current minting annual provisions value.

cosmos/mint/v1beta1/genesis.proto

GenesisState

GenesisState defines the mint module's genesis state.

Field

Type

Label

Description

minter

Minter

minter is a space for holding current inflation information.

params

params defines all the paramaters of the module.

cosmos/mint/v1beta1/mint.proto

Minter

Minter represents the minting state.

Field

Type

Label

Description

inflation

current annual inflation rate

annual_provisions

current annual expected provisions

Params

Params holds parameters for the mint module.

Field

Type

Label

Description

mint_denom

type of coin to mint

inflation_rate_change

maximum annual change in inflation rate

inflation_max

maximum inflation rate

inflation_min

minimum inflation rate

goal_bonded

goal of percent bonded atoms

blocks_per_year

expected blocks per year

cosmos/evidence/v1beta1/tx.proto

MsgSubmitEvidence

MsgSubmitEvidence represents a message that supports submitting arbitrary Evidence of misbehavior such as equivocation or counterfactual signing.

Field

Type

Label

Description

submitter

evidence

MsgSubmitEvidenceResponse

MsgSubmitEvidenceResponse defines the Msg/SubmitEvidence response type.

Field

Type

Label

Description

hash

MsgSubmitEvidenceResponse

hash defines the hash of the evidence.

Msg

Msg defines the evidence Msg service.

Method Name

Request Type

Response Type

Description

SubmitEvidence

MsgSubmitEvidence

SubmitEvidence submits an arbitrary Evidence of misbehavior such as equivocation or counterfactual signing.

cosmos/evidence/v1beta1/evidence.proto

Equivocation

Equivocation implements the Evidence interface and defines evidence of double signing misbehavior.

Field

Type

Label

Description

height

time

power

consensus_address

cosmos/evidence/v1beta1/query.proto

QueryAllEvidenceRequest

QueryEvidenceRequest is the request type for the Query/AllEvidence RPC method.

Field

Type

Label

Description

pagination

pagination defines an optional pagination for the request.

QueryAllEvidenceResponse

QueryAllEvidenceResponse is the response type for the Query/AllEvidence RPC method.

Field

Type

Label

Description

evidence

repeated

evidence returns all evidences.

pagination

pagination defines the pagination in the response.

QueryEvidenceRequest

QueryEvidenceRequest is the request type for the Query/Evidence RPC method.

Field

Type

Label

Description

evidence_hash

evidence_hash defines the hash of the requested evidence.

QueryEvidenceResponse

QueryEvidenceResponse is the response type for the Query/Evidence RPC method.

Field

Type

Label

Description

evidence

evidence returns the requested evidence.

Query

Query defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

Evidence

QueryEvidenceRequest

QueryEvidenceResponse

Evidence queries evidence based on evidence hash.

AllEvidence

QueryAllEvidenceRequest

QueryAllEvidenceResponse

AllEvidence queries all evidence.

cosmos/evidence/v1beta1/genesis.proto

GenesisState

GenesisState defines the evidence module's genesis state.

Field

Type

Label

Description

evidence

repeated

evidence defines all the evidence at genesis.

cosmos/auth/v1beta1/query.proto

QueryAccountRequest

QueryAccountRequest is the request type for the Query/Account RPC method.

Field

Type

Label

Description

address

address defines the address to query for.

QueryAccountResponse

QueryAccountResponse is the response type for the Query/Account RPC method.

Field

Type

Label

Description

account

account defines the account of the corresponding address.

QueryParamsRequest

QueryParamsRequest is the request type for the Query/Params RPC method.

QueryParamsResponse

QueryParamsResponse is the response type for the Query/Params RPC method.

Field

Type

Label

Description

params

params defines the parameters of the module.

Query

Query defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

Account

QueryAccountRequest

QueryAccountResponse

Account returns account details based on address.

Params

Params queries all parameters.

cosmos/auth/v1beta1/genesis.proto

GenesisState

GenesisState defines the auth module's genesis state.

Field

Type

Label

Description

params

params defines all the paramaters of the module.

accounts

repeated

accounts are the accounts present at genesis.

cosmos/auth/v1beta1/auth.proto

BaseAccount

BaseAccount defines a base account type. It contains all the necessary fields for basic account functionality. Any custom account type should extend this type for additional functionality (e.g. vesting).

Field

Type

Label

Description

address

pub_key

account_number

sequence

ModuleAccount

ModuleAccount defines an account for modules that holds coins on a pool.

Field

Type

Label

Description

base_account

BaseAccount

name

permissions

repeated

Params

Params defines the parameters for the auth module.

Field

Type

Label

Description

max_memo_characters

tx_sig_limit

tx_size_cost_per_byte

sig_verify_cost_ed25519

sig_verify_cost_secp256k1

cosmos/bank/v1beta1/tx.proto

MsgMultiSend

MsgMultiSend represents an arbitrary multi-in, multi-out send message.

Field

Type

Label

Description

inputs

Input

repeated

outputs

Output

repeated

MsgMultiSendResponse

MsgMultiSendResponse defines the Msg/MultiSend response type.

MsgSend

MsgSend represents a message to send coins from one account to another.

Field

Type

Label

Description

from_address

to_address

amount

repeated

MsgSendResponse

MsgSendResponse defines the Msg/Send response type.

Msg

Msg defines the bank Msg service.

Method Name

Request Type

Response Type

Description

Send

MsgSend

MsgSendResponse

Send defines a method for sending coins from one account to another account.

MultiSend

MsgMultiSend

MsgMultiSendResponse

MultiSend defines a method for sending coins from some accounts to other accounts.

cosmos/bank/v1beta1/bank.proto

DenomUnit

DenomUnit represents a struct that describes a given denomination unit of the basic token.

Field

Type

Label

Description

denom

denom represents the string name of the given denom unit (e.g uatom).

exponent

exponent represents power of 10 exponent that one must raise the base_denom to in order to equal the given DenomUnit's denom 1 denom = 1^exponent base_denom (e.g. with a base_denom of uatom, one can create a DenomUnit of 'atom' with exponent = 6, thus: 1 atom = 10^6 uatom).

aliases

repeated

aliases is a list of string aliases for the given denom

Input

Input models transaction input.

Field

Type

Label

Description

address

coins

repeated

Metadata

Metadata represents a struct that describes a basic token.

Field

Type

Label

Description

description

denom_units

DenomUnit

repeated

denom_units represents the list of DenomUnit's for a given coin

base

base represents the base denom (should be the DenomUnit with exponent = 0).

display

display indicates the suggested denom that should be displayed in clients.

Output

Output models transaction outputs.

Field

Type

Label

Description

address

coins

repeated

Params

Params defines the parameters for the bank module.

Field

Type

Label

Description

send_enabled

SendEnabled

repeated

default_send_enabled

SendEnabled

SendEnabled maps coin denom to a send_enabled status (whether a denom is sendable).

Field

Type

Label

Description

denom

enabled

Supply

Supply represents a struct that passively keeps track of the total supply amounts in the network.

Field

Type

Label

Description

total

repeated

cosmos/bank/v1beta1/query.proto

QueryAllBalancesRequest

QueryBalanceRequest is the request type for the Query/AllBalances RPC method.

Field

Type

Label

Description

address

address is the address to query balances for.

pagination

pagination defines an optional pagination for the request.

QueryAllBalancesResponse

QueryAllBalancesResponse is the response type for the Query/AllBalances RPC method.

Field

Type

Label

Description

balances

repeated

balances is the balances of all the coins.

pagination

pagination defines the pagination in the response.

QueryBalanceRequest

QueryBalanceRequest is the request type for the Query/Balance RPC method.

Field

Type

Label

Description

address

address is the address to query balances for.

denom

denom is the coin denom to query balances for.

QueryBalanceResponse

QueryBalanceResponse is the response type for the Query/Balance RPC method.

Field

Type

Label

Description

balance

balance is the balance of the coin.

QueryParamsRequest

QueryParamsRequest defines the request type for querying x/bank parameters.

QueryParamsResponse

QueryParamsResponse defines the response type for querying x/bank parameters.

Field

Type

Label

Description

params

QuerySupplyOfRequest

QuerySupplyOfRequest is the request type for the Query/SupplyOf RPC method.

Field

Type

Label

Description

denom

denom is the coin denom to query balances for.

QuerySupplyOfResponse

QuerySupplyOfResponse is the response type for the Query/SupplyOf RPC method.

Field

Type

Label

Description

amount

amount is the supply of the coin.

QueryTotalSupplyRequest

QueryTotalSupplyRequest is the request type for the Query/TotalSupply RPC method.

QueryTotalSupplyResponse

QueryTotalSupplyResponse is the response type for the Query/TotalSupply RPC method

Field

Type

Label

Description

supply

repeated

supply is the supply of the coins

Query

Query defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

Balance

QueryBalanceRequest

QueryBalanceResponse

Balance queries the balance of a single coin for a single account.

AllBalances

QueryAllBalancesRequest

QueryAllBalancesResponse

AllBalances queries the balance of all coins for a single account.

TotalSupply

QueryTotalSupplyRequest

QueryTotalSupplyResponse

TotalSupply queries the total supply of all coins.

SupplyOf

QuerySupplyOfRequest

QuerySupplyOfResponse

SupplyOf queries the supply of a single coin.

Params

Params queries the parameters of x/bank module.

cosmos/bank/v1beta1/genesis.proto

Balance

Balance defines an account address and balance pair used in the bank module's genesis state.

Field

Type

Label

Description

address

address is the address of the balance holder.

coins

repeated

coins defines the different coins this balance holds.

GenesisState

GenesisState defines the bank module's genesis state.

Field

Type

Label

Description

params

params defines all the paramaters of the module.

balances

Balance

repeated

balances is an array containing the balances of all the accounts.

supply

repeated

supply represents the total supply.

denom_metadata

Metadata

repeated

denom_metadata defines the metadata of the differents coins.

cosmos/capability/v1beta1/capability.proto

Capability

Capability defines an implementation of an object capability. The index provided to a Capability must be globally unique.

Field

Type

Label

Description

index

CapabilityOwners

CapabilityOwners defines a set of owners of a single Capability. The set of owners must be unique.

Field

Type

Label

Description

owners

Owner

repeated

Owner

Owner defines a single capability owner. An owner is defined by the name of capability and the module name.

Field

Type

Label

Description

module

name

cosmos/capability/v1beta1/genesis.proto

GenesisOwners

GenesisOwners defines the capability owners with their corresponding index.

Field

Type

Label

Description

index

index is the index of the capability owner.

index_owners

CapabilityOwners

index_owners are the owners at the given index.

GenesisState

GenesisState defines the capability module's genesis state.

Field

Type

Label

Description

index

index is the capability global index.

owners

GenesisOwners

repeated

owners represents a map from index to owners of the capability index index key is string to allow amino marshalling.

cosmos/distribution/v1beta1/tx.proto

MsgFundCommunityPool

MsgFundCommunityPool allows an account to directly fund the community pool.

Field

Type

Label

Description

amount

repeated

depositor

MsgFundCommunityPoolResponse

MsgFundCommunityPoolResponse defines the Msg/FundCommunityPool response type.

MsgSetWithdrawAddress

MsgSetWithdrawAddress sets the withdraw address for a delegator (or validator self-delegation).

Field

Type

Label

Description

delegator_address

withdraw_address

MsgSetWithdrawAddressResponse

MsgSetWithdrawAddressResponse defines the Msg/SetWithdrawAddress response type.

MsgWithdrawDelegatorReward

MsgWithdrawDelegatorReward represents delegation withdrawal to a delegator from a single validator.

Field

Type

Label

Description

delegator_address

validator_address

MsgWithdrawDelegatorRewardResponse

MsgWithdrawDelegatorRewardResponse defines the Msg/WithdrawDelegatorReward response type.

MsgWithdrawValidatorCommission

MsgWithdrawValidatorCommission withdraws the full commission to the validator address.

Field

Type

Label

Description

validator_address

MsgSetWithdrawAddressResponse

MsgWithdrawValidatorCommissionResponse

MsgWithdrawValidatorCommissionResponse defines the Msg/WithdrawValidatorCommission response type.

Msg

Msg defines the distribution Msg service.

Method Name

Request Type

Response Type

Description

SetWithdrawAddress

MsgSetWithdrawAddress

SetWithdrawAddress defines a method to change the withdraw address for a delegator (or validator self-delegation).

WithdrawDelegatorReward

MsgWithdrawDelegatorReward

MsgWithdrawDelegatorRewardResponse

WithdrawDelegatorReward defines a method to withdraw rewards of delegator from a single validator.

WithdrawValidatorCommission

MsgWithdrawValidatorCommission

MsgWithdrawValidatorCommissionResponse

WithdrawValidatorCommission defines a method to withdraw the full commission to the validator address.

FundCommunityPool

MsgFundCommunityPool

MsgFundCommunityPoolResponse

FundCommunityPool defines a method to allow an account to directly fund the community pool.

cosmos/distribution/v1beta1/distribution.proto

CommunityPoolSpendProposal

CommunityPoolSpendProposal details a proposal for use of community funds, together with how many coins are proposed to be spent, and to which recipient account.

Field

Type

Label

Description

title

description

recipient

amount

repeated

CommunityPoolSpendProposalWithDeposit

CommunityPoolSpendProposalWithDeposit defines a CommunityPoolSpendProposal with a deposit

Field

Type

Label

Description

title

description

recipient

amount

deposit

DelegationDelegatorReward

DelegationDelegatorReward represents the properties of a delegator's delegation reward.

Field

Type

Label

Description

validator_address

reward

repeated

DelegatorStartingInfo

DelegatorStartingInfo represents the starting info for a delegator reward period. It tracks the previous validator period, the delegation's amount of staking token, and the creation height (to check later on if any slashes have occurred). NOTE: Even though validators are slashed to whole staking tokens, the delegators within the validator may be left with less than a full token, thus sdk.Dec is used.

Field

Type

Label

Description

previous_period

stake

height

FeePool

FeePool is the global fee pool for distribution.

Field

Type

Label

Description

community_pool

repeated

Params

Params defines the set of params for the distribution module.

Field

Type

Label

Description

community_tax

base_proposer_reward

bonus_proposer_reward

withdraw_addr_enabled

ValidatorAccumulatedCommission

ValidatorAccumulatedCommission represents accumulated commission for a validator kept as a running counter, can be withdrawn at any time.

Field

Type

Label

Description

commission

repeated

ValidatorCurrentRewards

ValidatorCurrentRewards represents current rewards and current period for a validator kept as a running counter and incremented each block as long as the validator's tokens remain constant.

Field

Type

Label

Description

rewards

repeated

period

ValidatorHistoricalRewards

ValidatorHistoricalRewards represents historical rewards for a validator. Height is implicit within the store key. Cumulative reward ratio is the sum from the zeroeth period until this period of rewards / tokens, per the spec. The reference count indicates the number of objects which might need to reference this historical entry at any point. ReferenceCount = number of outstanding delegations which ended the associated period (and might need to read that record) + number of slashes which ended the associated period (and might need to read that record) + one per validator for the zeroeth period, set on initialization

Field

Type

Label

Description

cumulative_reward_ratio

repeated

reference_count

ValidatorOutstandingRewards

ValidatorOutstandingRewards represents outstanding (un-withdrawn) rewards for a validator inexpensive to track, allows simple sanity checks.

Field

Type

Label

Description

rewards

repeated

ValidatorSlashEvent

ValidatorSlashEvent represents a validator slash event. Height is implicit within the store key. This is needed to calculate appropriate amount of staking tokens for delegations which are withdrawn after a slash has occurred.

Field

Type

Label

Description

validator_period

fraction

ValidatorSlashEvents

ValidatorSlashEvents is a collection of ValidatorSlashEvent messages.

Field

Type

Label

Description

validator_slash_events

ValidatorSlashEvent

repeated

cosmos/distribution/v1beta1/query.proto

QueryCommunityPoolRequest

QueryCommunityPoolRequest is the request type for the Query/CommunityPool RPC method.

QueryCommunityPoolResponse

QueryCommunityPoolResponse is the response type for the Query/CommunityPool RPC method.

Field

Type

Label

Description

pool

repeated

pool defines community pool's coins.

QueryDelegationRewardsRequest

QueryDelegationRewardsRequest is the request type for the Query/DelegationRewards RPC method.

Field

Type

Label

Description

delegator_address

delegator_address defines the delegator address to query for.

validator_address

validator_address defines the validator address to query for.

QueryDelegationRewardsResponse

QueryDelegationRewardsResponse is the response type for the Query/DelegationRewards RPC method.

Field

Type

Label

Description

rewards

repeated

rewards defines the rewards accrued by a delegation.

QueryDelegationTotalRewardsRequest

QueryDelegationTotalRewardsRequest is the request type for the Query/DelegationTotalRewards RPC method.

Field

Type

Label

Description

delegator_address

DelegationDelegatorReward

delegator_address defines the delegator address to query for.

QueryDelegationTotalRewardsResponse

QueryDelegationTotalRewardsResponse is the response type for the Query/DelegationTotalRewards RPC method.

Field

Type

Label

Description

rewards

repeated

rewards defines all the rewards accrued by a delegator.

total

repeated

total defines the sum of all the rewards.

QueryDelegatorValidatorsRequest

QueryDelegatorValidatorsRequest is the request type for the Query/DelegatorValidators RPC method.

Field

Type

Label

Description

delegator_address

delegator_address defines the delegator address to query for.

QueryDelegatorValidatorsResponse

QueryDelegatorValidatorsResponse is the response type for the Query/DelegatorValidators RPC method.

Field

Type

Label

Description

validators

repeated

validators defines the validators a delegator is delegating for.

QueryDelegatorWithdrawAddressRequest

QueryDelegatorWithdrawAddressRequest is the request type for the Query/DelegatorWithdrawAddress RPC method.

Field

Type

Label

Description

delegator_address

delegator_address defines the delegator address to query for.

QueryDelegatorWithdrawAddressResponse

QueryDelegatorWithdrawAddressResponse is the response type for the Query/DelegatorWithdrawAddress RPC method.

Field

Type

Label

Description

withdraw_address

withdraw_address defines the delegator address to query for.

QueryParamsRequest

QueryParamsRequest is the request type for the Query/Params RPC method.

QueryParamsResponse

QueryParamsResponse is the response type for the Query/Params RPC method.

Field

Type

Label

Description

params

params defines the parameters of the module.

QueryValidatorCommissionRequest

QueryValidatorCommissionRequest is the request type for the Query/ValidatorCommission RPC method

Field

Type

Label

Description

validator_address

ValidatorAccumulatedCommission

validator_address defines the validator address to query for.

QueryValidatorCommissionResponse

QueryValidatorCommissionResponse is the response type for the Query/ValidatorCommission RPC method

Field

Type

Label

Description

commission

commission defines the commision the validator received.

QueryValidatorOutstandingRewardsRequest

QueryValidatorOutstandingRewardsRequest is the request type for the Query/ValidatorOutstandingRewards RPC method.

Field

Type

Label

Description

validator_address

ValidatorOutstandingRewards

validator_address defines the validator address to query for.

QueryValidatorOutstandingRewardsResponse

QueryValidatorOutstandingRewardsResponse is the response type for the Query/ValidatorOutstandingRewards RPC method.

Field

Type

Label

Description

rewards

QueryValidatorSlashesRequest

QueryValidatorSlashesRequest is the request type for the Query/ValidatorSlashes RPC method

Field

Type

Label

Description

validator_address

validator_address defines the validator address to query for.

starting_height

starting_height defines the optional starting height to query the slashes.

ending_height

starting_height defines the optional ending height to query the slashes.

pagination

pagination defines an optional pagination for the request.

QueryValidatorSlashesResponse

QueryValidatorSlashesResponse is the response type for the Query/ValidatorSlashes RPC method.

Field

Type

Label

Description

slashes

ValidatorSlashEvent

repeated

slashes defines the slashes the validator received.

pagination

pagination defines the pagination in the response.

Query

Query defines the gRPC querier service for distribution module.

Method Name

Request Type

Response Type

Description

Params

QueryValidatorOutstandingRewardsRequest

Params queries params of the distribution module.

ValidatorOutstandingRewards

QueryValidatorOutstandingRewardsResponse

ValidatorOutstandingRewards queries rewards of a validator address.

ValidatorCommission

QueryValidatorCommissionRequest

QueryValidatorCommissionResponse

ValidatorCommission queries accumulated commission for a validator.

ValidatorSlashes

QueryValidatorSlashesRequest

QueryValidatorSlashesResponse

ValidatorSlashes queries slash events of a validator.

DelegationRewards

QueryDelegationRewardsRequest

QueryDelegationRewardsResponse

DelegationRewards queries the total rewards accrued by a delegation.

DelegationTotalRewards

QueryDelegationTotalRewardsRequest

QueryDelegationTotalRewardsResponse

DelegationTotalRewards queries the total rewards accrued by a each validator.

DelegatorValidators

QueryDelegatorValidatorsRequest

QueryDelegatorValidatorsResponse

DelegatorValidators queries the validators of a delegator.

DelegatorWithdrawAddress

QueryDelegatorWithdrawAddressRequest

QueryDelegatorWithdrawAddressResponse

DelegatorWithdrawAddress queries withdraw address of a delegator.

CommunityPool

QueryCommunityPoolRequest

QueryCommunityPoolResponse

CommunityPool queries the community pool coins.

cosmos/distribution/v1beta1/genesis.proto

DelegatorStartingInfoRecord

DelegatorStartingInfoRecord used for import / export via genesis json.

Field

Type

Label

Description

delegator_address

delegator_address is the address of the delegator.

validator_address

validator_address is the address of the validator.

starting_info

DelegatorStartingInfo

starting_info defines the starting info of a delegator.

DelegatorWithdrawInfo

DelegatorWithdrawInfo is the address for where distributions rewards are withdrawn to by default this struct is only used at genesis to feed in default withdraw addresses.

Field

Type

Label

Description

delegator_address

delegator_address is the address of the delegator.

withdraw_address

withdraw_address is the address to withdraw the delegation rewards to.

GenesisState

GenesisState defines the distribution module's genesis state.

Field

Type

Label

Description

params

params defines all the paramaters of the module.

fee_pool

FeePool

fee_pool defines the fee pool at genesis.

delegator_withdraw_infos

DelegatorWithdrawInfo

repeated

fee_pool defines the delegator withdraw infos at genesis.

previous_proposer

ValidatorOutstandingRewardsRecord

fee_pool defines the previous proposer at genesis.

outstanding_rewards

repeated

fee_pool defines the outstanding rewards of all validators at genesis.

validator_accumulated_commissions

ValidatorAccumulatedCommissionRecord

repeated

fee_pool defines the accumulated commisions of all validators at genesis.

validator_historical_rewards

ValidatorHistoricalRewardsRecord

repeated

fee_pool defines the historical rewards of all validators at genesis.

validator_current_rewards

ValidatorCurrentRewardsRecord

repeated

fee_pool defines the current rewards of all validators at genesis.

delegator_starting_infos

DelegatorStartingInfoRecord

repeated

fee_pool defines the delegator starting infos at genesis.

validator_slash_events

ValidatorSlashEventRecord

repeated

fee_pool defines the validator slash events at genesis.

ValidatorAccumulatedCommissionRecord

ValidatorAccumulatedCommissionRecord is used for import / export via genesis json.

Field

Type

Label

Description

validator_address

ValidatorAccumulatedCommission

validator_address is the address of the validator.

accumulated

accumulated is the accumulated commission of a validator.

ValidatorCurrentRewardsRecord

ValidatorCurrentRewardsRecord is used for import / export via genesis json.

Field

Type

Label

Description

validator_address

validator_address is the address of the validator.

rewards

ValidatorCurrentRewards

rewards defines the current rewards of a validator.

ValidatorHistoricalRewardsRecord

ValidatorHistoricalRewardsRecord is used for import / export via genesis json.

Field

Type

Label

Description

validator_address

validator_address is the address of the validator.

period

ValidatorHistoricalRewards

period defines the period the historical rewards apply to.

rewards

rewards defines the historical rewards of a validator.

ValidatorOutstandingRewardsRecord

ValidatorOutstandingRewardsRecord is used for import/export via genesis json.

Field

Type

Label

Description

validator_address

validator_address is the address of the validator.

outstanding_rewards

repeated

outstanding_rewards represents the oustanding rewards of a validator.

ValidatorSlashEventRecord

ValidatorSlashEventRecord is used for import / export via genesis json.

Field

Type

Label

Description

validator_address

validator_address is the address of the validator.

height

height defines the block height at which the slash event occured.

period

period is the period of the slash event.

validator_slash_event

ValidatorSlashEvent

validator_slash_event describes the slash event.

cosmos/crisis/v1beta1/tx.proto

MsgVerifyInvariant

MsgVerifyInvariant represents a message to verify a particular invariance.

Field

Type

Label

Description

sender

invariant_module_name

invariant_route

MsgVerifyInvariantResponse

MsgVerifyInvariantResponse

MsgVerifyInvariantResponse defines the Msg/VerifyInvariant response type.

Msg

Msg defines the bank Msg service.

Method Name

Request Type

Response Type

Description

VerifyInvariant

MsgVerifyInvariant

VerifyInvariant defines a method to verify a particular invariance.

cosmos/crisis/v1beta1/genesis.proto

GenesisState

GenesisState defines the crisis module's genesis state.

Field

Type

Label

Description

constant_fee

constant_fee is the fee used to verify the invariant in the crisis module.

cosmos/tx/signing/v1beta1/signing.proto

SignatureDescriptor

SignatureDescriptor is a convenience type which represents the full data for a signature including the public key of the signer, signing modes and the signature itself. It is primarily used for coordinating signatures between clients.

Field

Type

Label

Description

public_key

public_key is the public key of the signer

data

SignatureDescriptor.Data

sequence

SignatureDescriptor.Data.Single

sequence is the sequence of the account, which describes the number of committed transactions signed by a given address. It is used to prevent replay attacks.

SignatureDescriptor.Data

Data represents signature data

Field

Type

Label

Description

single

single represents a single signer

multi

SignatureDescriptor.Data.Multi

multi represents a multisig signer

SignatureDescriptor.Data.Multi

Multi is the signature data for a multisig public key

Field

Type

Label

Description

bitarray

cosmos.crypto.multisig.v1beta1.CompactBitArray

bitarray specifies which keys within the multisig are signing

signatures

SignatureDescriptor.Data

repeated

signatures is the signatures of the multi-signature

SignatureDescriptor.Data.Single

Single is the signature data for a single signer

Field

Type

Label

Description

mode

SignMode

mode is the signing mode of the single signer

signature

signature is the raw signature bytes

SignatureDescriptors

SignatureDescriptors wraps multiple SignatureDescriptor's.

Field

Type

Label

Description

signatures

SignatureDescriptor

repeated

signatures are the signature descriptors

SignMode

SignMode represents a signing mode with its own security guarantees.

Name

Number

Description

SIGN_MODE_UNSPECIFIED

SIGN_MODE_UNSPECIFIED specifies an unknown signing mode and will be rejected

SIGN_MODE_DIRECT

SIGN_MODE_DIRECT specifies a signing mode which uses SignDoc and is verified with raw bytes from Tx

SIGN_MODE_TEXTUAL

SIGN_MODE_TEXTUAL is a future signing mode that will verify some human-readable textual representation on top of the binary representation from SIGN_MODE_DIRECT

SIGN_MODE_LEGACY_AMINO_JSON

127

SIGN_MODE_LEGACY_AMINO_JSON is a backwards compatibility mode which uses Amino JSON and will be removed in the future

cosmos/tx/v1beta1/tx.proto

AuthInfo

AuthInfo describes the fee and signer modes that are used to sign a transaction.

Field

Type

Label

Description

signer_infos

SignerInfo

repeated

signer_infos defines the signing modes for the required signers. The number and order of elements must match the required signers from TxBody's messages. The first element is the primary signer and the one which pays the fee.

fee

Fee

Fee is the fee and gas limit for the transaction. The first signer is the primary signer and the one which pays the fee. The fee can be calculated based on the cost of evaluating the body and doing signature verification of the signers. This can be estimated via simulation.

Fee

Fee includes the amount of coins paid in fees and the maximum gas to be used by the transaction. The ratio yields an effective "gasprice", which must be above some miminum to be accepted into the mempool.

Field

Type

Label

Description

amount

repeated

amount is the amount of coins to be paid as a fee

gas_limit

gas_limit is the maximum gas that can be used in transaction processing before an out of gas error occurs

payer

if unset, the first signer is responsible for paying the fees. If set, the specified account must pay the fees. the payer must be a tx signer (and thus have signed this field in AuthInfo). setting this field does not change the ordering of required signers for the transaction.

granter

cosmos.crypto.multisig.v1beta1.CompactBitArray

if set, the fee payer (either the first signer or the value of the payer field) requests that a fee grant be used to pay fees instead of the fee payer's own balance. If an appropriate fee grant does not exist or the chain does not support fee grants, this will fail

ModeInfo

ModeInfo describes the signing mode of a single or nested multisig signer.

Field

Type

Label

Description

single

ModeInfo.Single

single represents a single signer

multi

ModeInfo.Multi

multi represents a nested multisig signer

ModeInfo.Multi

Multi is the mode info for a multisig public key

Field

Type

Label

Description

bitarray

bitarray specifies which keys within the multisig are signing

mode_infos

ModeInfo

repeated

mode_infos is the corresponding modes of the signers of the multisig which could include nested multisig public keys

ModeInfo.Single

Single is the mode info for a single signer. It is structured as a message to allow for additional fields such as locale for SIGN_MODE_TEXTUAL in the future

Field

Type

Label

Description

mode

cosmos.tx.signing.v1beta1.SignMode

mode is the signing mode of the single signer

SignDoc

SignDoc is the type used for generating sign bytes for SIGN_MODE_DIRECT.

Field

Type

Label

Description

body_bytes

body_bytes is protobuf serialization of a TxBody that matches the representation in TxRaw.

auth_info_bytes

auth_info_bytes is a protobuf serialization of an AuthInfo that matches the representation in TxRaw.

chain_id

chain_id is the unique identifier of the chain this transaction targets. It prevents signed transactions from being used on another chain by an attacker

account_number

account_number is the account number of the account in state

SignerInfo

SignerInfo describes the public key and signing mode of a single top-level signer.

Field

Type

Label

Description

public_key

public_key is the public key of the signer. It is optional for accounts that already exist in state. If unset, the verifier can use the required \ signer address for this position and lookup the public key.

mode_info

ModeInfo

mode_info describes the signing mode of the signer and is a nested structure to support nested multisig pubkey's

sequence

sequence is the sequence of the account, which describes the number of committed transactions signed by a given address. It is used to prevent replay attacks.

Tx

Tx is the standard type used for broadcasting transactions.

Field

Type

Label

Description

body

TxBody

body is the processable content of the transaction

auth_info

AuthInfo

auth_info is the authorization related content of the transaction, specifically signers, signer modes and fee

signatures

repeated

signatures is a list of signatures that matches the length and order of AuthInfo's signer_infos to allow connecting signature meta information like public key and signing mode by position.

TxBody

TxBody is the body of a transaction that all signers sign over.

Field

Type

Label

Description

messages

repeated

messages is a list of messages to be executed. The required signers of those messages define the number and order of elements in AuthInfo's signer_infos and Tx's signatures. Each required signer address is added to the list only the first time it occurs.

By convention, the first required signer (usually from the first message) is referred to as the primary signer and pays the fee for the whole transaction. | | memo | string | | memo is any arbitrary memo to be added to the transaction | | timeout_height | uint64 | | timeout is the block height after which this transaction will not be processed by the chain | | extension_options | google.protobuf.Any | repeated | extension_options are arbitrary options that can be added by chains when the default options are not sufficient. If any of these are present and can't be handled, the transaction will be rejected | | non_critical_extension_options | google.protobuf.Any | repeated | extension_options are arbitrary options that can be added by chains when the default options are not sufficient. If any of these are present and can't be handled, they will be ignored |

TxRaw

TxRaw is a variant of Tx that pins the signer's exact binary representation of body and auth_info. This is used for signing, broadcasting and verification. The binary serialize(tx: TxRaw) is stored in Tendermint and the hash sha256(serialize(tx: TxRaw)) becomes the "txhash", commonly used as the transaction ID.

Field

Type

Label

Description

body_bytes

body_bytes is a protobuf serialization of a TxBody that matches the representation in SignDoc.

auth_info_bytes

auth_info_bytes is a protobuf serialization of an AuthInfo that matches the representation in SignDoc.

signatures

repeated

signatures is a list of signatures that matches the length and order of AuthInfo's signer_infos to allow connecting signature meta information like public key and signing mode by position.

cosmos/vesting/v1beta1/tx.proto

MsgCreateVestingAccount

MsgCreateVestingAccount defines a message that enables creating a vesting account.

Field

Type

Label

Description

from_address

to_address

amount

repeated

end_time

delayed

MsgCreateVestingAccountResponse

MsgCreateVestingAccountResponse

MsgCreateVestingAccountResponse defines the Msg/CreateVestingAccount response type.

Msg

Msg defines the bank Msg service.

Method Name

Request Type

Response Type

Description

CreateVestingAccount

MsgCreateVestingAccount

CreateVestingAccount defines a method that enables creating a vesting account.

cosmos.auth.v1beta1.BaseAccount

cosmos/vesting/v1beta1/vesting.proto

BaseVestingAccount

BaseVestingAccount implements the VestingAccount interface. It contains all the necessary fields needed for any vesting account implementation.

Field

Type

Label

Description

base_account

original_vesting

repeated

delegated_free

repeated

delegated_vesting

repeated

end_time

ContinuousVestingAccount

ContinuousVestingAccount implements the VestingAccount interface. It continuously vests by unlocking coins linearly with respect to time.

Field

Type

Label

Description

base_vesting_account

BaseVestingAccount

start_time

DelayedVestingAccount

DelayedVestingAccount implements the VestingAccount interface. It vests all coins after a specific time, but non prior. In other words, it keeps them locked until a specified time.

Field

Type

Label

Description

base_vesting_account

BaseVestingAccount

Period

Period defines a length of time and amount of coins that will vest.

Field

Type

Label

Description

length

amount

repeated

PeriodicVestingAccount

PeriodicVestingAccount implements the VestingAccount interface. It periodically vests by unlocking coins during each specified period.

Field

Type

Label

Description

base_vesting_account

start_time

vesting_periods

repeated

cosmos/staking/v1beta1/tx.proto

MsgBeginRedelegate

MsgBeginRedelegate defines a SDK message for performing a redelegation of coins from a delegator and source validator to a destination validator.

Field

Type

Label

Description

delegator_address

validator_src_address

validator_dst_address

amount

MsgBeginRedelegateResponse

MsgBeginRedelegateResponse defines the Msg/BeginRedelegate response type.

Field

Type

Label

Description

completion_time

MsgCreateValidator

MsgCreateValidator defines a SDK message for creating a new validator.

Field

Type

Label

Description

description

commission

min_self_delegation

delegator_address

validator_address

pubkey

value

MsgCreateValidatorResponse

MsgCreateValidatorResponse defines the Msg/CreateValidator response type.

MsgDelegate

MsgDelegate defines a SDK message for performing a delegation of coins from a delegator to a validator.

Field

Type

Label

Description

delegator_address

validator_address

amount

MsgDelegateResponse

MsgDelegateResponse defines the Msg/Delegate response type.

MsgEditValidator

MsgEditValidator defines a SDK message for editing an existing validator.

Field

Type

Label

Description

description

Description

validator_address

commission_rate

We pass a reference to the new commission rate and min self delegation as it's not mandatory to update. If not updated, the deserialized rate will be zero with no way to distinguish if an update was intended.

MsgEditValidatorResponse

MsgEditValidatorResponse defines the Msg/EditValidator response type.

MsgUndelegate

MsgUndelegate defines a SDK message for performing an undelegation from a delegate and a validator.

Field

Type

Label

Description

delegator_address

validator_address

amount

MsgUndelegateResponse

MsgUndelegateResponse defines the Msg/Undelegate response type.

Field

Type

Label

Description

completion_time

MsgCreateValidatorResponse

Msg

Msg defines the staking Msg service.

Method Name

Request Type

Response Type

Description

CreateValidator

MsgCreateValidator

CreateValidator defines a method for creating a new validator.

EditValidator

MsgEditValidator

MsgEditValidatorResponse

EditValidator defines a method for editing an existing validator.

Delegate

MsgDelegate

MsgDelegateResponse

Delegate defines a method for performing a delegation of coins from a delegator to a validator.

BeginRedelegate

MsgBeginRedelegate

MsgBeginRedelegateResponse

BeginRedelegate defines a method for performing a redelegation of coins from a delegator and source validator to a destination validator.

Undelegate

MsgUndelegate

MsgUndelegateResponse

Undelegate defines a method for performing an undelegation from a delegate and a validator.

cosmos/staking/v1beta1/query.proto

QueryDelegationRequest

QueryDelegationRequest is request type for the Query/Delegation RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

validator_addr

validator_addr defines the validator address to query for.

QueryDelegationResponse

QueryDelegationResponse is response type for the Query/Delegation RPC method.

Field

Type

Label

Description

delegation_response

DelegationResponse

delegation_responses defines the delegation info of a delegation.

QueryDelegatorDelegationsRequest

QueryDelegatorDelegationsRequest is request type for the Query/DelegatorDelegations RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

pagination

pagination defines an optional pagination for the request.

QueryDelegatorDelegationsResponse

QueryDelegatorDelegationsResponse is response type for the Query/DelegatorDelegations RPC method.

Field

Type

Label

Description

delegation_responses

DelegationResponse

repeated

delegation_responses defines all the delegations' info of a delegator.

pagination

pagination defines the pagination in the response.

QueryDelegatorUnbondingDelegationsRequest

QueryDelegatorUnbondingDelegationsRequest is request type for the Query/DelegatorUnbondingDelegations RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

pagination

pagination defines an optional pagination for the request.

QueryDelegatorUnbondingDelegationsResponse

QueryUnbondingDelegatorDelegationsResponse is response type for the Query/UnbondingDelegatorDelegations RPC method.

Field

Type

Label

Description

unbonding_responses

repeated

pagination

pagination defines the pagination in the response.

QueryDelegatorValidatorRequest

QueryDelegatorValidatorRequest is request type for the Query/DelegatorValidator RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

validator_addr

validator_addr defines the validator address to query for.

QueryDelegatorValidatorResponse

QueryDelegatorValidatorResponse response type for the Query/DelegatorValidator RPC method.

Field

Type

Label

Description

validator

validator defines the the validator info.

QueryDelegatorValidatorsRequest

QueryDelegatorValidatorsRequest is request type for the Query/DelegatorValidators RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

pagination

pagination defines an optional pagination for the request.

QueryDelegatorValidatorsResponse

QueryDelegatorValidatorsResponse is response type for the Query/DelegatorValidators RPC method.

Field

Type

Label

Description

validators

repeated

validators defines the the validators' info of a delegator.

pagination

pagination defines the pagination in the response.

QueryHistoricalInfoRequest

QueryHistoricalInfoRequest is request type for the Query/HistoricalInfo RPC method.

Field

Type

Label

Description

height

height defines at which height to query the historical info.

QueryHistoricalInfoResponse

QueryHistoricalInfoResponse is response type for the Query/HistoricalInfo RPC method.

Field

Type

Label

Description

hist

HistoricalInfo

hist defines the historical info at the given height.

QueryParamsRequest

QueryParamsRequest is request type for the Query/Params RPC method.

QueryParamsResponse

QueryParamsResponse is response type for the Query/Params RPC method.

Field

Type

Label

Description

params

params holds all the parameters of this module.

QueryPoolRequest

QueryPoolRequest is request type for the Query/Pool RPC method.

QueryPoolResponse

QueryPoolResponse is response type for the Query/Pool RPC method.

Field

Type

Label

Description

pool

Pool

pool defines the pool info.

QueryRedelegationsRequest

QueryRedelegationsRequest is request type for the Query/Redelegations RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

src_validator_addr

src_validator_addr defines the validator address to redelegate from.

dst_validator_addr

dst_validator_addr defines the validator address to redelegate to.

pagination

pagination defines an optional pagination for the request.

QueryRedelegationsResponse

QueryRedelegationsResponse is response type for the Query/Redelegations RPC method.

Field

Type

Label

Description

redelegation_responses

RedelegationResponse

repeated

pagination

pagination defines the pagination in the response.

QueryUnbondingDelegationRequest

QueryUnbondingDelegationRequest is request type for the Query/UnbondingDelegation RPC method.

Field

Type

Label

Description

delegator_addr

delegator_addr defines the delegator address to query for.

validator_addr

validator_addr defines the validator address to query for.

QueryUnbondingDelegationResponse

QueryDelegationResponse is response type for the Query/UnbondingDelegation RPC method.

Field

Type

Label

Description

unbond

unbond defines the unbonding information of a delegation.

QueryValidatorDelegationsRequest

QueryValidatorDelegationsRequest is request type for the Query/ValidatorDelegations RPC method

Field

Type

Label

Description

validator_addr

validator_addr defines the validator address to query for.

pagination

pagination defines an optional pagination for the request.

QueryValidatorDelegationsResponse

QueryValidatorDelegationsResponse is response type for the Query/ValidatorDelegations RPC method

Field

Type

Label

Description

delegation_responses

DelegationResponse

repeated

pagination

pagination defines the pagination in the response.

QueryValidatorRequest

QueryValidatorRequest is response type for the Query/Validator RPC method

Field

Type

Label

Description

validator_addr

validator_addr defines the validator address to query for.

QueryValidatorResponse

QueryValidatorResponse is response type for the Query/Validator RPC method

Field

Type

Label

Description

validator

validator defines the the validator info.

QueryValidatorUnbondingDelegationsRequest

QueryValidatorUnbondingDelegationsRequest is required type for the Query/ValidatorUnbondingDelegations RPC method

Field

Type

Label

Description

validator_addr

validator_addr defines the validator address to query for.

pagination

pagination defines an optional pagination for the request.

QueryValidatorUnbondingDelegationsResponse

QueryValidatorUnbondingDelegationsResponse is response type for the Query/ValidatorUnbondingDelegations RPC method.

Field

Type

Label

Description

unbonding_responses

repeated

pagination

pagination defines the pagination in the response.

QueryValidatorsRequest

QueryValidatorsRequest is request type for Query/Validators RPC method.

Field

Type

Label

Description

status

status enables to query for validators matching a given status.

pagination

pagination defines an optional pagination for the request.

QueryValidatorsResponse

QueryValidatorsResponse is response type for the Query/Validators RPC method

Field

Type

Label

Description

validators

repeated

validators contains all the queried validators.

pagination

QueryValidatorDelegationsRequest

pagination defines the pagination in the response.

Query

Query defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

Validators

QueryValidatorsRequest

QueryValidatorsResponse

Validators queries all validators that match the given status.

Validator

QueryValidatorRequest

QueryValidatorResponse

Validator queries validator info for given validator address.

ValidatorDelegations

QueryValidatorDelegationsResponse

ValidatorDelegations queries delegate info for given validator.

ValidatorUnbondingDelegations

QueryValidatorUnbondingDelegationsRequest

QueryValidatorUnbondingDelegationsResponse

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

Delegation

QueryDelegationRequest

QueryDelegationResponse

Delegation queries delegate info for given validator delegator pair.

UnbondingDelegation

QueryUnbondingDelegationRequest

QueryUnbondingDelegationResponse

UnbondingDelegation queries unbonding info for given validator delegator pair.

DelegatorDelegations

QueryDelegatorDelegationsRequest

QueryDelegatorDelegationsResponse

DelegatorDelegations queries all delegations of a given delegator address.

DelegatorUnbondingDelegations

QueryDelegatorUnbondingDelegationsRequest

QueryDelegatorUnbondingDelegationsResponse

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

Redelegations

QueryRedelegationsRequest

QueryRedelegationsResponse

Redelegations queries redelegations of given address.

DelegatorValidators

QueryDelegatorValidatorsRequest

QueryDelegatorValidatorsResponse

DelegatorValidators queries all validators info for given delegator address.

DelegatorValidator

QueryDelegatorValidatorRequest

QueryDelegatorValidatorResponse

DelegatorValidator queries validator info for given delegator validator pair.

HistoricalInfo

QueryHistoricalInfoRequest

QueryHistoricalInfoResponse

HistoricalInfo queries the historical info for given height.

Pool

QueryPoolRequest

QueryPoolResponse

Pool queries the pool info.

Params

Parameters queries the staking parameters.

cosmos/staking/v1beta1/genesis.proto

GenesisState

GenesisState defines the staking module's genesis state.

Field

Type

Label

Description

params

params defines all the paramaters of related to deposit.

last_total_power

last_total_power tracks the total amounts of bonded tokens recorded during the previous end block.

last_validator_powers

LastValidatorPower

repeated

last_validator_powers is a special index that provides a historical list of the last-block's bonded validators.

validators

repeated

delegations defines the validator set at genesis.

delegations

Delegation

repeated

delegations defines the delegations active at genesis.

unbonding_delegations

repeated

unbonding_delegations defines the unbonding delegations active at genesis.

redelegations

Redelegation

repeated

redelegations defines the redelegations active at genesis.

exported

LastValidatorPower

LastValidatorPower required for validator set update logic.

Field

Type

Label

Description

address

address is the address of the validator.

power

power defines the power of the validator.

cosmos/staking/v1beta1/staking.proto

Commission

Commission defines commission parameters for a given validator.

Field

Type

Label

Description

commission_rates

CommissionRates

update_time

CommissionRates

CommissionRates defines the initial commission rates to be used for creating a validator.

Field

Type

Label

Description

rate

max_rate

max_change_rate

DVPair

DVPair is struct that just has a delegator-validator pair with no other data. It is intended to be used as a marshalable pointer. For example, a DVPair can be used to construct the key to getting an UnbondingDelegation from state.

Field

Type

Label

Description

delegator_address

validator_address

DVPairs

DVPairs defines an array of DVPair objects.

Field

Type

Label

Description

pairs

DVPair

repeated

DVVTriplet

DVVTriplet is struct that just has a delegator-validator-validator triplet with no other data. It is intended to be used as a marshalable pointer. For example, a DVVTriplet can be used to construct the key to getting a Redelegation from state.

Field

Type

Label

Description

delegator_address

validator_src_address

validator_dst_address

DVVTriplets

DVVTriplets defines an array of DVVTriplet objects.

Field

Type

Label

Description

triplets

DVVTriplet

repeated

Delegation

Delegation represents the bond with tokens held by an account. It is owned by one delegator, and is associated with the voting power of one validator.

Field

Type

Label

Description

delegator_address

validator_address

DelegationResponse

DelegationResponse is equivalent to Delegation except that it contains a balance in addition to shares which is more suitable for client responses.

Field

Type

Label

Description

delegation

Delegation

balance

Description

Description defines a validator description.

Field

Type

Label

Description

moniker

identity

website

security_contact

details

HistoricalInfo

HistoricalInfo contains header and validator information for a given block. It is stored as part of staking module's state, which persists the n most recent HistoricalInfo (n is set by the staking module's historical_entries parameter).

Field

Type

Label

Description

header

tendermint.types.Header

valset

repeated

Params

Params defines the parameters for the staking module.

Field

Type

Label

Description

unbonding_time

max_validators

max_entries

historical_entries

bond_denom

Pool

Pool is used for tracking bonded and not-bonded token supply of the bond denomination.

Field

Type

Label

Description

not_bonded_tokens

bonded_tokens

Redelegation

Redelegation contains the list of a particular delegator's redelegating bonds from a particular source validator to a particular destination validator.

Field

Type

Label

Description

delegator_address

validator_src_address

validator_dst_address

entries

RedelegationEntry

repeated

redelegation entries

RedelegationEntry

RedelegationEntry defines a redelegation object with relevant metadata.

Field

Type

Label

Description

creation_height

completion_time

initial_balance

shares_dst

RedelegationEntryResponse

RedelegationEntryResponse is equivalent to a RedelegationEntry except that it contains a balance in addition to shares which is more suitable for client responses.

Field

Type

Label

Description

redelegation_entry

RedelegationEntry

balance

RedelegationEntryResponse

RedelegationResponse

RedelegationResponse is equivalent to a Redelegation except that its entries contain a balance in addition to shares which is more suitable for client responses.

Field

Type

Label

Description

redelegation

Redelegation

entries

repeated

UnbondingDelegation

UnbondingDelegation stores all of a single delegator's unbonding bonds for a single validator in an time-ordered list.

Field

Type

Label

Description

delegator_address

validator_address

entries

UnbondingDelegationEntry

repeated

unbonding delegation entries

UnbondingDelegationEntry

UnbondingDelegationEntry defines an unbonding object with relevant metadata.

Field

Type

Label

Description

creation_height

completion_time

initial_balance

balance

ValAddresses

ValAddresses defines a repeated set of validator addresses.

Field

Type

Label

Description

addresses

repeated

Validator

Validator defines a validator, together with the total amount of the Validator's bond shares and their exchange rate to coins. Slashing results in a decrease in the exchange rate, allowing correct calculation of future undelegations without iterating over delegators. When coins are delegated to this validator, the validator is credited with a delegation whose number of bond shares is based on the amount of coins delegated divided by the current exchange rate. Voting power can be calculated as total bonded shares multiplied by exchange rate.

Field

Type

Label

Description

operator_address

consensus_pubkey

jailed

status

tokens

delegator_shares

description

unbonding_height

unbonding_time

commission

Commission

min_self_delegation

BondStatus

BondStatus is the status of a validator.

Name

Number

Description

BOND_STATUS_UNSPECIFIED

UNSPECIFIED defines an invalid validator status.

BOND_STATUS_UNBONDED

UNBONDED defines a validator that is not bonded.

BOND_STATUS_UNBONDING

UNBONDING defines a validator that is unbonding.

BOND_STATUS_BONDED

BONDED defines a validator that is bonded.

cosmos/genutil/v1beta1/genesis.proto

GenesisState

GenesisState defines the raw genesis transaction in JSON.

Field

Type

Label

Description

gen_txs

repeated

gen_txs defines the genesis transactions.

cosmos/params/v1beta1/query.proto

QueryParamsRequest

QueryParamsRequest is request type for the Query/Params RPC method.

Field

Type

Label

Description

subspace

subspace defines the module to query the parameter for.

key

key defines the key of the parameter in the subspace.

QueryParamsResponse

QueryParamsResponse is response type for the Query/Params RPC method.

Field

Type

Label

Description

param

ParamChange

param defines the queried parameter.

Query

Query defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

Params

Params queries a specific parameter of a module, given its subspace and key.

cosmos/params/v1beta1/params.proto

ParamChange

ParamChange defines an individual parameter change, for use in ParameterChangeProposal.

Field

Type

Label

Description

subspace

key

value

ParameterChangeProposal

ParameterChangeProposal defines a proposal to change one or more parameters.

Field

Type

Label

Description

title

description

changes

repeated

cosmos/slashing/v1beta1/tx.proto

MsgUnjail

MsgUnjail defines the Msg/Unjail request type

Field

Type

Label

Description

validator_addr

MsgUnjailResponse

MsgUnjailResponse defines the Msg/Unjail response type

Msg

Msg defines the slashing Msg service.

Method Name

Request Type

Response Type

Description

Unjail

MsgUnjail

MsgUnjailResponse

Unjail defines a method for unjailing a jailed validator, thus returning them into the bonded validator set, so they can begin receiving provisions and rewards again.

cosmos/slashing/v1beta1/slashing.proto

Params

Params represents the parameters used for by the slashing module.

Field

Type

Label

Description

signed_blocks_window

min_signed_per_window

downtime_jail_duration

slash_fraction_double_sign

slash_fraction_downtime

ValidatorSigningInfo

ValidatorSigningInfo defines a validator's signing info for monitoring their liveness activity.

Field

Type

Label

Description

address

start_height

height at which validator was first a candidate OR was unjailed

index_offset

index offset into signed block bit array

jailed_until

timestamp validator cannot be unjailed until

tombstoned

whether or not a validator has been tombstoned (killed out of validator set)

missed_blocks_counter

missed blocks counter (to avoid scanning the array every time)

cosmos/slashing/v1beta1/query.proto

QueryParamsRequest

QueryParamsRequest is the request type for the Query/Params RPC method

QueryParamsResponse

QueryParamsResponse is the response type for the Query/Params RPC method

Field

Type

Label

Description

params

QuerySigningInfoRequest

QuerySigningInfoRequest is the request type for the Query/SigningInfo RPC method

Field

Type

Label

Description

cons_address

cons_address is the address to query signing info of

QuerySigningInfoResponse

QuerySigningInfoResponse is the response type for the Query/SigningInfo RPC method

Field

Type

Label

Description

val_signing_info

ValidatorSigningInfo

val_signing_info is the signing info of requested val cons address

QuerySigningInfosRequest

QuerySigningInfosRequest is the request type for the Query/SigningInfos RPC method

Field

Type

Label

Description

pagination

QuerySigningInfosResponse

QuerySigningInfosResponse is the response type for the Query/SigningInfos RPC method

Field

Type

Label

Description

info

ValidatorSigningInfo

repeated

info is the signing info of all validators

pagination

Query

Query provides defines the gRPC querier service

Method Name

Request Type

Response Type

Description

Params

QuerySigningInfosResponse

Params queries the parameters of slashing module

SigningInfo

QuerySigningInfoRequest

QuerySigningInfoResponse

SigningInfo queries the signing info of given cons address

SigningInfos

QuerySigningInfosRequest

SigningInfos queries signing info of all validators

cosmos/slashing/v1beta1/genesis.proto

GenesisState

GenesisState defines the slashing module's genesis state.

Field

Type

Label

Description

params

params defines all the paramaters of related to deposit.

signing_infos

SigningInfo

repeated

signing_infos represents a map between validator addresses and their signing infos.

missed_blocks

ValidatorMissedBlocks

repeated

signing_infos represents a map between validator addresses and their missed blocks.

MissedBlock

MissedBlock contains height and missed status as boolean.

Field

Type

Label

Description

index

index is the height at which the block was missed.

missed

missed is the missed status.

SigningInfo

SigningInfo stores validator signing info of corresponding address.

Field

Type

Label

Description

address

address is the validator address.

validator_signing_info

ValidatorSigningInfo

validator_signing_info represents the signing info of this validator.

ValidatorMissedBlocks

ValidatorMissedBlocks contains array of missed blocks of corresponding address.

Field

Type

Label

Description

address

address is the validator address.

missed_blocks

MissedBlock

repeated

missed_blocks is an array of missed blocks by the validator.

cosmos/base/abci/v1beta1/abci.proto

ABCIMessageLog

ABCIMessageLog defines a structure containing an indexed tx ABCI message log.

Field

Type

Label

Description

msg_index

log

events

StringEvent

repeated

Events contains a slice of Event objects that were emitted during some execution.

Attribute

Attribute defines an attribute wrapper where the key and value are strings instead of raw bytes.

Field

Type

Label

Description

key

value

GasInfo

GasInfo defines tx execution gas context.

Field

Type

Label

Description

gas_wanted

GasWanted is the maximum units of work we allow this tx to perform.

gas_used

GasUsed is the amount of gas actually consumed.

MsgData

MsgData defines the data returned in a Result object during message execution.

Field

Type

Label

Description

msg_type

data

Result

Result is the union of ResponseFormat and ResponseCheckTx.

Field

Type

Label

Description

data

Data is any data returned from message or handler execution. It MUST be length prefixed in order to separate data from multiple message executions.

log

Log contains the log information from message or handler execution.

events

tendermint.abci.Event

repeated

Events contains a slice of Event objects that were emitted during message or handler execution.

SearchTxsResult

SearchTxsResult defines a structure for querying txs pageable

Field

Type

Label

Description

total_count

Count of all txs

count

Count of txs in current page

page_number

Index of current page, start from 1

page_total

Count of total pages

limit

Max count txs per page

txs

TxResponse

repeated

List of txs in current page

SimulationResponse

SimulationResponse defines the response generated when a transaction is successfully simulated.

Field

Type

Label

Description

gas_info

GasInfo

result

Result

StringEvent

StringEvent defines en Event object wrapper where all the attributes contain key/value pairs that are strings instead of raw bytes.

Field

Type

Label

Description

type

attributes

Attribute

repeated

TxMsgData

TxMsgData defines a list of MsgData. A transaction will have a MsgData object for each message.

Field

Type

Label

Description

data

MsgData

repeated

TxResponse

TxResponse defines a structure containing relevant tx data and metadata. The tags are stringified and the log is JSON decoded.

Field

Type

Label

Description

height

The block height

txhash

The transaction hash.

codespace

Namespace for the Code

code

Response code.

data

Result bytes, if any.

raw_log

The output of the application's logger (raw string). May be non-deterministic.

logs

ABCIMessageLog

repeated

The output of the application's logger (typed). May be non-deterministic.

info

Additional information. May be non-deterministic.

gas_wanted

Amount of gas requested for transaction.

gas_used

Amount of gas consumed by transaction.

The request transaction bytes.

timestamp

Time of the previous block. For heights > 1, it's the weighted median of the timestamps of the valid votes in the block.LastCommit. For height == 1, it's genesis time.

cosmos/base/kv/v1beta1/kv.proto

Pair

Pair defines a key/value bytes tuple.

Field

Type

Label

Description

key

value

Pairs

Pairs defines a repeated slice of Pair objects.

Field

Type

Label

Description

pairs

Pair

repeated

cosmos/base/snapshots/v1beta1/snapshot.proto

Metadata

Metadata contains SDK-specific snapshot metadata.

Field

Type

Label

Description

chunk_hashes

cosmos.base.abci.v1beta1.GasInfo

repeated

SHA-256 chunk hashes

Snapshot

Snapshot contains Tendermint state sync snapshot info.

Field

Type

Label

Description

height

format

chunks

hash

metadata

cosmos/base/simulate/v1beta1/simulate.proto

SimulateRequest

SimulateRequest is the request type for the SimulateServiceService.Simulate RPC method.

Field

Type

Label

Description

cosmos.tx.v1beta1.Tx

tx is the transaction to simulate.

SimulateResponse

SimulateResponse is the response type for the SimulateServiceService.SimulateRPC method.

Field

Type

Label

Description

gas_info

gas_info is the information about gas used in the simulation.

result

cosmos.base.abci.v1beta1.Result

result is the result of the simulation.

SimulateService

SimulateService defines a gRPC service for simulating transactions. It may also support querying and broadcasting in the future.

Method Name

Request Type

Response Type

Description

Simulate

SimulateRequest

SimulateResponse

Simulate simulates executing a transaction for estimating gas usage.

cosmos/base/v1beta1/coin.proto

Coin

Coin defines a token with a denomination and an amount.

NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.

Field

Type

Label

Description

denom

amount

DecCoin

DecCoin defines a token with a denomination and a decimal amount.

NOTE: The amount field is an Dec which implements the custom method signatures required by gogoproto.

Field

Type

Label

Description

denom

amount

DecProto

DecProto defines a Protobuf wrapper around a Dec object.

Field

Type

Label

Description

dec

IntProto

IntProto defines a Protobuf wrapper around an Int object.

Field

Type

Label

Description

int

cosmos/base/query/v1beta1/pagination.proto

PageRequest

PageRequest is to be embedded in gRPC request messages for efficient pagination. Ex:

message SomeRequest { Foo some_parameter = 1; PageRequest pagination = 2; }

Field

Type

Label

Description

key

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

offset

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

limit

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

count_total

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

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; }

Field

Type

Label

Description

next_key

next_key is the key to be passed to PageRequest.key to query the next page most efficiently

total

total is total number of results available if PageRequest.count_total was set, its value is undefined otherwise

cosmos/base/store/v1beta1/commit_info.proto

CommitID

CommitID defines the committment information when a specific store is committed.

Field

Type

Label

Description

version

hash

CommitInfo

CommitInfo defines commit information used by the multi-store when committing a version/height.

Field

Type

Label

Description

version

store_infos

StoreInfo

repeated

StoreInfo

StoreInfo defines store-specific commit information. It contains a reference between a store name and the commit ID.

Field

Type

Label

Description

name

commit_id

CommitID

cosmos/base/store/v1beta1/snapshot.proto

SnapshotIAVLItem

SnapshotIAVLItem is an exported IAVL node.

Field

Type

Label

Description

key

value

version

height

SnapshotItem

SnapshotItem is an item contained in a rootmulti.Store snapshot.

Field

Type

Label

Description

store

SnapshotStoreItem

iavl

SnapshotIAVLItem

SnapshotStoreItem

SnapshotStoreItem contains metadata about a snapshotted store.

Field

Type

Label

Description

name

cosmos/base/reflection/v1beta1/reflection.proto

ListAllInterfacesRequest

ListAllInterfacesRequest is the request type of the ListAllInterfaces RPC.

ListAllInterfacesResponse

ListAllInterfacesResponse is the response type of the ListAllInterfaces RPC.

Field

Type

Label

Description

interface_names

repeated

interface_names is an array of all the registered interfaces.

ListImplementationsRequest

ListImplementationsRequest is the request type of the ListImplementations RPC.

Field

Type

Label

Description

interface_name

interface_name defines the interface to query the implementations for.

ListImplementationsResponse

ListImplementationsResponse is the response type of the ListImplementations RPC.

Field

Type

Label

Description

implementation_message_names

ListAllInterfacesResponse

repeated

ReflectionService

ReflectionService defines a service for interface reflection.

Method Name

Request Type

Response Type

Description

ListAllInterfaces

ListAllInterfacesRequest

ListAllInterfaces lists all the interfaces registered in the interface registry.

ListImplementations

ListImplementationsRequest

ListImplementationsResponse

ListImplementations list all the concrete types that implement a given interface.

cosmos/gov/v1beta1/tx.proto

MsgDeposit

MsgDeposit defines a message to submit a deposit to an existing proposal.

Field

Type

Label

Description

proposal_id

depositor

amount

repeated

MsgDepositResponse

MsgDepositResponse defines the Msg/Deposit response type.

MsgSubmitProposal

MsgSubmitProposal defines an sdk.Msg type that supports submitting arbitrary proposal Content.

Field

Type

Label

Description

content

initial_deposit

repeated

proposer

MsgSubmitProposalResponse

MsgSubmitProposalResponse defines the Msg/SubmitProposal response type.

Field

Type

Label

Description

proposal_id

MsgVote

MsgVote defines a message to cast a vote.

Field

Type

Label

Description

proposal_id

voter

MsgSubmitProposalResponse

option

VoteOption

MsgVoteResponse

MsgVoteResponse defines the Msg/Vote response type.

Msg

Msg defines the bank Msg service.

Method Name

Request Type

Response Type

Description

SubmitProposal

MsgSubmitProposal

SubmitProposal defines a method to create new proposal given a content.

Vote

MsgVote

MsgVoteResponse

Vote defines a method to add a vote on a specific proposal.

Deposit

MsgDeposit

MsgDepositResponse

Deposit defines a method to add deposit on a specific proposal.

cosmos/gov/v1beta1/gov.proto

Deposit

Deposit defines an amount deposited by an account address to an active proposal.

Field

Type

Label

Description

proposal_id

depositor

amount

repeated

DepositParams

DepositParams defines the params for deposits on governance proposals.

Field

Type

Label

Description

min_deposit

repeated

Minimum deposit for a proposal to enter voting period.

max_deposit_period

Maximum period for Atom holders to deposit on a proposal. Initial value: 2 months.

Proposal

Proposal defines the core field members of a governance proposal.

Field

Type

Label

Description

proposal_id

content

status

final_tally_result

submit_time

deposit_end_time

total_deposit

repeated

voting_start_time

voting_end_time

TallyParams

TallyParams defines the params for tallying votes on governance proposals.

Field

Type

Label

Description

quorum

Minimum percentage of total stake needed to vote for a result to be considered valid.

threshold

Minimum proportion of Yes votes for proposal to pass. Default value: 0.5.

veto_threshold

Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Default value: 1/3.

TallyResult

TallyResult defines a standard tally for a governance proposal.

Field

Type

Label

Description

yes

abstain

no_with_veto

TextProposal

TextProposal defines a standard text proposal whose changes need to be manually updated in case of approval.

Field

Type

Label

Description

title

description

Vote

Vote defines a vote on a governance proposal. A Vote consists of a proposal ID, the voter, and the vote option.

Field

Type

Label

Description

proposal_id

voter

option

VoteOption

VotingParams

VotingParams defines the params for voting on governance proposals.

Field

Type

Label

Description

voting_period

Length of the voting period.

ProposalStatus

ProposalStatus enumerates the valid statuses of a proposal.

Name

Number

Description

PROPOSAL_STATUS_UNSPECIFIED

PROPOSAL_STATUS_UNSPECIFIED defines the default propopsal status.

PROPOSAL_STATUS_DEPOSIT_PERIOD

PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.

PROPOSAL_STATUS_VOTING_PERIOD

PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.

PROPOSAL_STATUS_PASSED

PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.

PROPOSAL_STATUS_REJECTED

PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.

PROPOSAL_STATUS_FAILED

PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.

VoteOption

VoteOption enumerates the valid vote options for a given governance proposal.

Name

Number

Description

VOTE_OPTION_UNSPECIFIED

VOTE_OPTION_UNSPECIFIED defines a no-op vote option.

VOTE_OPTION_YES

VOTE_OPTION_YES defines a yes vote option.

VOTE_OPTION_ABSTAIN

VOTE_OPTION_ABSTAIN defines an abstain vote option.

VOTE_OPTION_NO

VOTE_OPTION_NO defines a no vote option.

VOTE_OPTION_NO_WITH_VETO

VOTE_OPTION_NO_WITH_VETO defines a no with veto vote option.

cosmos/gov/v1beta1/query.proto

QueryDepositRequest

QueryDepositRequest is the request type for the Query/Deposit RPC method.

Field

Type

Label

Description

proposal_id

proposal_id defines the unique id of the proposal.

depositor

depositor defines the deposit addresses from the proposals.

QueryDepositResponse

QueryDepositResponse is the response type for the Query/Deposit RPC method.

Field

Type

Label

Description

deposit

Deposit

deposit defines the requested deposit.

QueryDepositsRequest

QueryDepositsRequest is the request type for the Query/Deposits RPC method.

Field

Type

Label

Description

proposal_id

proposal_id defines the unique id of the proposal.

pagination

pagination defines an optional pagination for the request.

QueryDepositsResponse

QueryDepositsResponse is the response type for the Query/Deposits RPC method.

Field

Type

Label

Description

deposits

Deposit

repeated

pagination

pagination defines the pagination in the response.

QueryParamsRequest

QueryParamsRequest is the request type for the Query/Params RPC method.

Field

Type

Label

Description

params_type

params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

QueryParamsResponse

QueryParamsResponse is the response type for the Query/Params RPC method.

Field

Type

Label

Description

voting_params

VotingParams

voting_params defines the parameters related to voting.

deposit_params

DepositParams

deposit_params defines the parameters related to deposit.

tally_params

TallyParams

tally_params defines the parameters related to tally.

QueryProposalRequest

QueryProposalRequest is the request type for the Query/Proposal RPC method.

Field

Type

Label

Description

proposal_id

proposal_id defines the unique id of the proposal.

QueryProposalResponse

QueryProposalResponse is the response type for the Query/Proposal RPC method.

Field

Type

Label

Description

proposal

Proposal

QueryProposalsRequest

QueryProposalsRequest is the request type for the Query/Proposals RPC method.

Field

Type

Label

Description

proposal_status

ProposalStatus

proposal_status defines the status of the proposals.

voter

voter defines the voter address for the proposals.

depositor

depositor defines the deposit addresses from the proposals.

pagination

pagination defines an optional pagination for the request.

QueryProposalsResponse

QueryProposalsResponse is the response type for the Query/Proposals RPC method.

Field

Type

Label

Description

proposals

Proposal

repeated

pagination

pagination defines the pagination in the response.

QueryTallyResultRequest

QueryTallyResultRequest is the request type for the Query/Tally RPC method.

Field

Type

Label

Description

proposal_id

proposal_id defines the unique id of the proposal.

QueryTallyResultResponse

QueryTallyResultResponse is the response type for the Query/Tally RPC method.

Field

Type

Label

Description

tally

TallyResult

tally defines the requested tally.

QueryVoteRequest

QueryVoteRequest is the request type for the Query/Vote RPC method.

Field

Type

Label

Description

proposal_id

proposal_id defines the unique id of the proposal.

voter

voter defines the oter address for the proposals.

QueryVoteResponse

QueryVoteResponse is the response type for the Query/Vote RPC method.

Field

Type

Label

Description

vote

Vote

vote defined the queried vote.

QueryVotesRequest

QueryVotesRequest is the request type for the Query/Votes RPC method.

Field

Type

Label

Description

proposal_id

proposal_id defines the unique id of the proposal.

pagination

pagination defines an optional pagination for the request.

QueryVotesResponse

QueryVotesResponse is the response type for the Query/Votes RPC method.

Field

Type

Label

Description

votes

Vote

repeated

votes defined the queried votes.

pagination

pagination defines the pagination in the response.

Query

Query defines the gRPC querier service for gov module

Method Name

Request Type

Response Type

Description

Proposal

QueryProposalRequest

QueryProposalResponse

Proposal queries proposal details based on ProposalID.

Proposals

QueryProposalsRequest

QueryProposalsResponse

Proposals queries all proposals based on given status.

Vote

QueryVoteRequest

QueryVoteResponse

Vote queries voted information based on proposalID, voterAddr.

Votes

QueryVotesRequest

QueryVotesResponse

Votes queries votes of a given proposal.

Params

Params queries all parameters of the gov module.

Deposit

QueryDepositRequest

QueryDepositResponse

Deposit queries single deposit information based proposalID, depositAddr.

Deposits

QueryDepositsRequest

QueryDepositsResponse

Deposits queries all deposits of a single proposal.

TallyResult

QueryTallyResultRequest

QueryTallyResultResponse

TallyResult queries the tally of a proposal vote.

cosmos/gov/v1beta1/genesis.proto

GenesisState

GenesisState defines the gov module's genesis state.

Field

Type

Label

Description

starting_proposal_id

starting_proposal_id is the ID of the starting proposal.

deposits

Deposit

repeated

deposits defines all the deposits present at genesis.

votes

Vote

repeated

votes defines all the votes present at genesis.

proposals

Proposal

repeated

proposals defines all the proposals present at genesis.

deposit_params

DepositParams

params defines all the paramaters of related to deposit.

voting_params

VotingParams

params defines all the paramaters of related to voting.

tally_params

TallyParams

params defines all the paramaters of related to tally.

ibc.core.client.v1.GenesisState

ibc/core/types/v1/genesis.proto

GenesisState

GenesisState defines the ibc module's genesis state.

Field

Type

Label

Description

client_genesis

ICS002 - Clients genesis state

connection_genesis

ibc.core.connection.v1.GenesisState

ICS003 - Connections genesis state

channel_genesis

ibc.core.channel.v1.GenesisState

ICS004 - Channel genesis state

ibc/core/connection/v1/query.proto

QueryClientConnectionsRequest

QueryClientConnectionsRequest is the request type for the Query/ClientConnections RPC method

Field

Type

Label

Description

client_id

client identifier associated with a connection

QueryClientConnectionsResponse

QueryClientConnectionsResponse is the response type for the Query/ClientConnections RPC method

Field

Type

Label

Description

connection_paths

repeated

slice of all the connection paths associated with a client.

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was generated

QueryConnectionClientStateRequest

QueryConnectionClientStateRequest is the request type for the Query/ConnectionClientState RPC method

Field

Type

Label

Description

connection_id

ibc.core.client.v1.IdentifiedClientState

connection identifier

QueryConnectionClientStateResponse

QueryConnectionClientStateResponse is the response type for the Query/ConnectionClientState RPC method

Field

Type

Label

Description

identified_client_state

client state associated with the channel

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryConnectionConsensusStateRequest

QueryConnectionConsensusStateRequest is the request type for the Query/ConnectionConsensusState RPC method

Field

Type

Label

Description

connection_id

connection identifier

version_number

version_height

QueryConnectionConsensusStateResponse

QueryConnectionConsensusStateResponse is the response type for the Query/ConnectionConsensusState RPC method

Field

Type

Label

Description

consensus_state

consensus state associated with the channel

client_id

client ID associated with the consensus state

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryConnectionRequest

QueryConnectionRequest is the request type for the Query/Connection RPC method

Field

Type

Label

Description

connection_id

connection unique identifier

QueryConnectionResponse

QueryConnectionResponse is the response type for the Query/Connection RPC method. Besides the connection end, it includes a proof and the height from which the proof was retrieved.

Field

Type

Label

Description

connection

ConnectionEnd

connection associated with the request identifier

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryConnectionsRequest

QueryConnectionsRequest is the request type for the Query/Connections RPC method

Field

Type

Label

Description

pagination

QueryConnectionsResponse

QueryConnectionsResponse is the response type for the Query/Connections RPC method.

Field

Type

Label

Description

connections

IdentifiedConnection

repeated

list of stored connections of the chain.

pagination

pagination response

height

QueryClientConnectionsRequest

query block height

Query

Query provides defines the gRPC querier service

Method Name

Request Type

Response Type

Description

Connection

QueryConnectionRequest

QueryConnectionResponse

Connection queries an IBC connection end.

Connections

QueryConnectionsRequest

QueryConnectionsResponse

Connections queries all the IBC connections of a chain.

ClientConnections

QueryClientConnectionsResponse

ClientConnections queries the connection paths associated with a client state.

ConnectionClientState

QueryConnectionClientStateRequest

QueryConnectionClientStateResponse

ConnectionClientState queries the client state associated with the connection.

ConnectionConsensusState

QueryConnectionConsensusStateRequest

QueryConnectionConsensusStateResponse

ConnectionConsensusState queries the consensus state associated with the connection.

ibc/core/connection/v1/connection.proto

ClientPaths

ClientPaths define all the connection paths for a client state.

Field

Type

Label

Description

paths

repeated

list of connection paths

ConnectionEnd

ConnectionEnd defines a stateful object on a chain connected to another separate one. NOTE: there must only be 2 defined ConnectionEnds to establish a connection between two chains.

Field

Type

Label

Description

client_id

client associated with this connection.

versions

repeated

IBC version which can be utilised to determine encodings or protocols for channels or packets utilising this connection

state

current state of the connection end.

counterparty

counterparty chain associated with this connection.

ConnectionPaths

ConnectionPaths define all the connection paths for a given client state.

Field

Type

Label

Description

client_id

client state unique identifier

paths

repeated

list of connection paths

Counterparty

Counterparty defines the counterparty chain associated with a connection end.

Field

Type

Label

Description

client_id

identifies the client on the counterparty chain associated with a given connection.

connection_id

ibc.core.commitment.v1.MerklePrefix

identifies the connection end on the counterparty chain associated with a given connection.

prefix

commitment merkle prefix of the counterparty chain

IdentifiedConnection

IdentifiedConnection defines a connection with additional connection identifier field.

Field

Type

Label

Description

connection identifier.

client_id

client associated with this connection.

versions

repeated

IBC version which can be utilised to determine encodings or protocols for channels or packets utilising this connection

state

current state of the connection end.

counterparty

counterparty chain associated with this connection.

MsgConnectionOpenAck

MsgConnectionOpenAck defines a msg sent by a Relayer to Chain A to acknowledge the change of connection state to TRYOPEN on Chain B.

Field

Type

Label

Description

connection_id

counterparty_connection_id

version

client_state

proof_height

proof_try

proof of the initialization the connection on Chain B: UNITIALIZED -> TRYOPEN

proof_client

proof of client state included in message

proof_consensus

proof of client consensus state

consensus_height

signer

MsgConnectionOpenAckResponse

MsgConnectionOpenAckResponse defines the Msg/ConnectionOpenAck response type.

MsgConnectionOpenConfirm

MsgConnectionOpenConfirm defines a msg sent by a Relayer to Chain B to acknowledge the change of connection state to OPEN on Chain A.

Field

Type

Label

Description

connection_id

proof_ack

proof for the change of the connection state on Chain A: INIT -> OPEN

proof_height

signer

MsgConnectionOpenConfirmResponse

MsgConnectionOpenConfirmResponse defines the Msg/ConnectionOpenConfirm response type.

MsgConnectionOpenInit

MsgConnectionOpenInit defines the msg sent by an account on Chain A to initialize a connection with Chain B.

Field

Type

Label

Description

client_id

connection_id

counterparty

version

signer

MsgConnectionOpenInitResponse

MsgConnectionOpenInitResponse defines the Msg/ConnectionOpenInit response type.

MsgConnectionOpenTry

MsgConnectionOpenTry defines a msg sent by a Relayer to try to open a connection on Chain B.

Field

Type

Label

Description

client_id

desired_connection_id

counterparty_chosen_connection_id

client_state

counterparty

counterparty_versions

repeated

proof_height

proof_init

proof of the initialization the connection on Chain A: UNITIALIZED -> INIT

proof_client

proof of client state included in message

proof_consensus

proof of client consensus state

consensus_height

signer

MsgConnectionOpenTryResponse

MsgConnectionOpenTryResponse defines the Msg/ConnectionOpenTry response type.

Version

Version defines the versioning scheme used to negotiate the IBC verison in the connection handshake.

Field

Type

Label

Description

identifier

unique version identifier

features

MsgConnectionOpenInitResponse

repeated

list of features compatible with the specified identifier

State

State defines if a connection is in one of the following states: INIT, TRYOPEN, OPEN or UNINITIALIZED.

Name

Number

Description

STATE_UNINITIALIZED_UNSPECIFIED

Default State

STATE_INIT

A connection end has just started the opening handshake.

STATE_TRYOPEN

A connection end has acknowledged the handshake step on the counterparty chain.

STATE_OPEN

A connection end has completed the handshake.

Msg

Msg defines the ibc/connection Msg service.

Method Name

Request Type

Response Type

Description

ConnectionOpenInit

MsgConnectionOpenInit

ConnectionOpenInit defines a rpc handler method for MsgConnectionOpenInit.

ConnectionOpenTry

MsgConnectionOpenTry

MsgConnectionOpenTryResponse

ConnectionOpenTry defines a rpc handler method for MsgConnectionOpenTry.

ConnectionOpenAck

MsgConnectionOpenAck

MsgConnectionOpenAckResponse

ConnectionOpenAck defines a rpc handler method for MsgConnectionOpenAck.

ConnectionOpenConfirm

MsgConnectionOpenConfirm

MsgConnectionOpenConfirmResponse

ConnectionOpenConfirm defines a rpc handler method for MsgConnectionOpenConfirm.

ibc/core/connection/v1/genesis.proto

GenesisState

GenesisState defines the ibc connection submodule's genesis state.

Field

Type

Label

Description

connections

IdentifiedConnection

repeated

client_connection_paths

ConnectionPaths

repeated

ibc/core/commitment/v1/commitment.proto

Key

Key defines a proof Key

Field

Type

Label

Description

name

enc

KeyEncoding

KeyPath

KeyPath defines a slice of keys

Field

Type

Label

Description

keys

Key

repeated

MerklePath

MerklePath is the path used to verify commitment proofs, which can be an arbitrary structured object (defined by a commitment type).

Field

Type

Label

Description

key_path

KeyPath

MerklePrefix

MerklePrefix is merkle path prefixed to the key. The constructed key from the Path and the key will be append(Path.KeyPath, append(Path.KeyPrefix, key...))

Field

Type

Label

Description

key_prefix

tendermint.crypto.ProofOps

MerkleProof

MerkleProof is a wrapper type that contains a merkle proof. It demonstrates membership or non-membership for an element or set of elements, verifiable in conjunction with a known commitment root. Proofs should be succinct.

Field

Type

Label

Description

proof

MerkleRoot

MerkleRoot defines a merkle root hash. In the Cosmos SDK, the AppHash of a block header becomes the root.

Field

Type

Label

Description

hash

KeyEncoding

KeyEncoding defines the encoding format of a key's bytes.

Name

Number

Description

KEY_ENCODING_URL_UNSPECIFIED

URL encoding

KEY_ENCODING_HEX

Hex encoding

ibc/core/channel/v1/query.proto

QueryChannelClientStateRequest

QueryChannelClientStateRequest is the request type for the Query/ClientState RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

ibc.core.client.v1.IdentifiedClientState

channel unique identifier

QueryChannelClientStateResponse

QueryChannelClientStateResponse is the Response type for the Query/QueryChannelClientState RPC method

Field

Type

Label

Description

identified_client_state

client state associated with the channel

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryChannelConsensusStateRequest

QueryChannelConsensusStateRequest is the request type for the Query/ConsensusState RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

version_number

version number of the consensus state

version_height

version height of the consensus state

QueryChannelConsensusStateResponse

QueryChannelClientStateResponse is the Response type for the Query/QueryChannelClientState RPC method

Field

Type

Label

Description

consensus_state

consensus state associated with the channel

client_id

client ID associated with the consensus state

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryChannelRequest

QueryChannelRequest is the request type for the Query/Channel RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

QueryChannelResponse

QueryChannelResponse is the response type for the Query/Channel RPC method. Besides the Channel end, it includes a proof and the height from which the proof was retrieved.

Field

Type

Label

Description

channel

Channel

channel associated with the request identifiers

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryChannelsRequest

QueryChannelsRequest is the request type for the Query/Channels RPC method

Field

Type

Label

Description

pagination

pagination request

QueryChannelsResponse

QueryChannelsResponse is the response type for the Query/Channels RPC method.

Field

Type

Label

Description

channels

IdentifiedChannel

repeated

list of stored channels of the chain.

pagination

pagination response

height

query block height

QueryConnectionChannelsRequest

QueryConnectionChannelsRequest is the request type for the Query/QueryConnectionChannels RPC method

Field

Type

Label

Description

connection

connection unique identifier

pagination

pagination request

QueryConnectionChannelsResponse

QueryConnectionChannelsResponse is the Response type for the Query/QueryConnectionChannels RPC method

Field

Type

Label

Description

channels

IdentifiedChannel

repeated

list of channels associated with a connection.

pagination

pagination response

height

query block height

QueryNextSequenceReceiveRequest

QueryNextSequenceReceiveRequest is the request type for the Query/QueryNextSequenceReceiveRequest RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

QueryNextSequenceReceiveResponse

QuerySequenceResponse is the request type for the Query/QueryNextSequenceReceiveResponse RPC method

Field

Type

Label

Description

next_sequence_receive

next sequence receive number

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryPacketAcknowledgementRequest

QueryPacketAcknowledgementRequest is the request type for the Query/PacketAcknowledgement RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

sequence

packet sequence

QueryPacketAcknowledgementResponse

QueryPacketAcknowledgementResponse defines the client query response for a packet which also includes a proof, its path and the height form which the proof was retrieved

Field

Type

Label

Description

acknowledgement

packet associated with the request fields

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryPacketCommitmentRequest

QueryPacketCommitmentRequest is the request type for the Query/PacketCommitment RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

sequence

packet sequence

QueryPacketCommitmentResponse

QueryPacketCommitmentResponse defines the client query response for a packet which also includes a proof, its path and the height form which the proof was retrieved

Field

Type

Label

Description

commitment

packet associated with the request fields

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryPacketCommitmentsRequest

QueryPacketCommitmentsRequest is the request type for the Query/QueryPacketCommitments RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

pagination

pagination request

QueryPacketCommitmentsResponse

QueryPacketCommitmentsResponse is the request type for the Query/QueryPacketCommitments RPC method

Field

Type

Label

Description

commitments

PacketAckCommitment

repeated

pagination

pagination response

height

query block height

QueryUnreceivedPacketsRequest

QueryUnreceivedPacketsRequest is the request type for the Query/UnreceivedPackets RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

packet_commitment_sequences

repeated

list of packet sequences

QueryUnreceivedPacketsResponse

QueryUnreceivedPacketsResponse is the response type for the Query/UnreceivedPacketCommitments RPC method

Field

Type

Label

Description

sequences

repeated

list of unreceived packet sequences

height

query block height

QueryUnrelayedAcksRequest

QueryUnrelayedAcksRequest is the request type for the Query/UnrelayedAcks RPC method

Field

Type

Label

Description

port_id

port unique identifier

channel_id

channel unique identifier

packet_commitment_sequences

repeated

list of commitment sequences

QueryUnrelayedAcksResponse

QueryUnrelayedAcksResponse is the response type for the Query/UnrelayedAcks RPC method

Field

Type

Label

Description

sequences

repeated

list of unrelayed acknowledgement sequences

height

QueryConnectionChannelsRequest

query block height

Query

Query provides defines the gRPC querier service

Method Name

Request Type

Response Type

Description

Channel

QueryChannelRequest

QueryChannelResponse

Channel queries an IBC Channel.

Channels

QueryChannelsRequest

QueryChannelsResponse

Channels queries all the IBC channels of a chain.

ConnectionChannels

QueryConnectionChannelsResponse

ConnectionChannels queries all the channels associated with a connection end.

ChannelClientState

QueryChannelClientStateRequest

QueryChannelClientStateResponse

ChannelClientState queries for the client state for the channel associated with the provided channel identifiers.

ChannelConsensusState

QueryChannelConsensusStateRequest

QueryChannelConsensusStateResponse

ChannelConsensusState queries for the consensus state for the channel associated with the provided channel identifiers.

PacketCommitment

QueryPacketCommitmentRequest

QueryPacketCommitmentResponse

PacketCommitment queries a stored packet commitment hash.

PacketCommitments

QueryPacketCommitmentsRequest

QueryPacketCommitmentsResponse

PacketCommitments returns the all the packet commitments hashes associated with a channel.

PacketAcknowledgement

QueryPacketAcknowledgementRequest

QueryPacketAcknowledgementResponse

PacketAcknowledgement queries a stored packet acknowledgement hash.

UnreceivedPackets

QueryUnreceivedPacketsRequest

QueryUnreceivedPacketsResponse

UnreceivedPackets returns all the unrelayed IBC packets associated with a channel and sequences.

UnrelayedAcks

QueryUnrelayedAcksRequest

QueryUnrelayedAcksResponse

UnrelayedAcks returns all the unrelayed IBC acknowledgements associated with a channel and sequences.

NextSequenceReceive

QueryNextSequenceReceiveRequest

QueryNextSequenceReceiveResponse

NextSequenceReceive returns the next receive sequence for a given channel.

ibc/core/channel/v1/genesis.proto

GenesisState

GenesisState defines the ibc channel submodule's genesis state.

Field

Type

Label

Description

channels

IdentifiedChannel

repeated

acknowledgements

PacketAckCommitment

repeated

commitments

PacketAckCommitment

repeated

send_sequences

PacketSequence

repeated

recv_sequences

PacketSequence

repeated

ack_sequences

PacketSequence

repeated

PacketSequence

PacketSequence defines the genesis type necessary to retrieve and store next send and receive sequences.

Field

Type

Label

Description

port_id

channel_id

sequence

ibc/core/channel/v1/channel.proto

Acknowledgement

Acknowledgement is the recommended acknowledgement format to be used by app-specific protocols. NOTE: The field numbers 21 and 22 were explicitly chosen to avoid accidental conflicts with other protobuf message formats used for acknowledgements. The first byte of any message with this format will be the non-ASCII values 0xaa (result) or 0xb2 (error). Implemented as defined by ICS: https://github.com/cosmos/ics/tree/master/spec/ics-004-channel-and-packet-semantics#acknowledgement-envelope

Field

Type

Label

Description

result

error

Channel

Channel defines pipeline for exactly-once packet delivery between specific modules on separate blockchains, which has at least one end capable of sending packets and one end capable of receiving packets.

Field

Type

Label

Description

state

current state of the channel end

ordering

Order

whether the channel is ordered or unordered

counterparty

counterparty channel end

connection_hops

repeated

list of connection identifiers, in order, along which packets sent on this channel will travel

version

opaque channel version, which is agreed upon during the handshake

Counterparty

Counterparty defines a channel end counterparty

Field

Type

Label

Description

port_id

port on the counterparty chain which owns the other end of the channel.

channel_id

channel end on the counterparty chain

IdentifiedChannel

IdentifiedChannel defines a channel with additional port and channel identifier fields.

Field

Type

Label

Description

state

current state of the channel end

ordering

Order

whether the channel is ordered or unordered

counterparty

counterparty channel end

connection_hops

repeated

list of connection identifiers, in order, along which packets sent on this channel will travel

version

opaque channel version, which is agreed upon during the handshake

port_id

port identifier

channel_id

channel identifier

MsgAcknowledgement

MsgAcknowledgement receives incoming IBC acknowledgement

Field

Type

Label

Description

packet

acknowledgement

proof

proof_height

signer

MsgAcknowledgementResponse

MsgAcknowledgementResponse defines the Msg/Acknowledgement response type.

MsgChannelCloseConfirm

MsgChannelCloseConfirm defines a msg sent by a Relayer to Chain B to acknowledge the change of channel state to CLOSED on Chain A.

Field

Type

Label

Description

port_id

channel_id

proof_init

proof_height

signer

MsgChannelCloseConfirmResponse

MsgChannelCloseConfirmResponse defines the Msg/ChannelCloseConfirm response type.

MsgChannelCloseInit

MsgChannelCloseInit defines a msg sent by a Relayer to Chain A to close a channel with Chain B.

Field

Type

Label

Description

port_id

channel_id

signer

MsgChannelCloseInitResponse

MsgChannelCloseInitResponse defines the Msg/ChannelCloseInit response type.

MsgChannelOpenAck

MsgChannelOpenAck defines a msg sent by a Relayer to Chain A to acknowledge the change of channel state to TRYOPEN on Chain B.

Field

Type

Label

Description

port_id

channel_id

counterparty_channel_id

counterparty_version

proof_try

proof_height

signer

MsgChannelOpenAckResponse

MsgChannelOpenAckResponse defines the Msg/ChannelOpenAck response type.

MsgChannelOpenConfirm

MsgChannelOpenConfirm defines a msg sent by a Relayer to Chain B to acknowledge the change of channel state to OPEN on Chain A.

Field

Type

Label

Description

port_id

channel_id

proof_ack

proof_height

signer

MsgChannelOpenConfirmResponse

MsgChannelOpenConfirmResponse defines the Msg/ChannelOpenConfirm response type.

MsgChannelOpenInit

MsgChannelOpenInit defines an sdk.Msg to initialize a channel handshake. It is called by a relayer on Chain A.

Field

Type

Label

Description

port_id

channel_id

channel

signer

MsgChannelOpenInitResponse

MsgChannelOpenInitResponse defines the Msg/ChannelOpenInit response type.

MsgChannelOpenTry

MsgChannelOpenInit defines a msg sent by a Relayer to try to open a channel on Chain B.

Field

Type

Label

Description

port_id

desired_channel_id

counterparty_chosen_channel_id

channel

counterparty_version

proof_init

proof_height

signer

MsgChannelOpenTryResponse

MsgChannelOpenTryResponse defines the Msg/ChannelOpenTry response type.

MsgRecvPacket

MsgRecvPacket receives incoming IBC packet

Field

Type

Label

Description

packet

proof

proof_height

signer

MsgRecvPacketResponse

MsgRecvPacketResponse defines the Msg/RecvPacket response type.

MsgTimeout

MsgTimeout receives timed-out packet

Field

Type

Label

Description

packet

proof

proof_height

next_sequence_recv

signer

MsgTimeoutOnClose

MsgTimeoutOnClose timed-out packet upon counterparty channel closure.

Field

Type

Label

Description

packet

proof

proof_close

proof_height

next_sequence_recv

signer

MsgTimeoutOnCloseResponse

MsgTimeoutOnCloseResponse defines the Msg/TimeoutOnClose response type.

MsgTimeoutResponse

MsgTimeoutResponse defines the Msg/Timeout response type.

Packet

Packet defines a type that carries data across different chains through IBC

Field

Type

Label

Description

sequence

number corresponds to the order of sends and receives, where a Packet with an earlier sequence number must be sent and received before a Packet with a later sequence number.

source_port

identifies the port on the sending chain.

source_channel

identifies the channel end on the sending chain.

destination_port

identifies the port on the receiving chain.

destination_channel

identifies the channel end on the receiving chain.

data

actual opaque bytes transferred directly to the application module

timeout_height

block height after which the packet times out

timeout_timestamp

block timestamp (in nanoseconds) after which the packet times out

PacketAckCommitment

PacketAckCommitment defines the genesis type necessary to retrieve and store acknowlegements.

Field

Type

Label

Description

port_id

channel port identifier.

channel_id

channel unique identifier.

sequence

packet sequence.

hash

MsgChannelOpenInitResponse

packet commitment hash.

Order

Order defines if a channel is ORDERED or UNORDERED

Name

Number

Description

ORDER_NONE_UNSPECIFIED

zero-value for channel ordering

ORDER_UNORDERED

packets can be delivered in any order, which may differ from the order in which they were sent.

ORDER_ORDERED

packets are delivered exactly in the order which they were sent

State

State defines if a channel is in one of the following states: CLOSED, INIT, TRYOPEN, OPEN or UNINITIALIZED.

Name

Number

Description

STATE_UNINITIALIZED_UNSPECIFIED

Default State

STATE_INIT

A channel has just started the opening handshake.

STATE_TRYOPEN

A channel has acknowledged the handshake step on the counterparty chain.

STATE_OPEN

A channel has completed the handshake. Open channels are ready to send and receive packets.

STATE_CLOSED

A channel has been closed and can no longer be used to send or receive packets.

Msg

Msg defines the ibc/channel Msg service.

Method Name

Request Type

Response Type

Description

ChannelOpenInit

MsgChannelOpenInit

ChannelOpenInit defines a rpc handler method for MsgChannelOpenInit.

ChannelOpenTry

MsgChannelOpenTry

MsgChannelOpenTryResponse

ChannelOpenTry defines a rpc handler method for MsgChannelOpenTry.

ChannelOpenAck

MsgChannelOpenAck

MsgChannelOpenAckResponse

ChannelOpenAck defines a rpc handler method for MsgChannelOpenAck.

ChannelOpenConfirm

MsgChannelOpenConfirm

MsgChannelOpenConfirmResponse

ChannelOpenConfirm defines a rpc handler method for MsgChannelOpenConfirm.

ChannelCloseInit

MsgChannelCloseInit

MsgChannelCloseInitResponse

ChannelCloseInit defines a rpc handler method for MsgChannelCloseInit.

ChannelCloseConfirm

MsgChannelCloseConfirm

MsgChannelCloseConfirmResponse

ChannelCloseConfirm defines a rpc handler method for MsgChannelCloseConfirm.

RecvPacket

MsgRecvPacket

MsgRecvPacketResponse

RecvPacket defines a rpc handler method for MsgRecvPacket.

Timeout

MsgTimeout

MsgTimeoutResponse

Timeout defines a rpc handler method for MsgTimeout.

TimeoutOnClose

MsgTimeoutOnClose

MsgTimeoutOnCloseResponse

TimeoutOnClose defines a rpc handler method for MsgTimeoutOnClose.

Acknowledgement

MsgAcknowledgement

MsgAcknowledgementResponse

Acknowledgement defines a rpc handler method for MsgAcknowledgement.

ibc/core/client/v1/client.proto

ClientConsensusStates

ClientConsensusStates defines all the stored consensus states for a given client.

Field

Type

Label

Description

client_id

client identifier

consensus_states

ConsensusStateWithHeight

repeated

consensus states and their heights associated with the client

ClientUpdateProposal

ClientUpdateProposal is a governance proposal. If it passes, the client is updated with the provided header. The update may fail if the header is not valid given certain conditions specified by the client implementation.

Field

Type

Label

Description

title

the title of the update proposal

description

the description of the proposal

client_id

the client identifier for the client to be updated if the proposal passes

header

the header used to update the client if the proposal passes

ConsensusStateWithHeight

ConsensusStateWithHeight defines a consensus state with an additional height field.

Field

Type

Label

Description

height

consensus state height

consensus_state

consensus state

Height

Height is a monotonically increasing data type that can be compared against another Height for the purposes of updating and freezing clients

Normally the VersionHeight is incremented at each height while keeping version number the same However some consensus algorithms may choose to reset the height in certain conditions e.g. hard forks, state-machine breaking changes In these cases, the version number is incremented so that height continues to be monitonically increasing even as the VersionHeight gets reset

Field

Type

Label

Description

version_number

the version that the client is currently on

version_height

the height within the given version

IdentifiedClientState

IdentifiedClientState defines a client state with an additional client identifier field.

Field

Type

Label

Description

client_id

client identifier

client_state

client state

MsgCreateClient

MsgCreateClient defines a message to create an IBC client

Field

Type

Label

Description

client_id

client unique identifier

client_state

light client state

consensus_state

consensus state associated with the client that corresponds to a given height.

signer

signer address

MsgCreateClientResponse

MsgCreateClientResponse defines the Msg/CreateClient response type.

MsgSubmitMisbehaviour

MsgSubmitMisbehaviour defines an sdk.Msg type that submits Evidence for light client misbehaviour.

Field

Type

Label

Description

client_id

client unique identifier

misbehaviour

misbehaviour used for freezing the light client

signer

signer address

MsgSubmitMisbehaviourResponse

MsgSubmitMisbehaviourResponse defines the Msg/SubmitMisbehaviour response type.

MsgUpdateClient

MsgUpdateClient defines an sdk.Msg to update a IBC client state using the given header.

Field

Type

Label

Description

client_id

client unique identifier

header

header to update the light client

signer

signer address

MsgUpdateClientResponse

MsgUpdateClientResponse defines the Msg/UpdateClient response type.

MsgUpgradeClient

MsgUpgradeClient defines an sdk.Msg to upgrade an IBC client to a new client state

Field

Type

Label

Description

client_id

client unique identifier

client_state

upgraded client state

upgrade_height

height at which old chain halts and upgrades (i.e last block executed)

proof_upgrade

proof that old chain committed to new client

signer

MsgSubmitMisbehaviourResponse

signer address

MsgUpgradeClientResponse

MsgUpgradeClientResponse defines the Msg/UpgradeClient response type.

Msg

Msg defines the ibc/client Msg service.

Method Name

Request Type

Response Type

Description

CreateClient

MsgCreateClient

MsgCreateClientResponse

CreateClient defines a rpc handler method for MsgCreateClient.

UpdateClient

MsgUpdateClient

MsgUpdateClientResponse

UpdateClient defines a rpc handler method for MsgUpdateClient.

UpgradeClient

MsgUpgradeClient

MsgUpgradeClientResponse

UpgradeClient defines a rpc handler method for MsgUpgradeClient.

SubmitMisbehaviour

MsgSubmitMisbehaviour

SubmitMisbehaviour defines a rpc handler method for MsgSubmitMisbehaviour.

ibc/core/client/v1/query.proto

QueryClientStateRequest

QueryClientStateRequest is the request type for the Query/ClientState RPC method

Field

Type

Label

Description

client_id

client state unique identifier

QueryClientStateResponse

QueryClientStateResponse is the response type for the Query/ClientState RPC method. Besides the client state, it includes a proof and the height from which the proof was retrieved.

Field

Type

Label

Description

client_state

client state associated with the request identifier

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryClientStatesRequest

QueryClientStatesRequest is the request type for the Query/ClientStates RPC method

Field

Type

Label

Description

pagination

pagination request

QueryClientStatesResponse

QueryClientStatesResponse is the response type for the Query/ClientStates RPC method.

Field

Type

Label

Description

client_states

IdentifiedClientState

repeated

list of stored ClientStates of the chain.

pagination

pagination response

QueryConsensusStateRequest

QueryConsensusStateRequest is the request type for the Query/ConsensusState RPC method. Besides the consensus state, it includes a proof and the height from which the proof was retrieved.

Field

Type

Label

Description

client_id

client identifier

version_number

consensus state version number

version_height

consensus state version height

latest_height

latest_height overrrides the height field and queries the latest stored ConsensusState

QueryConsensusStateResponse

QueryConsensusStateResponse is the response type for the Query/ConsensusState RPC method

Field

Type

Label

Description

consensus_state

consensus state associated with the client identifier at the given height

proof

merkle proof of existence

proof_path

merkle proof path

proof_height

height at which the proof was retrieved

QueryConsensusStatesRequest

QueryConsensusStatesRequest is the request type for the Query/ConsensusStates RPC method.

Field

Type

Label

Description

client_id

client identifier

pagination

pagination request

QueryConsensusStatesResponse

QueryConsensusStatesResponse is the response type for the Query/ConsensusStates RPC method

Field

Type

Label

Description

consensus_states

ConsensusStateWithHeight

repeated

consensus states associated with the identifier

pagination

QueryClientStatesResponse

pagination response

Query

Query provides defines the gRPC querier service

Method Name

Request Type

Response Type

Description

ClientState

QueryClientStateRequest

QueryClientStateResponse

ClientState queries an IBC light client.

ClientStates

QueryClientStatesRequest

ClientStates queries all the IBC light clients of a chain.

ConsensusState

QueryConsensusStateRequest

QueryConsensusStateResponse

ConsensusState queries a consensus state associated with a client state at a given height.

ConsensusStates

QueryConsensusStatesRequest

QueryConsensusStatesResponse

ConsensusStates queries all the consensus state associated with a given client.

ibc/core/client/v1/genesis.proto

GenesisState

GenesisState defines the ibc client submodule's genesis state.

Field

Type

Label

Description

clients

IdentifiedClientState

repeated

client states with their corresponding identifiers

clients_consensus

ClientConsensusStates

repeated

consensus states from each client

create_localhost

create localhost on initialization

ibc/lightclients/solomachine/v1/solomachine.proto

ChannelStateData

ChannelStateData returns the SignBytes data for channel state verification.

Field

Type

Label

Description

path

ibc.core.channel.v1.Channel

channel

ClientState

ClientState defines a solo machine client that tracks the current consensus state and if the client is frozen.

Field

Type

Label

Description

sequence

latest sequence of the client state

frozen_sequence

frozen sequence of the solo machine

consensus_state

ConsensusState

allow_update_after_proposal

when set to true, will allow governance to update a solo machine client. The client will be unfrozen if it is frozen.

ClientStateData

ClientStateData returns the SignBytes data for client state verification.

Field

Type

Label

Description

path

client_state

ConnectionStateData

ConnectionStateData returns the SignBytes data for connection state verification.

Field

Type

Label

Description

path

ibc.core.connection.v1.ConnectionEnd

connection

ConsensusState

ConsensusState defines a solo machine consensus state. The sequence of a consensus state is contained in the "height" key used in storing the consensus state.

Field

Type

Label

Description

public_key

public key of the solo machine

diversifier

diversifier allows the same public key to be re-used across different solo machine clients (potentially on different chains) without being considered misbehaviour.

timestamp

ConsensusStateData

ConsensusStateData returns the SignBytes data for consensus state verification.

Field

Type

Label

Description

path

consensus_state

Header

Header defines a solo machine consensus header

Field

Type

Label

Description

sequence

sequence to update solo machine public key at

timestamp

signature

new_public_key

new_diversifier

HeaderData

HeaderData returns the SignBytes data for update verification.

Field

Type

Label

Description

new_pub_key

header public key

new_diversifier

header diversifier

Misbehaviour

Misbehaviour defines misbehaviour for a solo machine which consists of a sequence and two signatures over different messages at that sequence.

Field

Type

Label

Description

client_id

sequence

signature_one

signature_two

NextSequenceRecvData

NextSequenceRecvData returns the SignBytes data for verification of the next sequence to be received.

Field

Type

Label

Description

path

next_seq_recv

PacketAcknowledgementData

PacketAcknowledgementData returns the SignBytes data for acknowledgement verification.

Field

Type

Label

Description

path

acknowledgement

PacketCommitmentData

PacketCommitmentData returns the SignBytes data for packet commitment verification.

Field

Type

Label

Description

path

commitment

PacketReceiptAbsenceData

PacketReceiptAbsenceData returns the SignBytes data for packet receipt absence verification.

Field

Type

Label

Description

path

SignBytes

SignBytes defines the signed bytes used for signature verification.

Field

Type

Label

Description

sequence

timestamp

diversifier

data_type

type of the data used

data

marshaled data

SignatureAndData

SignatureAndData contains a signature and the data signed over to create that signature.

Field

Type

Label

Description

signature

data_type

data

timestamp

TimestampedSignatureData

TimestampedSignatureData contains the signature data and the timestamp of the signature.

Field

Type

Label

Description

signature_data

timestamp

DataType

DataType defines the type of solo machine proof being created. This is done to preserve uniqueness of different data sign byte encodings.

Name

Number

Description

DATA_TYPE_UNINITIALIZED_UNSPECIFIED

Default State

DATA_TYPE_CLIENT_STATE

Data type for client state verification

DATA_TYPE_CONSENSUS_STATE

Data type for consensus state verification

DATA_TYPE_CONNECTION_STATE

Data type for connection state verification

DATA_TYPE_CHANNEL_STATE

Data type for channel state verification

DATA_TYPE_PACKET_COMMITMENT

Data type for packet commitment verification

DATA_TYPE_PACKET_ACKNOWLEDGEMENT

Data type for packet acknowledgement verification

DATA_TYPE_PACKET_RECEIPT_ABSENCE

Data type for packet receipt absence verification

DATA_TYPE_NEXT_SEQUENCE_RECV

Data type for next sequence recv verification

DATA_TYPE_HEADER

Data type for header verification

ibc/lightclients/tendermint/v1/tendermint.proto

ClientState

ClientState from Tendermint tracks the current validator set, latest height, and a possible frozen height.

Field

Type

Label

Description

chain_id

trust_level

Fraction

trusting_period

duration of the period since the LatestTimestamp during which the submitted headers are valid for upgrade

unbonding_period

duration of the staking unbonding period

max_clock_drift

defines how much new (untrusted) header's Time can drift into the future.

frozen_height

Block height when the client was frozen due to a misbehaviour

latest_height

tendermint.abci.ConsensusParams

Latest height the client was updated to

consensus_params

Consensus params of the chain

proof_specs

ics23.ProofSpec

repeated

Proof specifications used in verifying counterparty state

upgrade_path

Path at which next upgraded client will be committed

allow_update_after_expiry

This flag, when set to true, will allow governance to recover a client which has expired

allow_update_after_misbehaviour

This flag, when set to true, will allow governance to unfreeze a client whose chain has experienced a misbehaviour event

ConsensusState

ConsensusState defines the consensus state from Tendermint.

Field

Type

Label

Description

timestamp

ibc.core.commitment.v1.MerkleRoot

timestamp that corresponds to the block height in which the ConsensusState was stored.

root

commitment root (i.e app hash)

next_validators_hash

Fraction

Fraction defines the protobuf message type for tmmath.Fraction

Field

Type

Label

Description

numerator

denominator

tendermint.types.SignedHeader

Header

Header defines the Tendermint client consensus Header. It encapsulates all the information necessary to update from a trusted Tendermint ConsensusState. The inclusion of TrustedHeight and TrustedValidators allows this update to process correctly, so long as the ConsensusState for the TrustedHeight exists, this removes race conditions among relayers The SignedHeader and ValidatorSet are the new untrusted update fields for the client. The TrustedHeight is the height of a stored ConsensusState on the client that will be used to verify the new untrusted header. The Trusted ConsensusState must be within the unbonding period of current time in order to correctly verify, and the TrustedValidators must hash to TrustedConsensusState.NextValidatorsHash since that is the last trusted validator set at the TrustedHeight.

Field

Type

Label

Description

signed_header

validator_set

tendermint.types.ValidatorSet

trusted_height

tendermint.types.ValidatorSet

trusted_validators

Misbehaviour

Misbehaviour is a wrapper over two conflicting Headers that implements Misbehaviour interface expected by ICS-02

Field

Type

Label

Description

client_id

chain_id

header_1

header_2

ibc/lightclients/localhost/v1/localhost.proto

ClientState

ClientState defines a loopback (localhost) client. It requires (read-only) access to keys outside the client prefix.

Field

Type

Label

Description

chain_id

self chain ID

height

self latest block height

ibc/applications/transfer/v1/transfer.proto

DenomTrace

DenomTrace contains the base denomination for ICS20 fungible tokens and the source tracing information path.

Field

Type

Label

Description

path

path defines the chain of port/channel identifiers used for tracing the source of the fungible token.

base_denom

base denomination of the relayed fungible token.

FungibleTokenPacketData

FungibleTokenPacketData defines a struct for the packet payload See FungibleTokenPacketData spec: https://github.com/cosmos/ics/tree/master/spec/ics-020-fungible-token-transfer#data-structures

Field

Type

Label

Description

denom

the token denomination to be transferred

amount

the token amount to be transferred

sender

the sender address

receiver

the recipient address on the destination chain

MsgTransfer

MsgTransfer defines a msg to transfer fungible tokens (i.e Coins) between ICS20 enabled chains. See ICS Spec here: https://github.com/cosmos/ics/tree/master/spec/ics-020-fungible-token-transfer#data-structures

Field

Type

Label

Description

source_port

the port on which the packet will be sent

source_channel

the channel by which the packet will be sent

token

the tokens to be transferred

sender

the sender address

receiver

the recipient address on the destination chain

timeout_height

Timeout height relative to the current block height. The timeout is disabled when set to 0.

timeout_timestamp

Timeout timestamp (in nanoseconds) relative to the current block timestamp. The timeout is disabled when set to 0.

MsgTransferResponse

MsgTransferResponse defines the Msg/Transfer response type.

Params

Params defines the set of IBC transfer parameters. NOTE: To prevent a single token from being transferred, set the TransfersEnabled parameter to true and then set the bank module's SendEnabled parameter for the denomination to false.

Field

Type

Label

Description

send_enabled

send_enabled enables or disables all cross-chain token transfers from this chain.

receive_enabled

receive_enabled enables or disables all cross-chain token transfers to this chain.

Msg

Msg defines the ibc/transfer Msg service.

Method Name

Request Type

Response Type

Description

Transfer

MsgTransfer

MsgTransferResponse

Transfer defines a rpc handler method for MsgTransfer.

ibc/applications/transfer/v1/query.proto

QueryDenomTraceRequest

QueryDenomTraceRequest is the request type for the Query/DenomTrace RPC method

Field

Type

Label

Description

hash

hash (in hex format) of the denomination trace information.

QueryDenomTraceResponse

QueryDenomTraceResponse is the response type for the Query/DenomTrace RPC method.

Field

Type

Label

Description

denom_trace

DenomTrace

denom_trace returns the requested denomination trace information.

QueryDenomTracesRequest

QueryConnectionsRequest is the request type for the Query/DenomTraces RPC method

Field

Type

Label

Description

pagination

pagination defines an optional pagination for the request.

QueryDenomTracesResponse

QueryConnectionsResponse is the response type for the Query/DenomTraces RPC method.

Field

Type

Label

Description

denom_traces

DenomTrace

repeated

denom_traces returns all denominations trace information.

pagination

pagination defines the pagination in the response.

QueryParamsRequest

QueryParamsRequest is the request type for the Query/Params RPC method.

QueryParamsResponse

QueryParamsResponse is the response type for the Query/Params RPC method.

Field

Type

Label

Description

params

params defines the parameters of the module.

Query

Query provides defines the gRPC querier service.

Method Name

Request Type

Response Type

Description

DenomTrace

QueryDenomTraceRequest

QueryDenomTraceResponse

DenomTrace queries a denomination trace information.

DenomTraces

QueryDenomTracesRequest

QueryDenomTracesResponse

DenomTraces queries all denomination traces.

Params

Params queries all parameters of the ibc-transfer module.

ibc/applications/transfer/v1/genesis.proto

GenesisState

GenesisState defines the ibc-transfer genesis state

Field

Type

Label

Description

port_id

denom_traces

DenomTrace

repeated

params