docs: improve documentation about authority in protos (cosmos#14531)

CHANGELOG.md

@@ -218,7 +218,7 @@ extension interfaces. `module.Manager.Modules` is now of type `map[string]interf
 ### Bug Fixes
 
 * (baseapp) [#14505](https://github.com/cosmos/cosmos-sdk/pull/14505) PrepareProposal and ProcessProposal now use deliverState for the first block in order to access changes made in InitChain.
-* (x/group) (x/group) [#14526](https://github.com/cosmos/cosmos-sdk/pull/14526) Fix wrong address set in `EventUpdateGroupPolicy`.
+* (x/group) [#14526](https://github.com/cosmos/cosmos-sdk/pull/14526) Fix wrong address set in `EventUpdateGroupPolicy`.
 * (server) [#14441](https://github.com/cosmos/cosmos-sdk/pull/14441) Fix `--log_format` flag not working.
 * (x/upgrade) [#13936](https://github.com/cosmos/cosmos-sdk/pull/13936) Make downgrade verification work again
 * (x/group) [#13742](https://github.com/cosmos/cosmos-sdk/pull/13742) Fix `validate-genesis` when group policy accounts exist.

UPGRADING.md

@@ -303,7 +303,7 @@ mistakes.
 
 #### `x/params`
 
-* The `x/param` module has been depreacted in favour of each module housing and providing way to modify their parameters. Each module that has parameters that are changable during runtime have an authority, the authority can be a module or user account. The Cosmos-SDK team recommends migrating modules away from using the param module. An example of how this could look like can be found [here](https://github.com/cosmos/cosmos-sdk/pull/12363). 
+* The `x/params` module has been depreacted in favour of each module housing and providing way to modify their parameters. Each module that has parameters that are changable during runtime have an authority, the authority can be a module or user account. The Cosmos-SDK team recommends migrating modules away from using the param module. An example of how this could look like can be found [here](https://github.com/cosmos/cosmos-sdk/pull/12363). 
 * The Param module will be maintained until April 18, 2023. At this point the module will reach end of life and be removed from the Cosmos SDK.
 
 #### `x/gov`

proto/cosmos/auth/v1beta1/tx.proto

@@ -13,8 +13,8 @@ option go_package = "github.com/cosmos/cosmos-sdk/x/auth/types";
 service Msg {
   option (cosmos.msg.v1.service) = true;
 
-  // UpdateParams defines a governance operation for updating the x/auth module
-  // parameters. The authority is hard-coded to the x/gov module account.
+  // UpdateParams defines a (governance) operation for updating the x/auth module
+  // parameters. The authority defaults to the x/gov module account.
   //
   // Since: cosmos-sdk 0.47
   rpc UpdateParams(MsgUpdateParams) returns (MsgUpdateParamsResponse);
@@ -27,7 +27,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/x/auth/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // params defines the x/auth parameters to update.

proto/cosmos/bank/v1beta1/tx.proto

@@ -77,7 +77,7 @@ message MsgMultiSendResponse {}
 message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority    = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   option (amino.name) = "cosmos-sdk/x/bank/MsgUpdateParams";
 

proto/cosmos/consensus/v1/tx.proto

@@ -21,7 +21,7 @@ service Msg {
 message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // params defines the x/consensus parameters to update.

proto/cosmos/crisis/v1beta1/tx.proto

@@ -51,7 +51,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/x/crisis/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // constant_fee defines the x/crisis parameter.

proto/cosmos/distribution/v1beta1/tx.proto

@@ -149,7 +149,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/distribution/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // params defines the x/distribution parameters to update.
@@ -174,7 +174,7 @@ message MsgCommunityPoolSpend {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/distr/MsgCommunityPoolSpend";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string   authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   string   recipient = 2;
   repeated cosmos.base.v1beta1.Coin amount = 3 [

proto/cosmos/gov/v1/tx.proto

@@ -156,7 +156,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/x/gov/v1/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // params defines the x/gov parameters to update.

proto/cosmos/mint/v1beta1/tx.proto

@@ -14,7 +14,7 @@ service Msg {
   option (cosmos.msg.v1.service) = true;
 
   // UpdateParams defines a governance operation for updating the x/mint module
-  // parameters. The authority is hard-coded to the x/gov module account.
+  // parameters. The authority is defaults to the x/gov module account.
   //
   // Since: cosmos-sdk 0.47
   rpc UpdateParams(MsgUpdateParams) returns (MsgUpdateParamsResponse);
@@ -27,7 +27,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/x/mint/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // params defines the x/mint parameters to update.

proto/cosmos/slashing/v1beta1/tx.proto

@@ -20,7 +20,7 @@ service Msg {
   rpc Unjail(MsgUnjail) returns (MsgUnjailResponse);
 
   // UpdateParams defines a governance operation for updating the x/slashing module
-  // parameters. The authority is hard-coded to the x/gov module account.
+  // parameters. The authority defaults to the x/gov module account.
   //
   // Since: cosmos-sdk 0.47
   rpc UpdateParams(MsgUpdateParams) returns (MsgUpdateParamsResponse);
@@ -51,7 +51,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/x/slashing/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // params defines the x/slashing parameters to update.

proto/cosmos/staking/v1beta1/tx.proto

@@ -186,7 +186,7 @@ message MsgUpdateParams {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/x/staking/MsgUpdateParams";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
   // params defines the x/staking parameters to update.
   //

proto/cosmos/upgrade/v1beta1/tx.proto

@@ -33,7 +33,7 @@ message MsgSoftwareUpgrade {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/MsgSoftwareUpgrade";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 
   // plan is the upgrade plan.
@@ -52,7 +52,7 @@ message MsgCancelUpgrade {
   option (cosmos.msg.v1.signer) = "authority";
   option (amino.name)           = "cosmos-sdk/MsgCancelUpgrade";
 
-  // authority is the address of the governance account.
+  // authority is the address that controls the module (defaults to x/gov unless overwritten).
   string authority = 1 [(cosmos_proto.scalar) = "cosmos.AddressString"];
 }