C-Chain (EVM)

The C-Chain (Contract Chain) is the primary smart contract platform on Lux Network. It runs a full Ethereum Virtual Machine, providing compatibility with Solidity contracts, standard EVM tooling (Hardhat, Foundry, ethers.js), and the standard JSON-RPC API.

Chain IDs

Token Denomination

The C-Chain uses standard EVM 18-decimal Wei denomination, matching Ethereum conventions. The P-Chain and X-Chain use 6-decimal microLUX denomination.

Configuration

The C-Chain is configured via the EVM genesis embedded in the network genesis. Lux activates all C-Chain features at genesis (activate-all-implicitly). The legacy networkUpgradeOverrides timestamp fields exist for header-schema compatibility with migrated chain-EVM state (LP-3641) and are pinned to genesis (timestamp 0):

{
  "networkUpgradeOverrides": {
    "durangoTimestamp": 0,
    "quasarTimestamp": 0,
    "fortunaTimestamp": 0,
    "graniteTimestamp": 0
  }
}

EVM opcode hardfork gates (Shanghai, Cancun) are kept because they gate bytecode behavior; the C-Chain supports the Cancun blob schedule:

{
  "blobSchedule": {
    "cancun": {
      "max": 6,
      "target": 3,
      "baseFeeUpdateFraction": 3338477
    }
  }
}

RPC API

The C-Chain exposes the standard Ethereum JSON-RPC API. All methods are available at the /ext/bc/C/rpc endpoint.

Common Methods

# Get chain ID
curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' \
  https://api.lux.network/mainnet/ext/bc/C/rpc

# Get latest block number
curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  https://api.lux.network/mainnet/ext/bc/C/rpc

# Get balance
curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x...","latest"],"id":1}' \
  https://api.lux.network/mainnet/ext/bc/C/rpc

WebSocket

WebSocket connections are available at /ext/bc/C/ws for real-time event subscriptions.

Connecting with MetaMask

Add Lux Mainnet to MetaMask with these settings:

• Network Name: Lux Mainnet
• RPC URL: https://api.lux.network/mainnet/ext/bc/C/rpc
• Chain ID: 96369
• Currency Symbol: LUX
• Explorer: https://explore.lux.network

Deploying Contracts

Use any standard EVM tooling. Example with Foundry:

forge create --rpc-url https://api.lux.network/mainnet/ext/bc/C/rpc \
  --private-key $PRIVATE_KEY \
  src/MyContract.sol:MyContract

Block Explorer

The C-Chain block explorer is available at explore.lux.network.

Related LPs

See lps.lux.network for the relevant Lux Proposals governing this chain.