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. Key parameters include EVM fork activation timestamps. For established chains, fork overrides can be applied via an upgrade.json file placed in the chain data directory:

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

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.