The platform where crypto content creators get tipped by humans AND autonomous AI agents.

BlinkTip makes it easy for crypto creators on Twitter to receive tips via Solana Blinks and Celo, while an autonomous AI agent evaluates and rewards creators based on their influence and authenticity.

• The Problem
• The Solution
• How It Works
• Platform Features
• Technology Stack
• Project Structure
• Getting Started
• Running the AI Agent
• API Reference
• Deployment

There's no universal, easy way to tip creators on the internet.

Imagine you're a content creator with Instagram, TikTok, Twitter/X, Farcaster, Medium, and more. Your audience is scattered across all these platforms:

• On Instagram/TikTok: Most followers don't know crypto. You use "link in bio" for PayPal, Venmo, or CashApp
• On Twitter/X: Maybe you drop your ENS or Solana address for on-chain tips, but only crypto natives understand that
• On other platforms: Same fragmented mess - different payment methods everywhere
• For AI agents: No way for autonomous agents to discover and tip you for your content

The result? You need multiple payment links, multiple bios, and you're invisible to the emerging world of autonomous AI agents that could reward quality content.

There's no single, universal tip link that works EVERYWHERE and accepts payments from ANYONE - humans AND AI agents.

BlinkTip gives creators ONE universal tip link that works everywhere.

1. Creator signs up with their Solana and/or Celo wallet
2. Gets ONE universal tip link: blink-tip.vercel.app/tip/nellycyberpro
3. Shares it EVERYWHERE: Instagram bio, TikTok bio, Twitter profile, Farcaster, Medium articles, email signature, anywhere
4. Anyone can tip - humans and AI agents alike, on Solana or Celo

On Twitter/X (Solana Blinks)

https://blink-tip.vercel.app/tip/nellycyberpro
→ Unfurls as an interactive Solana Blink once action is registered
→ Followers click and tip instantly without leaving Twitter
→ Powered by Solana Actions

See it live

Everywhere Else (x402 Protocol)

When someone clicks your tip link from Instagram, TikTok, Medium, or anywhere else:

1. Click tip link → Choose blockchain (Solana or Celo)
2. Browser sends GET request
3. Server returns 402 Payment Required with payment instructions
4. User creates transaction (Solana or EVM) via x402 client
5. Transaction signed → Submitted with X-PAYMENT header
6. Payment verified on-chain → Tip complete

Multi-Chain Support:

• Solana: USDC, Phantom CASH (working with x402)
• Celo: cUSD, USDC (ERC-2612 Permit / ERC-3009 TransferWithAuthorization)

The game-changer: AI agents can autonomously use the same x402 flow. An AI agent crawling the web can find your helpful Medium article, see your tip link, and autonomously send a tip via x402 on either blockchain without ANY human intervention.

BlinkTip includes a Claude Sonnet 4-powered autonomous agent that:

• Discovers registered creators from the platform
• Analyzes their crypto influence (Kaito Yaps API) and social metrics
• Decides who to tip using AI reasoning (authenticity, engagement, influence)
• Tips directly from its own CDP wallet using the same x402 infrastructure
• Records all decisions transparently

This demonstrates how ANY autonomous agent can discover and reward creators using x402 - whether they're on Twitter, Medium, personal blogs, or anywhere else on the internet.

1. Sign up at blink-tip.vercel.app/register

   • Connect Twitter via OAuth 2.0
   • Connect your Solana wallet
   • Optionally connect your Celo wallet for EVM chain support

2. Get your universal tip link: blink-tip.vercel.app/tip/yourhandle

3. Share it EVERYWHERE:

   • Instagram bio: "Tip me: blink-tip.vercel.app/tip/yourhandle"
   • TikTok bio: Same link
   • Twitter bio: Link unfurls as interactive Blink
   • Medium articles: Add at the end of posts
   • Email signature: Include your tip link
   • Personal website: Link from any page

4. Receive tips directly to your wallet from:

   • Humans on any platform (they choose blockchain and token)
   • Autonomous AI agents discovering your content
   • Solana: USDC, Phantom CASH
   • Celo: cUSD, USDC

On Twitter/X:

• See creator's Blink unfurl in timeline
• Click to tip (no leaving Twitter)
• Sign transaction with your Solana wallet
• Done

On Any Other Platform:

• Click creator's tip link from Instagram, TikTok, etc.
• Choose blockchain: Solana or Celo
• Choose tip amount and token:
  • Solana: USDC or Phantom CASH 👻
  • Celo: cUSD or USDC
• Browser creates x402 payment transaction
• Sign with your wallet (gasless on Celo via Permit/Authorization)
• Payment verified on-chain
• Creator receives tip

How ANY AI Agent Can Tip:

1. Agent discovers creator's tip link (on Medium, personal blog, anywhere)
2. Agent sends GET request → receives 402 Payment Required + payment details
3. Agent builds Solana transaction from payment requirements
4. Agent signs transaction with its own wallet
5. Agent submits with X-PAYMENT header → verified on-chain
6. Creator receives tip

BlinkTip's Built-in Agent:

Our platform demonstrates this with a Claude Sonnet 4-powered agent:

1. Fetches all registered creators from platform
2. Analyzes crypto influence (Kaito Yaps) + Twitter metrics
3. AI decides who to tip based on authenticity and engagement
4. Tips via x402 using its CDP wallet
5. Logs all decisions transparently

• View all tips received (human + agent)
• See agent decision reasoning
• Track total earnings
• Monitor tip frequency

• Display creator bio and stats
• Show recent tips
• Link to Twitter profile
• Display Solana wallet for direct tips

• All agent decisions logged publicly
• View why agent tipped or skipped
• See Kaito Yaps scores at decision time
• Track agent wallet balance and activity

• Auto-generated for each creator
• Unfurl beautifully on Twitter
• Support custom tip amounts
• Powered by x402 protocol

Solana

• USDC: Circle's USD stablecoin (standard)
• Phantom CASH: New USD stablecoin by Phantom/Bridge/Stripe
  • Launched Sept 2025
  • 1:1 USD-pegged
  • Gasless swaps in Phantom wallet
  • Perfect for Phantom wallet users

Celo

• cUSD: Celo Dollar (native stablecoin, 18 decimals)
• USDC: Circle's USDC on Celo (6 decimals)
• Gasless transfers via ERC-2612 Permit & ERC-3009 TransferWithAuthorization
• Mobile-first blockchain optimized for micropayments

Supporters choose their preferred blockchain and token when tipping. All tokens work seamlessly with x402 protocol.

• Framework: Next.js 15 (App Router)
• UI: React 19, Tailwind CSS
• Auth: NextAuth.js with Twitter OAuth 2.0
• Wallets: Solana Wallet Adapter, thirdweb React SDK (EVM)

• API: Next.js API routes
• Database: Supabase (PostgreSQL)
• Payments: x402 protocol on Solana & Celo
• Agent Wallet: Coinbase Developer Platform (CDP) SDK

• Networks:
  • Solana (Devnet for testing, Mainnet ready)
  • Celo Sepolia (Testnet)
• Tokens:
  • Solana: USDC & Phantom CASH (SPL stablecoins)
  • Celo: cUSD & USDC (ERC-20 stablecoins)
• Payment Protocol: x402 with facilitator verification
• Gasless Payments: ERC-2612 Permit & ERC-3009 TransferWithAuthorization on Celo

• Model: Claude Sonnet 4 (via OpenRouter)
• Influence API: Kaito Yaps
• Wallet: CDP server-side wallet

• Node.js 18+
• pnpm
• Coinbase Developer Platform account (for agent wallet)
• OpenRouter API key (for AI agent)
• Kaito API key (for influence scores)
• Twitter Developer account (for OAuth)
• thirdweb API key (for Celo x402 support)

# Clone the repository
git clone https://github.com/wamimi/BlinkTip.git
cd BlinkTip

# Install dependencies
pnpm install

# Copy environment template
cp .env.example .env

# Configure environment variables (see below)

# Run development server
pnpm dev

Visit http://localhost:3000

Create a .env file with:

# Database (Supabase)
NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# Twitter OAuth (NextAuth)
TWITTER_CLIENT_ID=your-twitter-client-id
TWITTER_CLIENT_SECRET=your-twitter-client-secret
NEXTAUTH_SECRET=your-nextauth-secret
NEXTAUTH_URL=http://localhost:3000

# Solana
SOLANA_RPC_URL=https://api.devnet.solana.com
NEXT_PUBLIC_NETWORK=solana-devnet

# x402 Protocol
NEXT_PUBLIC_FACILITATOR_URL=https://facilitator.payai.network

# Celo & thirdweb
NEXT_PUBLIC_THIRDWEB_CLIENT_ID=your-thirdweb-client-id
THIRDWEB_SECRET_KEY=your-thirdweb-secret-key
THIRDWEB_SERVER_WALLET=your-server-wallet-address

# CDP Agent Wallet
CDP_API_KEY_NAME=your-cdp-api-key
CDP_API_KEY_PRIVATE_KEY=your-cdp-private-key

# AI Agent
OPENROUTER_API_KEY=your-openrouter-key

# Platform
NEXT_PUBLIC_BASE_URL=http://localhost:3000

Run the Supabase migrations:

-- See database/migrations/ for full schema
-- Key tables:
-- - creators (user profiles with multi-chain wallet support)
-- - tips (all tips, human + agent, multi-chain)
-- - agent_actions (agent decision log)

-- Run migrations:
-- 1. Initial schema: database/migrations/initial_schema.sql
-- 2. Celo support: database/migrations/add_celo_support.sql

The autonomous agent can be triggered via API:

# Trigger agent run
curl -X POST http://localhost:3000/api/agent/run

# Check agent wallet
curl http://localhost:3000/api/agent/wallet

# View agent decisions
curl http://localhost:3000/api/agent/decisions

For automated runs, set up a cron job:

# Run every 6 hours
0 */6 * * * curl -X POST https://blink-tip.vercel.app/api/agent/run

See agent/README.md for detailed agent documentation.

BlinkTip/
├── app/                                    # Next.js App Router
│   ├── page.tsx                           # Homepage
│   ├── register/                          # Creator registration flow
│   │   └── page.tsx                       # Twitter OAuth + multi-chain wallet connection
│   ├── tip/[slug]/                        # Tipping pages (Multi-chain)
│   │   └── page.tsx                       # x402-powered tipping UI (Solana + Celo)
│   ├── creators/                          # Public creator profiles
│   └── api/                               # API routes
│       ├── auth/[...nextauth]/            # NextAuth Twitter OAuth
│       ├── creators/                      # Creator CRUD operations (multi-chain)
│       ├── tips/                          # Tip recording (multi-chain)
│       ├── x402/                          # x402 payment endpoints
│       │   └── tip/[slug]/
│       │       ├── pay-solana/            # Solana payment handler
│       │       └── pay-celo/              # Celo payment handler (ERC-2612/3009)
│       └── agent/                         # Agent API routes
│           ├── run/                       # Trigger agent run
│           ├── wallet/                    # Agent wallet info
│           ├── tips/                      # Agent tip recording
│           └── decisions/                 # Agent decision logging
│
├── agent/                                  # Autonomous AI Agent
│   ├── lib/
│   │   ├── agent.ts                       # Main agent orchestration (multi-chain)
│   │   └── services/
│   │       ├── solana/                    # Solana-specific services
│   │       │   ├── cdp-wallet.ts          # CDP wallet management
│   │       │   ├── cdp-tipper.ts          # Production tipping (WORKING)
│   │       │   └── x402-tipper.ts         # Experimental x402 (not working yet)
│   │       ├── celo/                      # Celo-specific services
│   │       │   ├── wallet.ts              # Celo wallet management
│   │       │   └── tipper.ts              # Celo tipping service
│   │       ├── kaito.ts                   # Kaito Yaps API
│   │       ├── openrouter.ts              # AI model integration
│   │       └── database.ts                # Database operations
│   └── README.md                          # Agent documentation
│
├── database/                              # Database migrations
│   └── migrations/
│       ├── initial_schema.sql             # Initial Solana-only schema
│       └── add_celo_support.sql           # Multi-chain migration
│
├── components/                            # React components
│   ├── WalletProvider.tsx                # Solana wallet setup
│   └── AuthProvider.tsx                  # NextAuth session provider
│
├── lib/                                   # Shared utilities
├── public/                                # Static assets
└── README.md                             # This file

List all registered creators

Get specific creator by slug

Register new creator (requires Twitter OAuth)

Returns 402 with payment requirements for Solana x402 flow

Returns 402 with payment requirements for Celo x402 flow (ERC-2612 Permit or ERC-3009)

Verifies Solana payment and records tip (requires X-PAYMENT header)

Verifies Celo payment and records tip (requires X-PAYMENT header)

Get agent wallet address and balance

Trigger agent to analyze creators and tip

List all agent decisions (TIP and SKIP)

# Install Vercel CLI
pnpm install -g vercel

# Deploy
vercel

# Add environment variables in Vercel dashboard
# Configure production domain

Add to vercel.json:

{
  "crons": [
    {
      "path": "/api/agent/run",
      "schedule": "0 */6 * * *"
    }
  ]
}

This runs the agent every 6 hours automatically.

• Creator registration with Twitter OAuth
• x402-powered tipping on Solana
• Solana Blinks for Twitter unfurling
• Autonomous AI agent with CDP wallet
• Kaito Yaps influence scoring
• Agent decision transparency

• Multi-chain support (Celo)
• ERC-2612 Permit & ERC-3009 TransferWithAuthorization
• Multi-token support (cUSD, USDC on Celo)
• Complete x402 server-side agent integration
• Resolve thirdweb facilitator payment routing
• Creator dashboard with analytics
• Agent tip notifications (Twitter DM)
• Dynamic tip amounts based on influence

• Mainnet deployment (Solana & Celo)
• Enhanced AI decision-making
• Creator reputation scores
• Community governance
• Additional EVM chains (Base, Optimism, Arbitrum)

The thirdweb facilitator overrides the payTo parameter to route all payments through the server wallet address instead of directly to creators. This causes "invalid signature" errors because the user's Permit/TransferWithAuthorization signature is for the wrong spender.

Status: Investigating with thirdweb team on Discord. May need to:

• Accept server-first architecture and redistribute to creators
• Build custom x402 implementation without thirdweb facilitator
• Or revert to direct ERC-20 transfers for Celo

See CELO_INTEGRATION.md for detailed technical analysis.

The autonomous agent's x402 integration is not working due to a Solana transaction validation error. See agent/README.md for details. Currently using direct CDP wallet transfers.

• Solana: Currently configured for Devnet
• Celo: Currently on Sepolia Testnet
• Mainnet deployment requires CDP fee payer setup and production wallet configuration

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Areas we'd love help with:

• x402 server-side Solana transaction format
• Enhanced AI decision-making algorithms
• UI/UX improvements
• Documentation

• x402 Specification
• x402-solana Package
• Pay AI Facilitator
• thirdweb x402 Docs

• Solana Blinks
• Solana Explorer
• SPL Token Program

• Celo Docs
• Celo Explorer
• ERC-2612 Permit
• ERC-3009 TransferWithAuthorization

• Kaito AI
• OpenRouter
• Claude (Anthropic)

• CDP Documentation
• CDP Wallets

MIT License - see LICENSE for details