From 0a3660d2ac96e75edfa6ddfce8e97fccb012d19c Mon Sep 17 00:00:00 2001 From: Amaury <1293565+amaurym@users.noreply.github.com> Date: Wed, 27 Oct 2021 16:13:35 +0200 Subject: [PATCH] chore: Add "Since:" on proto doc comments (#10434) ## Description ref: https://github.com/cosmos/cosmos-sdk/discussions/10406#discussioncomment-1533289 For clients to know whether a protobuf feature is available for a certain SDK version, we decided to use the [`@since` doc comment](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#@since) inside protobuf files. --- ### Author Checklist *All items are required. Please add a note to the item if the item is not applicable and please add links to any relevant follow up issues.* I have... - [ ] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] added `!` to the type prefix if API or client breaking change - [ ] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting)) - [ ] provided a link to the relevant issue or specification - [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules) - [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing) - [ ] added a changelog entry to `CHANGELOG.md` - [ ] included comments for [documenting Go code](https://blog.golang.org/godoc) - [ ] updated the relevant documentation or specification - [ ] reviewed "Files changed" and left comments if necessary - [ ] confirmed all CI checks have passed ### Reviewers Checklist *All items are required. Please add a note if the item is not applicable and please add your handle next to the items reviewed if you only reviewed selected items.* I have... - [ ] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] confirmed `!` in the type prefix if API or client breaking change - [ ] confirmed all author checklist items have been addressed - [ ] reviewed state machine logic - [ ] reviewed API design and naming - [ ] reviewed documentation is accurate - [ ] reviewed tests and test coverage - [ ] manually tested (if applicable) --- client/grpc/tmservice/query.pb.go | 17 +-- docs/core/proto-docs.md | 102 +++++++++++++----- proto/cosmos/auth/v1beta1/query.proto | 6 ++ proto/cosmos/authz/v1beta1/authz.proto | 1 + proto/cosmos/authz/v1beta1/event.proto | 1 + proto/cosmos/authz/v1beta1/genesis.proto | 1 + proto/cosmos/authz/v1beta1/query.proto | 1 + proto/cosmos/authz/v1beta1/tx.proto | 1 + proto/cosmos/bank/v1beta1/authz.proto | 2 + proto/cosmos/bank/v1beta1/bank.proto | 8 ++ proto/cosmos/bank/v1beta1/query.proto | 4 + .../base/query/v1beta1/pagination.proto | 2 + .../base/reflection/v2alpha1/reflection.proto | 1 + .../cosmos/base/store/v1beta1/listening.proto | 2 + .../base/tendermint/v1beta1/query.proto | 1 + proto/cosmos/crypto/secp256r1/keys.proto | 1 + proto/cosmos/feegrant/v1beta1/feegrant.proto | 1 + proto/cosmos/feegrant/v1beta1/genesis.proto | 1 + proto/cosmos/feegrant/v1beta1/query.proto | 1 + proto/cosmos/feegrant/v1beta1/tx.proto | 1 + proto/cosmos/gov/v1beta1/gov.proto | 3 + proto/cosmos/gov/v1beta1/tx.proto | 6 ++ proto/cosmos/staking/v1beta1/authz.proto | 4 + proto/cosmos/tx/v1beta1/service.proto | 2 + proto/cosmos/tx/v1beta1/tx.proto | 2 + proto/cosmos/upgrade/v1beta1/query.proto | 7 ++ proto/cosmos/upgrade/v1beta1/upgrade.proto | 2 + proto/cosmos/vesting/v1beta1/vesting.proto | 2 + store/types/listening.pb.go | 2 + types/query/pagination.pb.go | 2 + types/tx/service.pb.go | 2 + types/tx/tx.pb.go | 2 + x/auth/types/query.pb.go | 8 ++ x/auth/vesting/types/vesting.pb.go | 2 + x/bank/types/authz.pb.go | 2 + x/bank/types/bank.pb.go | 8 ++ x/bank/types/query.pb.go | 4 + x/gov/types/gov.pb.go | 5 +- x/gov/types/tx.pb.go | 8 ++ x/staking/types/authz.pb.go | 4 + x/upgrade/types/query.pb.go | 9 ++ x/upgrade/types/upgrade.pb.go | 2 + 42 files changed, 208 insertions(+), 35 deletions(-) diff --git a/client/grpc/tmservice/query.pb.go b/client/grpc/tmservice/query.pb.go index 3594da2c5f2f..ea4588c7fc3d 100644 --- a/client/grpc/tmservice/query.pb.go +++ b/client/grpc/tmservice/query.pb.go @@ -689,14 +689,15 @@ func (m *GetNodeInfoResponse) GetApplicationVersion() *VersionInfo { // VersionInfo is the type for the GetNodeInfoResponse message. type VersionInfo struct { - Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` - AppName string `protobuf:"bytes,2,opt,name=app_name,json=appName,proto3" json:"app_name,omitempty"` - Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"` - GitCommit string `protobuf:"bytes,4,opt,name=git_commit,json=gitCommit,proto3" json:"git_commit,omitempty"` - BuildTags string `protobuf:"bytes,5,opt,name=build_tags,json=buildTags,proto3" json:"build_tags,omitempty"` - GoVersion string `protobuf:"bytes,6,opt,name=go_version,json=goVersion,proto3" json:"go_version,omitempty"` - BuildDeps []*Module `protobuf:"bytes,7,rep,name=build_deps,json=buildDeps,proto3" json:"build_deps,omitempty"` - CosmosSdkVersion string `protobuf:"bytes,8,opt,name=cosmos_sdk_version,json=cosmosSdkVersion,proto3" json:"cosmos_sdk_version,omitempty"` + Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` + AppName string `protobuf:"bytes,2,opt,name=app_name,json=appName,proto3" json:"app_name,omitempty"` + Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"` + GitCommit string `protobuf:"bytes,4,opt,name=git_commit,json=gitCommit,proto3" json:"git_commit,omitempty"` + BuildTags string `protobuf:"bytes,5,opt,name=build_tags,json=buildTags,proto3" json:"build_tags,omitempty"` + GoVersion string `protobuf:"bytes,6,opt,name=go_version,json=goVersion,proto3" json:"go_version,omitempty"` + BuildDeps []*Module `protobuf:"bytes,7,rep,name=build_deps,json=buildDeps,proto3" json:"build_deps,omitempty"` + // Since: cosmos-sdk 0.43 + CosmosSdkVersion string `protobuf:"bytes,8,opt,name=cosmos_sdk_version,json=cosmosSdkVersion,proto3" json:"cosmos_sdk_version,omitempty"` } func (m *VersionInfo) Reset() { *m = VersionInfo{} } diff --git a/docs/core/proto-docs.md b/docs/core/proto-docs.md index dbc0ff6b21ce..855e9e838a0a 100644 --- a/docs/core/proto-docs.md +++ b/docs/core/proto-docs.md @@ -855,7 +855,9 @@ pagination. Ex: | `offset` | [uint64](#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](#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](#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. | -| `reverse` | [bool](#bool) | | reverse is set to true if results are to be returned in the descending order. | +| `reverse` | [bool](#bool) | | reverse is set to true if results are to be returned in the descending order. + +Since: cosmos-sdk 0.43 | @@ -1020,6 +1022,8 @@ QueryAccountResponse is the response type for the Query/Account RPC method. ### QueryAccountsRequest QueryAccountsRequest is the request type for the Query/Accounts RPC method. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -1035,6 +1039,8 @@ QueryAccountsRequest is the request type for the Query/Accounts RPC method. ### QueryAccountsResponse QueryAccountsResponse is the response type for the Query/Accounts RPC method. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -1109,7 +1115,9 @@ Query defines the gRPC querier service. | Method Name | Request Type | Response Type | Description | HTTP Verb | Endpoint | | ----------- | ------------ | ------------- | ------------| ------- | -------- | -| `Accounts` | [QueryAccountsRequest](#cosmos.auth.v1beta1.QueryAccountsRequest) | [QueryAccountsResponse](#cosmos.auth.v1beta1.QueryAccountsResponse) | Accounts returns all the existing accounts | GET|/cosmos/auth/v1beta1/accounts| +| `Accounts` | [QueryAccountsRequest](#cosmos.auth.v1beta1.QueryAccountsRequest) | [QueryAccountsResponse](#cosmos.auth.v1beta1.QueryAccountsResponse) | Accounts returns all the existing accounts + +Since: cosmos-sdk 0.43 | GET|/cosmos/auth/v1beta1/accounts| | `Account` | [QueryAccountRequest](#cosmos.auth.v1beta1.QueryAccountRequest) | [QueryAccountResponse](#cosmos.auth.v1beta1.QueryAccountResponse) | Account returns account details based on address. | GET|/cosmos/auth/v1beta1/accounts/{address}| | `Params` | [QueryParamsRequest](#cosmos.auth.v1beta1.QueryParamsRequest) | [QueryParamsResponse](#cosmos.auth.v1beta1.QueryParamsResponse) | Params queries all parameters. | GET|/cosmos/auth/v1beta1/params| | `ModuleAccounts` | [QueryModuleAccountsRequest](#cosmos.auth.v1beta1.QueryModuleAccountsRequest) | [QueryModuleAccountsResponse](#cosmos.auth.v1beta1.QueryModuleAccountsResponse) | ModuleAccounts returns all the existing module accounts. | GET|/cosmos/auth/v1beta1/module_accounts| @@ -1125,7 +1133,7 @@ Query defines the gRPC querier service.
## cosmos/authz/v1beta1/authz.proto - +Since: cosmos-sdk 0.43 @@ -1174,7 +1182,7 @@ the provide method with expiration time. ## cosmos/authz/v1beta1/event.proto - +Since: cosmos-sdk 0.43 @@ -1224,7 +1232,7 @@ EventRevoke is emitted on Msg/Revoke ## cosmos/authz/v1beta1/genesis.proto - +Since: cosmos-sdk 0.43 @@ -1273,7 +1281,7 @@ GrantAuthorization defines the GenesisState/GrantAuthorization type. ## cosmos/authz/v1beta1/query.proto - +Since: cosmos-sdk 0.43 @@ -1563,7 +1571,7 @@ tags are stringified and the log is JSON decoded. ## cosmos/authz/v1beta1/tx.proto - +Since: cosmos-sdk 0.43 @@ -1773,6 +1781,8 @@ IntProto defines a Protobuf wrapper around an Int object. SendAuthorization allows the grantee to spend up to spend_limit coins from the granter's account. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -1846,10 +1856,18 @@ a basic token. | `denom_units` | [DenomUnit](#cosmos.bank.v1beta1.DenomUnit) | repeated | denom_units represents the list of DenomUnit's for a given coin | | `base` | [string](#string) | | base represents the base denom (should be the DenomUnit with exponent = 0). | | `display` | [string](#string) | | display indicates the suggested denom that should be displayed in clients. | -| `name` | [string](#string) | | name defines the name of the token (eg: Cosmos Atom) | -| `symbol` | [string](#string) | | symbol is the token symbol usually shown on exchanges (eg: ATOM). This can be the same as the display. | -| `uri` | [string](#string) | | URI to a document (on or off-chain) that contains additional information. Optional. | -| `uri_hash` | [string](#string) | | URIHash is a sha256 hash of a document pointed by URI. It's used to verify that the document didn't change. Optional. | +| `name` | [string](#string) | | name defines the name of the token (eg: Cosmos Atom) + +Since: cosmos-sdk 0.43 | +| `symbol` | [string](#string) | | symbol is the token symbol usually shown on exchanges (eg: ATOM). This can be the same as the display. + +Since: cosmos-sdk 0.43 | +| `uri` | [string](#string) | | URI to a document (on or off-chain) that contains additional information. Optional. + +Since: cosmos-sdk 0.45 | +| `uri_hash` | [string](#string) | | URIHash is a sha256 hash of a document pointed by URI. It's used to verify that the document didn't change. Optional. + +Since: cosmos-sdk 0.45 | @@ -2232,7 +2250,9 @@ method. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| `pagination` | [cosmos.base.query.v1beta1.PageRequest](#cosmos.base.query.v1beta1.PageRequest) | | pagination defines an optional pagination for the request. | +| `pagination` | [cosmos.base.query.v1beta1.PageRequest](#cosmos.base.query.v1beta1.PageRequest) | | pagination defines an optional pagination for the request. + +Since: cosmos-sdk 0.43 | @@ -2249,7 +2269,9 @@ method | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | | `supply` | [cosmos.base.v1beta1.Coin](#cosmos.base.v1beta1.Coin) | repeated | supply is the supply of the coins | -| `pagination` | [cosmos.base.query.v1beta1.PageResponse](#cosmos.base.query.v1beta1.PageResponse) | | pagination defines the pagination in the response. | +| `pagination` | [cosmos.base.query.v1beta1.PageResponse](#cosmos.base.query.v1beta1.PageResponse) | | pagination defines the pagination in the response. + +Since: cosmos-sdk 0.43 | @@ -2497,7 +2519,7 @@ ReflectionService defines a service for interface reflection. ## cosmos/base/reflection/v2alpha1/reflection.proto - +Since: cosmos-sdk 0.43 @@ -3037,6 +3059,8 @@ StoreKVPair is a KVStore KVPair used for listening to state changes (Sets and De It optionally includes the StoreKey for the originating KVStore and a Boolean flag to distinguish between Sets and Deletes +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -3354,7 +3378,7 @@ VersionInfo is the type for the GetNodeInfoResponse message. | `build_tags` | [string](#string) | | | | `go_version` | [string](#string) | | | | `build_deps` | [Module](#cosmos.base.tendermint.v1beta1.Module) | repeated | | -| `cosmos_sdk_version` | [string](#string) | | | +| `cosmos_sdk_version` | [string](#string) | | Since: cosmos-sdk 0.43 | @@ -3896,7 +3920,7 @@ This prefix is followed with the x-coordinate. ## cosmos/crypto/secp256r1/keys.proto - +Since: cosmos-sdk 0.43 @@ -5007,7 +5031,7 @@ Msg defines the evidence Msg service. ## cosmos/feegrant/v1beta1/feegrant.proto - +Since: cosmos-sdk 0.43 @@ -5093,7 +5117,7 @@ as well as a limit per time period. ## cosmos/feegrant/v1beta1/genesis.proto - +Since: cosmos-sdk 0.43 @@ -5124,7 +5148,7 @@ GenesisState contains a set of fee allowances, persisted from the store ## cosmos/feegrant/v1beta1/query.proto - +Since: cosmos-sdk 0.43 @@ -5214,7 +5238,7 @@ Query defines the gRPC querier service. ## cosmos/feegrant/v1beta1/tx.proto - +Since: cosmos-sdk 0.43 @@ -5450,7 +5474,7 @@ A Vote consists of a proposal ID, the voter, and the vote option. | `proposal_id` | [uint64](#uint64) | | | | `voter` | [string](#string) | | | | `option` | [VoteOption](#cosmos.gov.v1beta1.VoteOption) | | **Deprecated.** Deprecated: Prefer to use `options` instead. This field is set in queries if and only if `len(options) == 1` and that option has weight 1. In all other cases, this field will default to VOTE_OPTION_UNSPECIFIED. | -| `options` | [WeightedVoteOption](#cosmos.gov.v1beta1.WeightedVoteOption) | repeated | | +| `options` | [WeightedVoteOption](#cosmos.gov.v1beta1.WeightedVoteOption) | repeated | Since: cosmos-sdk 0.43 | @@ -5477,6 +5501,8 @@ VotingParams defines the params for voting on governance proposals. ### WeightedVoteOption WeightedVoteOption defines a unit of vote for vote split. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -5950,6 +5976,8 @@ MsgVoteResponse defines the Msg/Vote response type. ### MsgVoteWeighted MsgVoteWeighted defines a message to cast a vote. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -5967,6 +5995,8 @@ MsgVoteWeighted defines a message to cast a vote. ### MsgVoteWeightedResponse MsgVoteWeightedResponse defines the Msg/VoteWeighted response type. +Since: cosmos-sdk 0.43 + @@ -5987,7 +6017,9 @@ Msg defines the bank Msg service. | ----------- | ------------ | ------------- | ------------| ------- | -------- | | `SubmitProposal` | [MsgSubmitProposal](#cosmos.gov.v1beta1.MsgSubmitProposal) | [MsgSubmitProposalResponse](#cosmos.gov.v1beta1.MsgSubmitProposalResponse) | SubmitProposal defines a method to create new proposal given a content. | | | `Vote` | [MsgVote](#cosmos.gov.v1beta1.MsgVote) | [MsgVoteResponse](#cosmos.gov.v1beta1.MsgVoteResponse) | Vote defines a method to add a vote on a specific proposal. | | -| `VoteWeighted` | [MsgVoteWeighted](#cosmos.gov.v1beta1.MsgVoteWeighted) | [MsgVoteWeightedResponse](#cosmos.gov.v1beta1.MsgVoteWeightedResponse) | VoteWeighted defines a method to add a weighted vote on a specific proposal. | | +| `VoteWeighted` | [MsgVoteWeighted](#cosmos.gov.v1beta1.MsgVoteWeighted) | [MsgVoteWeightedResponse](#cosmos.gov.v1beta1.MsgVoteWeightedResponse) | VoteWeighted defines a method to add a weighted vote on a specific proposal. + +Since: cosmos-sdk 0.43 | | | `Deposit` | [MsgDeposit](#cosmos.gov.v1beta1.MsgDeposit) | [MsgDepositResponse](#cosmos.gov.v1beta1.MsgDepositResponse) | Deposit defines a method to add deposit on a specific proposal. | | @@ -8120,6 +8152,8 @@ Msg defines the slashing Msg service. ### StakeAuthorization StakeAuthorization defines authorization for delegate/undelegate/redelegate. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -8155,6 +8189,8 @@ Validators defines list of validator addresses. ### AuthorizationType AuthorizationType defines the type of staking module authorization type +Since: cosmos-sdk 0.43 + | Name | Number | Description | | ---- | ------ | ----------- | | AUTHORIZATION_TYPE_UNSPECIFIED | 0 | AUTHORIZATION_TYPE_UNSPECIFIED specifies an unknown authorization type | @@ -9429,7 +9465,9 @@ transaction. | ----- | ---- | ----- | ----------- | | `signer_infos` | [SignerInfo](#cosmos.tx.v1beta1.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](#cosmos.tx.v1beta1.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. | -| `tip` | [Tip](#cosmos.tx.v1beta1.Tip) | | Tip is the optional tip used for meta-transactions. | +| `tip` | [Tip](#cosmos.tx.v1beta1.Tip) | | Tip is the optional tip used for meta-transactions. + +Since: cosmos-sdk 0.45 | @@ -9762,7 +9800,9 @@ RPC method. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | | `tx` | [Tx](#cosmos.tx.v1beta1.Tx) | | **Deprecated.** tx is the transaction to simulate. Deprecated. Send raw tx bytes instead. | -| `tx_bytes` | [bytes](#bytes) | | tx_bytes is the raw transaction. | +| `tx_bytes` | [bytes](#bytes) | | tx_bytes is the raw transaction. + +Since: cosmos-sdk 0.43 | @@ -9864,6 +9904,8 @@ upgrade. ### ModuleVersion ModuleVersion specifies a module and its consensus version. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -9993,6 +10035,8 @@ method. QueryModuleVersionsRequest is the request type for the Query/ModuleVersions RPC method. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -10009,6 +10053,8 @@ RPC method. QueryModuleVersionsResponse is the response type for the Query/ModuleVersions RPC method. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | @@ -10044,7 +10090,7 @@ RPC method. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| `upgraded_consensus_state` | [bytes](#bytes) | | | +| `upgraded_consensus_state` | [bytes](#bytes) | | Since: cosmos-sdk 0.43 | @@ -10067,7 +10113,9 @@ Query defines the gRPC upgrade querier service. | `CurrentPlan` | [QueryCurrentPlanRequest](#cosmos.upgrade.v1beta1.QueryCurrentPlanRequest) | [QueryCurrentPlanResponse](#cosmos.upgrade.v1beta1.QueryCurrentPlanResponse) | CurrentPlan queries the current upgrade plan. | GET|/cosmos/upgrade/v1beta1/current_plan| | `AppliedPlan` | [QueryAppliedPlanRequest](#cosmos.upgrade.v1beta1.QueryAppliedPlanRequest) | [QueryAppliedPlanResponse](#cosmos.upgrade.v1beta1.QueryAppliedPlanResponse) | AppliedPlan queries a previously applied upgrade plan by its name. | GET|/cosmos/upgrade/v1beta1/applied_plan/{name}| | `UpgradedConsensusState` | [QueryUpgradedConsensusStateRequest](#cosmos.upgrade.v1beta1.QueryUpgradedConsensusStateRequest) | [QueryUpgradedConsensusStateResponse](#cosmos.upgrade.v1beta1.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 This rpc is deprecated now that IBC has its own replacement (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54) | GET|/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}| -| `ModuleVersions` | [QueryModuleVersionsRequest](#cosmos.upgrade.v1beta1.QueryModuleVersionsRequest) | [QueryModuleVersionsResponse](#cosmos.upgrade.v1beta1.QueryModuleVersionsResponse) | ModuleVersions queries the list of module versions from state. | GET|/cosmos/upgrade/v1beta1/module_versions| +| `ModuleVersions` | [QueryModuleVersionsRequest](#cosmos.upgrade.v1beta1.QueryModuleVersionsRequest) | [QueryModuleVersionsResponse](#cosmos.upgrade.v1beta1.QueryModuleVersionsResponse) | ModuleVersions queries the list of module versions from state. + +Since: cosmos-sdk 0.43 | GET|/cosmos/upgrade/v1beta1/module_versions| @@ -10175,6 +10223,8 @@ PermanentLockedAccount implements the VestingAccount interface. It does not ever release coins, locking them indefinitely. Coins in this account can still be used for delegating and for governance votes even while locked. +Since: cosmos-sdk 0.43 + | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | diff --git a/proto/cosmos/auth/v1beta1/query.proto b/proto/cosmos/auth/v1beta1/query.proto index 845695fd87af..d99d594016a6 100644 --- a/proto/cosmos/auth/v1beta1/query.proto +++ b/proto/cosmos/auth/v1beta1/query.proto @@ -13,6 +13,8 @@ option go_package = "github.com/cosmos/cosmos-sdk/x/auth/types"; // Query defines the gRPC querier service. service Query { // Accounts returns all the existing accounts + // + // Since: cosmos-sdk 0.43 rpc Accounts(QueryAccountsRequest) returns (QueryAccountsResponse) { option (google.api.http).get = "/cosmos/auth/v1beta1/accounts"; } @@ -49,12 +51,16 @@ service Query { } // QueryAccountsRequest is the request type for the Query/Accounts RPC method. +// +// Since: cosmos-sdk 0.43 message QueryAccountsRequest { // pagination defines an optional pagination for the request. cosmos.base.query.v1beta1.PageRequest pagination = 1; } // QueryAccountsResponse is the response type for the Query/Accounts RPC method. +// +// Since: cosmos-sdk 0.43 message QueryAccountsResponse { // accounts are the existing accounts repeated google.protobuf.Any accounts = 1 [(cosmos_proto.accepts_interface) = "AccountI"]; diff --git a/proto/cosmos/authz/v1beta1/authz.proto b/proto/cosmos/authz/v1beta1/authz.proto index c69a93c11f4a..2c376905eb8b 100644 --- a/proto/cosmos/authz/v1beta1/authz.proto +++ b/proto/cosmos/authz/v1beta1/authz.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.authz.v1beta1; diff --git a/proto/cosmos/authz/v1beta1/event.proto b/proto/cosmos/authz/v1beta1/event.proto index f763854b38d6..0476649afc1b 100644 --- a/proto/cosmos/authz/v1beta1/event.proto +++ b/proto/cosmos/authz/v1beta1/event.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.authz.v1beta1; diff --git a/proto/cosmos/authz/v1beta1/genesis.proto b/proto/cosmos/authz/v1beta1/genesis.proto index 504739bc0cce..8bf5f82e1562 100644 --- a/proto/cosmos/authz/v1beta1/genesis.proto +++ b/proto/cosmos/authz/v1beta1/genesis.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.authz.v1beta1; diff --git a/proto/cosmos/authz/v1beta1/query.proto b/proto/cosmos/authz/v1beta1/query.proto index 5b01be7e1fc4..eefd894170c3 100644 --- a/proto/cosmos/authz/v1beta1/query.proto +++ b/proto/cosmos/authz/v1beta1/query.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.authz.v1beta1; diff --git a/proto/cosmos/authz/v1beta1/tx.proto b/proto/cosmos/authz/v1beta1/tx.proto index 65c0e45caeed..b99feee45889 100644 --- a/proto/cosmos/authz/v1beta1/tx.proto +++ b/proto/cosmos/authz/v1beta1/tx.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.authz.v1beta1; diff --git a/proto/cosmos/bank/v1beta1/authz.proto b/proto/cosmos/bank/v1beta1/authz.proto index f3505ad41cab..4f58b15e4970 100644 --- a/proto/cosmos/bank/v1beta1/authz.proto +++ b/proto/cosmos/bank/v1beta1/authz.proto @@ -9,6 +9,8 @@ option go_package = "github.com/cosmos/cosmos-sdk/x/bank/types"; // SendAuthorization allows the grantee to spend up to spend_limit coins from // the granter's account. +// +// Since: cosmos-sdk 0.43 message SendAuthorization { option (cosmos_proto.implements_interface) = "Authorization"; diff --git a/proto/cosmos/bank/v1beta1/bank.proto b/proto/cosmos/bank/v1beta1/bank.proto index 3ae2074ff0fe..0e1733e6065d 100644 --- a/proto/cosmos/bank/v1beta1/bank.proto +++ b/proto/cosmos/bank/v1beta1/bank.proto @@ -85,13 +85,21 @@ message Metadata { // displayed in clients. string display = 4; // name defines the name of the token (eg: Cosmos Atom) + // + // Since: cosmos-sdk 0.43 string name = 5; // symbol is the token symbol usually shown on exchanges (eg: ATOM). This can // be the same as the display. + // + // Since: cosmos-sdk 0.43 string symbol = 6; // URI to a document (on or off-chain) that contains additional information. Optional. + // + // Since: cosmos-sdk 0.45 string uri = 7 [(gogoproto.customname) = "URI"]; // URIHash is a sha256 hash of a document pointed by URI. It's used to verify that // the document didn't change. Optional. + // + // Since: cosmos-sdk 0.45 string uri_hash = 8 [(gogoproto.customname) = "URIHash"]; } diff --git a/proto/cosmos/bank/v1beta1/query.proto b/proto/cosmos/bank/v1beta1/query.proto index f42c93a758ef..bfe4ebaa819c 100644 --- a/proto/cosmos/bank/v1beta1/query.proto +++ b/proto/cosmos/bank/v1beta1/query.proto @@ -103,6 +103,8 @@ message QueryTotalSupplyRequest { option (gogoproto.goproto_getters) = false; // pagination defines an optional pagination for the request. + // + // Since: cosmos-sdk 0.43 cosmos.base.query.v1beta1.PageRequest pagination = 1; } @@ -114,6 +116,8 @@ message QueryTotalSupplyResponse { [(gogoproto.nullable) = false, (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"]; // pagination defines the pagination in the response. + // + // Since: cosmos-sdk 0.43 cosmos.base.query.v1beta1.PageResponse pagination = 2; } diff --git a/proto/cosmos/base/query/v1beta1/pagination.proto b/proto/cosmos/base/query/v1beta1/pagination.proto index 784c479562a9..cd5eb066d399 100644 --- a/proto/cosmos/base/query/v1beta1/pagination.proto +++ b/proto/cosmos/base/query/v1beta1/pagination.proto @@ -32,6 +32,8 @@ message PageRequest { bool count_total = 4; // reverse is set to true if results are to be returned in the descending order. + // + // Since: cosmos-sdk 0.43 bool reverse = 5; } diff --git a/proto/cosmos/base/reflection/v2alpha1/reflection.proto b/proto/cosmos/base/reflection/v2alpha1/reflection.proto index 3e8e94048221..d5b048558fa0 100644 --- a/proto/cosmos/base/reflection/v2alpha1/reflection.proto +++ b/proto/cosmos/base/reflection/v2alpha1/reflection.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.base.reflection.v2alpha1; diff --git a/proto/cosmos/base/store/v1beta1/listening.proto b/proto/cosmos/base/store/v1beta1/listening.proto index 186ecee4b080..359997109c10 100644 --- a/proto/cosmos/base/store/v1beta1/listening.proto +++ b/proto/cosmos/base/store/v1beta1/listening.proto @@ -6,6 +6,8 @@ option go_package = "github.com/cosmos/cosmos-sdk/store/types"; // StoreKVPair is a KVStore KVPair used for listening to state changes (Sets and Deletes) // It optionally includes the StoreKey for the originating KVStore and a Boolean flag to distinguish between Sets and // Deletes +// +// Since: cosmos-sdk 0.43 message StoreKVPair { string store_key = 1; // the store key for the KVStore this pair originates from bool delete = 2; // true indicates a delete operation, false indicates a set operation diff --git a/proto/cosmos/base/tendermint/v1beta1/query.proto b/proto/cosmos/base/tendermint/v1beta1/query.proto index e88ed74a6718..c5a64c3c651c 100644 --- a/proto/cosmos/base/tendermint/v1beta1/query.proto +++ b/proto/cosmos/base/tendermint/v1beta1/query.proto @@ -124,6 +124,7 @@ message VersionInfo { string build_tags = 5; string go_version = 6; repeated Module build_deps = 7; + // Since: cosmos-sdk 0.43 string cosmos_sdk_version = 8; } diff --git a/proto/cosmos/crypto/secp256r1/keys.proto b/proto/cosmos/crypto/secp256r1/keys.proto index b0aad99d1f94..2e96c6e3c65e 100644 --- a/proto/cosmos/crypto/secp256r1/keys.proto +++ b/proto/cosmos/crypto/secp256r1/keys.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.crypto.secp256r1; diff --git a/proto/cosmos/feegrant/v1beta1/feegrant.proto b/proto/cosmos/feegrant/v1beta1/feegrant.proto index 1a82b01e895d..769490c59992 100644 --- a/proto/cosmos/feegrant/v1beta1/feegrant.proto +++ b/proto/cosmos/feegrant/v1beta1/feegrant.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.feegrant.v1beta1; diff --git a/proto/cosmos/feegrant/v1beta1/genesis.proto b/proto/cosmos/feegrant/v1beta1/genesis.proto index 4c1e51fdd2c2..5b1ac4ca5593 100644 --- a/proto/cosmos/feegrant/v1beta1/genesis.proto +++ b/proto/cosmos/feegrant/v1beta1/genesis.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.feegrant.v1beta1; diff --git a/proto/cosmos/feegrant/v1beta1/query.proto b/proto/cosmos/feegrant/v1beta1/query.proto index 657114b80453..69fef2e7eb19 100644 --- a/proto/cosmos/feegrant/v1beta1/query.proto +++ b/proto/cosmos/feegrant/v1beta1/query.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.feegrant.v1beta1; diff --git a/proto/cosmos/feegrant/v1beta1/tx.proto b/proto/cosmos/feegrant/v1beta1/tx.proto index 69a1a25fc2d9..cf7e800f49a3 100644 --- a/proto/cosmos/feegrant/v1beta1/tx.proto +++ b/proto/cosmos/feegrant/v1beta1/tx.proto @@ -1,3 +1,4 @@ +// Since: cosmos-sdk 0.43 syntax = "proto3"; package cosmos.feegrant.v1beta1; diff --git a/proto/cosmos/gov/v1beta1/gov.proto b/proto/cosmos/gov/v1beta1/gov.proto index c867ecef59e4..2b5dd881a2cb 100644 --- a/proto/cosmos/gov/v1beta1/gov.proto +++ b/proto/cosmos/gov/v1beta1/gov.proto @@ -30,6 +30,8 @@ enum VoteOption { } // WeightedVoteOption defines a unit of vote for vote split. +// +// Since: cosmos-sdk 0.43 message WeightedVoteOption { VoteOption option = 1; string weight = 2 [ @@ -134,6 +136,7 @@ message Vote { // if and only if `len(options) == 1` and that option has weight 1. In all // other cases, this field will default to VOTE_OPTION_UNSPECIFIED. VoteOption option = 3 [deprecated = true]; + // Since: cosmos-sdk 0.43 repeated WeightedVoteOption options = 4 [(gogoproto.nullable) = false]; } diff --git a/proto/cosmos/gov/v1beta1/tx.proto b/proto/cosmos/gov/v1beta1/tx.proto index 50b23684e9b8..35e49eb2d765 100644 --- a/proto/cosmos/gov/v1beta1/tx.proto +++ b/proto/cosmos/gov/v1beta1/tx.proto @@ -18,6 +18,8 @@ service Msg { rpc Vote(MsgVote) returns (MsgVoteResponse); // VoteWeighted defines a method to add a weighted vote on a specific proposal. + // + // Since: cosmos-sdk 0.43 rpc VoteWeighted(MsgVoteWeighted) returns (MsgVoteWeightedResponse); // Deposit defines a method to add deposit on a specific proposal. @@ -61,6 +63,8 @@ message MsgVote { message MsgVoteResponse {} // MsgVoteWeighted defines a message to cast a vote. +// +// Since: cosmos-sdk 0.43 message MsgVoteWeighted { option (gogoproto.equal) = false; option (gogoproto.goproto_stringer) = false; @@ -73,6 +77,8 @@ message MsgVoteWeighted { } // MsgVoteWeightedResponse defines the Msg/VoteWeighted response type. +// +// Since: cosmos-sdk 0.43 message MsgVoteWeightedResponse {} // MsgDeposit defines a message to submit a deposit to an existing proposal. diff --git a/proto/cosmos/staking/v1beta1/authz.proto b/proto/cosmos/staking/v1beta1/authz.proto index 9d3c09dce35c..677edaad1a26 100644 --- a/proto/cosmos/staking/v1beta1/authz.proto +++ b/proto/cosmos/staking/v1beta1/authz.proto @@ -8,6 +8,8 @@ import "cosmos/base/v1beta1/coin.proto"; option go_package = "github.com/cosmos/cosmos-sdk/x/staking/types"; // StakeAuthorization defines authorization for delegate/undelegate/redelegate. +// +// Since: cosmos-sdk 0.43 message StakeAuthorization { option (cosmos_proto.implements_interface) = "Authorization"; @@ -31,6 +33,8 @@ message StakeAuthorization { } // AuthorizationType defines the type of staking module authorization type +// +// Since: cosmos-sdk 0.43 enum AuthorizationType { // AUTHORIZATION_TYPE_UNSPECIFIED specifies an unknown authorization type AUTHORIZATION_TYPE_UNSPECIFIED = 0; diff --git a/proto/cosmos/tx/v1beta1/service.proto b/proto/cosmos/tx/v1beta1/service.proto index 646175c00d09..acfbf15b3689 100644 --- a/proto/cosmos/tx/v1beta1/service.proto +++ b/proto/cosmos/tx/v1beta1/service.proto @@ -104,6 +104,8 @@ message SimulateRequest { // Deprecated. Send raw tx bytes instead. cosmos.tx.v1beta1.Tx tx = 1 [deprecated = true]; // tx_bytes is the raw transaction. + // + // Since: cosmos-sdk 0.43 bytes tx_bytes = 2; } diff --git a/proto/cosmos/tx/v1beta1/tx.proto b/proto/cosmos/tx/v1beta1/tx.proto index f26c02051ff6..a26cad5d54df 100644 --- a/proto/cosmos/tx/v1beta1/tx.proto +++ b/proto/cosmos/tx/v1beta1/tx.proto @@ -137,6 +137,8 @@ message AuthInfo { Fee fee = 2; // Tip is the optional tip used for meta-transactions. + // + // Since: cosmos-sdk 0.45 Tip tip = 3; } diff --git a/proto/cosmos/upgrade/v1beta1/query.proto b/proto/cosmos/upgrade/v1beta1/query.proto index 0703ef347b83..dd14ba6401c4 100644 --- a/proto/cosmos/upgrade/v1beta1/query.proto +++ b/proto/cosmos/upgrade/v1beta1/query.proto @@ -31,6 +31,8 @@ service Query { } // ModuleVersions queries the list of module versions from state. + // + // Since: cosmos-sdk 0.43 rpc ModuleVersions(QueryModuleVersionsRequest) returns (QueryModuleVersionsResponse) { option (google.api.http).get = "/cosmos/upgrade/v1beta1/module_versions"; } @@ -77,11 +79,14 @@ message QueryUpgradedConsensusStateResponse { option deprecated = true; reserved 1; + // Since: cosmos-sdk 0.43 bytes upgraded_consensus_state = 2; } // QueryModuleVersionsRequest is the request type for the Query/ModuleVersions // RPC method. +// +// Since: cosmos-sdk 0.43 message QueryModuleVersionsRequest { // module_name is a field to query a specific module // consensus version from state. Leaving this empty will @@ -91,6 +96,8 @@ message QueryModuleVersionsRequest { // QueryModuleVersionsResponse is the response type for the Query/ModuleVersions // RPC method. +// +// Since: cosmos-sdk 0.43 message QueryModuleVersionsResponse { // module_versions is a list of module names with their consensus versions. repeated ModuleVersion module_versions = 1; diff --git a/proto/cosmos/upgrade/v1beta1/upgrade.proto b/proto/cosmos/upgrade/v1beta1/upgrade.proto index 067124a2340e..70a90b1f0ad5 100644 --- a/proto/cosmos/upgrade/v1beta1/upgrade.proto +++ b/proto/cosmos/upgrade/v1beta1/upgrade.proto @@ -64,6 +64,8 @@ message CancelSoftwareUpgradeProposal { } // ModuleVersion specifies a module and its consensus version. +// +// Since: cosmos-sdk 0.43 message ModuleVersion { option (gogoproto.equal) = true; option (gogoproto.goproto_stringer) = true; diff --git a/proto/cosmos/vesting/v1beta1/vesting.proto b/proto/cosmos/vesting/v1beta1/vesting.proto index f24069e54719..59580245aea4 100644 --- a/proto/cosmos/vesting/v1beta1/vesting.proto +++ b/proto/cosmos/vesting/v1beta1/vesting.proto @@ -72,6 +72,8 @@ message PeriodicVestingAccount { // PermanentLockedAccount implements the VestingAccount interface. It does // not ever release coins, locking them indefinitely. Coins in this account can // still be used for delegating and for governance votes even while locked. +// +// Since: cosmos-sdk 0.43 message PermanentLockedAccount { option (gogoproto.goproto_getters) = false; option (gogoproto.goproto_stringer) = false; diff --git a/store/types/listening.pb.go b/store/types/listening.pb.go index bc0b84514c00..47d5a23a8367 100644 --- a/store/types/listening.pb.go +++ b/store/types/listening.pb.go @@ -25,6 +25,8 @@ const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package // StoreKVPair is a KVStore KVPair used for listening to state changes (Sets and Deletes) // It optionally includes the StoreKey for the originating KVStore and a Boolean flag to distinguish between Sets and // Deletes +// +// Since: cosmos-sdk 0.43 type StoreKVPair struct { StoreKey string `protobuf:"bytes,1,opt,name=store_key,json=storeKey,proto3" json:"store_key,omitempty"` Delete bool `protobuf:"varint,2,opt,name=delete,proto3" json:"delete,omitempty"` diff --git a/types/query/pagination.pb.go b/types/query/pagination.pb.go index 3b1455d6f299..c631ecfb1eaf 100644 --- a/types/query/pagination.pb.go +++ b/types/query/pagination.pb.go @@ -47,6 +47,8 @@ type PageRequest struct { // is set. CountTotal bool `protobuf:"varint,4,opt,name=count_total,json=countTotal,proto3" json:"count_total,omitempty"` // reverse is set to true if results are to be returned in the descending order. + // + // Since: cosmos-sdk 0.43 Reverse bool `protobuf:"varint,5,opt,name=reverse,proto3" json:"reverse,omitempty"` } diff --git a/types/tx/service.pb.go b/types/tx/service.pb.go index c61222acaed8..13c068cae088 100644 --- a/types/tx/service.pb.go +++ b/types/tx/service.pb.go @@ -342,6 +342,8 @@ type SimulateRequest struct { // Deprecated. Send raw tx bytes instead. Tx *Tx `protobuf:"bytes,1,opt,name=tx,proto3" json:"tx,omitempty"` // Deprecated: Do not use. // tx_bytes is the raw transaction. + // + // Since: cosmos-sdk 0.43 TxBytes []byte `protobuf:"bytes,2,opt,name=tx_bytes,json=txBytes,proto3" json:"tx_bytes,omitempty"` } diff --git a/types/tx/tx.pb.go b/types/tx/tx.pb.go index cb9f6bb6de5e..6a7df6c004c3 100644 --- a/types/tx/tx.pb.go +++ b/types/tx/tx.pb.go @@ -450,6 +450,8 @@ type AuthInfo struct { // of the signers. This can be estimated via simulation. Fee *Fee `protobuf:"bytes,2,opt,name=fee,proto3" json:"fee,omitempty"` // Tip is the optional tip used for meta-transactions. + // + // Since: cosmos-sdk 0.45 Tip *Tip `protobuf:"bytes,3,opt,name=tip,proto3" json:"tip,omitempty"` } diff --git a/x/auth/types/query.pb.go b/x/auth/types/query.pb.go index a0c621434008..2a3f8493aa21 100644 --- a/x/auth/types/query.pb.go +++ b/x/auth/types/query.pb.go @@ -33,6 +33,8 @@ var _ = math.Inf const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package // QueryAccountsRequest is the request type for the Query/Accounts RPC method. +// +// Since: cosmos-sdk 0.43 type QueryAccountsRequest struct { // pagination defines an optional pagination for the request. Pagination *query.PageRequest `protobuf:"bytes,1,opt,name=pagination,proto3" json:"pagination,omitempty"` @@ -79,6 +81,8 @@ func (m *QueryAccountsRequest) GetPagination() *query.PageRequest { } // QueryAccountsResponse is the response type for the Query/Accounts RPC method. +// +// Since: cosmos-sdk 0.43 type QueryAccountsResponse struct { // accounts are the existing accounts Accounts []*types.Any `protobuf:"bytes,1,rep,name=accounts,proto3" json:"accounts,omitempty"` @@ -732,6 +736,8 @@ const _ = grpc.SupportPackageIsVersion4 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type QueryClient interface { // Accounts returns all the existing accounts + // + // Since: cosmos-sdk 0.43 Accounts(ctx context.Context, in *QueryAccountsRequest, opts ...grpc.CallOption) (*QueryAccountsResponse, error) // Account returns account details based on address. Account(ctx context.Context, in *QueryAccountRequest, opts ...grpc.CallOption) (*QueryAccountResponse, error) @@ -821,6 +827,8 @@ func (c *queryClient) AddressStringToBytes(ctx context.Context, in *AddressStrin // QueryServer is the server API for Query service. type QueryServer interface { // Accounts returns all the existing accounts + // + // Since: cosmos-sdk 0.43 Accounts(context.Context, *QueryAccountsRequest) (*QueryAccountsResponse, error) // Account returns account details based on address. Account(context.Context, *QueryAccountRequest) (*QueryAccountResponse, error) diff --git a/x/auth/vesting/types/vesting.pb.go b/x/auth/vesting/types/vesting.pb.go index dc2425b1a79a..1404b5891cc6 100644 --- a/x/auth/vesting/types/vesting.pb.go +++ b/x/auth/vesting/types/vesting.pb.go @@ -241,6 +241,8 @@ var xxx_messageInfo_PeriodicVestingAccount proto.InternalMessageInfo // PermanentLockedAccount implements the VestingAccount interface. It does // not ever release coins, locking them indefinitely. Coins in this account can // still be used for delegating and for governance votes even while locked. +// +// Since: cosmos-sdk 0.43 type PermanentLockedAccount struct { *BaseVestingAccount `protobuf:"bytes,1,opt,name=base_vesting_account,json=baseVestingAccount,proto3,embedded=base_vesting_account" json:"base_vesting_account,omitempty"` } diff --git a/x/bank/types/authz.pb.go b/x/bank/types/authz.pb.go index e5352246fbef..904a7f9ce793 100644 --- a/x/bank/types/authz.pb.go +++ b/x/bank/types/authz.pb.go @@ -28,6 +28,8 @@ const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package // SendAuthorization allows the grantee to spend up to spend_limit coins from // the granter's account. +// +// Since: cosmos-sdk 0.43 type SendAuthorization struct { SpendLimit github_com_cosmos_cosmos_sdk_types.Coins `protobuf:"bytes,1,rep,name=spend_limit,json=spendLimit,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"spend_limit"` } diff --git a/x/bank/types/bank.pb.go b/x/bank/types/bank.pb.go index c720f94a3d98..947acfdc16ef 100644 --- a/x/bank/types/bank.pb.go +++ b/x/bank/types/bank.pb.go @@ -332,14 +332,22 @@ type Metadata struct { // displayed in clients. Display string `protobuf:"bytes,4,opt,name=display,proto3" json:"display,omitempty"` // name defines the name of the token (eg: Cosmos Atom) + // + // Since: cosmos-sdk 0.43 Name string `protobuf:"bytes,5,opt,name=name,proto3" json:"name,omitempty"` // symbol is the token symbol usually shown on exchanges (eg: ATOM). This can // be the same as the display. + // + // Since: cosmos-sdk 0.43 Symbol string `protobuf:"bytes,6,opt,name=symbol,proto3" json:"symbol,omitempty"` // URI to a document (on or off-chain) that contains additional information. Optional. + // + // Since: cosmos-sdk 0.45 URI string `protobuf:"bytes,7,opt,name=uri,proto3" json:"uri,omitempty"` // URIHash is a sha256 hash of a document pointed by URI. It's used to verify that // the document didn't change. Optional. + // + // Since: cosmos-sdk 0.45 URIHash string `protobuf:"bytes,8,opt,name=uri_hash,json=uriHash,proto3" json:"uri_hash,omitempty"` } diff --git a/x/bank/types/query.pb.go b/x/bank/types/query.pb.go index 36018d4df0fd..637218150c0e 100644 --- a/x/bank/types/query.pb.go +++ b/x/bank/types/query.pb.go @@ -221,6 +221,8 @@ func (m *QueryAllBalancesResponse) GetPagination() *query.PageResponse { // method. type QueryTotalSupplyRequest struct { // pagination defines an optional pagination for the request. + // + // Since: cosmos-sdk 0.43 Pagination *query.PageRequest `protobuf:"bytes,1,opt,name=pagination,proto3" json:"pagination,omitempty"` } @@ -263,6 +265,8 @@ type QueryTotalSupplyResponse struct { // supply is the supply of the coins Supply github_com_cosmos_cosmos_sdk_types.Coins `protobuf:"bytes,1,rep,name=supply,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"supply"` // pagination defines the pagination in the response. + // + // Since: cosmos-sdk 0.43 Pagination *query.PageResponse `protobuf:"bytes,2,opt,name=pagination,proto3" json:"pagination,omitempty"` } diff --git a/x/gov/types/gov.pb.go b/x/gov/types/gov.pb.go index 97330037ae3e..4b32cf249afe 100644 --- a/x/gov/types/gov.pb.go +++ b/x/gov/types/gov.pb.go @@ -122,6 +122,8 @@ func (ProposalStatus) EnumDescriptor() ([]byte, []int) { } // WeightedVoteOption defines a unit of vote for vote split. +// +// Since: cosmos-sdk 0.43 type WeightedVoteOption struct { Option VoteOption `protobuf:"varint,1,opt,name=option,proto3,enum=cosmos.gov.v1beta1.VoteOption" json:"option,omitempty"` Weight github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,2,opt,name=weight,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"weight"` @@ -331,7 +333,8 @@ type Vote struct { // Deprecated: Prefer to use `options` instead. This field is set in queries // if and only if `len(options) == 1` and that option has weight 1. In all // other cases, this field will default to VOTE_OPTION_UNSPECIFIED. - Option VoteOption `protobuf:"varint,3,opt,name=option,proto3,enum=cosmos.gov.v1beta1.VoteOption" json:"option,omitempty"` // Deprecated: Do not use. + Option VoteOption `protobuf:"varint,3,opt,name=option,proto3,enum=cosmos.gov.v1beta1.VoteOption" json:"option,omitempty"` // Deprecated: Do not use. + // Since: cosmos-sdk 0.43 Options []WeightedVoteOption `protobuf:"bytes,4,rep,name=options,proto3" json:"options"` } diff --git a/x/gov/types/tx.pb.go b/x/gov/types/tx.pb.go index 77dc90080839..1326c6575c9d 100644 --- a/x/gov/types/tx.pb.go +++ b/x/gov/types/tx.pb.go @@ -194,6 +194,8 @@ func (m *MsgVoteResponse) XXX_DiscardUnknown() { var xxx_messageInfo_MsgVoteResponse proto.InternalMessageInfo // MsgVoteWeighted defines a message to cast a vote. +// +// Since: cosmos-sdk 0.43 type MsgVoteWeighted struct { ProposalId uint64 `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"proposal_id,omitempty"` Voter string `protobuf:"bytes,2,opt,name=voter,proto3" json:"voter,omitempty"` @@ -233,6 +235,8 @@ func (m *MsgVoteWeighted) XXX_DiscardUnknown() { var xxx_messageInfo_MsgVoteWeighted proto.InternalMessageInfo // MsgVoteWeightedResponse defines the Msg/VoteWeighted response type. +// +// Since: cosmos-sdk 0.43 type MsgVoteWeightedResponse struct { } @@ -420,6 +424,8 @@ type MsgClient interface { // Vote defines a method to add a vote on a specific proposal. Vote(ctx context.Context, in *MsgVote, opts ...grpc.CallOption) (*MsgVoteResponse, error) // VoteWeighted defines a method to add a weighted vote on a specific proposal. + // + // Since: cosmos-sdk 0.43 VoteWeighted(ctx context.Context, in *MsgVoteWeighted, opts ...grpc.CallOption) (*MsgVoteWeightedResponse, error) // Deposit defines a method to add deposit on a specific proposal. Deposit(ctx context.Context, in *MsgDeposit, opts ...grpc.CallOption) (*MsgDepositResponse, error) @@ -476,6 +482,8 @@ type MsgServer interface { // Vote defines a method to add a vote on a specific proposal. Vote(context.Context, *MsgVote) (*MsgVoteResponse, error) // VoteWeighted defines a method to add a weighted vote on a specific proposal. + // + // Since: cosmos-sdk 0.43 VoteWeighted(context.Context, *MsgVoteWeighted) (*MsgVoteWeightedResponse, error) // Deposit defines a method to add deposit on a specific proposal. Deposit(context.Context, *MsgDeposit) (*MsgDepositResponse, error) diff --git a/x/staking/types/authz.pb.go b/x/staking/types/authz.pb.go index c3e5f0d186c2..ac9c88271f25 100644 --- a/x/staking/types/authz.pb.go +++ b/x/staking/types/authz.pb.go @@ -26,6 +26,8 @@ var _ = math.Inf const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package // AuthorizationType defines the type of staking module authorization type +// +// Since: cosmos-sdk 0.43 type AuthorizationType int32 const ( @@ -62,6 +64,8 @@ func (AuthorizationType) EnumDescriptor() ([]byte, []int) { } // StakeAuthorization defines authorization for delegate/undelegate/redelegate. +// +// Since: cosmos-sdk 0.43 type StakeAuthorization struct { // max_tokens specifies the maximum amount of tokens can be delegate to a validator. If it is // empty, there is no spend limit and any amount of coins can be delegated. diff --git a/x/upgrade/types/query.pb.go b/x/upgrade/types/query.pb.go index 1f3acb808439..9b2daef286eb 100644 --- a/x/upgrade/types/query.pb.go +++ b/x/upgrade/types/query.pb.go @@ -263,6 +263,7 @@ func (m *QueryUpgradedConsensusStateRequest) GetLastHeight() int64 { // // Deprecated: Do not use. type QueryUpgradedConsensusStateResponse struct { + // Since: cosmos-sdk 0.43 UpgradedConsensusState []byte `protobuf:"bytes,2,opt,name=upgraded_consensus_state,json=upgradedConsensusState,proto3" json:"upgraded_consensus_state,omitempty"` } @@ -308,6 +309,8 @@ func (m *QueryUpgradedConsensusStateResponse) GetUpgradedConsensusState() []byte // QueryModuleVersionsRequest is the request type for the Query/ModuleVersions // RPC method. +// +// Since: cosmos-sdk 0.43 type QueryModuleVersionsRequest struct { // module_name is a field to query a specific module // consensus version from state. Leaving this empty will @@ -357,6 +360,8 @@ func (m *QueryModuleVersionsRequest) GetModuleName() string { // QueryModuleVersionsResponse is the response type for the Query/ModuleVersions // RPC method. +// +// Since: cosmos-sdk 0.43 type QueryModuleVersionsResponse struct { // module_versions is a list of module names with their consensus versions. ModuleVersions []*ModuleVersion `protobuf:"bytes,1,rep,name=module_versions,json=moduleVersions,proto3" json:"module_versions,omitempty"` @@ -482,6 +487,8 @@ type QueryClient interface { // (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54) UpgradedConsensusState(ctx context.Context, in *QueryUpgradedConsensusStateRequest, opts ...grpc.CallOption) (*QueryUpgradedConsensusStateResponse, error) // ModuleVersions queries the list of module versions from state. + // + // Since: cosmos-sdk 0.43 ModuleVersions(ctx context.Context, in *QueryModuleVersionsRequest, opts ...grpc.CallOption) (*QueryModuleVersionsResponse, error) } @@ -544,6 +551,8 @@ type QueryServer interface { // (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54) UpgradedConsensusState(context.Context, *QueryUpgradedConsensusStateRequest) (*QueryUpgradedConsensusStateResponse, error) // ModuleVersions queries the list of module versions from state. + // + // Since: cosmos-sdk 0.43 ModuleVersions(context.Context, *QueryModuleVersionsRequest) (*QueryModuleVersionsResponse, error) } diff --git a/x/upgrade/types/upgrade.pb.go b/x/upgrade/types/upgrade.pb.go index 7d496f5bd67b..20fb4b235077 100644 --- a/x/upgrade/types/upgrade.pb.go +++ b/x/upgrade/types/upgrade.pb.go @@ -166,6 +166,8 @@ func (m *CancelSoftwareUpgradeProposal) XXX_DiscardUnknown() { var xxx_messageInfo_CancelSoftwareUpgradeProposal proto.InternalMessageInfo // ModuleVersion specifies a module and its consensus version. +// +// Since: cosmos-sdk 0.43 type ModuleVersion struct { // name of the app module Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`