Skip to main content
Lumera Protocol nodes on EVM enabled networks serve a standard Ethereum JSON-RPC API. HTTP runs on port 8545 and WebSocket on port 8546, both enabled by default on upgraded nodes. Any tool that speaks Ethereum RPC works unchanged. Hardhat, Foundry, Ethers, viem, and MetaMask all connect by pointing at the endpoint and chain ID below. The EVM is live on testnet today. Mainnet runs v1.12.0 and gains the EVM JSON-RPC with its EVM upgrade.

​
Base URLs and chain ID

The EVM chain ID is 76857769 on every Lumera network. JSON-RPC returns it as hex 0x494c1a9. The currency symbol is LUME, exposed to the EVM as the 18 decimal denom alume. WebSocket subscriptions run on port 8546 on nodes you operate yourself.

​
Quick checks

Verify connectivity with eth_chainId and eth_blockNumber.
eth_chainId returns 0x494c1a9. eth_blockNumber returns the latest height as a hex number.

​
Namespaces

Methods are grouped by namespace prefix. The default node configuration enables eth, net, web3, and rpc. Node operators can enable additional namespaces such as debug and txpool in app.toml, so their availability depends on the endpoint you call. The fee market implements EIP-1559 with a dynamic base fee, so fee estimation behaves the way Ethereum tooling expects.

​
OpenRPC discovery

The node ships a machine readable catalog of every JSON-RPC method it supports, in OpenRPC format. The spec regenerates at build time from the RPC implementation, so it always matches the running node. There are two ways to fetch it.
  • Call rpc_discover (or the alias rpc.discover) on the JSON-RPC endpoint.
  • Fetch /openrpc.json from the Cosmos REST API port (1317) with a plain GET.
The catalog covers about 743 methods with parameters, return types, and examples. Browse and execute them interactively in the OpenRPC playground.

​
Next steps

Smart contracts overview

What the Lumera EVM offers contract developers.

OpenRPC playground

Explore every RPC method from the browser.

Connect MetaMask

Add the Lumera network to MetaMask.