x402 Facilitator

The facilitator is an optional but recommended service that simplifies the process of verifying and settling payments between clients (buyers) and servers (sellers).

What is a Facilitator?

The facilitator is a service that:

• Verifies payment payloads submitted by clients.

• Settles payments on the blockchain on behalf of servers.

By using a facilitator, servers do not need to maintain direct blockchain connectivity or implement payment verification logic themselves. This reduces operational complexity and ensures accurate, real-time validation of transactions.

Facilitator Responsibilities

• Verify payments: Confirm that the client's payment payload meets the server's declared payment requirements.

• Settle payments: Submit validated payments to the blockchain and monitor for confirmation.

• Provide responses: Return verification and settlement results to the server, allowing the server to decide whether to fulfill the client's request.

The facilitator does not hold funds or act as a custodian - it performs verification and execution of onchain transactions based on signed payloads provided by clients.

Why Use a Facilitator?

Using a facilitator provides:

• Reduced operational complexity: Servers do not need to interact directly with blockchain nodes.

• Protocol consistency: Standardized verification and settlement flows across services.

• Faster integration: Services can start accepting payments with minimal blockchain-specific development.

While it is possible to implement verification and settlement locally, using a facilitator accelerates adoption and ensures correct protocol behavior.

AWE World.fun Facilitator

AWE World.fun operates a hosted facilitator service.

AWE World.fun's x402 Facilitator

World.fun's x402 facilitator offers:

• Fee-free USDC payments on Base: It currently processes transactions without additional fees, allowing sellers to receive 100% of the payment.

• Flexible token support: Any ERC-20 token that implements EIP-3009 can be used as the payment asset.

• High performance settlement: Payments are submitted to the Base network with fast confirmation times and high throughput.

Using World.fun's facilitator allows sellers to quickly integrate payments without managing blockchain infrastructure, while providing a predictable and low-cost experience for buyers.

How It Works

To accept World.fun payments, just add:

import express from "express";
import { paymentMiddleware } from "x402-express";

const app = express();

app.use(paymentMiddleware(
    "0xYourAddress", // your receiving wallet address
    {  // Route configurations for protected endpoints
    "GET /weather": {
        // USDC amount in dollars
        price: "$0.001",
        network: "base",
        // Optional: Add metadata for better discovery in x402 Bazaar
        config: {
        description: "Get current weather data for any location",
        inputSchema: {
            type: "object",
            properties: {
            location: { type: "string", description: "City name" }
            }
        },
        outputSchema: {
            type: "object",
            properties: {
            weather: { type: "string" },
            temperature: { type: "number" }
            }
        }
        }
    },
    },
    {
    url: "https://facilitator.world.fun",
    }
));

It also supports the Next.js and Hono frameworks for Node.js, as well as the FastAPI and Flask frameworks for Python.

Supported Networks

• Base (Mainnet)