diff --git a/proto/cosmos/auth/v1beta1/auth.proto b/proto/cosmos/auth/v1beta1/auth.proto
index 90ada9d92f..c07466e0d9 100644
--- a/proto/cosmos/auth/v1beta1/auth.proto
+++ b/proto/cosmos/auth/v1beta1/auth.proto
@@ -20,7 +20,7 @@ message BaseAccount {
   uint64 sequence       = 4;
 }
 
-// ModuleAccount defines an account for modules that holds coins on a pool
+// ModuleAccount defines an account for modules that holds coins on a pool.
 message ModuleAccount {
   option (gogoproto.goproto_getters)  = false;
   option (gogoproto.goproto_stringer) = false;
diff --git a/proto/cosmos/bank/v1beta1/bank.proto b/proto/cosmos/bank/v1beta1/bank.proto
index 817b4b2df6..74e6c1f746 100644
--- a/proto/cosmos/bank/v1beta1/bank.proto
+++ b/proto/cosmos/bank/v1beta1/bank.proto
@@ -7,14 +7,14 @@ import "cosmos/base/v1beta1/coin.proto";
 
 option go_package = "github.com/cosmos/cosmos-sdk/x/bank/types";
 
-// Params defines the set of bank parameters.
+// Params defines the parameters for the bank module.
 message Params {
   option (gogoproto.goproto_stringer)       = false;
   repeated SendEnabled send_enabled         = 1 [(gogoproto.moretags) = "yaml:\"send_enabled,omitempty\""];
   bool                 default_send_enabled = 2 [(gogoproto.moretags) = "yaml:\"default_send_enabled,omitempty\""];
 }
 
-// Send enabled configuration properties for each denomination
+// SendEnabled maps coin denom to a send_enabled status (whether a denom is sendable).
 message SendEnabled {
   option (gogoproto.equal)            = true;
   option (gogoproto.goproto_stringer) = false;
@@ -22,7 +22,7 @@ message SendEnabled {
   bool   enabled                      = 2;
 }
 
-// Input models transaction input
+// Input models transaction input.
 message Input {
   option (gogoproto.equal) = true;
 
@@ -31,7 +31,7 @@ message Input {
       [(gogoproto.nullable) = false, (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"];
 }
 
-// Output models transaction outputs
+// Output models transaction outputs.
 message Output {
   option (gogoproto.equal) = true;
 
@@ -52,19 +52,30 @@ message Supply {
       [(gogoproto.nullable) = false, (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"];
 }
 
-// DenomUnits represents a struct that describes different
-// denominations units of the basic token
-message DenomUnits {
+// DenomUnit represents a struct that describes a given 
+// denomination unit of the basic token.
+message DenomUnit {
+  // denom represents the string name of the given denom unit (e.g uatom).
   string          denom    = 1;
-  uint32          exponent = 2;
+  // exponent represents power of 10 exponent that one must
+  // raise the base_denom to in order to equal the given DenomUnit's denom
+  // 1 denom = 1^exponent base_denom
+  // (e.g. with a base_denom of uatom, one can create a DenomUnit of 'atom' with 
+  // exponent = 6, thus: 1 atom = 10^6 uatom).
+  uint32          exponent = 2;  
+  // aliases is a list of string aliases for the given denom
   repeated string aliases  = 3;
 }
 
-// Metadata represents a struct that describes
-// a basic token
+// Metadata represents a struct that describes 
+// a basic token.
 message Metadata {
-  string              description = 1;
-  repeated DenomUnits denom_units = 2;
-  string              base        = 3;
-  string              display     = 4;
-}
+  string             description = 1;
+  // denom_units represents the list of DenomUnit's for a given coin
+  repeated DenomUnit denom_units = 2;
+  // base represents the base denom (should be the DenomUnit with exponent = 0).
+  string             base        = 3;
+  // display indicates the suggested denom that should be
+  // displayed in clients.
+  string             display     = 4;
+}
\ No newline at end of file
diff --git a/proto/cosmos/bank/v1beta1/tx.proto b/proto/cosmos/bank/v1beta1/tx.proto
index 17e0c96142..0ff9794cd4 100644
--- a/proto/cosmos/bank/v1beta1/tx.proto
+++ b/proto/cosmos/bank/v1beta1/tx.proto
@@ -7,7 +7,7 @@ import "cosmos/bank/v1beta1/bank.proto";
 
 option go_package = "github.com/cosmos/cosmos-sdk/x/bank/types";
 
-// MsgSend - high level transaction of the coin module
+// MsgSend represents a message to send coins from one account to another.
 message MsgSend {
   option (gogoproto.equal) = true;
 
@@ -23,10 +23,10 @@ message MsgSend {
       [(gogoproto.nullable) = false, (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"];
 }
 
-// MsgMultiSend - high level transaction of the coin module
+// MsgMultiSend represents an arbitrary multi-in, multi-out send message.
 message MsgMultiSend {
   option (gogoproto.equal) = true;
 
   repeated Input  inputs  = 1 [(gogoproto.nullable) = false];
   repeated Output outputs = 2 [(gogoproto.nullable) = false];
-}
\ No newline at end of file
+}
diff --git a/proto/cosmos/base/query/v1beta1/pagination.proto b/proto/cosmos/base/query/v1beta1/pagination.proto
index 486a9759ad..8539fbdce6 100644
--- a/proto/cosmos/base/query/v1beta1/pagination.proto
+++ b/proto/cosmos/base/query/v1beta1/pagination.proto
@@ -32,7 +32,7 @@ message PageRequest {
 }
 
 // PageResponse is to be embedded in gRPC response messages where the corresponding
-// request message has used PageRequest
+// request message has used PageRequest.
 //
 //  message SomeResponse {
 //          repeated Bar results = 1;
diff --git a/proto/cosmos/crisis/v1beta1/tx.proto b/proto/cosmos/crisis/v1beta1/tx.proto
index ff44db6977..84d1f0101a 100644
--- a/proto/cosmos/crisis/v1beta1/tx.proto
+++ b/proto/cosmos/crisis/v1beta1/tx.proto
@@ -5,7 +5,7 @@ option go_package = "github.com/cosmos/cosmos-sdk/x/crisis/types";
 
 import "gogoproto/gogo.proto";
 
-// MsgVerifyInvariant - message struct to verify a particular invariance
+// MsgVerifyInvariant represents a message to verify a particular invariance.
 message MsgVerifyInvariant {
   option (gogoproto.equal) = true;
 
diff --git a/proto/cosmos/distribution/v1beta1/distribution.proto b/proto/cosmos/distribution/v1beta1/distribution.proto
index 7aace2071f..eaf514bb43 100644
--- a/proto/cosmos/distribution/v1beta1/distribution.proto
+++ b/proto/cosmos/distribution/v1beta1/distribution.proto
@@ -7,7 +7,7 @@ option (gogoproto.equal_all) = true;
 import "gogoproto/gogo.proto";
 import "cosmos/base/v1beta1/coin.proto";
 
-// Params defines the set of distribution parameters.
+// Params defines the set of params for the distribution module.
 message Params {
   option (gogoproto.goproto_stringer) = false;
   string community_tax                = 1 [
@@ -28,13 +28,12 @@ message Params {
   bool withdraw_addr_enabled = 4 [(gogoproto.moretags) = "yaml:\"withdraw_addr_enabled\""];
 }
 
-// historical rewards for a validator
-// height is implicit within the store key
-// cumulative reward ratio is the sum from the zeroeth period
-// until this period of rewards / tokens, per the spec
+// ValidatorHistoricalRewards represents historical rewards for a validator.
+// Height is implicit within the store key.
+// Cumulative reward ratio is the sum from the zeroeth period
+// until this period of rewards / tokens, per the spec.
 // The reference count indicates the number of objects
-// which might need to reference this historical entry
-// at any point.
+// which might need to reference this historical entry at any point.
 // ReferenceCount =
 //    number of outstanding delegations which ended the associated period (and might need to read
 //    that record)
@@ -49,9 +48,9 @@ message ValidatorHistoricalRewards {
   uint32 reference_count = 2 [(gogoproto.moretags) = "yaml:\"reference_count\""];
 }
 
-// current rewards and current period for a validator
-// kept as a running counter and incremented each block
-// as long as the validator's tokens remain constant
+// ValidatorCurrentRewards represents current rewards and current
+// period for a validator kept as a running counter and incremented
+// each block as long as the validator's tokens remain constant.
 message ValidatorCurrentRewards {
   repeated cosmos.base.v1beta1.DecCoin rewards = 1 [
     (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.DecCoins",
@@ -60,8 +59,8 @@ message ValidatorCurrentRewards {
   uint64 period = 2;
 }
 
-// accumulated commission for a validator
-// kept as a running counter, can be withdrawn at any time
+// ValidatorAccumulatedCommission represents accumulated commission
+// for a validator kept as a running counter, can be withdrawn at any time.
 message ValidatorAccumulatedCommission {
   repeated cosmos.base.v1beta1.DecCoin commission = 1 [
     (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.DecCoins",
@@ -69,8 +68,8 @@ message ValidatorAccumulatedCommission {
   ];
 }
 
-// outstanding (un-withdrawn) rewards for a validator
-// inexpensive to track, allows simple sanity checks
+// ValidatorOutstandingRewards represents outstanding (un-withdrawn) rewards
+// for a validator inexpensive to track, allows simple sanity checks.
 message ValidatorOutstandingRewards {
   repeated cosmos.base.v1beta1.DecCoin rewards = 1 [
     (gogoproto.moretags)     = "yaml:\"rewards\"",
@@ -79,10 +78,10 @@ message ValidatorOutstandingRewards {
   ];
 }
 
-// validator slash event
-// height is implicit within the store key
-// needed to calculate appropriate amounts of staking token
-// for delegations which withdraw after a slash has occurred
+// ValidatorSlashEvent represents a validator slash event.
+// Height is implicit within the store key.
+// This is needed to calculate appropriate amount of staking tokens
+// for delegations which are withdrawn after a slash has occurred.
 message ValidatorSlashEvent {
   uint64 validator_period = 1 [(gogoproto.moretags) = "yaml:\"validator_period\""];
   string fraction         = 2 [
@@ -91,14 +90,14 @@ message ValidatorSlashEvent {
   ];
 }
 
-// ValidatorSlashEvents is a collection of ValidatorSlashEvent
+// ValidatorSlashEvents is a collection of ValidatorSlashEvent messages.
 message ValidatorSlashEvents {
   option (gogoproto.goproto_stringer)                 = false;
   repeated ValidatorSlashEvent validator_slash_events = 1
       [(gogoproto.moretags) = "yaml:\"validator_slash_events\"", (gogoproto.nullable) = false];
 }
 
-// global fee pool for distribution
+// FeePool is the global fee pool for distribution.
 message FeePool {
   repeated cosmos.base.v1beta1.DecCoin community_pool = 1 [
     (gogoproto.nullable)     = false,
@@ -107,7 +106,9 @@ message FeePool {
   ];
 }
 
-// CommunityPoolSpendProposal spends from the community pool
+// CommunityPoolSpendProposal details a proposal for use of community funds,
+// together with how many coins are proposed to be spent, and to which
+// recipient account.
 message CommunityPoolSpendProposal {
   option (gogoproto.goproto_stringer) = false;
   option (gogoproto.goproto_getters)  = false;
@@ -120,13 +121,13 @@ message CommunityPoolSpendProposal {
   ];
 }
 
-// starting info for a delegator reward period
-// tracks the previous validator period, the delegation's amount
+// DelegatorStartingInfo represents the starting info for a delegator reward period.
+// It tracks the previous validator period, the delegation's amount
 // of staking token, and the creation height (to check later on
-// if any slashes have occurred)
-// NOTE that even though validators are slashed to whole staking tokens, the
+// if any slashes have occurred).
+// NOTE: Even though validators are slashed to whole staking tokens, the
 // delegators within the validator may be left with less than a full token,
-// thus sdk.Dec is used
+// thus sdk.Dec is used.
 message DelegatorStartingInfo {
   uint64 previous_period = 1 [(gogoproto.moretags) = "yaml:\"previous_period\""];
   string stake           = 2 [
@@ -138,7 +139,7 @@ message DelegatorStartingInfo {
       [(gogoproto.moretags) = "yaml:\"creation_height\"", (gogoproto.jsontag) = "creation_height"];
 }
 
-// DelegationDelegatorReward defines the properties
+// DelegationDelegatorReward represents the properties
 // of a delegator's delegation reward.
 message DelegationDelegatorReward {
   bytes validator_address = 1 [
diff --git a/proto/cosmos/distribution/v1beta1/tx.proto b/proto/cosmos/distribution/v1beta1/tx.proto
index 3887d8aa37..60c555dde7 100644
--- a/proto/cosmos/distribution/v1beta1/tx.proto
+++ b/proto/cosmos/distribution/v1beta1/tx.proto
@@ -7,7 +7,8 @@ option (gogoproto.equal_all) = true;
 import "gogoproto/gogo.proto";
 import "cosmos/base/v1beta1/coin.proto";
 
-// msg struct for changing the withdraw address for a delegator (or validator self-delegation)
+// MsgSetWithdrawAddress sets the withdraw address for
+// a delegator (or validator self-delegation).
 message MsgSetWithdrawAddress {
   bytes delegator_address = 1 [
     (gogoproto.casttype) = "github.com/cosmos/cosmos-sdk/types.AccAddress",
@@ -19,7 +20,8 @@ message MsgSetWithdrawAddress {
   ];
 }
 
-// msg struct for delegation withdraw from a single validator
+// MsgWithdrawDelegatorReward represents delegation withdrawal to a delegator
+// from a single validator.
 message MsgWithdrawDelegatorReward {
   bytes delegator_address = 1 [
     (gogoproto.casttype) = "github.com/cosmos/cosmos-sdk/types.AccAddress",
@@ -31,7 +33,7 @@ message MsgWithdrawDelegatorReward {
   ];
 }
 
-// msg struct for validator withdraw
+// MsgWithdrawValidatorCommission withdraws the full commission to the validator address.
 message MsgWithdrawValidatorCommission {
   bytes validator_address = 1 [
     (gogoproto.casttype) = "github.com/cosmos/cosmos-sdk/types.ValAddress",
@@ -39,7 +41,7 @@ message MsgWithdrawValidatorCommission {
   ];
 }
 
-// MsgFundCommunityPool defines a Msg type that allows an account to directly
+// MsgFundCommunityPool allows an account to directly
 // fund the community pool.
 message MsgFundCommunityPool {
   repeated cosmos.base.v1beta1.Coin amount = 1 [
diff --git a/proto/cosmos/evidence/v1beta1/tx.proto b/proto/cosmos/evidence/v1beta1/tx.proto
index 664924638a..c8c51b694b 100644
--- a/proto/cosmos/evidence/v1beta1/tx.proto
+++ b/proto/cosmos/evidence/v1beta1/tx.proto
@@ -8,8 +8,8 @@ import "gogoproto/gogo.proto";
 import "google/protobuf/any.proto";
 import "cosmos_proto/cosmos.proto";
 
-// MsgSubmitEvidence defines an sdk.Msg type that supports submitting arbitrary
-// Evidence.
+// MsgSubmitEvidence represents a message that supports submitting arbitrary
+// Evidence of misbehavior such as equivocation or counterfactual signing.
 message MsgSubmitEvidence {
   option (gogoproto.goproto_getters)  = false;
   bytes submitter = 1 [(gogoproto.casttype) = "github.com/cosmos/cosmos-sdk/types.AccAddress"];
diff --git a/proto/cosmos/gov/v1beta1/gov.proto b/proto/cosmos/gov/v1beta1/gov.proto
index acce2bfd1c..6bcc00a9de 100644
--- a/proto/cosmos/gov/v1beta1/gov.proto
+++ b/proto/cosmos/gov/v1beta1/gov.proto
@@ -13,7 +13,7 @@ option (gogoproto.goproto_stringer_all) = false;
 option (gogoproto.stringer_all)         = false;
 option (gogoproto.goproto_getters_all)  = false;
 
-// VoteOption defines a vote option
+// VoteOption enumerates the valid vote options for a given governance proposal.
 enum VoteOption {
   option (gogoproto.goproto_enum_prefix)   = false;
 
@@ -30,7 +30,7 @@ enum VoteOption {
 }
 
 // TextProposal defines a standard text proposal whose changes need to be
-// manually updated in case of approval
+// manually updated in case of approval.
 message TextProposal {
   option (cosmos_proto.implements_interface) = "Content";
 
@@ -40,7 +40,7 @@ message TextProposal {
   string description = 2;
 }
 
-// Deposit defines an amount deposited by an account address to an active proposal
+// Deposit defines an amount deposited by an account address to an active proposal.
 message Deposit {
   option (gogoproto.equal) = true;
 
@@ -50,7 +50,7 @@ message Deposit {
       [(gogoproto.nullable) = false, (gogoproto.castrepeated) = "github.com/cosmos/cosmos-sdk/types.Coins"];
 }
 
-// Proposal defines the core field members of a governance proposal
+// Proposal defines the core field members of a governance proposal.
 message Proposal {
   option (gogoproto.equal) = true;
 
@@ -77,7 +77,7 @@ message Proposal {
       [(gogoproto.stdtime) = true, (gogoproto.nullable) = false, (gogoproto.moretags) = "yaml:\"voting_end_time\""];
 }
 
-// ProposalStatus is a type alias that represents a proposal status as a byte
+// ProposalStatus enumerates the valid statuses of a proposal.
 enum ProposalStatus {
   option (gogoproto.goproto_enum_prefix)   = false;
 
@@ -95,7 +95,7 @@ enum ProposalStatus {
   PROPOSAL_STATUS_FAILED = 5 [(gogoproto.enumvalue_customname) = "StatusFailed"];
 }
 
-// TallyResult defines a standard tally for a proposal
+// TallyResult defines a standard tally for a governance proposal.
 message TallyResult {
   option (gogoproto.equal) = true;
 
@@ -109,8 +109,8 @@ message TallyResult {
   ];
 }
 
-// Vote defines a vote on a governance proposal. A vote corresponds to a proposal
-// ID, the voter, and the vote option.
+// Vote defines a vote on a governance proposal.
+// A Vote consists of a proposal ID, the voter, and the vote option.
 message Vote {
   option (gogoproto.equal) = true;
 
@@ -119,7 +119,7 @@ message Vote {
   VoteOption option      = 3;
 }
 
-// DepositParams defines the params around deposits for governance
+// DepositParams defines the params for deposits on governance proposals.
 message DepositParams {
   //  Minimum deposit for a proposal to enter voting period.
   repeated cosmos.base.v1beta1.Coin min_deposit = 1 [
@@ -138,7 +138,7 @@ message DepositParams {
   ];
 }
 
-// VotingParams defines the params around Voting in governance
+// VotingParams defines the params for voting on governance proposals.
 message VotingParams {
   //  Length of the voting period.
   google.protobuf.Duration voting_period = 1 [
@@ -149,7 +149,7 @@ message VotingParams {
   ];
 }
 
-// TallyParams defines the params around Tallying votes in governance
+// TallyParams defines the params for tallying votes on governance proposals.
 message TallyParams {
   //  Minimum percentage of total stake needed to vote for a result to be considered valid.
   bytes quorum = 1 [
@@ -158,17 +158,18 @@ message TallyParams {
     (gogoproto.jsontag) = "quorum,omitempty"
   ];
 
-  //  Minimum proportion of Yes votes for proposal to pass. Initial value: 0.5.
+  //  Minimum proportion of Yes votes for proposal to pass. Default value: 0.5.
   bytes threshold = 2 [
     (gogoproto.customtype) = "github.com/cosmos/cosmos-sdk/types.Dec", 
     (gogoproto.nullable) = false,
     (gogoproto.jsontag) = "threshold,omitempty"
   ];
   
-  //  Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Initial value: 1/3.
-  bytes veto = 3 [
+  //  Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Default value: 1/3.
+  bytes veto_threshold = 3 [
     (gogoproto.customtype) = "github.com/cosmos/cosmos-sdk/types.Dec", 
     (gogoproto.nullable) = false,
-    (gogoproto.jsontag) = "veto,omitempty"
+    (gogoproto.jsontag) = "veto_threshold,omitempty",
+    (gogoproto.moretags) = "yaml:\"veto_threshold\""
   ];
 }
diff --git a/proto/cosmos/gov/v1beta1/tx.proto b/proto/cosmos/gov/v1beta1/tx.proto
index e483dd1971..8a3409e8e4 100644
--- a/proto/cosmos/gov/v1beta1/tx.proto
+++ b/proto/cosmos/gov/v1beta1/tx.proto
@@ -26,7 +26,7 @@ message MsgSubmitProposal {
   bytes proposer = 3 [(gogoproto.casttype) = "github.com/cosmos/cosmos-sdk/types.AccAddress"];
 }
 
-// MsgVote defines a message to cast a vote
+// MsgVote defines a message to cast a vote.
 message MsgVote {
   option (gogoproto.equal) = true;
 
@@ -38,7 +38,7 @@ message MsgVote {
   VoteOption option = 3;
 }
 
-// MsgDeposit defines a message to submit a deposit to an existing proposal
+// MsgDeposit defines a message to submit a deposit to an existing proposal.
 message MsgDeposit {
   option (gogoproto.equal) = true;
 
diff --git a/proto/cosmos/mint/v1beta1/mint.proto b/proto/cosmos/mint/v1beta1/mint.proto
index b3444a1b8d..f94d4ae2e8 100644
--- a/proto/cosmos/mint/v1beta1/mint.proto
+++ b/proto/cosmos/mint/v1beta1/mint.proto
@@ -18,7 +18,7 @@ message Minter {
   ];
 }
 
-// mint parameters
+// Params holds parameters for the mint module.
 message Params {
   option (gogoproto.goproto_stringer) = false;
 
diff --git a/proto/cosmos/params/v1beta1/params.proto b/proto/cosmos/params/v1beta1/params.proto
index a44e5ca723..573a96f708 100644
--- a/proto/cosmos/params/v1beta1/params.proto
+++ b/proto/cosmos/params/v1beta1/params.proto
@@ -6,8 +6,7 @@ option (gogoproto.equal_all) = true;
 
 import "gogoproto/gogo.proto";
 
-// ParameterChangeProposal defines a proposal which contains multiple parameter
-// changes.
+// ParameterChangeProposal defines a proposal to change one or more parameters.
 message ParameterChangeProposal {
   option (gogoproto.goproto_getters)  = false;
   option (gogoproto.goproto_stringer) = false;
@@ -17,7 +16,7 @@ message ParameterChangeProposal {
   repeated ParamChange changes     = 3 [(gogoproto.nullable) = false];
 }
 
-// ParamChange defines a parameter change.
+// ParamChange defines an individual parameter change, for use in ParameterChangeProposal.
 message ParamChange {
   option (gogoproto.goproto_stringer) = false;
 
diff --git a/proto/cosmos/slashing/v1beta1/slashing.proto b/proto/cosmos/slashing/v1beta1/slashing.proto
index 7f36f5d526..2ed0b934e6 100644
--- a/proto/cosmos/slashing/v1beta1/slashing.proto
+++ b/proto/cosmos/slashing/v1beta1/slashing.proto
@@ -8,7 +8,7 @@ import "gogoproto/gogo.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 
-// ValidatorSigningInfo defines the signing info for a validator
+// ValidatorSigningInfo defines a validator's signing info for monitoring their liveness activity.
 message ValidatorSigningInfo {
   option (gogoproto.equal)            = true;
   option (gogoproto.goproto_stringer) = false;
@@ -29,7 +29,7 @@ message ValidatorSigningInfo {
   int64 missed_blocks_counter = 6 [(gogoproto.moretags) = "yaml:\"missed_blocks_counter\""];
 }
 
-// Params - used for initializing default parameter for slashing at genesis
+// Params represents the parameters used for by the slashing module.
 message Params {
   int64 signed_blocks_window  = 1 [(gogoproto.moretags) = "yaml:\"signed_blocks_window\""];
   bytes min_signed_per_window = 2 [
diff --git a/proto/cosmos/slashing/v1beta1/tx.proto b/proto/cosmos/slashing/v1beta1/tx.proto
index 9485ed1f34..7cb1ffd924 100644
--- a/proto/cosmos/slashing/v1beta1/tx.proto
+++ b/proto/cosmos/slashing/v1beta1/tx.proto
@@ -6,7 +6,9 @@ option (gogoproto.equal_all) = true;
 
 import "gogoproto/gogo.proto";
 
-// MsgUnjail - struct for unjailing jailed validator
+// MsgUnjail is an sdk.Msg used for unjailing a jailed validator, thus returning
+// them into the bonded validator set, so they can begin receiving provisions
+// and rewards again.
 message MsgUnjail {
   bytes validator_addr = 1 [
     (gogoproto.casttype) = "github.com/cosmos/cosmos-sdk/types.ValAddress",
diff --git a/proto/cosmos/staking/v1beta1/staking.proto b/proto/cosmos/staking/v1beta1/staking.proto
index cace6cf6aa..1d0a05b7b9 100644
--- a/proto/cosmos/staking/v1beta1/staking.proto
+++ b/proto/cosmos/staking/v1beta1/staking.proto
@@ -9,8 +9,9 @@ import "cosmos/base/v1beta1/coin.proto";
 
 option go_package = "github.com/cosmos/cosmos-sdk/x/staking/types";
 
-// HistoricalInfo contains the historical information that gets stored at
-// each height.
+// HistoricalInfo contains header and validator information for a given block. It is stored
+// as part of staking module's state, which persists the `n` most recent HistoricalInfo
+// (`n` is set by the staking module's `historical_entries` parameter).
 message HistoricalInfo {
   tendermint.types.Header header = 1 [(gogoproto.nullable) = false];
   repeated Validator      valset = 2 [(gogoproto.nullable) = false];
@@ -38,7 +39,7 @@ message CommissionRates {
   ];
 }
 
-// Commission defines a commission parameters for a given validator.
+// Commission defines commission parameters for a given validator.
 message Commission {
   option (gogoproto.equal)            = true;
   option (gogoproto.goproto_stringer) = false;
@@ -63,8 +64,9 @@ message Description {
   string details          = 5;
 }
 
-// Validator defines the total amount of bond shares and their exchange rate to
-// coins. Slashing results in a decrease in the exchange rate, allowing correct
+// Validator defines a validator, together with the total amount of the Validator's
+// bond shares and their exchange rate to coins.
+// Slashing results in a decrease in the exchange rate, allowing correct
 // calculation of future undelegations without iterating over delegators.
 // When coins are delegated to this validator, the validator is credited with a
 // delegation whose number of bond shares is based on the amount of coins
@@ -185,7 +187,7 @@ message Delegation {
 }
 
 // UnbondingDelegation stores all of a single delegator's unbonding bonds
-// for a single validator in an time-ordered list
+// for a single validator in an time-ordered list.
 message UnbondingDelegation {
   option (gogoproto.equal)            = true;
   option (gogoproto.goproto_stringer) = false;
@@ -317,7 +319,7 @@ message RedelegationResponse {
   repeated RedelegationEntryResponse entries      = 2 [(gogoproto.nullable) = false];
 }
 
-// Pool - tracking bonded and not-bonded token supply of the bond denomination
+// Pool is used for tracking bonded and not-bonded token supply of the bond denomination.
 message Pool {
   option (gogoproto.description) = true;
   option (gogoproto.equal)       = true;
diff --git a/proto/cosmos/staking/v1beta1/tx.proto b/proto/cosmos/staking/v1beta1/tx.proto
index 45f69b04af..11ae147cab 100644
--- a/proto/cosmos/staking/v1beta1/tx.proto
+++ b/proto/cosmos/staking/v1beta1/tx.proto
@@ -56,8 +56,8 @@ message MsgEditValidator {
   ];
 }
 
-// MsgDelegate defines an SDK message for performing a delegation from a
-// delegate to a validator.
+// MsgDelegate defines an SDK message for performing a delegation of coins 
+// from a delegator to a validator.
 message MsgDelegate {
   option (gogoproto.equal) = true;
 
@@ -72,8 +72,8 @@ message MsgDelegate {
   cosmos.base.v1beta1.Coin amount = 3 [(gogoproto.nullable) = false];
 }
 
-// MsgBeginRedelegate defines an SDK message for performing a redelegation from
-// a delegate and source validator to a destination validator.
+// MsgBeginRedelegate defines an SDK message for performing a redelegation 
+// of coins from a delegator and source validator to a destination validator.
 message MsgBeginRedelegate {
   option (gogoproto.equal) = true;
 
diff --git a/proto/cosmos/tx/signing/v1beta1/signing.proto b/proto/cosmos/tx/signing/v1beta1/signing.proto
index 8dff5e2f3b..74913e3ea3 100644
--- a/proto/cosmos/tx/signing/v1beta1/signing.proto
+++ b/proto/cosmos/tx/signing/v1beta1/signing.proto
@@ -5,7 +5,7 @@ import "cosmos/base/crypto/v1beta1/crypto.proto";
 
 option go_package = "github.com/cosmos/cosmos-sdk/types/tx/signing";
 
-// SignMode represents a signing mode with its own security guarantees
+// SignMode represents a signing mode with its own security guarantees.
 enum SignMode {
     // SIGN_MODE_UNSPECIFIED specifies an unknown signing mode and will be rejected
     SIGN_MODE_UNSPECIFIED = 0;
diff --git a/proto/cosmos/tx/v1beta1/tx.proto b/proto/cosmos/tx/v1beta1/tx.proto
index ec99fccf67..e0238a8a2b 100644
--- a/proto/cosmos/tx/v1beta1/tx.proto
+++ b/proto/cosmos/tx/v1beta1/tx.proto
@@ -9,7 +9,7 @@ import "google/protobuf/any.proto";
 
 option go_package = "github.com/cosmos/cosmos-sdk/types/tx";
 
-// Tx is the standard type used for broadcasting transactions
+// Tx is the standard type used for broadcasting transactions.
 message Tx {
   // body is the processable content of the transaction
   TxBody body = 1;
@@ -39,7 +39,7 @@ message TxRaw {
   repeated bytes signatures = 3;
 }
 
-// SignDoc is the type used for generating sign bytes for SIGN_MODE_DIRECT
+// SignDoc is the type used for generating sign bytes for SIGN_MODE_DIRECT.
 message SignDoc {
   // body_bytes is protobuf serialization of a TxBody that matches the representation in TxRaw.
   bytes body_bytes = 1;
@@ -60,7 +60,7 @@ message SignDoc {
   uint64 account_sequence = 5;
 }
 
-// TxBody is the body of a transaction that all signers sign over
+// TxBody is the body of a transaction that all signers sign over.
 message TxBody {
   // messages is a list of messages to be executed. The required signers of those messages define
   // the number and order of elements in AuthInfo's signer_infos and Tx's signatures.
@@ -88,7 +88,7 @@ message TxBody {
   repeated google.protobuf.Any non_critical_extension_options = 2047;
 }
 
-// AuthInfo describes the fee and signer modes that are used to sign a transaction
+// AuthInfo describes the fee and signer modes that are used to sign a transaction.
 message AuthInfo {
   // 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.
@@ -102,7 +102,7 @@ message AuthInfo {
   Fee fee = 2;
 }
 
-// SignerInfo describes the public key and signing mode of a single top-level signer
+// SignerInfo describes the public key and signing mode of a single top-level signer.
 message SignerInfo {
   // public_key is the public key of the signer. It is optional for accounts
   // that already exist in state. If unset, the verifier can use the required \
@@ -114,7 +114,7 @@ message SignerInfo {
   ModeInfo mode_info = 2;
 }
 
-// ModeInfo describes the signing mode of a single or nested multisig signer
+// ModeInfo describes the signing mode of a single or nested multisig signer.
 message ModeInfo {
   // sum is the oneof that specifies whether this represents a single or nested
   // multisig signer
diff --git a/proto/cosmos/upgrade/v1beta1/upgrade.proto b/proto/cosmos/upgrade/v1beta1/upgrade.proto
index fd32b93493..470fae3da9 100644
--- a/proto/cosmos/upgrade/v1beta1/upgrade.proto
+++ b/proto/cosmos/upgrade/v1beta1/upgrade.proto
@@ -8,7 +8,7 @@ option go_package                       = "github.com/cosmos/cosmos-sdk/x/upgrad
 option (gogoproto.goproto_stringer_all) = false;
 option (gogoproto.goproto_getters_all)  = false;
 
-// Plan specifies information about a planned upgrade and when it should occur
+// Plan specifies information about a planned upgrade and when it should occur.
 message Plan {
   option (gogoproto.equal) = true;
 
@@ -32,7 +32,7 @@ message Plan {
   string info = 4;
 }
 
-// SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade
+// SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade.
 message SoftwareUpgradeProposal {
   option (gogoproto.equal) = true;
 
@@ -41,7 +41,7 @@ message SoftwareUpgradeProposal {
   Plan   plan        = 3 [(gogoproto.nullable) = false];
 }
 
-// CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade
+// CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade.
 message CancelSoftwareUpgradeProposal {
   option (gogoproto.equal) = true;
 
diff --git a/proto/cosmos/vesting/v1beta1/vesting.proto b/proto/cosmos/vesting/v1beta1/vesting.proto
index 9bbc749e09..c28baac532 100644
--- a/proto/cosmos/vesting/v1beta1/vesting.proto
+++ b/proto/cosmos/vesting/v1beta1/vesting.proto
@@ -52,7 +52,7 @@ message DelayedVestingAccount {
   BaseVestingAccount base_vesting_account = 1 [(gogoproto.embed) = true];
 }
 
-// Period defines a length of time and amount of coins that will vest
+// Period defines a length of time and amount of coins that will vest.
 message Period {
   option (gogoproto.goproto_stringer) = false;
 
@@ -64,7 +64,7 @@ message Period {
 }
 
 // PeriodicVestingAccount implements the VestingAccount interface. It
-// periodically vests by unlocking coins during each specified period
+// periodically vests by unlocking coins during each specified period.
 message PeriodicVestingAccount {
   option (gogoproto.goproto_getters)  = false;
   option (gogoproto.goproto_stringer) = false;
diff --git a/types/query/pagination.pb.go b/types/query/pagination.pb.go
index 8efc8934ca..6b292bfd5e 100644
--- a/types/query/pagination.pb.go
+++ b/types/query/pagination.pb.go
@@ -109,7 +109,7 @@ func (m *PageRequest) GetCountTotal() bool {
 }
 
 // PageResponse is to be embedded in gRPC response messages where the corresponding
-// request message has used PageRequest
+// request message has used PageRequest.
 //
 //  message SomeResponse {
 //          repeated Bar results = 1;
diff --git a/types/tx/signing/signing.pb.go b/types/tx/signing/signing.pb.go
index e5989e11d1..207965ad1a 100644
--- a/types/tx/signing/signing.pb.go
+++ b/types/tx/signing/signing.pb.go
@@ -23,7 +23,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// SignMode represents a signing mode with its own security guarantees
+// SignMode represents a signing mode with its own security guarantees.
 type SignMode int32
 
 const (
diff --git a/types/tx/tx.pb.go b/types/tx/tx.pb.go
index f88283f15d..0738293590 100644
--- a/types/tx/tx.pb.go
+++ b/types/tx/tx.pb.go
@@ -28,7 +28,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// Tx is the standard type used for broadcasting transactions
+// Tx is the standard type used for broadcasting transactions.
 type Tx struct {
 	// body is the processable content of the transaction
 	Body *TxBody `protobuf:"bytes,1,opt,name=body,proto3" json:"body,omitempty"`
@@ -162,7 +162,7 @@ func (m *TxRaw) GetSignatures() [][]byte {
 	return nil
 }
 
-// SignDoc is the type used for generating sign bytes for SIGN_MODE_DIRECT
+// SignDoc is the type used for generating sign bytes for SIGN_MODE_DIRECT.
 type SignDoc struct {
 	// body_bytes is protobuf serialization of a TxBody that matches the representation in TxRaw.
 	BodyBytes []byte `protobuf:"bytes,1,opt,name=body_bytes,json=bodyBytes,proto3" json:"body_bytes,omitempty"`
@@ -247,7 +247,7 @@ func (m *SignDoc) GetAccountSequence() uint64 {
 	return 0
 }
 
-// TxBody is the body of a transaction that all signers sign over
+// TxBody is the body of a transaction that all signers sign over.
 type TxBody struct {
 	// messages is a list of messages to be executed. The required signers of those messages define
 	// the number and order of elements in AuthInfo's signer_infos and Tx's signatures.
@@ -339,7 +339,7 @@ func (m *TxBody) GetNonCriticalExtensionOptions() []*types.Any {
 	return nil
 }
 
-// AuthInfo describes the fee and signer modes that are used to sign a transaction
+// AuthInfo describes the fee and signer modes that are used to sign a transaction.
 type AuthInfo struct {
 	// 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.
@@ -399,7 +399,7 @@ func (m *AuthInfo) GetFee() *Fee {
 	return nil
 }
 
-// SignerInfo describes the public key and signing mode of a single top-level signer
+// SignerInfo describes the public key and signing mode of a single top-level signer.
 type SignerInfo struct {
 	// public_key is the public key of the signer. It is optional for accounts
 	// that already exist in state. If unset, the verifier can use the required \
@@ -457,7 +457,7 @@ func (m *SignerInfo) GetModeInfo() *ModeInfo {
 	return nil
 }
 
-// ModeInfo describes the signing mode of a single or nested multisig signer
+// ModeInfo describes the signing mode of a single or nested multisig signer.
 type ModeInfo struct {
 	// sum is the oneof that specifies whether this represents a single or nested
 	// multisig signer
diff --git a/x/auth/types/auth.pb.go b/x/auth/types/auth.pb.go
index f216413a43..f5a7258637 100644
--- a/x/auth/types/auth.pb.go
+++ b/x/auth/types/auth.pb.go
@@ -67,7 +67,7 @@ func (m *BaseAccount) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_BaseAccount proto.InternalMessageInfo
 
-// ModuleAccount defines an account for modules that holds coins on a pool
+// ModuleAccount defines an account for modules that holds coins on a pool.
 type ModuleAccount struct {
 	*BaseAccount `protobuf:"bytes,1,opt,name=base_account,json=baseAccount,proto3,embedded=base_account" json:"base_account,omitempty" yaml:"base_account"`
 	Name         string   `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
diff --git a/x/auth/vesting/types/vesting.pb.go b/x/auth/vesting/types/vesting.pb.go
index ab103ed2b0..c491c7504b 100644
--- a/x/auth/vesting/types/vesting.pb.go
+++ b/x/auth/vesting/types/vesting.pb.go
@@ -146,7 +146,7 @@ func (m *DelayedVestingAccount) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_DelayedVestingAccount proto.InternalMessageInfo
 
-// Period defines a length of time and amount of coins that will vest
+// Period defines a length of time and amount of coins that will vest.
 type Period struct {
 	Length int64                                    `protobuf:"varint,1,opt,name=length,proto3" json:"length,omitempty"`
 	Amount github_com_cosmos_cosmos_sdk_types.Coins `protobuf:"bytes,2,rep,name=amount,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"amount"`
@@ -199,7 +199,7 @@ func (m *Period) GetAmount() github_com_cosmos_cosmos_sdk_types.Coins {
 }
 
 // PeriodicVestingAccount implements the VestingAccount interface. It
-// periodically vests by unlocking coins during each specified period
+// periodically vests by unlocking coins during each specified period.
 type PeriodicVestingAccount struct {
 	*BaseVestingAccount `protobuf:"bytes,1,opt,name=base_vesting_account,json=baseVestingAccount,proto3,embedded=base_vesting_account" json:"base_vesting_account,omitempty"`
 	StartTime           int64    `protobuf:"varint,2,opt,name=start_time,json=startTime,proto3" json:"start_time,omitempty" yaml:"start_time"`
diff --git a/x/bank/keeper/keeper_test.go b/x/bank/keeper/keeper_test.go
index 7bdd47d59b..744de818e4 100644
--- a/x/bank/keeper/keeper_test.go
+++ b/x/bank/keeper/keeper_test.go
@@ -1019,7 +1019,7 @@ func (suite *IntegrationTestSuite) TestIterateAllDenomMetaData() {
 func (suite *IntegrationTestSuite) getTestMetadata() []types.Metadata {
 	return []types.Metadata{{
 		Description: "The native staking token of the Cosmos Hub.",
-		DenomUnits: []*types.DenomUnits{
+		DenomUnits: []*types.DenomUnit{
 			{"uatom", uint32(0), []string{"microatom"}},
 			{"matom", uint32(3), []string{"milliatom"}},
 			{"atom", uint32(6), nil},
@@ -1029,7 +1029,7 @@ func (suite *IntegrationTestSuite) getTestMetadata() []types.Metadata {
 	},
 		{
 			Description: "The native staking token of the Token Hub.",
-			DenomUnits: []*types.DenomUnits{
+			DenomUnits: []*types.DenomUnit{
 				{"1token", uint32(5), []string{"decitoken"}},
 				{"2token", uint32(4), []string{"centitoken"}},
 				{"3token", uint32(7), []string{"dekatoken"}},
diff --git a/x/bank/types/bank.pb.go b/x/bank/types/bank.pb.go
index 798194f886..5f111b57b4 100644
--- a/x/bank/types/bank.pb.go
+++ b/x/bank/types/bank.pb.go
@@ -27,7 +27,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// Params defines the set of bank parameters.
+// Params defines the parameters for the bank module.
 type Params struct {
 	SendEnabled        []*SendEnabled `protobuf:"bytes,1,rep,name=send_enabled,json=sendEnabled,proto3" json:"send_enabled,omitempty" yaml:"send_enabled,omitempty"`
 	DefaultSendEnabled bool           `protobuf:"varint,2,opt,name=default_send_enabled,json=defaultSendEnabled,proto3" json:"default_send_enabled,omitempty" yaml:"default_send_enabled,omitempty"`
@@ -79,7 +79,7 @@ func (m *Params) GetDefaultSendEnabled() bool {
 	return false
 }
 
-// Send enabled configuration properties for each denomination
+// SendEnabled maps coin denom to a send_enabled status (whether a denom is sendable).
 type SendEnabled struct {
 	Denom   string `protobuf:"bytes,1,opt,name=denom,proto3" json:"denom,omitempty"`
 	Enabled bool   `protobuf:"varint,2,opt,name=enabled,proto3" json:"enabled,omitempty"`
@@ -131,7 +131,7 @@ func (m *SendEnabled) GetEnabled() bool {
 	return false
 }
 
-// Input models transaction input
+// Input models transaction input.
 type Input struct {
 	Address github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=address,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"address,omitempty"`
 	Coins   github_com_cosmos_cosmos_sdk_types.Coins      `protobuf:"bytes,2,rep,name=coins,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"coins"`
@@ -184,7 +184,7 @@ func (m *Input) GetCoins() github_com_cosmos_cosmos_sdk_types.Coins {
 	return nil
 }
 
-// Output models transaction outputs
+// Output models transaction outputs.
 type Output struct {
 	Address github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=address,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"address,omitempty"`
 	Coins   github_com_cosmos_cosmos_sdk_types.Coins      `protobuf:"bytes,2,rep,name=coins,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"coins"`
@@ -275,26 +275,33 @@ func (m *Supply) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_Supply proto.InternalMessageInfo
 
-// DenomUnits represents a struct that describes different
-// denominations units of the basic token
-type DenomUnits struct {
-	Denom    string   `protobuf:"bytes,1,opt,name=denom,proto3" json:"denom,omitempty"`
-	Exponent uint32   `protobuf:"varint,2,opt,name=exponent,proto3" json:"exponent,omitempty"`
-	Aliases  []string `protobuf:"bytes,3,rep,name=aliases,proto3" json:"aliases,omitempty"`
+// DenomUnit represents a struct that describes a given
+// denomination unit of the basic token.
+type DenomUnit struct {
+	// denom represents the string name of the given denom unit (e.g uatom).
+	Denom string `protobuf:"bytes,1,opt,name=denom,proto3" json:"denom,omitempty"`
+	// exponent represents power of 10 exponent that one must
+	// raise the base_denom to in order to equal the given DenomUnit's denom
+	// 1 denom = 1^exponent base_denom
+	// (e.g. with a base_denom of uatom, one can create a DenomUnit of 'atom' with
+	// exponent = 6, thus: 1 atom = 10^6 uatom).
+	Exponent uint32 `protobuf:"varint,2,opt,name=exponent,proto3" json:"exponent,omitempty"`
+	// aliases is a list of string aliases for the given denom
+	Aliases []string `protobuf:"bytes,3,rep,name=aliases,proto3" json:"aliases,omitempty"`
 }
 
-func (m *DenomUnits) Reset()         { *m = DenomUnits{} }
-func (m *DenomUnits) String() string { return proto.CompactTextString(m) }
-func (*DenomUnits) ProtoMessage()    {}
-func (*DenomUnits) Descriptor() ([]byte, []int) {
+func (m *DenomUnit) Reset()         { *m = DenomUnit{} }
+func (m *DenomUnit) String() string { return proto.CompactTextString(m) }
+func (*DenomUnit) ProtoMessage()    {}
+func (*DenomUnit) Descriptor() ([]byte, []int) {
 	return fileDescriptor_dd052eee12edf988, []int{5}
 }
-func (m *DenomUnits) XXX_Unmarshal(b []byte) error {
+func (m *DenomUnit) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
 }
-func (m *DenomUnits) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
+func (m *DenomUnit) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
 	if deterministic {
-		return xxx_messageInfo_DenomUnits.Marshal(b, m, deterministic)
+		return xxx_messageInfo_DenomUnit.Marshal(b, m, deterministic)
 	} else {
 		b = b[:cap(b)]
 		n, err := m.MarshalToSizedBuffer(b)
@@ -304,33 +311,33 @@ func (m *DenomUnits) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
 		return b[:n], nil
 	}
 }
-func (m *DenomUnits) XXX_Merge(src proto.Message) {
-	xxx_messageInfo_DenomUnits.Merge(m, src)
+func (m *DenomUnit) XXX_Merge(src proto.Message) {
+	xxx_messageInfo_DenomUnit.Merge(m, src)
 }
-func (m *DenomUnits) XXX_Size() int {
+func (m *DenomUnit) XXX_Size() int {
 	return m.Size()
 }
-func (m *DenomUnits) XXX_DiscardUnknown() {
-	xxx_messageInfo_DenomUnits.DiscardUnknown(m)
+func (m *DenomUnit) XXX_DiscardUnknown() {
+	xxx_messageInfo_DenomUnit.DiscardUnknown(m)
 }
 
-var xxx_messageInfo_DenomUnits proto.InternalMessageInfo
+var xxx_messageInfo_DenomUnit proto.InternalMessageInfo
 
-func (m *DenomUnits) GetDenom() string {
+func (m *DenomUnit) GetDenom() string {
 	if m != nil {
 		return m.Denom
 	}
 	return ""
 }
 
-func (m *DenomUnits) GetExponent() uint32 {
+func (m *DenomUnit) GetExponent() uint32 {
 	if m != nil {
 		return m.Exponent
 	}
 	return 0
 }
 
-func (m *DenomUnits) GetAliases() []string {
+func (m *DenomUnit) GetAliases() []string {
 	if m != nil {
 		return m.Aliases
 	}
@@ -338,12 +345,16 @@ func (m *DenomUnits) GetAliases() []string {
 }
 
 // Metadata represents a struct that describes
-// a basic token
+// a basic token.
 type Metadata struct {
-	Description string        `protobuf:"bytes,1,opt,name=description,proto3" json:"description,omitempty"`
-	DenomUnits  []*DenomUnits `protobuf:"bytes,2,rep,name=denom_units,json=denomUnits,proto3" json:"denom_units,omitempty"`
-	Base        string        `protobuf:"bytes,3,opt,name=base,proto3" json:"base,omitempty"`
-	Display     string        `protobuf:"bytes,4,opt,name=display,proto3" json:"display,omitempty"`
+	Description string `protobuf:"bytes,1,opt,name=description,proto3" json:"description,omitempty"`
+	// denom_units represents the list of DenomUnit's for a given coin
+	DenomUnits []*DenomUnit `protobuf:"bytes,2,rep,name=denom_units,json=denomUnits,proto3" json:"denom_units,omitempty"`
+	// base represents the base denom (should be the DenomUnit with exponent = 0).
+	Base string `protobuf:"bytes,3,opt,name=base,proto3" json:"base,omitempty"`
+	// display indicates the suggested denom that should be
+	// displayed in clients.
+	Display string `protobuf:"bytes,4,opt,name=display,proto3" json:"display,omitempty"`
 }
 
 func (m *Metadata) Reset()         { *m = Metadata{} }
@@ -386,7 +397,7 @@ func (m *Metadata) GetDescription() string {
 	return ""
 }
 
-func (m *Metadata) GetDenomUnits() []*DenomUnits {
+func (m *Metadata) GetDenomUnits() []*DenomUnit {
 	if m != nil {
 		return m.DenomUnits
 	}
@@ -413,51 +424,51 @@ func init() {
 	proto.RegisterType((*Input)(nil), "cosmos.bank.v1beta1.Input")
 	proto.RegisterType((*Output)(nil), "cosmos.bank.v1beta1.Output")
 	proto.RegisterType((*Supply)(nil), "cosmos.bank.v1beta1.Supply")
-	proto.RegisterType((*DenomUnits)(nil), "cosmos.bank.v1beta1.DenomUnits")
+	proto.RegisterType((*DenomUnit)(nil), "cosmos.bank.v1beta1.DenomUnit")
 	proto.RegisterType((*Metadata)(nil), "cosmos.bank.v1beta1.Metadata")
 }
 
 func init() { proto.RegisterFile("cosmos/bank/v1beta1/bank.proto", fileDescriptor_dd052eee12edf988) }
 
 var fileDescriptor_dd052eee12edf988 = []byte{
-	// 586 bytes of a gzipped FileDescriptorProto
+	// 587 bytes of a gzipped FileDescriptorProto
 	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x54, 0xbf, 0x6f, 0xd3, 0x4e,
-	0x14, 0xf7, 0x35, 0x69, 0x9a, 0x5e, 0xfa, 0x5d, 0xfc, 0xcd, 0xe0, 0x46, 0xc2, 0x36, 0x96, 0x90,
-	0x52, 0x44, 0x1c, 0x02, 0x62, 0xc9, 0x44, 0x53, 0x2a, 0x54, 0x21, 0x04, 0x72, 0x85, 0x84, 0x60,
-	0x88, 0x2e, 0xbe, 0x6b, 0xb0, 0x6a, 0xdf, 0x59, 0xb9, 0x33, 0x6a, 0xfe, 0x03, 0x46, 0x46, 0x06,
-	0x86, 0xcc, 0x8c, 0x88, 0x15, 0xe6, 0x8e, 0x15, 0x2c, 0x4c, 0x01, 0x25, 0x0b, 0x73, 0x47, 0x26,
-	0x74, 0x77, 0xce, 0x8f, 0x4a, 0x01, 0x75, 0x60, 0x61, 0x8a, 0xdf, 0x7b, 0x9f, 0xf7, 0xf9, 0x7c,
-	0xf2, 0xde, 0xb3, 0xa1, 0x1d, 0x32, 0x9e, 0x30, 0xde, 0xec, 0x21, 0x7a, 0xdc, 0x7c, 0xd9, 0xea,
-	0x11, 0x81, 0x5a, 0x2a, 0xf0, 0xd3, 0x01, 0x13, 0xcc, 0xfc, 0x5f, 0xd7, 0x7d, 0x95, 0xca, 0xeb,
-	0xb5, 0x6a, 0x9f, 0xf5, 0x99, 0xaa, 0x37, 0xe5, 0x93, 0x86, 0xd6, 0xb6, 0x35, 0xb4, 0xab, 0x0b,
-	0x79, 0x9f, 0x2e, 0x2d, 0x54, 0x38, 0x99, 0xab, 0x84, 0x2c, 0xa2, 0xba, 0xee, 0x7d, 0x01, 0xb0,
-	0xf4, 0x18, 0x0d, 0x50, 0xc2, 0xcd, 0x23, 0xb8, 0xc5, 0x09, 0xc5, 0x5d, 0x42, 0x51, 0x2f, 0x26,
-	0xd8, 0x02, 0x6e, 0xa1, 0x5e, 0xb9, 0xe5, 0xfa, 0x2b, 0x7c, 0xf8, 0x87, 0x84, 0xe2, 0x7d, 0x8d,
-	0xeb, 0x5c, 0x3d, 0x1f, 0x3b, 0x57, 0x86, 0x28, 0x89, 0xdb, 0xde, 0x72, 0xff, 0x0d, 0x96, 0x44,
-	0x82, 0x24, 0xa9, 0x18, 0x7a, 0x41, 0x85, 0x2f, 0xf0, 0xe6, 0x73, 0x58, 0xc5, 0xe4, 0x08, 0x65,
-	0xb1, 0xe8, 0x5e, 0xd0, 0x5b, 0x73, 0x41, 0xbd, 0xdc, 0xd9, 0x39, 0x1f, 0x3b, 0xd7, 0x34, 0xdb,
-	0x2a, 0xd4, 0x32, 0xab, 0x99, 0x03, 0x96, 0xcc, 0xb4, 0x8b, 0x6f, 0x46, 0x8e, 0xe1, 0xdd, 0x87,
-	0x95, 0xa5, 0xa4, 0x59, 0x85, 0xeb, 0x98, 0x50, 0x96, 0x58, 0xc0, 0x05, 0xf5, 0xcd, 0x40, 0x07,
-	0xa6, 0x05, 0x37, 0x2e, 0x48, 0x07, 0xb3, 0xb0, 0x5d, 0x96, 0x24, 0x3f, 0x46, 0x0e, 0xf0, 0x3e,
-	0x02, 0xb8, 0x7e, 0x40, 0xd3, 0x4c, 0x98, 0x0f, 0xe0, 0x06, 0xc2, 0x78, 0x40, 0x38, 0x57, 0x2c,
-	0x5b, 0x9d, 0xd6, 0xcf, 0xb1, 0xd3, 0xe8, 0x47, 0xe2, 0x45, 0xd6, 0xf3, 0x43, 0x96, 0xe4, 0x63,
-	0xcf, 0x7f, 0x1a, 0x1c, 0x1f, 0x37, 0xc5, 0x30, 0x25, 0xdc, 0xdf, 0x0d, 0xc3, 0x5d, 0xdd, 0x18,
-	0xcc, 0x18, 0x4c, 0x04, 0xd7, 0xe5, 0x0e, 0xb8, 0xb5, 0xa6, 0x66, 0xbc, 0xbd, 0x98, 0x31, 0x27,
-	0xf3, 0x19, 0xef, 0xb1, 0x88, 0x76, 0x6e, 0x9e, 0x8e, 0x1d, 0xe3, 0xdd, 0x37, 0xa7, 0x7e, 0x09,
-	0x25, 0xd9, 0xc0, 0x03, 0xcd, 0xdc, 0x2e, 0x2a, 0xff, 0x9f, 0x00, 0x2c, 0x3d, 0xca, 0xc4, 0xbf,
-	0xfb, 0x07, 0xde, 0x03, 0x58, 0x3a, 0xcc, 0xd2, 0x34, 0x1e, 0x4a, 0x4d, 0xc1, 0x04, 0x8a, 0xf3,
-	0xc3, 0xfc, 0xbb, 0x9a, 0x8a, 0xb9, 0xbd, 0xff, 0x6a, 0xe4, 0x18, 0xb3, 0xe5, 0x7f, 0xfe, 0xd0,
-	0xb8, 0x73, 0xfd, 0x8f, 0x0c, 0x27, 0xfa, 0xe5, 0x25, 0x27, 0x29, 0x1b, 0x08, 0x82, 0x7d, 0x6d,
-	0xf4, 0xc0, 0x7b, 0x0a, 0xe1, 0x3d, 0x79, 0x62, 0x4f, 0x68, 0x24, 0xf8, 0x6f, 0xae, 0xaf, 0x06,
-	0xcb, 0xb2, 0x8f, 0x12, 0x2a, 0xd4, 0xf9, 0xfd, 0x17, 0xcc, 0x63, 0x79, 0x99, 0x28, 0x8e, 0x10,
-	0x27, 0xdc, 0x2a, 0xb8, 0x85, 0xfa, 0x66, 0x30, 0x0b, 0xbd, 0xb7, 0x00, 0x96, 0x1f, 0x12, 0x81,
-	0x30, 0x12, 0xc8, 0x74, 0x61, 0x05, 0x13, 0x1e, 0x0e, 0xa2, 0x54, 0x44, 0x8c, 0xe6, 0xf4, 0xcb,
-	0x29, 0xf3, 0xae, 0x44, 0x50, 0x96, 0x74, 0x33, 0xe9, 0x24, 0x5f, 0x96, 0xb3, 0xf2, 0x8d, 0x5e,
-	0x18, 0x0e, 0x20, 0x5e, 0x98, 0x37, 0x61, 0x51, 0xce, 0xd7, 0x2a, 0x28, 0x72, 0xf5, 0x2c, 0xed,
-	0xe1, 0x88, 0xa7, 0x31, 0x1a, 0x5a, 0x45, 0x95, 0x9e, 0x85, 0x9d, 0xbd, 0xd3, 0x89, 0x0d, 0xce,
-	0x26, 0x36, 0xf8, 0x3e, 0xb1, 0xc1, 0xeb, 0xa9, 0x6d, 0x9c, 0x4d, 0x6d, 0xe3, 0xeb, 0xd4, 0x36,
-	0x9e, 0xed, 0x5c, 0x66, 0x90, 0x6a, 0x23, 0xbd, 0x92, 0xfa, 0x32, 0xdd, 0xfe, 0x15, 0x00, 0x00,
-	0xff, 0xff, 0xe3, 0xc7, 0xfe, 0xdc, 0x21, 0x05, 0x00, 0x00,
+	0x14, 0xf7, 0x35, 0x69, 0x9a, 0x5e, 0xfa, 0x5d, 0xee, 0xdb, 0xc1, 0xad, 0x84, 0x6d, 0x2c, 0x21,
+	0xa5, 0x88, 0x38, 0x04, 0xc4, 0x92, 0x05, 0x35, 0xa5, 0x42, 0x15, 0x42, 0x20, 0x57, 0x08, 0x09,
+	0x86, 0xe8, 0xe2, 0xbb, 0x06, 0xab, 0xf6, 0x9d, 0x95, 0x3b, 0xa3, 0xe6, 0x3f, 0x60, 0x64, 0x44,
+	0x62, 0xc9, 0xcc, 0x88, 0x58, 0x61, 0xee, 0x58, 0xc1, 0xc2, 0x14, 0x50, 0xb2, 0x30, 0x77, 0x64,
+	0x42, 0xbe, 0xb3, 0x93, 0x54, 0x0a, 0xa8, 0x03, 0x0b, 0x53, 0xde, 0x8f, 0xcf, 0xfb, 0x7c, 0x5e,
+	0xde, 0x7b, 0x67, 0x68, 0x05, 0x5c, 0xc4, 0x5c, 0x34, 0x7b, 0x98, 0x1d, 0x37, 0x5f, 0xb6, 0x7a,
+	0x54, 0xe2, 0x96, 0x72, 0xbc, 0x64, 0xc0, 0x25, 0x47, 0xff, 0xeb, 0xbc, 0xa7, 0x42, 0x79, 0x7e,
+	0x7b, 0xb3, 0xcf, 0xfb, 0x5c, 0xe5, 0x9b, 0x99, 0xa5, 0xa1, 0xdb, 0x5b, 0x1a, 0xda, 0xd5, 0x89,
+	0xbc, 0x4e, 0xa7, 0xe6, 0x2a, 0x82, 0xce, 0x54, 0x02, 0x1e, 0x32, 0x9d, 0x77, 0xbf, 0x00, 0x58,
+	0x79, 0x8c, 0x07, 0x38, 0x16, 0xe8, 0x08, 0x6e, 0x08, 0xca, 0x48, 0x97, 0x32, 0xdc, 0x8b, 0x28,
+	0x31, 0x81, 0x53, 0xaa, 0xd7, 0x6e, 0x39, 0xde, 0x92, 0x3e, 0xbc, 0x43, 0xca, 0xc8, 0xbe, 0xc6,
+	0x75, 0xae, 0x9e, 0x8f, 0xed, 0x2b, 0x43, 0x1c, 0x47, 0x6d, 0x77, 0xb1, 0xfe, 0x06, 0x8f, 0x43,
+	0x49, 0xe3, 0x44, 0x0e, 0x5d, 0xbf, 0x26, 0xe6, 0x78, 0xf4, 0x1c, 0x6e, 0x12, 0x7a, 0x84, 0xd3,
+	0x48, 0x76, 0x2f, 0xe8, 0xad, 0x38, 0xa0, 0x5e, 0xed, 0xec, 0x9c, 0x8f, 0xed, 0x6b, 0x9a, 0x6d,
+	0x19, 0x6a, 0x91, 0x15, 0xe5, 0x80, 0x85, 0x66, 0xda, 0xe5, 0x37, 0x23, 0xdb, 0x70, 0xef, 0xc3,
+	0xda, 0x42, 0x10, 0x6d, 0xc2, 0x55, 0x42, 0x19, 0x8f, 0x4d, 0xe0, 0x80, 0xfa, 0xba, 0xaf, 0x1d,
+	0x64, 0xc2, 0xb5, 0x0b, 0xd2, 0x7e, 0xe1, 0xb6, 0xab, 0x19, 0xc9, 0x8f, 0x91, 0x0d, 0xdc, 0x8f,
+	0x00, 0xae, 0x1e, 0xb0, 0x24, 0x95, 0xe8, 0x01, 0x5c, 0xc3, 0x84, 0x0c, 0xa8, 0x10, 0x8a, 0x65,
+	0xa3, 0xd3, 0xfa, 0x39, 0xb6, 0x1b, 0xfd, 0x50, 0xbe, 0x48, 0x7b, 0x5e, 0xc0, 0xe3, 0x7c, 0xec,
+	0xf9, 0x4f, 0x43, 0x90, 0xe3, 0xa6, 0x1c, 0x26, 0x54, 0x78, 0xbb, 0x41, 0xb0, 0xab, 0x0b, 0xfd,
+	0x82, 0x01, 0x61, 0xb8, 0x9a, 0xed, 0x40, 0x98, 0x2b, 0x6a, 0xc6, 0x5b, 0xf3, 0x19, 0x0b, 0x3a,
+	0x9b, 0xf1, 0x1e, 0x0f, 0x59, 0xe7, 0xe6, 0xe9, 0xd8, 0x36, 0xde, 0x7d, 0xb3, 0xeb, 0x97, 0x50,
+	0xca, 0x0a, 0x84, 0xaf, 0x99, 0xdb, 0x65, 0xd5, 0xff, 0x27, 0x00, 0x2b, 0x8f, 0x52, 0xf9, 0xef,
+	0xfe, 0x81, 0xf7, 0x00, 0x56, 0x0e, 0xd3, 0x24, 0x89, 0x86, 0x99, 0xa6, 0xe4, 0x12, 0x47, 0xf9,
+	0x61, 0xfe, 0x5d, 0x4d, 0xc5, 0xdc, 0xde, 0x7f, 0x35, 0xb2, 0x8d, 0x62, 0xf9, 0x9f, 0x3f, 0x34,
+	0xee, 0x5c, 0xff, 0x23, 0xc3, 0x89, 0x7e, 0xbc, 0xf4, 0x24, 0xe1, 0x03, 0x49, 0x89, 0xa7, 0x1b,
+	0x3d, 0x70, 0x9f, 0xc2, 0xf5, 0x7b, 0xd9, 0x89, 0x3d, 0x61, 0xa1, 0xfc, 0xcd, 0xf1, 0x6d, 0xc3,
+	0x6a, 0x56, 0xc6, 0x28, 0x93, 0xea, 0xfa, 0xfe, 0xf3, 0x67, 0x7e, 0x76, 0x98, 0x38, 0x0a, 0xb1,
+	0xa0, 0xc2, 0x2c, 0x39, 0xa5, 0xfa, 0xba, 0x5f, 0xb8, 0xee, 0x5b, 0x00, 0xab, 0x0f, 0xa9, 0xc4,
+	0x04, 0x4b, 0x8c, 0x1c, 0x58, 0x23, 0x54, 0x04, 0x83, 0x30, 0x91, 0x21, 0x67, 0x39, 0xfd, 0x62,
+	0x08, 0xdd, 0xcd, 0x10, 0x8c, 0xc7, 0xdd, 0x94, 0x85, 0xb2, 0xd8, 0x95, 0xb5, 0xf4, 0x41, 0xcf,
+	0xfa, 0xf5, 0x21, 0x29, 0x4c, 0x81, 0x10, 0x2c, 0x67, 0xd3, 0x35, 0x4b, 0x8a, 0x5b, 0xd9, 0x59,
+	0x77, 0x24, 0x14, 0x49, 0x84, 0x87, 0x66, 0x59, 0x85, 0x0b, 0xb7, 0xb3, 0x77, 0x3a, 0xb1, 0xc0,
+	0xd9, 0xc4, 0x02, 0xdf, 0x27, 0x16, 0x78, 0x3d, 0xb5, 0x8c, 0xb3, 0xa9, 0x65, 0x7c, 0x9d, 0x5a,
+	0xc6, 0xb3, 0x9d, 0xcb, 0x8c, 0x51, 0xed, 0xa3, 0x57, 0x51, 0xdf, 0xa5, 0xdb, 0xbf, 0x02, 0x00,
+	0x00, 0xff, 0xff, 0xeb, 0x92, 0xb2, 0x14, 0x1f, 0x05, 0x00, 0x00,
 }
 
 func (this *SendEnabled) Equal(that interface{}) bool {
@@ -792,7 +803,7 @@ func (m *Supply) MarshalToSizedBuffer(dAtA []byte) (int, error) {
 	return len(dAtA) - i, nil
 }
 
-func (m *DenomUnits) Marshal() (dAtA []byte, err error) {
+func (m *DenomUnit) Marshal() (dAtA []byte, err error) {
 	size := m.Size()
 	dAtA = make([]byte, size)
 	n, err := m.MarshalToSizedBuffer(dAtA[:size])
@@ -802,12 +813,12 @@ func (m *DenomUnits) Marshal() (dAtA []byte, err error) {
 	return dAtA[:n], nil
 }
 
-func (m *DenomUnits) MarshalTo(dAtA []byte) (int, error) {
+func (m *DenomUnit) MarshalTo(dAtA []byte) (int, error) {
 	size := m.Size()
 	return m.MarshalToSizedBuffer(dAtA[:size])
 }
 
-func (m *DenomUnits) MarshalToSizedBuffer(dAtA []byte) (int, error) {
+func (m *DenomUnit) MarshalToSizedBuffer(dAtA []byte) (int, error) {
 	i := len(dAtA)
 	_ = i
 	var l int
@@ -992,7 +1003,7 @@ func (m *Supply) Size() (n int) {
 	return n
 }
 
-func (m *DenomUnits) Size() (n int) {
+func (m *DenomUnit) Size() (n int) {
 	if m == nil {
 		return 0
 	}
@@ -1588,7 +1599,7 @@ func (m *Supply) Unmarshal(dAtA []byte) error {
 	}
 	return nil
 }
-func (m *DenomUnits) Unmarshal(dAtA []byte) error {
+func (m *DenomUnit) Unmarshal(dAtA []byte) error {
 	l := len(dAtA)
 	iNdEx := 0
 	for iNdEx < l {
@@ -1611,10 +1622,10 @@ func (m *DenomUnits) Unmarshal(dAtA []byte) error {
 		fieldNum := int32(wire >> 3)
 		wireType := int(wire & 0x7)
 		if wireType == 4 {
-			return fmt.Errorf("proto: DenomUnits: wiretype end group for non-group")
+			return fmt.Errorf("proto: DenomUnit: wiretype end group for non-group")
 		}
 		if fieldNum <= 0 {
-			return fmt.Errorf("proto: DenomUnits: illegal tag %d (wire type %d)", fieldNum, wire)
+			return fmt.Errorf("proto: DenomUnit: illegal tag %d (wire type %d)", fieldNum, wire)
 		}
 		switch fieldNum {
 		case 1:
@@ -1814,7 +1825,7 @@ func (m *Metadata) Unmarshal(dAtA []byte) error {
 			if postIndex > l {
 				return io.ErrUnexpectedEOF
 			}
-			m.DenomUnits = append(m.DenomUnits, &DenomUnits{})
+			m.DenomUnits = append(m.DenomUnits, &DenomUnit{})
 			if err := m.DenomUnits[len(m.DenomUnits)-1].Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
 				return err
 			}
diff --git a/x/bank/types/genesis_test.go b/x/bank/types/genesis_test.go
index 4c7b44f60f..c0a7d61430 100644
--- a/x/bank/types/genesis_test.go
+++ b/x/bank/types/genesis_test.go
@@ -21,7 +21,7 @@ func TestMarshalJSONMetaData(t *testing.T) {
 		{"empty metadata", []types.Metadata{}, `[]`},
 		{"non-empty coins", []types.Metadata{{
 			Description: "The native staking token of the Cosmos Hub.",
-			DenomUnits: []*types.DenomUnits{
+			DenomUnits: []*types.DenomUnit{
 				{"uatom", uint32(0), []string{"microatom"}}, // The default exponent value 0 is omitted in the json
 				{"matom", uint32(3), []string{"milliatom"}},
 				{"atom", uint32(6), nil},
diff --git a/x/bank/types/msgs.go b/x/bank/types/msgs.go
index a169c5df48..4c3f7faeaf 100644
--- a/x/bank/types/msgs.go
+++ b/x/bank/types/msgs.go
@@ -13,7 +13,7 @@ const (
 
 var _ sdk.Msg = &MsgSend{}
 
-// NewMsgSend - construct arbitrary multi-in, multi-out send msg.
+// NewMsgSend - construct a msg to send coins from one account to another.
 func NewMsgSend(fromAddr, toAddr sdk.AccAddress, amount sdk.Coins) *MsgSend {
 	return &MsgSend{FromAddress: fromAddr, ToAddress: toAddr, Amount: amount}
 }
diff --git a/x/bank/types/tx.pb.go b/x/bank/types/tx.pb.go
index 52fc8f1497..d654e508ce 100644
--- a/x/bank/types/tx.pb.go
+++ b/x/bank/types/tx.pb.go
@@ -26,7 +26,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// MsgSend - high level transaction of the coin module
+// MsgSend represents a message to send coins from one account to another.
 type MsgSend struct {
 	FromAddress github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=from_address,json=fromAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"from_address,omitempty" yaml:"from_address"`
 	ToAddress   github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,2,opt,name=to_address,json=toAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"to_address,omitempty" yaml:"to_address"`
@@ -87,7 +87,7 @@ func (m *MsgSend) GetAmount() github_com_cosmos_cosmos_sdk_types.Coins {
 	return nil
 }
 
-// MsgMultiSend - high level transaction of the coin module
+// MsgMultiSend represents an arbitrary multi-in, multi-out send message.
 type MsgMultiSend struct {
 	Inputs  []Input  `protobuf:"bytes,1,rep,name=inputs,proto3" json:"inputs"`
 	Outputs []Output `protobuf:"bytes,2,rep,name=outputs,proto3" json:"outputs"`
diff --git a/x/crisis/types/tx.pb.go b/x/crisis/types/tx.pb.go
index 0157664c82..3f59c10484 100644
--- a/x/crisis/types/tx.pb.go
+++ b/x/crisis/types/tx.pb.go
@@ -25,7 +25,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// MsgVerifyInvariant - message struct to verify a particular invariance
+// MsgVerifyInvariant represents a message to verify a particular invariance.
 type MsgVerifyInvariant struct {
 	Sender              github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=sender,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"sender,omitempty"`
 	InvariantModuleName string                                        `protobuf:"bytes,2,opt,name=invariant_module_name,json=invariantModuleName,proto3" json:"invariant_module_name,omitempty" yaml:"invariant_module_name"`
diff --git a/x/distribution/types/distribution.pb.go b/x/distribution/types/distribution.pb.go
index 2149d45380..aadd833213 100644
--- a/x/distribution/types/distribution.pb.go
+++ b/x/distribution/types/distribution.pb.go
@@ -26,7 +26,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// Params defines the set of distribution parameters.
+// Params defines the set of params for the distribution module.
 type Params struct {
 	CommunityTax        github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,1,opt,name=community_tax,json=communityTax,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"community_tax" yaml:"community_tax"`
 	BaseProposerReward  github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,2,opt,name=base_proposer_reward,json=baseProposerReward,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"base_proposer_reward" yaml:"base_proposer_reward"`
@@ -73,13 +73,12 @@ func (m *Params) GetWithdrawAddrEnabled() bool {
 	return false
 }
 
-// historical rewards for a validator
-// height is implicit within the store key
-// cumulative reward ratio is the sum from the zeroeth period
-// until this period of rewards / tokens, per the spec
+// ValidatorHistoricalRewards represents historical rewards for a validator.
+// Height is implicit within the store key.
+// Cumulative reward ratio is the sum from the zeroeth period
+// until this period of rewards / tokens, per the spec.
 // The reference count indicates the number of objects
-// which might need to reference this historical entry
-// at any point.
+// which might need to reference this historical entry at any point.
 // ReferenceCount =
 //    number of outstanding delegations which ended the associated period (and might need to read
 //    that record)
@@ -137,9 +136,9 @@ func (m *ValidatorHistoricalRewards) GetReferenceCount() uint32 {
 	return 0
 }
 
-// current rewards and current period for a validator
-// kept as a running counter and incremented each block
-// as long as the validator's tokens remain constant
+// ValidatorCurrentRewards represents current rewards and current
+// period for a validator kept as a running counter and incremented
+// each block as long as the validator's tokens remain constant.
 type ValidatorCurrentRewards struct {
 	Rewards github_com_cosmos_cosmos_sdk_types.DecCoins `protobuf:"bytes,1,rep,name=rewards,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.DecCoins" json:"rewards"`
 	Period  uint64                                      `protobuf:"varint,2,opt,name=period,proto3" json:"period,omitempty"`
@@ -192,8 +191,8 @@ func (m *ValidatorCurrentRewards) GetPeriod() uint64 {
 	return 0
 }
 
-// accumulated commission for a validator
-// kept as a running counter, can be withdrawn at any time
+// ValidatorAccumulatedCommission represents accumulated commission
+// for a validator kept as a running counter, can be withdrawn at any time.
 type ValidatorAccumulatedCommission struct {
 	Commission github_com_cosmos_cosmos_sdk_types.DecCoins `protobuf:"bytes,1,rep,name=commission,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.DecCoins" json:"commission"`
 }
@@ -238,8 +237,8 @@ func (m *ValidatorAccumulatedCommission) GetCommission() github_com_cosmos_cosmo
 	return nil
 }
 
-// outstanding (un-withdrawn) rewards for a validator
-// inexpensive to track, allows simple sanity checks
+// ValidatorOutstandingRewards represents outstanding (un-withdrawn) rewards
+// for a validator inexpensive to track, allows simple sanity checks.
 type ValidatorOutstandingRewards struct {
 	Rewards github_com_cosmos_cosmos_sdk_types.DecCoins `protobuf:"bytes,1,rep,name=rewards,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.DecCoins" json:"rewards" yaml:"rewards"`
 }
@@ -284,10 +283,10 @@ func (m *ValidatorOutstandingRewards) GetRewards() github_com_cosmos_cosmos_sdk_
 	return nil
 }
 
-// validator slash event
-// height is implicit within the store key
-// needed to calculate appropriate amounts of staking token
-// for delegations which withdraw after a slash has occurred
+// ValidatorSlashEvent represents a validator slash event.
+// Height is implicit within the store key.
+// This is needed to calculate appropriate amount of staking tokens
+// for delegations which are withdrawn after a slash has occurred.
 type ValidatorSlashEvent struct {
 	ValidatorPeriod uint64                                 `protobuf:"varint,1,opt,name=validator_period,json=validatorPeriod,proto3" json:"validator_period,omitempty" yaml:"validator_period"`
 	Fraction        github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,2,opt,name=fraction,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"fraction"`
@@ -333,7 +332,7 @@ func (m *ValidatorSlashEvent) GetValidatorPeriod() uint64 {
 	return 0
 }
 
-// ValidatorSlashEvents is a collection of ValidatorSlashEvent
+// ValidatorSlashEvents is a collection of ValidatorSlashEvent messages.
 type ValidatorSlashEvents struct {
 	ValidatorSlashEvents []ValidatorSlashEvent `protobuf:"bytes,1,rep,name=validator_slash_events,json=validatorSlashEvents,proto3" json:"validator_slash_events" yaml:"validator_slash_events"`
 }
@@ -377,7 +376,7 @@ func (m *ValidatorSlashEvents) GetValidatorSlashEvents() []ValidatorSlashEvent {
 	return nil
 }
 
-// global fee pool for distribution
+// FeePool is the global fee pool for distribution.
 type FeePool struct {
 	CommunityPool github_com_cosmos_cosmos_sdk_types.DecCoins `protobuf:"bytes,1,rep,name=community_pool,json=communityPool,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.DecCoins" json:"community_pool" yaml:"community_pool"`
 }
@@ -422,7 +421,9 @@ func (m *FeePool) GetCommunityPool() github_com_cosmos_cosmos_sdk_types.DecCoins
 	return nil
 }
 
-// CommunityPoolSpendProposal spends from the community pool
+// CommunityPoolSpendProposal details a proposal for use of community funds,
+// together with how many coins are proposed to be spent, and to which
+// recipient account.
 type CommunityPoolSpendProposal struct {
 	Title       string                                        `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
 	Description string                                        `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
@@ -462,13 +463,13 @@ func (m *CommunityPoolSpendProposal) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_CommunityPoolSpendProposal proto.InternalMessageInfo
 
-// starting info for a delegator reward period
-// tracks the previous validator period, the delegation's amount
+// DelegatorStartingInfo represents the starting info for a delegator reward period.
+// It tracks the previous validator period, the delegation's amount
 // of staking token, and the creation height (to check later on
-// if any slashes have occurred)
-// NOTE that even though validators are slashed to whole staking tokens, the
+// if any slashes have occurred).
+// NOTE: Even though validators are slashed to whole staking tokens, the
 // delegators within the validator may be left with less than a full token,
-// thus sdk.Dec is used
+// thus sdk.Dec is used.
 type DelegatorStartingInfo struct {
 	PreviousPeriod uint64                                 `protobuf:"varint,1,opt,name=previous_period,json=previousPeriod,proto3" json:"previous_period,omitempty" yaml:"previous_period"`
 	Stake          github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,2,opt,name=stake,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"stake" yaml:"stake"`
@@ -522,7 +523,7 @@ func (m *DelegatorStartingInfo) GetHeight() uint64 {
 	return 0
 }
 
-// DelegationDelegatorReward defines the properties
+// DelegationDelegatorReward represents the properties
 // of a delegator's delegation reward.
 type DelegationDelegatorReward struct {
 	ValidatorAddress github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,1,opt,name=validator_address,json=validatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"validator_address,omitempty" yaml:"validator_address"`
diff --git a/x/distribution/types/tx.pb.go b/x/distribution/types/tx.pb.go
index e86f560c7c..f172166a67 100644
--- a/x/distribution/types/tx.pb.go
+++ b/x/distribution/types/tx.pb.go
@@ -26,7 +26,8 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// msg struct for changing the withdraw address for a delegator (or validator self-delegation)
+// MsgSetWithdrawAddress sets the withdraw address for
+// a delegator (or validator self-delegation).
 type MsgSetWithdrawAddress struct {
 	DelegatorAddress github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=delegator_address,json=delegatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"delegator_address,omitempty" yaml:"delegator_address"`
 	WithdrawAddress  github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,2,opt,name=withdraw_address,json=withdrawAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"withdraw_address,omitempty" yaml:"withdraw_address"`
@@ -79,7 +80,8 @@ func (m *MsgSetWithdrawAddress) GetWithdrawAddress() github_com_cosmos_cosmos_sd
 	return nil
 }
 
-// msg struct for delegation withdraw from a single validator
+// MsgWithdrawDelegatorReward represents delegation withdrawal to a delegator
+// from a single validator.
 type MsgWithdrawDelegatorReward struct {
 	DelegatorAddress github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=delegator_address,json=delegatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"delegator_address,omitempty" yaml:"delegator_address"`
 	ValidatorAddress github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,2,opt,name=validator_address,json=validatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"validator_address,omitempty" yaml:"validator_address"`
@@ -132,7 +134,7 @@ func (m *MsgWithdrawDelegatorReward) GetValidatorAddress() github_com_cosmos_cos
 	return nil
 }
 
-// msg struct for validator withdraw
+// MsgWithdrawValidatorCommission withdraws the full commission to the validator address.
 type MsgWithdrawValidatorCommission struct {
 	ValidatorAddress github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,1,opt,name=validator_address,json=validatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"validator_address,omitempty" yaml:"validator_address"`
 }
@@ -177,7 +179,7 @@ func (m *MsgWithdrawValidatorCommission) GetValidatorAddress() github_com_cosmos
 	return nil
 }
 
-// MsgFundCommunityPool defines a Msg type that allows an account to directly
+// MsgFundCommunityPool allows an account to directly
 // fund the community pool.
 type MsgFundCommunityPool struct {
 	Amount    github_com_cosmos_cosmos_sdk_types.Coins      `protobuf:"bytes,1,rep,name=amount,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"amount"`
diff --git a/x/evidence/types/tx.pb.go b/x/evidence/types/tx.pb.go
index 205e1b117a..ce00fadb82 100644
--- a/x/evidence/types/tx.pb.go
+++ b/x/evidence/types/tx.pb.go
@@ -27,8 +27,8 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// MsgSubmitEvidence defines an sdk.Msg type that supports submitting arbitrary
-// Evidence.
+// MsgSubmitEvidence represents a message that supports submitting arbitrary
+// Evidence of misbehavior such as equivocation or counterfactual signing.
 type MsgSubmitEvidence struct {
 	Submitter github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=submitter,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"submitter,omitempty"`
 	Evidence  *types.Any                                    `protobuf:"bytes,2,opt,name=evidence,proto3" json:"evidence,omitempty"`
diff --git a/x/gov/keeper/tally.go b/x/gov/keeper/tally.go
index c0838d696f..993167ec33 100644
--- a/x/gov/keeper/tally.go
+++ b/x/gov/keeper/tally.go
@@ -100,7 +100,7 @@ func (keeper Keeper) Tally(ctx sdk.Context, proposal types.Proposal) (passes boo
 	}
 
 	// If more than 1/3 of voters veto, proposal fails
-	if results[types.OptionNoWithVeto].Quo(totalVotingPower).GT(tallyParams.Veto) {
+	if results[types.OptionNoWithVeto].Quo(totalVotingPower).GT(tallyParams.VetoThreshold) {
 		return false, true, tallyResults
 	}
 
diff --git a/x/gov/simulation/genesis_test.go b/x/gov/simulation/genesis_test.go
index 9cc54045e9..1df3202dd0 100644
--- a/x/gov/simulation/genesis_test.go
+++ b/x/gov/simulation/genesis_test.go
@@ -46,7 +46,7 @@ func TestRandomizedGenState(t *testing.T) {
 	require.Equal(t, float64(148296), govGenesis.VotingParams.VotingPeriod.Seconds())
 	require.Equal(t, dec1, govGenesis.TallyParams.Quorum)
 	require.Equal(t, dec2, govGenesis.TallyParams.Threshold)
-	require.Equal(t, dec3, govGenesis.TallyParams.Veto)
+	require.Equal(t, dec3, govGenesis.TallyParams.VetoThreshold)
 	require.Equal(t, uint64(0x28), govGenesis.StartingProposalId)
 	require.Equal(t, types.Deposits(nil), govGenesis.Deposits)
 	require.Equal(t, types.Votes(nil), govGenesis.Votes)
diff --git a/x/gov/types/genesis.go b/x/gov/types/genesis.go
index 89607689c4..7f2d138ae3 100644
--- a/x/gov/types/genesis.go
+++ b/x/gov/types/genesis.go
@@ -50,7 +50,7 @@ func ValidateGenesis(data *GenesisState) error {
 			threshold.String())
 	}
 
-	veto := data.TallyParams.Veto
+	veto := data.TallyParams.VetoThreshold
 	if veto.IsNegative() || veto.GT(sdk.OneDec()) {
 		return fmt.Errorf("governance vote veto threshold should be positive and less or equal to one, is %s",
 			veto.String())
diff --git a/x/gov/types/gov.pb.go b/x/gov/types/gov.pb.go
index 80671b3e83..8d7b9023f9 100644
--- a/x/gov/types/gov.pb.go
+++ b/x/gov/types/gov.pb.go
@@ -33,7 +33,7 @@ var _ = time.Kitchen
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// VoteOption defines a vote option
+// VoteOption enumerates the valid vote options for a given governance proposal.
 type VoteOption int32
 
 const (
@@ -73,7 +73,7 @@ func (VoteOption) EnumDescriptor() ([]byte, []int) {
 	return fileDescriptor_6e82113c1a9a4b7c, []int{0}
 }
 
-// ProposalStatus is a type alias that represents a proposal status as a byte
+// ProposalStatus enumerates the valid statuses of a proposal.
 type ProposalStatus int32
 
 const (
@@ -118,7 +118,7 @@ func (ProposalStatus) EnumDescriptor() ([]byte, []int) {
 }
 
 // TextProposal defines a standard text proposal whose changes need to be
-// manually updated in case of approval
+// manually updated in case of approval.
 type TextProposal struct {
 	Title       string `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
 	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
@@ -156,7 +156,7 @@ func (m *TextProposal) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_TextProposal proto.InternalMessageInfo
 
-// Deposit defines an amount deposited by an account address to an active proposal
+// Deposit defines an amount deposited by an account address to an active proposal.
 type Deposit struct {
 	ProposalId uint64                                        `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"proposal_id,omitempty" yaml:"proposal_id"`
 	Depositor  github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,2,opt,name=depositor,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"depositor,omitempty"`
@@ -195,7 +195,7 @@ func (m *Deposit) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_Deposit proto.InternalMessageInfo
 
-// Proposal defines the core field members of a governance proposal
+// Proposal defines the core field members of a governance proposal.
 type Proposal struct {
 	ProposalId       uint64                                   `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"id" yaml:"id"`
 	Content          *types1.Any                              `protobuf:"bytes,2,opt,name=content,proto3" json:"content,omitempty"`
@@ -240,7 +240,7 @@ func (m *Proposal) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_Proposal proto.InternalMessageInfo
 
-// TallyResult defines a standard tally for a proposal
+// TallyResult defines a standard tally for a governance proposal.
 type TallyResult struct {
 	Yes        github_com_cosmos_cosmos_sdk_types.Int `protobuf:"bytes,1,opt,name=yes,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Int" json:"yes"`
 	Abstain    github_com_cosmos_cosmos_sdk_types.Int `protobuf:"bytes,2,opt,name=abstain,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Int" json:"abstain"`
@@ -280,8 +280,8 @@ func (m *TallyResult) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_TallyResult proto.InternalMessageInfo
 
-// Vote defines a vote on a governance proposal. A vote corresponds to a proposal
-// ID, the voter, and the vote option.
+// Vote defines a vote on a governance proposal.
+// A Vote consists of a proposal ID, the voter, and the vote option.
 type Vote struct {
 	ProposalId uint64                                        `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"proposal_id,omitempty" yaml:"proposal_id"`
 	Voter      github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,2,opt,name=voter,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"voter,omitempty"`
@@ -320,7 +320,7 @@ func (m *Vote) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_Vote proto.InternalMessageInfo
 
-// DepositParams defines the params around deposits for governance
+// DepositParams defines the params for deposits on governance proposals.
 type DepositParams struct {
 	//  Minimum deposit for a proposal to enter voting period.
 	MinDeposit github_com_cosmos_cosmos_sdk_types.Coins `protobuf:"bytes,1,rep,name=min_deposit,json=minDeposit,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"min_deposit,omitempty" yaml:"min_deposit"`
@@ -360,7 +360,7 @@ func (m *DepositParams) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_DepositParams proto.InternalMessageInfo
 
-// VotingParams defines the params around Voting in governance
+// VotingParams defines the params for voting on governance proposals.
 type VotingParams struct {
 	//  Length of the voting period.
 	VotingPeriod time.Duration `protobuf:"bytes,1,opt,name=voting_period,json=votingPeriod,proto3,stdduration" json:"voting_period,omitempty" yaml:"voting_period"`
@@ -398,14 +398,14 @@ func (m *VotingParams) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_VotingParams proto.InternalMessageInfo
 
-// TallyParams defines the params around Tallying votes in governance
+// TallyParams defines the params for tallying votes on governance proposals.
 type TallyParams struct {
 	//  Minimum percentage of total stake needed to vote for a result to be considered valid.
 	Quorum github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,1,opt,name=quorum,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"quorum,omitempty"`
-	//  Minimum proportion of Yes votes for proposal to pass. Initial value: 0.5.
+	//  Minimum proportion of Yes votes for proposal to pass. Default value: 0.5.
 	Threshold github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,2,opt,name=threshold,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"threshold,omitempty"`
-	//  Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Initial value: 1/3.
-	Veto github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,3,opt,name=veto,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"veto,omitempty"`
+	//  Minimum value of Veto votes to Total votes ratio for proposal to be vetoed. Default value: 1/3.
+	VetoThreshold github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,3,opt,name=veto_threshold,json=vetoThreshold,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"veto_threshold,omitempty" yaml:"veto_threshold"`
 }
 
 func (m *TallyParams) Reset()      { *m = TallyParams{} }
@@ -456,93 +456,94 @@ func init() {
 func init() { proto.RegisterFile("cosmos/gov/v1beta1/gov.proto", fileDescriptor_6e82113c1a9a4b7c) }
 
 var fileDescriptor_6e82113c1a9a4b7c = []byte{
-	// 1375 bytes of a gzipped FileDescriptorProto
-	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xa4, 0x57, 0x41, 0x6c, 0xdb, 0xd4,
-	0x1b, 0x8f, 0xd3, 0xb4, 0x5d, 0x5f, 0xd2, 0xd6, 0x7b, 0xed, 0xbf, 0x4d, 0xfd, 0xdf, 0xdf, 0xf6,
-	0xdf, 0x20, 0x54, 0x4d, 0x5b, 0xba, 0x15, 0x04, 0x62, 0x93, 0xd0, 0x92, 0xc6, 0xdb, 0x82, 0xa6,
-	0x24, 0x72, 0xbc, 0x4c, 0x1b, 0x07, 0xcb, 0x89, 0xdf, 0x52, 0x43, 0xec, 0x17, 0xe2, 0x97, 0xd2,
-	0x88, 0x0b, 0xc7, 0x29, 0x48, 0x68, 0x47, 0x24, 0x14, 0x09, 0x09, 0x4e, 0x9c, 0x39, 0x73, 0x44,
-	0x15, 0xe2, 0x30, 0x71, 0x9a, 0x38, 0x64, 0xac, 0x93, 0x10, 0xea, 0xb1, 0x07, 0x0e, 0x1c, 0x10,
-	0xb2, 0xdf, 0x73, 0xe3, 0x24, 0x15, 0x5d, 0xe0, 0x54, 0xfb, 0xfb, 0xbe, 0xdf, 0xef, 0xfb, 0xde,
-	0xef, 0x7d, 0xdf, 0xe7, 0x06, 0x5c, 0xa8, 0x63, 0xcf, 0xc1, 0xde, 0x56, 0x03, 0xef, 0x6d, 0xed,
-	0x5d, 0xad, 0x21, 0x62, 0x5e, 0xf5, 0x9f, 0x33, 0xad, 0x36, 0x26, 0x18, 0x42, 0xea, 0xcd, 0xf8,
-	0x16, 0xe6, 0x15, 0x44, 0x86, 0xa8, 0x99, 0x1e, 0x3a, 0x81, 0xd4, 0xb1, 0xed, 0x52, 0x8c, 0xb0,
-	0xda, 0xc0, 0x0d, 0x1c, 0x3c, 0x6e, 0xf9, 0x4f, 0xcc, 0xba, 0x41, 0x51, 0x06, 0x75, 0x30, 0x5a,
-	0xea, 0x92, 0x1a, 0x18, 0x37, 0x9a, 0x68, 0x2b, 0x78, 0xab, 0x75, 0x1e, 0x6e, 0x11, 0xdb, 0x41,
-	0x1e, 0x31, 0x9d, 0x56, 0x88, 0x1d, 0x0f, 0x30, 0xdd, 0x2e, 0x73, 0x89, 0xe3, 0x2e, 0xab, 0xd3,
-	0x36, 0x89, 0x8d, 0x59, 0x31, 0xca, 0x3d, 0x90, 0xd2, 0xd1, 0x3e, 0x29, 0xb7, 0x71, 0x0b, 0x7b,
-	0x66, 0x13, 0xae, 0x82, 0x59, 0x62, 0x93, 0x26, 0x4a, 0x73, 0x32, 0xb7, 0xb9, 0xa0, 0xd1, 0x17,
-	0x28, 0x83, 0xa4, 0x85, 0xbc, 0x7a, 0xdb, 0x6e, 0xf9, 0xd0, 0x74, 0x3c, 0xf0, 0x45, 0x4d, 0xd7,
-	0x96, 0x7f, 0xfb, 0x52, 0xe2, 0x7e, 0xfa, 0xf6, 0xf2, 0xfc, 0x0e, 0x76, 0x09, 0x72, 0x89, 0xf2,
-	0x27, 0x07, 0xe6, 0xf3, 0xa8, 0x85, 0x3d, 0x9b, 0xc0, 0xb7, 0x40, 0xb2, 0xc5, 0x12, 0x18, 0xb6,
-	0x15, 0x50, 0x27, 0x72, 0x6b, 0xc7, 0x03, 0x09, 0x76, 0x4d, 0xa7, 0x79, 0x4d, 0x89, 0x38, 0x15,
-	0x0d, 0x84, 0x6f, 0x05, 0x0b, 0x96, 0xc0, 0x82, 0x45, 0x39, 0x70, 0x3b, 0xc8, 0x9a, 0xca, 0x5d,
-	0xfd, 0x63, 0x20, 0x5d, 0x6e, 0xd8, 0x64, 0xb7, 0x53, 0xcb, 0xd4, 0xb1, 0xc3, 0x94, 0x62, 0x7f,
-	0x2e, 0x7b, 0xd6, 0x07, 0x5b, 0xa4, 0xdb, 0x42, 0x5e, 0x26, 0x5b, 0xaf, 0x67, 0x2d, 0xab, 0x8d,
-	0x3c, 0x4f, 0x1b, 0x72, 0xc0, 0x3a, 0x98, 0x33, 0x1d, 0xdc, 0x71, 0x49, 0x7a, 0x46, 0x9e, 0xd9,
-	0x4c, 0x6e, 0x6f, 0x64, 0x98, 0xd2, 0xfe, 0x65, 0x85, 0x37, 0x98, 0xd9, 0xc1, 0xb6, 0x9b, 0xbb,
-	0x72, 0x30, 0x90, 0x62, 0xdf, 0x3c, 0x93, 0x36, 0x5f, 0x22, 0x99, 0x0f, 0xf0, 0x34, 0x46, 0x7d,
-	0x2d, 0xe1, 0x6b, 0xa1, 0xfc, 0x3e, 0x07, 0xce, 0x9d, 0xc8, 0xfa, 0xc6, 0x69, 0x0a, 0xac, 0x1c,
-	0x0d, 0xa4, 0xb8, 0x6d, 0x1d, 0x0f, 0xa4, 0x05, 0xaa, 0xc3, 0xf8, 0xf1, 0xaf, 0x83, 0xf9, 0x3a,
-	0x95, 0x33, 0x38, 0x7c, 0x72, 0x7b, 0x35, 0x43, 0xaf, 0x33, 0x13, 0x5e, 0x67, 0x26, 0xeb, 0x76,
-	0x73, 0xc9, 0x1f, 0x86, 0xba, 0x6b, 0x21, 0x02, 0x56, 0xc1, 0x9c, 0x47, 0x4c, 0xd2, 0xf1, 0xd2,
-	0x33, 0x32, 0xb7, 0xb9, 0xb4, 0xad, 0x64, 0x26, 0x7b, 0x35, 0x13, 0x16, 0x58, 0x09, 0x22, 0x73,
-	0xc2, 0xf1, 0x40, 0x5a, 0x1b, 0xbb, 0x13, 0x4a, 0xa2, 0x68, 0x8c, 0x0d, 0xb6, 0x00, 0x7c, 0x68,
-	0xbb, 0x66, 0xd3, 0x20, 0x66, 0xb3, 0xd9, 0x35, 0xda, 0xc8, 0xeb, 0x34, 0x49, 0x3a, 0x11, 0xd4,
-	0x27, 0x9d, 0x96, 0x43, 0xf7, 0xe3, 0xb4, 0x20, 0x2c, 0xf7, 0x7f, 0x5f, 0xd4, 0xe3, 0x81, 0xb4,
-	0x41, 0x93, 0x4c, 0x12, 0x29, 0x1a, 0x1f, 0x18, 0x23, 0x20, 0xf8, 0x1e, 0x48, 0x7a, 0x9d, 0x9a,
-	0x63, 0x13, 0xc3, 0x6f, 0xfc, 0xf4, 0x6c, 0x90, 0x4a, 0x98, 0x90, 0x42, 0x0f, 0xa7, 0x22, 0x27,
-	0xb2, 0x2c, 0xac, 0xbd, 0x22, 0x60, 0xe5, 0xf1, 0x33, 0x89, 0xd3, 0x00, 0xb5, 0xf8, 0x00, 0x68,
-	0x03, 0x9e, 0xb5, 0x87, 0x81, 0x5c, 0x8b, 0x66, 0x98, 0x3b, 0x33, 0xc3, 0x2b, 0x2c, 0xc3, 0x3a,
-	0xcd, 0x30, 0xce, 0x40, 0xd3, 0x2c, 0x31, 0xb3, 0xea, 0x5a, 0x41, 0xaa, 0x47, 0x1c, 0x58, 0x24,
-	0x98, 0x98, 0x4d, 0x83, 0x39, 0xd2, 0xf3, 0x67, 0x35, 0xe1, 0x6d, 0x96, 0x67, 0x95, 0xe6, 0x19,
-	0x41, 0x2b, 0x53, 0x35, 0x67, 0x2a, 0xc0, 0x86, 0x13, 0xd9, 0x04, 0xe7, 0xf7, 0x30, 0xb1, 0xdd,
-	0x86, 0x7f, 0xbd, 0x6d, 0x26, 0xec, 0xb9, 0x33, 0x8f, 0xfd, 0x2a, 0x2b, 0x27, 0x4d, 0xcb, 0x99,
-	0xa0, 0xa0, 0xe7, 0x5e, 0xa6, 0xf6, 0x8a, 0x6f, 0x0e, 0x0e, 0xfe, 0x10, 0x30, 0xd3, 0x50, 0xe2,
-	0x85, 0x33, 0x73, 0x29, 0x2c, 0xd7, 0xda, 0x48, 0xae, 0x51, 0x85, 0x17, 0xa9, 0x95, 0x09, 0xcc,
-	0x06, 0xef, 0x20, 0x0e, 0x92, 0xd1, 0xf6, 0xb9, 0x01, 0x66, 0xba, 0xc8, 0xa3, 0x0b, 0x2d, 0x97,
-	0xf1, 0x59, 0x7f, 0x1e, 0x48, 0xaf, 0xbd, 0x84, 0x70, 0x05, 0x97, 0x68, 0x3e, 0x14, 0xde, 0x06,
-	0xf3, 0x66, 0xcd, 0x23, 0xa6, 0xcd, 0x56, 0xdf, 0xd4, 0x2c, 0x21, 0x1c, 0xbe, 0x03, 0xe2, 0x2e,
-	0x0e, 0x06, 0x72, 0x7a, 0x92, 0xb8, 0x8b, 0x61, 0x03, 0xa4, 0x5c, 0x6c, 0x7c, 0x64, 0x93, 0x5d,
-	0x63, 0x0f, 0x11, 0x1c, 0x8c, 0xdd, 0x42, 0x4e, 0x9d, 0x8e, 0xe9, 0x78, 0x20, 0xad, 0x50, 0x51,
-	0xa3, 0x5c, 0x8a, 0x06, 0x5c, 0x7c, 0xcf, 0x26, 0xbb, 0x55, 0x44, 0x30, 0x93, 0xf2, 0x7b, 0x0e,
-	0x24, 0xaa, 0x98, 0xa0, 0x7f, 0xbe, 0xc1, 0x6f, 0x81, 0xd9, 0x3d, 0x4c, 0xd0, 0xbf, 0xd8, 0xde,
-	0x14, 0x0f, 0xdf, 0x04, 0x73, 0x98, 0x7e, 0x7d, 0xe8, 0x3a, 0x13, 0x4f, 0x5b, 0x35, 0x7e, 0xad,
-	0xa5, 0x20, 0x4a, 0x63, 0xd1, 0xec, 0x20, 0xdf, 0xc5, 0xc1, 0x22, 0xeb, 0xfd, 0xb2, 0xd9, 0x36,
-	0x1d, 0x0f, 0x7e, 0xc1, 0x81, 0xa4, 0x63, 0xbb, 0x27, 0xa3, 0xc8, 0x9d, 0x35, 0x8a, 0x86, 0x2f,
-	0xf2, 0xd1, 0x40, 0xfa, 0x4f, 0x04, 0x75, 0x09, 0x3b, 0x36, 0x41, 0x4e, 0x8b, 0x74, 0x87, 0x52,
-	0x44, 0xdc, 0xd3, 0x4d, 0x28, 0x70, 0x6c, 0x37, 0x9c, 0xcf, 0xcf, 0x38, 0x00, 0x1d, 0x73, 0x3f,
-	0x24, 0x32, 0x5a, 0xa8, 0x6d, 0x63, 0x8b, 0x7d, 0x05, 0x36, 0x26, 0xa6, 0x26, 0xcf, 0x3e, 0xea,
-	0xb4, 0x13, 0x8e, 0x06, 0xd2, 0x85, 0x49, 0xf0, 0x48, 0xad, 0x6c, 0xff, 0x4e, 0x46, 0x29, 0x9f,
-	0xfb, 0x73, 0xc5, 0x3b, 0xe6, 0x7e, 0x28, 0x17, 0x35, 0x7f, 0xca, 0x81, 0x54, 0x35, 0x18, 0x36,
-	0xa6, 0xdf, 0xc7, 0x80, 0x0d, 0x5f, 0x58, 0x1b, 0x77, 0x56, 0x6d, 0xd7, 0x59, 0x6d, 0xeb, 0x23,
-	0xb8, 0x91, 0xb2, 0x56, 0x47, 0x66, 0x3d, 0x5a, 0x51, 0x8a, 0xda, 0x58, 0x35, 0x5f, 0x87, 0x23,
-	0xce, 0x8a, 0x79, 0x00, 0xe6, 0x3e, 0xec, 0xe0, 0x76, 0xc7, 0x09, 0xaa, 0x48, 0xe5, 0x72, 0x53,
-	0x0c, 0x44, 0x1e, 0xd5, 0x8f, 0x06, 0x12, 0x4f, 0xf1, 0xc3, 0x6a, 0x34, 0xc6, 0x08, 0xeb, 0x60,
-	0x81, 0xec, 0xb6, 0x91, 0xb7, 0x8b, 0x9b, 0x16, 0xeb, 0x62, 0x75, 0x6a, 0xfa, 0x95, 0x13, 0x8a,
-	0x48, 0x86, 0x21, 0x2f, 0xd4, 0x41, 0x22, 0x98, 0xe7, 0x99, 0x80, 0xff, 0xc6, 0xd4, 0xfc, 0x4b,
-	0x3e, 0x3a, 0x42, 0x1d, 0xb0, 0x5d, 0xfc, 0x95, 0x03, 0x60, 0x38, 0x12, 0xf0, 0x12, 0x58, 0xaf,
-	0x96, 0x74, 0xd5, 0x28, 0x95, 0xf5, 0x42, 0xa9, 0x68, 0xdc, 0x2d, 0x56, 0xca, 0xea, 0x4e, 0xe1,
-	0x66, 0x41, 0xcd, 0xf3, 0x31, 0x61, 0xb9, 0xd7, 0x97, 0x93, 0x34, 0x50, 0xf5, 0x29, 0xa0, 0x02,
-	0x96, 0xa3, 0xd1, 0xf7, 0xd5, 0x0a, 0xcf, 0x09, 0x8b, 0xbd, 0xbe, 0xbc, 0x40, 0xa3, 0xee, 0x23,
-	0x0f, 0x5e, 0x04, 0x2b, 0xd1, 0x98, 0x6c, 0xae, 0xa2, 0x67, 0x0b, 0x45, 0x3e, 0x2e, 0x9c, 0xef,
-	0xf5, 0xe5, 0x45, 0x1a, 0x97, 0x65, 0xab, 0x4f, 0x06, 0x4b, 0xd1, 0xd8, 0x62, 0x89, 0x9f, 0x11,
-	0x52, 0xbd, 0xbe, 0x7c, 0x8e, 0x86, 0x15, 0x31, 0xdc, 0x06, 0xe9, 0xd1, 0x08, 0xe3, 0x5e, 0x41,
-	0xbf, 0x6d, 0x54, 0x55, 0xbd, 0xc4, 0x27, 0x84, 0xd5, 0x5e, 0x5f, 0xe6, 0xc3, 0xd8, 0x70, 0x4f,
-	0x09, 0x89, 0x47, 0x5f, 0x89, 0xb1, 0x8b, 0x3f, 0xc6, 0xc1, 0xd2, 0xe8, 0xbf, 0x32, 0x30, 0x03,
-	0xfe, 0x5b, 0xd6, 0x4a, 0xe5, 0x52, 0x25, 0x7b, 0xc7, 0xa8, 0xe8, 0x59, 0xfd, 0x6e, 0x65, 0xec,
-	0xc0, 0xc1, 0x51, 0x68, 0x70, 0xd1, 0x6e, 0xc2, 0xeb, 0x40, 0x1c, 0x8f, 0xcf, 0xab, 0xe5, 0x52,
-	0xa5, 0xa0, 0x1b, 0x65, 0x55, 0x2b, 0x94, 0xf2, 0x3c, 0x27, 0xac, 0xf7, 0xfa, 0xf2, 0x0a, 0x85,
-	0x8c, 0x4c, 0x07, 0x7c, 0x1b, 0xfc, 0x6f, 0x1c, 0x5c, 0x2d, 0xe9, 0x85, 0xe2, 0xad, 0x10, 0x1b,
-	0x17, 0xd6, 0x7a, 0x7d, 0x19, 0x52, 0x6c, 0x35, 0xd2, 0xca, 0xf0, 0x12, 0x58, 0x1b, 0x87, 0x96,
-	0xb3, 0x95, 0x8a, 0x9a, 0xe7, 0x67, 0x04, 0xbe, 0xd7, 0x97, 0x53, 0x14, 0x53, 0x36, 0x3d, 0x0f,
-	0x59, 0xf0, 0x0a, 0x48, 0x8f, 0x47, 0x6b, 0xea, 0xbb, 0xea, 0x8e, 0xae, 0xe6, 0xf9, 0x84, 0x00,
-	0x7b, 0x7d, 0x79, 0x89, 0xc6, 0x6b, 0xe8, 0x7d, 0x54, 0x27, 0xe8, 0x54, 0xfe, 0x9b, 0xd9, 0xc2,
-	0x1d, 0x35, 0xcf, 0xcf, 0x46, 0xf9, 0x6f, 0x9a, 0x76, 0x13, 0x59, 0x54, 0xce, 0x5c, 0xf1, 0xe0,
-	0xb9, 0x18, 0x7b, 0xfa, 0x5c, 0x8c, 0x7d, 0x72, 0x28, 0xc6, 0x0e, 0x0e, 0x45, 0xee, 0xc9, 0xa1,
-	0xc8, 0xfd, 0x72, 0x28, 0x72, 0x8f, 0x5f, 0x88, 0xb1, 0x27, 0x2f, 0xc4, 0xd8, 0xd3, 0x17, 0x62,
-	0xec, 0xc1, 0xdf, 0x6f, 0xb6, 0xfd, 0xe0, 0x17, 0x53, 0xd0, 0xa3, 0xb5, 0xb9, 0x60, 0x19, 0xbc,
-	0xfe, 0x57, 0x00, 0x00, 0x00, 0xff, 0xff, 0x49, 0xad, 0x38, 0x5a, 0x4c, 0x0d, 0x00, 0x00,
+	// 1389 bytes of a gzipped FileDescriptorProto
+	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xa4, 0x57, 0x4f, 0x6c, 0x1b, 0x45,
+	0x17, 0xf7, 0x3a, 0xff, 0xea, 0xb1, 0x93, 0x6c, 0x27, 0x69, 0xe2, 0xec, 0xd7, 0x6f, 0x77, 0xbf,
+	0xfd, 0x10, 0x8a, 0xaa, 0xd6, 0x69, 0x03, 0x02, 0xd1, 0x4a, 0x08, 0x3b, 0xde, 0xb6, 0x46, 0x95,
+	0x6d, 0xad, 0xb7, 0xae, 0x5a, 0x0e, 0xab, 0xb5, 0x77, 0xea, 0x2c, 0x78, 0x77, 0x8c, 0x77, 0x1c,
+	0x62, 0x71, 0xe1, 0x58, 0x19, 0x09, 0xf5, 0x88, 0x84, 0x2c, 0x21, 0x71, 0xe3, 0xcc, 0x99, 0x23,
+	0x8a, 0x10, 0x87, 0x8a, 0x53, 0x05, 0x92, 0x4b, 0x53, 0x09, 0xa1, 0x1c, 0x73, 0xe0, 0xc0, 0x01,
+	0xa1, 0xdd, 0x99, 0x8d, 0xd7, 0x76, 0x44, 0x6a, 0x38, 0x65, 0xf7, 0xcd, 0xfb, 0xfd, 0x7e, 0x6f,
+	0x7e, 0x33, 0xef, 0x6d, 0x0c, 0x2e, 0xd6, 0xb1, 0xe7, 0x60, 0x6f, 0xab, 0x81, 0xf7, 0xb6, 0xf6,
+	0xae, 0xd5, 0x10, 0x31, 0xaf, 0xf9, 0xcf, 0x99, 0x56, 0x1b, 0x13, 0x0c, 0x21, 0x5d, 0xcd, 0xf8,
+	0x11, 0xb6, 0x2a, 0x88, 0x0c, 0x51, 0x33, 0x3d, 0x74, 0x02, 0xa9, 0x63, 0xdb, 0xa5, 0x18, 0x61,
+	0xb5, 0x81, 0x1b, 0x38, 0x78, 0xdc, 0xf2, 0x9f, 0x58, 0x74, 0x83, 0xa2, 0x0c, 0xba, 0xc0, 0x68,
+	0xe9, 0x92, 0xd4, 0xc0, 0xb8, 0xd1, 0x44, 0x5b, 0xc1, 0x5b, 0xad, 0xf3, 0x70, 0x8b, 0xd8, 0x0e,
+	0xf2, 0x88, 0xe9, 0xb4, 0x42, 0xec, 0x78, 0x82, 0xe9, 0x76, 0xd9, 0x92, 0x38, 0xbe, 0x64, 0x75,
+	0xda, 0x26, 0xb1, 0x31, 0x2b, 0x46, 0xb9, 0x07, 0x52, 0x3a, 0xda, 0x27, 0xe5, 0x36, 0x6e, 0x61,
+	0xcf, 0x6c, 0xc2, 0x55, 0x30, 0x47, 0x6c, 0xd2, 0x44, 0x69, 0x4e, 0xe6, 0x36, 0x13, 0x1a, 0x7d,
+	0x81, 0x32, 0x48, 0x5a, 0xc8, 0xab, 0xb7, 0xed, 0x96, 0x0f, 0x4d, 0xc7, 0x83, 0xb5, 0x68, 0xe8,
+	0xfa, 0xf2, 0x6f, 0x5f, 0x4a, 0xdc, 0x8f, 0xdf, 0x5c, 0x59, 0xd8, 0xc1, 0x2e, 0x41, 0x2e, 0x51,
+	0xfe, 0xe4, 0xc0, 0x42, 0x1e, 0xb5, 0xb0, 0x67, 0x13, 0xf8, 0x26, 0x48, 0xb6, 0x98, 0x80, 0x61,
+	0x5b, 0x01, 0xf5, 0x6c, 0x6e, 0xed, 0x78, 0x20, 0xc1, 0xae, 0xe9, 0x34, 0xaf, 0x2b, 0x91, 0x45,
+	0x45, 0x03, 0xe1, 0x5b, 0xc1, 0x82, 0x25, 0x90, 0xb0, 0x28, 0x07, 0x6e, 0x07, 0xaa, 0xa9, 0xdc,
+	0xb5, 0x3f, 0x06, 0xd2, 0x95, 0x86, 0x4d, 0x76, 0x3b, 0xb5, 0x4c, 0x1d, 0x3b, 0xcc, 0x29, 0xf6,
+	0xe7, 0x8a, 0x67, 0x7d, 0xb0, 0x45, 0xba, 0x2d, 0xe4, 0x65, 0xb2, 0xf5, 0x7a, 0xd6, 0xb2, 0xda,
+	0xc8, 0xf3, 0xb4, 0x21, 0x07, 0xac, 0x83, 0x79, 0xd3, 0xc1, 0x1d, 0x97, 0xa4, 0x67, 0xe4, 0x99,
+	0xcd, 0xe4, 0xf6, 0x46, 0x86, 0x39, 0xed, 0x1f, 0x56, 0x78, 0x82, 0x99, 0x1d, 0x6c, 0xbb, 0xb9,
+	0xab, 0x07, 0x03, 0x29, 0xf6, 0xf5, 0x33, 0x69, 0xf3, 0x25, 0xc4, 0x7c, 0x80, 0xa7, 0x31, 0xea,
+	0xeb, 0xb3, 0xbe, 0x17, 0xca, 0xef, 0xf3, 0xe0, 0xdc, 0x89, 0xad, 0xaf, 0x9f, 0xe6, 0xc0, 0xca,
+	0xd1, 0x40, 0x8a, 0xdb, 0xd6, 0xf1, 0x40, 0x4a, 0x50, 0x1f, 0xc6, 0xb7, 0x7f, 0x03, 0x2c, 0xd4,
+	0xa9, 0x9d, 0xc1, 0xe6, 0x93, 0xdb, 0xab, 0x19, 0x7a, 0x9c, 0x99, 0xf0, 0x38, 0x33, 0x59, 0xb7,
+	0x9b, 0x4b, 0x7e, 0x3f, 0xf4, 0x5d, 0x0b, 0x11, 0xb0, 0x0a, 0xe6, 0x3d, 0x62, 0x92, 0x8e, 0x97,
+	0x9e, 0x91, 0xb9, 0xcd, 0xa5, 0x6d, 0x25, 0x33, 0x79, 0x57, 0x33, 0x61, 0x81, 0x95, 0x20, 0x33,
+	0x27, 0x1c, 0x0f, 0xa4, 0xb5, 0xb1, 0x33, 0xa1, 0x24, 0x8a, 0xc6, 0xd8, 0x60, 0x0b, 0xc0, 0x87,
+	0xb6, 0x6b, 0x36, 0x0d, 0x62, 0x36, 0x9b, 0x5d, 0xa3, 0x8d, 0xbc, 0x4e, 0x93, 0xa4, 0x67, 0x83,
+	0xfa, 0xa4, 0xd3, 0x34, 0x74, 0x3f, 0x4f, 0x0b, 0xd2, 0x72, 0xff, 0xf3, 0x4d, 0x3d, 0x1e, 0x48,
+	0x1b, 0x54, 0x64, 0x92, 0x48, 0xd1, 0xf8, 0x20, 0x18, 0x01, 0xc1, 0xf7, 0x40, 0xd2, 0xeb, 0xd4,
+	0x1c, 0x9b, 0x18, 0xfe, 0xc5, 0x4f, 0xcf, 0x05, 0x52, 0xc2, 0x84, 0x15, 0x7a, 0xd8, 0x15, 0x39,
+	0x91, 0xa9, 0xb0, 0xeb, 0x15, 0x01, 0x2b, 0x8f, 0x9f, 0x49, 0x9c, 0x06, 0x68, 0xc4, 0x07, 0x40,
+	0x1b, 0xf0, 0xec, 0x7a, 0x18, 0xc8, 0xb5, 0xa8, 0xc2, 0xfc, 0x99, 0x0a, 0xff, 0x67, 0x0a, 0xeb,
+	0x54, 0x61, 0x9c, 0x81, 0xca, 0x2c, 0xb1, 0xb0, 0xea, 0x5a, 0x81, 0xd4, 0x23, 0x0e, 0x2c, 0x12,
+	0x4c, 0xcc, 0xa6, 0xc1, 0x16, 0xd2, 0x0b, 0x67, 0x5d, 0xc2, 0xdb, 0x4c, 0x67, 0x95, 0xea, 0x8c,
+	0xa0, 0x95, 0xa9, 0x2e, 0x67, 0x2a, 0xc0, 0x86, 0x1d, 0xd9, 0x04, 0xe7, 0xf7, 0x30, 0xb1, 0xdd,
+	0x86, 0x7f, 0xbc, 0x6d, 0x66, 0xec, 0xb9, 0x33, 0xb7, 0xfd, 0x0a, 0x2b, 0x27, 0x4d, 0xcb, 0x99,
+	0xa0, 0xa0, 0xfb, 0x5e, 0xa6, 0xf1, 0x8a, 0x1f, 0x0e, 0x36, 0xfe, 0x10, 0xb0, 0xd0, 0xd0, 0xe2,
+	0xc4, 0x99, 0x5a, 0x0a, 0xd3, 0x5a, 0x1b, 0xd1, 0x1a, 0x75, 0x78, 0x91, 0x46, 0x99, 0xc1, 0xac,
+	0xf1, 0x0e, 0xe2, 0x20, 0x19, 0xbd, 0x3e, 0xef, 0x80, 0x99, 0x2e, 0xf2, 0xe8, 0x40, 0xcb, 0x65,
+	0x7c, 0xd6, 0x9f, 0x06, 0xd2, 0xab, 0x2f, 0x61, 0x5c, 0xc1, 0x25, 0x9a, 0x0f, 0x85, 0xb7, 0xc1,
+	0x82, 0x59, 0xf3, 0x88, 0x69, 0xb3, 0xd1, 0x37, 0x35, 0x4b, 0x08, 0x87, 0x6f, 0x83, 0xb8, 0x8b,
+	0x83, 0x86, 0x9c, 0x9e, 0x24, 0xee, 0x62, 0xd8, 0x00, 0x29, 0x17, 0x1b, 0x1f, 0xd9, 0x64, 0xd7,
+	0xd8, 0x43, 0x04, 0x07, 0x6d, 0x97, 0xc8, 0xa9, 0xd3, 0x31, 0x1d, 0x0f, 0xa4, 0x15, 0x6a, 0x6a,
+	0x94, 0x4b, 0xd1, 0x80, 0x8b, 0xef, 0xd9, 0x64, 0xb7, 0x8a, 0x08, 0x66, 0x56, 0x7e, 0xc7, 0x81,
+	0xd9, 0x2a, 0x26, 0xe8, 0x9f, 0x4f, 0xf0, 0x5b, 0x60, 0x6e, 0x0f, 0x13, 0xf4, 0x2f, 0xa6, 0x37,
+	0xc5, 0xc3, 0x37, 0xc0, 0x3c, 0xa6, 0x5f, 0x1f, 0x3a, 0xce, 0xc4, 0xd3, 0x46, 0x8d, 0x5f, 0x6b,
+	0x29, 0xc8, 0xd2, 0x58, 0x36, 0xdb, 0xc8, 0xb7, 0x71, 0xb0, 0xc8, 0xee, 0x7e, 0xd9, 0x6c, 0x9b,
+	0x8e, 0x07, 0xbf, 0xe0, 0x40, 0xd2, 0xb1, 0xdd, 0x93, 0x56, 0xe4, 0xce, 0x6a, 0x45, 0xc3, 0x37,
+	0xf9, 0x68, 0x20, 0x5d, 0x88, 0xa0, 0x2e, 0x63, 0xc7, 0x26, 0xc8, 0x69, 0x91, 0xee, 0xd0, 0x8a,
+	0xc8, 0xf2, 0x74, 0x1d, 0x0a, 0x1c, 0xdb, 0x0d, 0xfb, 0xf3, 0x33, 0x0e, 0x40, 0xc7, 0xdc, 0x0f,
+	0x89, 0x8c, 0x16, 0x6a, 0xdb, 0xd8, 0x62, 0x5f, 0x81, 0x8d, 0x89, 0xae, 0xc9, 0xb3, 0x8f, 0x3a,
+	0xbd, 0x09, 0x47, 0x03, 0xe9, 0xe2, 0x24, 0x78, 0xa4, 0x56, 0x36, 0x7f, 0x27, 0xb3, 0x94, 0xcf,
+	0xfd, 0xbe, 0xe2, 0x1d, 0x73, 0x3f, 0xb4, 0x8b, 0x86, 0x3f, 0xe5, 0x40, 0xaa, 0x1a, 0x34, 0x1b,
+	0xf3, 0xef, 0x63, 0xc0, 0x9a, 0x2f, 0xac, 0x8d, 0x3b, 0xab, 0xb6, 0x1b, 0xac, 0xb6, 0xf5, 0x11,
+	0xdc, 0x48, 0x59, 0xab, 0x23, 0xbd, 0x1e, 0xad, 0x28, 0x45, 0x63, 0xac, 0x9a, 0x9f, 0xc3, 0x16,
+	0x67, 0xc5, 0x3c, 0x00, 0xf3, 0x1f, 0x76, 0x70, 0xbb, 0xe3, 0x04, 0x55, 0xa4, 0x72, 0xb9, 0x29,
+	0x1a, 0x22, 0x8f, 0xea, 0x47, 0x03, 0x89, 0xa7, 0xf8, 0x61, 0x35, 0x1a, 0x63, 0x84, 0x75, 0x90,
+	0x20, 0xbb, 0x6d, 0xe4, 0xed, 0xe2, 0xa6, 0xc5, 0x6e, 0xb1, 0x3a, 0x35, 0xfd, 0xca, 0x09, 0x45,
+	0x44, 0x61, 0xc8, 0x0b, 0x7b, 0x1c, 0x58, 0xf2, 0x9b, 0xd0, 0x18, 0x4a, 0xcd, 0x04, 0x52, 0xf5,
+	0xa9, 0xa5, 0xd2, 0xa3, 0x3c, 0x23, 0xfe, 0x5e, 0x60, 0xfe, 0x8e, 0x64, 0x28, 0xda, 0xa2, 0x1f,
+	0xd0, 0xc3, 0xf7, 0x4b, 0xbf, 0x72, 0x00, 0x0c, 0x3b, 0x09, 0x5e, 0x06, 0xeb, 0xd5, 0x92, 0xae,
+	0x1a, 0xa5, 0xb2, 0x5e, 0x28, 0x15, 0x8d, 0xbb, 0xc5, 0x4a, 0x59, 0xdd, 0x29, 0xdc, 0x2c, 0xa8,
+	0x79, 0x3e, 0x26, 0x2c, 0xf7, 0xfa, 0x72, 0x92, 0x26, 0xaa, 0xbe, 0x08, 0x54, 0xc0, 0x72, 0x34,
+	0xfb, 0xbe, 0x5a, 0xe1, 0x39, 0x61, 0xb1, 0xd7, 0x97, 0x13, 0x34, 0xeb, 0x3e, 0xf2, 0xe0, 0x25,
+	0xb0, 0x12, 0xcd, 0xc9, 0xe6, 0x2a, 0x7a, 0xb6, 0x50, 0xe4, 0xe3, 0xc2, 0xf9, 0x5e, 0x5f, 0x5e,
+	0xa4, 0x79, 0x59, 0x36, 0x31, 0x65, 0xb0, 0x14, 0xcd, 0x2d, 0x96, 0xf8, 0x19, 0x21, 0xd5, 0xeb,
+	0xcb, 0xe7, 0x68, 0x5a, 0x11, 0xc3, 0x6d, 0x90, 0x1e, 0xcd, 0x30, 0xee, 0x15, 0xf4, 0xdb, 0x46,
+	0x55, 0xd5, 0x4b, 0xfc, 0xac, 0xb0, 0xda, 0xeb, 0xcb, 0x7c, 0x98, 0x1b, 0x8e, 0x37, 0x61, 0xf6,
+	0xd1, 0x57, 0x62, 0xec, 0xd2, 0x0f, 0x71, 0xb0, 0x34, 0xfa, 0x1f, 0x10, 0xcc, 0x80, 0xff, 0x94,
+	0xb5, 0x52, 0xb9, 0x54, 0xc9, 0xde, 0x31, 0x2a, 0x7a, 0x56, 0xbf, 0x5b, 0x19, 0xdb, 0x70, 0xb0,
+	0x15, 0x9a, 0x5c, 0xb4, 0x9b, 0xf0, 0x06, 0x10, 0xc7, 0xf3, 0xf3, 0x6a, 0xb9, 0x54, 0x29, 0xe8,
+	0x46, 0x59, 0xd5, 0x0a, 0xa5, 0x3c, 0xcf, 0x09, 0xeb, 0xbd, 0xbe, 0xbc, 0x42, 0x21, 0x23, 0x4d,
+	0x05, 0xdf, 0x02, 0xff, 0x1d, 0x07, 0x57, 0x4b, 0x7a, 0xa1, 0x78, 0x2b, 0xc4, 0xc6, 0x85, 0xb5,
+	0x5e, 0x5f, 0x86, 0x14, 0x5b, 0x8d, 0x74, 0x00, 0xbc, 0x0c, 0xd6, 0xc6, 0xa1, 0xe5, 0x6c, 0xa5,
+	0xa2, 0xe6, 0xf9, 0x19, 0x81, 0xef, 0xf5, 0xe5, 0x14, 0xc5, 0x94, 0x4d, 0xcf, 0x43, 0x16, 0xbc,
+	0x0a, 0xd2, 0xe3, 0xd9, 0x9a, 0xfa, 0xae, 0xba, 0xa3, 0xab, 0x79, 0x7e, 0x56, 0x80, 0xbd, 0xbe,
+	0xbc, 0x44, 0xf3, 0x35, 0xf4, 0x3e, 0xaa, 0x13, 0x74, 0x2a, 0xff, 0xcd, 0x6c, 0xe1, 0x8e, 0x9a,
+	0xe7, 0xe7, 0xa2, 0xfc, 0x37, 0x4d, 0xbb, 0x89, 0x2c, 0x6a, 0x67, 0xae, 0x78, 0xf0, 0x5c, 0x8c,
+	0x3d, 0x7d, 0x2e, 0xc6, 0x3e, 0x39, 0x14, 0x63, 0x07, 0x87, 0x22, 0xf7, 0xe4, 0x50, 0xe4, 0x7e,
+	0x39, 0x14, 0xb9, 0xc7, 0x2f, 0xc4, 0xd8, 0x93, 0x17, 0x62, 0xec, 0xe9, 0x0b, 0x31, 0xf6, 0xe0,
+	0xef, 0x07, 0xe2, 0x7e, 0xf0, 0x43, 0x2b, 0xb8, 0xcf, 0xb5, 0xf9, 0x60, 0x86, 0xbc, 0xf6, 0x57,
+	0x00, 0x00, 0x00, 0xff, 0xff, 0x92, 0x64, 0xc1, 0x80, 0x83, 0x0d, 0x00, 0x00,
 }
 
 func (this *TextProposal) Equal(that interface{}) bool {
@@ -1110,9 +1111,9 @@ func (m *TallyParams) MarshalToSizedBuffer(dAtA []byte) (int, error) {
 	var l int
 	_ = l
 	{
-		size := m.Veto.Size()
+		size := m.VetoThreshold.Size()
 		i -= size
-		if _, err := m.Veto.MarshalTo(dAtA[i:]); err != nil {
+		if _, err := m.VetoThreshold.MarshalTo(dAtA[i:]); err != nil {
 			return 0, err
 		}
 		i = encodeVarintGov(dAtA, i, uint64(size))
@@ -1301,7 +1302,7 @@ func (m *TallyParams) Size() (n int) {
 	n += 1 + l + sovGov(uint64(l))
 	l = m.Threshold.Size()
 	n += 1 + l + sovGov(uint64(l))
-	l = m.Veto.Size()
+	l = m.VetoThreshold.Size()
 	n += 1 + l + sovGov(uint64(l))
 	return n
 }
@@ -2512,7 +2513,7 @@ func (m *TallyParams) Unmarshal(dAtA []byte) error {
 			iNdEx = postIndex
 		case 3:
 			if wireType != 2 {
-				return fmt.Errorf("proto: wrong wireType = %d for field Veto", wireType)
+				return fmt.Errorf("proto: wrong wireType = %d for field VetoThreshold", wireType)
 			}
 			var byteLen int
 			for shift := uint(0); ; shift += 7 {
@@ -2539,7 +2540,7 @@ func (m *TallyParams) Unmarshal(dAtA []byte) error {
 			if postIndex > l {
 				return io.ErrUnexpectedEOF
 			}
-			if err := m.Veto.Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
+			if err := m.VetoThreshold.Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
 				return err
 			}
 			iNdEx = postIndex
diff --git a/x/gov/types/params.go b/x/gov/types/params.go
index 5a9dfcc53e..5421136f39 100644
--- a/x/gov/types/params.go
+++ b/x/gov/types/params.go
@@ -20,7 +20,7 @@ var (
 	DefaultMinDepositTokens = sdk.TokensFromConsensusPower(10)
 	DefaultQuorum           = sdk.NewDecWithPrec(334, 3)
 	DefaultThreshold        = sdk.NewDecWithPrec(5, 1)
-	DefaultVeto             = sdk.NewDecWithPrec(334, 3)
+	DefaultVetoThreshold    = sdk.NewDecWithPrec(334, 3)
 )
 
 // Parameter store key
@@ -83,22 +83,22 @@ func validateDepositParams(i interface{}) error {
 }
 
 // NewTallyParams creates a new TallyParams object
-func NewTallyParams(quorum, threshold, veto sdk.Dec) TallyParams {
+func NewTallyParams(quorum, threshold, vetoThreshold sdk.Dec) TallyParams {
 	return TallyParams{
-		Quorum:    quorum,
-		Threshold: threshold,
-		Veto:      veto,
+		Quorum:        quorum,
+		Threshold:     threshold,
+		VetoThreshold: vetoThreshold,
 	}
 }
 
 // DefaultTallyParams default parameters for tallying
 func DefaultTallyParams() TallyParams {
-	return NewTallyParams(DefaultQuorum, DefaultThreshold, DefaultVeto)
+	return NewTallyParams(DefaultQuorum, DefaultThreshold, DefaultVetoThreshold)
 }
 
 // Equal checks equality of TallyParams
 func (tp TallyParams) Equal(other TallyParams) bool {
-	return tp.Quorum.Equal(other.Quorum) && tp.Threshold.Equal(other.Threshold) && tp.Veto.Equal(other.Veto)
+	return tp.Quorum.Equal(other.Quorum) && tp.Threshold.Equal(other.Threshold) && tp.VetoThreshold.Equal(other.VetoThreshold)
 }
 
 // String implements stringer insterface
@@ -125,10 +125,10 @@ func validateTallyParams(i interface{}) error {
 	if v.Threshold.GT(sdk.OneDec()) {
 		return fmt.Errorf("vote threshold too large: %s", v)
 	}
-	if !v.Veto.IsPositive() {
+	if !v.VetoThreshold.IsPositive() {
 		return fmt.Errorf("veto threshold must be positive: %s", v.Threshold)
 	}
-	if v.Veto.GT(sdk.OneDec()) {
+	if v.VetoThreshold.GT(sdk.OneDec()) {
 		return fmt.Errorf("veto threshold too large: %s", v)
 	}
 
diff --git a/x/gov/types/tx.pb.go b/x/gov/types/tx.pb.go
index 18df61e4ae..5c90c25f0d 100644
--- a/x/gov/types/tx.pb.go
+++ b/x/gov/types/tx.pb.go
@@ -68,7 +68,7 @@ func (m *MsgSubmitProposal) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_MsgSubmitProposal proto.InternalMessageInfo
 
-// MsgVote defines a message to cast a vote
+// MsgVote defines a message to cast a vote.
 type MsgVote struct {
 	ProposalId uint64                                        `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"proposal_id" yaml:"proposal_id"`
 	Voter      github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,2,opt,name=voter,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"voter,omitempty"`
@@ -107,7 +107,7 @@ func (m *MsgVote) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_MsgVote proto.InternalMessageInfo
 
-// MsgDeposit defines a message to submit a deposit to an existing proposal
+// MsgDeposit defines a message to submit a deposit to an existing proposal.
 type MsgDeposit struct {
 	ProposalId uint64                                        `protobuf:"varint,1,opt,name=proposal_id,json=proposalId,proto3" json:"proposal_id" yaml:"proposal_id"`
 	Depositor  github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,2,opt,name=depositor,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"depositor,omitempty"`
diff --git a/x/mint/types/mint.pb.go b/x/mint/types/mint.pb.go
index 1850887d74..2575c2f96f 100644
--- a/x/mint/types/mint.pb.go
+++ b/x/mint/types/mint.pb.go
@@ -65,7 +65,7 @@ func (m *Minter) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_Minter proto.InternalMessageInfo
 
-// mint parameters
+// Params holds parameters for the mint module.
 type Params struct {
 	// type of coin to mint
 	MintDenom string `protobuf:"bytes,1,opt,name=mint_denom,json=mintDenom,proto3" json:"mint_denom,omitempty"`
diff --git a/x/params/types/proposal/params.pb.go b/x/params/types/proposal/params.pb.go
index 5a4ea0274b..42c16d0085 100644
--- a/x/params/types/proposal/params.pb.go
+++ b/x/params/types/proposal/params.pb.go
@@ -23,8 +23,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// ParameterChangeProposal defines a proposal which contains multiple parameter
-// changes.
+// ParameterChangeProposal defines a proposal to change one or more parameters.
 type ParameterChangeProposal struct {
 	Title       string        `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
 	Description string        `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
@@ -63,7 +62,7 @@ func (m *ParameterChangeProposal) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_ParameterChangeProposal proto.InternalMessageInfo
 
-// ParamChange defines a parameter change.
+// ParamChange defines an individual parameter change, for use in ParameterChangeProposal.
 type ParamChange struct {
 	Subspace string `protobuf:"bytes,1,opt,name=subspace,proto3" json:"subspace,omitempty"`
 	Key      string `protobuf:"bytes,2,opt,name=key,proto3" json:"key,omitempty"`
diff --git a/x/slashing/types/slashing.pb.go b/x/slashing/types/slashing.pb.go
index 2ddc8ea0b1..b99db26f1c 100644
--- a/x/slashing/types/slashing.pb.go
+++ b/x/slashing/types/slashing.pb.go
@@ -30,7 +30,7 @@ var _ = time.Kitchen
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// ValidatorSigningInfo defines the signing info for a validator
+// ValidatorSigningInfo defines a validator's signing info for monitoring their liveness activity.
 type ValidatorSigningInfo struct {
 	Address github_com_cosmos_cosmos_sdk_types.ConsAddress `protobuf:"bytes,1,opt,name=address,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ConsAddress" json:"address,omitempty"`
 	// height at which validator was first a candidate OR was unjailed
@@ -119,7 +119,7 @@ func (m *ValidatorSigningInfo) GetMissedBlocksCounter() int64 {
 	return 0
 }
 
-// Params - used for initializing default parameter for slashing at genesis
+// Params represents the parameters used for by the slashing module.
 type Params struct {
 	SignedBlocksWindow      int64                                  `protobuf:"varint,1,opt,name=signed_blocks_window,json=signedBlocksWindow,proto3" json:"signed_blocks_window,omitempty" yaml:"signed_blocks_window"`
 	MinSignedPerWindow      github_com_cosmos_cosmos_sdk_types.Dec `protobuf:"bytes,2,opt,name=min_signed_per_window,json=minSignedPerWindow,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Dec" json:"min_signed_per_window" yaml:"min_signed_per_window"`
diff --git a/x/slashing/types/tx.pb.go b/x/slashing/types/tx.pb.go
index 8fa0772622..03db68cf3c 100644
--- a/x/slashing/types/tx.pb.go
+++ b/x/slashing/types/tx.pb.go
@@ -25,7 +25,9 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// MsgUnjail - struct for unjailing jailed validator
+// MsgUnjail is an sdk.Msg used for unjailing a jailed validator, thus returning
+// them into the bonded validator set, so they can begin receiving provisions
+// and rewards again.
 type MsgUnjail struct {
 	ValidatorAddr github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,1,opt,name=validator_addr,json=validatorAddr,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"address" yaml:"address"`
 }
diff --git a/x/staking/types/staking.pb.go b/x/staking/types/staking.pb.go
index 456cc2457b..c0c875fb74 100644
--- a/x/staking/types/staking.pb.go
+++ b/x/staking/types/staking.pb.go
@@ -38,8 +38,9 @@ var _ = time.Kitchen
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// HistoricalInfo contains the historical information that gets stored at
-// each height.
+// HistoricalInfo contains header and validator information for a given block. It is stored
+// as part of staking module's state, which persists the `n` most recent HistoricalInfo
+// (`n` is set by the staking module's `historical_entries` parameter).
 type HistoricalInfo struct {
 	Header types.Header `protobuf:"bytes,1,opt,name=header,proto3" json:"header"`
 	Valset []Validator  `protobuf:"bytes,2,rep,name=valset,proto3" json:"valset"`
@@ -132,7 +133,7 @@ func (m *CommissionRates) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_CommissionRates proto.InternalMessageInfo
 
-// Commission defines a commission parameters for a given validator.
+// Commission defines commission parameters for a given validator.
 type Commission struct {
 	CommissionRates `protobuf:"bytes,1,opt,name=commission_rates,json=commissionRates,proto3,embedded=commission_rates" json:"commission_rates"`
 	UpdateTime      time.Time `protobuf:"bytes,2,opt,name=update_time,json=updateTime,proto3,stdtime" json:"update_time" yaml:"update_time"`
@@ -253,8 +254,9 @@ func (m *Description) GetDetails() string {
 	return ""
 }
 
-// Validator defines the total amount of bond shares and their exchange rate to
-// coins. Slashing results in a decrease in the exchange rate, allowing correct
+// Validator defines a validator, together with the total amount of the Validator's
+// bond shares and their exchange rate to coins.
+// Slashing results in a decrease in the exchange rate, allowing correct
 // calculation of future undelegations without iterating over delegators.
 // When coins are delegated to this validator, the validator is credited with a
 // delegation whose number of bond shares is based on the amount of coins
@@ -613,7 +615,7 @@ func (m *Delegation) GetValidatorAddress() github_com_cosmos_cosmos_sdk_types.Va
 }
 
 // UnbondingDelegation stores all of a single delegator's unbonding bonds
-// for a single validator in an time-ordered list
+// for a single validator in an time-ordered list.
 type UnbondingDelegation struct {
 	DelegatorAddress github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=delegator_address,json=delegatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"delegator_address,omitempty" yaml:"delegator_address"`
 	ValidatorAddress github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,2,opt,name=validator_address,json=validatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"validator_address,omitempty" yaml:"validator_address"`
@@ -1082,7 +1084,7 @@ func (m *RedelegationResponse) GetEntries() []RedelegationEntryResponse {
 	return nil
 }
 
-// Pool - tracking bonded and not-bonded token supply of the bond denomination
+// Pool is used for tracking bonded and not-bonded token supply of the bond denomination.
 type Pool struct {
 	NotBondedTokens github_com_cosmos_cosmos_sdk_types.Int `protobuf:"bytes,1,opt,name=not_bonded_tokens,json=notBondedTokens,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Int" json:"not_bonded_tokens"`
 	BondedTokens    github_com_cosmos_cosmos_sdk_types.Int `protobuf:"bytes,2,opt,name=bonded_tokens,json=bondedTokens,proto3,customtype=github.com/cosmos/cosmos-sdk/types.Int" json:"bonded_tokens" yaml:"bonded_tokens"`
diff --git a/x/staking/types/tx.pb.go b/x/staking/types/tx.pb.go
index ef43b4ba2d..9e53ec2f7c 100644
--- a/x/staking/types/tx.pb.go
+++ b/x/staking/types/tx.pb.go
@@ -172,8 +172,8 @@ func (m *MsgEditValidator) GetValidatorAddress() github_com_cosmos_cosmos_sdk_ty
 	return nil
 }
 
-// MsgDelegate defines an SDK message for performing a delegation from a
-// delegate to a validator.
+// MsgDelegate defines an SDK message for performing a delegation of coins
+// from a delegator to a validator.
 type MsgDelegate struct {
 	DelegatorAddress github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=delegator_address,json=delegatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"delegator_address,omitempty" yaml:"delegator_address"`
 	ValidatorAddress github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,2,opt,name=validator_address,json=validatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"validator_address,omitempty" yaml:"validator_address"`
@@ -234,8 +234,8 @@ func (m *MsgDelegate) GetAmount() types.Coin {
 	return types.Coin{}
 }
 
-// MsgBeginRedelegate defines an SDK message for performing a redelegation from
-// a delegate and source validator to a destination validator.
+// MsgBeginRedelegate defines an SDK message for performing a redelegation
+// of coins from a delegator and source validator to a destination validator.
 type MsgBeginRedelegate struct {
 	DelegatorAddress    github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=delegator_address,json=delegatorAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"delegator_address,omitempty" yaml:"delegator_address"`
 	ValidatorSrcAddress github_com_cosmos_cosmos_sdk_types.ValAddress `protobuf:"bytes,2,opt,name=validator_src_address,json=validatorSrcAddress,proto3,casttype=github.com/cosmos/cosmos-sdk/types.ValAddress" json:"validator_src_address,omitempty" yaml:"validator_src_address"`
diff --git a/x/upgrade/types/upgrade.pb.go b/x/upgrade/types/upgrade.pb.go
index 20092a97cd..ce9d9d3b83 100644
--- a/x/upgrade/types/upgrade.pb.go
+++ b/x/upgrade/types/upgrade.pb.go
@@ -27,7 +27,7 @@ var _ = time.Kitchen
 // proto package needs to be updated.
 const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package
 
-// Plan specifies information about a planned upgrade and when it should occur
+// Plan specifies information about a planned upgrade and when it should occur.
 type Plan struct {
 	// Sets the name for the upgrade. This name will be used by the upgraded version of the software to apply any
 	// special "on-upgrade" commands during the first BeginBlock method after the upgrade is applied. It is also used
@@ -78,7 +78,7 @@ func (m *Plan) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_Plan proto.InternalMessageInfo
 
-// SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade
+// SoftwareUpgradeProposal is a gov Content type for initiating a software upgrade.
 type SoftwareUpgradeProposal struct {
 	Title       string `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
 	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
@@ -117,7 +117,7 @@ func (m *SoftwareUpgradeProposal) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_SoftwareUpgradeProposal proto.InternalMessageInfo
 
-// CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade
+// CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software upgrade.
 type CancelSoftwareUpgradeProposal struct {
 	Title       string `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
 	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`