ukstv/x402-facilitator repository overview

⁠x402 Facilitator

Production-ready x402 payment facilitator in Rust — verify, settle, and monitor blockchain payments over HTTP 402 flows.

This Docker image runs the x402-facilitator binary, a Rust-based server that handles x402 payment verification and on-chain settlement.

⁠✨ Features

• ✅ Payment Verification — Cryptographically verify x402 payment payloads
• ✅ On-chain Settlement — Submit verified payments to the blockchain
• ✅ Multi-Chain Support — EVM (EIP-155), Solana, Aptos networks
• ✅ Protocol V1 & V2 — Support for both x402 protocol versions
• ✅ Low Resource Footprint — Efficient Rust implementation
• ✅ OpenTelemetry Tracing — Built-in observability

⁠🚀 Quickstart

⁠Using GHCR (GitHub Container Registry)

docker pull ghcr.io/x402-rs/x402-facilitator:latest
docker run -v $(pwd)/config.json:/app/config.json -p 8080:8080 ghcr.io/x402-rs/x402-facilitator:latest

⁠Using Docker Hub

docker pull ukstv/x402-facilitator:latest
docker run -v $(pwd)/config.json:/app/config.json -p 8080:8080 ukstv/x402-facilitator:latest

⁠📋 Configuration

The facilitator requires a config.json file. See config.json.example⁠:

{
  "port": 8080,
  "host": "0.0.0.0",
  "chains": {
    "eip155:84532": {
      "eip1559": true,
      "flashblocks": true,
      "signers": ["0xWALLET"],
      "rpc": [
        {
          "http": "https://rpc.com/eip155/84532",
          "rate_limit": 50
        }
      ]
    },
    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": {
      "signer": "SOLANA_PRIVATE_KEY",
      "rpc": "https://rpc.com/solana/5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "pubsub": "wss://rpc.com/solana/5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
    }
  },
  "schemes": [
    {
      "id": "v1-eip155-exact",
      "chains": "eip155:*"
    },
    {
      "id": "v2-eip155-exact",
      "chains": "eip155:*"
    },
    {
      "id": "v1-solana-exact",
      "chains": "solana:*"
    },
    {
      "id": "v2-solana-exact",
      "chains": "solana:*"
    }
  ]
}

⁠Environment Variables

The facilitator supports the following environment variables (defined in the facilitator⁠ crate):

Environment variables override values in config.json.

⁠🌐 Supported Networks

EIP-155 (EVM), Solana, and Aptos networks are supported. Configure the networks you need in config.json using CAIP-2⁠ chain IDs.

⁠Common Network Examples

⁠📖 API Endpoints

The facilitator exposes the following HTTP endpoints (as defined in the facilitator⁠ crate):

⁠🔗 Links

• GitHub: https://github.com/x402-rs/x402-rs⁠
• x402 Protocol: https://x402.org⁠
• Coinbase Docs: https://docs.cdp.coinbase.com/x402⁠

⁠🛠️ Building from Source

git clone https://github.com/x402-rs/x402-rs.git
cd x402-rs
docker build . -t x402-facilitator

⁠📄 License

Apache-2.0

⁠🤝 Contributing

Open issues or PRs at https://github.com/x402-rs/x402-rs⁠