lumera-testnet-2 runs v1.20.1). Mainnet still runs v1.12.0, so the mainnet upgrade is ahead. This page explains what changed and what users and operators need to do when their network upgrades.
What changed
- Cosmos EVM v0.6.0 runs Solidity contracts natively alongside Cosmos SDK modules and CosmWasm
- New modules
x/vm,x/feemarket,x/precisebank,x/erc20, andx/evmigration - Key derivation moved from
secp256k1(coin type 118) toeth_secp256k1(coin type 60) - An 18 decimal EVM denom
alumebridges to the native 6 decimalulume - Ethereum JSON-RPC, WebSocket, indexer, tracing, and OpenRPC discovery are on by default
- An EIP-1559 fee market and EVM precompiles for native modules, including Action and SuperNode
Release timeline
Testnet runs the v1.20 line today. Mainnet remains on
v1.12.0 until its upgrade passes governance, so mainnet accounts and operators do not need to act yet.
Why accounts migrate
The chain switched its key type at the upgrade. The same mnemonic now derives a different Lumera address, because the BIP44 path changed from coin type 118 to coin type 60. Thex/evmigration module moves everything held by your legacy address to your new address in one atomic transaction. The transaction is free of fees. It carries two proofs, an ADR-036 signature from the legacy key and an EIP-191 signature from the new key.
After migration one account works in both wallet worlds. Keplr shows the bech32 form (lumera1...) and MetaMask shows the hex form (0x...). Both point to the same funds. Keplr needs the coin type 60 chain profile and a re-import first.
Who needs to do what
Each audience has a canonical guide in the lumera repo. The guides below are maintained with the chain code, so follow them rather than copies.Notes for validators
Validators migrate withMsgMigrateValidator, not MsgClaimLegacyAccount. The chain rejects the plain claim message for validator operator addresses. The migration re-keys delegations, distribution state, and any bound SuperNode in one transaction. Your consensus key in priv_validator_key.json is not affected. Only the operator key changes.
Notes for SuperNode operators
Two paths reach the same end state. Path A setsevm_key_name in config.yml and lets the daemon migrate the account on restart. Path B migrates first through the Portal or the scripts, after which the daemon detects the on-chain record and cleans up locally. Multisig operators must use the offline lumerad CLI flow, because the daemon does not drive multi party signing ceremonies.
Notes for relayer operators
Hermes must re-derive the same key from your mnemonic. Its default derivation does not match the new path, so set theethermint address type with the ethsecp256k1 proto type in the Hermes config and pass --hd-path "m/44'/60'/0'/0/0" when adding the key. The relayer guide covers the full stop, migrate, re-key, and restart sequence.
Next steps
Smart contracts
What you can build now that the EVM is live.
Validator operations
Day to day validator management on the current release.
SuperNode operations
Run and monitor your SuperNode daemon.