x402x

x402x is an advanced facilitator service that extends the base x402 protocol with additional features for enterprise use cases. It provides enhanced payment processing, analytics, and customization options.

Prerequisites

Node.js and npm installed
A SKALE Chain endpoint
Understanding of x402 protocol

Configuration

Environment Variables

Create a .env file with x402x configuration:

# Facilitator router address
RECEIVING_ADDRESS=0x1Ae0E196dC18355aF3a19985faf67354213F833D

# Payment token configuration
PAYMENT_TOKEN_ADDRESS=0x2e08028E3C4c2356572E096d8EF835cD5C6030bD
PAYMENT_TOKEN_NAME="Bridged USDC (SKALE Bridge)"
# Your receiving address
RECEIVING_ADDRESS=0xyour_address_to_receive_payment

# SKALE network configuration
NETWORK_CHAIN_ID=324705682

Basic Integration

Server Setup
Client Setup

import { Hono } from "hono";
import { serve } from "@hono/node-server";
import { paymentMiddleware, x402ResourceServer } from "@x402/hono";
import { ExactEvmScheme } from "@x402/evm/exact/server";
import { registerExactEvmScheme } from "@x402/evm/exact/server";
import type { RouteConfig as X402RouteConfig } from "@x402/core/server";
import { HTTPFacilitatorClient } from "@x402/core/server";
import {
  registerRouterSettlement,
  registerSettlementHooks,
  createSettlementRouteConfig,
} from "@x402x/extensions";
import "dotenv/config";

const app = new Hono();
const PORT = Number(process.env.PORT) || 3001;

async function main() {

app.use(
  "/*",
  cors({
    origin: "*",
    credentials: false,
    exposeHeaders: ["PAYMENT-REQUIRED", "PAYMENT-RESPONSE"],
    allowHeaders: [
      "Content-Type",
      "PAYMENT-SIGNATURE",
      "PAYMENT-RESPONSE",
      "X-PAYMENT-SIGNATURE",
      "X-PAYMENT-RESPONSE",
    ],
  }),
);

  const facilitatorUrl = "https://facilitator.x402x.dev";
  const receivingAddress = process.env.RECEIVING_ADDRESS as `0x${string}`;
  const networkChainId = process.env.NETWORK_CHAIN_ID || "324705682";
  const network = `eip155:${networkChainId}`;

  // Initialize x402x facilitator client with authentication
  const facilitatorClient = new HTTPFacilitatorClient({
    url: facilitatorUrl
    });

  const resourceServer = new x402ResourceServer(facilitatorClient);
  registerExactEvmScheme(resourceServer, {
    networks: ["eip155:*"],
  });
  registerRouterSettlement(resourceServer);
  registerSettlementHooks(resourceServer);
  await resourceServer.initialize();

  const routes = {
    "GET /api/premium": createSettlementRouteConfig(
      {
        accepts: {
          scheme: "exact",
          network,
          payTo: receivingAddress,
          price: "$0.01",
        },
      },
      {
        // Dynamic fee: query facilitator /calculate-fee on 402 probe
        facilitatorUrl,
      },
  
    ) as X402RouteConfig,
  };
  app.use("/api/premium", paymentMiddleware(routes, resourceServer));

  app.get("/api/premium", async (c) => {
    console.log("[Server] Weather request received");
    return c.json({
      message: "Premium content unlocked via x402x!",
      features: ["analytics", "webhooks", "rate-limiting"],
      timestamp: new Date().toISOString(),
    });
  });

  serve({ fetch: app.fetch, port }, () => {
    console.log(`Server running on http://localhost:${port}`);
    console.log(`Using x402x facilitator: ${facilitatorUrl}`);
  });
}

main().catch(console.error);

  import { wrapFetchWithPayment } from "x402-fetch";
  import { x402Client } from "@x402/core/client";
  import { registerX402xScheme } from "@x402x/extensions";
  import { privateKeyToAccount } from "viem/accounts";

  import "dotenv/config";

  async function main() {
      const account = privateKeyToAccount(
        process.env.PRIVATE_KEY as `0x${string}`
      );
      const baseUrl = process.env.BASE_URL || "http://localhost:3001";
      const networkChainId = process.env.NETWORK_CHAIN_ID || "324705682";

      const client = new x402Client();
      const networkId = `eip155:${networkChainId}` as `${string}:${string}`;
      registerX402xScheme(client, "eip155:324705682", account);

      const fetchWithPayment = wrapFetchWithPayment(fetch, client);
      
      const fetchWithPayment = wrapFetchWithPayment(
          fetch,
          client
        );

      const premium_url = `${baseUrl}/api/premium`;

      try{
      const response = await fetchWithPayment(premium_url, {
            method: "GET",
            headers: {
              "Content-Type": "application/json",
            },
          });
      const data = await response.json();
      console.log(data);
      }
      catch(error){
        console.error(
          "[Client] Error:",
          error instanceof Error ? error.message : error
        );
        process.exit(1);
      }

      const response = await fetchWithPayment("/api/premium-content", {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({ /* your data */ }),
      });
      const result = await response.json();
    }

main();

Troubleshooting

Connection Issues

If you cannot connect to x402x:

Verify the facilitator URL is correct
Check network connectivity
Ensure API credentials are valid
Review firewall settings

Payment Failures

Common causes and solutions:

Issue	Solution
Invalid signature	Verify wallet configuration and signing
Insufficient balance	Ensure payer has enough tokens
Network mismatch	Check chain ID matches configuration
Expired authorization	Increase `maxTimeoutSeconds`

Resources

This entity — x402x — is deployed and activley supporting SKALE. These are 3rd party services that may have their own terms and conditions and privacy polices. Use these services at your own risk. AI and agents is a highly experimental space; the 3rd party software solutions may have bugs or be unaudited. You and your agents and your customers use all 3rd party services chosen at your own risk and per their terms.

Deployment

Smart Contracts

Privacy

x402

MPP

Facilitators

AI Agents

Native Features

Prerequisites

Configuration

Environment Variables

Basic Integration

Troubleshooting

Connection Issues

Payment Failures

Resources

​Prerequisites

​Configuration

​Environment Variables

​Basic Integration

​Troubleshooting

​Connection Issues

​Payment Failures

​Resources

Prerequisites

Configuration

Environment Variables

Basic Integration

Troubleshooting

Connection Issues

Payment Failures

Resources