Token Link Drop - Chingadrop.xyz

🚀 Get Started

Create and manage your token distribution campaigns

📋 About

A secure token distribution system using one-time and multi-claim links. Built for ERC-20 tokens with hot wallet backend integration, ENS support, and Supabase database management.

🔗 One-Time Links

Generate unique URLs that can only be used once to claim tokens

🔄 Multi-Claim Links

Create links that allow multiple wallets to claim (e.g., 10 claims of 10 tokens each)

🏷️ Campaign System

Organize drops by campaigns - wallets can claim from multiple campaigns

🏷️ ENS Support

Users can claim using ENS names (e.g., vitalik.eth) instead of wallet addresses

🛡️ Secure Claims

Atomic reservations prevent double-spending with automatic rollback

💰 Balance Check

Pre-transfer balance verification prevents gas waste on failed transactions

📊 Transaction History

View claim details with direct links to blockchain explorers

⏰ Expirable

Set custom expiration times for each batch of links

🔐 Admin Protected

Link generation requires admin authentication

👤 User Dashboard

Web interface for users to create and manage their own campaigns

🚀 API Endpoints

POST/api/generate

Generate new single-use claim links (requires admin token)

POST/api/generate-multi

Generate new multi-claim links - allows multiple wallets to claim (requires admin token)

POST/api/claim

Process token claim from a valid link (supports ENS resolution)

GET/claim/:id

Claim page with user-friendly interface, progress tracking for multi-claims

GET/dashboard

Campaign management dashboard - create and manage your own drops

💼 Usage Examples

Single-Use Claims

curl -X POST https://chingadrop.xyz/api/generate \
  -H "Content-Type: application/json" \
  -H "x-admin-token: YOUR_ADMIN_TOKEN" \
  -d '{"count": 10, "amount": 50, "expiresInHours": 24, "campaign_id": "launch-drop"}'

Multi-Claim Links

curl -X POST https://chingadrop.xyz/api/generate-multi \
  -H "Content-Type: application/json" \
  -H "x-admin-token: YOUR_ADMIN_TOKEN" \
  -d '{"count": 1, "amount": 10, "maxClaims": 20, "expiresInHours": 48, "campaign_id": "community-rewards"}'

Claiming with ENS

• Visit /claim/:id
• Enter wallet address: 0xabc123... or ENS name: vitalik.eth
• System automatically resolves ENS to address
• Balance checked before transfer to prevent gas waste

⚙️ Configuration

Multi-chain system supporting:

🔴 Optimism: Layer 2 scaling solution (Original network)
🔵 Arbitrum One: Optimistic rollup with fast withdrawals
🔷 Base: Coinbase's Layer 2 built on OP Stack
📜 Scroll: zkEVM-based Layer 2 solution
🟫 Mantle: Modular Layer 2 with native yield
🟣 Monad Testnet: High-performance EVM-compatible Layer 1
Database: Supabase Connected

🆕 Recent Updates

🌐 Multi-Chain Support: Full support for Optimism, Arbitrum, Base, Scroll, and Mantle networks
🎯 Network Detection: Automatic detection of connected wallet network with real-time updates
⚙️ Dynamic RPCs: Smart routing to correct RPC endpoints based on campaign network
Campaign System: Organize drops by campaigns - wallets can participate in multiple campaigns
Multi-Claim Links: Create links that allow multiple different wallets to claim
ENS Resolution: Users can claim using ENS names like vitalik.eth
Balance Verification: Pre-transfer checks prevent failed transactions and gas waste
Transaction History: Already-claimed errors show transaction hash and explorer links

🙏 Credits & Acknowledgments

🤖 Development

Claude Code
AI-powered development

ChatGPT
AI assistance & optimization

🌐 Community

criptochingaderas.com
Web3 education & resources

⚡ Technology

Ethers.js
Blockchain interaction

Supabase
Database & backend

Vercel
Deployment platform