cosmos-sdk/x
Sishir Giri b65f3fe070
feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603)
## Description
Most modules right now have a no-op for AppModule.BeginBlock and AppModule.EndBlock. We should move these methods off the AppModule interface so we have less deadcode, and instead move them to extension interfaces. 

1. I added `BeginBlockAppModule` and `EndBlockAppModule` interface.
2. Remove the dead-code from modules that do no implement them
3. Add type casting in the the module code to use the new interface

Closes: #12462



---

### Author Checklist

*All items are required. Please add a note to the item if the item is not applicable and
please add links to any relevant follow up issues.*

I have...

- [ ] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [ ] added `!` to the type prefix if API or client breaking change
- [ ] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/main/CONTRIBUTING.md#pr-targeting))
- [ ] provided a link to the relevant issue or specification
- [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/main/docs/building-modules)
- [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/main/CONTRIBUTING.md#testing)
- [ ] added a changelog entry to `CHANGELOG.md`
- [ ] included comments for [documenting Go code](https://blog.golang.org/godoc)
- [ ] updated the relevant documentation or specification
- [ ] reviewed "Files changed" and left comments if necessary
- [ ] confirmed all CI checks have passed

### Reviewers Checklist

*All items are required. Please add a note if the item is not applicable and please add
your handle next to the items reviewed if you only reviewed selected items.*

I have...

- [ ] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [ ] confirmed `!` in the type prefix if API or client breaking change
- [ ] confirmed all author checklist items have been addressed 
- [ ] reviewed state machine logic
- [ ] reviewed API design and naming
- [ ] reviewed documentation is accurate
- [ ] reviewed tests and test coverage
- [ ] manually tested (if applicable)
2022-07-19 17:19:23 +00:00
..
auth feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
authz feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
bank feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
capability feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
crisis feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
distribution feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
epoching docs: updates outdated docs (#12014) 2022-05-31 08:59:38 -04:00
evidence feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
feegrant feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
genutil refactor: rename depinject imports to cosmossdk.io/depinject (#12479) 2022-07-09 17:46:07 +02:00
gov feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
group feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
mint feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
nft feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
params feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
simulation fix: Simulation is not deterministic due to GenSignedMockTx (#12374) 2022-06-30 11:12:25 -04:00
slashing feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
staking fix: panic string in staking/val_state_change.go::UnbondingToUnbonded (#12566) 2022-07-13 20:11:38 +00:00
upgrade feat: Move AppModule.BeginBlock and AppModule.EndBlock to extension interfaces (#12603) 2022-07-19 17:19:23 +00:00
README.md docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00

List of Modules

Here are some production-grade modules that can be used in Cosmos SDK applications, along with their respective documentation:

  • Auth - Authentication of accounts and transactions for Cosmos SDK applications.
  • Authz - Authorization for accounts to perform actions on behalf of other accounts.
  • Bank - Token transfer functionalities.
  • Capability - Object capability implementation.
  • Crisis - Halting the blockchain under certain circumstances (e.g. if an invariant is broken).
  • Distribution - Fee distribution, and staking token provision distribution.
  • Epoching - Allows modules to queue messages for execution at a certain block height.
  • Evidence - Evidence handling for double signing, misbehaviour, etc.
  • Feegrant - Grant fee allowances for executing transactions.
  • Governance - On-chain proposals and voting.
  • Mint - Creation of new units of staking token.
  • Params - Globally available parameter store.
  • Slashing - Validator punishment mechanisms.
  • Staking - Proof-of-Stake layer for public blockchains.
  • Upgrade - Software upgrades handling and coordination.

To learn more about the process of building modules, visit the building modules reference documentation.

IBC

The IBC module for the SDK has moved to its own repository.