Documentation

Overview

coldcases.fun is a real-time blockchain investigation and intelligence platform built on Solana. It aggregates on-chain data, exploit reports, community investigations, and token analytics into a single, unified dashboard.

Think of it as the intersection of a blockchain explorer, a threat intelligence feed, and a community tip line — designed for investigators, traders, and anyone who wants to understand what's really happening on-chain.

How It Works

The platform operates through three layers of data aggregation:

Key Features

Investigation Feed

The investigation feed is the centerpiece of the home canvas. It displays active and historical cases in an expandable accordion format, with each entry containing:

• Case ID — unique identifier for the investigation
• Date — when the case was opened or last updated
• Summary — brief description with linked wallet addresses and transaction hashes
• Source Links — references to original reports, Twitter threads, or on-chain evidence

Exploit Tracker

The exploit tracker monitors and catalogues security incidents across the Solana ecosystem. Each exploit entry includes:

• Protocol name and affected smart contracts
• Exploit type — reentrancy, flash loan, access control, rug pull, etc.
• Funds affected — estimated USD value of compromised assets
• Post-mortem links — analysis and remediation details

Scope (Live Tokens)

Scope is a real-time token monitoring dashboard that tracks the lifecycle of Solana tokens from creation to migration. It organizes tokens into three columns:

Real-Time Updates

Scope connects to a WebSocket server that streams the following event types:

// WebSocket message types
type ScopeMessage =
  | { type: "initial_tokens"; tokens: Record<Category, Token[]> }
  | { type: "new_token"; token: Token }
  | { type: "token_added"; token: Token; category: Category }
  | { type: "token_removed"; pairAddress: string }
  | { type: "price_update"; pairAddress: string; updates: Partial<Token> }
  | { type: "sol_price_update"; solPrice: number }
  | { type: "thumbnail_update"; pairAddress: string; thumbnail: string }

Token Card Data

Each token card in the Scope feed displays:

• Token ticker and name with clickable link to Solscan
• Price change (5m) — green for positive, red for negative
• Market cap — converted from SOL using live price
• Volume — trading volume in USD
• Buy/sell ratio — visual bar showing transaction sentiment
• Bonding curve progress — percentage toward migration threshold

Solana Explorer

The built-in explorer provides full Solana blockchain search capabilities. Enter any wallet address or transaction signature to look up detailed information.

Network Dashboard

The explorer home displays real-time network analytics:

• TPS — current transactions per second with historical chart
• Block height and current slot number
• Epoch progress — visual progress bar with slot count
• SOL supply — circulating vs total with stake distribution
• Trending tokens — top 24h tokens by volume with price data

Account Lookup

Search for any Solana address to see:

• SOL balance with USD conversion
• SPL token holdings (mint, balance, decimals)
• Transaction history with type, source, timestamp, and fee

Transaction Details

Look up any transaction signature to view:

• Transaction type and human-readable description
• Source program and slot number
• Timestamp and fee (in SOL)

Wallet Forensics

Wallet forensics is the process of tracing fund flows between Solana addresses to identify patterns of suspicious activity. The platform supports:

Transaction Tracing

Transaction tracing follows the path of funds across multiple hops to build a complete picture of where assets originated and where they ended up.

The platform uses Helius Enhanced Transactions API to provide enriched transaction data including:

• Human-readable transaction descriptions
• Program source identification (Jupiter, Raydium, Orca, etc.)
• Token transfer details with USD value estimates
• Account balance changes per instruction

Token Analysis

Token analysis tools help evaluate the legitimacy and risk profile of Solana tokens. Key indicators monitored by the platform:

Submit a Tip

The tip submission system allows anyone to report suspicious on-chain activity anonymously. Tips are reviewed by the community and integrated into active investigations when verified.

How to Submit

$COLD Token

$COLD is the native token of the coldcases.fun ecosystem on Solana. It serves as the platform's utility and community token.

Socials & Links

Architecture

coldcases.fun is built with a modern serverless stack optimized for real-time data delivery:

Request Flow

Client Request
    |
    v
Next.js API Route (/api/solana, /api/scope, /api/tips)
    |
    +---> Upstash Redis Cache (check TTL)
    |         |
    |         +---> Cache HIT: return cached data
    |         |
    |         +---> Cache MISS:
    |                   |
    |                   v
    |              Helius RPC / Birdeye API
    |                   |
    |                   v
    |              Cache response (TTL: 30-120s)
    |                   |
    v                   v
Client <------------ JSON Response

API Reference

The platform exposes internal API routes used by the frontend. These are not intended as a public API but are documented here for transparency.

GET /api/solana

Solana blockchain data endpoint. Supports multiple actions via query parameter.

# Fetch network overview + trending tokens
curl https://coldcases.fun/api/solana?action=bootstrap

# Look up a wallet address
curl https://coldcases.fun/api/solana?action=account&address=<WALLET_ADDRESS>

# Look up a transaction
curl https://coldcases.fun/api/solana?action=tx&sig=<TX_SIGNATURE>

GET /api/scope

Returns a snapshot of the current Scope feed data including all tracked tokens organized by category (newPairs, finalStretch, migrated), SOL price, and token counts.

POST /api/tips

Submit an anonymous tip. Accepts multipart form data.

Data Sources

coldcases.fun aggregates data from multiple sources to provide comprehensive blockchain intelligence: