Skip to content

CodeMuscle/solbeam

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

72 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”† Solbeam

Cut through the noise. Real-time Solana DeFi intelligence β€” track smart money, scan tokens, and catch signals before the crowd.

License Next.js Supabase Solana Cost


What is Solbeam?

Solbeam is an open-source, self-hostable Solana DeFi intelligence dashboard. It shines a beam of light on on-chain activity β€” new token launches, smart wallet movements, whale alerts, and token risk scoring β€” all in one clean, fast interface.

Built as a direct alternative to tools like karoshi.fun, GMGN, and Birdeye, but with a zero-cost infrastructure approach that lets you ship a full MVP for free.


Screenshots

Coming soon β€” dashboard, token detail page, wallet tracker, and alerts.


Features

πŸ”΄ Live Token Feed

  • Real-time new token launches from Pump.fun, Raydium, and Jupiter
  • Price, volume, market cap, liquidity, and token age at a glance
  • Rug risk scoring β€” holder concentration, LP lock status, mint authority flags

πŸ‹ Smart Wallet Tracker

  • Add any Solana wallet address to your watchlist
  • Live transaction feed powered by Helius webhooks (no polling)
  • Classify every trade β€” buy/sell, token, USD value, DEX used
  • Follow known whale wallets and smart money

πŸ“Š Token Deep-Dive

  • TradingView Lightweight Charts for price + volume history
  • Top holder distribution (top 10 / 25 breakdown)
  • Recent on-chain transactions feed
  • Risk assessment panel with go/no-go signal

πŸ”” Alerts Engine

  • Set custom alerts on price thresholds, volume spikes, whale buys, and new wallet entries
  • Delivered via in-app notifications, email (Resend), and Telegram bot
  • No polling β€” push-based via Helius webhooks

πŸ€– AI Signal Summary (optional)

  • Claude API integration to summarise what smart money is doing
  • Example: "3 whale wallets entered $BONK in the last 2 hours β€” possible momentum setup"

πŸ† Smart Money Leaderboard

  • Curated list of consistently profitable wallets
  • Win rate, estimated PnL, most traded tokens
  • One-click follow to add to your watchlist

Tech Stack

Layer Technology
Framework Next.js 14 (App Router)
UI Shadcn/UI + Tailwind CSS
Database Supabase (Postgres + Realtime)
Auth Supabase Auth
Cache Upstash Redis (free tier)
Solana RPC Helius (free tier β€” 1M credits/mo)
Token Prices Jupiter Price API (free)
Token Analytics DexScreener API (free)
Charts TradingView Lightweight Charts
Email Resend (free tier β€” 3k/mo)
Deployment Vercel (Hobby β€” free)

Estimated infrastructure cost: $0–5/month for a full MVP.


Data Sources (All Free)

Source What It Provides
Helius Parsed transactions, webhooks, wallet history, token metadata (DAS API)
Jupiter Price API Real-time SPL token prices
DexScreener API Token pairs, volume, liquidity, OHLCV, new pairs
Solscan Holder data, token supply info

No Birdeye. No paid RPC. No expensive analytics subscriptions.


Getting Started

Prerequisites

1. Clone the repo

git clone https://github.com/yourusername/solbeam
cd solbeam
npm install

2. Set up environment variables

cp .env.example .env.local

Fill in your .env.local:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Helius
HELIUS_API_KEY=your_helius_api_key
HELIUS_WEBHOOK_SECRET=your_webhook_secret

# Upstash Redis
UPSTASH_REDIS_REST_URL=your_upstash_url
UPSTASH_REDIS_REST_TOKEN=your_upstash_token

# Resend (email alerts)
RESEND_API_KEY=your_resend_key

# Telegram Bot (optional)
TELEGRAM_BOT_TOKEN=your_telegram_bot_token

# Claude AI (optional β€” for AI signal summaries)
ANTHROPIC_API_KEY=your_anthropic_key

3. Run the database migrations

npx supabase db push

Or apply the SQL manually from /supabase/migrations/.

4. Register your Helius webhook

Point Helius to your deployment URL:

https://yourapp.vercel.app/api/webhooks/helius

Set it to listen for enhanced transaction events on your tracked wallet addresses.

5. Run locally

npm run dev

Open http://localhost:3000.


Project Structure

solbeam/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ (auth)/
β”‚   β”‚   β”œβ”€β”€ login/
β”‚   β”‚   └── signup/
β”‚   β”œβ”€β”€ dashboard/          # Main live feed
β”‚   β”œβ”€β”€ tokens/
β”‚   β”‚   └── [mint]/         # Token deep-dive page
β”‚   β”œβ”€β”€ wallets/
β”‚   β”‚   └── [address]/      # Wallet detail page
β”‚   β”œβ”€β”€ alerts/             # Alert management
β”‚   └── leaderboard/        # Smart money list
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ charts/             # TradingView + Recharts wrappers
β”‚   β”œβ”€β”€ tokens/             # TokenCard, RiskBadge, HolderChart
β”‚   β”œβ”€β”€ wallets/            # WalletFeed, WalletCard, TxRow
β”‚   └── alerts/             # AlertForm, AlertList, NotificationBell
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ helius.ts           # RPC + webhook helpers
β”‚   β”œβ”€β”€ jupiter.ts          # Price feed
β”‚   β”œβ”€β”€ dexscreener.ts      # Token pair data
β”‚   β”œβ”€β”€ supabase.ts         # DB client (server + browser)
β”‚   └── redis.ts            # Upstash cache helpers
β”œβ”€β”€ api/
β”‚   β”œβ”€β”€ webhooks/
β”‚   β”‚   └── helius/         # Ingest live transactions β†’ DB + alerts
β”‚   β”œβ”€β”€ tokens/
β”‚   β”‚   └── [mint]/         # Token data endpoint
β”‚   └── alerts/             # CRUD for user alerts
└── supabase/
    └── migrations/         # DB schema SQL

Database Schema

-- Tracked wallets per user
CREATE TABLE tracked_wallets (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  user_id uuid REFERENCES auth.users(id),
  wallet_address text NOT NULL,
  label text,
  created_at timestamptz DEFAULT now()
);

-- Live transaction feed
CREATE TABLE transactions (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  wallet_address text NOT NULL,
  signature text UNIQUE NOT NULL,
  type text CHECK (type IN ('buy', 'sell', 'transfer')),
  token_mint text,
  token_symbol text,
  amount_usd numeric,
  dex text,
  timestamp timestamptz NOT NULL
);

-- Token metadata cache
CREATE TABLE tokens (
  mint text PRIMARY KEY,
  name text,
  symbol text,
  price_usd numeric,
  volume_24h numeric,
  market_cap numeric,
  liquidity_usd numeric,
  holder_count integer,
  risk_score integer CHECK (risk_score BETWEEN 0 AND 100),
  updated_at timestamptz DEFAULT now()
);

-- User alerts
CREATE TABLE alerts (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  user_id uuid REFERENCES auth.users(id),
  type text CHECK (type IN ('price', 'whale', 'new_entry', 'volume')),
  token_mint text,
  wallet_address text,
  threshold numeric,
  active boolean DEFAULT true,
  created_at timestamptz DEFAULT now()
);

-- In-app notifications
CREATE TABLE notifications (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  user_id uuid REFERENCES auth.users(id),
  alert_id uuid REFERENCES alerts(id),
  message text NOT NULL,
  read boolean DEFAULT false,
  created_at timestamptz DEFAULT now()
);

How the Webhook Pipeline Works

Helius detects tx on tracked wallet
        ↓
POST /api/webhooks/helius
        ↓
Parse: buy/sell/transfer + token + USD value
        ↓
Insert into transactions table
        ↓
Check against active user alerts
        ↓
Match? β†’ Queue notification
        ↓
Supabase Realtime broadcast β†’ live UI update
        ↓
Email via Resend + Telegram bot (if enabled)

Upgrade Path

Solbeam is designed to scale with you β€” zero changes needed to the architecture.

Stage Users Monthly Cost What to upgrade
MVP 0–100 $0 Nothing
Growing 100–500 ~$25 Supabase Pro (more DB + bandwidth)
Revenue 500+ ~$75 Helius Growth + Supabase Pro
Scale 1000+ Self-sustaining Revenue covers infra comfortably

At just 4–8 paying subscribers at $10–20/mo, the app covers all infrastructure costs.


Roadmap

  • Project scaffolding + DB schema
  • Auth (Supabase email/password)
  • Live token feed (DexScreener + Jupiter)
  • Wallet tracker (Helius webhooks)
  • Token deep-dive page
  • Risk scoring engine
  • Alerts system (in-app + email)
  • Telegram bot integration
  • Smart money leaderboard
  • AI signal summaries (Claude API)
  • Public wallet pages
  • Tiered access / paywall

Contributing

Pull requests are welcome. For major changes, open an issue first.

  1. Fork the repo
  2. Create your branch (git checkout -b feature/my-feature)
  3. Commit your changes (git commit -m 'Add my feature')
  4. Push to the branch (git push origin feature/my-feature)
  5. Open a Pull Request

License

MIT β€” do whatever you want, just don't blame us if you get rekt on-chain.


Built with πŸ”† by someone tired of paying $99/mo for DeFi data that should be free.

About

Personal Solana memecoin intelligence dashboard

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors