From 697dd7ce69f2a88e1c65c8bfa15c617d031f2e9f Mon Sep 17 00:00:00 2001 From: "mergify[bot]" <37929162+mergify[bot]@users.noreply.github.com> Date: Fri, 29 Oct 2021 09:42:49 +0200 Subject: [PATCH] chore: Add "Since:" on proto doc comments (backport #10434) (#10449) * 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) (cherry picked from commit 0a3660d2ac96e75edfa6ddfce8e97fccb012d19c) # Conflicts: # docs/core/proto-docs.md # proto/cosmos/bank/v1beta1/bank.proto # proto/cosmos/tx/v1beta1/tx.proto # types/tx/tx.pb.go # x/bank/types/bank.pb.go * Fix conflicts Co-authored-by: Amaury <1293565+amaurym@users.noreply.github.com> --- client/grpc/cmtservice/query.pb.go | 17 +++++----- proto/cosmos/auth/v1beta1/query.proto | 10 ++++-- .../base/query/v1beta1/pagination.proto | 4 ++- .../base/tendermint/v1beta1/query.proto | 3 +- proto/cosmos/tx/v1beta1/service.proto | 4 ++- store/types/listening.pb.go | 8 +++-- types/query/pagination.pb.go | 2 ++ types/tx/service.pb.go | 2 ++ x/auth/types/query.pb.go | 32 +++++++++++++++---- .../cosmos/vesting/v1beta1/vesting.proto | 2 ++ x/bank/types/authz.pb.go | 2 ++ x/bank/types/bank.pb.go | 4 +++ x/bank/types/query.pb.go | 4 +++ x/gov/proto/cosmos/gov/v1beta1/gov.proto | 9 +++--- x/gov/types/v1beta1/gov.pb.go | 4 +-- x/gov/types/v1beta1/tx.pb.go | 8 +++++ .../proto/cosmos/staking/v1beta1/authz.proto | 2 ++ x/staking/types/authz.pb.go | 2 ++ .../proto/cosmos/upgrade/v1beta1/query.proto | 9 +++++- .../cosmos/upgrade/v1beta1/upgrade.proto | 2 ++ x/upgrade/types/query.pb.go | 9 ++++++ x/upgrade/types/upgrade.pb.go | 2 ++ 22 files changed, 110 insertions(+), 31 deletions(-) diff --git a/client/grpc/cmtservice/query.pb.go b/client/grpc/cmtservice/query.pb.go index 37cedbed196c..12db44082740 100644 --- a/client/grpc/cmtservice/query.pb.go +++ b/client/grpc/cmtservice/query.pb.go @@ -709,14 +709,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/proto/cosmos/auth/v1beta1/query.proto b/proto/cosmos/auth/v1beta1/query.proto index c2f14e8be736..57fabee4c6d8 100644 --- a/proto/cosmos/auth/v1beta1/query.proto +++ b/proto/cosmos/auth/v1beta1/query.proto @@ -13,9 +13,9 @@ 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. - // When called from another module, this query might consume a high amount of - // gas if the pagination field is incorrectly set. + // Accounts returns all the existing accounts + // + // Since: cosmos-sdk 0.43 rpc Accounts(QueryAccountsRequest) returns (QueryAccountsResponse) { option (cosmos_proto.method_added_in) = "cosmos-sdk 0.43"; option (cosmos.query.v1.module_query_safe) = true; @@ -81,6 +81,8 @@ service Query { } // QueryAccountsRequest is the request type for the Query/Accounts RPC method. +// +// Since: cosmos-sdk 0.43 message QueryAccountsRequest { option (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; // pagination defines an optional pagination for the request. @@ -88,6 +90,8 @@ message QueryAccountsRequest { } // QueryAccountsResponse is the response type for the Query/Accounts RPC method. +// +// Since: cosmos-sdk 0.43 message QueryAccountsResponse { option (cosmos_proto.message_added_in) = "cosmos-sdk 0.47"; // accounts are the existing accounts diff --git a/proto/cosmos/base/query/v1beta1/pagination.proto b/proto/cosmos/base/query/v1beta1/pagination.proto index fc5f376db520..9ff297104b99 100644 --- a/proto/cosmos/base/query/v1beta1/pagination.proto +++ b/proto/cosmos/base/query/v1beta1/pagination.proto @@ -34,7 +34,9 @@ message PageRequest { bool count_total = 4; // reverse is set to true if results are to be returned in the descending order. - bool reverse = 5 [(cosmos_proto.field_added_in) = "cosmos-sdk 0.43"]; + // + // Since: cosmos-sdk 0.43 + bool reverse = 5; } // PageResponse is to be embedded in gRPC response messages where the diff --git a/proto/cosmos/base/tendermint/v1beta1/query.proto b/proto/cosmos/base/tendermint/v1beta1/query.proto index 9e17e952118c..98fd8997982b 100644 --- a/proto/cosmos/base/tendermint/v1beta1/query.proto +++ b/proto/cosmos/base/tendermint/v1beta1/query.proto @@ -147,7 +147,8 @@ message VersionInfo { string build_tags = 5; string go_version = 6; repeated Module build_deps = 7; - string cosmos_sdk_version = 8 [(cosmos_proto.field_added_in) = "cosmos-sdk 0.43"]; + // Since: cosmos-sdk 0.43 + string cosmos_sdk_version = 8; } // Module is the type for VersionInfo diff --git a/proto/cosmos/tx/v1beta1/service.proto b/proto/cosmos/tx/v1beta1/service.proto index fbd503444305..bddb00acec8d 100644 --- a/proto/cosmos/tx/v1beta1/service.proto +++ b/proto/cosmos/tx/v1beta1/service.proto @@ -164,7 +164,9 @@ message SimulateRequest { // Deprecated. Send raw tx bytes instead. cosmos.tx.v1beta1.Tx tx = 1 [deprecated = true]; // tx_bytes is the raw transaction. - bytes tx_bytes = 2 [(cosmos_proto.field_added_in) = "cosmos-sdk 0.43"]; + // + // Since: cosmos-sdk 0.43 + bytes tx_bytes = 2; } // SimulateResponse is the response type for the diff --git a/store/types/listening.pb.go b/store/types/listening.pb.go index 1821ca474a6f..66b3769e12d3 100644 --- a/store/types/listening.pb.go +++ b/store/types/listening.pb.go @@ -24,9 +24,11 @@ var _ = math.Inf // proto package needs to be updated. 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 +// 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 650eddf93dcc..c06c8918479a 100644 --- a/types/query/pagination.pb.go +++ b/types/query/pagination.pb.go @@ -48,6 +48,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 f5e9499ce192..93a9a2eb929a 100644 --- a/types/tx/service.pb.go +++ b/types/tx/service.pb.go @@ -389,6 +389,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/x/auth/types/query.pb.go b/x/auth/types/query.pb.go index b127caf89b2a..7861e0be52e7 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 []*any.Any `protobuf:"bytes,1,rep,name=accounts,proto3" json:"accounts,omitempty"` @@ -338,9 +342,18 @@ func (m *QueryModuleAccountsRequest) XXX_DiscardUnknown() { var xxx_messageInfo_QueryModuleAccountsRequest proto.InternalMessageInfo -// QueryModuleAccountsResponse is the response type for the Query/ModuleAccounts RPC method. -type QueryModuleAccountsResponse struct { - Accounts []*any.Any `protobuf:"bytes,1,rep,name=accounts,proto3" json:"accounts,omitempty"` +// QueryClient is the client API for Query service. +// +// 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) + // Params queries all parameters. + Params(ctx context.Context, in *QueryParamsRequest, opts ...grpc.CallOption) (*QueryParamsResponse, error) } func (m *QueryModuleAccountsResponse) Reset() { *m = QueryModuleAccountsResponse{} } @@ -383,9 +396,16 @@ func (m *QueryModuleAccountsResponse) GetAccounts() []*any.Any { return nil } -// QueryModuleAccountByNameRequest is the request type for the Query/ModuleAccountByName RPC method. -type QueryModuleAccountByNameRequest struct { - Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` +// 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) + // Params queries all parameters. + Params(context.Context, *QueryParamsRequest) (*QueryParamsResponse, error) } func (m *QueryModuleAccountByNameRequest) Reset() { *m = QueryModuleAccountByNameRequest{} } diff --git a/x/auth/vesting/proto/cosmos/vesting/v1beta1/vesting.proto b/x/auth/vesting/proto/cosmos/vesting/v1beta1/vesting.proto index 64b75641c495..cf622f90ed18 100644 --- a/x/auth/vesting/proto/cosmos/vesting/v1beta1/vesting.proto +++ b/x/auth/vesting/proto/cosmos/vesting/v1beta1/vesting.proto @@ -84,6 +84,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 (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; option (amino.name) = "cosmos-sdk/PermanentLockedAccount"; diff --git a/x/bank/types/authz.pb.go b/x/bank/types/authz.pb.go index 008ed319e200..3b62f5161985 100644 --- a/x/bank/types/authz.pb.go +++ b/x/bank/types/authz.pb.go @@ -29,6 +29,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"` // allow_list specifies an optional list of addresses to whom the grantee can send tokens on behalf of the diff --git a/x/bank/types/bank.pb.go b/x/bank/types/bank.pb.go index 38df467fb9c2..05861816ec5d 100644 --- a/x/bank/types/bank.pb.go +++ b/x/bank/types/bank.pb.go @@ -343,9 +343,13 @@ 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. URI string `protobuf:"bytes,7,opt,name=uri,proto3" json:"uri,omitempty"` diff --git a/x/bank/types/query.pb.go b/x/bank/types/query.pb.go index 6b7756a2816d..7ca76309972e 100644 --- a/x/bank/types/query.pb.go +++ b/x/bank/types/query.pb.go @@ -411,6 +411,8 @@ func (m *QuerySpendableBalanceByDenomResponse) GetBalance() *types.Coin { // 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"` } @@ -453,6 +455,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/proto/cosmos/gov/v1beta1/gov.proto b/x/gov/proto/cosmos/gov/v1beta1/gov.proto index 630fe9dba98a..6953d348d785 100644 --- a/x/gov/proto/cosmos/gov/v1beta1/gov.proto +++ b/x/gov/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 { option (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; // option defines the valid vote options, it must not contain duplicate vote options. @@ -190,12 +192,9 @@ message Vote { // 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. - VoteOption option = 3 [deprecated = true]; - - // options is the weighted vote options. - // + VoteOption option = 3 [deprecated = true]; // Since: cosmos-sdk 0.43 - repeated WeightedVoteOption options = 4 [(gogoproto.nullable) = false, (amino.dont_omitempty) = true]; + repeated WeightedVoteOption options = 4 [(gogoproto.nullable) = false]; } // DepositParams defines the params for deposits on governance proposals. diff --git a/x/gov/types/v1beta1/gov.pb.go b/x/gov/types/v1beta1/gov.pb.go index 146d0fe513a3..3e640b326c4b 100644 --- a/x/gov/types/v1beta1/gov.pb.go +++ b/x/gov/types/v1beta1/gov.pb.go @@ -124,6 +124,8 @@ func (ProposalStatus) EnumDescriptor() ([]byte, []int) { } // WeightedVoteOption defines a unit of vote for vote split. +// +// Since: cosmos-sdk 0.43 type WeightedVoteOption struct { // option defines the valid vote options, it must not contain duplicate vote options. Option VoteOption `protobuf:"varint,1,opt,name=option,proto3,enum=cosmos.gov.v1beta1.VoteOption" json:"option,omitempty"` @@ -363,8 +365,6 @@ type Vote struct { // 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. - // options is the weighted vote options. - // // Since: cosmos-sdk 0.43 Options []WeightedVoteOption `protobuf:"bytes,4,rep,name=options,proto3" json:"options"` } diff --git a/x/gov/types/v1beta1/tx.pb.go b/x/gov/types/v1beta1/tx.pb.go index 5bf73f14d84b..cae5c55ee832 100644 --- a/x/gov/types/v1beta1/tx.pb.go +++ b/x/gov/types/v1beta1/tx.pb.go @@ -205,6 +205,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 { // proposal_id defines the unique id of the proposal. ProposalId uint64 `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"proposal_id"` @@ -248,6 +250,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 { } @@ -447,6 +451,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) @@ -503,6 +509,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/proto/cosmos/staking/v1beta1/authz.proto b/x/staking/proto/cosmos/staking/v1beta1/authz.proto index 0ffe54cc70aa..0ec018c5ffaf 100644 --- a/x/staking/proto/cosmos/staking/v1beta1/authz.proto +++ b/x/staking/proto/cosmos/staking/v1beta1/authz.proto @@ -9,6 +9,8 @@ import "amino/amino.proto"; option go_package = "cosmossdk.io/x/staking/types"; // StakeAuthorization defines authorization for delegate/undelegate/redelegate. +// +// Since: cosmos-sdk 0.43 message StakeAuthorization { option (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; option (cosmos_proto.implements_interface) = "cosmos.authz.v1beta1.Authorization"; diff --git a/x/staking/types/authz.pb.go b/x/staking/types/authz.pb.go index 257df694ad51..8f549b7ae6d4 100644 --- a/x/staking/types/authz.pb.go +++ b/x/staking/types/authz.pb.go @@ -69,6 +69,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/proto/cosmos/upgrade/v1beta1/query.proto b/x/upgrade/proto/cosmos/upgrade/v1beta1/query.proto index 410305eaf6da..8cd13b44eb84 100644 --- a/x/upgrade/proto/cosmos/upgrade/v1beta1/query.proto +++ b/x/upgrade/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"; option (cosmos_proto.method_added_in) = "cosmos-sdk 0.43"; @@ -84,11 +86,14 @@ message QueryUpgradedConsensusStateResponse { option deprecated = true; reserved 1; - bytes upgraded_consensus_state = 2 [(cosmos_proto.field_added_in) = "cosmos-sdk 0.43"]; + // 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 { option (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; // module_name is a field to query a specific module @@ -99,6 +104,8 @@ message QueryModuleVersionsRequest { // QueryModuleVersionsResponse is the response type for the Query/ModuleVersions // RPC method. +// +// Since: cosmos-sdk 0.43 message QueryModuleVersionsResponse { option (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; // module_versions is a list of module names with their consensus versions. diff --git a/x/upgrade/proto/cosmos/upgrade/v1beta1/upgrade.proto b/x/upgrade/proto/cosmos/upgrade/v1beta1/upgrade.proto index 62d0976c37c9..caa023cb5437 100644 --- a/x/upgrade/proto/cosmos/upgrade/v1beta1/upgrade.proto +++ b/x/upgrade/proto/cosmos/upgrade/v1beta1/upgrade.proto @@ -81,6 +81,8 @@ message CancelSoftwareUpgradeProposal { } // ModuleVersion specifies a module and its consensus version. +// +// Since: cosmos-sdk 0.43 message ModuleVersion { option (gogoproto.equal) = true; option (cosmos_proto.message_added_in) = "cosmos-sdk 0.43"; diff --git a/x/upgrade/types/query.pb.go b/x/upgrade/types/query.pb.go index 78b22892dd92..3f46ac61aa44 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"` @@ -566,6 +571,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) // Returns the account with authority to conduct upgrades Authority(ctx context.Context, in *QueryAuthorityRequest, opts ...grpc.CallOption) (*QueryAuthorityResponse, error) @@ -639,6 +646,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) // Returns the account with authority to conduct upgrades Authority(context.Context, *QueryAuthorityRequest) (*QueryAuthorityResponse, error) diff --git a/x/upgrade/types/upgrade.pb.go b/x/upgrade/types/upgrade.pb.go index 3123881959b5..2e99b029258f 100644 --- a/x/upgrade/types/upgrade.pb.go +++ b/x/upgrade/types/upgrade.pb.go @@ -183,6 +183,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"`