@proxies-sx/x402-sdk

x402 SDK for AI agent payments. Accept USDC on Base and Solana.

Packages

Package	Description
@proxies-sx/x402-core	Core types and utilities
@proxies-sx/x402-hono	Hono middleware (Lucid compatible)
@proxies-sx/x402-solana	Solana payment verification

Quick Start

npm install @proxies-sx/x402-hono

import { Hono } from 'hono'
import { x402 } from '@proxies-sx/x402-hono'

const app = new Hono()

// Free endpoint
app.get('/health', (c) => c.json({ status: 'ok' }))

// Paid endpoint - $0.10 per request
app.get('/data', x402({
  amount: 0.10,
  network: 'base',
  recipient: '0xYourWallet',
  description: 'Premium data endpoint'
}), async (c) => {
  const payment = c.get('x402Payment')
  console.log(`Paid by: ${payment.walletAddress}`)

  return c.json({ data: 'Premium content!' })
})

export default app

How x402 Works

1. Agent calls your endpoint without payment
2. Your server returns 402 with payment requirements
3. Agent sends USDC on Base or Solana
4. Agent retries with Payment-Signature header
5. Your server verifies payment and returns data

Payment Networks

Network	USDC Address	Speed	Cost
Base	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913	~2s	~$0.01
Solana	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v	~400ms	~$0.0001

Solana Verification

import { verifySolanaPayment } from '@proxies-sx/x402-solana'

const result = await verifySolanaPayment(
  txSignature,
  'YourSolanaWalletAddress'
)

if (result.valid) {
  console.log(`Received $${result.amount} from ${result.payer}`)
}

Deploy to Railway

railway login
railway init
railway up

Register on xgate.run

After deploying, register your agent on xgate.run for discovery.

Links

• Lucid Agents SDK
• x402 Protocol
• Proxies.sx

License

MIT