package poa.v1

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc UpdateAuthoritySet (MsgUpdateAuthoritySet, MsgUpdateAuthoritySetResponse)

  tx.proto:11

  message MsgUpdateAuthoritySet

  tx.proto:17

  MsgUpdateAuthoritySet replaces the authority allowlist. Only callable by the chain's gov authority.

  • string authority = 1

  • repeated string validators = 2

    bech32 sdk.ValAddress strings

  message MsgUpdateAuthoritySetResponse

  tx.proto:24

  (message has no fields)

• rpc UpdateParams (MsgUpdateParams, MsgUpdateParamsResponse)

  tx.proto:12

  message MsgUpdateParams

  tx.proto:27

  MsgUpdateParams replaces the module params. Only callable by gov.

  • string authority = 1

  • optional Params params = 2

  message MsgUpdateParamsResponse

  tx.proto:34

  (message has no fields)

• rpc AuthoritySet (QueryAuthoritySetRequest, QueryAuthoritySetResponse)

  query.proto:14

  message QueryAuthoritySetRequest

  query.proto:33

  (message has no fields)

  message QueryAuthoritySetResponse

  query.proto:34

  • repeated string validators = 1

• rpc EffectivePower (QueryEffectivePowerRequest, QueryEffectivePowerResponse)

  query.proto:17

  message QueryEffectivePowerRequest

  query.proto:38

  • string operator_address = 1

  message QueryEffectivePowerResponse

  query.proto:41

  • int64 power = 1

  • bool is_authority = 2

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:11

  message QueryParamsRequest

  query.proto:28

  (message has no fields)

  message QueryParamsResponse

  query.proto:29

  • optional Params params = 1

• rpc SafeMode (QuerySafeModeRequest, QuerySafeModeResponse)

  query.proto:23

  SafeMode reports whether the chain is in authority-empty safe mode, in which case the value-bearing modules (gravity, cork, axelarcork) are frozen. This is the primary operational health check for the module.

  message QuerySafeModeRequest

  query.proto:46

  (message has no fields)

  message QuerySafeModeResponse

  query.proto:47

  • bool active = 1

    active is true while value-bearing modules are frozen.

  • int64 thaw_height = 2

    thaw_height is the height at or after which the freeze lifts, once the authority set is healthy again. Zero when no thaw is scheduled (either not in safe mode, or in safe mode with the authority set still empty).

  • uint64 bonded_authority_count = 3

    bonded_authority_count is how many allowlisted validators are currently bonded and unjailed. Zero is what puts (and keeps) the chain in safe mode.

AuthoritySetWrapper is the on-disk representation written under AuthoritySetKey.

• repeated AuthorityValidator validators = 1

AuthorityValidator identifies a validator in the binary-specified PoA authority allowlist by operator (bech32 ValAddress) address.

Used in: AuthoritySetWrapper, GenesisState

• string operator_address = 1

• optional Params params = 1

• repeated AuthorityValidator authority_set = 2

• int64 activation_height = 3

  activation_height is the height at which PoA boosting first took effect. Exported so a genesis restart does not reset it: rawSlashPower treats infraction heights BELOW activation as un-boosted and slashes them verbatim, so a reset activation height would let a post-activation infraction be slashed on boosted power. Zero means "not yet active", and InitGenesis will stamp the current height.

• int64 activation_time = 4

  activation_time is the block time (unix nanos) observed at activation_height. Paired with activation_height it gives the measured average block time that drives multiplier-snapshot retention.

• bool safe_mode = 5

  safe_mode carries the authority-empty freeze across an export/import so a restart cannot silently unfreeze the value-bearing modules for the blocks before the first EndBlocker re-derives it.

• int64 safe_mode_thaw_height = 6

  safe_mode_thaw_height is the pending thaw height, if one is scheduled.

• repeated MultiplierSnapshot multiplier_snapshots = 7

  multiplier_snapshots are the retained per-height boost snapshots. Dropping them across a restart would make every in-flight authority slash either be refused or (worse, if activation_height also reset) applied to boosted power.

MultiplierEntry records the per-block boost multiplier applied to a single authority validator. Multiplier is an sdk.Dec string.

Used in: MultiplierSnapshot

• string operator_address = 1

• string multiplier = 2

MultiplierSnapshot records the boosts applied at a given block height, used at slash time to normalise consensus power back to raw stake.

Used in: GenesisState

• int64 height = 1

• repeated MultiplierEntry entries = 2

Params defines configuration for the PoA power-floor module.

Used in: GenesisState, MsgUpdateParams, QueryParamsResponse

• string floor_fraction = 1

  Minimum aggregate share of consensus voting power that must be held by bonded, unjailed authority validators. Encoded as an sdk.Dec string.

• bool enabled = 2

  Feature flag. When false, the PoA EndBlocker is a no-op.

• bool halt_when_authority_empty = 3

  When true, the EndBlocker panics if no bonded, unjailed authority validator exists. This is the correct PoA failure mode.