Lux Docs

Sovereign L1 EVM chains with configurable gas, fees, and precompiles. Used by Zoo, Hanzo, SPC, Pars.

Each sovereign L1 EVM chain has its own validator set, gas configuration, fee structure, precompiles, and genesis state while participating in the Lux Network for cross-chain messaging and shared security.

Deployed Chains

Chain	Chain ID (Mainnet)	Chain ID (Testnet)	Chain ID (Devnet)	Explorer
Zoo	200200	200201	200202	explore-zoo.lux.network
Hanzo	36963	36964	36964	explore-hanzo.lux.network
SPC	36911	36910	36912	explore-spc.lux.network
Pars	494949	7071	494951	explore-pars.lux.network

RPC Endpoints

Chain RPCs are accessible via the gateway using their blockchain ID:

https://api.lux.network/mainnet/ext/bc/{blockchain-id}/rpc

Named shortcuts are available for deployed chains:

https://api.lux.network/mainnet/ext/bc/zoo/rpc
https://api.lux.network/mainnet/ext/bc/hanzo/rpc
https://api.lux.network/mainnet/ext/bc/spc/rpc
https://api.lux.network/mainnet/ext/bc/pars/rpc

Genesis Configuration

An EVM chain genesis defines the initial state, fee parameters, and precompile configuration. Key fields:

{
  "config": {
    "chainId": 200200,
    "feeConfig": {
      "gasLimit": 15000000,
      "targetBlockRate": 2,
      "minBaseFee": 25000000000,
      "targetGas": 15000000,
      "baseFeeChangeDenominator": 36,
      "minBlockGasCost": 0,
      "maxBlockGasCost": 1000000,
      "blockGasCostStep": 200000
    },
    "allowFeeRecipients": false
  },
  "alloc": {
    "0x...": {
      "balance": "0x..."
    }
  },
  "timestamp": "0x0",
  "gasLimit": "0xe4e1c0"
}

Fee Configuration Parameters

Parameter	Default	Description
`gasLimit`	15,000,000	Maximum gas per block
`targetBlockRate`	2	Target seconds between blocks
`minBaseFee`	25 Gwei	Minimum base fee
`targetGas`	15,000,000	Target gas consumption per block
`baseFeeChangeDenominator`	36	Controls base fee adjustment speed
`minBlockGasCost`	0	Minimum gas cost charged to the block producer
`maxBlockGasCost`	1,000,000	Maximum gas cost charged to the block producer

Deploying a New EVM Chain

Create the genesis JSON with your desired chain ID, allocations, and fee config.
Deploy via the Lux wallet SDK:

export LUX_PRIVATE_KEY=0x...
go run ./wallet/network/primary/examples/deploy-chains/ \
  --network=mainnet \
  --skip-validators

Ensure all validators track the new chain:

luxd --track-chains=<chain-id>

Standard Contract Deployments

All chains include a standard set of 20 deployed contracts: WLUX, bridged tokens, AMM (router, factory, pairs), governance, identity (DIDRegistry), treasury, LSSVM, and DeFi utilities. Contract addresses are identical across all chains (deployed from nonce 0).

RPC API

EVM chains expose the full Ethereum JSON-RPC API, identical to the C-Chain. All eth_*, net_*, web3_*, and debug_* methods are supported.

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

EVM Chains