Protocol Documentation
Table of Contents
cosmos/crypto/multisig/v1beta1/multisig.proto
CompactBitArray
CompactBitArray is an implementation of a space efficient bit array. This is used to ensure that the encoded data takes up a minimal amount of space after proto encoding. This is not thread safe, and is not intended for concurrent usage.
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.
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.
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 is the current upgrade plan. |
Query
Query defines the gRPC upgrade querier service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
CurrentPlan | CurrentPlan queries the current upgrade plan. | ||
AppliedPlan | 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 | Params returns the total set of minting parameters. | ||
Inflation | Inflation returns the current minting inflation value. | ||
AnnualProvisions | 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 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 | hash defines the hash of the evidence. |
Msg
Msg defines the evidence Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
SubmitEvidence | 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 | Evidence queries evidence based on evidence hash. | ||
AllEvidence | 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 | 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 | |||
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.
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 | Send defines a method for sending coins from one account to another account. | ||
MultiSend | 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 | 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 | repeated | ||
default_send_enabled |
SendEnabled
SendEnabled maps coin denom to a send_enabled status (whether a denom is sendable).
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 | Balance queries the balance of a single coin for a single account. | ||
AllBalances | AllBalances queries the balance of all coins for a single account. | ||
TotalSupply | TotalSupply queries the total supply of all coins. | ||
SupplyOf | 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 | repeated | balances is an array containing the balances of all the accounts. | |
supply | repeated | supply represents the total supply. | |
denom_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 | repeated |
Owner
Owner defines a single capability owner. An owner is defined by the name of capability and the 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 | 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 | 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).
MsgSetWithdrawAddressResponse
MsgSetWithdrawAddressResponse defines the Msg/SetWithdrawAddress response type.
MsgWithdrawDelegatorReward
MsgWithdrawDelegatorReward represents delegation withdrawal to a delegator from a single validator.
MsgWithdrawDelegatorRewardResponse
MsgWithdrawDelegatorRewardResponse defines the Msg/WithdrawDelegatorReward response type.
MsgWithdrawValidatorCommission
MsgWithdrawValidatorCommission withdraws the full commission to the validator address.
| Field | Type | Label | Description |
|---|---|---|---|
validator_address |
MsgWithdrawValidatorCommissionResponse
MsgWithdrawValidatorCommissionResponse defines the Msg/WithdrawValidatorCommission response type.
Msg
Msg defines the distribution Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
SetWithdrawAddress | SetWithdrawAddress defines a method to change the withdraw address for a delegator (or validator self-delegation). | ||
WithdrawDelegatorReward | WithdrawDelegatorReward defines a method to withdraw rewards of delegator from a single validator. | ||
WithdrawValidatorCommission | WithdrawValidatorCommission defines a method to withdraw the full commission to the validator address. | ||
FundCommunityPool | 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
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.
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.
ValidatorSlashEvents
ValidatorSlashEvents is a collection of ValidatorSlashEvent messages.
| Field | Type | Label | Description |
|---|---|---|---|
validator_slash_events | 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 | 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 | 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 | 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 | 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 | Params queries params of the distribution module. | ||
ValidatorOutstandingRewards | ValidatorOutstandingRewards queries rewards of a validator address. | ||
ValidatorCommission | ValidatorCommission queries accumulated commission for a validator. | ||
ValidatorSlashes | ValidatorSlashes queries slash events of a validator. | ||
DelegationRewards | DelegationRewards queries the total rewards accrued by a delegation. | ||
DelegationTotalRewards | DelegationTotalRewards queries the total rewards accrued by a each validator. | ||
DelegatorValidators | DelegatorValidators queries the validators of a delegator. | ||
DelegatorWithdrawAddress | DelegatorWithdrawAddress queries withdraw address of a delegator. | ||
CommunityPool | 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 | 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 | fee_pool defines the fee pool at genesis. | ||
delegator_withdraw_infos | repeated | fee_pool defines the delegator withdraw infos at genesis. | |
previous_proposer | 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 | repeated | fee_pool defines the accumulated commisions of all validators at genesis. | |
validator_historical_rewards | repeated | fee_pool defines the historical rewards of all validators at genesis. | |
validator_current_rewards | repeated | fee_pool defines the current rewards of all validators at genesis. | |
delegator_starting_infos | repeated | fee_pool defines the delegator starting infos at genesis. | |
validator_slash_events | 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 | 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 | 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 | 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 | validator_slash_event describes the slash event. |
cosmos/crisis/v1beta1/tx.proto
MsgVerifyInvariant
MsgVerifyInvariant represents a message to verify a particular invariance.
MsgVerifyInvariantResponse
MsgVerifyInvariantResponse defines the Msg/VerifyInvariant response type.
Msg
Msg defines the bank Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
VerifyInvariant | 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 | |||
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. |
SignatureDescriptor.Data
Data represents signature data
| Field | Type | Label | Description |
|---|---|---|---|
single | single represents a single signer | ||
multi | multi represents a multisig signer |
SignatureDescriptor.Data.Multi
Multi is the signature data for a multisig public key
| Field | Type | Label | Description |
|---|---|---|---|
bitarray | bitarray specifies which keys within the multisig are signing | ||
signatures | 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 | 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 | repeated | signatures are the signature descriptors |
SignMode
SignMode represents a signing mode with its own security guarantees.
| Name | Number | Description |
|---|---|---|
SIGN_MODE_UNSPECIFIED | 0 | SIGN_MODE_UNSPECIFIED specifies an unknown signing mode and will be rejected |
SIGN_MODE_DIRECT | 1 | SIGN_MODE_DIRECT specifies a signing mode which uses SignDoc and is verified with raw bytes from Tx |
SIGN_MODE_TEXTUAL | 2 | 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 | 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 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 | 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 | single represents a single signer | ||
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 | 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 | 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 | 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 | body is the processable content of the transaction | ||
auth_info | 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 defines the Msg/CreateVestingAccount response type.
Msg
Msg defines the bank Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
CreateVestingAccount | CreateVestingAccount defines a method that enables creating a vesting account. |
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 | |||
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 |
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 | |||
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. |
REF: #2373 | | min_self_delegation | string | | |
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 |
Msg
Msg defines the staking Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
CreateValidator | CreateValidator defines a method for creating a new validator. | ||
EditValidator | EditValidator defines a method for editing an existing validator. | ||
Delegate | Delegate defines a method for performing a delegation of coins from a delegator to a validator. | ||
BeginRedelegate | BeginRedelegate defines a method for performing a redelegation of coins from a delegator and source validator to a destination validator. | ||
Undelegate | 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 | 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 | 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 | 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 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 | 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 | 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 | pagination defines the pagination in the response. |
Query
Query defines the gRPC querier service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
Validators | Validators queries all validators that match the given status. | ||
Validator | Validator queries validator info for given validator address. | ||
ValidatorDelegations | ValidatorDelegations queries delegate info for given validator. | ||
ValidatorUnbondingDelegations | ValidatorUnbondingDelegations queries unbonding delegations of a validator. | ||
Delegation | Delegation queries delegate info for given validator delegator pair. | ||
UnbondingDelegation | UnbondingDelegation queries unbonding info for given validator delegator pair. | ||
DelegatorDelegations | DelegatorDelegations queries all delegations of a given delegator address. | ||
DelegatorUnbondingDelegations | DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address. | ||
Redelegations | Redelegations queries redelegations of given address. | ||
DelegatorValidators | DelegatorValidators queries all validators info for given delegator address. | ||
DelegatorValidator | DelegatorValidator queries validator info for given delegator validator pair. | ||
HistoricalInfo | HistoricalInfo queries the historical info for given height. | ||
Pool | 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 | 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 | repeated | delegations defines the delegations active at genesis. | |
unbonding_delegations | repeated | unbonding_delegations defines the unbonding delegations active at genesis. | |
redelegations | 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 | |||
update_time |
CommissionRates
CommissionRates defines the initial commission rates to be used for creating a validator.
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.
DVPairs
DVPairs defines an array of DVPair objects.
| Field | Type | Label | Description |
|---|---|---|---|
pairs | 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 | 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.
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 | |||
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 | |||
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.
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 | 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 | |||
balance |
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 | |||
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 | 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 | |||
min_self_delegation |
BondStatus
BondStatus is the status of a validator.
| Name | Number | Description |
|---|---|---|
BOND_STATUS_UNSPECIFIED | 0 | UNSPECIFIED defines an invalid validator status. |
BOND_STATUS_UNBONDED | 1 | UNBONDED defines a validator that is not bonded. |
BOND_STATUS_UNBONDING | 2 | UNBONDING defines a validator that is unbonding. |
BOND_STATUS_BONDED | 3 | 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 | 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.
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 | 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 | 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 | 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 | Params queries the parameters of slashing module | ||
SigningInfo | SigningInfo queries the signing info of given cons address | ||
SigningInfos | 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 | repeated | signing_infos represents a map between validator addresses and their signing infos. | |
missed_blocks | 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 | 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 | 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 | 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.
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.
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 | 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 | repeated | List of txs in current page |
SimulationResponse
SimulationResponse defines the response generated when a transaction is successfully simulated.
StringEvent
StringEvent defines en Event object wrapper where all the attributes contain key/value pairs that are strings instead of raw bytes.
TxMsgData
TxMsgData defines a list of MsgData. A transaction will have a MsgData object for each message.
| Field | Type | Label | Description |
|---|---|---|---|
data | 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 | 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. | ||
tx | 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.
Pairs
Pairs defines a repeated slice of Pair objects.
| Field | Type | Label | Description |
|---|---|---|---|
pairs | repeated |
cosmos/base/snapshots/v1beta1/snapshot.proto
Metadata
Metadata contains SDK-specific snapshot metadata.
| Field | Type | Label | Description |
|---|---|---|---|
chunk_hashes | repeated | SHA-256 chunk hashes |
Snapshot
Snapshot contains Tendermint state sync snapshot info.
cosmos/base/simulate/v1beta1/simulate.proto
SimulateRequest
SimulateRequest is the request type for the SimulateServiceService.Simulate RPC method.
| Field | Type | Label | Description |
|---|---|---|---|
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 | 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 | 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.
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.
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.
CommitInfo
CommitInfo defines commit information used by the multi-store when committing a version/height.
StoreInfo
StoreInfo defines store-specific commit information. It contains a reference between a store name and the commit ID.
cosmos/base/store/v1beta1/snapshot.proto
SnapshotIAVLItem
SnapshotIAVLItem is an exported IAVL node.
SnapshotItem
SnapshotItem is an item contained in a rootmulti.Store snapshot.
| Field | Type | Label | Description |
|---|---|---|---|
store | |||
iavl |
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 | repeated |
ReflectionService
ReflectionService defines a service for interface reflection.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
ListAllInterfaces | ListAllInterfaces lists all the interfaces registered in the interface registry. | ||
ListImplementations | 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 | |||
option |
MsgVoteResponse
MsgVoteResponse defines the Msg/Vote response type.
Msg
Msg defines the bank Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
SubmitProposal | SubmitProposal defines a method to create new proposal given a content. | ||
Vote | Vote defines a method to add a vote on a specific proposal. | ||
Deposit | 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.
TextProposal
TextProposal defines a standard text proposal whose changes need to be manually updated in case of approval.
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 |
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 | 0 | PROPOSAL_STATUS_UNSPECIFIED defines the default propopsal status. |
PROPOSAL_STATUS_DEPOSIT_PERIOD | 1 | PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period. |
PROPOSAL_STATUS_VOTING_PERIOD | 2 | PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period. |
PROPOSAL_STATUS_PASSED | 3 | PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed. |
PROPOSAL_STATUS_REJECTED | 4 | PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected. |
PROPOSAL_STATUS_FAILED | 5 | 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 | 0 | VOTE_OPTION_UNSPECIFIED defines a no-op vote option. |
VOTE_OPTION_YES | 1 | VOTE_OPTION_YES defines a yes vote option. |
VOTE_OPTION_ABSTAIN | 2 | VOTE_OPTION_ABSTAIN defines an abstain vote option. |
VOTE_OPTION_NO | 3 | VOTE_OPTION_NO defines a no vote option. |
VOTE_OPTION_NO_WITH_VETO | 4 | 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 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 | 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 | voting_params defines the parameters related to voting. | ||
deposit_params | deposit_params defines the parameters related to deposit. | ||
tally_params | 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 |
QueryProposalsRequest
QueryProposalsRequest is the request type for the Query/Proposals RPC method.
| Field | Type | Label | Description |
|---|---|---|---|
proposal_status | 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 | 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 | 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 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 | 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 | Proposal queries proposal details based on ProposalID. | ||
Proposals | Proposals queries all proposals based on given status. | ||
Vote | Vote queries voted information based on proposalID, voterAddr. | ||
Votes | Votes queries votes of a given proposal. | ||
Params | Params queries all parameters of the gov module. | ||
Deposit | Deposit queries single deposit information based proposalID, depositAddr. | ||
Deposits | Deposits queries all deposits of a single proposal. | ||
TallyResult | 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 | repeated | deposits defines all the deposits present at genesis. | |
votes | repeated | votes defines all the votes present at genesis. | |
proposals | repeated | proposals defines all the proposals present at genesis. | |
deposit_params | params defines all the paramaters of related to deposit. | ||
voting_params | params defines all the paramaters of related to voting. | ||
tally_params | params defines all the paramaters of related to tally. |
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 | ICS003 - Connections genesis state | ||
channel_genesis | 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 | 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 | 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 | repeated | list of stored connections of the chain. | |
pagination | pagination response | ||
height | query block height |
Query
Query provides defines the gRPC querier service
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
Connection | Connection queries an IBC connection end. | ||
Connections | Connections queries all the IBC connections of a chain. | ||
ClientConnections | ClientConnections queries the connection paths associated with a client state. | ||
ConnectionClientState | ConnectionClientState queries the client state associated with the connection. | ||
ConnectionConsensusState | 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 | 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 |
|---|---|---|---|
id | 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: | ||
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: | ||
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: | ||
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 | 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 | 0 | Default State |
STATE_INIT | 1 | A connection end has just started the opening handshake. |
STATE_TRYOPEN | 2 | A connection end has acknowledged the handshake step on the counterparty chain. |
STATE_OPEN | 3 | A connection end has completed the handshake. |
Msg
Msg defines the ibc/connection Msg service.
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
ConnectionOpenInit | ConnectionOpenInit defines a rpc handler method for MsgConnectionOpenInit. | ||
ConnectionOpenTry | ConnectionOpenTry defines a rpc handler method for MsgConnectionOpenTry. | ||
ConnectionOpenAck | ConnectionOpenAck defines a rpc handler method for MsgConnectionOpenAck. | ||
ConnectionOpenConfirm | 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 | repeated | ||
client_connection_paths | repeated |
ibc/core/commitment/v1/commitment.proto
Key
Key defines a proof Key
| Field | Type | Label | Description |
|---|---|---|---|
name | |||
enc |
KeyPath
KeyPath defines a slice of keys
| Field | Type | Label | Description |
|---|---|---|---|
keys | 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 |
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 |
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 | 0 | URL encoding |
KEY_ENCODING_HEX | 1 | 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 | 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 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 | 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 | 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 | 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 | query block height |
Query
Query provides defines the gRPC querier service
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
Channel | Channel queries an IBC Channel. | ||
Channels | Channels queries all the IBC channels of a chain. | ||
ConnectionChannels | ConnectionChannels queries all the channels associated with a connection end. | ||
ChannelClientState | ChannelClientState queries for the client state for the channel associated with the provided channel identifiers. | ||
ChannelConsensusState | ChannelConsensusState queries for the consensus state for the channel associated with the provided channel identifiers. | ||
PacketCommitment | PacketCommitment queries a stored packet commitment hash. | ||
PacketCommitments | PacketCommitments returns the all the packet commitments hashes associated with a channel. | ||
PacketAcknowledgement | PacketAcknowledgement queries a stored packet acknowledgement hash. | ||
UnreceivedPackets | UnreceivedPackets returns all the unrelayed IBC packets associated with a channel and sequences. | ||
UnrelayedAcks | UnrelayedAcks returns all the unrelayed IBC acknowledgements associated with a channel and sequences. | ||
NextSequenceReceive | 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 | repeated | ||
acknowledgements | repeated | ||
commitments | repeated | ||
send_sequences | repeated | ||
recv_sequences | repeated | ||
ack_sequences | repeated |
PacketSequence
PacketSequence defines the genesis type necessary to retrieve and store next send and receive sequences.
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
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 | 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 | 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.
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.
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 | packet commitment hash. |
Order
Order defines if a channel is ORDERED or UNORDERED
| Name | Number | Description |
|---|---|---|
ORDER_NONE_UNSPECIFIED | 0 | zero-value for channel ordering |
ORDER_UNORDERED | 1 | packets can be delivered in any order, which may differ from the order in which they were sent. |
ORDER_ORDERED | 2 | 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 | 0 | Default State |
STATE_INIT | 1 | A channel has just started the opening handshake. |
STATE_TRYOPEN | 2 | A channel has acknowledged the handshake step on the counterparty chain. |
STATE_OPEN | 3 | A channel has completed the handshake. Open channels are ready to send and receive packets. |
STATE_CLOSED | 4 | 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 | ChannelOpenInit defines a rpc handler method for MsgChannelOpenInit. | ||
ChannelOpenTry | ChannelOpenTry defines a rpc handler method for MsgChannelOpenTry. | ||
ChannelOpenAck | ChannelOpenAck defines a rpc handler method for MsgChannelOpenAck. | ||
ChannelOpenConfirm | ChannelOpenConfirm defines a rpc handler method for MsgChannelOpenConfirm. | ||
ChannelCloseInit | ChannelCloseInit defines a rpc handler method for MsgChannelCloseInit. | ||
ChannelCloseConfirm | ChannelCloseConfirm defines a rpc handler method for MsgChannelCloseConfirm. | ||
RecvPacket | RecvPacket defines a rpc handler method for MsgRecvPacket. | ||
Timeout | Timeout defines a rpc handler method for MsgTimeout. | ||
TimeoutOnClose | TimeoutOnClose defines a rpc handler method for MsgTimeoutOnClose. | ||
Acknowledgement | 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 | 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 | 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 | CreateClient defines a rpc handler method for MsgCreateClient. | ||
UpdateClient | UpdateClient defines a rpc handler method for MsgUpdateClient. | ||
UpgradeClient | UpgradeClient defines a rpc handler method for MsgUpgradeClient. | ||
SubmitMisbehaviour | 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 | 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 | repeated | consensus states associated with the identifier | |
pagination | pagination response |
Query
Query provides defines the gRPC querier service
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
ClientState | ClientState queries an IBC light client. | ||
ClientStates | ClientStates queries all the IBC light clients of a chain. | ||
ConsensusState | ConsensusState queries a consensus state associated with a client state at a given height. | ||
ConsensusStates | 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 | repeated | client states with their corresponding identifiers | |
clients_consensus | 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 | |||
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 | |||
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 | |||
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.
PacketAcknowledgementData
PacketAcknowledgementData returns the SignBytes data for acknowledgement verification.
PacketCommitmentData
PacketCommitmentData returns the SignBytes data for packet commitment verification.
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.
TimestampedSignatureData
TimestampedSignatureData contains the signature data and the timestamp of the signature.
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 | 0 | Default State |
DATA_TYPE_CLIENT_STATE | 1 | Data type for client state verification |
DATA_TYPE_CONSENSUS_STATE | 2 | Data type for consensus state verification |
DATA_TYPE_CONNECTION_STATE | 3 | Data type for connection state verification |
DATA_TYPE_CHANNEL_STATE | 4 | Data type for channel state verification |
DATA_TYPE_PACKET_COMMITMENT | 5 | Data type for packet commitment verification |
DATA_TYPE_PACKET_ACKNOWLEDGEMENT | 6 | Data type for packet acknowledgement verification |
DATA_TYPE_PACKET_RECEIPT_ABSENCE | 7 | Data type for packet receipt absence verification |
DATA_TYPE_NEXT_SEQUENCE_RECV | 8 | Data type for next sequence recv verification |
DATA_TYPE_HEADER | 9 | 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 | |||
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 | Latest height the client was updated to | ||
consensus_params | Consensus params of the chain | ||
proof_specs | 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 | 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
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 | |||
trusted_height | |||
trusted_validators |
Misbehaviour
Misbehaviour is a wrapper over two conflicting Headers that implements Misbehaviour interface expected by ICS-02
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 | 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 | 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 | 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 | DenomTrace queries a denomination trace information. | ||
DenomTraces | 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 | repeated | ||
params |
Scalar Value Types
| .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
|---|---|---|---|---|---|---|---|---|
double | double | double | float | float64 | double | float | Float | |
float | float | float | float | float32 | float | float | Float | |
int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum |
uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) |
uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) |
sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum |
fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) |
fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum |
sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum |
bool | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass | |
string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) |
bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | []byte | ByteString | string | String (ASCII-8BIT) |
Last updated