feat(precompiles)!: added ics02 client router precompile (#768)

* feat: added ICS02 interface

* style: rename

* imp: added abi

* imp: add interface

* imp: added precompile boilerplate

* feat: added tx.go

* imp: added query

* imp: use new abi

* fix

* imp: update default precompiles

* imp: wire

* docs: updated changelog

* lint

* test: boilerplate

* fix: added missing adress

* fix: wrong address

* test: first test passing

* test: bad case

* feat: update client tested and working

* lint: golanci-lint

* test: verify membership

* test: verify non-membership

* lint

* style: self review items

* test: fix

* chore: fix attempt

* imp: change addr to 0x...807 instead of 0x...808

* imp: update required gas

* docs: added README

* imp: removed unused constants

* test: added update_client misbehavior

* test: added more update_client error cases

* test: added more failure cases to get_client_state

* test: added invalid header test

* test: add failure cases for verify membership

* test: added more failure cases to non-membership

* imp: removed noop

* imp: removed bankKeeper

* lint

* docs: added migration docs

* docs: alex review items

* docs: removed noop

---------

Co-authored-by: Alex | Cosmos Labs <[email protected]>
Co-authored-by: Vlad J <[email protected]>

Author: 3 people

CHANGELOG.md

@@ -10,6 +10,8 @@
 
 ### FEATURES
 
+- [\#768](https://github.com/cosmos/evm/pull/768) Added ICS-02 Client Router precompile
+
 ### BUG FIXES
 
 - [\#748](https://github.com/cosmos/evm/pull/748) Fix DynamicFeeChecker in Cosmos ante handler to respect NoBaseFee feemarkets' parameter.

docs/migrations/v0.5.0_to_v0.6.0.md

@@ -0,0 +1,55 @@
+# Cosmos EVM v0.5.0 → v0.6.0 Migration
+
+## 0) Prep
+
+- Create a branch: `git switch -c upgrade/evm-v0.6`.
+- Ensure a clean build + tests green pre-upgrade.
+- Snapshot your current params/genesis for comparison later.
+
+---
+
+## 1) Dependency bumps (go.mod)
+
+- Bump `github.com/cosmos/evm` to v0.6.0 and run:
+
+```bash
+go mod tidy
+```
+
+---
+
+<!-- TODO: Other changes required for the upgrade -->
+
+## 3) App wiring in `app.go`
+
+### Default Precompiles
+
+We added a new default precompile, ICS-02 Client Router. As such, the function signature for `DefaultStaticPrecompiles` has changed to accept a `clientKeeper` parameter.
+
+```diff
+	app.EVMKeeper = evmkeeper.NewKeeper(
+		appCodec, keys[evmtypes.StoreKey], tkeys[evmtypes.TransientKey], keys,
+		authtypes.NewModuleAddress(govtypes.ModuleName),
+		app.AccountKeeper,
+		app.PreciseBankKeeper,
+		app.StakingKeeper,
+		app.FeeMarketKeeper,
+		&app.ConsensusParamsKeeper,
+		&app.Erc20Keeper,
+		evmChainID,
+		tracer,
+	).WithStaticPrecompiles(
+		precompiletypes.DefaultStaticPrecompiles(
+			*app.StakingKeeper,
+			app.DistrKeeper,
+			app.PreciseBankKeeper,
+			&app.Erc20Keeper,
+			&app.TransferKeeper,
+			app.IBCKeeper.ChannelKeeper,
++			app.IBCKeeper.ClientKeeper,
+			app.GovKeeper,
+			app.SlashingKeeper,
+			appCodec,
+		),
+	)
+```

evmd/app.go

@@ -464,6 +464,7 @@ func NewExampleApp(
 			&app.Erc20Keeper,
 			&app.TransferKeeper,
 			app.IBCKeeper.ChannelKeeper,
+			app.IBCKeeper.ClientKeeper,
 			app.GovKeeper,
 			app.SlashingKeeper,
 			appCodec,