awesome-x402

🚀 Curated list of x402 resources: HTTP 402 Payment Required protocol for blockchain payments, crypto micropayments, AI agents, API monetization. Includes SDKs (TypeScript, Python, Rust), examples, facilitators (Coinbase, Cloudflare), MCP integration, tutorials. Accept USDC payments with one line of code. Perfect for AI agent economy.
https://github.com/xpaysh/awesome-x402

Last synced: 5 days ago
JSON representation

Awesome Lists
- Issue Guidelines
  - Awesome Crypto - Cryptography resources.
  - Awesome Ethereum - Ethereum development.
  - sindresorhus/awesome - The awesome list of awesome lists.
  - Awesome Web3 - Web3 development.
  - Awesome Blockchain - Blockchain resources.
🔗 Related Protocols
- Payment Protocols
  - Lightning Network - Bitcoin Layer 2 micropayments.
  - Request Network - Payment request protocol.
  - Stellar Anchors - Cross-border payments.
- Web Standards
  - ERC-20 - Token standard.
- Historical Reference
  - HTTP 402 Proposal - Original RFC (1999).
  - 21.co Micropayments - Early Bitcoin micropayment attempt (2015).
- AI & Agent Protocols
  - Agent Protocol (AP2) - Agent communication standard.
  - OpenAI Function Calling - Tool use API.
🔒 Security & Audits
- Bug Bounty Programs
  - Coinbase Bug Bounty - Report x402 vulnerabilities for rewards up to $50,000.
- Security Best Practices
  - x402 Security Checklist - Production deployment security requirements.
  - Payment Verification Guide - Proper payment verification implementation.
  - Key Management - Secure private key handling for automated payments.
- Known Vulnerabilities & Mitigations
  - CVE Database - Known vulnerabilities and patches.
  - Replay Attack Prevention - Nonce and deadline handling.
- Security Monitoring
  - Rate Limiting Tools - Prevent abuse and ensure service availability.
🔨 Tools & Utilities
- CLI Tools
  - Foundry - Smart contract development toolkit.
🛠️ SDKs & Client Libraries
- JavaScript/TypeScript
  - viem - TypeScript library used for signing payments.
  - x402-got - Got HTTP client integration.
- Rust
  - alloy - High-performance Ethereum library.
📖 Protocol Documentation
- EIP-3009 TransferWithAuthorization - Gasless transfer standard used by x402.
- Verification & Settlement - Payment validation process.
- How x402 Works - Complete payment flow explanation with diagrams.
- HTTP 402 Status Code - The long-dormant HTTP status.
🏭 Production Implementations
- High-Volume Production Deployments
  - Cloudflare Workers - Edge computing platform with x402 integration serving global distributed payment verification at scale across 300+ data centers.
  - AIsa - Leading x402 payment processor with **10.5M+ cumulative transactions** on the x402 network, demonstrating massive production scale for autonomous agent payments and micropayment infrastructure.
  - Bitget - Major cryptocurrency exchange integrating x402 for seamless payment flows, enabling instant settlements and gasless transfers for trading operations.
🌟 Ecosystem Projects
- DeFi & Finance
  - Chainlink VRF - Random NFT minting with payment demo.
  - Cred Protocol - Decentralized credit scoring.
- Infrastructure
  - thirdweb Nebula - AI agent transaction framework.
  - Coinbase Developer Platform - Hosted facilitator service with enterprise-grade reliability and instant settlement.
- Tools & Services
  - Apexti Toolbelt - 1,500+ Web3 APIs via x402 MCP servers.
  - BuffetPay - Smart x402 payments with guardrails.
  - AIAgentStore.ai - Insights for founders with x402 payments.
- Developer Tools
  - Boosty Labs - AI agents buying real-time insights.
🏗️ Facilitators
- Self-Hosted Facilitators
  - Running Your Own Facilitator - Setup guide.
- Rust
  - Cloudflare x402 - Edge computing facilitator on Base/Ethereum with deferred settlement.
  - BNB Chain Pieverse - BNB Chain facilitator with instant settlement.
🤖 AI Agent Integration
- Agent-to-Agent (A2A)
  - Google A2A x402 Extension - Agent commerce protocol.
- Model Context Protocol (MCP)
  - MCP Server Setup Guide - Complete installation instructions.
- Agent Frameworks
  - NEAR AI - Cross-chain agent settlements.
  - Phidata Agents - Multi-modal agents with x402.
💡 Example Applications
- Full-Stack Applications
  - Video Paywall - Premium content access tutorial.
  - Weather API Service - Simple paid API endpoint.
  - Farcaster Mini App - Social app integration.
- API Examples
  - REST API with Auth Pricing - SIWE + dynamic pricing.
- Client Examples
  - Axios Client - Automatic payment handling.
  - Fetch Client - Fetch API wrapper demo.
🎯 Quick Start - Become an x402 Champion
- 5-Minute Quickstart - Accept your first payment.
📚 Official Resources
- Protocol Specifications - Detailed technical specifications.
- Payment Schemes - Different payment flow types.
- EVM Implementation - Ethereum Virtual Machine specifics.
- x402 Foundation - Protocol foundation website with overview and documentation.
🚀 Quickstart Guides
- Buyer/Client Setup - Make automated payments.
- One-Line Integration - Add payment middleware in a single line of code.
- Base Sepolia Testnet Setup - Get test USDC and start testing.
⚙️ Protocol Implementations
- TypeScript/JavaScript
  - x402-typescript - Complete TypeScript implementation.
  - x402-express - Express.js middleware example.
- Python
  - x402 - Python SDK on PyPI.
- Rust
  - x402-reqwest - Reqwest HTTP client wrapper.
🔧 Server Frameworks & Middleware
- Node.js/TypeScript
  - x402-next - App Router middleware.
  - Next.js route protection - Complete app example.
  - Mainnet production example - Base mainnet ready.
  - Browser wallet example - React + Hono full-stack.
- Python
  - FastAPI example - Complete implementation.
🧪 Testing & Development
- Testnets
  - Base Sepolia Testnet - Primary testnet.
  - Base Sepolia USDC Faucet - Get test USDC.
  - Base Sepolia Bridge - Bridge test ETH.
🎥 Videos & Talks
- Official Videos
  - Introducing x402 - Coinbase - Protocol announcement.
  - x402 Deep Dive - Technical explanation.
  - Building with x402 - Developer walkthrough.
- Conference Talks
  - ETHDenver 2025 - x402 Workshop - Hands-on workshop.
  - DevCon Bangkok - HTTP 402 - Protocol evolution.
- Tutorial Videos
  - Building Your First x402 API - 20-minute tutorial.
  - AI Agents with x402 - Agent integration.
  - From Stripe to x402 - Migration guide.
📝 Articles & Blog Posts
- Official Blog Posts
  - Introducing x402 - Coinbase announcement.
- Technical Deep Dives
  - EIP-3009 Explained - Gasless transfers.
  - x402 vs Traditional Payments - Comparison study.
- Use Case Articles
  - Micropayments Finally Work - Economic analysis.
  - Building the Agent Economy - Market opportunity.
- News Coverage
  - x402 Sees 10,000% Growth - Yahoo Finance.
👥 Community
- Official Channels
  - x402 Foundation Discord - Official community server.
  - Twitter @x402org - Official updates and announcements.
- Developer Communities
  - x402 Builders Telegram - Active developer chat.
  - Reddit r/x402 - Community forum and discussions.
  - Farcaster x402 Channel - Decentralized social.
  - Dev.to #x402 - Tutorials and articles.
- Events & Meetups
  - Weekly Office Hours - Live Q&A with core team.
  - Local Meetups - In-person gatherings.
- Newsletters
  - Agent Economy Digest - AI agent payments news.
Star History
- Issue Guidelines
  - ![Star History Chart - history.com/#xpaysh/awesome-x402&Date)
📊 Ecosystem Market Data
- Analytics Dashboards
  - Dune Analytics x402 - Comprehensive on-chain metrics and visualizations including real-time transaction volumes, chain-by-chain analytics, facilitator comparison data, and revenue/fee metrics.
  - x402scan Explorer - Blockchain explorer for x402 payments with transaction search and verification, payment requirement inspection, and settlement status tracking.
  - CoinGecko x402 Category - Token tracking and market data featuring $180M+ tracked market cap, price charts, trading volumes, and ecosystem token listings.
🚀 Migration Guides
- From Traditional Payment Processors
  - From Stripe to x402 - Migrate subscription and one-time payments from Stripe to x402 for crypto-native payments with instant settlement. Includes API comparison, webhook migration strategies, customer migration approaches, and zero-fee cost analysis.
- From Authentication to Payments
  - From API Keys to x402 Payments - Replace API key-based access control with payment-per-use models. Includes authentication middleware replacement, rate limiting evolution, revenue model transformation, and pay-per-request implementation.
- From Subscription to Usage-Based
  - From Subscription to Pay-Per-Use - Transform monthly subscriptions into granular pay-as-you-go pricing. Includes SaaS model evolution, pricing psychology and conversion, customer acquisition benefits, and revenue optimization strategies.

Programming Languages

Rust 2 TypeScript 1 Go 1 JavaScript 1

awesome-x402

Awesome Lists

Issue Guidelines

🔗 Related Protocols

Payment Protocols

Web Standards

Historical Reference

AI & Agent Protocols

🔒 Security & Audits

Bug Bounty Programs

Security Best Practices

Known Vulnerabilities & Mitigations

Security Monitoring

🔨 Tools & Utilities

CLI Tools

🛠️ SDKs & Client Libraries

JavaScript/TypeScript

Rust

📖 Protocol Documentation

🏭 Production Implementations

High-Volume Production Deployments

🌟 Ecosystem Projects

DeFi & Finance

Infrastructure

Tools & Services

Developer Tools

🏗️ Facilitators

Self-Hosted Facilitators

Rust

🤖 AI Agent Integration

Agent-to-Agent (A2A)

Model Context Protocol (MCP)

Agent Frameworks

💡 Example Applications

Full-Stack Applications

API Examples

Client Examples

🎯 Quick Start - Become an x402 Champion

📚 Official Resources

🚀 Quickstart Guides

⚙️ Protocol Implementations

TypeScript/JavaScript

Python

Rust

🔧 Server Frameworks & Middleware

Node.js/TypeScript

Python

🧪 Testing & Development

Testnets

🎥 Videos & Talks

Official Videos

Conference Talks

Tutorial Videos

📝 Articles & Blog Posts

Official Blog Posts

Technical Deep Dives

Use Case Articles

News Coverage

👥 Community

Official Channels

Developer Communities

Events & Meetups

Newsletters

Star History

Issue Guidelines

📊 Ecosystem Market Data

Analytics Dashboards

🚀 Migration Guides

From Traditional Payment Processors

From Authentication to Payments

From Subscription to Usage-Based