Documentation

ROBINCORE Terminal

RWA intelligence platform for screening tokenized Treasuries, money markets, credit, and funds — with health scoring, RAG chat, wallet exposure, and a knowledge graph over issuers, custodians, and chains.

Architecture

ROBINCORE is a Next.js App Router application. Platform routes live under (platform) with a shared navbar + sidebar shell. Seed RWA data ships in src/lib/data; scoring and RAG utilities sit beside API route handlers under src/app/api.

Presentation

Glass cards, ScoreRing/Bar, Recharts, Framer Motion, dark green terminal theme.

Domain

Assets, issuers, chains, regulations, news — typed in src/lib/types.ts.

Intelligence

Health scores, portfolio exposure, RAG context for /api/chat, knowledge graph.

Modules

Screener

Multi-filter RWA discovery sorted by overall health.

Watchlist

LocalStorage tickers with yield alerts above 5%.

Knowledge Graph

Issuer ↔ asset ↔ custodian ↔ chain relationships.

Wallet

Demo portfolio exposure, weighted APY, health.

Compare

Side-by-side asset fields and recomputed scores.

AI Agent

RAG-backed chat over seed corpus + optional LLM.

Health scoring

Seven dimensions: risk, liquidity, transparency, compliance, issuer, security, and overall. Weights live in src/lib/scores/health-score.ts (HEALTH_SCORE_WEIGHTS).

Risk — inverted risk level with yield-chase penalties
Liquidity — log depth + liquidity/TVL ratio
Transparency — whitepaper, audit, contract, disclosures
Compliance — frameworks, jurisdiction, custody signals
Issuer — reputation, age, TVL, audit presence
Security — audit, permissioning, contract presence

Fetch live computed scores via GET /api/scores?slug=.

RAG

src/lib/ai/rag.ts builds knowledge chunks from assets, issuers, news, and regulations. Retrieval scores lexical overlap and injects context into the chat system prompt.

Without OPENROUTER_API_KEY or OPENAI_API_KEY, /api/chat streams a mock RAG answer so the terminal works offline.

APIs

REST handlers: /api/chat, /api/search, /api/assets, /api/market, /api/scores. Full curl examples live on the API reference.

Data sources

Default mode uses curated seed datasets (demo NAV / TVL / APY — not live). Optional Supabase clients exist under src/lib/supabase for future persistence of watchlists and portfolios.

Toggle mock vs. future live feeds in Settings.

Getting started

Environment

# .env.local
OPENROUTER_API_KEY=           # preferred for /api/chat
OPENAI_API_KEY=               # fallback OpenAI-compatible key
NEXT_PUBLIC_SUPABASE_URL=     # optional
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=    # server only

npm install
npm run dev
# open http://localhost:3000/dashboard