Applies to: Lumera chain post-EVM upgrade (x/evmigration enabled, Cosmos EVM v0.6.0)
This space holds the operator- and end-user-facing documentation for living on the EVM-enabled Lumera chain. Architecture, internals, and audit material live in the parent EVM Integration documentation; this set is the "what do I do, and in what order" layer.
| You are… | Start here | Then |
|---|---|---|
| An end user with a legacy (coin-type 118) account | EVM Migration User Guide | EVM Migration Helper Scripts Guide if you have many accounts to batch |
| A validator operator | Validator Operator EVM Migration Guide | EVM Migration Helper Scripts Guide for the migrate-validator.sh wrapper |
| A supernode operator | Supernode Operator EVM Migration Guide | EVM Migration User Guide for chain-level mechanics |
| A Hermes IBC relayer operator | Hermes IBC Relayer EVM Migration Guide | EVM Migration Helper Scripts Guide for the migrate-account.sh wrapper |
| A node operator (full node, sentry, public RPC) | Node Operator EVM Config Guide | EVM Parameter Tuning Guide for parameter sizing |
| A MetaMask user or public-RPC operator | MetaMask Configuration | Node Operator EVM Config Guide for node-side JSON-RPC settings |
| A governance participant or chain steward | EVM Parameter Tuning Guide | Node Operator EVM Config Guide for what each knob controls |
The canonical migration walkthrough for end users. Covers the three supported paths (Portal + Keplr wizard, shell scripts, raw lumerad CLI), the four post-migration follow-up states on the Claim page, the Keplr re-import dance, and a full multisig section with the offline four-step proof ceremony (generate-proof-payload → sign-proof → combine-proof → submit-proof). Includes the FAQ that most operators end up needing.
scripts/migrate-*.shReference for the bundled scripts/migrate-account.sh, scripts/migrate-validator.sh, and scripts/migrate-multisig.sh. These layer pre-flight estimates, destination-freshness checks, post-migration verification, structured exit codes, and an optional same-mnemonic file flow on top of the raw CLI commands. Use when migrating in bulk, scripting CI, or when you want safety rails the raw CLI doesn't provide.
MsgMigrateValidatorThe validator-specific procedure: maintenance window planning against downtime_jail_duration (1 hour on mainnet), the max_validator_delegations cap (default 2500), the unjail recovery flow if pre-flight reports the validator is jailed or unbonded, and the consensus-key safety guarantee (priv_validator_key.json is not affected — only the operator key changes from secp256k1 to eth_secp256k1). Includes the multisig validator operator path.
Two paths to the same end state: Path A (the daemon migrates for you on restart once evm_key_name is set in config.yml) or Path B (you migrate via Portal/Keplr or the shell helpers first, then the daemon detects the on-chain record and just performs local cleanup). Covers the multisig refusal behavior — the daemon won't drive a K-of-N ceremony and points you to the offline lumerad CLI flow — plus troubleshooting for address-mismatch and proto-skew errors.
Migrating a Hermes relayer's Lumera signing account from legacy secp256k1 to eth_secp256k1. The relayer is the one account where a second tool (Hermes) must re-derive the same key from the mnemonic, so the guide centers on the HD-path gotcha: Hermes' default ethermint derivation does not match lumerad's m/44'/60'/0'/0/0, so you must pin --hd-path "m/44'/60'/0'/0/0" and set the address_type block in config.toml. Includes a mandatory derived-address gate before the irreversible migration, and the stop → migrate → re-key → restart sequence.
app.toml referenceEvery EVM-relevant app.toml section explained: [evm], [evm.mempool], [json-rpc], [lumera.json-rpc-ratelimit], [lumera.evm-mempool]. Documents the chain-id namespace policy (mainnet rejects debug, personal, admin), the v1.20.0+ automatic config migration helper that fills in missing sections on first start, deployment-pattern checklists for validator / public-RPC / archive nodes, and the Prometheus metrics endpoints (127.0.0.1:6065 for RPC, 127.0.0.1:8100 for the geth engine).
End-user and operator guide for connecting MetaMask to Lumera EVM networks. A full screenshot walkthrough of connecting the Lumera Portal to MetaMask (the eth_chainId → wallet_switchEthereumChain → wallet_addEthereumChain → eth_requestAccounts handshake, the 0x…/lumera1… address mapping, importing a migrated EVM account, and verifying on the EVM Migration page), plus the crucial Keplr-vs-MetaMask endpoint distinction (MetaMask speaks EVM JSON-RPC on a separate port/URL — Cosmos LCD/CometBFT will never answer eth_chainId), manual network setup as a fallback, validator-local EVM ports, HTTPS / path-based / WSS reverse-proxy setup, and eth_chainId troubleshooting.