Skip to main content
Precompiles are contracts at fixed addresses that the chain implements natively instead of in EVM bytecode. Your Solidity code calls them like any other contract, and the chain runs the matching module logic directly. There is nothing to deploy, and the addresses never change. Lumera Protocol ships 11 static precompiles. Eight come from the standard Cosmos EVM v0.6.0 set. Three are custom precompiles that expose Lumera’s own modules. The EVM is live on testnet (lumera-testnet-2) only. Mainnet runs v1.12.0 and gains the EVM with its upgrade.

Address map

Lumera follows a simple address convention.

Custom precompiles

Standard precompiles

The Vesting precompile (0x...0803) is excluded because the current Cosmos EVM default registry does not provide an implementation for it. Full signatures for the whole set live on the standard precompiles page.

When to use a precompile

Reach for a precompile whenever your contract needs a native chain feature.
  • Register and track Cascade storage or Sense analysis actions from contract logic (Action)
  • Read SuperNode registration state, rankings, and hardware metrics on chain (SuperNode)
  • Execute or query a CosmWasm contract from Solidity (Wasm)
  • Stake, vote, claim rewards, or send IBC transfers from a contract (standard set)
You can also call any precompile straight from JavaScript over JSON-RPC. Read methods work through eth_call with no deployed contract at all.

Calling a precompile

Import the interface and point it at the fixed address.
MyDApp.sol
The interfaces (IAction.sol, ISupernode.sol, IWasm.sol) live in precompiles/solidity in the lumera repo, together with example contracts and a Hardhat test project. They are plain type-safe wrappers around calls to the fixed addresses.

Gas

Precompile calls consume gas like any other EVM call. The custom precompiles meter gas from the underlying Cosmos gas usage, converted to EVM gas units. view methods cost nothing when called through eth_call. The P256 precompile has a fixed cost of 3,450 gas.

Safety rails

Precompile addresses cannot receive plain token transfers. The chain blocks them through the module account block list and a bank send restriction, so funds cannot be lost by sending tokens to a precompile address by accident.

Next steps

Standard precompiles

Staking, governance, IBC transfers, and more with full signatures.

Action precompile

Drive Cascade and Sense actions from your contracts.

CosmWasm bridge

Call CosmWasm contracts from Solidity and the reverse.