zeekayandHanzo Dev
2aab9f6e87
work.lux / work.hanzo came up during rollout: they now serve the Dework shell (HTTP 200) but render the amber FIXTURE fallback (owner 0x0000…0000 + "Missing or invalid parameters") because their C-Chain work-market is undeployed (brands.ts bounty == 0x0 — Lux frozen at flag-day tip, Hanzo key-gap). Keep them skip-gated (un-skipping would fail the emerald-LIVE invariant), but fix the stale "HTTP-unreachable" reason to the accurate go-live condition: flip when BountyV1 is deployed on the org C-Chain and the board shows the emerald LIVE badge. Co-authored-by: Hanzo Dev <[email protected]>
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 | 96367 | lux-dev-k8s |
Mainnet runs 15 validators. Each cluster runs luxd StatefulSets.
app chain EVM Chain IDs
| app chain EVM | Coin | Mainnet | Testnet | Devnet |
|---|---|---|---|---|
| Zoo | ZOO | 200200 | 200201 | 200202 |
| Hanzo | AI | 36963 | 36962 | 36964 |
| SPC | SPC | 36911 | 36910 | 36912 |
| Pars | PARS | 494949 | 494950 | 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 | Gateway API gateway |
| lux-explorer | Lux Explorer (single Go binary: indexer+GraphQL+SPA, all 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/explorer | Lux Explorer (single Go binary: indexer+GraphQL+SPA) |
| ghcr.io/luxfi/operator | K8s operator |
| ghcr.io/luxfi/gateway | Gateway |
RPC Endpoints
https://api.lux.network/{mainnet,testnet,devnet}/v1/bc/{chain}/rpc
License
Proprietary - Lux Partners Limited. All rights reserved.