CryptoCheck AI — Institutional Terminal v3

The neural scanner for Solana. Bloomberg-style terminal with real-time Helius data, portfolio risk scoring, and Jupiter integration.

🚀 Quick Start (localhost)

# 1. Install dependencies
npm install

# 2. Run dev server
npm run dev

# 3. Open in browser
open http://localhost:3000

📁 Project Structure

cryptocheck/
├── app/
│   ├── layout.tsx          ← Root layout (IBM Plex fonts, SolanaProvider)
│   └── page.tsx            ← Main terminal UI (all views + logic)
├── components/
│   └── SolanaProvider.tsx  ← Phantom wallet context (no external deps)
├── lib/
│   └── helius.ts           ← All Helius RPC/API/DAS calls + risk engine
├── styles/
│   └── globals.css         ← Scanlines, ambient glow, all custom effects
├── tailwind.config.js      ← Bloomberg fonts + neon color palette
├── next.config.js
├── tsconfig.json
└── package.json

🔑 Environment variables (canonical)

Server-side Solana / Helius (never expose the API key in NEXT_PUBLIC_*):

HELIUS_API_KEY=your_helius_api_key
# Optional: override default public RPC for specific routes (e.g. payments)
HELIUS_RPC_URL=https://api.mainnet-beta.solana.com
# Optional: extra failover JSON-RPC URL
SOLANA_RPC_FALLBACK_URL=

Supabase + OpenAI (see Vercel project settings):

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
OPENAI_API_KEY=

The app builds Helius REST and RPC URLs from HELIUS_API_KEY inside lib/helius-server.ts (server-only). The browser uses /api/solana/rpc so the key is not bundled client-side.

💳 Stripe (Paywall)

Price IDs pre-configured in ProModal:

• Weekly $5/week: price_1T9vbAAkjKVFT4LeZstngEew
• Yearly $200/year: price_1T9vdDAkjKVFT4LeAb9952Gt

To activate payments, create a /api/checkout route and call Stripe from the server.

✨ Features

Feature	Status	Source
Neural Token Scan	✅ Live	Helius RPC + API
Holder Distribution Chart	✅ Live	Helius RPC / Chart.js
Rug Pull Detection	✅ Live	Neural Engine v2
Portfolio Risk Score	✅ Live	Helius DAS API
Safe vs Risk Breakdown	✅ Live	Neural Engine v2
Jupiter Buy Button	✅ Live	jup.ag deep link
Whale Tracker	🔒 PRO	Demo data
Alpha Feed	🔒 PRO	Demo data
Phantom Wallet	✅ Live	window.solana
Mobile Bottom Nav	✅ Live	Tailwind responsive
Bloomberg Aesthetic	✅ Live	IBM Plex Mono
Scanlines Effect	✅ Live	CSS repeating-gradient
Ambient Glow	✅ Live	CSS blur blobs
Disclaimer Footer	✅ Live	Static

🔌 Wallet

Phantom wallet connection uses window.solana directly — no @solana/wallet-adapter needed for this build. Install Phantom from phantom.app.

📱 Mobile

• Sticky bottom nav bar (Scan / Portfolio / Whales / Alpha / Pro)
• Horizontal scroll for all data tables
• Full-width Jupiter buy and Upgrade buttons
• Cards stack vertically on small screens
• Charts adapt to mobile viewport