> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart contracts on Lumera

> Deploy Solidity contracts on Lumera with standard Ethereum tooling and reach native modules through precompiles.

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.

<img className="block dark:hidden mx-auto" src="https://mintcdn.com/lumeraprotocol/izWPZ7kcPzv32-z6/images/diagrams/execution-environments-light.svg?fit=max&auto=format&n=izWPZ7kcPzv32-z6&q=85&s=37789ccfe334b868cda4c6887de5f863" alt="Three execution environments on one chain" width="760" height="300" data-path="images/diagrams/execution-environments-light.svg" />

<img className="hidden dark:block mx-auto" src="https://mintcdn.com/lumeraprotocol/izWPZ7kcPzv32-z6/images/diagrams/execution-environments-dark.svg?fit=max&auto=format&n=izWPZ7kcPzv32-z6&q=85&s=ad8d9ece7fa5df5db3a1b0f584709314" alt="Three execution environments on one chain" width="760" height="300" data-path="images/diagrams/execution-environments-dark.svg" />

## 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.

| Representation   | Format       | Used by                                  |
| ---------------- | ------------ | ---------------------------------------- |
| Cosmos address   | `lumera1...` | Keplr, Leap, `lumerad`, Cosmos endpoints |
| Ethereum address | `0x...`      | MetaMask, EVM tooling, JSON-RPC          |

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](/upgrades/evm-upgrade).

## 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.

| Precompile | Address  | What it exposes                                             |
| ---------- | -------- | ----------------------------------------------------------- |
| Action     | `0x0901` | Register and query Cascade and Sense actions from contracts |
| SuperNode  | `0x0902` | SuperNode registration state and queries                    |
| Wasm       | `0x0903` | Call CosmWasm contracts from the EVM                        |

The standard set covers bank, staking, distribution, governance, slashing, ICS20 transfers, Bech32 conversion, and P256 verification. Full details live in the [precompiles overview](/smart-contracts/precompiles/overview).

<Note>
  New to the EVM side? Start by [connecting MetaMask](/smart-contracts/connect-metamask), then [deploy your first contract with Remix](/smart-contracts/deploy-with-remix). When you are ready to script against the node, explore the full method catalog in the [OpenRPC playground](/smart-contracts/openrpc-playground).
</Note>

## Where to build first

Cascade storage is the core product of the chain. If your app needs permanent storage, start with the [Cascade section](/cascade/how-cascade-works) and the SDKs. Reach for the EVM when you need Solidity contracts, MetaMask users, or existing Ethereum tooling. The [Action precompile](/smart-contracts/precompiles/action) lets a contract drive Cascade directly.

## Next steps

<CardGroup cols={2}>
  <Card title="Connect MetaMask" icon="wallet" href="/smart-contracts/connect-metamask">
    Add the Lumera EVM network to MetaMask and verify the endpoint.
  </Card>

  <Card title="Deploy with Remix" icon="rocket" href="/smart-contracts/deploy-with-remix">
    Compile and deploy a Solidity contract from the browser.
  </Card>

  <Card title="Precompiles" icon="microchip" href="/smart-contracts/precompiles/overview">
    Call native Lumera modules from Solidity at fixed addresses.
  </Card>
</CardGroup>