This is a Next.js project that demonstrates the x402 payment protocol in action and showcases ecosystem builders. The demo site includes a modern UI and a facilitator backend that handles payment verification and settlement.

x402 is an open protocol for internet-native payments built around the HTTP 402 status code. This demo site showcases how to implement x402 in a real-world application, demonstrating:

• Payment-gated content access
• Real-time payment verification
• Payment settlement
• Integration with EVM, SVM, and AVM blockchains

• Payment Middleware: Protect routes with a simple middleware configuration
• Facilitator Backend: Handle payment verification and settlement
• Live Demo: Try out the payment flow with a protected route

• Node.js 20+
• A wallet with testnet USDC (for testing)

1. Install dependencies:

pnpm install

2. Configure your environment variables in .env:

FACILITATOR_URL=your_facilitator_url
RESOURCE_EVM_ADDRESS=your_evm_wallet_address
RESOURCE_SVM_ADDRESS=your_solana_wallet_address
RESOURCE_AVM_ADDRESS=your_algorand_wallet_address
FACILITATOR_EVM_PRIVATE_KEY=your_evm_private_key
FACILITATOR_SVM_PRIVATE_KEY=your_solana_private_key
FACILITATOR_AVM_PRIVATE_KEY=your_algorand_private_key

pnpm dev

Open http://localhost:3000 with your browser to see the result.

• /app - Next.js application code
  • /facilitator - Payment facilitator API routes
  • /protected - Example protected route
• /middleware.ts - x402 payment middleware configuration
• /ecosystem - Directory of ecosystem builders

1. When a user tries to access a protected route, the middleware checks for a valid payment
2. If no payment is found, the server responds with HTTP 402
3. The client can then make a payment and retry the request
4. The facilitator backend verifies the payment and allows access

We welcome projects that are building with x402! To add your project to our ecosystem page, follow these steps:

1. Fork the repository
2. Create a new directory in app/ecosystem/partners-data/[your-project-slug]
3. Add your logo to public/logos/
4. Add your project's metadata in metadata.json:

{
  "name": "Your Project Name",
  "description": "A brief description of your project and how it uses x402",
  "logoUrl": "/logos/your-logo.png",
  "websiteUrl": "https://your-project.com", // ideally pointing to somehwere to learn more about the x402 integration
  "category": "Client-Side Integrations" // Must match one of our categories: - `Client-Side Integrations`, `Services/Endpoints`, `Infrastructure & Tooling`, `Learning & Community Resources`
}

For Facilitators, use this JSON template:

{
  "name": "Your Facilitator Name",
  "description": "A brief description of your facilitator service and supported networks",
  "logoUrl": "/logos/your-logo.png",
  "websiteUrl": "https://your-facilitator.com",
  "category": "Facilitators",
  "facilitator": {
    "baseUrl": "https://your-facilitator.com",
    "networks": ["base", "base-sepolia", "polygon", "solana"],
    "schemes": ["exact"],
    "assets": ["ERC20"],
    "supports": {
      "verify": true,
      "settle": true,
      "supported": true,
      "list": false
    }
  }
}

5. Submit a pull request

• Must demonstrate a working integration with x402
• Should include a link to documentation, quickstart, or code examples
• Must be actively maintained

• Must have a working mainnet integration
• Should include API documentation
• Should maintain 99% uptime

• Should include comprehensive documentation
• Should demonstrate clear value to the x402 ecosystem

• Must include a GitHub template or starter kit
• Should be shared on social media (Twitter/X, Discord, etc.)
• Must include clear setup instructions
• Should demonstrate a practical use case

• Must implement the x402 facilitator API specification
• Should support at least one payment scheme (e.g., "exact")
• Must provide working verify and/or settle endpoints
• Should maintain high uptime and reliability
• Must include comprehensive API documentation

1. Our team will review your submission within 5 business days
2. We may request additional information or changes
3. Once approved, your project will be added to the ecosystem page, and we'd love to do some co-marketing around your use case!

To learn more about the technologies used in this project:

• Next.js Documentation - learn about Next.js features and API
• x402 Protocol Documentation - learn about the x402 payment protocol
• EVM Documentation - learn about Ethereum Virtual Machine

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

We welcome contributions! Please see our Contributing Guidelines for details.

This project is licensed under the MIT License - see the LICENSE file for details.