Hanzo AI
e1e339dbfc
Comprehensive standup guide covering:
- Repo map (lux/{exchange,bridge,explorer,graph,universe,standard,genesis,cli},
zoo/{exchange,contracts,brand,logo}, hanzo/, pars/, liquidity/swap)
- Network topology diagram (browser → CF → hanzoai/ingress LB → KrakenD
gateway → luxd validators / unified explorer / MPC bridge)
- Per-chain backend table (gateway + indexer + graph + explorer per chain)
- Unified luxfi/explorer image (indexer + graph + explore frontend in one)
- White-label DEX standup pattern (50-line main.tsx shim, 5 steps to fork)
- Onboarding new WL apps (hanzo/exchange, pars/exchange, etc.) from canonical
zoo/exchange template
- Bridge integration (multi-tenant by Host header)
- Local dev full-stack standup (lux + standard + explorer + bridge + zoo)
- Production cluster deploy (kubectl apply per directory)
- DNS table for all 5 brand frontends + their api.*
Cross-references white-label api gateway recipe at
k8s/lux-mainnet/WHITE-LABEL-API.md.
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.