V1 Documentation

Documentation

Architecture, roadmap, and what's coming next.

V2

Token Fee Scanner

Coming Soon

Someone is collecting fees on every token you trade. Drop any Solana or Base contract address and find out who, how much, and whether the money has been claimed.

Who Gets Paid

Paste a contract address. See which wallet collects the creator fees and trace their on-chain identity.

How Much

Earned, claimed, and unclaimed. Every number in native tokens with live USD conversion.

Claim Status

Three states: Claimed (fully collected), Partial (some collected, some remaining), and Unclaimed (nothing claimed yet).

Claim From Here

Connect your wallet and claim all your uncollected fees in one place. No more jumping between 10 different platforms.

In development. Solana and Base.
Telegram Bot

ClaimScan Bot

In Development

Your group chat just became a fee scanner. Paste any Solana or Base contract address and ClaimScan Bot replies with earned, claimed, and unclaimed fees instantly.

Paste a CA

Drop any Solana or Base contract address in the chat. The bot detects it automatically and replies with full fee data. No commands, no prefixes.

Handles & Wallets

Works with Twitter handles, GitHub usernames, and raw wallet addresses too. Drop it in, get the breakdown.

Full Breakdown

Earned, claimed, and unclaimed in native tokens plus USD. Claim status for every position. Inline buttons to view on ClaimScan or share on X.

In development. Groups and DMs. Solana and Base.
V1Whitepaper
Download PDF
01

What is ClaimScan?

You launched tokens. Platforms collected fees for you. But nobody told you where the money went. ClaimScan scans 9 launchpads across Solana and Base in real time, showing you exactly how much you've earned, what you've claimed, and what's still sitting uncollected on-chain.

“Your money is already on-chain. ClaimScan tells you where.”
9Platforms
2Chains
~40%Go Unclaimed
<30sScan Time
$0Always Free
24/7Always Live

Whether you launched on Pump.fun last week or Clanker six months ago. Enter your handle or wallet address and see exactly what's waiting for you. No signups. No wallet connection. Just answers.

02

The Creator Fee Problem

You launched a token on Pump.fun. A few on Clanker. Maybe one on Believe. Each platform deposited creator fees into different wallets, on different chains. You claimed some. You forgot about others. Some you never knew existed.

Fragmented Dashboards

9 platforms. 9 different dashboards. 9 different login flows. No creator checks all of them.

Cross-Chain Complexity

Solana and Base use different wallets, explorers, and token standards. Two separate workflows just to see what you're owed.

Identity Sprawl

Your Twitter handle, Farcaster account, 0x wallet, Solana address. All disconnected. No tool connects the dots.

Result: creator fees sitting unclaimed across DeFi. Yours included.

Think you might have unclaimed fees?

Scan Your Handle

Free. No signup. Takes 30 seconds.

03

How ClaimScan Solves It

One Search, All Platforms

Type your @handle. ClaimScan queries all 9 platforms simultaneously in seconds.

Cross-Chain Aggregation

Solana and Base in one view. No chain switching, no separate dashboards.

Real-Time Tracking

Live polling every 30 seconds. Leave the tab open. Numbers update automatically.

Identity Resolution

Enter a Twitter handle → wallets found. Farcaster name → all chains mapped.

USD Valuation

Live prices from CoinGecko, DexScreener, and Jupiter. Updated every 5 minutes.

Zero Cost

Free. Not freemium. We built ClaimScan as an internal tool and opened it up.

04

How It Works

From @handle to full fee breakdown in under 30 seconds.

1

You Enter a Handle

Twitter handle, Farcaster name, GitHub username, or raw wallet address.

2

We Find Your Wallets

Your social identity gets resolved to wallet addresses across both chains.

3

All 9 Platforms Scanned

Every supported launchpad queried simultaneously. No manual checking.

4

Fees Collected & Organized

Earned, claimed, partially claimed, and unclaimed fees pulled for every token. Duplicates filtered.

5

Converted to USD

Live price feeds turn raw token amounts into real dollar figures.

6

Live Dashboard Ready

Platform breakdown, chain breakdown, token-level details, updating every 30s.

All scanning is read-only. No wallet connection. No signatures. No transaction risk.
05

Supported Platforms

9 platforms across 2 blockchains. More coming in V2.

Solana6 Platforms
Pump.funLargest Solana memecoin launchpad
Bags.fmSocial token trading with creator fees
BelieveCommunity token launches with fee splits
RevShareOn-chain revenue sharing for token creators
CoinbarrelFast token launches with built-in fees
RaydiumSolana DEX, LP fee tracking
Base3 Platforms
ClankerBase-native memecoin launcher via Farcaster
ZoraCreator token minting with protocol rewards
BankrAI-powered trading with creator fee splits
+ More platforms coming in V2. Ethereum L1, Arbitrum, and more.
06

Architecture & Tech Stack

FRONTENDNext.js 16 + React 19 + Tailwind CSS v4
BLOCKCHAIN@solana/web3.js + viem (EVM/Base)
DATABASESupabase (PostgreSQL)
PRICE FEEDSCoinGecko, DexScreener, Jupiter API
IDENTITYNeynar API (Farcaster), Twitter API
MONITORINGSentry error tracking
DEPLOYMENTVercel Edge Network
TYPOGRAPHYExo 2 (headings) + JetBrains Mono

Database Schema

creators  →  wallets  →  fee_records
    |            |            |
identity     blockchain    per-token fees
resolution   addresses     & USD values

Key Architecture Decisions

In-flight deduplicationPrevents duplicate API calls for concurrent requests to the same creator.
30-second timeoutAll resolve operations timeout gracefully for serverless environments.
40-minute cache TTLCreator and fee data cached in Supabase. Fresh scans only trigger after TTL expires.
Dynamic dust filterPositions below $15 in unclaimed fees are skipped during claimed-amount computation. The threshold uses live SOL price from CoinGecko, adjusting automatically as prices change.
Multi-key API rotation10 API keys from separate accounts enable 10,000 requests/hour with round-robin rotation and per-key rate limit tracking.
Batched concurrencyAPI requests processed in batches of 40 to avoid connection overload on both bags.fm and Vercel.
Visibility-aware pollingLive polling stops when the browser tab is hidden, resuming on focus.
Privacy-first loggingAll search queries SHA256-hashed before storage. No raw PII stored.
07

Security & Privacy

We don't touch your wallet. We don't store your data. That's not a promise. It's the architecture.

Your Searches Stay Private

All search queries are SHA256 hashed before logging. Nobody can see who you looked up.

Nothing Runs in Your Browser

All sensitive operations run server-side. API keys never touch the client.

No Wallet Connection

100% read-only. No signatures. No approvals. Zero transaction risk.

No Data Collected

No personal data. No cookies. No tracking pixels. Just anonymized, hashed analytics.

Verify On-Chain

Every fee record can be independently verified on the blockchain. Nothing is fabricated.

08

What's Next

V1Current · March 2025
  • >9 platform support (Solana + Base)
  • >Multi-identity search (Twitter, GitHub, Farcaster, Wallet)
  • >Real-time fee polling with 30s intervals
  • >USD conversion with live price feeds
  • >Dynamic dust filtering ($15 threshold)
  • >Multi-key API rotation (10,000 req/hr)
  • >Privacy-preserving analytics (SHA256 hashed)
V2Coming Soon
  • Token Fee Scanner (paste any contract address)
  • Fee recipient discovery (who gets paid)
  • Earnings breakdown (earned, claimed, unclaimed in USD)
  • Tri-state claim status (claimed, partial, unclaimed)
  • Telegram Bot (paste CA in groups/DMs for instant fee data)
  • One-click claim across all platforms
  • Additional chain support (Ethereum L1, Arbitrum)
V32026+
  • Automated claim scheduling
  • Creator analytics & insights dashboard
  • Portfolio dashboard for multi-creator agencies
  • SDK for platform integrations

This is V1. We're just getting started.

09

Built by LW

4-person Web3 studio. 408+ projects shipped. Every build handled by the same team you talk to on Telegram. No layers, no outsourcing.

“We built ClaimScan because we needed it. Then we opened it to everyone.”
408+Projects Delivered
$1.6B+Market Cap Generated
LW-2201

Branding Specialist

Brand psychology, logos, visual identity

LW-2202

Frontend Developer

Websites, dApps, bots, dashboards

LW-2203

Backend Engineer

APIs, databases, contract integrations

LW-2204

Motion Designer

Promo videos, animated logos, TGS stickers

Ready to find your money?

Enter your handle. See what you're owed. Takes 30 seconds.

Scan Now

Free forever. No wallet connection needed.