@darklrd/x402-agent-client

Client library that auto-handles HTTP 402 payment challenges. Your AI agent makes a normal fetch call — the client intercepts 402 responses, pays via Solana USDC, and retries transparently.

Install

pnpm add @darklrd/x402-agent-client x402-adapters

Quick Start

x402Fetch (drop-in fetch replacement)

import { x402Fetch } from '@darklrd/x402-agent-client';
import { MockPayer } from 'x402-adapters';

const payer = new MockPayer();
const res = await x402Fetch('http://api.example.com/weather?city=London', { payer });
const data = await res.json();

createTool (structured tool wrapper)

import { createTool } from '@darklrd/x402-agent-client';
import { MockPayer } from 'x402-adapters';

const tool = createTool({
  name: 'weather',
  url: 'http://api.example.com/weather',
  method: 'GET',
  payer: new MockPayer(),
});

const result = await tool.invoke({ city: 'London' });

OpenAI Function Calling

import { toOpenAITools, executeToolCall } from '@darklrd/x402-agent-client';

const tools = toOpenAITools(myToolDefinitions);
// Pass to OpenAI chat completion, then:
const result = await executeToolCall(toolCall, myToolDefinitions);

Features

• Drop-in fetch replacement with automatic 402 handling
• Structured tool wrapper for agent frameworks
• OpenAI function calling adapter
• Pluggable payer interface (mock or real Solana USDC)

Links

• GitHub
• Playground
• x402 Protocol