Protobuf Documentation
Table of Contents
cosmos/bank/v1beta1/query.proto
cosmos/base/tendermint/v1beta1/query.proto
cosmos/distribution/v1beta1/query.proto
cosmos/gov/v1beta1/query.proto
cosmos/staking/v1beta1/query.proto
ibc/core/channel/v1/query.proto
cosmos/base/v1beta1/coin.proto
Coin
Coin defines a token with a denomination and an amount.
NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
Field | Type | Label | Description |
---|---|---|---|
denom | string | ||
amount | string |
DecCoin
DecCoin defines a token with a denomination and a decimal amount.
NOTE: The amount field is an Dec which implements the custom method signatures required by gogoproto.
Field | Type | Label | Description |
---|---|---|---|
denom | string | ||
amount | string |
DecProto
DecProto defines a Protobuf wrapper around a Dec object.
Field | Type | Label | Description |
---|---|---|---|
dec | string |
IntProto
IntProto defines a Protobuf wrapper around an Int object.
Field | Type | Label | Description |
---|---|---|---|
int | string |
coinswap/coinswap.proto
Input
Input defines the properties of order's input
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
coin | cosmos.base.v1beta1.Coin |
Output
Output defines the properties of order's output
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
coin | cosmos.base.v1beta1.Coin |
Params
Params defines token module's parameters
Field | Type | Label | Description |
---|---|---|---|
fee | cosmos.base.v1beta1.Coin |
Pool
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
standard_denom | string | denom of base coin of the pool | |
counterparty_denom | string | denom of counterparty coin of the pool | |
escrow_address | string | escrow account for deposit tokens | |
lpt_denom | string | denom of the liquidity pool coin |
coinswap/genesis.proto
GenesisState
GenesisState defines the coinswap module's genesis state
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
standard_denom | string | ||
pool | Pool | repeated | |
sequence | uint64 |
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 | bytes | 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 | uint64 | 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 | uint64 | 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 | bool | 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 | bytes | next_key is the key to be passed to PageRequest.key to query the next page most efficiently | |
total | uint64 | total is total number of results available if PageRequest.count_total was set, its value is undefined otherwise |
coinswap/query.proto
PoolInfo
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
escrow_address | string | escrow account for deposit tokens | |
standard | cosmos.base.v1beta1.Coin | main token balance | |
token | cosmos.base.v1beta1.Coin | counterparty token balance | |
lpt | cosmos.base.v1beta1.Coin | liquidity token balance | |
fee | string | liquidity pool fee |
QueryLiquidityPoolRequest
QueryLiquidityPoolRequest is request type for the Query/LiquidityPool RPC method
Field | Type | Label | Description |
---|---|---|---|
lpt_denom | string |
QueryLiquidityPoolResponse
QueryLiquidityPoolResponse is response type for the Query/LiquidityPool RPC method
Field | Type | Label | Description |
---|---|---|---|
pool | PoolInfo |
QueryLiquidityPoolsRequest
QueryLiquidityPoolsRequest is request type for the Query/LiquidityPools RPC method
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryLiquidityPoolsResponse
QueryLiquidityPoolsResponse is response type for the Query/LiquidityPools RPC method
Field | Type | Label | Description |
---|---|---|---|
pools | PoolInfo | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
Query
Query creates service with coinswap as rpc
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
LiquidityPool | QueryLiquidityPoolRequest | QueryLiquidityPoolResponse | LiquidityPool returns the liquidity pool for the provided lpt_denom | GET | /irismod/coinswap/pools/{lpt_denom} |
LiquidityPools | QueryLiquidityPoolsRequest | QueryLiquidityPoolsResponse | LiquidityPools returns all the liquidity pools available | GET | /irismod/coinswap/pools |
coinswap/tx.proto
MsgAddLiquidity
MsgAddLiquidity defines a msg for adding liquidity to a reserve pool
Field | Type | Label | Description |
---|---|---|---|
max_token | cosmos.base.v1beta1.Coin | ||
exact_standard_amt | string | ||
min_liquidity | string | ||
deadline | int64 | ||
sender | string |
MsgAddLiquidityResponse
MsgAddLiquidityResponse defines the Msg/AddLiquidity response type
Field | Type | Label | Description |
---|---|---|---|
mint_token | cosmos.base.v1beta1.Coin |
MsgRemoveLiquidity
MsgRemoveLiquidity defines a msg for removing liquidity from a reserve pool
Field | Type | Label | Description |
---|---|---|---|
withdraw_liquidity | cosmos.base.v1beta1.Coin | ||
min_token | string | ||
min_standard_amt | string | ||
deadline | int64 | ||
sender | string |
MsgRemoveLiquidityResponse
MsgRemoveLiquidityResponse defines the Msg/RemoveLiquidity response type
Field | Type | Label | Description |
---|---|---|---|
withdraw_coins | cosmos.base.v1beta1.Coin | repeated |
MsgSwapCoinResponse
MsgSwapCoinResponse defines the Msg/SwapCoin response type
MsgSwapOrder
MsgSwapOrder defines a msg for swap order
Field | Type | Label | Description |
---|---|---|---|
input | Input | ||
output | Output | ||
deadline | int64 | ||
is_buy_order | bool |
Msg
Msg defines the coinswap Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
AddLiquidity | MsgAddLiquidity | MsgAddLiquidityResponse | AddLiquidity defines a method for depositing some tokens to the liquidity pool | ||
RemoveLiquidity | MsgRemoveLiquidity | MsgRemoveLiquidityResponse | RemoveLiquidity defines a method for withdraw some tokens from the liquidity pool | ||
SwapCoin | MsgSwapOrder | MsgSwapCoinResponse | SwapCoin defines a method for swapping a token with the other token from the liquidity pool |
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 | string | ||
pub_key | google.protobuf.Any | ||
account_number | uint64 | ||
sequence | uint64 |
ModuleAccount
ModuleAccount defines an account for modules that holds coins on a pool.
Field | Type | Label | Description |
---|---|---|---|
base_account | BaseAccount | ||
name | string | ||
permissions | string | repeated |
Params
Params defines the parameters for the auth module.
Field | Type | Label | Description |
---|---|---|---|
max_memo_characters | uint64 | ||
tx_sig_limit | uint64 | ||
tx_size_cost_per_byte | uint64 | ||
sig_verify_cost_ed25519 | uint64 | ||
sig_verify_cost_secp256k1 | uint64 |
cosmos/auth/v1beta1/genesis.proto
GenesisState
GenesisState defines the auth module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
params | Params | params defines all the paramaters of the module. | |
accounts | google.protobuf.Any | repeated | accounts are the accounts present at genesis. |
cosmos/auth/v1beta1/query.proto
QueryAccountRequest
QueryAccountRequest is the request type for the Query/Account RPC method.
Field | Type | Label | Description |
---|---|---|---|
address | string | address defines the address to query for. |
QueryAccountResponse
QueryAccountResponse is the response type for the Query/Account RPC method.
Field | Type | Label | Description |
---|---|---|---|
account | google.protobuf.Any | 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 | params defines the parameters of the module. |
Query
Query defines the gRPC querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Account | QueryAccountRequest | QueryAccountResponse | Account returns account details based on address. | GET | /cosmos/auth/v1beta1/accounts/{address} |
Params | QueryParamsRequest | QueryParamsResponse | Params queries all parameters. | GET | /cosmos/auth/v1beta1/params |
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 | string | denom represents the string name of the given denom unit (e.g uatom). | |
exponent | uint32 | 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 | string | repeated | aliases is a list of string aliases for the given denom |
Input
Input models transaction input.
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
coins | cosmos.base.v1beta1.Coin | repeated |
Metadata
Metadata represents a struct that describes a basic token.
Field | Type | Label | Description |
---|---|---|---|
description | string | ||
denom_units | DenomUnit | repeated | denom_units represents the list of DenomUnit's for a given coin |
base | string | base represents the base denom (should be the DenomUnit with exponent = 0). | |
display | string | display indicates the suggested denom that should be displayed in clients. |
Output
Output models transaction outputs.
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
coins | cosmos.base.v1beta1.Coin | repeated |
Params
Params defines the parameters for the bank module.
Field | Type | Label | Description |
---|---|---|---|
send_enabled | SendEnabled | repeated | |
default_send_enabled | bool |
SendEnabled
SendEnabled maps coin denom to a send_enabled status (whether a denom is sendable).
Field | Type | Label | Description |
---|---|---|---|
denom | string | ||
enabled | bool |
Supply
Supply represents a struct that passively keeps track of the total supply amounts in the network.
Field | Type | Label | Description |
---|---|---|---|
total | cosmos.base.v1beta1.Coin | repeated |
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 | string | address is the address of the balance holder. | |
coins | cosmos.base.v1beta1.Coin | repeated | coins defines the different coins this balance holds. |
GenesisState
GenesisState defines the bank module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
params | Params | params defines all the paramaters of the module. | |
balances | Balance | repeated | balances is an array containing the balances of all the accounts. |
supply | cosmos.base.v1beta1.Coin | repeated | supply represents the total supply. |
denom_metadata | Metadata | repeated | denom_metadata defines the metadata of the differents coins. |
cosmos/bank/v1beta1/query.proto
QueryAllBalancesRequest
QueryBalanceRequest is the request type for the Query/AllBalances RPC method.
Field | Type | Label | Description |
---|---|---|---|
address | string | address is the address to query balances for. | |
pagination | cosmos.base.query.v1beta1.PageRequest | 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 | cosmos.base.v1beta1.Coin | repeated | balances is the balances of all the coins. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryBalanceRequest
QueryBalanceRequest is the request type for the Query/Balance RPC method.
Field | Type | Label | Description |
---|---|---|---|
address | string | address is the address to query balances for. | |
denom | string | 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 | cosmos.base.v1beta1.Coin | balance is the balance of the coin. |
QueryDenomMetadataRequest
QueryDenomMetadataRequest is the request type for the Query/DenomMetadata RPC method.
Field | Type | Label | Description |
---|---|---|---|
denom | string | denom is the coin denom to query the metadata for. |
QueryDenomMetadataResponse
QueryDenomMetadataResponse is the response type for the Query/DenomMetadata RPC method.
Field | Type | Label | Description |
---|---|---|---|
metadata | Metadata | metadata describes and provides all the client information for the requested token. |
QueryDenomsMetadataRequest
QueryDenomsMetadataRequest is the request type for the Query/DenomsMetadata RPC method.
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryDenomsMetadataResponse
QueryDenomsMetadataResponse is the response type for the Query/DenomsMetadata RPC method.
Field | Type | Label | Description |
---|---|---|---|
metadatas | Metadata | repeated | metadata provides the client information for all the registered tokens. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
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 | Params |
QuerySupplyOfRequest
QuerySupplyOfRequest is the request type for the Query/SupplyOf RPC method.
Field | Type | Label | Description |
---|---|---|---|
denom | string | 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 | cosmos.base.v1beta1.Coin | 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 | cosmos.base.v1beta1.Coin | repeated | supply is the supply of the coins |
Query
Query defines the gRPC querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Balance | QueryBalanceRequest | QueryBalanceResponse | Balance queries the balance of a single coin for a single account. | GET | /cosmos/bank/v1beta1/balances/{address}/{denom} |
AllBalances | QueryAllBalancesRequest | QueryAllBalancesResponse | AllBalances queries the balance of all coins for a single account. | GET | /cosmos/bank/v1beta1/balances/{address} |
TotalSupply | QueryTotalSupplyRequest | QueryTotalSupplyResponse | TotalSupply queries the total supply of all coins. | GET | /cosmos/bank/v1beta1/supply |
SupplyOf | QuerySupplyOfRequest | QuerySupplyOfResponse | SupplyOf queries the supply of a single coin. | GET | /cosmos/bank/v1beta1/supply/{denom} |
Params | QueryParamsRequest | QueryParamsResponse | Params queries the parameters of x/bank module. | GET | /cosmos/bank/v1beta1/params |
DenomMetadata | QueryDenomMetadataRequest | QueryDenomMetadataResponse | DenomsMetadata queries the client metadata of a given coin denomination. | GET | /cosmos/bank/v1beta1/denoms_metadata/{denom} |
DenomsMetadata | QueryDenomsMetadataRequest | QueryDenomsMetadataResponse | DenomsMetadata queries the client metadata for all registered coin denominations. | GET | /cosmos/bank/v1beta1/denoms_metadata |
cosmos/bank/v1beta1/tx.proto
MsgMultiSend
MsgMultiSend represents an arbitrary multi-in, multi-out send message.
Field | Type | Label | Description |
---|---|---|---|
inputs | Input | repeated | |
outputs | Output | repeated |
MsgMultiSendResponse
MsgMultiSendResponse defines the Msg/MultiSend response type.
MsgSend
MsgSend represents a message to send coins from one account to another.
Field | Type | Label | Description |
---|---|---|---|
from_address | string | ||
to_address | string | ||
amount | cosmos.base.v1beta1.Coin | repeated |
MsgSendResponse
MsgSendResponse defines the Msg/Send response type.
Msg
Msg defines the bank Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Send | MsgSend | MsgSendResponse | Send defines a method for sending coins from one account to another account. | ||
MultiSend | MsgMultiSend | MsgMultiSendResponse | MultiSend defines a method for sending coins from some accounts to other accounts. |
cosmos/base/abci/v1beta1/abci.proto
ABCIMessageLog
ABCIMessageLog defines a structure containing an indexed tx ABCI message log.
Field | Type | Label | Description |
---|---|---|---|
msg_index | uint32 | ||
log | string | ||
events | StringEvent | repeated | Events contains a slice of Event objects that were emitted during some execution. |
Attribute
Attribute defines an attribute wrapper where the key and value are strings instead of raw bytes.
Field | Type | Label | Description |
---|---|---|---|
key | string | ||
value | string |
GasInfo
GasInfo defines tx execution gas context.
Field | Type | Label | Description |
---|---|---|---|
gas_wanted | uint64 | GasWanted is the maximum units of work we allow this tx to perform. | |
gas_used | uint64 | GasUsed is the amount of gas actually consumed. |
MsgData
MsgData defines the data returned in a Result object during message execution.
Field | Type | Label | Description |
---|---|---|---|
msg_type | string | ||
data | bytes |
Result
Result is the union of ResponseFormat and ResponseCheckTx.
Field | Type | Label | Description |
---|---|---|---|
data | bytes | 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 | string | Log contains the log information from message or handler execution. | |
events | tendermint.abci.Event | repeated | Events contains a slice of Event objects that were emitted during message or handler execution. |
SearchTxsResult
SearchTxsResult defines a structure for querying txs pageable
Field | Type | Label | Description |
---|---|---|---|
total_count | uint64 | Count of all txs | |
count | uint64 | Count of txs in current page | |
page_number | uint64 | Index of current page, start from 1 | |
page_total | uint64 | Count of total pages | |
limit | uint64 | Max count txs per page | |
txs | TxResponse | repeated | List of txs in current page |
SimulationResponse
SimulationResponse defines the response generated when a transaction is successfully simulated.
Field | Type | Label | Description |
---|---|---|---|
gas_info | GasInfo | ||
result | Result |
StringEvent
StringEvent defines en Event object wrapper where all the attributes contain key/value pairs that are strings instead of raw bytes.
Field | Type | Label | Description |
---|---|---|---|
type | string | ||
attributes | Attribute | repeated |
TxMsgData
TxMsgData defines a list of MsgData. A transaction will have a MsgData object for each message.
Field | Type | Label | Description |
---|---|---|---|
data | MsgData | repeated |
TxResponse
TxResponse defines a structure containing relevant tx data and metadata. The tags are stringified and the log is JSON decoded.
Field | Type | Label | Description |
---|---|---|---|
height | int64 | The block height | |
txhash | string | The transaction hash. | |
codespace | string | Namespace for the Code | |
code | uint32 | Response code. | |
data | string | Result bytes, if any. | |
raw_log | string | The output of the application's logger (raw string). May be non-deterministic. | |
logs | ABCIMessageLog | repeated | The output of the application's logger (typed). May be non-deterministic. |
info | string | Additional information. May be non-deterministic. | |
gas_wanted | int64 | Amount of gas requested for transaction. | |
gas_used | int64 | Amount of gas consumed by transaction. | |
tx | google.protobuf.Any | The request transaction bytes. | |
timestamp | string | Time of the previous block. For heights > 1, it's the weighted median of the timestamps of the valid votes in the block.LastCommit. For height == 1, it's genesis time. |
cosmos/base/kv/v1beta1/kv.proto
Pair
Pair defines a key/value bytes tuple.
Field | Type | Label | Description |
---|---|---|---|
key | bytes | ||
value | bytes |
Pairs
Pairs defines a repeated slice of Pair objects.
Field | Type | Label | Description |
---|---|---|---|
pairs | Pair | repeated |
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 | string | 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 | string | 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 | string | repeated |
ReflectionService
ReflectionService defines a service for interface reflection.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
ListAllInterfaces | ListAllInterfacesRequest | ListAllInterfacesResponse | ListAllInterfaces lists all the interfaces registered in the interface registry. | GET | /cosmos/base/reflection/v1beta1/interfaces |
ListImplementations | ListImplementationsRequest | ListImplementationsResponse | ListImplementations list all the concrete types that implement a given interface. | GET | /cosmos/base/reflection/v1beta1/interfaces/{interface_name}/implementations |
cosmos/base/snapshots/v1beta1/snapshot.proto
Metadata
Metadata contains SDK-specific snapshot metadata.
Field | Type | Label | Description |
---|---|---|---|
chunk_hashes | bytes | repeated | SHA-256 chunk hashes |
Snapshot
Snapshot contains Tendermint state sync snapshot info.
Field | Type | Label | Description |
---|---|---|---|
height | uint64 | ||
format | uint32 | ||
chunks | uint32 | ||
hash | bytes | ||
metadata | Metadata |
cosmos/base/store/v1beta1/commit_info.proto
CommitID
CommitID defines the committment information when a specific store is committed.
Field | Type | Label | Description |
---|---|---|---|
version | int64 | ||
hash | bytes |
CommitInfo
CommitInfo defines commit information used by the multi-store when committing a version/height.
Field | Type | Label | Description |
---|---|---|---|
version | int64 | ||
store_infos | StoreInfo | repeated |
StoreInfo
StoreInfo defines store-specific commit information. It contains a reference between a store name and the commit ID.
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
commit_id | CommitID |
cosmos/base/store/v1beta1/snapshot.proto
SnapshotIAVLItem
SnapshotIAVLItem is an exported IAVL node.
Field | Type | Label | Description |
---|---|---|---|
key | bytes | ||
value | bytes | ||
version | int64 | ||
height | int32 |
SnapshotItem
SnapshotItem is an item contained in a rootmulti.Store snapshot.
Field | Type | Label | Description |
---|---|---|---|
store | SnapshotStoreItem | ||
iavl | SnapshotIAVLItem |
SnapshotStoreItem
SnapshotStoreItem contains metadata about a snapshotted store.
Field | Type | Label | Description |
---|---|---|---|
name | string |
cosmos/base/tendermint/v1beta1/query.proto
GetBlockByHeightRequest
GetBlockByHeightRequest is the request type for the Query/GetBlockByHeight RPC method.
Field | Type | Label | Description |
---|---|---|---|
height | int64 |
GetBlockByHeightResponse
GetBlockByHeightResponse is the response type for the Query/GetBlockByHeight RPC method.
Field | Type | Label | Description |
---|---|---|---|
block_id | tendermint.types.BlockID | ||
block | tendermint.types.Block |
GetLatestBlockRequest
GetLatestBlockRequest is the request type for the Query/GetLatestBlock RPC method.
GetLatestBlockResponse
GetLatestBlockResponse is the response type for the Query/GetLatestBlock RPC method.
Field | Type | Label | Description |
---|---|---|---|
block_id | tendermint.types.BlockID | ||
block | tendermint.types.Block |
GetLatestValidatorSetRequest
GetLatestValidatorSetRequest is the request type for the Query/GetValidatorSetByHeight RPC method.
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an pagination for the request. |
GetLatestValidatorSetResponse
GetLatestValidatorSetResponse is the response type for the Query/GetValidatorSetByHeight RPC method.
Field | Type | Label | Description |
---|---|---|---|
block_height | int64 | ||
validators | Validator | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines an pagination for the response. |
GetNodeInfoRequest
GetNodeInfoRequest is the request type for the Query/GetNodeInfo RPC method.
GetNodeInfoResponse
GetNodeInfoResponse is the request type for the Query/GetNodeInfo RPC method.
Field | Type | Label | Description |
---|---|---|---|
default_node_info | tendermint.p2p.DefaultNodeInfo | ||
application_version | VersionInfo |
GetSyncingRequest
GetSyncingRequest is the request type for the Query/GetSyncing RPC method.
GetSyncingResponse
GetSyncingResponse is the response type for the Query/GetSyncing RPC method.
Field | Type | Label | Description |
---|---|---|---|
syncing | bool |
GetValidatorSetByHeightRequest
GetValidatorSetByHeightRequest is the request type for the Query/GetValidatorSetByHeight RPC method.
Field | Type | Label | Description |
---|---|---|---|
height | int64 | ||
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an pagination for the request. |
GetValidatorSetByHeightResponse
GetValidatorSetByHeightResponse is the response type for the Query/GetValidatorSetByHeight RPC method.
Field | Type | Label | Description |
---|---|---|---|
block_height | int64 | ||
validators | Validator | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines an pagination for the response. |
Module
Module is the type for VersionInfo
Field | Type | Label | Description |
---|---|---|---|
path | string | module path | |
version | string | module version | |
sum | string | checksum |
Validator
Validator is the type for the validator-set.
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
pub_key | google.protobuf.Any | ||
voting_power | int64 | ||
proposer_priority | int64 |
VersionInfo
VersionInfo is the type for the GetNodeInfoResponse message.
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
app_name | string | ||
version | string | ||
git_commit | string | ||
build_tags | string | ||
go_version | string | ||
build_deps | Module | repeated | |
cosmos_sdk_version | string |
Service
Service defines the gRPC querier service for tendermint queries.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
GetNodeInfo | GetNodeInfoRequest | GetNodeInfoResponse | GetNodeInfo queries the current node info. | GET | /cosmos/base/tendermint/v1beta1/node_info |
GetSyncing | GetSyncingRequest | GetSyncingResponse | GetSyncing queries node syncing. | GET | /cosmos/base/tendermint/v1beta1/syncing |
GetLatestBlock | GetLatestBlockRequest | GetLatestBlockResponse | GetLatestBlock returns the latest block. | GET | /cosmos/base/tendermint/v1beta1/blocks/latest |
GetBlockByHeight | GetBlockByHeightRequest | GetBlockByHeightResponse | GetBlockByHeight queries block for given height. | GET | /cosmos/base/tendermint/v1beta1/blocks/{height} |
GetLatestValidatorSet | GetLatestValidatorSetRequest | GetLatestValidatorSetResponse | GetLatestValidatorSet queries latest validator-set. | GET | /cosmos/base/tendermint/v1beta1/validatorsets/latest |
GetValidatorSetByHeight | GetValidatorSetByHeightRequest | GetValidatorSetByHeightResponse | GetValidatorSetByHeight queries validator-set at a given height. | GET | /cosmos/base/tendermint/v1beta1/validatorsets/{height} |
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 | uint64 |
CapabilityOwners
CapabilityOwners defines a set of owners of a single Capability. The set of owners must be unique.
Field | Type | Label | Description |
---|---|---|---|
owners | Owner | repeated |
Owner
Owner defines a single capability owner. An owner is defined by the name of capability and the module name.
Field | Type | Label | Description |
---|---|---|---|
module | string | ||
name | string |
cosmos/capability/v1beta1/genesis.proto
GenesisOwners
GenesisOwners defines the capability owners with their corresponding index.
Field | Type | Label | Description |
---|---|---|---|
index | uint64 | index is the index of the capability owner. | |
index_owners | CapabilityOwners | index_owners are the owners at the given index. |
GenesisState
GenesisState defines the capability module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
index | uint64 | index is the capability global index. | |
owners | GenesisOwners | repeated | owners represents a map from index to owners of the capability index index key is string to allow amino marshalling. |
cosmos/crisis/v1beta1/genesis.proto
GenesisState
GenesisState defines the crisis module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
constant_fee | cosmos.base.v1beta1.Coin | constant_fee is the fee used to verify the invariant in the crisis module. |
cosmos/crisis/v1beta1/tx.proto
MsgVerifyInvariant
MsgVerifyInvariant represents a message to verify a particular invariance.
Field | Type | Label | Description |
---|---|---|---|
sender | string | ||
invariant_module_name | string | ||
invariant_route | string |
MsgVerifyInvariantResponse
MsgVerifyInvariantResponse defines the Msg/VerifyInvariant response type.
Msg
Msg defines the bank Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
VerifyInvariant | MsgVerifyInvariant | MsgVerifyInvariantResponse | VerifyInvariant defines a method to verify a particular invariance. |
cosmos/crypto/ed25519/keys.proto
PrivKey
PrivKey defines a ed25519 private key.
Field | Type | Label | Description |
---|---|---|---|
key | bytes |
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 | bytes |
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 | uint32 | ||
public_keys | google.protobuf.Any | repeated |
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.
Field | Type | Label | Description |
---|---|---|---|
extra_bits_stored | uint32 | ||
elems | bytes |
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 | bytes | repeated |
cosmos/crypto/secp256k1/keys.proto
PrivKey
PrivKey defines a secp256k1 private key.
Field | Type | Label | Description |
---|---|---|---|
key | bytes |
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 | bytes |
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 | string | ||
description | string | ||
recipient | string | ||
amount | cosmos.base.v1beta1.Coin | repeated |
CommunityPoolSpendProposalWithDeposit
CommunityPoolSpendProposalWithDeposit defines a CommunityPoolSpendProposal with a deposit
Field | Type | Label | Description |
---|---|---|---|
title | string | ||
description | string | ||
recipient | string | ||
amount | string | ||
deposit | string |
DelegationDelegatorReward
DelegationDelegatorReward represents the properties of a delegator's delegation reward.
Field | Type | Label | Description |
---|---|---|---|
validator_address | string | ||
reward | cosmos.base.v1beta1.DecCoin | repeated |
DelegatorStartingInfo
DelegatorStartingInfo represents the starting info for a delegator reward period. It tracks the previous validator period, the delegation's amount of staking token, and the creation height (to check later on if any slashes have occurred). NOTE: Even though validators are slashed to whole staking tokens, the delegators within the validator may be left with less than a full token, thus sdk.Dec is used.
Field | Type | Label | Description |
---|---|---|---|
previous_period | uint64 | ||
stake | string | ||
height | uint64 |
FeePool
FeePool is the global fee pool for distribution.
Field | Type | Label | Description |
---|---|---|---|
community_pool | cosmos.base.v1beta1.DecCoin | repeated |
Params
Params defines the set of params for the distribution module.
Field | Type | Label | Description |
---|---|---|---|
community_tax | string | ||
base_proposer_reward | string | ||
bonus_proposer_reward | string | ||
withdraw_addr_enabled | bool |
ValidatorAccumulatedCommission
ValidatorAccumulatedCommission represents accumulated commission for a validator kept as a running counter, can be withdrawn at any time.
Field | Type | Label | Description |
---|---|---|---|
commission | cosmos.base.v1beta1.DecCoin | 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 | cosmos.base.v1beta1.DecCoin | repeated | |
period | uint64 |
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 | cosmos.base.v1beta1.DecCoin | repeated | |
reference_count | uint32 |
ValidatorOutstandingRewards
ValidatorOutstandingRewards represents outstanding (un-withdrawn) rewards for a validator inexpensive to track, allows simple sanity checks.
Field | Type | Label | Description |
---|---|---|---|
rewards | cosmos.base.v1beta1.DecCoin | repeated |
ValidatorSlashEvent
ValidatorSlashEvent represents a validator slash event. Height is implicit within the store key. This is needed to calculate appropriate amount of staking tokens for delegations which are withdrawn after a slash has occurred.
Field | Type | Label | Description |
---|---|---|---|
validator_period | uint64 | ||
fraction | string |
ValidatorSlashEvents
ValidatorSlashEvents is a collection of ValidatorSlashEvent messages.
Field | Type | Label | Description |
---|---|---|---|
validator_slash_events | ValidatorSlashEvent | repeated |
cosmos/distribution/v1beta1/genesis.proto
DelegatorStartingInfoRecord
DelegatorStartingInfoRecord used for import / export via genesis json.
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | delegator_address is the address of the delegator. | |
validator_address | string | validator_address is the address of the validator. | |
starting_info | DelegatorStartingInfo | starting_info defines the starting info of a delegator. |
DelegatorWithdrawInfo
DelegatorWithdrawInfo is the address for where distributions rewards are withdrawn to by default this struct is only used at genesis to feed in default withdraw addresses.
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | delegator_address is the address of the delegator. | |
withdraw_address | string | 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 | params defines all the paramaters of the module. | |
fee_pool | FeePool | fee_pool defines the fee pool at genesis. | |
delegator_withdraw_infos | DelegatorWithdrawInfo | repeated | fee_pool defines the delegator withdraw infos at genesis. |
previous_proposer | string | fee_pool defines the previous proposer at genesis. | |
outstanding_rewards | ValidatorOutstandingRewardsRecord | repeated | fee_pool defines the outstanding rewards of all validators at genesis. |
validator_accumulated_commissions | ValidatorAccumulatedCommissionRecord | repeated | fee_pool defines the accumulated commisions of all validators at genesis. |
validator_historical_rewards | ValidatorHistoricalRewardsRecord | repeated | fee_pool defines the historical rewards of all validators at genesis. |
validator_current_rewards | ValidatorCurrentRewardsRecord | repeated | fee_pool defines the current rewards of all validators at genesis. |
delegator_starting_infos | DelegatorStartingInfoRecord | repeated | fee_pool defines the delegator starting infos at genesis. |
validator_slash_events | ValidatorSlashEventRecord | repeated | fee_pool defines the validator slash events at genesis. |
ValidatorAccumulatedCommissionRecord
ValidatorAccumulatedCommissionRecord is used for import / export via genesis json.
Field | Type | Label | Description |
---|---|---|---|
validator_address | string | validator_address is the address of the validator. | |
accumulated | ValidatorAccumulatedCommission | accumulated is the accumulated commission of a validator. |
ValidatorCurrentRewardsRecord
ValidatorCurrentRewardsRecord is used for import / export via genesis json.
Field | Type | Label | Description |
---|---|---|---|
validator_address | string | validator_address is the address of the validator. | |
rewards | ValidatorCurrentRewards | rewards defines the current rewards of a validator. |
ValidatorHistoricalRewardsRecord
ValidatorHistoricalRewardsRecord is used for import / export via genesis json.
Field | Type | Label | Description |
---|---|---|---|
validator_address | string | validator_address is the address of the validator. | |
period | uint64 | period defines the period the historical rewards apply to. | |
rewards | ValidatorHistoricalRewards | rewards defines the historical rewards of a validator. |
ValidatorOutstandingRewardsRecord
ValidatorOutstandingRewardsRecord is used for import/export via genesis json.
Field | Type | Label | Description |
---|---|---|---|
validator_address | string | validator_address is the address of the validator. | |
outstanding_rewards | cosmos.base.v1beta1.DecCoin | 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 | string | validator_address is the address of the validator. | |
height | uint64 | height defines the block height at which the slash event occured. | |
period | uint64 | period is the period of the slash event. | |
validator_slash_event | ValidatorSlashEvent | validator_slash_event describes the slash event. |
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 | cosmos.base.v1beta1.DecCoin | 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 | string | delegator_address defines the delegator address to query for. | |
validator_address | string | 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 | cosmos.base.v1beta1.DecCoin | 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 | string | 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 | DelegationDelegatorReward | repeated | rewards defines all the rewards accrued by a delegator. |
total | cosmos.base.v1beta1.DecCoin | 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 | string | 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 | string | 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 | string | 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 | string | 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 | 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 | string | 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 | ValidatorAccumulatedCommission | 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 | string | 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 | ValidatorOutstandingRewards |
QueryValidatorSlashesRequest
QueryValidatorSlashesRequest is the request type for the Query/ValidatorSlashes RPC method
Field | Type | Label | Description |
---|---|---|---|
validator_address | string | validator_address defines the validator address to query for. | |
starting_height | uint64 | starting_height defines the optional starting height to query the slashes. | |
ending_height | uint64 | starting_height defines the optional ending height to query the slashes. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryValidatorSlashesResponse
QueryValidatorSlashesResponse is the response type for the Query/ValidatorSlashes RPC method.
Field | Type | Label | Description |
---|---|---|---|
slashes | ValidatorSlashEvent | repeated | slashes defines the slashes the validator received. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
Query
Query defines the gRPC querier service for distribution module.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Params | QueryParamsRequest | QueryParamsResponse | Params queries params of the distribution module. | GET | /cosmos/distribution/v1beta1/params |
ValidatorOutstandingRewards | QueryValidatorOutstandingRewardsRequest | QueryValidatorOutstandingRewardsResponse | ValidatorOutstandingRewards queries rewards of a validator address. | GET | /cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards |
ValidatorCommission | QueryValidatorCommissionRequest | QueryValidatorCommissionResponse | ValidatorCommission queries accumulated commission for a validator. | GET | /cosmos/distribution/v1beta1/validators/{validator_address}/commission |
ValidatorSlashes | QueryValidatorSlashesRequest | QueryValidatorSlashesResponse | ValidatorSlashes queries slash events of a validator. | GET | /cosmos/distribution/v1beta1/validators/{validator_address}/slashes |
DelegationRewards | QueryDelegationRewardsRequest | QueryDelegationRewardsResponse | DelegationRewards queries the total rewards accrued by a delegation. | GET | /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address} |
DelegationTotalRewards | QueryDelegationTotalRewardsRequest | QueryDelegationTotalRewardsResponse | DelegationTotalRewards queries the total rewards accrued by a each validator. | GET | /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards |
DelegatorValidators | QueryDelegatorValidatorsRequest | QueryDelegatorValidatorsResponse | DelegatorValidators queries the validators of a delegator. | GET | /cosmos/distribution/v1beta1/delegators/{delegator_address}/validators |
DelegatorWithdrawAddress | QueryDelegatorWithdrawAddressRequest | QueryDelegatorWithdrawAddressResponse | DelegatorWithdrawAddress queries withdraw address of a delegator. | GET | /cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address |
CommunityPool | QueryCommunityPoolRequest | QueryCommunityPoolResponse | CommunityPool queries the community pool coins. | GET | /cosmos/distribution/v1beta1/community_pool |
cosmos/distribution/v1beta1/tx.proto
MsgFundCommunityPool
MsgFundCommunityPool allows an account to directly fund the community pool.
Field | Type | Label | Description |
---|---|---|---|
amount | cosmos.base.v1beta1.Coin | repeated | |
depositor | string |
MsgFundCommunityPoolResponse
MsgFundCommunityPoolResponse defines the Msg/FundCommunityPool response type.
MsgSetWithdrawAddress
MsgSetWithdrawAddress sets the withdraw address for a delegator (or validator self-delegation).
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | ||
withdraw_address | string |
MsgSetWithdrawAddressResponse
MsgSetWithdrawAddressResponse defines the Msg/SetWithdrawAddress response type.
MsgWithdrawDelegatorReward
MsgWithdrawDelegatorReward represents delegation withdrawal to a delegator from a single validator.
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | ||
validator_address | string |
MsgWithdrawDelegatorRewardResponse
MsgWithdrawDelegatorRewardResponse defines the Msg/WithdrawDelegatorReward response type.
MsgWithdrawValidatorCommission
MsgWithdrawValidatorCommission withdraws the full commission to the validator address.
Field | Type | Label | Description |
---|---|---|---|
validator_address | string |
MsgWithdrawValidatorCommissionResponse
MsgWithdrawValidatorCommissionResponse defines the Msg/WithdrawValidatorCommission response type.
Msg
Msg defines the distribution Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
SetWithdrawAddress | MsgSetWithdrawAddress | MsgSetWithdrawAddressResponse | SetWithdrawAddress defines a method to change the withdraw address for a delegator (or validator self-delegation). | ||
WithdrawDelegatorReward | MsgWithdrawDelegatorReward | MsgWithdrawDelegatorRewardResponse | WithdrawDelegatorReward defines a method to withdraw rewards of delegator from a single validator. | ||
WithdrawValidatorCommission | MsgWithdrawValidatorCommission | MsgWithdrawValidatorCommissionResponse | WithdrawValidatorCommission defines a method to withdraw the full commission to the validator address. | ||
FundCommunityPool | MsgFundCommunityPool | MsgFundCommunityPoolResponse | FundCommunityPool defines a method to allow an account to directly fund the community pool. |
cosmos/evidence/v1beta1/evidence.proto
Equivocation
Equivocation implements the Evidence interface and defines evidence of double signing misbehavior.
Field | Type | Label | Description |
---|---|---|---|
height | int64 | ||
time | google.protobuf.Timestamp | ||
power | int64 | ||
consensus_address | string |
cosmos/evidence/v1beta1/genesis.proto
GenesisState
GenesisState defines the evidence module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
evidence | google.protobuf.Any | repeated | evidence defines all the evidence at genesis. |
cosmos/evidence/v1beta1/query.proto
QueryAllEvidenceRequest
QueryEvidenceRequest is the request type for the Query/AllEvidence RPC method.
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | 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 | google.protobuf.Any | repeated | evidence returns all evidences. |
pagination | cosmos.base.query.v1beta1.PageResponse | 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 | bytes | 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 | google.protobuf.Any | evidence returns the requested evidence. |
Query
Query defines the gRPC querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Evidence | QueryEvidenceRequest | QueryEvidenceResponse | Evidence queries evidence based on evidence hash. | GET | /cosmos/evidence/v1beta1/evidence/{evidence_hash} |
AllEvidence | QueryAllEvidenceRequest | QueryAllEvidenceResponse | AllEvidence queries all evidence. | GET | /cosmos/evidence/v1beta1/evidence |
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 | string | ||
evidence | google.protobuf.Any |
MsgSubmitEvidenceResponse
MsgSubmitEvidenceResponse defines the Msg/SubmitEvidence response type.
Field | Type | Label | Description |
---|---|---|---|
hash | bytes | hash defines the hash of the evidence. |
Msg
Msg defines the evidence Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
SubmitEvidence | MsgSubmitEvidence | MsgSubmitEvidenceResponse | SubmitEvidence submits an arbitrary Evidence of misbehavior such as equivocation or counterfactual signing. |
cosmos/genutil/v1beta1/genesis.proto
GenesisState
GenesisState defines the raw genesis transaction in JSON.
Field | Type | Label | Description |
---|---|---|---|
gen_txs | bytes | repeated | gen_txs defines the genesis transactions. |
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 | uint64 | ||
depositor | string | ||
amount | cosmos.base.v1beta1.Coin | repeated |
DepositParams
DepositParams defines the params for deposits on governance proposals.
Field | Type | Label | Description |
---|---|---|---|
min_deposit | cosmos.base.v1beta1.Coin | repeated | Minimum deposit for a proposal to enter voting period. |
max_deposit_period | google.protobuf.Duration | 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 | uint64 | ||
content | google.protobuf.Any | ||
status | ProposalStatus | ||
final_tally_result | TallyResult | ||
submit_time | google.protobuf.Timestamp | ||
deposit_end_time | google.protobuf.Timestamp | ||
total_deposit | cosmos.base.v1beta1.Coin | repeated | |
voting_start_time | google.protobuf.Timestamp | ||
voting_end_time | google.protobuf.Timestamp |
TallyParams
TallyParams defines the params for tallying votes on governance proposals.
Field | Type | Label | Description |
---|---|---|---|
quorum | bytes | Minimum percentage of total stake needed to vote for a result to be considered valid. | |
threshold | bytes | Minimum proportion of Yes votes for proposal to pass. Default value: 0.5. | |
veto_threshold | bytes | Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Default value: 1/3. |
TallyResult
TallyResult defines a standard tally for a governance proposal.
Field | Type | Label | Description |
---|---|---|---|
yes | string | ||
abstain | string | ||
no | string | ||
no_with_veto | string |
TextProposal
TextProposal defines a standard text proposal whose changes need to be manually updated in case of approval.
Field | Type | Label | Description |
---|---|---|---|
title | string | ||
description | string |
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 | uint64 | ||
voter | string | ||
option | VoteOption |
VotingParams
VotingParams defines the params for voting on governance proposals.
Field | Type | Label | Description |
---|---|---|---|
voting_period | google.protobuf.Duration | 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/genesis.proto
GenesisState
GenesisState defines the gov module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
starting_proposal_id | uint64 | starting_proposal_id is the ID of the starting proposal. | |
deposits | Deposit | repeated | deposits defines all the deposits present at genesis. |
votes | Vote | repeated | votes defines all the votes present at genesis. |
proposals | Proposal | repeated | proposals defines all the proposals present at genesis. |
deposit_params | DepositParams | params defines all the paramaters of related to deposit. | |
voting_params | VotingParams | params defines all the paramaters of related to voting. | |
tally_params | TallyParams | params defines all the paramaters of related to tally. |
cosmos/gov/v1beta1/query.proto
QueryDepositRequest
QueryDepositRequest is the request type for the Query/Deposit RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | proposal_id defines the unique id of the proposal. | |
depositor | string | depositor defines the deposit addresses from the proposals. |
QueryDepositResponse
QueryDepositResponse is the response type for the Query/Deposit RPC method.
Field | Type | Label | Description |
---|---|---|---|
deposit | Deposit | deposit defines the requested deposit. |
QueryDepositsRequest
QueryDepositsRequest is the request type for the Query/Deposits RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | proposal_id defines the unique id of the proposal. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryDepositsResponse
QueryDepositsResponse is the response type for the Query/Deposits RPC method.
Field | Type | Label | Description |
---|---|---|---|
deposits | Deposit | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | 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 | string | params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit". |
QueryParamsResponse
QueryParamsResponse is the response type for the Query/Params RPC method.
Field | Type | Label | Description |
---|---|---|---|
voting_params | VotingParams | voting_params defines the parameters related to voting. | |
deposit_params | DepositParams | deposit_params defines the parameters related to deposit. | |
tally_params | TallyParams | tally_params defines the parameters related to tally. |
QueryProposalRequest
QueryProposalRequest is the request type for the Query/Proposal RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | proposal_id defines the unique id of the proposal. |
QueryProposalResponse
QueryProposalResponse is the response type for the Query/Proposal RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal | Proposal |
QueryProposalsRequest
QueryProposalsRequest is the request type for the Query/Proposals RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal_status | ProposalStatus | proposal_status defines the status of the proposals. | |
voter | string | voter defines the voter address for the proposals. | |
depositor | string | depositor defines the deposit addresses from the proposals. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryProposalsResponse
QueryProposalsResponse is the response type for the Query/Proposals RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposals | Proposal | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | 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 | uint64 | proposal_id defines the unique id of the proposal. |
QueryTallyResultResponse
QueryTallyResultResponse is the response type for the Query/Tally RPC method.
Field | Type | Label | Description |
---|---|---|---|
tally | TallyResult | tally defines the requested tally. |
QueryVoteRequest
QueryVoteRequest is the request type for the Query/Vote RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | proposal_id defines the unique id of the proposal. | |
voter | string | voter defines the oter address for the proposals. |
QueryVoteResponse
QueryVoteResponse is the response type for the Query/Vote RPC method.
Field | Type | Label | Description |
---|---|---|---|
vote | Vote | vote defined the queried vote. |
QueryVotesRequest
QueryVotesRequest is the request type for the Query/Votes RPC method.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | proposal_id defines the unique id of the proposal. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryVotesResponse
QueryVotesResponse is the response type for the Query/Votes RPC method.
Field | Type | Label | Description |
---|---|---|---|
votes | Vote | repeated | votes defined the queried votes. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
Query
Query defines the gRPC querier service for gov module
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Proposal | QueryProposalRequest | QueryProposalResponse | Proposal queries proposal details based on ProposalID. | GET | /cosmos/gov/v1beta1/proposals/{proposal_id} |
Proposals | QueryProposalsRequest | QueryProposalsResponse | Proposals queries all proposals based on given status. | GET | /cosmos/gov/v1beta1/proposals |
Vote | QueryVoteRequest | QueryVoteResponse | Vote queries voted information based on proposalID, voterAddr. | GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter} |
Votes | QueryVotesRequest | QueryVotesResponse | Votes queries votes of a given proposal. | GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/votes |
Params | QueryParamsRequest | QueryParamsResponse | Params queries all parameters of the gov module. | GET | /cosmos/gov/v1beta1/params/{params_type} |
Deposit | QueryDepositRequest | QueryDepositResponse | Deposit queries single deposit information based proposalID, depositAddr. | GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor} |
Deposits | QueryDepositsRequest | QueryDepositsResponse | Deposits queries all deposits of a single proposal. | GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits |
TallyResult | QueryTallyResultRequest | QueryTallyResultResponse | TallyResult queries the tally of a proposal vote. | GET | /cosmos/gov/v1beta1/proposals/{proposal_id}/tally |
cosmos/gov/v1beta1/tx.proto
MsgDeposit
MsgDeposit defines a message to submit a deposit to an existing proposal.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | ||
depositor | string | ||
amount | cosmos.base.v1beta1.Coin | 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 | google.protobuf.Any | ||
initial_deposit | cosmos.base.v1beta1.Coin | repeated | |
proposer | string |
MsgSubmitProposalResponse
MsgSubmitProposalResponse defines the Msg/SubmitProposal response type.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 |
MsgVote
MsgVote defines a message to cast a vote.
Field | Type | Label | Description |
---|---|---|---|
proposal_id | uint64 | ||
voter | string | ||
option | VoteOption |
MsgVoteResponse
MsgVoteResponse defines the Msg/Vote response type.
Msg
Msg defines the bank Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
SubmitProposal | MsgSubmitProposal | MsgSubmitProposalResponse | SubmitProposal defines a method to create new proposal given a content. | ||
Vote | MsgVote | MsgVoteResponse | Vote defines a method to add a vote on a specific proposal. | ||
Deposit | MsgDeposit | MsgDepositResponse | Deposit defines a method to add deposit on a specific proposal. |
cosmos/params/v1beta1/params.proto
ParamChange
ParamChange defines an individual parameter change, for use in ParameterChangeProposal.
Field | Type | Label | Description |
---|---|---|---|
subspace | string | ||
key | string | ||
value | string |
ParameterChangeProposal
ParameterChangeProposal defines a proposal to change one or more parameters.
Field | Type | Label | Description |
---|---|---|---|
title | string | ||
description | string | ||
changes | ParamChange | repeated |
cosmos/params/v1beta1/query.proto
QueryParamsRequest
QueryParamsRequest is request type for the Query/Params RPC method.
Field | Type | Label | Description |
---|---|---|---|
subspace | string | subspace defines the module to query the parameter for. | |
key | string | key defines the key of the parameter in the subspace. |
QueryParamsResponse
QueryParamsResponse is response type for the Query/Params RPC method.
Field | Type | Label | Description |
---|---|---|---|
param | ParamChange | param defines the queried parameter. |
Query
Query defines the gRPC querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Params | QueryParamsRequest | QueryParamsResponse | Params queries a specific parameter of a module, given its subspace and key. | GET | /cosmos/params/v1beta1/params |
cosmos/slashing/v1beta1/slashing.proto
Params
Params represents the parameters used for by the slashing module.
Field | Type | Label | Description |
---|---|---|---|
signed_blocks_window | int64 | ||
min_signed_per_window | bytes | ||
downtime_jail_duration | google.protobuf.Duration | ||
slash_fraction_double_sign | bytes | ||
slash_fraction_downtime | bytes |
ValidatorSigningInfo
ValidatorSigningInfo defines a validator's signing info for monitoring their liveness activity.
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
start_height | int64 | height at which validator was first a candidate OR was unjailed | |
index_offset | int64 | index offset into signed block bit array | |
jailed_until | google.protobuf.Timestamp | timestamp validator cannot be unjailed until | |
tombstoned | bool | whether or not a validator has been tombstoned (killed out of validator set) | |
missed_blocks_counter | int64 | missed blocks counter (to avoid scanning the array every time) |
cosmos/slashing/v1beta1/genesis.proto
GenesisState
GenesisState defines the slashing module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
params | Params | params defines all the paramaters of related to deposit. | |
signing_infos | SigningInfo | repeated | signing_infos represents a map between validator addresses and their signing infos. |
missed_blocks | ValidatorMissedBlocks | repeated | signing_infos represents a map between validator addresses and their missed blocks. |
MissedBlock
MissedBlock contains height and missed status as boolean.
Field | Type | Label | Description |
---|---|---|---|
index | int64 | index is the height at which the block was missed. | |
missed | bool | missed is the missed status. |
SigningInfo
SigningInfo stores validator signing info of corresponding address.
Field | Type | Label | Description |
---|---|---|---|
address | string | address is the validator address. | |
validator_signing_info | ValidatorSigningInfo | validator_signing_info represents the signing info of this validator. |
ValidatorMissedBlocks
ValidatorMissedBlocks contains array of missed blocks of corresponding address.
Field | Type | Label | Description |
---|---|---|---|
address | string | address is the validator address. | |
missed_blocks | MissedBlock | repeated | missed_blocks is an array of missed blocks by the validator. |
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 | Params |
QuerySigningInfoRequest
QuerySigningInfoRequest is the request type for the Query/SigningInfo RPC method
Field | Type | Label | Description |
---|---|---|---|
cons_address | string | cons_address is the address to query signing info of |
QuerySigningInfoResponse
QuerySigningInfoResponse is the response type for the Query/SigningInfo RPC method
Field | Type | Label | Description |
---|---|---|---|
val_signing_info | ValidatorSigningInfo | val_signing_info is the signing info of requested val cons address |
QuerySigningInfosRequest
QuerySigningInfosRequest is the request type for the Query/SigningInfos RPC method
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest |
QuerySigningInfosResponse
QuerySigningInfosResponse is the response type for the Query/SigningInfos RPC method
Field | Type | Label | Description |
---|---|---|---|
info | ValidatorSigningInfo | repeated | info is the signing info of all validators |
pagination | cosmos.base.query.v1beta1.PageResponse |
Query
Query provides defines the gRPC querier service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Params | QueryParamsRequest | QueryParamsResponse | Params queries the parameters of slashing module | GET | /cosmos/slashing/v1beta1/params |
SigningInfo | QuerySigningInfoRequest | QuerySigningInfoResponse | SigningInfo queries the signing info of given cons address | GET | /cosmos/slashing/v1beta1/signing_infos/{cons_address} |
SigningInfos | QuerySigningInfosRequest | QuerySigningInfosResponse | SigningInfos queries signing info of all validators | GET | /cosmos/slashing/v1beta1/signing_infos |
cosmos/slashing/v1beta1/tx.proto
MsgUnjail
MsgUnjail defines the Msg/Unjail request type
Field | Type | Label | Description |
---|---|---|---|
validator_addr | string |
MsgUnjailResponse
MsgUnjailResponse defines the Msg/Unjail response type
Msg
Msg defines the slashing Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Unjail | MsgUnjail | MsgUnjailResponse | Unjail defines a method for unjailing a jailed validator, thus returning them into the bonded validator set, so they can begin receiving provisions and rewards again. |
cosmos/staking/v1beta1/staking.proto
Commission
Commission defines commission parameters for a given validator.
Field | Type | Label | Description |
---|---|---|---|
commission_rates | CommissionRates | commission_rates defines the initial commission rates to be used for creating a validator. | |
update_time | google.protobuf.Timestamp | update_time is the last time the commission rate was changed. |
CommissionRates
CommissionRates defines the initial commission rates to be used for creating a validator.
Field | Type | Label | Description |
---|---|---|---|
rate | string | rate is the commission rate charged to delegators, as a fraction. | |
max_rate | string | max_rate defines the maximum commission rate which validator can ever charge, as a fraction. | |
max_change_rate | string | max_change_rate defines the maximum daily increase of the validator commission, as a fraction. |
DVPair
DVPair is struct that just has a delegator-validator pair with no other data. It is intended to be used as a marshalable pointer. For example, a DVPair can be used to construct the key to getting an UnbondingDelegation from state.
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | ||
validator_address | string |
DVPairs
DVPairs defines an array of DVPair objects.
Field | Type | Label | Description |
---|---|---|---|
pairs | DVPair | repeated |
DVVTriplet
DVVTriplet is struct that just has a delegator-validator-validator triplet with no other data. It is intended to be used as a marshalable pointer. For example, a DVVTriplet can be used to construct the key to getting a Redelegation from state.
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | ||
validator_src_address | string | ||
validator_dst_address | string |
DVVTriplets
DVVTriplets defines an array of DVVTriplet objects.
Field | Type | Label | Description |
---|---|---|---|
triplets | DVVTriplet | repeated |
Delegation
Delegation represents the bond with tokens held by an account. It is owned by one delegator, and is associated with the voting power of one validator.
Field | Type | Label | Description |
---|---|---|---|
delegator_address | string | delegator_address is the bech32-encoded address of the delegator. | |
validator_address | string | validator_address is the bech32-encoded address of the validator. | |
shares | string | shares define the delegation shares received. |
DelegationResponse
DelegationResponse is equivalent to Delegation except that it contains a balance in addition to shares which is more suitable for client responses.
Field | Type | Label | Description |
---|---|---|---|
delegation | Delegation | ||
balance | cosmos.base.v1beta1.Coin |
Description
Description defines a validator description.
Field | Type | Label | Description |
---|---|---|---|
moniker | string | moniker defines a human-readable name for the validator. | |
identity | string | identity defines an optional identity signature (ex. UPort or Keybase). | |
website | string | website defines an optional website link. | |
security_contact | string | security_contact defines an optional email for security contact. | |
details | string | details define other optional details. |
HistoricalInfo
HistoricalInfo contains header and validator information for a given block. It is stored as part of staking module's state, which persists the n
most recent HistoricalInfo (n
is set by the staking module's historical_entries
parameter).
Field | Type | Label | Description |
---|---|---|---|
header | tendermint.types.Header | ||
valset | Validator | repeated |
Params
Params defines the parameters for the staking module.
Field | Type | Label | Description |
---|---|---|---|
unbonding_time | google.protobuf.Duration | unbonding_time is the time duration of unbonding. | |
max_validators | uint32 | max_validators is the maximum number of validators. | |
max_entries | uint32 | max_entries is the max entries for either unbonding delegation or redelegation (per pair/trio). | |
historical_entries | uint32 | historical_entries is the number of historical entries to persist. | |
bond_denom | string | bond_denom defines the bondable coin denomination. |
Pool
Pool is used for tracking bonded and not-bonded token supply of the bond denomination.
Field | Type | Label | Description |
---|---|---|---|
not_bonded_tokens | string | ||
bonded_tokens | string |
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 | string | delegator_address is the bech32-encoded address of the delegator. | |
validator_src_address | string | validator_src_address is the validator redelegation source operator address. | |
validator_dst_address | string | validator_dst_address is the validator redelegation destination operator address. | |
entries | RedelegationEntry | repeated | entries are the redelegation entries. |
redelegation entries |
RedelegationEntry
RedelegationEntry defines a redelegation object with relevant metadata.
Field | Type | Label | Description |
---|---|---|---|
creation_height | int64 | creation_height defines the height which the redelegation took place. | |
completion_time | google.protobuf.Timestamp | completion_time defines the unix time for redelegation completion. | |
initial_balance | string | initial_balance defines the initial balance when redelegation started. | |
shares_dst | string | shares_dst is the amount of destination-validator shares created by redelegation. |
RedelegationEntryResponse
RedelegationEntryResponse is equivalent to a RedelegationEntry except that it contains a balance in addition to shares which is more suitable for client responses.
Field | Type | Label | Description |
---|---|---|---|
redelegation_entry | RedelegationEntry | ||
balance | string |
RedelegationResponse
RedelegationResponse is equivalent to a Redelegation except that its entries contain a balance in addition to shares which is more suitable for client responses.
Field | Type | Label | Description |
---|---|---|---|
redelegation | Redelegation | ||
entries | RedelegationEntryResponse | 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 | string | delegator_address is the bech32-encoded address of the delegator. | |
validator_address | string | validator_address is the bech32-encoded address of the validator. | |
entries | UnbondingDelegationEntry | repeated | entries are the unbonding delegation entries. |
unbonding delegation entries |
UnbondingDelegationEntry
UnbondingDelegationEntry defines an unbonding object with relevant metadata.
Field | Type | Label | Description |
---|---|---|---|
creation_height | int64 | creation_height is the height which the unbonding took place. | |
completion_time | google.protobuf.Timestamp | completion_time is the unix time for unbonding completion. | |
initial_balance | string | initial_balance defines the tokens initially scheduled to receive at completion. | |
balance | string | balance defines the tokens to receive at completion. |
ValAddresses
ValAddresses defines a repeated set of validator addresses.
Field | Type | Label | Description |
---|---|---|---|
addresses | string | 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 | string | operator_address defines the address of the validator's operator; bech encoded in JSON. | |
consensus_pubkey | google.protobuf.Any | consensus_pubkey is the consensus public key of the validator, as a Protobuf Any. | |
jailed | bool | jailed defined whether the validator has been jailed from bonded status or not. | |
status | BondStatus | status is the validator status (bonded/unbonding/unbonded). | |
tokens | string | tokens define the delegated tokens (incl. self-delegation). | |
delegator_shares | string | delegator_shares defines total shares issued to a validator's delegators. | |
description | Description | description defines the description terms for the validator. | |
unbonding_height | int64 | unbonding_height defines, if unbonding, the height at which this validator has begun unbonding. | |
unbonding_time | google.protobuf.Timestamp | unbonding_time defines, if unbonding, the min time for the validator to complete unbonding. | |
commission | Commission | commission defines the commission parameters. | |
min_self_delegation | string | min_self_delegation is the validator's self declared minimum 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/staking/v1beta1/genesis.proto
GenesisState
GenesisState defines the staking module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
params | Params | params defines all the paramaters of related to deposit. | |
last_total_power | bytes | last_total_power tracks the total amounts of bonded tokens recorded during the previous end block. | |
last_validator_powers | LastValidatorPower | repeated | last_validator_powers is a special index that provides a historical list of the last-block's bonded validators. |
validators | Validator | repeated | delegations defines the validator set at genesis. |
delegations | Delegation | repeated | delegations defines the delegations active at genesis. |
unbonding_delegations | UnbondingDelegation | repeated | unbonding_delegations defines the unbonding delegations active at genesis. |
redelegations | Redelegation | repeated | redelegations defines the redelegations active at genesis. |
exported | bool |
LastValidatorPower
LastValidatorPower required for validator set update logic.
Field | Type | Label | Description |
---|---|---|---|
address | string | address is the address of the validator. | |
power | int64 | power defines the power of the validator. |
cosmos/staking/v1beta1/query.proto
QueryDelegationRequest
QueryDelegationRequest is request type for the Query/Delegation RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
validator_addr | string | validator_addr defines the validator address to query for. |
QueryDelegationResponse
QueryDelegationResponse is response type for the Query/Delegation RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegation_response | DelegationResponse | delegation_responses defines the delegation info of a delegation. |
QueryDelegatorDelegationsRequest
QueryDelegatorDelegationsRequest is request type for the Query/DelegatorDelegations RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryDelegatorDelegationsResponse
QueryDelegatorDelegationsResponse is response type for the Query/DelegatorDelegations RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegation_responses | DelegationResponse | repeated | delegation_responses defines all the delegations' info of a delegator. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryDelegatorUnbondingDelegationsRequest
QueryDelegatorUnbondingDelegationsRequest is request type for the Query/DelegatorUnbondingDelegations RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
pagination | cosmos.base.query.v1beta1.PageRequest | 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 | UnbondingDelegation | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryDelegatorValidatorRequest
QueryDelegatorValidatorRequest is request type for the Query/DelegatorValidator RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
validator_addr | string | 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 | validator defines the the validator info. |
QueryDelegatorValidatorsRequest
QueryDelegatorValidatorsRequest is request type for the Query/DelegatorValidators RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryDelegatorValidatorsResponse
QueryDelegatorValidatorsResponse is response type for the Query/DelegatorValidators RPC method.
Field | Type | Label | Description |
---|---|---|---|
validators | Validator | repeated | validators defines the the validators' info of a delegator. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryHistoricalInfoRequest
QueryHistoricalInfoRequest is request type for the Query/HistoricalInfo RPC method.
Field | Type | Label | Description |
---|---|---|---|
height | int64 | height defines at which height to query the historical info. |
QueryHistoricalInfoResponse
QueryHistoricalInfoResponse is response type for the Query/HistoricalInfo RPC method.
Field | Type | Label | Description |
---|---|---|---|
hist | HistoricalInfo | hist defines the historical info at the given height. |
QueryParamsRequest
QueryParamsRequest is request type for the Query/Params RPC method.
QueryParamsResponse
QueryParamsResponse is response type for the Query/Params RPC method.
Field | Type | Label | Description |
---|---|---|---|
params | Params | params holds all the parameters of this module. |
QueryPoolRequest
QueryPoolRequest is request type for the Query/Pool RPC method.
QueryPoolResponse
QueryPoolResponse is response type for the Query/Pool RPC method.
Field | Type | Label | Description |
---|---|---|---|
pool | Pool | pool defines the pool info. |
QueryRedelegationsRequest
QueryRedelegationsRequest is request type for the Query/Redelegations RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
src_validator_addr | string | src_validator_addr defines the validator address to redelegate from. | |
dst_validator_addr | string | dst_validator_addr defines the validator address to redelegate to. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryRedelegationsResponse
QueryRedelegationsResponse is response type for the Query/Redelegations RPC method.
Field | Type | Label | Description |
---|---|---|---|
redelegation_responses | RedelegationResponse | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryUnbondingDelegationRequest
QueryUnbondingDelegationRequest is request type for the Query/UnbondingDelegation RPC method.
Field | Type | Label | Description |
---|---|---|---|
delegator_addr | string | delegator_addr defines the delegator address to query for. | |
validator_addr | string | 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 | UnbondingDelegation | 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 | string | validator_addr defines the validator address to query for. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryValidatorDelegationsResponse
QueryValidatorDelegationsResponse is response type for the Query/ValidatorDelegations RPC method
Field | Type | Label | Description |
---|---|---|---|
delegation_responses | DelegationResponse | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryValidatorRequest
QueryValidatorRequest is response type for the Query/Validator RPC method
Field | Type | Label | Description |
---|---|---|---|
validator_addr | string | 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 | validator defines the the validator info. |
QueryValidatorUnbondingDelegationsRequest
QueryValidatorUnbondingDelegationsRequest is required type for the Query/ValidatorUnbondingDelegations RPC method
Field | Type | Label | Description |
---|---|---|---|
validator_addr | string | validator_addr defines the validator address to query for. | |
pagination | cosmos.base.query.v1beta1.PageRequest | 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 | UnbondingDelegation | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
QueryValidatorsRequest
QueryValidatorsRequest is request type for Query/Validators RPC method.
Field | Type | Label | Description |
---|---|---|---|
status | string | status enables to query for validators matching a given status. | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryValidatorsResponse
QueryValidatorsResponse is response type for the Query/Validators RPC method
Field | Type | Label | Description |
---|---|---|---|
validators | Validator | repeated | validators contains all the queried validators. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines the pagination in the response. |
Query
Query defines the gRPC querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Validators | QueryValidatorsRequest | QueryValidatorsResponse | Validators queries all validators that match the given status. | GET | /cosmos/staking/v1beta1/validators |
Validator | QueryValidatorRequest | QueryValidatorResponse | Validator queries validator info for given validator address. | GET | /cosmos/staking/v1beta1/validators/{validator_addr} |
ValidatorDelegations | QueryValidatorDelegationsRequest | QueryValidatorDelegationsResponse | ValidatorDelegations queries delegate info for given validator. | GET | /cosmos/staking/v1beta1/validators/{validator_addr}/delegations |
ValidatorUnbondingDelegations | QueryValidatorUnbondingDelegationsRequest | QueryValidatorUnbondingDelegationsResponse | ValidatorUnbondingDelegations queries unbonding delegations of a validator. | GET | /cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations |
Delegation | QueryDelegationRequest | QueryDelegationResponse | Delegation queries delegate info for given validator delegator pair. | GET | /cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr} |
UnbondingDelegation | QueryUnbondingDelegationRequest | QueryUnbondingDelegationResponse | UnbondingDelegation queries unbonding info for given validator delegator pair. | GET | /cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation |
DelegatorDelegations | QueryDelegatorDelegationsRequest | QueryDelegatorDelegationsResponse | DelegatorDelegations queries all delegations of a given delegator address. | GET | /cosmos/staking/v1beta1/delegations/{delegator_addr} |
DelegatorUnbondingDelegations | QueryDelegatorUnbondingDelegationsRequest | QueryDelegatorUnbondingDelegationsResponse | DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address. | GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations |
Redelegations | QueryRedelegationsRequest | QueryRedelegationsResponse | Redelegations queries redelegations of given address. | GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations |
DelegatorValidators | QueryDelegatorValidatorsRequest | QueryDelegatorValidatorsResponse | DelegatorValidators queries all validators info for given delegator address. | GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/validators |
DelegatorValidator | QueryDelegatorValidatorRequest | QueryDelegatorValidatorResponse | DelegatorValidator queries validator info for given delegator validator pair. | GET | /cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr} |
HistoricalInfo | QueryHistoricalInfoRequest | QueryHistoricalInfoResponse | HistoricalInfo queries the historical info for given height. | GET | /cosmos/staking/v1beta1/historical_info/{height} |
Pool | QueryPoolRequest | QueryPoolResponse | Pool queries the pool info. | GET | /cosmos/staking/v1beta1/pool |
Params | QueryParamsRequest | QueryParamsResponse | Parameters queries the staking parameters. | GET | /cosmos/staking/v1beta1/params |
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 | string | ||
validator_src_address | string | ||
validator_dst_address | string | ||
amount | cosmos.base.v1beta1.Coin |
MsgBeginRedelegateResponse
MsgBeginRedelegateResponse defines the Msg/BeginRedelegate response type.
Field | Type | Label | Description |
---|---|---|---|
completion_time | google.protobuf.Timestamp |
MsgCreateValidator
MsgCreateValidator defines a SDK message for creating a new validator.
Field | Type | Label | Description |
---|---|---|---|
description | Description | ||
commission | CommissionRates | ||
min_self_delegation | string | ||
delegator_address | string | ||
validator_address | string | ||
pubkey | google.protobuf.Any | ||
value | cosmos.base.v1beta1.Coin |
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 | string | ||
validator_address | string | ||
amount | cosmos.base.v1beta1.Coin |
MsgDelegateResponse
MsgDelegateResponse defines the Msg/Delegate response type.
MsgEditValidator
MsgEditValidator defines a SDK message for editing an existing validator.
Field | Type | Label | Description |
---|---|---|---|
description | Description | ||
validator_address | string | ||
commission_rate | string | 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 | string | ||
validator_address | string | ||
amount | cosmos.base.v1beta1.Coin |
MsgUndelegateResponse
MsgUndelegateResponse defines the Msg/Undelegate response type.
Field | Type | Label | Description |
---|---|---|---|
completion_time | google.protobuf.Timestamp |
Msg
Msg defines the staking Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreateValidator | MsgCreateValidator | MsgCreateValidatorResponse | CreateValidator defines a method for creating a new validator. | ||
EditValidator | MsgEditValidator | MsgEditValidatorResponse | EditValidator defines a method for editing an existing validator. | ||
Delegate | MsgDelegate | MsgDelegateResponse | Delegate defines a method for performing a delegation of coins from a delegator to a validator. | ||
BeginRedelegate | MsgBeginRedelegate | MsgBeginRedelegateResponse | BeginRedelegate defines a method for performing a redelegation of coins from a delegator and source validator to a destination validator. | ||
Undelegate | MsgUndelegate | MsgUndelegateResponse | Undelegate defines a method for performing an undelegation from a delegate and a validator. |
cosmos/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 | google.protobuf.Any | public_key is the public key of the signer | |
data | SignatureDescriptor.Data | ||
sequence | uint64 | 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 | SignatureDescriptor.Data.Single | single represents a single signer | |
multi | SignatureDescriptor.Data.Multi | multi represents a multisig signer |
SignatureDescriptor.Data.Multi
Multi is the signature data for a multisig public key
Field | Type | Label | Description |
---|---|---|---|
bitarray | cosmos.crypto.multisig.v1beta1.CompactBitArray | bitarray specifies which keys within the multisig are signing | |
signatures | SignatureDescriptor.Data | repeated | signatures is the signatures of the multi-signature |
SignatureDescriptor.Data.Single
Single is the signature data for a single signer
Field | Type | Label | Description |
---|---|---|---|
mode | SignMode | mode is the signing mode of the single signer | |
signature | bytes | signature is the raw signature bytes |
SignatureDescriptors
SignatureDescriptors wraps multiple SignatureDescriptor's.
Field | Type | Label | Description |
---|---|---|---|
signatures | SignatureDescriptor | repeated | signatures are the signature descriptors |
SignMode
SignMode represents a signing mode with its own security guarantees.
Name | Number | Description |
---|---|---|
SIGN_MODE_UNSPECIFIED | 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 | SignerInfo | repeated | signer_infos defines the signing modes for the required signers. The number and order of elements must match the required signers from TxBody's messages. The first element is the primary signer and the one which pays the fee. |
fee | Fee | Fee is the fee and gas limit for the transaction. The first signer is the primary signer and the one which pays the fee. The fee can be calculated based on the cost of evaluating the body and doing signature verification of the signers. This can be estimated via simulation. |
Fee
Fee includes the amount of coins paid in fees and the maximum gas to be used by the transaction. The ratio yields an effective "gasprice", which must be above some miminum to be accepted into the mempool.
Field | Type | Label | Description |
---|---|---|---|
amount | cosmos.base.v1beta1.Coin | repeated | amount is the amount of coins to be paid as a fee |
gas_limit | uint64 | gas_limit is the maximum gas that can be used in transaction processing before an out of gas error occurs | |
payer | string | 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 | string | if set, the fee payer (either the first signer or the value of the payer field) requests that a fee grant be used to pay fees instead of the fee payer's own balance. If an appropriate fee grant does not exist or the chain does not support fee grants, this will fail |
ModeInfo
ModeInfo describes the signing mode of a single or nested multisig signer.
Field | Type | Label | Description |
---|---|---|---|
single | ModeInfo.Single | single represents a single signer | |
multi | ModeInfo.Multi | multi represents a nested multisig signer |
ModeInfo.Multi
Multi is the mode info for a multisig public key
Field | Type | Label | Description |
---|---|---|---|
bitarray | cosmos.crypto.multisig.v1beta1.CompactBitArray | bitarray specifies which keys within the multisig are signing | |
mode_infos | ModeInfo | repeated | mode_infos is the corresponding modes of the signers of the multisig which could include nested multisig public keys |
ModeInfo.Single
Single is the mode info for a single signer. It is structured as a message to allow for additional fields such as locale for SIGN_MODE_TEXTUAL in the future
Field | Type | Label | Description |
---|---|---|---|
mode | cosmos.tx.signing.v1beta1.SignMode | mode is the signing mode of the single signer |
SignDoc
SignDoc is the type used for generating sign bytes for SIGN_MODE_DIRECT.
Field | Type | Label | Description |
---|---|---|---|
body_bytes | bytes | body_bytes is protobuf serialization of a TxBody that matches the representation in TxRaw. | |
auth_info_bytes | bytes | auth_info_bytes is a protobuf serialization of an AuthInfo that matches the representation in TxRaw. | |
chain_id | string | 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 | uint64 | 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 | google.protobuf.Any | public_key is the public key of the signer. It is optional for accounts that already exist in state. If unset, the verifier can use the required \ signer address for this position and lookup the public key. | |
mode_info | ModeInfo | mode_info describes the signing mode of the signer and is a nested structure to support nested multisig pubkey's | |
sequence | uint64 | sequence is the sequence of the account, which describes the number of committed transactions signed by a given address. It is used to prevent replay attacks. |
Tx
Tx is the standard type used for broadcasting transactions.
Field | Type | Label | Description |
---|---|---|---|
body | TxBody | body is the processable content of the transaction | |
auth_info | AuthInfo | auth_info is the authorization related content of the transaction, specifically signers, signer modes and fee | |
signatures | bytes | 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 | google.protobuf.Any | 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 | bytes | body_bytes is a protobuf serialization of a TxBody that matches the representation in SignDoc. | |
auth_info_bytes | bytes | auth_info_bytes is a protobuf serialization of an AuthInfo that matches the representation in SignDoc. | |
signatures | bytes | 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/tx/v1beta1/service.proto
BroadcastTxRequest
BroadcastTxRequest is the request type for the Service.BroadcastTxRequest RPC method.
Field | Type | Label | Description |
---|---|---|---|
tx_bytes | bytes | tx_bytes is the raw transaction. | |
mode | BroadcastMode |
BroadcastTxResponse
BroadcastTxResponse is the response type for the Service.BroadcastTx method.
Field | Type | Label | Description |
---|---|---|---|
tx_response | cosmos.base.abci.v1beta1.TxResponse | tx_response is the queried TxResponses. |
GetTxRequest
GetTxRequest is the request type for the Service.GetTx RPC method.
Field | Type | Label | Description |
---|---|---|---|
hash | string | hash is the tx hash to query, encoded as a hex string. |
GetTxResponse
GetTxResponse is the response type for the Service.GetTx method.
Field | Type | Label | Description |
---|---|---|---|
tx | Tx | tx is the queried transaction. | |
tx_response | cosmos.base.abci.v1beta1.TxResponse | tx_response is the queried TxResponses. |
GetTxsEventRequest
GetTxsEventRequest is the request type for the Service.TxsByEvents RPC method.
Field | Type | Label | Description |
---|---|---|---|
events | string | repeated | events is the list of transaction event type. |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an pagination for the request. | |
order_by | OrderBy |
GetTxsEventResponse
GetTxsEventResponse is the response type for the Service.TxsByEvents RPC method.
Field | Type | Label | Description |
---|---|---|---|
txs | Tx | repeated | txs is the list of queried transactions. |
tx_responses | cosmos.base.abci.v1beta1.TxResponse | repeated | tx_responses is the list of queried TxResponses. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines an pagination for the response. |
SimulateRequest
SimulateRequest is the request type for the Service.Simulate RPC method.
Field | Type | Label | Description |
---|---|---|---|
tx | Tx | tx is the transaction to simulate. |
SimulateResponse
SimulateResponse is the response type for the Service.SimulateRPC method.
Field | Type | Label | Description |
---|---|---|---|
gas_info | cosmos.base.abci.v1beta1.GasInfo | gas_info is the information about gas used in the simulation. | |
result | cosmos.base.abci.v1beta1.Result | result is the result of the simulation. |
BroadcastMode
BroadcastMode specifies the broadcast mode for the TxService.Broadcast RPC method.
Name | Number | Description |
---|---|---|
BROADCAST_MODE_UNSPECIFIED | 0 | zero-value for mode ordering |
BROADCAST_MODE_BLOCK | 1 | BROADCAST_MODE_BLOCK defines a tx broadcasting mode where the client waits for the tx to be committed in a block. |
BROADCAST_MODE_SYNC | 2 | BROADCAST_MODE_SYNC defines a tx broadcasting mode where the client waits for a CheckTx execution response only. |
BROADCAST_MODE_ASYNC | 3 | BROADCAST_MODE_ASYNC defines a tx broadcasting mode where the client returns immediately. |
OrderBy
OrderBy defines the sorting order
Name | Number | Description |
---|---|---|
ORDER_BY_UNSPECIFIED | 0 | ORDER_BY_UNSPECIFIED specifies an unknown sorting order. OrderBy defaults to ASC in this case. |
ORDER_BY_ASC | 1 | ORDER_BY_ASC defines ascending order |
ORDER_BY_DESC | 2 | ORDER_BY_DESC defines descending order |
Service
Service defines a gRPC service for interacting with transactions.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Simulate | SimulateRequest | SimulateResponse | Simulate simulates executing a transaction for estimating gas usage. | POST | /cosmos/tx/v1beta1/simulate |
GetTx | GetTxRequest | GetTxResponse | GetTx fetches a tx by hash. | GET | /cosmos/tx/v1beta1/txs/{hash} |
BroadcastTx | BroadcastTxRequest | BroadcastTxResponse | BroadcastTx broadcast transaction. | POST | /cosmos/tx/v1beta1/txs |
GetTxsEvent | GetTxsEventRequest | GetTxsEventResponse | GetTxsEvent fetches txs by event. | GET | /cosmos/tx/v1beta1/txs |
cosmos/upgrade/v1beta1/upgrade.proto
CancelSoftwareUpgradeProposal
CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade.
Field | Type | Label | Description |
---|---|---|---|
title | string | ||
description | string |
Plan
Plan specifies information about a planned upgrade and when it should occur.
Field | Type | Label | Description |
---|---|---|---|
name | string | 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 | google.protobuf.Timestamp | The time after which the upgrade must be performed. Leave set to its zero value to use a pre-defined Height instead. | |
height | int64 | The height at which the upgrade must be performed. Only used if Time is not set. | |
info | string | Any application specific upgrade info to be included on-chain such as a git commit that validators could automatically upgrade to | |
upgraded_client_state | google.protobuf.Any | IBC-enabled chains can opt-in to including the upgraded client state in its upgrade plan This will make the chain commit to the correct upgraded (self) client state before the upgrade occurs, so that connecting chains can verify that the new upgraded client is valid by verifying a proof on the previous version of the chain. This will allow IBC connections to persist smoothly across planned chain upgrades |
SoftwareUpgradeProposal
SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade.
Field | Type | Label | Description |
---|---|---|---|
title | string | ||
description | string | ||
plan | Plan |
cosmos/upgrade/v1beta1/query.proto
QueryAppliedPlanRequest
QueryCurrentPlanRequest is the request type for the Query/AppliedPlan RPC method.
Field | Type | Label | Description |
---|---|---|---|
name | string | 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 | int64 | height is the block height at which the plan was applied. |
QueryCurrentPlanRequest
QueryCurrentPlanRequest is the request type for the Query/CurrentPlan RPC method.
QueryCurrentPlanResponse
QueryCurrentPlanResponse is the response type for the Query/CurrentPlan RPC method.
Field | Type | Label | Description |
---|---|---|---|
plan | Plan | plan is the current upgrade plan. |
QueryUpgradedConsensusStateRequest
QueryUpgradedConsensusStateRequest is the request type for the Query/UpgradedConsensusState RPC method.
Field | Type | Label | Description |
---|---|---|---|
last_height | int64 | last height of the current chain must be sent in request as this is the height under which next consensus state is stored |
QueryUpgradedConsensusStateResponse
QueryUpgradedConsensusStateResponse is the response type for the Query/UpgradedConsensusState RPC method.
Field | Type | Label | Description |
---|---|---|---|
upgraded_consensus_state | google.protobuf.Any |
Query
Query defines the gRPC upgrade querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CurrentPlan | QueryCurrentPlanRequest | QueryCurrentPlanResponse | CurrentPlan queries the current upgrade plan. | GET | /cosmos/upgrade/v1beta1/current_plan |
AppliedPlan | QueryAppliedPlanRequest | QueryAppliedPlanResponse | AppliedPlan queries a previously applied upgrade plan by its name. | GET | /cosmos/upgrade/v1beta1/applied_plan/{name} |
UpgradedConsensusState | QueryUpgradedConsensusStateRequest | QueryUpgradedConsensusStateResponse | UpgradedConsensusState queries the consensus state that will serve as a trusted kernel for the next version of this chain. It will only be stored at the last height of this chain. UpgradedConsensusState RPC not supported with legacy querier | GET | /cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height} |
cosmos/vesting/v1beta1/tx.proto
MsgCreateVestingAccount
MsgCreateVestingAccount defines a message that enables creating a vesting account.
Field | Type | Label | Description |
---|---|---|---|
from_address | string | ||
to_address | string | ||
amount | cosmos.base.v1beta1.Coin | repeated | |
end_time | int64 | ||
delayed | bool |
MsgCreateVestingAccountResponse
MsgCreateVestingAccountResponse defines the Msg/CreateVestingAccount response type.
Msg
Msg defines the bank Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreateVestingAccount | MsgCreateVestingAccount | MsgCreateVestingAccountResponse | 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 | cosmos.auth.v1beta1.BaseAccount | ||
original_vesting | cosmos.base.v1beta1.Coin | repeated | |
delegated_free | cosmos.base.v1beta1.Coin | repeated | |
delegated_vesting | cosmos.base.v1beta1.Coin | repeated | |
end_time | int64 |
ContinuousVestingAccount
ContinuousVestingAccount implements the VestingAccount interface. It continuously vests by unlocking coins linearly with respect to time.
Field | Type | Label | Description |
---|---|---|---|
base_vesting_account | BaseVestingAccount | ||
start_time | int64 |
DelayedVestingAccount
DelayedVestingAccount implements the VestingAccount interface. It vests all coins after a specific time, but non prior. In other words, it keeps them locked until a specified time.
Field | Type | Label | Description |
---|---|---|---|
base_vesting_account | BaseVestingAccount |
Period
Period defines a length of time and amount of coins that will vest.
Field | Type | Label | Description |
---|---|---|---|
length | int64 | ||
amount | cosmos.base.v1beta1.Coin | repeated |
PeriodicVestingAccount
PeriodicVestingAccount implements the VestingAccount interface. It periodically vests by unlocking coins during each specified period.
Field | Type | Label | Description |
---|---|---|---|
base_vesting_account | BaseVestingAccount | ||
start_time | int64 | ||
vesting_periods | Period | repeated |
farm/farm.proto
FarmInfo
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
address | string | ||
locked | string | ||
reward_debt | cosmos.base.v1beta1.Coin | repeated |
FarmPool
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
creator | string | ||
description | string | ||
start_height | int64 | ||
end_height | int64 | ||
last_height_distr_rewards | int64 | ||
editable | bool | ||
total_lpt_locked | cosmos.base.v1beta1.Coin | ||
rules | RewardRule | repeated |
Params
Field | Type | Label | Description |
---|---|---|---|
create_pool_fee | cosmos.base.v1beta1.Coin | ||
max_reward_categories | uint32 |
RewardRule
Field | Type | Label | Description |
---|---|---|---|
reward | string | ||
total_reward | string | ||
remaining_reward | string | ||
reward_per_block | string | ||
reward_per_share | string |
farm/genesis.proto
GenesisState
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
pools | FarmPool | repeated | |
farm_infos | FarmInfo | repeated |
farm/query.proto
FarmPoolEntry
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
creator | string | ||
description | string | ||
start_height | int64 | ||
end_height | int64 | ||
editable | bool | ||
expired | bool | ||
total_lpt_locked | cosmos.base.v1beta1.Coin | ||
total_reward | cosmos.base.v1beta1.Coin | repeated | |
remaining_reward | cosmos.base.v1beta1.Coin | repeated | |
reward_per_block | cosmos.base.v1beta1.Coin | repeated |
LockedInfo
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
locked | cosmos.base.v1beta1.Coin | ||
pending_reward | cosmos.base.v1beta1.Coin | repeated |
QueryFarmPoolRequest
Field | Type | Label | Description |
---|---|---|---|
name | string |
QueryFarmPoolResponse
Field | Type | Label | Description |
---|---|---|---|
pool | FarmPoolEntry |
QueryFarmPoolsRequest
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest |
QueryFarmPoolsResponse
Field | Type | Label | Description |
---|---|---|---|
pools | FarmPoolEntry | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryFarmerRequest
Field | Type | Label | Description |
---|---|---|---|
farmer | string | ||
pool_name | string |
QueryFarmerResponse
Field | Type | Label | Description |
---|---|---|---|
list | LockedInfo | repeated | |
height | int64 |
QueryParamsRequest
QueryParamsResponse
Field | Type | Label | Description |
---|---|---|---|
params | Params |
Query
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
FarmPools | QueryFarmPoolsRequest | QueryFarmPoolsResponse | GET | /irismod/farm/pools | |
FarmPool | QueryFarmPoolRequest | QueryFarmPoolResponse | GET | /irismod/farm/pool/{name} | |
Farmer | QueryFarmerRequest | QueryFarmerResponse | GET | /irismod/farm/farmers/{farmer} | |
Params | QueryParamsRequest | QueryParamsResponse | Params queries the htlc parameters | GET | /irismod/farm/params |
farm/tx.proto
MsgAdjustPool
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
additional_reward | cosmos.base.v1beta1.Coin | repeated | |
reward_per_block | cosmos.base.v1beta1.Coin | repeated | |
creator | string |
MsgAdjustPoolResponse
MsgCreatePool
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
description | string | ||
lpt_denom | string | ||
start_height | int64 | ||
reward_per_block | cosmos.base.v1beta1.Coin | repeated | |
total_reward | cosmos.base.v1beta1.Coin | repeated | |
editable | bool | ||
creator | string |
MsgCreatePoolResponse
MsgDestroyPool
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
creator | string |
MsgDestroyPoolResponse
MsgHarvest
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
sender | string |
MsgHarvestResponse
Field | Type | Label | Description |
---|---|---|---|
reward | cosmos.base.v1beta1.Coin | repeated |
MsgStake
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
amount | cosmos.base.v1beta1.Coin | ||
sender | string |
MsgStakeResponse
Field | Type | Label | Description |
---|---|---|---|
reward | cosmos.base.v1beta1.Coin | repeated |
MsgUnstake
Field | Type | Label | Description |
---|---|---|---|
pool_name | string | ||
amount | cosmos.base.v1beta1.Coin | ||
sender | string |
MsgUnstakeResponse
Field | Type | Label | Description |
---|---|---|---|
reward | cosmos.base.v1beta1.Coin | repeated |
Msg
Msg defines the farm Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreatePool | MsgCreatePool | MsgCreatePoolResponse | CreatePool defines a method for creating a new farm pool | ||
DestroyPool | MsgDestroyPool | MsgDestroyPoolResponse | DestroyPool defines a method for destroying a existed farm pool | ||
AdjustPool | MsgAdjustPool | MsgAdjustPoolResponse | AdjustPool defines a method for adjusting the farm pool params | ||
Stake | MsgStake | MsgStakeResponse | Stake defines a method for staking some lp token to a farm pool | ||
Unstake | MsgUnstake | MsgUnstakeResponse | Unstake defines a method for unstaking some lp token from a farm pool and withdraw some reward | ||
Harvest | MsgHarvest | MsgHarvestResponse | Harvest defines a method withdraw some reward from a farm pool |
guardian/guardian.proto
Super
Super defines the super standard
Field | Type | Label | Description |
---|---|---|---|
description | string | ||
account_type | AccountType | ||
address | string | ||
added_by | string |
AccountType
AccountType defines the super account type
Name | Number | Description |
---|---|---|
GENESIS | 0 | GENESIS defines a genesis account type |
ORDINARY | 1 | ORDINARY defines a ordinary account type |
guardian/genesis.proto
GenesisState
GenesisState defines the guardian module's genesis state
Field | Type | Label | Description |
---|---|---|---|
supers | Super | repeated |
guardian/query.proto
QuerySupersRequest
QuerySupersRequest is request type for the Query/Supers RPC method
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request |
QuerySupersResponse
QuerySupersResponse is response type for the Query/Supers RPC method
Field | Type | Label | Description |
---|---|---|---|
supers | Super | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
Query
Query creates service with guardian as RPC
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Supers | QuerySupersRequest | QuerySupersResponse | Supers returns all Supers | GET | /irishub/guardian/supers |
guardian/tx.proto
MsgAddSuper
MsgAddSuper defines the properties of add super account message
Field | Type | Label | Description |
---|---|---|---|
description | string | ||
address | string | ||
added_by | string |
MsgAddSuperResponse
MsgAddSuperResponse defines the Msg/AddSuper response type
MsgDeleteSuper
MsgDeleteSuper defines the properties of delete super account message
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
deleted_by | string |
MsgDeleteSuperResponse
MsgDeleteSuperResponse defines the Msg/DeleteSuper response type
Msg
Msg defines the guardian Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
AddSuper | MsgAddSuper | MsgAddSuperResponse | AddSuper defines a method for adding a super account | ||
DeleteSuper | MsgDeleteSuper | MsgDeleteSuperResponse | DeleteSuper defines a method for deleting a super account |
htlc/htlc.proto
AssetParam
Field | Type | Label | Description |
---|---|---|---|
denom | string | name of the asset | |
supply_limit | SupplyLimit | asset supply limit | |
active | bool | denotes if asset is available or paused | |
deputy_address | string | the address of the relayer process | |
fixed_fee | string | the fixed fee charged by the relayer process for outgoing swaps | |
min_swap_amount | string | Minimum swap amount | |
max_swap_amount | string | Maximum swap amount | |
min_block_lock | uint64 | Minimum swap block lock | |
max_block_lock | uint64 | Maximum swap block lock |
AssetSupply
Field | Type | Label | Description |
---|---|---|---|
incoming_supply | cosmos.base.v1beta1.Coin | ||
outgoing_supply | cosmos.base.v1beta1.Coin | ||
current_supply | cosmos.base.v1beta1.Coin | ||
time_limited_current_supply | cosmos.base.v1beta1.Coin | ||
time_elapsed | google.protobuf.Duration |
HTLC
HTLC defines the struct of an HTLC
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
sender | string | ||
to | string | ||
receiver_on_other_chain | string | ||
sender_on_other_chain | string | ||
amount | cosmos.base.v1beta1.Coin | repeated | |
hash_lock | string | ||
secret | string | ||
timestamp | uint64 | ||
expiration_height | uint64 | ||
state | HTLCState | ||
closed_block | uint64 | ||
transfer | bool | ||
direction | SwapDirection |
Params
Params defines token module's parameters
Field | Type | Label | Description |
---|---|---|---|
asset_params | AssetParam | repeated |
SupplyLimit
Field | Type | Label | Description |
---|---|---|---|
limit | string | the absolute supply limit for an asset | |
time_limited | bool | boolean for if the supply is also limited by time | |
time_period | google.protobuf.Duration | the duration for which the supply time limit applies | |
time_based_limit | string | the supply limit for an asset for each time period |
HTLCState
HTLCState defines the state of an HTLC
Name | Number | Description |
---|---|---|
HTLC_STATE_OPEN | 0 | HTLC_STATE_OPEN defines an open state. |
HTLC_STATE_COMPLETED | 1 | HTLC_STATE_COMPLETED defines a completed state. |
HTLC_STATE_REFUNDED | 2 | HTLC_STATE_REFUNDED defines a refunded state. |
SwapDirection
SwapDirection defines the direction of an HTLT
Name | Number | Description |
---|---|---|
NONE | 0 | NONE defines an htlt none direction. |
INCOMING | 1 | INCOMING defines an htlt incoming direction. |
OUTGOING | 2 | OUTGOING defines an htlt outgoing direction. |
htlc/genesis.proto
GenesisState
GenesisState defines the HTLC module's genesis state
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
htlcs | HTLC | repeated | |
supplies | AssetSupply | repeated | |
previous_block_time | google.protobuf.Timestamp |
htlc/query.proto
QueryAssetSuppliesRequest
QueryAssetSuppliesRequest is request type for the Query/AssetSupplies RPC method
QueryAssetSuppliesResponse
QueryAssetSuppliesResponse is response type for the Query/AssetSupplies RPC method
Field | Type | Label | Description |
---|---|---|---|
asset_supplies | AssetSupply | repeated |
QueryAssetSupplyRequest
QueryAssetSupplyRequest is request type for the Query/AssetSupply RPC method
Field | Type | Label | Description |
---|---|---|---|
denom | string |
QueryAssetSupplyResponse
QueryAssetSupplyResponse is response type for the Query/AssetSupply RPC method
Field | Type | Label | Description |
---|---|---|---|
asset_supply | AssetSupply |
QueryHTLCRequest
QueryHTLCRequest is the request type for the Query/HTLC RPC method
Field | Type | Label | Description |
---|---|---|---|
id | string |
QueryHTLCResponse
QueryBalanceResponse is the response type for the Query/HTLC RPC method
Field | Type | Label | Description |
---|---|---|---|
htlc | HTLC |
QueryParamsRequest
QueryParamsRequest is request type for the Query/Parameters RPC method
QueryParamsResponse
QueryParamsResponse is response type for the Query/Parameters RPC method
Field | Type | Label | Description |
---|---|---|---|
params | Params |
Query
Query provides defines the gRPC querier service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
HTLC | QueryHTLCRequest | QueryHTLCResponse | HTLC queries the HTLC by the specified hash lock | GET | /irismod/htlc/htlcs/{id} |
AssetSupply | QueryAssetSupplyRequest | QueryAssetSupplyResponse | AssetSupply queries the supply of an asset | GET | /irismod/htlc/supplies/{denom} |
AssetSupplies | QueryAssetSuppliesRequest | QueryAssetSuppliesResponse | AssetSupplies queries the supplies of all assets | GET | /irismod/htlc/supplies |
Params | QueryParamsRequest | QueryParamsResponse | Params queries the htlc parameters | GET | /irismod/htlc/params |
htlc/tx.proto
MsgClaimHTLC
MsgClaimHTLC defines a message to claim an HTLC
Field | Type | Label | Description |
---|---|---|---|
sender | string | ||
id | string | ||
secret | string |
MsgClaimHTLCResponse
MsgClaimHTLCResponse defines the Msg/ClaimHTLC response type
MsgCreateHTLC
MsgCreateHTLC defines a message to create an HTLC
Field | Type | Label | Description |
---|---|---|---|
sender | string | ||
to | string | ||
receiver_on_other_chain | string | ||
sender_on_other_chain | string | ||
amount | cosmos.base.v1beta1.Coin | repeated | |
hash_lock | string | ||
timestamp | uint64 | ||
time_lock | uint64 | ||
transfer | bool |
MsgCreateHTLCResponse
MsgCreateHTLCResponse defines the Msg/CreateHTLC response type
Field | Type | Label | Description |
---|---|---|---|
id | string |
Msg
Msg defines the HTLC Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreateHTLC | MsgCreateHTLC | MsgCreateHTLCResponse | CreateHTLC defines a method for creating a HTLC | ||
ClaimHTLC | MsgClaimHTLC | MsgClaimHTLCResponse | ClaimHTLC defines a method for claiming a HTLC |
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 | string | path defines the chain of port/channel identifiers used for tracing the source of the fungible token. | |
base_denom | string | 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 | string | the token denomination to be transferred | |
amount | uint64 | the token amount to be transferred | |
sender | string | the sender address | |
receiver | string | the recipient address on the destination chain |
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 | bool | send_enabled enables or disables all cross-chain token transfers from this chain. | |
receive_enabled | bool | receive_enabled enables or disables all cross-chain token transfers to this chain. |
ibc/applications/transfer/v1/genesis.proto
GenesisState
GenesisState defines the ibc-transfer genesis state
Field | Type | Label | Description |
---|---|---|---|
port_id | string | ||
denom_traces | DenomTrace | repeated | |
params | Params |
ibc/applications/transfer/v1/query.proto
QueryDenomTraceRequest
QueryDenomTraceRequest is the request type for the Query/DenomTrace RPC method
Field | Type | Label | Description |
---|---|---|---|
hash | string | hash (in hex format) of the denomination trace information. |
QueryDenomTraceResponse
QueryDenomTraceResponse is the response type for the Query/DenomTrace RPC method.
Field | Type | Label | Description |
---|---|---|---|
denom_trace | DenomTrace | denom_trace returns the requested denomination trace information. |
QueryDenomTracesRequest
QueryConnectionsRequest is the request type for the Query/DenomTraces RPC method
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryDenomTracesResponse
QueryConnectionsResponse is the response type for the Query/DenomTraces RPC method.
Field | Type | Label | Description |
---|---|---|---|
denom_traces | DenomTrace | repeated | denom_traces returns all denominations trace information. |
pagination | cosmos.base.query.v1beta1.PageResponse | 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 | params defines the parameters of the module. |
Query
Query provides defines the gRPC querier service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
DenomTrace | QueryDenomTraceRequest | QueryDenomTraceResponse | DenomTrace queries a denomination trace information. | GET | /ibc/applications/transfer/v1beta1/denom_traces/{hash} |
DenomTraces | QueryDenomTracesRequest | QueryDenomTracesResponse | DenomTraces queries all denomination traces. | GET | /ibc/applications/transfer/v1beta1/denom_traces |
Params | QueryParamsRequest | QueryParamsResponse | Params queries all parameters of the ibc-transfer module. | GET | /ibc/applications/transfer/v1beta1/params |
ibc/core/client/v1/client.proto
ClientConsensusStates
ClientConsensusStates defines all the stored consensus states for a given client.
Field | Type | Label | Description |
---|---|---|---|
client_id | string | client identifier | |
consensus_states | ConsensusStateWithHeight | repeated | consensus states and their heights associated with the client |
ClientUpdateProposal
ClientUpdateProposal is a governance proposal. If it passes, the client is updated with the provided header. The update may fail if the header is not valid given certain conditions specified by the client implementation.
Field | Type | Label | Description |
---|---|---|---|
title | string | the title of the update proposal | |
description | string | the description of the proposal | |
client_id | string | the client identifier for the client to be updated if the proposal passes | |
header | google.protobuf.Any | 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 | Height | consensus state height | |
consensus_state | google.protobuf.Any | 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 RevisionHeight is incremented at each height while keeping RevisionNumber 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 RevisionNumber is incremented so that height continues to be monitonically increasing even as the RevisionHeight gets reset
Field | Type | Label | Description |
---|---|---|---|
revision_number | uint64 | the revision that the client is currently on | |
revision_height | uint64 | the height within the given revision |
IdentifiedClientState
IdentifiedClientState defines a client state with an additional client identifier field.
Field | Type | Label | Description |
---|---|---|---|
client_id | string | client identifier | |
client_state | google.protobuf.Any | client state |
Params
Params defines the set of IBC light client parameters.
Field | Type | Label | Description |
---|---|---|---|
allowed_clients | string | repeated | allowed_clients defines the list of allowed client state types. |
ibc/applications/transfer/v1/tx.proto
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 | string | the port on which the packet will be sent | |
source_channel | string | the channel by which the packet will be sent | |
token | cosmos.base.v1beta1.Coin | the tokens to be transferred | |
sender | string | the sender address | |
receiver | string | the recipient address on the destination chain | |
timeout_height | ibc.core.client.v1.Height | Timeout height relative to the current block height. The timeout is disabled when set to 0. | |
timeout_timestamp | uint64 | 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.
Msg
Msg defines the ibc/transfer Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Transfer | MsgTransfer | MsgTransferResponse | Transfer defines a rpc handler method for MsgTransfer. |
ibc/core/channel/v1/channel.proto
Acknowledgement
Acknowledgement is the recommended acknowledgement format to be used by app-specific protocols. NOTE: The field numbers 21 and 22 were explicitly chosen to avoid accidental conflicts with other protobuf message formats used for acknowledgements. The first byte of any message with this format will be the non-ASCII values 0xaa
(result) or 0xb2
(error). Implemented as defined by ICS: https://github.com/cosmos/ics/tree/master/spec/ics-004-channel-and-packet-semantics#acknowledgement-envelope
Field | Type | Label | Description |
---|---|---|---|
result | bytes | ||
error | string |
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 | State | current state of the channel end | |
ordering | Order | whether the channel is ordered or unordered | |
counterparty | Counterparty | counterparty channel end | |
connection_hops | string | repeated | list of connection identifiers, in order, along which packets sent on this channel will travel |
version | string | opaque channel version, which is agreed upon during the handshake |
Counterparty
Counterparty defines a channel end counterparty
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port on the counterparty chain which owns the other end of the channel. | |
channel_id | string | channel end on the counterparty chain |
IdentifiedChannel
IdentifiedChannel defines a channel with additional port and channel identifier fields.
Field | Type | Label | Description |
---|---|---|---|
state | State | current state of the channel end | |
ordering | Order | whether the channel is ordered or unordered | |
counterparty | Counterparty | counterparty channel end | |
connection_hops | string | repeated | list of connection identifiers, in order, along which packets sent on this channel will travel |
version | string | opaque channel version, which is agreed upon during the handshake | |
port_id | string | port identifier | |
channel_id | string | channel identifier |
Packet
Packet defines a type that carries data across different chains through IBC
Field | Type | Label | Description |
---|---|---|---|
sequence | uint64 | 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 | string | identifies the port on the sending chain. | |
source_channel | string | identifies the channel end on the sending chain. | |
destination_port | string | identifies the port on the receiving chain. | |
destination_channel | string | identifies the channel end on the receiving chain. | |
data | bytes | actual opaque bytes transferred directly to the application module | |
timeout_height | ibc.core.client.v1.Height | block height after which the packet times out | |
timeout_timestamp | uint64 | block timestamp (in nanoseconds) after which the packet times out |
PacketState
PacketState defines the generic type necessary to retrieve and store packet commitments, acknowledgements, and receipts. Caller is responsible for knowing the context necessary to interpret this state as a commitment, acknowledgement, or a receipt.
Field | Type | Label | Description |
---|---|---|---|
port_id | string | channel port identifier. | |
channel_id | string | channel unique identifier. | |
sequence | uint64 | packet sequence. | |
data | bytes | embedded data that represents packet state. |
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. |
ibc/core/channel/v1/genesis.proto
GenesisState
GenesisState defines the ibc channel submodule's genesis state.
Field | Type | Label | Description |
---|---|---|---|
channels | IdentifiedChannel | repeated | |
acknowledgements | PacketState | repeated | |
commitments | PacketState | repeated | |
receipts | PacketState | repeated | |
send_sequences | PacketSequence | repeated | |
recv_sequences | PacketSequence | repeated | |
ack_sequences | PacketSequence | repeated | |
next_channel_sequence | uint64 | the sequence for the next generated channel identifier |
PacketSequence
PacketSequence defines the genesis type necessary to retrieve and store next send and receive sequences.
Field | Type | Label | Description |
---|---|---|---|
port_id | string | ||
channel_id | string | ||
sequence | uint64 |
ibc/core/channel/v1/query.proto
QueryChannelClientStateRequest
QueryChannelClientStateRequest is the request type for the Query/ClientState RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier |
QueryChannelClientStateResponse
QueryChannelClientStateResponse is the Response type for the Query/QueryChannelClientState RPC method
Field | Type | Label | Description |
---|---|---|---|
identified_client_state | ibc.core.client.v1.IdentifiedClientState | client state associated with the channel | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | port unique identifier | |
channel_id | string | channel unique identifier | |
revision_number | uint64 | revision number of the consensus state | |
revision_height | uint64 | revision height of the consensus state |
QueryChannelConsensusStateResponse
QueryChannelClientStateResponse is the Response type for the Query/QueryChannelClientState RPC method
Field | Type | Label | Description |
---|---|---|---|
consensus_state | google.protobuf.Any | consensus state associated with the channel | |
client_id | string | client ID associated with the consensus state | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | port unique identifier | |
channel_id | string | channel unique identifier |
QueryChannelResponse
QueryChannelResponse is the response type for the Query/Channel RPC method. Besides the Channel end, it includes a proof and the height from which the proof was retrieved.
Field | Type | Label | Description |
---|---|---|---|
channel | Channel | channel associated with the request identifiers | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | cosmos.base.query.v1beta1.PageRequest | pagination request |
QueryChannelsResponse
QueryChannelsResponse is the response type for the Query/Channels RPC method.
Field | Type | Label | Description |
---|---|---|---|
channels | IdentifiedChannel | repeated | list of stored channels of the chain. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination response | |
height | ibc.core.client.v1.Height | query block height |
QueryConnectionChannelsRequest
QueryConnectionChannelsRequest is the request type for the Query/QueryConnectionChannels RPC method
Field | Type | Label | Description |
---|---|---|---|
connection | string | connection unique identifier | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination request |
QueryConnectionChannelsResponse
QueryConnectionChannelsResponse is the Response type for the Query/QueryConnectionChannels RPC method
Field | Type | Label | Description |
---|---|---|---|
channels | IdentifiedChannel | repeated | list of channels associated with a connection. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination response | |
height | ibc.core.client.v1.Height | query block height |
QueryNextSequenceReceiveRequest
QueryNextSequenceReceiveRequest is the request type for the Query/QueryNextSequenceReceiveRequest RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier |
QueryNextSequenceReceiveResponse
QuerySequenceResponse is the request type for the Query/QueryNextSequenceReceiveResponse RPC method
Field | Type | Label | Description |
---|---|---|---|
next_sequence_receive | uint64 | next sequence receive number | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | port unique identifier | |
channel_id | string | channel unique identifier | |
sequence | uint64 | packet sequence |
QueryPacketAcknowledgementResponse
QueryPacketAcknowledgementResponse defines the client query response for a packet which also includes a proof and the height from which the proof was retrieved
Field | Type | Label | Description |
---|---|---|---|
acknowledgement | bytes | packet associated with the request fields | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.Height | height at which the proof was retrieved |
QueryPacketAcknowledgementsRequest
QueryPacketAcknowledgementsRequest is the request type for the Query/QueryPacketCommitments RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination request |
QueryPacketAcknowledgementsResponse
QueryPacketAcknowledgemetsResponse is the request type for the Query/QueryPacketAcknowledgements RPC method
Field | Type | Label | Description |
---|---|---|---|
acknowledgements | PacketState | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination response | |
height | ibc.core.client.v1.Height | query block height |
QueryPacketCommitmentRequest
QueryPacketCommitmentRequest is the request type for the Query/PacketCommitment RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier | |
sequence | uint64 | packet sequence |
QueryPacketCommitmentResponse
QueryPacketCommitmentResponse defines the client query response for a packet which also includes a proof and the height from which the proof was retrieved
Field | Type | Label | Description |
---|---|---|---|
commitment | bytes | packet associated with the request fields | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | port unique identifier | |
channel_id | string | channel unique identifier | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination request |
QueryPacketCommitmentsResponse
QueryPacketCommitmentsResponse is the request type for the Query/QueryPacketCommitments RPC method
Field | Type | Label | Description |
---|---|---|---|
commitments | PacketState | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination response | |
height | ibc.core.client.v1.Height | query block height |
QueryPacketReceiptRequest
QueryPacketReceiptRequest is the request type for the Query/PacketReceipt RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier | |
sequence | uint64 | packet sequence |
QueryPacketReceiptResponse
QueryPacketReceiptResponse defines the client query response for a packet receipt which also includes a proof, and the height from which the proof was retrieved
Field | Type | Label | Description |
---|---|---|---|
received | bool | success flag for if receipt exists | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.Height | height at which the proof was retrieved |
QueryUnreceivedAcksRequest
QueryUnreceivedAcks is the request type for the Query/UnreceivedAcks RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier | |
packet_ack_sequences | uint64 | repeated | list of acknowledgement sequences |
QueryUnreceivedAcksResponse
QueryUnreceivedAcksResponse is the response type for the Query/UnreceivedAcks RPC method
Field | Type | Label | Description |
---|---|---|---|
sequences | uint64 | repeated | list of unreceived acknowledgement sequences |
height | ibc.core.client.v1.Height | query block height |
QueryUnreceivedPacketsRequest
QueryUnreceivedPacketsRequest is the request type for the Query/UnreceivedPackets RPC method
Field | Type | Label | Description |
---|---|---|---|
port_id | string | port unique identifier | |
channel_id | string | channel unique identifier | |
packet_commitment_sequences | uint64 | repeated | list of packet sequences |
QueryUnreceivedPacketsResponse
QueryUnreceivedPacketsResponse is the response type for the Query/UnreceivedPacketCommitments RPC method
Field | Type | Label | Description |
---|---|---|---|
sequences | uint64 | repeated | list of unreceived packet sequences |
height | ibc.core.client.v1.Height | query block height |
Query
Query provides defines the gRPC querier service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Channel | QueryChannelRequest | QueryChannelResponse | Channel queries an IBC Channel. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id} |
Channels | QueryChannelsRequest | QueryChannelsResponse | Channels queries all the IBC channels of a chain. | GET | /ibc/core/channel/v1beta1/channels |
ConnectionChannels | QueryConnectionChannelsRequest | QueryConnectionChannelsResponse | ConnectionChannels queries all the channels associated with a connection end. | GET | /ibc/core/channel/v1beta1/connections/{connection}/channels |
ChannelClientState | QueryChannelClientStateRequest | QueryChannelClientStateResponse | ChannelClientState queries for the client state for the channel associated with the provided channel identifiers. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/client_state |
ChannelConsensusState | QueryChannelConsensusStateRequest | QueryChannelConsensusStateResponse | ChannelConsensusState queries for the consensus state for the channel associated with the provided channel identifiers. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height} |
PacketCommitment | QueryPacketCommitmentRequest | QueryPacketCommitmentResponse | PacketCommitment queries a stored packet commitment hash. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence} |
PacketCommitments | QueryPacketCommitmentsRequest | QueryPacketCommitmentsResponse | PacketCommitments returns all the packet commitments hashes associated with a channel. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments |
PacketReceipt | QueryPacketReceiptRequest | QueryPacketReceiptResponse | PacketReceipt queries if a given packet sequence has been received on the queried chain | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence} |
PacketAcknowledgement | QueryPacketAcknowledgementRequest | QueryPacketAcknowledgementResponse | PacketAcknowledgement queries a stored packet acknowledgement hash. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence} |
PacketAcknowledgements | QueryPacketAcknowledgementsRequest | QueryPacketAcknowledgementsResponse | PacketAcknowledgements returns all the packet acknowledgements associated with a channel. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements |
UnreceivedPackets | QueryUnreceivedPacketsRequest | QueryUnreceivedPacketsResponse | UnreceivedPackets returns all the unreceived IBC packets associated with a channel and sequences. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets |
UnreceivedAcks | QueryUnreceivedAcksRequest | QueryUnreceivedAcksResponse | UnreceivedAcks returns all the unreceived IBC acknowledgements associated with a channel and sequences. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks |
NextSequenceReceive | QueryNextSequenceReceiveRequest | QueryNextSequenceReceiveResponse | NextSequenceReceive returns the next receive sequence for a given channel. | GET | /ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/next_sequence |
ibc/core/channel/v1/tx.proto
MsgAcknowledgement
MsgAcknowledgement receives incoming IBC acknowledgement
Field | Type | Label | Description |
---|---|---|---|
packet | Packet | ||
acknowledgement | bytes | ||
proof_acked | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
signer | string |
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 | string | ||
channel_id | string | ||
proof_init | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
signer | string |
MsgChannelCloseConfirmResponse
MsgChannelCloseConfirmResponse defines the Msg/ChannelCloseConfirm response type.
MsgChannelCloseInit
MsgChannelCloseInit defines a msg sent by a Relayer to Chain A to close a channel with Chain B.
Field | Type | Label | Description |
---|---|---|---|
port_id | string | ||
channel_id | string | ||
signer | string |
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 | string | ||
channel_id | string | ||
counterparty_channel_id | string | ||
counterparty_version | string | ||
proof_try | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
signer | string |
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 | string | ||
channel_id | string | ||
proof_ack | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
signer | string |
MsgChannelOpenConfirmResponse
MsgChannelOpenConfirmResponse defines the Msg/ChannelOpenConfirm response type.
MsgChannelOpenInit
MsgChannelOpenInit defines an sdk.Msg to initialize a channel handshake. It is called by a relayer on Chain A.
Field | Type | Label | Description |
---|---|---|---|
port_id | string | ||
channel | Channel | ||
signer | string |
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 | string | ||
previous_channel_id | string | in the case of crossing hello's, when both chains call OpenInit, we need the channel identifier of the previous channel in state INIT | |
channel | Channel | ||
counterparty_version | string | ||
proof_init | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
signer | string |
MsgChannelOpenTryResponse
MsgChannelOpenTryResponse defines the Msg/ChannelOpenTry response type.
MsgRecvPacket
MsgRecvPacket receives incoming IBC packet
Field | Type | Label | Description |
---|---|---|---|
packet | Packet | ||
proof_commitment | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
signer | string |
MsgRecvPacketResponse
MsgRecvPacketResponse defines the Msg/RecvPacket response type.
MsgTimeout
MsgTimeout receives timed-out packet
Field | Type | Label | Description |
---|---|---|---|
packet | Packet | ||
proof_unreceived | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
next_sequence_recv | uint64 | ||
signer | string |
MsgTimeoutOnClose
MsgTimeoutOnClose timed-out packet upon counterparty channel closure.
Field | Type | Label | Description |
---|---|---|---|
packet | Packet | ||
proof_unreceived | bytes | ||
proof_close | bytes | ||
proof_height | ibc.core.client.v1.Height | ||
next_sequence_recv | uint64 | ||
signer | string |
MsgTimeoutOnCloseResponse
MsgTimeoutOnCloseResponse defines the Msg/TimeoutOnClose response type.
MsgTimeoutResponse
MsgTimeoutResponse defines the Msg/Timeout response type.
Msg
Msg defines the ibc/channel Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
ChannelOpenInit | MsgChannelOpenInit | MsgChannelOpenInitResponse | ChannelOpenInit defines a rpc handler method for MsgChannelOpenInit. | ||
ChannelOpenTry | MsgChannelOpenTry | MsgChannelOpenTryResponse | ChannelOpenTry defines a rpc handler method for MsgChannelOpenTry. | ||
ChannelOpenAck | MsgChannelOpenAck | MsgChannelOpenAckResponse | ChannelOpenAck defines a rpc handler method for MsgChannelOpenAck. | ||
ChannelOpenConfirm | MsgChannelOpenConfirm | MsgChannelOpenConfirmResponse | ChannelOpenConfirm defines a rpc handler method for MsgChannelOpenConfirm. | ||
ChannelCloseInit | MsgChannelCloseInit | MsgChannelCloseInitResponse | ChannelCloseInit defines a rpc handler method for MsgChannelCloseInit. | ||
ChannelCloseConfirm | MsgChannelCloseConfirm | MsgChannelCloseConfirmResponse | ChannelCloseConfirm defines a rpc handler method for MsgChannelCloseConfirm. | ||
RecvPacket | MsgRecvPacket | MsgRecvPacketResponse | RecvPacket defines a rpc handler method for MsgRecvPacket. | ||
Timeout | MsgTimeout | MsgTimeoutResponse | Timeout defines a rpc handler method for MsgTimeout. | ||
TimeoutOnClose | MsgTimeoutOnClose | MsgTimeoutOnCloseResponse | TimeoutOnClose defines a rpc handler method for MsgTimeoutOnClose. | ||
Acknowledgement | MsgAcknowledgement | MsgAcknowledgementResponse | Acknowledgement defines a rpc handler method for MsgAcknowledgement. |
ibc/core/client/v1/genesis.proto
GenesisMetadata
GenesisMetadata defines the genesis type for metadata that clients may return with ExportMetadata
Field | Type | Label | Description |
---|---|---|---|
key | bytes | store key of metadata without clientID-prefix | |
value | bytes | metadata value |
GenesisState
GenesisState defines the ibc client submodule's genesis state.
Field | Type | Label | Description |
---|---|---|---|
clients | IdentifiedClientState | repeated | client states with their corresponding identifiers |
clients_consensus | ClientConsensusStates | repeated | consensus states from each client |
clients_metadata | IdentifiedGenesisMetadata | repeated | metadata from each client |
params | Params | ||
create_localhost | bool | create localhost on initialization | |
next_client_sequence | uint64 | the sequence for the next generated client identifier |
IdentifiedGenesisMetadata
IdentifiedGenesisMetadata has the client metadata with the corresponding client id.
Field | Type | Label | Description |
---|---|---|---|
client_id | string | ||
client_metadata | GenesisMetadata | repeated |
ibc/core/client/v1/query.proto
QueryClientParamsRequest
QueryClientParamsRequest is the request type for the Query/ClientParams RPC method.
QueryClientParamsResponse
QueryClientParamsResponse is the response type for the Query/ClientParams RPC method.
Field | Type | Label | Description |
---|---|---|---|
params | Params | params defines the parameters of the module. |
QueryClientStateRequest
QueryClientStateRequest is the request type for the Query/ClientState RPC method
Field | Type | Label | Description |
---|---|---|---|
client_id | string | 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 | google.protobuf.Any | client state associated with the request identifier | |
proof | bytes | merkle proof of existence | |
proof_height | 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 | cosmos.base.query.v1beta1.PageRequest | pagination request |
QueryClientStatesResponse
QueryClientStatesResponse is the response type for the Query/ClientStates RPC method.
Field | Type | Label | Description |
---|---|---|---|
client_states | IdentifiedClientState | repeated | list of stored ClientStates of the chain. |
pagination | cosmos.base.query.v1beta1.PageResponse | 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 | string | client identifier | |
revision_number | uint64 | consensus state revision number | |
revision_height | uint64 | consensus state revision height | |
latest_height | bool | 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 | google.protobuf.Any | consensus state associated with the client identifier at the given height | |
proof | bytes | merkle proof of existence | |
proof_height | 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 | string | client identifier | |
pagination | cosmos.base.query.v1beta1.PageRequest | pagination request |
QueryConsensusStatesResponse
QueryConsensusStatesResponse is the response type for the Query/ConsensusStates RPC method
Field | Type | Label | Description |
---|---|---|---|
consensus_states | ConsensusStateWithHeight | repeated | consensus states associated with the identifier |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination response |
Query
Query provides defines the gRPC querier service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
ClientState | QueryClientStateRequest | QueryClientStateResponse | ClientState queries an IBC light client. | GET | /ibc/core/client/v1beta1/client_states/{client_id} |
ClientStates | QueryClientStatesRequest | QueryClientStatesResponse | ClientStates queries all the IBC light clients of a chain. | GET | /ibc/core/client/v1beta1/client_states |
ConsensusState | QueryConsensusStateRequest | QueryConsensusStateResponse | ConsensusState queries a consensus state associated with a client state at a given height. | GET | /ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height} |
ConsensusStates | QueryConsensusStatesRequest | QueryConsensusStatesResponse | ConsensusStates queries all the consensus state associated with a given client. | GET | /ibc/core/client/v1beta1/consensus_states/{client_id} |
ClientParams | QueryClientParamsRequest | QueryClientParamsResponse | ClientParams queries all parameters of the ibc client. | GET | /ibc/client/v1beta1/params |
ibc/core/client/v1/tx.proto
MsgCreateClient
MsgCreateClient defines a message to create an IBC client
Field | Type | Label | Description |
---|---|---|---|
client_state | google.protobuf.Any | light client state | |
consensus_state | google.protobuf.Any | consensus state associated with the client that corresponds to a given height. | |
signer | string | 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 | string | client unique identifier | |
misbehaviour | google.protobuf.Any | misbehaviour used for freezing the light client | |
signer | string | 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 | string | client unique identifier | |
header | google.protobuf.Any | header to update the light client | |
signer | string | 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 | string | client unique identifier | |
client_state | google.protobuf.Any | upgraded client state | |
consensus_state | google.protobuf.Any | upgraded consensus state, only contains enough information to serve as a basis of trust in update logic | |
proof_upgrade_client | bytes | proof that old chain committed to new client | |
proof_upgrade_consensus_state | bytes | proof that old chain committed to new consensus state | |
signer | string | 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 | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreateClient | MsgCreateClient | MsgCreateClientResponse | CreateClient defines a rpc handler method for MsgCreateClient. | ||
UpdateClient | MsgUpdateClient | MsgUpdateClientResponse | UpdateClient defines a rpc handler method for MsgUpdateClient. | ||
UpgradeClient | MsgUpgradeClient | MsgUpgradeClientResponse | UpgradeClient defines a rpc handler method for MsgUpgradeClient. | ||
SubmitMisbehaviour | MsgSubmitMisbehaviour | MsgSubmitMisbehaviourResponse | SubmitMisbehaviour defines a rpc handler method for MsgSubmitMisbehaviour. |
ibc/core/commitment/v1/commitment.proto
MerklePath
MerklePath is the path used to verify commitment proofs, which can be an arbitrary structured object (defined by a commitment type). MerklePath is represented from root-to-leaf
Field | Type | Label | Description |
---|---|---|---|
key_path | string | repeated |
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 | bytes |
MerkleProof
MerkleProof is a wrapper type over a chain of CommitmentProofs. 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. MerkleProofs are ordered from leaf-to-root
Field | Type | Label | Description |
---|---|---|---|
proofs | ics23.CommitmentProof | repeated |
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 | bytes |
ibc/core/connection/v1/connection.proto
ClientPaths
ClientPaths define all the connection paths for a client state.
Field | Type | Label | Description |
---|---|---|---|
paths | string | 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 | string | client associated with this connection. | |
versions | Version | repeated | IBC version which can be utilised to determine encodings or protocols for channels or packets utilising this connection. |
state | State | current state of the connection end. | |
counterparty | Counterparty | counterparty chain associated with this connection. | |
delay_period | uint64 | delay period that must pass before a consensus state can be used for packet-verification NOTE: delay period logic is only implemented by some clients. |
ConnectionPaths
ConnectionPaths define all the connection paths for a given client state.
Field | Type | Label | Description |
---|---|---|---|
client_id | string | client state unique identifier | |
paths | string | repeated | list of connection paths |
Counterparty
Counterparty defines the counterparty chain associated with a connection end.
Field | Type | Label | Description |
---|---|---|---|
client_id | string | identifies the client on the counterparty chain associated with a given connection. | |
connection_id | string | identifies the connection end on the counterparty chain associated with a given connection. | |
prefix | ibc.core.commitment.v1.MerklePrefix | commitment merkle prefix of the counterparty chain. |
IdentifiedConnection
IdentifiedConnection defines a connection with additional connection identifier field.
Field | Type | Label | Description |
---|---|---|---|
id | string | connection identifier. | |
client_id | string | client associated with this connection. | |
versions | Version | repeated | IBC version which can be utilised to determine encodings or protocols for channels or packets utilising this connection |
state | State | current state of the connection end. | |
counterparty | Counterparty | counterparty chain associated with this connection. | |
delay_period | uint64 | delay period associated with this connection. |
Version
Version defines the versioning scheme used to negotiate the IBC verison in the connection handshake.
Field | Type | Label | Description |
---|---|---|---|
identifier | string | unique version identifier | |
features | string | 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. |
ibc/core/connection/v1/genesis.proto
GenesisState
GenesisState defines the ibc connection submodule's genesis state.
Field | Type | Label | Description |
---|---|---|---|
connections | IdentifiedConnection | repeated | |
client_connection_paths | ConnectionPaths | repeated | |
next_connection_sequence | uint64 | the sequence for the next generated connection identifier |
ibc/core/connection/v1/query.proto
QueryClientConnectionsRequest
QueryClientConnectionsRequest is the request type for the Query/ClientConnections RPC method
Field | Type | Label | Description |
---|---|---|---|
client_id | string | client identifier associated with a connection |
QueryClientConnectionsResponse
QueryClientConnectionsResponse is the response type for the Query/ClientConnections RPC method
Field | Type | Label | Description |
---|---|---|---|
connection_paths | string | repeated | slice of all the connection paths associated with a client. |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | connection identifier |
QueryConnectionClientStateResponse
QueryConnectionClientStateResponse is the response type for the Query/ConnectionClientState RPC method
Field | Type | Label | Description |
---|---|---|---|
identified_client_state | ibc.core.client.v1.IdentifiedClientState | client state associated with the channel | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | connection identifier | |
revision_number | uint64 | ||
revision_height | uint64 |
QueryConnectionConsensusStateResponse
QueryConnectionConsensusStateResponse is the response type for the Query/ConnectionConsensusState RPC method
Field | Type | Label | Description |
---|---|---|---|
consensus_state | google.protobuf.Any | consensus state associated with the channel | |
client_id | string | client ID associated with the consensus state | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | string | connection unique identifier |
QueryConnectionResponse
QueryConnectionResponse is the response type for the Query/Connection RPC method. Besides the connection end, it includes a proof and the height from which the proof was retrieved.
Field | Type | Label | Description |
---|---|---|---|
connection | ConnectionEnd | connection associated with the request identifier | |
proof | bytes | merkle proof of existence | |
proof_height | ibc.core.client.v1.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 | cosmos.base.query.v1beta1.PageRequest |
QueryConnectionsResponse
QueryConnectionsResponse is the response type for the Query/Connections RPC method.
Field | Type | Label | Description |
---|---|---|---|
connections | IdentifiedConnection | repeated | list of stored connections of the chain. |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination response | |
height | ibc.core.client.v1.Height | query block height |
Query
Query provides defines the gRPC querier service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Connection | QueryConnectionRequest | QueryConnectionResponse | Connection queries an IBC connection end. | GET | /ibc/core/connection/v1beta1/connections/{connection_id} |
Connections | QueryConnectionsRequest | QueryConnectionsResponse | Connections queries all the IBC connections of a chain. | GET | /ibc/core/connection/v1beta1/connections |
ClientConnections | QueryClientConnectionsRequest | QueryClientConnectionsResponse | ClientConnections queries the connection paths associated with a client state. | GET | /ibc/core/connection/v1beta1/client_connections/{client_id} |
ConnectionClientState | QueryConnectionClientStateRequest | QueryConnectionClientStateResponse | ConnectionClientState queries the client state associated with the connection. | GET | /ibc/core/connection/v1beta1/connections/{connection_id}/client_state |
ConnectionConsensusState | QueryConnectionConsensusStateRequest | QueryConnectionConsensusStateResponse | ConnectionConsensusState queries the consensus state associated with the connection. | GET | /ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height} |
ibc/core/connection/v1/tx.proto
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 | string | ||
counterparty_connection_id | string | ||
version | Version | ||
client_state | google.protobuf.Any | ||
proof_height | ibc.core.client.v1.Height | ||
proof_try | bytes | proof of the initialization the connection on Chain B: UNITIALIZED -> TRYOPEN | |
proof_client | bytes | proof of client state included in message | |
proof_consensus | bytes | proof of client consensus state | |
consensus_height | ibc.core.client.v1.Height | ||
signer | string |
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 | string | ||
proof_ack | bytes | proof for the change of the connection state on Chain A: INIT -> OPEN | |
proof_height | ibc.core.client.v1.Height | ||
signer | string |
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 | string | ||
counterparty | Counterparty | ||
version | Version | ||
delay_period | uint64 | ||
signer | string |
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 | string | ||
previous_connection_id | string | in the case of crossing hello's, when both chains call OpenInit, we need the connection identifier of the previous connection in state INIT | |
client_state | google.protobuf.Any | ||
counterparty | Counterparty | ||
delay_period | uint64 | ||
counterparty_versions | Version | repeated | |
proof_height | ibc.core.client.v1.Height | ||
proof_init | bytes | proof of the initialization the connection on Chain A: UNITIALIZED -> INIT | |
proof_client | bytes | proof of client state included in message | |
proof_consensus | bytes | proof of client consensus state | |
consensus_height | ibc.core.client.v1.Height | ||
signer | string |
MsgConnectionOpenTryResponse
MsgConnectionOpenTryResponse defines the Msg/ConnectionOpenTry response type.
Msg
Msg defines the ibc/connection Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
ConnectionOpenInit | MsgConnectionOpenInit | MsgConnectionOpenInitResponse | ConnectionOpenInit defines a rpc handler method for MsgConnectionOpenInit. | ||
ConnectionOpenTry | MsgConnectionOpenTry | MsgConnectionOpenTryResponse | ConnectionOpenTry defines a rpc handler method for MsgConnectionOpenTry. | ||
ConnectionOpenAck | MsgConnectionOpenAck | MsgConnectionOpenAckResponse | ConnectionOpenAck defines a rpc handler method for MsgConnectionOpenAck. | ||
ConnectionOpenConfirm | MsgConnectionOpenConfirm | MsgConnectionOpenConfirmResponse | ConnectionOpenConfirm defines a rpc handler method for MsgConnectionOpenConfirm. |
ibc/core/types/v1/genesis.proto
GenesisState
GenesisState defines the ibc module's genesis state.
Field | Type | Label | Description |
---|---|---|---|
client_genesis | ibc.core.client.v1.GenesisState | ICS002 - Clients genesis state | |
connection_genesis | ibc.core.connection.v1.GenesisState | ICS003 - Connections genesis state | |
channel_genesis | ibc.core.channel.v1.GenesisState | ICS004 - Channel genesis state |
ibc/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 | string | self chain ID | |
height | ibc.core.client.v1.Height | self latest block height |
ibc/lightclients/solomachine/v1/solomachine.proto
ChannelStateData
ChannelStateData returns the SignBytes data for channel state verification.
Field | Type | Label | Description |
---|---|---|---|
path | bytes | ||
channel | ibc.core.channel.v1.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 | uint64 | latest sequence of the client state | |
frozen_sequence | uint64 | frozen sequence of the solo machine | |
consensus_state | ConsensusState | ||
allow_update_after_proposal | bool | 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 | bytes | ||
client_state | google.protobuf.Any |
ConnectionStateData
ConnectionStateData returns the SignBytes data for connection state verification.
Field | Type | Label | Description |
---|---|---|---|
path | bytes | ||
connection | ibc.core.connection.v1.ConnectionEnd |
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 | google.protobuf.Any | public key of the solo machine | |
diversifier | string | diversifier allows the same public key to be re-used across different solo machine clients (potentially on different chains) without being considered misbehaviour. | |
timestamp | uint64 |
ConsensusStateData
ConsensusStateData returns the SignBytes data for consensus state verification.
Field | Type | Label | Description |
---|---|---|---|
path | bytes | ||
consensus_state | google.protobuf.Any |
Header
Header defines a solo machine consensus header
Field | Type | Label | Description |
---|---|---|---|
sequence | uint64 | sequence to update solo machine public key at | |
timestamp | uint64 | ||
signature | bytes | ||
new_public_key | google.protobuf.Any | ||
new_diversifier | string |
HeaderData
HeaderData returns the SignBytes data for update verification.
Field | Type | Label | Description |
---|---|---|---|
new_pub_key | google.protobuf.Any | header public key | |
new_diversifier | string | 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 | string | ||
sequence | uint64 | ||
signature_one | SignatureAndData | ||
signature_two | SignatureAndData |
NextSequenceRecvData
NextSequenceRecvData returns the SignBytes data for verification of the next sequence to be received.
Field | Type | Label | Description |
---|---|---|---|
path | bytes | ||
next_seq_recv | uint64 |
PacketAcknowledgementData
PacketAcknowledgementData returns the SignBytes data for acknowledgement verification.
Field | Type | Label | Description |
---|---|---|---|
path | bytes | ||
acknowledgement | bytes |
PacketCommitmentData
PacketCommitmentData returns the SignBytes data for packet commitment verification.
Field | Type | Label | Description |
---|---|---|---|
path | bytes | ||
commitment | bytes |
PacketReceiptAbsenceData
PacketReceiptAbsenceData returns the SignBytes data for packet receipt absence verification.
Field | Type | Label | Description |
---|---|---|---|
path | bytes |
SignBytes
SignBytes defines the signed bytes used for signature verification.
Field | Type | Label | Description |
---|---|---|---|
sequence | uint64 | ||
timestamp | uint64 | ||
diversifier | string | ||
data_type | DataType | type of the data used | |
data | bytes | marshaled data |
SignatureAndData
SignatureAndData contains a signature and the data signed over to create that signature.
Field | Type | Label | Description |
---|---|---|---|
signature | bytes | ||
data_type | DataType | ||
data | bytes | ||
timestamp | uint64 |
TimestampedSignatureData
TimestampedSignatureData contains the signature data and the timestamp of the signature.
Field | Type | Label | Description |
---|---|---|---|
signature_data | bytes | ||
timestamp | uint64 |
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 | string | ||
trust_level | Fraction | ||
trusting_period | google.protobuf.Duration | duration of the period since the LastestTimestamp during which the submitted headers are valid for upgrade | |
unbonding_period | google.protobuf.Duration | duration of the staking unbonding period | |
max_clock_drift | google.protobuf.Duration | defines how much new (untrusted) header's Time can drift into the future. | |
frozen_height | ibc.core.client.v1.Height | Block height when the client was frozen due to a misbehaviour | |
latest_height | ibc.core.client.v1.Height | Latest height the client was updated to | |
proof_specs | ics23.ProofSpec | repeated | Proof specifications used in verifying counterparty state |
upgrade_path | string | repeated | Path at which next upgraded client will be committed. Each element corresponds to the key for a single CommitmentProof in the chained proof. NOTE: ClientState must stored under {upgradePath}/{upgradeHeight}/clientState ConsensusState must be stored under {upgradepath}/{upgradeHeight}/consensusState For SDK chains using the default upgrade module, upgrade_path should be []string{"upgrade", "upgradedIBCState"}` |
allow_update_after_expiry | bool | This flag, when set to true, will allow governance to recover a client which has expired | |
allow_update_after_misbehaviour | bool | 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 | google.protobuf.Timestamp | timestamp that corresponds to the block height in which the ConsensusState was stored. | |
root | ibc.core.commitment.v1.MerkleRoot | commitment root (i.e app hash) | |
next_validators_hash | bytes |
Fraction
Fraction defines the protobuf message type for tmmath.Fraction that only supports positive values.
Field | Type | Label | Description |
---|---|---|---|
numerator | uint64 | ||
denominator | uint64 |
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 | tendermint.types.SignedHeader | ||
validator_set | tendermint.types.ValidatorSet | ||
trusted_height | ibc.core.client.v1.Height | ||
trusted_validators | tendermint.types.ValidatorSet |
Misbehaviour
Misbehaviour is a wrapper over two conflicting Headers that implements Misbehaviour interface expected by ICS-02
Field | Type | Label | Description |
---|---|---|---|
client_id | string | ||
header_1 | Header | ||
header_2 | Header |
mint/mint.proto
Minter
Minter represents the minting state
Field | Type | Label | Description |
---|---|---|---|
last_update | google.protobuf.Timestamp | time which the last update was made to the minter | |
inflation_base | string | base inflation |
Params
Params defines mint module's parameters
Field | Type | Label | Description |
---|---|---|---|
mint_denom | string | type of coin to mint | |
inflation | string | inflation rate |
mint/genesis.proto
GenesisState
GenesisState defines the mint module's genesis state
Field | Type | Label | Description |
---|---|---|---|
minter | Minter | ||
params | Params |
mint/query.proto
QueryParamsRequest
QueryParamsRequest is request type for the Query/Parameters RPC method
QueryParamsResponse
QueryParamsResponse is response type for the Query/Parameters RPC method
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
res | cosmos.base.query.v1beta1.PageResponse |
Query
Query creates service with guardian as rpc
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Params | QueryParamsRequest | QueryParamsResponse | Params queries the mint parameters | GET | /irishub/mint/params |
nft/nft.proto
BaseNFT
BaseNFT defines a non-fungible token
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
name | string | ||
uri | string | ||
data | string | ||
owner | string |
Collection
Collection defines a type of collection
Field | Type | Label | Description |
---|---|---|---|
denom | Denom | ||
nfts | BaseNFT | repeated |
Denom
Denom defines a type of NFT
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
name | string | ||
schema | string | ||
creator | string | ||
symbol | string | ||
mint_restricted | bool | ||
update_restricted | bool |
IDCollection
IDCollection defines a type of collection with specified ID
Field | Type | Label | Description |
---|---|---|---|
denom_id | string | ||
token_ids | string | repeated |
Owner
Owner defines a type of owner
Field | Type | Label | Description |
---|---|---|---|
address | string | ||
id_collections | IDCollection | repeated |
nft/genesis.proto
GenesisState
GenesisState defines the NFT module's genesis state
Field | Type | Label | Description |
---|---|---|---|
collections | Collection | repeated |
nft/query.proto
QueryCollectionRequest
QueryCollectionRequest is the request type for the Query/Collection RPC method
Field | Type | Label | Description |
---|---|---|---|
denom_id | string | ||
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryCollectionResponse
QueryCollectionResponse is the response type for the Query/Collection RPC method
Field | Type | Label | Description |
---|---|---|---|
collection | Collection | ||
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryDenomRequest
QueryDenomRequest is the request type for the Query/Denom RPC method
Field | Type | Label | Description |
---|---|---|---|
denom_id | string |
QueryDenomResponse
QueryDenomResponse is the response type for the Query/Denom RPC method
Field | Type | Label | Description |
---|---|---|---|
denom | Denom |
QueryDenomsRequest
QueryDenomsRequest is the request type for the Query/Denoms RPC method
Field | Type | Label | Description |
---|---|---|---|
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryDenomsResponse
QueryDenomsResponse is the response type for the Query/Denoms RPC method
Field | Type | Label | Description |
---|---|---|---|
denoms | Denom | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryNFTRequest
QueryNFTRequest is the request type for the Query/NFT RPC method
Field | Type | Label | Description |
---|---|---|---|
denom_id | string | ||
token_id | string |
QueryNFTResponse
QueryNFTResponse is the response type for the Query/NFT RPC method
Field | Type | Label | Description |
---|---|---|---|
nft | BaseNFT |
QueryOwnerRequest
QueryOwnerRequest is the request type for the Query/Owner RPC method
Field | Type | Label | Description |
---|---|---|---|
denom_id | string | ||
owner | string | ||
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryOwnerResponse
QueryOwnerResponse is the response type for the Query/Owner RPC method
Field | Type | Label | Description |
---|---|---|---|
owner | Owner | ||
pagination | cosmos.base.query.v1beta1.PageResponse |
QuerySupplyRequest
QuerySupplyRequest is the request type for the Query/HTLC RPC method
Field | Type | Label | Description |
---|---|---|---|
denom_id | string | ||
owner | string |
QuerySupplyResponse
QuerySupplyResponse is the response type for the Query/Supply RPC method
Field | Type | Label | Description |
---|---|---|---|
amount | uint64 |
Query
Query defines the gRPC querier service for NFT module
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Supply | QuerySupplyRequest | QuerySupplyResponse | Supply queries the total supply of a given denom or owner | GET | /irismod/nft/collections/{denom_id}/supply |
Owner | QueryOwnerRequest | QueryOwnerResponse | Owner queries the NFTs of the specified owner | GET | /irismod/nft/nfts |
Collection | QueryCollectionRequest | QueryCollectionResponse | Collection queries the NFTs of the specified denom | GET | /irismod/nft/collections/{denom_id} |
Denom | QueryDenomRequest | QueryDenomResponse | Denom queries the definition of a given denom | GET | /irismod/nft/denoms/{denom_id} |
Denoms | QueryDenomsRequest | QueryDenomsResponse | Denoms queries all the denoms | GET | /irismod/nft/denoms |
NFT | QueryNFTRequest | QueryNFTResponse | NFT queries the NFT for the given denom and token ID | GET | /irismod/nft/nfts/{denom_id}/{token_id} |
nft/tx.proto
MsgBurnNFT
MsgBurnNFT defines an SDK message for burning a NFT.
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
denom_id | string | ||
sender | string |
MsgBurnNFTResponse
MsgBurnNFTResponse defines the Msg/BurnNFT response type.
MsgEditNFT
MsgEditNFT defines an SDK message for editing a nft.
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
denom_id | string | ||
name | string | ||
uri | string | ||
data | string | ||
sender | string |
MsgEditNFTResponse
MsgEditNFTResponse defines the Msg/EditNFT response type.
MsgIssueDenom
MsgIssueDenom defines an SDK message for creating a new denom.
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
name | string | ||
schema | string | ||
sender | string | ||
symbol | string | ||
mint_restricted | bool | ||
update_restricted | bool |
MsgIssueDenomResponse
MsgIssueDenomResponse defines the Msg/IssueDenom response type.
MsgMintNFT
MsgMintNFT defines an SDK message for creating a new NFT.
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
denom_id | string | ||
name | string | ||
uri | string | ||
data | string | ||
sender | string | ||
recipient | string |
MsgMintNFTResponse
MsgMintNFTResponse defines the Msg/MintNFT response type.
MsgTransferDenom
MsgTransferDenom defines an SDK message for transferring an denom to recipient.
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
sender | string | ||
recipient | string |
MsgTransferDenomResponse
MsgTransferDenomResponse defines the Msg/TransferDenom response type.
MsgTransferNFT
MsgTransferNFT defines an SDK message for transferring an NFT to recipient.
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
denom_id | string | ||
name | string | ||
uri | string | ||
data | string | ||
sender | string | ||
recipient | string |
MsgTransferNFTResponse
MsgTransferNFTResponse defines the Msg/TransferNFT response type.
Msg
Msg defines the nft Msg service.
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
IssueDenom | MsgIssueDenom | MsgIssueDenomResponse | IssueDenom defines a method for issue a denom. | ||
MintNFT | MsgMintNFT | MsgMintNFTResponse | MintNFT defines a method for mint a new nft | ||
EditNFT | MsgEditNFT | MsgEditNFTResponse | RefundHTLC defines a method for editing a nft. | ||
TransferNFT | MsgTransferNFT | MsgTransferNFTResponse | TransferNFT defines a method for transferring a nft. | ||
BurnNFT | MsgBurnNFT | MsgBurnNFTResponse | BurnNFT defines a method for burning a nft. | ||
TransferDenom | MsgTransferDenom | MsgTransferDenomResponse | TransferDenom defines a method for transferring a denom. |
oracle/oracle.proto
Feed
Feed defines the feed standard
Field | Type | Label | Description |
---|---|---|---|
feed_name | string | ||
description | string | ||
aggregate_func | string | ||
value_json_path | string | ||
latest_history | uint64 | ||
request_context_id | string | ||
creator | string |
FeedValue
FeedValue defines the feed result standard
Field | Type | Label | Description |
---|---|---|---|
data | string | ||
timestamp | google.protobuf.Timestamp |
service/service.proto
CompactRequest
CompactRequest defines a standard for compact request
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
request_context_batch_counter | uint64 | ||
provider | string | ||
service_fee | cosmos.base.v1beta1.Coin | repeated | |
request_height | int64 | ||
expiration_height | int64 |
Params
Params defines service module's parameters
Field | Type | Label | Description |
---|---|---|---|
max_request_timeout | int64 | ||
min_deposit_multiple | int64 | ||
min_deposit | cosmos.base.v1beta1.Coin | repeated | |
service_fee_tax | string | ||
slash_fraction | string | ||
complaint_retrospect | google.protobuf.Duration | ||
arbitration_time_limit | google.protobuf.Duration | ||
tx_size_limit | uint64 | ||
base_denom | string | ||
restricted_service_fee_denom | bool |
Pricing
Pricing defines a standard for service pricing
Field | Type | Label | Description |
---|---|---|---|
price | cosmos.base.v1beta1.Coin | repeated | |
promotions_by_time | PromotionByTime | repeated | |
promotions_by_volume | PromotionByVolume | repeated |
PromotionByTime
PromotionByTime defines a standard for service promotion by time
Field | Type | Label | Description |
---|---|---|---|
start_time | google.protobuf.Timestamp | ||
end_time | google.protobuf.Timestamp | ||
discount | string |
PromotionByVolume
PromotionByVolume defines a standard for service promotion by volume
Field | Type | Label | Description |
---|---|---|---|
volume | uint64 | ||
discount | string |
Request
Request defines a standard for request
Field | Type | Label | Description |
---|---|---|---|
id | string | ||
service_name | string | ||
provider | string | ||
consumer | string | ||
input | string | ||
service_fee | cosmos.base.v1beta1.Coin | repeated | |
request_height | int64 | ||
expiration_height | int64 | ||
request_context_id | string | ||
request_context_batch_counter | uint64 |
RequestContext
RequestContext defines a standard for request context
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
providers | string | repeated | |
consumer | string | ||
input | string | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
module_name | string | ||
timeout | int64 | ||
repeated | bool | ||
repeated_frequency | uint64 | ||
repeated_total | int64 | ||
batch_counter | uint64 | ||
batch_request_count | uint32 | ||
batch_response_count | uint32 | ||
batch_response_threshold | uint32 | ||
response_threshold | uint32 | ||
batch_state | RequestContextBatchState | ||
state | RequestContextState |
Response
Response defines a standard for response
Field | Type | Label | Description |
---|---|---|---|
provider | string | ||
consumer | string | ||
result | string | ||
output | string | ||
request_context_id | string | ||
request_context_batch_counter | uint64 |
ServiceBinding
ServiceBinding defines a standard for service binding
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
deposit | cosmos.base.v1beta1.Coin | repeated | |
pricing | string | ||
qos | uint64 | ||
options | string | ||
available | bool | ||
disabled_time | google.protobuf.Timestamp | ||
owner | string |
ServiceDefinition
ServiceDefinition defines a standard for service definition
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
description | string | ||
tags | string | repeated | |
author | string | ||
author_description | string | ||
schemas | string |
RequestContextBatchState
RequestContextBatchState is a type alias that represents a request batch status as a byte
Name | Number | Description |
---|---|---|
BATCH_RUNNING | 0 | BATCH_RUNNING defines the running batch status. |
BATCH_COMPLETED | 1 | BATCH_COMPLETED defines the completed batch status. |
RequestContextState
RequestContextState is a type alias that represents a request status as a byte
Name | Number | Description |
---|---|---|
RUNNING | 0 | RUNNING defines the running request context status |
PAUSED | 1 | PAUSED defines the paused request context status |
COMPLETED | 2 | COMPLETED defines the completed request context status |
oracle/genesis.proto
FeedEntry
Field | Type | Label | Description |
---|---|---|---|
feed | Feed | ||
state | irismod.service.RequestContextState | ||
values | FeedValue | repeated |
GenesisState
GenesisState defines the oracle module's genesis state
Field | Type | Label | Description |
---|---|---|---|
entries | FeedEntry | repeated |
oracle/query.proto
FeedContext
FeedContext defines the feed context struct
Field | Type | Label | Description |
---|---|---|---|
feed | Feed | ||
service_name | string | ||
providers | string | repeated | |
input | string | ||
timeout | int64 | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
repeated_frequency | uint64 | ||
response_threshold | uint32 | ||
state | irismod.service.RequestContextState |
QueryFeedRequest
QueryFeedRequest is request type for the Query/Feed RPC method
Field | Type | Label | Description |
---|---|---|---|
feed_name | string |
QueryFeedResponse
QueryFeedResponse is response type for the Query/Feed RPC method
Field | Type | Label | Description |
---|---|---|---|
feed | FeedContext |
QueryFeedValueRequest
QueryFeedValueRequest is request type for the Query/FeedValue RPC method
Field | Type | Label | Description |
---|---|---|---|
feed_name | string |
QueryFeedValueResponse
QueryFeedValueResponse is response type for the Query/FeedValue RPC method
Field | Type | Label | Description |
---|---|---|---|
feed_values | FeedValue | repeated |
QueryFeedsRequest
QueryFeedsRequest is request type for the Query/Feeds RPC method
Field | Type | Label | Description |
---|---|---|---|
state | string | ||
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request |
QueryFeedsResponse
QueryFeedsResponse is response type for the Query/Feeds RPC method
Field | Type | Label | Description |
---|---|---|---|
feeds | FeedContext | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse | pagination defines an optional pagination for the request |
Query
Query creates service with guardian as rpc
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Feed | QueryFeedRequest | QueryFeedResponse | Feed queries the feed | GET | /irismod/oracle/feeds/{feed_name} |
Feeds | QueryFeedsRequest | QueryFeedsResponse | Feeds queries the feed list | GET | /irismod/oracle/feeds |
FeedValue | QueryFeedValueRequest | QueryFeedValueResponse | FeedValue queries the feed value | GET | /irismod/oracle/feeds/{feed_name}/values |
oracle/tx.proto
MsgCreateFeed
MsgCreateFeed defines an sdk.Msg type that supports creating a feed
Field | Type | Label | Description |
---|---|---|---|
feed_name | string | ||
latest_history | uint64 | ||
description | string | ||
creator | string | ||
service_name | string | ||
providers | string | repeated | |
input | string | ||
timeout | int64 | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
repeated_frequency | uint64 | ||
aggregate_func | string | ||
value_json_path | string | ||
response_threshold | uint32 |
MsgCreateFeedResponse
MsgCreateFeedResponse defines the Msg/CreateFeed response type
MsgEditFeed
MsgEditFeed defines an sdk.Msg type that supports editing a feed
Field | Type | Label | Description |
---|---|---|---|
feed_name | string | ||
description | string | ||
latest_history | uint64 | ||
providers | string | repeated | |
timeout | int64 | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
repeated_frequency | uint64 | ||
response_threshold | uint32 | ||
creator | string |
MsgEditFeedResponse
MsgEditFeedResponse defines the Msg/EditFeed response type
MsgPauseFeed
MsgPauseFeed defines an sdk.Msg type that supports pausing a feed
Field | Type | Label | Description |
---|---|---|---|
feed_name | string | ||
creator | string |
MsgPauseFeedResponse
MsgPauseFeedResponse defines the Msg/PauseFeed response type
MsgStartFeed
MsgPauseFeed defines an sdk.Msg type that supports stating a feed
Field | Type | Label | Description |
---|---|---|---|
feed_name | string | ||
creator | string |
MsgStartFeedResponse
MsgStartFeedResponse defines the Msg/StartFeed response type
Msg
Msg defines the oracle Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreateFeed | MsgCreateFeed | MsgCreateFeedResponse | CreateFeed defines a method for creating a new feed | ||
EditFeed | MsgEditFeed | MsgEditFeedResponse | EditFeed defines a method for editing a feed | ||
StartFeed | MsgStartFeed | MsgStartFeedResponse | StartFeed defines a method for starting a feed | ||
PauseFeed | MsgPauseFeed | MsgPauseFeedResponse | PauseFeed defines a method for pausing a feed |
random/random.proto
Random
Random defines the feed standard
Field | Type | Label | Description |
---|---|---|---|
request_tx_hash | string | ||
height | int64 | ||
value | string |
Request
Request defines the random request standard
Field | Type | Label | Description |
---|---|---|---|
height | int64 | ||
consumer | string | ||
tx_hash | string | ||
oracle | bool | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
service_context_id | string |
random/genesis.proto
GenesisState
GenesisState defines the random module's genesis state
Field | Type | Label | Description |
---|---|---|---|
pending_random_requests | GenesisState.PendingRandomRequestsEntry | repeated |
GenesisState.PendingRandomRequestsEntry
Field | Type | Label | Description |
---|---|---|---|
key | string | ||
value | Requests |
Requests
Requests defines the random requests
Field | Type | Label | Description |
---|---|---|---|
requests | Request | repeated |
random/query.proto
QueryRandomRequest
QueryRandomRequest is request type for the Query/Random RPC method
Field | Type | Label | Description |
---|---|---|---|
req_id | string |
QueryRandomRequestQueueRequest
QueryRandomRequestQueueRequest is request type for the Query/RandomRequestQueue RPC method
Field | Type | Label | Description |
---|---|---|---|
height | int64 |
QueryRandomRequestQueueResponse
QueryRandomRequestQueueResponse is response type for the Query/RandomRequestQueue RPC method
Field | Type | Label | Description |
---|---|---|---|
requests | Request | repeated |
QueryRandomResponse
QueryParametersResponse is response type for the Query/Random RPC method
Field | Type | Label | Description |
---|---|---|---|
random | Random |
Query
Query creates service with guardian as rpc
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Random | QueryRandomRequest | QueryRandomResponse | Random queries the random result | GET | /irismod/random/randoms/{req_id} |
RandomRequestQueue | QueryRandomRequestQueueRequest | QueryRandomRequestQueueResponse | RandomRequestQueue queries the random request queue | GET | /irismod/random/queue |
random/tx.proto
MsgRequestRandom
MsgRequestRandom defines an sdk.Msg type that supports requesting a random number
Field | Type | Label | Description |
---|---|---|---|
block_interval | uint64 | ||
consumer | string | ||
oracle | bool | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated |
MsgRequestRandomResponse
MsgRequestRandomResponse defines the Msg/RequestRandom response type
Msg
Msg defines the oracle Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
RequestRandom | MsgRequestRandom | MsgRequestRandomResponse | RequestRandom defines a method for requesting a new random number |
record/record.proto
Content
Content defines the detailed information for a record
Field | Type | Label | Description |
---|---|---|---|
digest | string | ||
digest_algo | string | ||
uri | string | ||
meta | string |
Record
Record defines the record standard
Field | Type | Label | Description |
---|---|---|---|
tx_hash | string | ||
contents | Content | repeated | |
creator | string |
record/genesis.proto
GenesisState
GenesisState defines the record module's genesis state
Field | Type | Label | Description |
---|---|---|---|
records | Record | repeated |
record/query.proto
QueryRecordRequest
QueryRecordRequest is the request type for the Query/Record RPC method
Field | Type | Label | Description |
---|---|---|---|
record_id | string |
QueryRecordResponse
QueryRecordResponse is the response type for the Query/Record RPC method
Field | Type | Label | Description |
---|---|---|---|
record | Record |
Query
Query defines the gRPC querier service for record module
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Record | QueryRecordRequest | QueryRecordResponse | Record queries the record by the given record ID | GET | /irismod/record/records/{record_id} |
record/tx.proto
MsgCreateRecord
MsgCreateRecord defines an SDK message for creating a new record
Field | Type | Label | Description |
---|---|---|---|
contents | Content | repeated | |
creator | string |
MsgCreateRecordResponse
MsgCreateRecordResponse defines the Msg/CreateRecord response type
Field | Type | Label | Description |
---|---|---|---|
id | string |
Msg
Msg defines the oracle Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
CreateRecord | MsgCreateRecord | MsgCreateRecordResponse | CreateRecord defines a method for creating a new record |
service/genesis.proto
GenesisState
GenesisState defines the service module's genesis state
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
definitions | ServiceDefinition | repeated | |
bindings | ServiceBinding | repeated | |
withdraw_addresses | GenesisState.WithdrawAddressesEntry | repeated | |
request_contexts | GenesisState.RequestContextsEntry | repeated |
GenesisState.RequestContextsEntry
Field | Type | Label | Description |
---|---|---|---|
key | string | ||
value | RequestContext |
GenesisState.WithdrawAddressesEntry
Field | Type | Label | Description |
---|---|---|---|
key | string | ||
value | string |
service/query.proto
QueryBindingRequest
QueryBindingRequest is request type for the Query/Binding RPC method
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string |
QueryBindingResponse
QueryDefinitionResponse is response type for the Query/Binding RPC method
Field | Type | Label | Description |
---|---|---|---|
service_binding | ServiceBinding |
QueryBindingsRequest
QueryBindingsRequest is request type for the Query/Bindings RPC method
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
owner | string | ||
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request |
QueryBindingsResponse
QueryDefinitionsResponse is response type for the Query/Bindings RPC method
Field | Type | Label | Description |
---|---|---|---|
service_bindings | ServiceBinding | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryDefinitionRequest
QueryDefinitionRequest is request type for the Query/Definition RPC method
Field | Type | Label | Description |
---|---|---|---|
service_name | string |
QueryDefinitionResponse
QueryDefinitionResponse is response type for the Query/Definition RPC method
Field | Type | Label | Description |
---|---|---|---|
service_definition | ServiceDefinition |
QueryEarnedFeesRequest
QueryEarnedFeesRequest is request type for the Query/EarnedFees RPC method
Field | Type | Label | Description |
---|---|---|---|
provider | string |
QueryEarnedFeesResponse
QueryEarnedFeesResponse is response type for the Query/EarnedFees RPC method
Field | Type | Label | Description |
---|---|---|---|
fees | cosmos.base.v1beta1.Coin | repeated |
QueryParamsRequest
QueryParametersRequest is request type for the Query/Parameters RPC method
QueryParamsResponse
QueryParametersResponse is response type for the Query/Parameters RPC method
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
res | cosmos.base.query.v1beta1.PageResponse |
QueryRequestContextRequest
QueryRequestContextRequest is request type for the Query/RequestContext RPC method
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string |
QueryRequestContextResponse
QueryRequestContextResponse is response type for the Query/RequestContext RPC method
Field | Type | Label | Description |
---|---|---|---|
request_context | RequestContext |
QueryRequestRequest
QueryRequestRequest is request type for the Query/Request RPC method
Field | Type | Label | Description |
---|---|---|---|
request_id | string |
QueryRequestResponse
QueryRequestResponse is response type for the Query/Request RPC method
Field | Type | Label | Description |
---|---|---|---|
request | Request |
QueryRequestsByReqCtxRequest
QueryRequestsByReqCtxRequest is request type for the Query/RequestsByReqCtx RPC method
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
batch_counter | uint64 | ||
pagination | cosmos.base.query.v1beta1.PageRequest |
QueryRequestsByReqCtxResponse
QueryRequestsByReqCtxResponse is response type for the Query/RequestsByReqCtx RPC method
Field | Type | Label | Description |
---|---|---|---|
requests | Request | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryRequestsRequest
QueryRequestsRequest is request type for the Query/Requests RPC method
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
pagination | cosmos.base.query.v1beta1.PageRequest |
QueryRequestsResponse
QueryRequestsResponse is response type for the Query/Requests RPC method
Field | Type | Label | Description |
---|---|---|---|
requests | Request | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryResponseRequest
QueryResponseRequest is request type for the Query/Response RPC method
Field | Type | Label | Description |
---|---|---|---|
request_id | string |
QueryResponseResponse
QueryResponseResponse is response type for the Query/Response RPC method
Field | Type | Label | Description |
---|---|---|---|
response | Response |
QueryResponsesRequest
QueryResponsesRequest is request type for the Query/Responses RPC method
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
batch_counter | uint64 | ||
pagination | cosmos.base.query.v1beta1.PageRequest |
QueryResponsesResponse
QueryResponsesResponse is response type for the Query/Responses RPC method
Field | Type | Label | Description |
---|---|---|---|
responses | Response | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QuerySchemaRequest
QuerySchemaRequest is request type for the Query/Schema RPC method
Field | Type | Label | Description |
---|---|---|---|
schema_name | string |
QuerySchemaResponse
QuerySchemaResponse is response type for the Query/Schema RPC method
Field | Type | Label | Description |
---|---|---|---|
schema | string |
QueryWithdrawAddressRequest
QueryWithdrawAddressRequest is request type for the Query/WithdrawAddress RPC method
Field | Type | Label | Description |
---|---|---|---|
owner | string |
QueryWithdrawAddressResponse
QueryWithdrawAddressResponse is response type for the Query/WithdrawAddress RPC method
Field | Type | Label | Description |
---|---|---|---|
withdraw_address | string |
Query
Query creates service with iservice as rpc
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Definition | QueryDefinitionRequest | QueryDefinitionResponse | Definition returns service definition | GET | /irismod/service/definitions/{service_name} |
Binding | QueryBindingRequest | QueryBindingResponse | Binding returns service Binding with service name and provider | GET | /irismod/service/bindings/{service_name}/{provider} |
Bindings | QueryBindingsRequest | QueryBindingsResponse | Bindings returns all service Bindings with service name and owner | GET | /irismod/service/bindings/{service_name} |
WithdrawAddress | QueryWithdrawAddressRequest | QueryWithdrawAddressResponse | WithdrawAddress returns the withdraw address of the binding owner | GET | /irismod/service/owners/{owner}/withdraw-address |
RequestContext | QueryRequestContextRequest | QueryRequestContextResponse | RequestContext returns the request context | GET | /irismod/service/contexts/{request_context_id} |
Request | QueryRequestRequest | QueryRequestResponse | Request returns the request | GET | /irismod/service/requests/{request_id} |
Requests | QueryRequestsRequest | QueryRequestsResponse | Request returns all requests of one service with provider | GET | /irismod/service/requests/{service_name}/{provider} |
RequestsByReqCtx | QueryRequestsByReqCtxRequest | QueryRequestsByReqCtxResponse | RequestsByReqCtx returns all requests of one service call batch | GET | /irismod/service/requests/{request_context_id}/{batch_counter} |
Response | QueryResponseRequest | QueryResponseResponse | Response returns the response of request | GET | /irismod/service/responses/{request_id} |
Responses | QueryResponsesRequest | QueryResponsesResponse | Responses returns all responses of one service call batch | GET | /irismod/service/responses/{request_context_id}/{batch_counter} |
EarnedFees | QueryEarnedFeesRequest | QueryEarnedFeesResponse | EarnedFees returns the earned service fee of one provider | GET | /irismod/service/fees/{provider} |
Schema | QuerySchemaRequest | QuerySchemaResponse | Schema returns the schema | GET | /irismod/service/schemas/{schema_name} |
Params | QueryParamsRequest | QueryParamsResponse | Params queries the service parameters | GET | /irismod/service/params |
service/tx.proto
MsgBindService
MsgBindService defines an SDK message for binding to an existing service
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
deposit | cosmos.base.v1beta1.Coin | repeated | |
pricing | string | ||
qos | uint64 | ||
options | string | ||
owner | string |
MsgBindServiceResponse
MsgBindServiceResponse defines the Msg/BindService response type
MsgCallService
MsgCallService defines an SDK message to initiate a service request context
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
providers | string | repeated | |
consumer | string | ||
input | string | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
timeout | int64 | ||
repeated | bool | ||
repeated_frequency | uint64 | ||
repeated_total | int64 |
MsgCallServiceResponse
MsgCallServiceResponse defines the Msg/CallService response type
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string |
MsgDefineService
MsgDefineService defines an SDK message for defining a new service
Field | Type | Label | Description |
---|---|---|---|
name | string | ||
description | string | ||
tags | string | repeated | |
author | string | ||
author_description | string | ||
schemas | string |
MsgDefineServiceResponse
MsgDefineServiceResponse defines the Msg/DefineService response type
MsgDisableServiceBinding
MsgDisableServiceBinding defines an SDK message to disable a service binding
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
owner | string |
MsgDisableServiceBindingResponse
MsgDisableServiceBindingResponse defines the Msg/DisableServiceBinding response type
MsgEnableServiceBinding
MsgEnableServiceBinding defines an SDK message to enable a service binding
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
deposit | cosmos.base.v1beta1.Coin | repeated | |
owner | string |
MsgEnableServiceBindingResponse
MsgEnableServiceBindingResponse defines the Msg/EnableServiceBinding response type
MsgKillRequestContext
MsgKillRequestContext defines an SDK message to terminate a service request
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
consumer | string |
MsgKillRequestContextResponse
MsgKillRequestContextResponse defines the Msg/KillRequestContext response type
MsgPauseRequestContext
MsgPauseRequestContext defines an SDK message to pause a service request
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
consumer | string |
MsgPauseRequestContextResponse
MsgPauseRequestContextResponse defines the Msg/PauseRequestContext response type
MsgRefundServiceDeposit
MsgRefundServiceDeposit defines an SDK message to refund deposit from a service binding
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
owner | string |
MsgRefundServiceDepositResponse
MsgRefundServiceDepositResponse defines the Msg/RefundServiceDeposit response type
MsgRespondService
MsgRespondService defines an SDK message to respond a service request
Field | Type | Label | Description |
---|---|---|---|
request_id | string | ||
provider | string | ||
result | string | ||
output | string |
MsgRespondServiceResponse
MsgRespondServiceResponse defines the Msg/RespondService response type
MsgSetWithdrawAddress
MsgSetWithdrawAddress defines an SDK message to set the withdrawal address for a provider
Field | Type | Label | Description |
---|---|---|---|
owner | string | ||
withdraw_address | string |
MsgSetWithdrawAddressResponse
MsgSetWithdrawAddressResponse defines the Msg/SetWithdrawAddress response type
MsgStartRequestContext
MsgStartRequestContext defines an SDK message to resume a service request
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
consumer | string |
MsgStartRequestContextResponse
MsgStartRequestContextResponse defines the Msg/StartRequestContext response type
MsgUpdateRequestContext
MsgUpdateRequestContext defines an SDK message to update a service request context
Field | Type | Label | Description |
---|---|---|---|
request_context_id | string | ||
providers | string | repeated | |
consumer | string | ||
service_fee_cap | cosmos.base.v1beta1.Coin | repeated | |
timeout | int64 | ||
repeated_frequency | uint64 | ||
repeated_total | int64 |
MsgUpdateRequestContextResponse
MsgUpdateRequestContextResponse defines the Msg/UpdateRequestContext response type
MsgUpdateServiceBinding
MsgUpdateServiceBinding defines an SDK message for updating an existing service binding
Field | Type | Label | Description |
---|---|---|---|
service_name | string | ||
provider | string | ||
deposit | cosmos.base.v1beta1.Coin | repeated | |
pricing | string | ||
qos | uint64 | ||
options | string | ||
owner | string |
MsgUpdateServiceBindingResponse
MsgUpdateServiceBindingResponse defines the Msg/UpdateServiceBinding response type
MsgWithdrawEarnedFees
MsgWithdrawEarnedFees defines an SDK message to withdraw the fees earned by the provider or owner
Field | Type | Label | Description |
---|---|---|---|
owner | string | ||
provider | string |
MsgWithdrawEarnedFeesResponse
MsgWithdrawEarnedFeesResponse defines the Msg/WithdrawEarnedFees response type
Msg
Msg defines the oracle Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
DefineService | MsgDefineService | MsgDefineServiceResponse | DefineService defines a method for define a new service | ||
BindService | MsgBindService | MsgBindServiceResponse | BindService defines a method for bind a server | ||
UpdateServiceBinding | MsgUpdateServiceBinding | MsgUpdateServiceBindingResponse | UpdateServiceBinding defines a method for update a service binding | ||
SetWithdrawAddress | MsgSetWithdrawAddress | MsgSetWithdrawAddressResponse | SetWithdrawAddress defines a method for setting a withdraw address | ||
EnableServiceBinding | MsgEnableServiceBinding | MsgEnableServiceBindingResponse | EnableServiceBinding defines a method for enabling a service binding | ||
DisableServiceBinding | MsgDisableServiceBinding | MsgDisableServiceBindingResponse | DisableServiceBinding defines a method for disabling a service binding | ||
RefundServiceDeposit | MsgRefundServiceDeposit | MsgRefundServiceDepositResponse | RefundServiceDeposit defines a method for refunding a fee | ||
CallService | MsgCallService | MsgCallServiceResponse | CallService defines a method for calling a service | ||
RespondService | MsgRespondService | MsgRespondServiceResponse | RespondService defines a method for responding a service | ||
PauseRequestContext | MsgPauseRequestContext | MsgPauseRequestContextResponse | PauseRequestContext defines a method for pausing a service call | ||
StartRequestContext | MsgStartRequestContext | MsgStartRequestContextResponse | StartRequestContext defines a method for starting a service call | ||
KillRequestContext | MsgKillRequestContext | MsgKillRequestContextResponse | KillRequestContext defines a method for killing a service call | ||
UpdateRequestContext | MsgUpdateRequestContext | MsgUpdateRequestContextResponse | UpdateRequestContext defines a method for updating a service call | ||
WithdrawEarnedFees | MsgWithdrawEarnedFees | MsgWithdrawEarnedFeesResponse | WithdrawEarnedFees defines a method for Withdrawing a earned fees |
token/token.proto
Params
Params defines token module's parameters
Field | Type | Label | Description |
---|---|---|---|
token_tax_rate | string | ||
issue_token_base_fee | cosmos.base.v1beta1.Coin | ||
mint_token_fee_ratio | string |
Token
Token defines a standard for the fungible token
Field | Type | Label | Description |
---|---|---|---|
symbol | string | ||
name | string | ||
scale | uint32 | ||
min_unit | string | ||
initial_supply | uint64 | ||
max_supply | uint64 | ||
mintable | bool | ||
owner | string |
token/genesis.proto
GenesisState
GenesisState defines the token module's genesis state
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
tokens | Token | repeated | |
burned_coins | cosmos.base.v1beta1.Coin | repeated |
token/query.proto
QueryFeesRequest
QueryFeesRequest is request type for the Query/Fees RPC method
Field | Type | Label | Description |
---|---|---|---|
symbol | string |
QueryFeesResponse
QueryFeesResponse is response type for the Query/Fees RPC method
Field | Type | Label | Description |
---|---|---|---|
exist | bool | ||
issue_fee | cosmos.base.v1beta1.Coin | ||
mint_fee | cosmos.base.v1beta1.Coin |
QueryParamsRequest
QueryParametersRequest is request type for the Query/Parameters RPC method
QueryParamsResponse
QueryParametersResponse is response type for the Query/Parameters RPC method
Field | Type | Label | Description |
---|---|---|---|
params | Params | ||
res | cosmos.base.query.v1beta1.PageResponse |
QueryTokenRequest
QueryTokenRequest is request type for the Query/Token RPC method
Field | Type | Label | Description |
---|---|---|---|
denom | string |
QueryTokenResponse
QueryTokenResponse is response type for the Query/Token RPC method
Field | Type | Label | Description |
---|---|---|---|
Token | google.protobuf.Any |
QueryTokensRequest
QueryTokensRequest is request type for the Query/Tokens RPC method
Field | Type | Label | Description |
---|---|---|---|
owner | string | ||
pagination | cosmos.base.query.v1beta1.PageRequest | pagination defines an optional pagination for the request. |
QueryTokensResponse
QueryTokensResponse is response type for the Query/Tokens RPC method
Field | Type | Label | Description |
---|---|---|---|
Tokens | google.protobuf.Any | repeated | |
pagination | cosmos.base.query.v1beta1.PageResponse |
QueryTotalBurnRequest
QueryTokenRequest is request type for the Query/TotalBurn RPC method
QueryTotalBurnResponse
QueryTotalBurnResponse is response type for the Query/TotalBurn RPC method
Field | Type | Label | Description |
---|---|---|---|
burned_coins | cosmos.base.v1beta1.Coin | repeated |
Query
Query creates service with token as RPC
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
Token | QueryTokenRequest | QueryTokenResponse | Token returns token with token name | GET | /irismod/token/tokens/{denom} |
Tokens | QueryTokensRequest | QueryTokensResponse | Tokens returns the token list | GET | /irismod/token/tokens |
Fees | QueryFeesRequest | QueryFeesResponse | Fees returns the fees to issue or mint a token | GET | /irismod/token/tokens/{symbol}/fees |
Params | QueryParamsRequest | QueryParamsResponse | Params queries the token parameters | GET | /irismod/token/params |
TotalBurn | QueryTotalBurnRequest | QueryTotalBurnResponse | TotalBurn queries all the burnt coins | GET | /irismod/token/total_burn |
token/tx.proto
MsgBurnToken
MsgBurnToken defines an SDK message for burning some tokens
Field | Type | Label | Description |
---|---|---|---|
symbol | string | ||
amount | uint64 | ||
sender | string |
MsgBurnTokenResponse
MsgBurnTokenResponse defines the Msg/BurnToken response type
MsgEditToken
MsgEditToken defines an SDK message for editing a new token
Field | Type | Label | Description |
---|---|---|---|
symbol | string | ||
name | string | ||
max_supply | uint64 | ||
mintable | string | ||
owner | string |
MsgEditTokenResponse
MsgEditTokenResponse defines the Msg/EditToken response type
MsgIssueToken
MsgIssueToken defines an SDK message for issuing a new token
Field | Type | Label | Description |
---|---|---|---|
symbol | string | ||
name | string | ||
scale | uint32 | ||
min_unit | string | ||
initial_supply | uint64 | ||
max_supply | uint64 | ||
mintable | bool | ||
owner | string |
MsgIssueTokenResponse
MsgIssueTokenResponse defines the Msg/IssueToken response type
MsgMintToken
MsgMintToken defines an SDK message for minting a new token
Field | Type | Label | Description |
---|---|---|---|
symbol | string | ||
amount | uint64 | ||
to | string | ||
owner | string |
MsgMintTokenResponse
MsgMintTokenResponse defines the Msg/MintToken response type
MsgTransferTokenOwner
MsgTransferTokenOwner defines an SDK message for transferring the token owner
Field | Type | Label | Description |
---|---|---|---|
src_owner | string | ||
dst_owner | string | ||
symbol | string |
MsgTransferTokenOwnerResponse
MsgTransferTokenOwnerResponse defines the Msg/TransferTokenOwner response type
Msg
Msg defines the oracle Msg service
Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint |
---|---|---|---|---|---|
IssueToken | MsgIssueToken | MsgIssueTokenResponse | IssueToken defines a method for issuing a new token | ||
EditToken | MsgEditToken | MsgEditTokenResponse | EditToken defines a method for editing a token | ||
MintToken | MsgMintToken | MsgMintTokenResponse | MintToken defines a method for minting some tokens | ||
BurnToken | MsgBurnToken | MsgBurnTokenResponse | BurnToken defines a method for burning some tokens | ||
TransferTokenOwner | MsgTransferTokenOwner | MsgTransferTokenOwnerResponse | TransferTokenOwner defines a method for minting some tokens |