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.

Agentpowered by Xona Wallet 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 Xona Wallet 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

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 Xona Wallet sits in an agent workflow.

Your agent handles reasoning. Xona Wallet 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

Userasks
“Make a short video of a cat astronaut”
Agentdecides
Needs a video-generation service it doesn’t have
Xona WalletdiscoverXona Wallet
Searches 21,000+ services → api.xona-agent.com · $0.50
Xona WalletguardrailXona Wallet
$0.50 ≤ $1.00 per-tx cap - approved before signing
Xona WalletpayXona Wallet
Signs USDC on Solana · x402 settled in 1.2s
Serviceapi.xona-agent.com
Receives payment, generates the short video
Resultdelivered
Video returned to the agent → back to the user

Why Xona Wallet

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

Payments that scalewith your agents.