Documentation

import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts'

// Generate a dedicated wallet for your agent
const privateKey = generatePrivateKey()
const account = privateKeyToAccount(privateKey)

console.log('Agent Address:', account.address)
console.log('Private Key:', privateKey)  // Store securely!

// Fund this wallet with USDC on Base network

# .env
AGENT_PRIVATE_KEY=0x...your-agent-private-key...
GATEWAY_URL=https://gateway.apiosk.com
NETWORK=base-sepolia   # Use 'base' for production

import { createAgent } from './agent-client'

const agent = createAgent({
  gatewayUrl: process.env.GATEWAY_URL!,
  privateKey: process.env.AGENT_PRIVATE_KEY!,
  network: 'base-sepolia'  // or 'base' for mainnet
})

// Verify initialization
console.log('Agent wallet:', agent.getAddress())

// The agent handles 402 responses and payments automatically

// GET request
const weather = await agent.callApi('/acme/weather/current', {
  method: 'GET'
})

// POST request with body
const completion = await agent.callApi('/openai/gpt4/completion', {
  method: 'POST',
  body: {
    prompt: 'Explain quantum computing',
    max_tokens: 100
  }
})

// Access response data
console.log('Data:', completion.data)
console.log('Paid:', completion.paymentInfo.amount, 'USDC')

const result = await agent.callApi('/provider/api/endpoint', {
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH',
  body?: object,                    // JSON request body
  headers?: Record<string, string>, // Additional headers
  timeout?: number                  // Timeout in ms (default: 30000)
})

// Returns:
interface ApiResponse<T> {
  data: T                // Response data from upstream API
  paymentInfo: {
    amount: string       // Amount paid in USDC
    txHash?: string      // Transaction hash (if available)
  }
}

curl https://gateway.apiosk.com/provider/api/endpoint

# Response: 402 Payment Required
# Headers:
#   X-Payment-Amount: 0.01
#   X-Payment-Asset: USDC
#   X-Payment-Network: base
#   X-Payment-Recipient: 0x...marketplace-wallet...

// Using x402 client
const payment = await x402.createPayment({
  amount: "0.01",
  asset: "USDC",
  network: "base",
  recipient: "0x...marketplace-wallet..."
})

curl -X GET "https://gateway.apiosk.com/provider/api/endpoint" \
  -H "X-Payment: <your-x402-payment-token>"

# Response: 200 OK
# Headers:
#   X-Payment-Status: paid
# Body: <API response data>