Agentic commerce · Solana + Base

Payments that scale
with your agents.

One SDK gives your agent a multi-network wallet, discovery across 21,000+ services, x402 payments, and spending reports — on Solana and Base.

Powered by Xona
Agentpowered by xPay SDKlive demo
How much can I spend?
xpay.wallet.balance()
You've got $42.80 USDC ready — $28.50 on Solana, $14.30 on Base. One seed derives both chains.
discover → guardrail → pay → report@xona-labs/xpay
Add to your agent

Commerce capabilities, dropped into your agent.

Export xPay as native tools for your model of choice — wallet, discovery, payments, and reports — then let the agent spend within the limits you set. No glue code, no custodian, no popups.

npm install @xona-labs/xpayGet started
Works with your modeltool calling
Claude
forClaude(xpay) — native tool definitions
Ready
H
Hermes
Nous Hermes · OpenAI-style function calling
Ready
OpenAI
forOpenAI(xpay)
Gemini
forGemini(xpay)

Same handlers everywhere — pick the vendor-shaped schema and your agent gets the full discover → pay → report loop.

In the loop

Where xPay sits in an agent workflow.

Your agent handles reasoning. xPay handles the money — finding the right service, enforcing your spending rules, and settling payment over x402, all in three calls the agent never has to think about.

  • The agent asks discover → guardrail → pay
  • You set the caps; they’re enforced before any signature
  • The service gets paid, the result comes back — no human in the loop
  1. Userasks

    “Make a short video of a cat astronaut”

  2. Agentdecides

    Needs a video-generation service it doesn’t have

  3. xPaydiscoverxPay

    Searches 21,000+ services → api.xona-agent.com · $0.50

  4. xPayguardrailxPay

    $0.50 ≤ $1.00 per-tx cap — approved before signing

  5. xPaypayxPay

    Signs USDC on Solana · x402 settled in 1.2s

  6. Serviceapi.xona-agent.com

    Receives payment, generates the short video

  7. Resultdelivered

    Video returned to the agent → back to the user

Why xPay

One SDK for the entire agentic commerce loop.

Discovery

21,000+ services

Search the entire x402 ecosystem via PayAI and other catalogs. Ranked, cached, one call.

Payments

x402 in one line

Pay any compatible endpoint — catalog or wild — with automatic network routing and retries.

Multi-network

Solana + Base

One BIP-39 seed derives both. USDC balances and transfers unified across chains.

Guardrails

Spend caps that hold

Per-tx and per-day limits enforced before signing — a hallucinating agent can't slip past.

Custody

Local & self-custodial

Keys live on the agent's own machine, never a vendor's — encrypt at rest with a passphrase. No popups, no lock-in.

Auditable

Activity reports

Every payment is a public USDC transfer. Get daily, weekly, or monthly reports via OrbitX402 — no RPC key needed.

SDK

Drop it into any agent.

Type-safe TypeScript with one entry point. createXPay gives you discover, pay, transfer, balance, and report — plus tool exporters for Claude, OpenAI, and Gemini so your agent can spend in four lines.

  • createXPay({ profile }) — wallet + rails configured
  • useByUrl() pays any x402 endpoint and returns the result
  • forClaude / forOpenAI / forGemini tool definitions
agent.ts
import { createXPay, loadProfile } from "@xona-labs/xpay"
const xpay = createXPay({
profile: await loadProfile({ passphrase }),
});
// pay any x402 endpoint, get the result
const video = await xpay.useByUrl(
"https://api.xona-agent.com/video/short-generation",
{ body: { prompt: "a cat astronaut" } }
);
typescript@xona-labs/xpay
CLI

A wallet in your terminal.

Install once, init a local encrypted keystore, and you're transacting. No browser, no popups, no vendor — perfect for scripts, cron jobs, and headless agents.

  • xpay init — Solana + EVM from one seed, encrypted at rest
  • xpay discover / pay / transfer / balance / report
  • Runs anywhere Node runs
bash
$ npm install -g @xona-labs/xpay
$ xpay init
✔ Solana 7RB7frd…6qkpf5ph
✔ EVM 0xA5D9…1023dfa
$ xpay discover "short video"
$0.5000 solana api.xona-agent.com
$ xpay pay api.xona-agent.com/video/…
✔ Paid $0.5000 on solana · 1.2s
bash@xona-labs/xpay
MCP

Native in Claude, Cursor & Codex.

Paste one block into your MCP host config — no keys, no setup. On first run the agent gets its own wallet and seven payment tools: discover, pay, do, transfer, balance, report, guardrail. Fund the printed address and it can pay.

  • npx @xona-labs/xpay mcp — stdio server
  • 7 tools, zero glue code
  • Agent gets its own wallet — or bring your own key
claude_desktop_config.json
// claude_desktop_config.json — no keys, no setup
{
"mcpServers": {
"xpay": {
"command": "npx",
"args": ["-y", "@xona-labs/xpay", "mcp"]
}
}
}
// first run → the agent gets its own wallet; fund the printed address
› "pay api.xona-agent.com to make a short video"
json@xona-labs/xpay
Ship in minutes

Give your agent a wallet today.

Paste the MCP block — no keys, no setup — or install the SDK, and your agent can discover and pay 21,000+ services across Solana and Base.