$QUANT — landing + live terminal

An orchestra of ~18 AI agents trading Hyperliquid perps. Marketing site (LARP) with a Living Agent Swarm aesthetic, driven by real Hyperliquid market data.

• Landing (/) — hero swarm + 6-layer pipeline + live signal desk + agent roster + performance + tokenomics + roadmap + Telegram modes + FAQ + waitlist.
• Terminal (/terminal) — live dashboard: real price/funding/OI, in-browser TA, agent vote matrix and a LONG/SHORT/SKIP verdict.

Stack

React 19 · Vite 8 · TypeScript · Tailwind v4 · shadcn-style UI · anime.js v4 (SVG) · Recharts · React Router · Lenis. Package manager: pnpm.

Run

pnpm install
pnpm dev        # dev server (http://localhost:5173)
pnpm build      # production build → dist/  (deploy this only)
pnpm preview    # serve the built dist/
pnpm gen:icons  # regenerate favicon.ico / og.png from public/favicon.svg

Data

• Live: Hyperliquid public info API (POST https://api.hyperliquid.xyz/info, no auth, CORS *) → live BTC/ETH/SOL price, funding, OI. Indicators (RSI/MACD/EMA/ATR/Bollinger) are computed in-browser in src/lib/ta.ts; agent votes + verdict in src/lib/signals.ts.
• Seed fallback: src/data/seedMarket.ts renders deterministic data instantly (labelled non-live) so cards never hang; live data replaces it.
• Honesty: anything that can't be real pre-TGE (token price/holders/PnL track record) is rendered but clearly labelled simulated.

Live paper-trading worker

worker/ is an always-on Node loop that reuses the browser brain (src/lib/ta.ts

• signals.ts) server-side: real candles → real TA → 4-agent vote → verdict, then it paper-trades the verdict against live Hyperliquid prices and broadcasts every fill to Telegram. This turns the simulated PnL track record into an honest, verifiable one — no order is ever signed (dry-run only). See worker/README.md.

pnpm worker        # run forever (Telegram optional — prints to stdout if unset)
pnpm worker:once   # single tick smoke test

⚠️ Fill these before launch

Edit src/data/site.ts:

• x — the project's X/Twitter URL (manager-provided; shown in header + footer)
• telegram — Telegram link
• contract — $QUANT Solana mint (post-TGE)

Other:

• Wallet: src/components/ConnectWallet.tsx is a cosmetic Solana connect modal (honest pre-TGE). To wire real Reown AppKit (Solana), add a projectId (Reown dashboard) and swap the modal body — see the project plan.
• DexScreener token strip: add the $QUANT pair address once it lists.
• The base-verification meta tag is already in index.html.

Research agent (FactsAI)

The landing has a "Research agent · L4" section that renders a real AI market brief with cited web sources from FactsAI (src/lib/factsai.ts, components/sections/AIBrief.tsx). It self-hides when the feed is unreachable, so the page never looks broken.

⚠️ A static site cannot call FactsAI directly — the API returns no Access-Control-Allow-Origin (browser blocks it) and a client key would be public. Also, at the time of building, FactsAI's endpoint returned 500 "Service configuration error" (their backend). To enable it:

1. Deploy the included proxy: proxy/factsai-worker.js (Cloudflare Worker — holds the key + adds CORS). See the header comment for wrangler steps.
2. Set VITE_FACTSAI_PROXY=https://<your-worker>.workers.dev in .env.local, then pnpm build.
3. FactsAI must also fix their upstream 500 before real answers return.

Without a proxy, set VITE_FACTSAI_KEY in .env.local for local dev only (the key is baked into the bundle and CORS will still block production).

Deploy

Ship dist/ only to the GitLab static host (agency templates/starter pipeline). If the app is served without SPA fallback, deep-linking /terminal on refresh may 404 — configure the host to fall back to index.html, or switch to HashRouter in src/App.tsx.