Skip to main content

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 SendCoinsFromModuleToAccount and emits EventFundFromPool.