Skip to content

LW-ARTS/claimscan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClaimScan

ClaimScan

Cross-chain creator fee scanner, claimer, and paid intelligence API for 12 DeFi launchpads on Solana, Base, Ethereum, and BNB Chain

Solana Base Ethereum BNB Chain Website

Live App · Docs · Whitepaper V1.5


What is ClaimScan?

ClaimScan is a free tool that scans and claims unclaimed creator fees across 12 DeFi launchpads on Solana, Base, Ethereum, and BNB Chain.

Around 40% of creator fees go unclaimed. Creators launch tokens, generate volume, earn fees, and never collect them. ClaimScan finds that money and lets you claim it.

Paste any @handle or wallet. Get a full breakdown in under 30 seconds.

ClaimScan Homepage

How It Works

  1. Paste a Twitter handle, TikTok URL, GitHub username, Farcaster name, or wallet address
  2. ClaimScan scans 12 launchpads across Solana, Base, Ethereum, and BNB Chain simultaneously
  3. Full breakdown: earned, claimed, unclaimed in USD with live pricing
  4. Connect your wallet and claim uncollected fees directly from ClaimScan

No signup. Read-only scanning. Zero-custody claiming. Always free.

ClaimScan creator profile - @finnbags scan result

Supported Platforms

Solana

Platform Features
Bags.fm Identity resolution, live polling, direct claim with Turnstile + priority fees
Pump.fun Historical + live fee tracking (V1 and V2 supported)
Believe Creator fee tracking
RevShare Revenue share scanning
Coinbarrel Fee discovery
Raydium LaunchLab LP fee tracking

Base + Ethereum + BNB Chain

Platform Chain Features
Clanker Base + BSC Farcaster identity + fee tracking across both chains
Zora Base + Ethereum Creator protocol rewards, cross-chain
Bankr Base + ETH + BSC Fee recipient tracking across three chains
Flaunch Base Per-coin fee breakdown via FeeEscrow, historical earnings on-chain
Flap.sh BSC Four vault types, fund-recipient auto-forwarded BNB fees surfaced on recipient profile
Klik Ethereum + Base Creator fee tracking with Base 50% creator-share detection, ENS + Farcaster + Twitter identity resolution for 506+ indexed creators

Features

Scanning

  • 4 chains: Solana, Base, Ethereum, and BNB Chain in a single scan
  • Identity resolution: Twitter, TikTok, GitHub, Farcaster handles, ENS, and raw wallet addresses
  • Real-time streaming: Scan progress updates as each platform completes via SSE
  • True real time fees: The unclaimed total, the status filter, and the token list all read from the same live data stream. What you see and what you can act on are always in sync. Tokens appear within seconds of being detected on chain instead of waiting for the next sync.
  • Dynamic dust filter: Filters noise using live token prices
  • Shareable receipts: OG image cards for social sharing
  • Privacy-first: Searches anonymized before logging

Leaderboard

  • Public creator ranking at claimscan.tech/leaderboard ordered by total fees earned across all 12 platforms
  • Filter chips for platform and chain that scroll horizontally on mobile and wrap on desktop
  • Deep linkable filter state, share a filtered view by URL
  • Mobile cards with creator avatars, rank trophy for the top 3, and proper responsive sizing down to 360px wide
  • Pagination scrolls back to the top automatically on page change
  • Dynamic Open Graph image for the leaderboard route, share the live ranking on socials
ClaimScan Leaderboard - Top creator fee earners

UI and UX

  • Visual redesign v2 with consistent spacing, typography, color tokens, and motion across every page
  • Per route skeleton loading states for home, docs, terms, leaderboard, and creator profiles. No more blank flashes during navigation.
  • Mobile first down to 360px wide. Hover utilities have tap mirrors so phones get the same visual feedback as desktop hover.
  • Animation system with shared duration tokens, easing curves, and full prefers-reduced-motion support so users who opt out of animation still get a great experience.
  • Dynamic Open Graph images per creator profile and per leaderboard route. Share any handle, see a beautiful preview card.
  • Tight currency typography with proper digit alignment so values render correctly at every size.
ClaimScan dynamic OG card for @finnbags profile

Claiming (V1.5) ✦ Bags.fm Live

V1.5 is the update where ClaimScan went from read-only scanner to full claimer. Bags.fm is the first platform with direct on-chain claiming built in. No third-party custody, no approvals, no token permissions. Connect your wallet, review the simulation, sign, done.

How the claim flow works:

  1. ClaimScan detects unclaimed fees on Bags.fm for your wallet
  2. A claim transaction is built server-side with optimized compute units
  3. The transaction is simulated before it ever reaches your wallet
  4. You review and sign in your own wallet (Phantom, Backpack, Ledger, or any Wallet Standard compatible wallet)
  5. ClaimScan tracks the transaction from submission through on-chain finalization
  6. Claim status updates in real time: pending → signing → submitted → confirmed → finalized

Claim architecture:

  • Zero-custody: Your keys never leave your wallet. Transactions are constructed server-side but signed exclusively client-side
  • Pre-sign simulation: Every transaction is simulated on-chain before the wallet prompt appears, so failed claims are caught before you spend gas
  • Priority fees: Dynamic compute unit pricing calibrated per transaction for reliable confirmation, even during network congestion
  • Turnstile-gated: Every claim request is verified through Cloudflare Turnstile to prevent bot abuse and replay attacks
  • Finalization tracking: Claims are tracked end-to-end with immutable state transitions. Once finalized, a claim cannot be reverted or replayed
  • Cryptographic verification: Claim requests are signed and verified at every step, from client to server to chain
  • Hardware wallet support: Full compatibility with Ledger and other hardware signers
  • Auto-discovery: Wallet detection via Wallet Standard protocol. No manual wallet imports needed

More platforms coming in V3. Bags.fm is just the start.

V2 API: Paid Intelligence for Agents and Developers ✦ New

ClaimScan V2 introduces a paid API powered by the x402 protocol. Any developer, bot, or AI agent can query ClaimScan data and pay per request in USDC. No API keys, no subscriptions, no accounts. Just pay and receive.

Endpoints:

Endpoint Price What you get
GET /api/v2/fees?wallet=<address> $0.01 Full fee report across all 12 platforms and 4 chains
GET /api/v2/export?wallet=<address> $0.05 CSV or JSON export of all fee records
GET /api/v2/intelligence?wallet=<address> $0.02 Intelligence report: ClaimScan fees + Allium cross-chain enrichment
GET /api/v2/resolve?ows_wallet=<name> $0.01 Resolve an OWS wallet name into multi-chain addresses

How it works:

  1. An agent or developer makes a request to any paid endpoint
  2. ClaimScan responds with HTTP 402 (Payment Required)
  3. The client signs a USDC payment on Base Mainnet automatically
  4. ClaimScan verifies the payment via facilitator and returns the data

All endpoints are discoverable through the x402 bazaar extension. An AI agent can find ClaimScan, read the input/output schema, pay, and consume the data without any human setup.

Built into the protocol layer:

  • Bazaar discovery: Every paid endpoint publishes its schema so AI agents can find and use it autonomously
  • Idempotency: Payment-identifier extension prevents duplicate charges when clients retry
  • Payment observability: Every verify, settle, and failure event is logged with structured tracing and forwarded to Sentry

Compatible with OWS (Open Wallet Standard) for seamless agent access:

ows pay request "https://claimscan.tech/api/v2/intelligence?wallet=0x..." --wallet my-agent

Powered by:

  • x402 for trustless per-request payments in USDC on Base Mainnet
  • Allium for cross-chain transaction history, PnL, and portfolio context
  • OWS for multi-chain wallet identity and agent-friendly authentication

Security

  • Defense in depth: Multiple layers of abuse prevention across all endpoints
  • Bot protection: Turnstile verification on sensitive operations
  • Request signing: All client-server communication cryptographically signed
  • Zero-custody claiming: Transactions signed exclusively in user wallets
  • Tamper-proof claims: Claim states are immutable once finalized
  • On-chain verifiable: Every fee record independently verifiable on-chain
  • Anti-enumeration: Rate-limited identity resolution prevents scraping
  • Honeypot endpoints: Fake data traps to detect and fingerprint scrapers
  • CSV injection protection: All export values sanitized against formula injection before reaching spreadsheets

Performance

  • Fast scans: All routes optimized for parallel execution across 4 chains
  • Smart caching: Multi-layer caching (Redis + DB) keeps data fresh without hammering the chain
  • Background indexing: Automated token discovery via Helius DAS webhooks
  • Graceful degradation: Partial results instead of timeouts
  • SSE streaming: Real-time scan progress and live fee updates via Server-Sent Events

Tech Stack

Layer Technology
Framework Next.js + React + TypeScript
Styling Tailwind CSS + Radix UI + Motion
Blockchain Solana (web3.js) + EVM (Viem)
Database Supabase (PostgreSQL with row-level security)
Cache Redis with in-memory fallback
Identity Cross-platform resolution (Twitter, TikTok, GitHub, Farcaster, wallets)
Pricing Multi-source aggregation (DexScreener, Jupiter, CoinGecko)
Payments x402 protocol (USDC on Base Mainnet) + bazaar discovery + payment-identifier
Intelligence Allium (cross-chain wallet data)
Wallet Standard OWS (Open Wallet Standard) for agent access
Monitoring Sentry + structured logging
Security Turnstile + HMAC signing + rate limiting + honeypots
Deploy Vercel (Serverless)

Stats

  • 12 launchpads supported
  • 4 chains (Solana + Base + Ethereum + BNB Chain)
  • Under 30 second scan time
  • $0 to scan and claim (always free)
  • Paid API starting at $0.01 per query

Roadmap

Version Status Highlights
V1.0 Live First launchpads, cross-chain scanning, identity resolution
V1.5 Live First on-chain claim flow (Bags.fm), Turnstile + priority fees, defense-in-depth security, Helius DAS indexing
V2.0 Live Raydium LaunchLab support, 4 chains (added ETH + BSC), paid API via x402 on Base Mainnet, Allium intelligence, OWS wallet support, Pump.fun V2
V2.1 Live x402 hardening: bazaar extension for agent discovery, payment-identifier for idempotency, lifecycle hooks, CSV injection protection, mainnet facilitator
V2.5 Live Visual redesign v2, real time live fees architecture, leaderboard polish, mobile first pass, skeleton loading states, animation system, hardening pass. Read the full release notes.
V2.6 Live TikTok profile search powered by Bags.fm TikTok Fee Sharing, fee sync reliability pass (per creator distributed lock, Sentry routing for prune failures, batch DELETE with tripwire), GitHub leaderboard navigation fix. Read the full release notes.
V2.7 Live Flaunch.gg as 10th launchpad, per-coin fee breakdown on Base via FeeEscrow (historical earnings read on-chain), Sentry error monitoring restored after malformed DSN was silently dropping events for 30 days. Read the full release notes.
V2.8 Live Flap.sh as 11th launchpad (first BSC-native platform), fund-recipient vault type surfaces auto-forwarded BNB fees that were previously invisible, Unicode-aware token symbols for CJK and emoji tickers across all views. Read the full release notes.
V2.9 Live Klik as 12th launchpad (Ethereum + Base), dual-chain identity resolution indexer (ENS + Farcaster + Twitter), 506 creators indexed at launch, daily cron, circuit breaker, Flap.sh cron backlog fix. Read the full release notes.
V3 Next Token Fee Scanner (paste any contract address), in-app EVM claims via unified wallet adapter (Solana and EVM in one modal), covers Clanker, Zora, Bankr, Flaunch, and Flap
V3.5 Planned Automated claim scheduling, creator analytics, portfolio dashboard

Built By

LW ARTS · @lwartss · t.me/lwarts

Fullstack Web3 studio. 408+ crypto projects delivered. $1.6B+ in market cap generated.

License

Proprietary. All Rights Reserved. See LICENSE for full terms. View-only for personal reference. No use, copy, deploy, or derivative works without written permission from LW ARTS.

About

Free cross-chain creator fee scanner + claimer + paid intelligence API. 13 launchpads, 7 chains (Solana, Base, Ethereum, BNB), under 30 seconds.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors