History

mergify[bot] 8b70c6caf7 refactor: remove viper as a direct dependency (backport #21635 ) (#21672 ) Co-authored-by: Matt Kocubinski <mkocubinski@gmail.com> Co-authored-by: Julien Robert <julien@rbrt.fr>		2024-09-12 08:41:25 +00:00
..
exported	refactor(x/consensus): audit QA v0.52 (backport #21416 ) (#21419 )	2024-08-27 11:55:54 +00:00
keeper	fix: remove stray fmt.Println (backport #21661 ) (#21664 )	2024-09-11 22:13:59 +02:00
proto	refactor: remove consensus as a imported type in modules (backport #21480 ) (#21638 )	2024-09-10 19:10:37 +02:00
types	refactor: remove consensus as a imported type in modules (backport #21480 ) (#21638 )	2024-09-10 19:10:37 +02:00
autocli.go	refactor(cli): Standardize `Use` field convention and update readme (backport #21369 ) (#21376 )	2024-08-23 20:08:16 +00:00
CHANGELOG.md	refactor(x/consensus): audit QA (backport #21151 ) (#21240 )	2024-08-09 18:34:55 +00:00
depinject.go	feat: unify version modifier for v2 (backport #21508 ) (#21578 )	2024-09-06 18:57:40 +00:00
go.mod	refactor: remove viper as a direct dependency (backport #21635 ) (#21672 )	2024-09-12 08:41:25 +00:00
go.sum	refactor: remove viper as a direct dependency (backport #21635 ) (#21672 )	2024-09-12 08:41:25 +00:00
module.go	refactor(core): move amino registrar and drop legacy package (backport #21531 ) (#21561 )	2024-09-05 13:04:00 +00:00
README.md	refactor(x/consensus): audit QA v0.52 (backport #21416 ) (#21419 )	2024-08-27 11:55:54 +00:00
sonar-project.properties	chore: force reload sonar cloud (#20480 )	2024-05-29 11:12:09 +00:00

README.md

sidebar_position
1

`x/consensus`

Abstract

Functionality to modify CometBFT's ABCI consensus params.

State
Params
Keepers
Messages
Consensus Messages
Events
- Message Events

State

The x/consensus module keeps state of the consensus params from cometbft.:

Params

The consensus module stores it's params in state with the prefix of 0x05, it can be updated with governance or the address with authority.

Params: 0x05 | ProtocolBuffer(cometbft.ConsensusParams)

https://github.com/cosmos/cosmos-sdk/blob/release/v0.52.x/x/consensus/proto/cosmos/consensus/v1/consensus.proto#L9-L15

Keepers

The consensus module provides methods to Set and Get consensus params. It is recommended to use the x/consensus module keeper to get consensus params instead of accessing them through the context.

Messages

UpdateParams

Update consensus params.

https://github.com/cosmos/cosmos-sdk/blob/release/v0.52.x/x/consensus/proto/cosmos/consensus/v1/tx.proto#L23-L44

The message will fail under the following conditions:

The signer is not the set authority
Not all values are set

Events

The consensus module emits the following events:

Message Events

MsgUpdateParams

Type	Attribute Key	Attribute Value
string	authority	msg.Signer
string	parameters	consensus Parameters