zeekay f907239098 universe: sovereign-L1 chain.yaml + 5-line Makefile + lux CLI flow
Migrate Zoo from L2-on-Lux to sovereign L1. Per-env primary networkID
equals per-env EVM chainID (200200 / 200201 / 200202 / 200203).
Explicit httpPort + stakingPort per env (no collisions; the old 9680
dev/local clash is gone — now 9720 / 9730).

chain.yaml:
  * networks.<env>.{networkID, primaryEvmChainID, httpPort, stakingPort,
    genesisFile, rpcUrl, cluster, namespace} explicit per env
  * runtime: block — dataDir / snapshotName / serviceLabel templates
    that the lux CLI (pkg/brand) expands per (network, env)

Makefile: collapsed from 16 hardcoded targets (4 verbs × 4 envs with
NID_MAIN := 200200 duplication) to 6 parametric lines:
    make up    env=devnet     ≡  lux up    zoo/devnet
    make cycle env=mainnet    ≡  lux cycle zoo/mainnet
    make cycle-all
Per-env constants live in chain.yaml — single source of truth.

deploy.sh removed: replaced by `lux <verb>` calls via Makefile.

LLM.md: documents the new sovereign-L1 model, CLI grammar
(`lux up/down/snap/cycle <network>/<env>`), chain.lock invariant,
per-brand DOKS cluster topology, and the zoo-private/universe sibling.
2026-06-16 21:03:25 -07:00
2026-06-10 18:23:14 -07:00
2026-02-14 05:27:03 -08:00
2026-03-26 22:45:36 -07:00
2026-03-26 22:45:36 -07:00

Zoo Universe

Infrastructure orchestration for Zoo Labs Foundation.

Architecture

zoo.ngo           — Marketing site (Vite SPA)
zoo.exchange      — DEX (Vite + Tamagui)
zoo.network       — Zoo Network validators
zoo.wallet        — Browser extension + mobile + web wallet
docs.zoo.ngo      — Documentation (fumadocs)
zips.zoo.ngo      — Zoo Improvement Proposals

Local Development

docker compose up        # All services
docker compose up ngo    # Just the website

Production (DOKS)

Three clusters:

  • do-sfo3-zoo-k8s — mainnet
  • do-sfo3-zoo-test-k8s — testnet
  • do-sfo3-zoo-dev-k8s — devnet

Deploy:

./deploy.sh mainnet
./deploy.sh testnet
./deploy.sh devnet

Repos

Repo Package Purpose
zoo/ngo @zooai/ngo-web Marketing site
zoo/exchange @zooai/exchange DEX frontend
zoo/wallet @zooai/wallet Wallet (ext + mobile + web)
zoo/ui @zooai/ui + @zooai/gui Design system
zoo/node — Rust blockchain node
zoo/docs @zoo/docs Documentation
zoo/ZIPs — Improvement Proposals
zoo/papers — Research papers (47)
zoo/formal — Formal proofs (20)
S
Description
Declared state for the zoo fleet: one values file per service, one ApplicationSet
Readme
1.2 MiB
Languages
TypeScript 70.1%
Shell 21.5%
Makefile 8.4%