Lux Universe
Infrastructure monorepo for Lux Network. Compose files, Kubernetes manifests, gateway configs, and deployment scripts.
Lux Ecosystem
| Repo | Purpose | Stack |
|---|---|---|
| lux/node | Core blockchain node (luxd) | Go |
| lux/wallet | @luxfi/wallet (extension, mobile, web) | TypeScript |
| lux/exchange | DEX at lux.exchange (apps/web, apps/mobile) | Vite + Tamagui |
| lux/web | lux.network marketing site | Next.js 14 |
| lux/ui | @luxfi/ui component library | React |
| lux/papers | 111 research papers | LaTeX |
| lux/proofs | Formal verification (Lean 4, TLA+, Halmos, Tamarin) | Multi |
Structure
compose*.yml Docker Compose for local dev (mainnet/testnet/devnet)
k8s/ Kubernetes manifests (lux-k8s cluster)
configs/ Node and gateway configuration
chain-configs/ Per-chain EVM configuration
scripts/ Deployment and management scripts
docker/ Dockerfiles
iam/ IAM init data for lux.id
e2e/ Playwright E2E tests (~488 cases)
Networks
| Network | Network ID | C-Chain ID | DOKS Cluster |
|---|---|---|---|
| Mainnet | 1 | 96369 | lux-k8s (do-sfo3-lux-k8s) |
| Testnet | 2 | 96368 | lux-test-k8s |
| Devnet | 3 | 96370 | lux-dev-k8s |
Mainnet runs 15 validators. Each cluster runs luxd StatefulSets.
Subnet Chain IDs (EVM)
| Subnet | Coin | Mainnet | Testnet | Devnet |
|---|---|---|---|---|
| Zoo | ZOO | 200200 | 200201 | 200202 |
| Hanzo | AI | 36963 | 36964 | 36964 |
| SPC | SPC | 36911 | 36910 | 36912 |
| Pars | PARS | 494949 | 7071 | 494951 |
Quick Start
git clone --recursive [email protected]:luxfi/universe.git
cd universe
# Local development
docker compose -f compose.mainnet.yml up -d
# Production (lux-k8s)
kubectl --context do-sfo3-lux-k8s apply -k k8s/lux-k8s
Production (lux-k8s)
LB: 134.199.138.27. All *.lux.network services.
| Namespace | Services |
|---|---|
| lux-system | hanzo-ingress (Traefik), lux-operator |
| lux-mainnet | 5 luxd validators |
| lux-testnet | 5 luxd validators |
| lux-devnet | 5 luxd validators |
| lux-gateway | KrakenD API gateway |
| lux-explorer | Blockscout (5 chains), exchange, indexers, faucets |
| lux-bridge | Bridge UI + server |
| lux-mpc | MPC dashboard + API (5 nodes, threshold 3) |
| lux-kms | KMS API |
Key Images (GHCR)
| Image | Purpose |
|---|---|
| ghcr.io/luxfi/node | Blockchain node |
| ghcr.io/luxfi/explore | Explorer frontend |
| ghcr.io/luxfi/blockscout-lux | Explorer backend |
| ghcr.io/luxfi/operator | K8s operator |
| ghcr.io/luxfi/gateway | KrakenD gateway |
RPC Endpoints
https://api.lux.network/{mainnet,testnet,devnet}/ext/bc/{chain}/rpc
License
Proprietary - Lux Partners Limited. All rights reserved.