feat: add core and api for PreBlock (#17468)

core/CHANGELOG.md

@@ -36,6 +36,8 @@ Ref: https://keepachangelog.com/en/1.0.0/
 
 ## [Unreleased]
 
+* [#17468](https://github.com/cosmos/cosmos-sdk/pull/17468) Add `appmodule.HasPreBlocker` interface.
+
 ## [v0.10.0](https://github.com/cosmos/cosmos-sdk/releases/tag/core%2Fv0.10.0)
 
 * [#17383](https://github.com/cosmos/cosmos-sdk/pull/17383) Add `appmoduke.UpgradeModule` interface.

core/appmodule/module.go

@@ -52,6 +52,22 @@ type HasPrecommit interface {
 	Precommit(context.Context) error
 }
 
+// ResponsePreBlock represents the response from the PreBlock method.
+// It can modify consensus parameters in storage and signal the caller through the return value.
+// When it returns ConsensusParamsChanged=true, the caller must refresh the consensus parameter in the finalize context.
+// The new context (ctx) must be passed to all the other lifecycle methods.
+type ResponsePreBlock interface {
+	IsConsensusParamsChanged() bool
+}
+
+// HasPreBlocker is the extension interface that modules should implement to run
+// custom logic before BeginBlock.
+type HasPreBlocker interface {
+	AppModule
+	// PreBlock is method that will be run before BeginBlock.
+	PreBlock(context.Context) (ResponsePreBlock, error)
+}
+
 // HasBeginBlocker is the extension interface that modules should implement to run
 // custom logic before transaction processing in a block.
 type HasBeginBlocker interface {

proto/cosmos/app/runtime/v1alpha1/module.proto

@@ -52,6 +52,11 @@ message Module {
   // to call in the order in which they should be called. If this is left empty
   // no preparecheckstate function will be registered.
   repeated string prepare_check_staters = 9;
+
+  // pre_blockers specifies the module names of pre blockers
+  // to call in the order in which they should be called. If this is left empty
+  // no pre blocker will be registered.
+  repeated string pre_blockers = 10;
 }
 
 // StoreKeyConfig may be supplied to override the default module store key, which