mirror of
https://github.com/hanzoai/bootnode.git
synced 2026-10-25 02:31:30 +00:00
zeekay
d5fbe67fad
Turn lux.cloud into a live graphical fleet dashboard for the managed luxd fleet (devnet/testnet/mainnet, 5 validators each on do-sfo3-lux-k8s). Backend (read-only collector, no mutations, no monolith dependency): - core/chains/lux_fleet.py: reads the operator LuxNetwork CR (lux.cloud/v1) for validators/version/plugin-set/phase, lists luxd-N pods + per-pod LB Services, and queries luxd JSON-RPC per node (info.getNodeVersion/getNodeID/ peers/isBootstrapped, C-Chain eth_blockNumber, P-Chain platform.getHeight), plus a native D-Chain DEX summary. Aggregates all 3 nets concurrently. - fleet_app.py: minimal standalone FastAPI exposing GET /v1/fleets/lux/overview (public, read-only). Reuses the bootnode api image; isolated from the (currently import-broken) monolith. - fleets/__init__.py: same overview endpoint also mounted on the main router. - Uses a READ-ONLY lux-k8s kubeconfig from KMS; only public chain data leaves. Frontend (Next.js 16, Lux white-label, auto by hostname): - lib/fleet.ts: typed client + health/status derivations. - components/lux/fleet-dashboard.tsx: graphical multi-net dashboard — totals, world topology map, per-network cards (phase, version, plugin-set, peers, C-Chain height, DEX state, per-chain C/P/X/D bootstrap), expandable per-node tables (node ID, version, peers, heights). Auto-refresh 15s. - app/fleet/page.tsx: public /fleet page (the lux.cloud fleet dashboard). - components/lux/fleet-strip.tsx + page.tsx: live fleet status strip on the landing hero. - navbar + dashboard nav: Fleet links; register existing Lux fleet mgmt page. - brand.ts: add skillsOrg (fixes pre-existing typecheck/build break). Deploy: infra/k8s/lux-fleet.yaml — lux-fleet Deployment/Service + ExternalSecret (lux-k8s RO kubeconfig from KMS) + ingress path /v1/fleets/lux/overview on api.cloud.lux.network. Verified: collector live against all 3 nets (real heights/peers/versions/DEX); api + collector tests pass (8/8); web typecheck + production build green; /fleet renders live data in browser (screenshot).
skills
@ a066582936
Bootnode
Web3 Backend in a Box - Run locally or deploy to cloud.
Go rewrite (HIP-0106) in progress. The current production service is the Python FastAPI app under
api/. A Go scaffold that mounts intosuperbaseper HIP-0106 lives alongside it —api/,cmd/bootnode/,schema/,zap/. Seedocs/PYTHON_TO_GO_PORT.mdfor the endpoint-by-endpoint port map and the new Go README section below.
Quick Start
docker compose up -d
Done. Your Web3 backend is running:
- API: http://localhost:8000
- Dashboard: http://localhost:3001
- API Docs: http://localhost:8000/docs
Features
| API | Description |
|---|---|
POST /v1/rpc/{chain} |
Multi-chain JSON-RPC proxy |
WS /v1/ws/{chain} |
Real-time blockchain subscriptions |
GET /v1/tokens/{chain}/balances/{address} |
Token balances & metadata |
GET /v1/nfts/{chain}/owned/{address} |
NFT ownership & metadata |
POST /v1/webhooks |
Event-driven notifications |
POST /v1/wallets/create |
ERC-4337 smart wallets |
POST /v1/bundler/{chain} |
UserOp bundling |
POST /v1/gas/sponsor |
Gas sponsorship |
Supported Chains
L1: Ethereum, BNB Chain, Avalanche, Solana, Bitcoin
L2: Arbitrum, Optimism, Base, Polygon, zkSync, Scroll, Linea, Blast
Development
# API (Python 3.12+)
cd api && uv sync && uvicorn bootnode.main:app --reload --port 8000
# Dashboard (Node 22+)
cd web && pnpm install && pnpm dev
Deploy
Self-hosted
docker compose -f docker-compose.prod.yml up -d
# or
kubectl apply -f infra/k8s/
Hanzo Cloud
hanzo deploy
Visit web3.hanzo.ai for managed hosting.
License
Apache-2.0
Go rewrite (HIP-0106)
The Go subsystem mounts into superbase (the unified Hanzo Cloud
binary). It exposes a single Mount(r chi.Router, deps api.Deps) error
entry point and a public ZAP schema (schema/bootnode.zap) covering
every cross-subsystem type.
bootnode/
schema/bootnode.zap # public typed surface (ZAP)
zap/gen/ # zapc-generated Go (hand-stubs today)
api/ # subsystem code (chi handlers + store)
mount.go # HIP-0106 contract
deps.go # IAM/KMS/Base/O11y/Commerce interfaces
handlers/ # one MountXxx per FastAPI route group
middleware/ # auth, telemetry, rate-limit
store/ # per-tenant SQLite via deps.Base
web3/ # chain registry + RPC pool
cmd/bootnode/main.go # standalone dev shim
docs/PYTHON_TO_GO_PORT.md # endpoint-by-endpoint mapping
Build
go build ./...
go vet ./...
go run ./cmd/bootnode # listens on :8100 (BOOTNODE_ADDR to override)
Generate ZAP bindings
cd zap && make gen # no-op if zapc isn't installed
zapc lives at ~/work/hanzo/zap/zapc-rs/. Brand policy: no
.capnp files, no "Cap'n Proto" references on the public surface
(HIP-0106).