Use Since: cosmos-sdk 0.43

cosmos · Oct 26, 2021 · 1c8a923 · 1c8a923
1 parent 390a416
commit 1c8a923
Show file tree

Hide file tree

Showing 20 changed files with 80 additions and 8 deletions.
diff --git a/proto/cosmos/auth/v1beta1/query.proto b/proto/cosmos/auth/v1beta1/query.proto
@@ -14,7 +14,7 @@ option go_package = "github.com/cosmos/cosmos-sdk/x/auth/types";
 service Query {
   // Accounts returns all the existing accounts
   //
-  // @since Cosmos SDK 0.43
+  // Since: cosmos-sdk 0.43
   rpc Accounts(QueryAccountsRequest) returns (QueryAccountsResponse) {
     option (google.api.http).get = "/cosmos/auth/v1beta1/accounts";
   }
@@ -52,15 +52,15 @@ service Query {
 
 // QueryAccountsRequest is the request type for the Query/Accounts RPC method.
 //
-// @since Cosmos SDK 0.43
+// 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
+// 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
@@ -11,6 +11,8 @@ option (gogoproto.goproto_getters_all) = false;
 
 // GenericAuthorization gives the grantee unrestricted permissions to execute
 // the provided method on behalf of the granter's account.
+//
+// Since: cosmos-sdk 0.43
 message GenericAuthorization {
   option (cosmos_proto.implements_interface) = "Authorization";
 
@@ -20,6 +22,8 @@ message GenericAuthorization {
 
 // Grant gives permissions to execute
 // the provide method with expiration time.
+//
+// Since: cosmos-sdk 0.43
 message Grant {
   google.protobuf.Any       authorization = 1 [(cosmos_proto.accepts_interface) = "Authorization"];
   google.protobuf.Timestamp expiration    = 2 [(gogoproto.stdtime) = true, (gogoproto.nullable) = false];

diff --git a/proto/cosmos/authz/v1beta1/event.proto b/proto/cosmos/authz/v1beta1/event.proto
@@ -6,6 +6,8 @@ import "cosmos_proto/cosmos.proto";
 option go_package = "github.com/cosmos/cosmos-sdk/x/authz";
 
 // EventGrant is emitted on Msg/Grant
+//
+// Since: cosmos-sdk 0.43
 message EventGrant {
   // Msg type URL for which an autorization is granted
   string msg_type_url = 2;
@@ -16,6 +18,8 @@ message EventGrant {
 }
 
 // EventRevoke is emitted on Msg/Revoke
+//
+// Since: cosmos-sdk 0.43
 message EventRevoke {
   // Msg type URL for which an autorization is revoked
   string msg_type_url = 2;

diff --git a/proto/cosmos/authz/v1beta1/genesis.proto b/proto/cosmos/authz/v1beta1/genesis.proto
@@ -9,11 +9,15 @@ import "cosmos_proto/cosmos.proto";
 option go_package = "github.com/cosmos/cosmos-sdk/x/authz";
 
 // GenesisState defines the authz module's genesis state.
+//
+// Since: cosmos-sdk 0.43
 message GenesisState {
   repeated GrantAuthorization authorization = 1 [(gogoproto.nullable) = false];
 }
 
 // GrantAuthorization defines the GenesisState/GrantAuthorization type.
+//
+// Since: cosmos-sdk 0.43
 message GrantAuthorization {
   string granter = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   string grantee = 2 [(cosmos_proto.scalar) = "cosmos.AddressString"];

diff --git a/proto/cosmos/authz/v1beta1/query.proto b/proto/cosmos/authz/v1beta1/query.proto
@@ -9,6 +9,8 @@ import "cosmos_proto/cosmos.proto";
 option go_package = "github.com/cosmos/cosmos-sdk/x/authz";
 
 // Query defines the gRPC querier service.
+//
+// Since: cosmos-sdk 0.43
 service Query {
   // Returns list of `Authorization`, granted to the grantee by the granter.
   rpc Grants(QueryGrantsRequest) returns (QueryGrantsResponse) {
@@ -22,6 +24,8 @@ service Query {
 }
 
 // QueryGrantsRequest is the request type for the Query/Grants RPC method.
+//
+// Since: cosmos-sdk 0.43
 message QueryGrantsRequest {
   string granter = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   string grantee = 2 [(cosmos_proto.scalar) = "cosmos.AddressString"];
@@ -32,6 +36,8 @@ message QueryGrantsRequest {
 }
 
 // QueryGrantsResponse is the response type for the Query/Authorizations RPC method.
+//
+// Since: cosmos-sdk 0.43
 message QueryGrantsResponse {
   // authorizations is a list of grants granted for grantee by granter.
   repeated cosmos.authz.v1beta1.Grant grants = 1;
@@ -40,6 +46,8 @@ message QueryGrantsResponse {
 }
 
 // QueryGranterGrantsRequest is the request type for the Query/GranterGrants RPC method.
+//
+// Since: cosmos-sdk 0.43
 message QueryGranterGrantsRequest {
   string granter = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
@@ -48,6 +56,8 @@ message QueryGranterGrantsRequest {
 }
 
 // QueryGranterGrantsResponse is the response type for the Query/GranterGrants RPC method.
+//
+// Since: cosmos-sdk 0.43
 message QueryGranterGrantsResponse {
   // authorizations is a list of grants granted for grantee by granter.
   repeated cosmos.authz.v1beta1.Grant grants = 1;

diff --git a/proto/cosmos/authz/v1beta1/tx.proto b/proto/cosmos/authz/v1beta1/tx.proto
@@ -12,6 +12,8 @@ option go_package                      = "github.com/cosmos/cosmos-sdk/x/authz";
 option (gogoproto.goproto_getters_all) = false;
 
 // Msg defines the authz Msg service.
+//
+// Since: cosmos-sdk 0.43
 service Msg {
   // Grant grants the provided authorization to the grantee on the granter's
   // account with the provided expiration time. If there is already a grant
@@ -31,6 +33,8 @@ service Msg {
 
 // MsgGrant is a request type for Grant method. It declares authorization to the grantee
 // on behalf of the granter with the provided expiration time.
+//
+// Since: cosmos-sdk 0.43
 message MsgGrant {
   string granter = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   string grantee = 2 [(cosmos_proto.scalar) = "cosmos.AddressString"];
@@ -39,13 +43,17 @@ message MsgGrant {
 }
 
 // MsgExecResponse defines the Msg/MsgExecResponse response type.
+//
+// Since: cosmos-sdk 0.43
 message MsgExecResponse {
   repeated bytes results = 1;
 }
 
 // MsgExec attempts to execute the provided messages using
 // authorizations granted to the grantee. Each message should have only
 // one signer corresponding to the granter of the authorization.
+//
+// Since: cosmos-sdk 0.43
 message MsgExec {
   string grantee = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   // Authorization Msg requests to execute. Each msg must implement Authorization interface
@@ -55,15 +63,21 @@ message MsgExec {
 }
 
 // MsgGrantResponse defines the Msg/MsgGrant response type.
+//
+// Since: cosmos-sdk 0.43
 message MsgGrantResponse {}
 
 // MsgRevoke revokes any authorization with the provided sdk.Msg type on the
 // granter's account with that has been granted to the grantee.
+//
+// Since: cosmos-sdk 0.43
 message MsgRevoke {
   string granter      = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   string grantee      = 2 [(cosmos_proto.scalar) = "cosmos.AddressString"];;
   string msg_type_url = 3;
 }
 
 // MsgRevokeResponse defines the Msg/MsgRevokeResponse response type.
+//
+// Since: cosmos-sdk 0.43
 message MsgRevokeResponse {}
diff --git 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
@@ -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
@@ -33,7 +33,7 @@ message PageRequest {
 
   // reverse is set to true if results are to be returned in the descending order.
   //
-  // @since Cosmos SDK 0.43
+  // 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
@@ -1,4 +1,5 @@
 syntax = "proto3";
+// Since: cosmos-sdk 0.43
 package cosmos.base.reflection.v2alpha1;
 
 import "google/api/annotations.proto";

diff --git 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
@@ -124,7 +124,7 @@ message VersionInfo {
   string          build_tags         = 5;
   string          go_version         = 6;
   repeated Module build_deps         = 7;
-  // @since Cosmos SDK 0.43
+  // 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
@@ -1,4 +1,5 @@
 syntax = "proto3";
+// Since: cosmos-sdk 0.43
 package cosmos.crypto.secp256r1;
 
 import "gogoproto/gogo.proto";

diff --git 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
@@ -19,7 +19,7 @@ service Msg {
 
   // VoteWeighted defines a method to add a weighted vote on a specific proposal.
   //
-  // @since Cosmos SDK 0.43
+  // Since: cosmos-sdk 0.43
   rpc VoteWeighted(MsgVoteWeighted) returns (MsgVoteWeightedResponse);
 
   // Deposit defines a method to add deposit on a specific proposal.
@@ -64,7 +64,7 @@ message MsgVoteResponse {}
 
 // MsgVoteWeighted defines a message to cast a vote.
 //
-// @since Cosmos SDK 0.43
+// Since: cosmos-sdk 0.43
 message MsgVoteWeighted {
   option (gogoproto.equal)            = false;
   option (gogoproto.goproto_stringer) = false;
@@ -78,7 +78,7 @@ message MsgVoteWeighted {
 
 // MsgVoteWeightedResponse defines the Msg/VoteWeighted response type.
 //
-// @since Cosmos SDK 0.43
+// 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
@@ -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
@@ -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/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
@@ -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
@@ -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;