XFuel Protocol

XFuel is the verifiable settlement and payments layer for AI compute. Agents and applications submit inference tasks; XFuel routes each task to the best available provider, settles fees in USDC via x402 on Base, and returns a verifiable receipt — signed by default, or an on-chain SP1 settlement proof on demand.

Providers are pluggable (OpenAI-compatible APIs, neoclouds, optional DePIN GPUs). Money and proofs live on Base. Trust is tiered so cost tracks value at risk: signed receipt → SP1 settlement proof → Verified Inference (zkLLM, active build).

To learn more about the protocol design, read the whitepaper. For live endpoints and what is real vs mock today, see runtime state. Full documentation hub: docs/.

Live app: https://xfuel.app
Public API: https://api-testnet.xfuel.app

Table of Contents

• Setup
• Using the API
• Agent toolkit
• Documentation
• Security

Setup

Prerequisites

Install Node.js 20+ and npm 10+. A Rust toolchain is required if you build CosmWasm, SP1, or zkLLM crates.

Build and test

Clone the repository, install dependencies, compile contracts, and run the test suite:

git clone https://github.com/XFuel-Lab/xfuel-protocol.git
cd xfuel-protocol
npm install
npx hardhat compile
npx hardhat test

Agent gateway

The agent-facing API (routing, payments, proving, receipts) runs from services/gateway:

cd services/gateway
npm install
npm run m2m-server

The gateway listens on http://localhost:3002 by default. Env examples live under services/gateway/. Production layout is documented in runtime state.

Website

cd apps/web
npm install
npm run dev

Try the demo

One command against the hosted testnet (USDC on Base Sepolia → shareable receipt):

cd packages/sdk
npx tsx examples/flagship-demo.ts

Or install the SDK in your own project:

npm install xfuel-sdk
npx xfuel-mcp

• TypeScript SDK — packages/sdk
• MCP server — packages/mcp
• Agent playbook — packages/agent-skills
• Hosted endpoint — docs/HOSTED_TESTNET_ENDPOINT.md

Windows note: if you use raw HTTP, call curl.exe — PowerShell’s curl is not real curl.

API reference: M2M API · OpenAI gateway: docs here · Payments: x402 adapter.

Documentation

Security

Responsible disclosure (safe harbour; no cash bounty until the first audit): docs/bug-bounty.md.
Reporting policy: SECURITY.md.

MIT License — see LICENSE.