Lux Docs

lux chain

Create and deploy chains (subnets)

The chain command (also aliased as subnet) manages the full lifecycle of Lux chains -- creation, deployment, import/export, and configuration.

Commands

# Create a new chain configuration
lux chain create <name>
lux chain create <name> --evm-chain-id=12345
lux chain create <name> --token-name=MYTOKEN --token-symbol=MTK
lux chain create <name> --type=l1    # Sovereign L1
lux chain create <name> --type=l3    # App-specific L3

# Deploy to a network
lux chain deploy <name> --devnet
lux chain deploy <name> --testnet
lux chain deploy <name> --mainnet

# List configured chains
lux chain list

# Show chain details
lux chain describe <name>

# Import RLP blocks
lux chain import --chain=c --path=/path/to/blocks.rlp
lux chain import --chain=zoo --path=/path/to/zoo.rlp

# Export chain configuration
lux chain export <name>

Chain Types

TypeFlagDescription
L2 (default)--type=l2Subnet EVM chain validated by a subset of validators
L1--type=l1Sovereign chain with its own validator set
L3--type=l3Application-specific chain anchored to an L2

Chain Configuration

Configurations are stored in ~/.lux/chains/<name>/:

~/.lux/chains/<name>/
  genesis.json      Chain genesis with allocations and config
  sidecar.json      VM metadata and chain type
  config.json       Runtime configuration (optional)

Deployment

When deploying, the CLI:

  1. Creates a subnet on the P-Chain
  2. Adds validators to the subnet
  3. Creates the blockchain with the genesis file
  4. Configures all nodes to track the new chain

Pre-deployed Subnet Chains

ChainMainnet Chain IDSubnet ID
Zoo200200See blockchain-ids
Hanzo36963See blockchain-ids
SPC36911See blockchain-ids
Pars494949See blockchain-ids

On this page