Messages
Both messages are authority-gated (the governance module account) and are expected to be executed via governance proposals.
MsgUpdateParams
message MsgUpdateParams {
string authority = 1; // must equal the module authority (gov)
Params params = 2; // full replacement — all fields must be supplied
}
Handler behaviour:
- Rejects a non-authority signer.
- Validates the new params (ratio bounds, non-empty epoch identifier, non-negative reward).
- Rejects any change to
service_pool_denom— the denom is immutable after genesis (see State). Same-denom updates of the other fields are accepted.
MsgFundFromPool
message MsgFundFromPool {
string authority = 1; // must equal the module authority (gov)
repeated Payout payouts = 2; // batch of {address, coins}
}
message Payout {
string address = 1;
repeated cosmos.base.v1beta1.Coin coins = 2;
}
Batch spend from the pool's available balance. Handler behaviour:
- Rejects a non-authority signer and empty payout batches.
- Rejects any payout coin whose denom is not
service_pool_denom— the earmark guard below is only sound in the single denom the pool accounts for. - Earmark guard: the summed total may only draw from
moduleBalance − AccruedFees. Accrued fees are earmarked for the epoch split (and, via the distribute slice, for delegators) and can never be spent by governance. - Sends to each recipient via
SendCoinsFromModuleToAccountand emitsEventFundFromPool.