01 — Overview
UniGen is an AI agent for on-chain intelligence. You ask in natural language; UniGen fetches wallet, token, and transaction signals, then explains them — not just dumps charts.
// UniGen_ What is UniGen? → AI agent for on-chain intelligence What can I do? → Analyze wallets, tokens & transactions Where? → Robinhood
02 — Quickstart
- Open /app
- Type a query or pick a suggestion chip
- Watch [ Processing... ] → structured panel + AI narrative
$ unigen_ > Analyze this wallet > 0x7A...92F [ Processing... ] > indexing on-chain data... > ready_
03 — AI Terminal
The terminal is the product surface. Language matches the visual system:
- // comments
- <components /> tags
- $ commands
- [ status ] state
- → data flow
- _ cursor
Input accepts free-form English. UniGen classifies intent (wallet / token / transactions / general) and returns matching intelligence.
04 — Example queries
> Analyze this wallet
Balance, activity, holdings, PnL narrative
> Analyze this wallet 0x7A...92F
Same flow with an explicit address
> What's happening with this token?
Price, volume, holders, liquidity read
> Track this address
Ongoing activity framing for a wallet
> Show recent transactions
Recent flow + accumulation vs sell bias
05 — AI Response Layer
Differentiation is interpretation. Raw fields sit in the dashboard; the AI layer answers what it means.
UniGen AI: This wallet has increased ETH exposure by 34% over the last 7 days. Recent activity suggests accumulation rather than selling.
MVP uses curated mock intelligence for demo reliability. With XAI_API_KEY set, /api/analyze can enrich narratives via SpaceXAI / xAI.
06 — On-chain data model
WALLET ├── Balance ├── Transactions ├── Holdings ├── PnL └── Activity
TOKEN ├── Price ├── Volume ├── Holders ├── Liquidity └── On-chain Activity
Phase 1 keeps charts minimal on purpose. Structure + narrative first; deep viz later.
07 — Analyze API
Client and server share one endpoint for the terminal agent loop.
POST /api/analyze
Content-Type: application/json
{ "query": "Analyze this wallet 0x7A..." }
→ {
kind, statusLines, insight,
wallet?, token?
}Status: 200 success · 400 missing query · narrative may fall back to mock if LLM unavailable
08 — Stack & env
- Frontend → Next.js · TypeScript · Tailwind · Framer Motion
- AI → LLM API · agent / tool-calling ready
- Chain → Robinhood on-chain APIs / RPC (wired in later phases)
- Backend → Next.js API · PostgreSQL (planned)
- Deploy → Vercel
# .env.local XAI_API_KEY= # optional, SpaceXAI / xAI
// visual system
Background → #08080D
Primary → White
Accent → Purple
Font → Monospace / Inter
Style → Terminal / AI / Cyber
09 — Roadmap
Phase 1
Landing · AI Terminal UI · Wallet lookup · On-chain data · AI analysis
Phase 2
Token intelligence · Transaction analysis · Wallet tracking · Saved searches
Phase 3
AI Agents · Automation · Alerts · Advanced on-chain intelligence