Developer Integration Guide

Accept >< payments via x402 protocol in your API or web application.

Quick Start

install
pnpm add @agentic/x402-middleware
server.ts
import { x402 } from '@agentic/x402-middleware'
import express from 'express'

const app = express()

// Paid endpoint - requires 2500 >< tokens
app.get('/api/premium-content',
  x402.middleware({
    amount: '2500',
    asset: '><',
    contract: 'G849nDx4r1vwjibbmpjkZ6pbDWwaMouhkWLq1o8Z5FUN',
    network: 'solana',
    recipient: process.env.WALLET_ADDRESS
  }),
  (req, res) => {
    res.json({ content: 'Premium data here' })
  }
)

app.listen(3000)

Client-Side Integration

client.ts
import { AgenticBrowser } from '@agentic/sdk'

const browser = new AgenticBrowser({
  autoApproveThreshold: 5000, // Auto-pay up to 5000 ><
  wallet: phantomWallet
})

// Automatically handles 402 responses
const data = await browser.fetch('/api/premium-content')
// Payment sent transparently if required

Testing

Use Solana devnet for testing:

test
export SOLANA_NETWORK=devnet
export FISH_TOKEN_MINT=DevnetFishTokenMintAddress
pnpm test

Documentation