Skip to main content
Lumera Protocol runs three execution environments side by side. Native Cosmos SDK modules power Cascade and staking. CosmWasm runs Rust smart contracts. The v1.20.0 Aurora Convergence upgrade added a full EVM that runs Solidity and Vyper contracts. The EVM is live on testnet (lumera-testnet-2). Mainnet still runs v1.12.0 and gains EVM support with its upgrade, so build and test against testnet for now. This page gives you the complete picture of the EVM support. The rest of this section shows each piece in practice, from wallet setup to precompile calls. Three execution environments on one chain

​
What the EVM support includes

Lumera integrates Cosmos EVM v0.6.0 directly into the chain. It is not a sidechain or a bridge. On EVM enabled networks it includes the following.
  • Ethereum JSON-RPC and WebSocket endpoints, enabled by default on every upgraded node
  • An EVM indexer and transaction tracing
  • OpenRPC discovery through rpc_discover or the /openrpc.json path on the API server
  • An EIP-1559 fee market with dynamic base fees
  • Phase 1 of a bidirectional CosmWasm to EVM bridge
Standard toolchains work without changes. Hardhat, Foundry, Remix, Ethers, viem, and MetaMask all target Lumera over JSON-RPC.

​
Accounts

Lumera uses Ethereum style key derivation (eth_secp256k1, BIP44 coin type 60). One account has two representations of the same key. Both point to the same funds and the same state. Accounts created before a network’s v1.20.0 upgrade need a one time migration. See the EVM upgrade page.

​
Token precision

The native token keeps its 6 decimal base denom ulume. The EVM side exposes an 18 decimal denom called alume, where 1 ulume equals 10^12 alume. The x/precisebank module bridges the two without creating a second supply. Balances always reconcile between Cosmos and EVM views.

​
Precompiles

Precompiles are contracts at fixed addresses that expose native chain features to Solidity. Lumera ships the standard Cosmos EVM set plus three custom precompiles for its own modules. The standard set covers bank, staking, distribution, governance, slashing, ICS20 transfers, Bech32 conversion, and P256 verification. Full details live in the precompiles overview.
New to the EVM side? Start by connecting MetaMask, then deploy your first contract with Remix. When you are ready to script against the node, explore the full method catalog in the OpenRPC playground.

​
Where to build first

Cascade storage is the core product of the chain. If your app needs permanent storage, start with the Cascade section and the SDKs. Reach for the EVM when you need Solidity contracts, MetaMask users, or existing Ethereum tooling. The Action precompile lets a contract drive Cascade directly.

​
Next steps

Connect MetaMask

Add the Lumera EVM network to MetaMask and verify the endpoint.

Deploy with Remix

Compile and deploy a Solidity contract from the browser.

Precompiles

Call native Lumera modules from Solidity at fixed addresses.