l2-template/README.md

Lux L2 Template

Spin up a new L2/L1 on the Lux Network in minutes.

Usage

./init.sh <chain-name> <symbol> <chain-id-mainnet> <chain-id-testnet> <chain-id-devnet>

# Example:
./init.sh zoo ZOO 200200 200201 200202
./init.sh hanzo AI 36963 36964 36965
./init.sh mychain MYC 900900 900901 900902

This generates 7 repos in ~/work/<chain>/:

Repo	What
evm/	Go node binary — 1 file, imports luxfi/evm + precompiles
cli/	Go CLI — <chain> deploy evm
sdk/	TypeScript SDK — chain IDs, RPCs, precompile addresses
contracts/	Foundry — bridge tokens, chain-specific contracts
genesis/	Genesis JSON per environment
exchange/	Web + Mobile + Extension apps (consumes @l.x/* from npm)
universe/	K8s manifests (nodes, explorer, mpc, kms, bridge, ingress)

Requirements

• Go 1.26+
• Node 20+ / pnpm
• Foundry (forge, cast)
• kubectl + cluster access
• MNEMONIC env var for deployment