SolScope — Solana On-Chain Intelligence

SolScope is an open-source on-chain intelligence platform for Solana. Paste any wallet or token address and get instant visual analytics, AI-powered explanations, and risk scoring.

Features

• Bubble Map — D3.js force-graph visualization of holder distribution (Haradrim-style)
• Holder Table — Ranked holder list with Solscan links
• Sankey Flow Diagram — Transaction flow visualization
• Risk Scoring — Automated risk assessment (LOW / MEDIUM / HIGH / CRITICAL)
• AI Explainer — Natural language analysis powered by Claude (via OpenRouter)
• Interactive Chat — Ask follow-up questions about the analysis
• Share & Export — Share via URL, export as JSON/CSV
• Dashboard — History of analyzed addresses
• Alerts — Set up whale movement and concentration alerts

Tech Stack

Layer	Technology
Frontend	Next.js 15, TypeScript, Tailwind CSS v4, D3.js
UI	React Bits (animated components), Radix UI
Backend	Hono.js, TypeScript
AI	OpenRouter (Claude, GPT, etc.)
Data	Helius APIs (Solana)
State	Zustand, TanStack Query

Quick Start

Prerequisites

• Node.js 18+
• Helius API key (free tier works)
• OpenRouter API key (for AI features)

1. Clone

git clone https://github.com/YOUR_USERNAME/solscope.git
cd solscope

2. Backend Setup

cd backend
npm install
cp .env.example .env
# Edit .env with your API keys
npm run dev

Backend runs on http://localhost:8787

3. Frontend Setup

cd frontend
npm install
cp .env.example .env.local
# Edit .env.local if backend runs on different port
npm run dev

Frontend runs on http://localhost:3000

4. Use

Open http://localhost:3000, paste a Solana token or wallet address, and explore.

Project Structure

solscope/
├── frontend/          # Next.js 15 App Router
│   ├── src/
│   │   ├── app/       # Pages (explore, dashboard, alerts)
│   │   ├── components/# UI components
│   │   ├── hooks/     # React hooks
│   │   ├── stores/    # Zustand stores
│   │   └── lib/       # Utils, API client, constants
│   └── ...
├── backend/           # Hono.js API server
│   ├── src/
│   │   ├── routes/    # API routes (analyze, chat, share, export, alerts)
│   │   ├── services/  # Business logic (helius, analysis, AI, cache)
│   │   └── config/    # Configuration
│   └── ...
├── CLAUDE.md          # AI coding assistant context
└── PRD - SolScope.md  # Product requirements

API Endpoints

POST /api/analyze          — Analyze a Solana address
GET  /api/analyze/:address — Get cached analysis
POST /api/chat             — AI chat with analysis context
POST /api/share            — Generate share URL
GET  /api/share/:id        — Get shared analysis
GET  /api/export/:address  — Export as JSON or CSV (?format=json|csv)
GET  /api/history          — List recent analyses
POST /api/alerts           — Create alert
GET  /api/alerts           — List alerts

Environment Variables

Backend (.env)

Variable	Description	Required
HELIUS_API_KEY	Helius API key for Solana data	Yes
AI_API_KEY	OpenRouter / OpenAI / Anthropic API key	Yes (for AI features)
AI_BASE_URL	AI provider base URL	No (defaults to OpenRouter)
AI_MODEL	AI model to use	No (defaults to claude-sonnet-4)
PORT	Server port	No (defaults to 8787)

Frontend (.env.local)

Variable	Description	Required
NEXT_PUBLIC_API_URL	Backend API URL	No (defaults to http://localhost:8787)

License

MIT