x402-agent-pay 2.2.0

package/dist/scripts/generate-pdf.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env npx ts-node
+"use strict";
+/**
+ * Generate PDF summary of x402-agent-pay
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const pdfkit_1 = __importDefault(require("pdfkit"));
+const fs = __importStar(require("fs"));
+const doc = new pdfkit_1.default({
+    size: 'A4',
+    margins: { top: 50, bottom: 50, left: 50, right: 50 }
+});
+const outputPath = process.argv[2] || './x402-agent-pay-summary.pdf';
+doc.pipe(fs.createWriteStream(outputPath));
+// Colors
+const blue = '#0066cc';
+const gray = '#666666';
+const darkGray = '#333333';
+// Header
+doc.fontSize(28).fillColor(blue).text('💸 x402-agent-pay', { align: 'center' });
+doc.moveDown(0.3);
+doc.fontSize(14).fillColor(gray).text('Seamless USDC payments for AI agents using the x402 protocol', { align: 'center' });
+doc.moveDown(0.5);
+doc.fontSize(10).fillColor(blue).text('MIT License  |  x402 Protocol  |  USDC Hackathon 2026', { align: 'center' });
+doc.moveDown(1);
+// Horizontal line
+doc.moveTo(50, doc.y).lineTo(545, doc.y).strokeColor(blue).lineWidth(2).stroke();
+doc.moveDown(1);
+// Executive Summary
+doc.fontSize(16).fillColor(blue).text('📋 Executive Summary');
+doc.moveDown(0.5);
+doc.fontSize(11).fillColor(darkGray).text('x402-agent-pay is a TypeScript library that enables autonomous AI agents to make USDC payments automatically when encountering paid APIs (HTTP 402 responses). Built on Coinbase\'s official @x402/fetch SDK, it adds critical safety guardrails that prevent wallet drain from bugs, prompt injections, or infinite loops.', { align: 'justify' });
+doc.moveDown(1);
+// Key Value Prop box
+doc.rect(50, doc.y, 495, 50).fillColor('#fff3cd').fill();
+doc.fillColor(darkGray).fontSize(10);
+doc.text('Key Value Proposition: Purpose-built for autonomous OpenClaw agents with spending controls, velocity limits, and full audit trails — the missing safety layer between AI agents and real money.', 60, doc.y - 40, { width: 475 });
+doc.moveDown(1.5);
+// Problem & Solution
+doc.fontSize(16).fillColor(blue).text('🎯 Problem & Solution');
+doc.moveDown(0.5);
+doc.fontSize(12).fillColor(darkGray).text('The Problem:', { continued: false });
+doc.fontSize(11).fillColor(gray);
+doc.list([
+    'Bugs can trigger infinite payment loops',
+    'Prompt injections can redirect payments to attackers',
+    'No visibility into what agents are spending',
+    'No way to set spending limits or control recipients'
+], { bulletRadius: 2, textIndent: 20 });
+doc.moveDown(0.5);
+doc.fontSize(12).fillColor(darkGray).text('The Solution:', { continued: false });
+doc.fontSize(11).fillColor(gray).text('x402-agent-pay wraps the official Coinbase SDK with policy enforcement that happens before any payment is signed.');
+doc.moveDown(1);
+// Key Features
+doc.fontSize(16).fillColor(blue).text('✨ Key Features');
+doc.moveDown(0.5);
+doc.fontSize(11).fillColor(darkGray);
+doc.text('🛡️ Spending Controls', { continued: true }).fillColor(gray).text(' — Per-transaction, daily, weekly, monthly limits');
+doc.fillColor(darkGray).text('⚡ Velocity Limits', { continued: true }).fillColor(gray).text(' — Max transactions per hour to prevent loops');
+doc.fillColor(darkGray).text('📋 Recipient Controls', { continued: true }).fillColor(gray).text(' — Whitelist + blacklist for approved addresses');
+doc.fillColor(darkGray).text('📜 Audit Trail', { continued: true }).fillColor(gray).text(' — Every payment attempt logged with full details');
+doc.fillColor(darkGray).text('🔌 Official SDK', { continued: true }).fillColor(gray).text(' — Built on Coinbase\'s @x402/fetch');
+doc.moveDown(1);
+// Feature Comparison Table
+doc.fontSize(16).fillColor(blue).text('📊 Feature Comparison');
+doc.moveDown(0.5);
+const tableTop = doc.y;
+const tableLeft = 50;
+const colWidths = [180, 120, 195];
+const rowHeight = 25;
+// Table header
+doc.rect(tableLeft, tableTop, 495, rowHeight).fillColor('#f5f5f5').fill();
+doc.fillColor(darkGray).fontSize(10);
+doc.text('Feature', tableLeft + 5, tableTop + 8);
+doc.text('Raw @x402/fetch', tableLeft + colWidths[0] + 5, tableTop + 8);
+doc.text('x402-agent-pay', tableLeft + colWidths[0] + colWidths[1] + 5, tableTop + 8);
+// Table rows
+const rows = [
+    ['Auto-402 handling', '✅', '✅'],
+    ['Spending limits', '❌', '✅ Per-tx, daily, weekly, monthly'],
+    ['Velocity limits', '❌', '✅ Max tx/hour'],
+    ['Recipient controls', '❌', '✅ Whitelist + blacklist'],
+    ['Receipt logging', '❌', '✅ Full audit trail'],
+    ['Policy enforcement', '❌', '✅ Block before signing'],
+];
+let yPos = tableTop + rowHeight;
+rows.forEach(row => {
+    doc.fillColor(gray).fontSize(9);
+    doc.text(row[0], tableLeft + 5, yPos + 8);
+    doc.text(row[1], tableLeft + colWidths[0] + 5, yPos + 8);
+    doc.text(row[2], tableLeft + colWidths[0] + colWidths[1] + 5, yPos + 8);
+    yPos += rowHeight;
+});
+// Draw table borders
+doc.strokeColor('#ddd').lineWidth(0.5);
+for (let i = 0; i <= rows.length + 1; i++) {
+    doc.moveTo(tableLeft, tableTop + i * rowHeight).lineTo(tableLeft + 495, tableTop + i * rowHeight).stroke();
+}
+doc.moveTo(tableLeft, tableTop).lineTo(tableLeft, yPos).stroke();
+doc.moveTo(tableLeft + colWidths[0], tableTop).lineTo(tableLeft + colWidths[0], yPos).stroke();
+doc.moveTo(tableLeft + colWidths[0] + colWidths[1], tableTop).lineTo(tableLeft + colWidths[0] + colWidths[1], yPos).stroke();
+doc.moveTo(tableLeft + 495, tableTop).lineTo(tableLeft + 495, yPos).stroke();
+doc.y = yPos + 15;
+doc.moveDown(1);
+// Technical Stack
+doc.fontSize(16).fillColor(blue).text('🔧 Technical Stack');
+doc.moveDown(0.5);
+doc.fontSize(10).fillColor(gray);
+doc.list([
+    'Language: TypeScript',
+    'SDK: @x402/fetch, @x402/evm, @x402/core (official Coinbase)',
+    'Blockchain: viem for Ethereum interactions',
+    'Networks: Base, Ethereum, Arbitrum, Optimism, Polygon + testnets',
+    'Testing: 29 unit tests passing with Vitest'
+], { bulletRadius: 2, textIndent: 20 });
+doc.moveDown(1);
+// Security
+doc.fontSize(16).fillColor(blue).text('🔐 Security Model');
+doc.moveDown(0.5);
+doc.fontSize(10).fillColor(gray);
+doc.list([
+    'Private keys never logged or transmitted',
+    'Policy enforcement happens before any transaction is signed',
+    'Blacklist checked before whitelist (security priority)',
+    'Full audit trail enables post-hoc review',
+    'Built on audited Coinbase SDK infrastructure'
+], { bulletRadius: 2, textIndent: 20 });
+doc.moveDown(1);
+// Links
+doc.fontSize(16).fillColor(blue).text('🔗 Links');
+doc.moveDown(0.5);
+doc.fontSize(10).fillColor(blue);
+doc.text('GitHub: https://github.com/Omnivalent/x402-agent-pay');
+doc.text('x402 Protocol: https://x402.org');
+doc.text('Coinbase SDK: https://github.com/coinbase/x402');
+doc.moveDown(1);
+// Footer
+doc.moveTo(50, doc.y).lineTo(545, doc.y).strokeColor('#ddd').lineWidth(1).stroke();
+doc.moveDown(0.5);
+doc.fontSize(10).fillColor(gray).text('Built by ClawMD 🩺 | February 2026 | MIT License', { align: 'center' });
+doc.end();
+console.log(`PDF generated: ${outputPath}`);
+//# sourceMappingURL=generate-pdf.js.map

package/dist/scripts/generate-pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-pdf.js","sourceRoot":"","sources":["../../scripts/generate-pdf.ts"],"names":[],"mappings":"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"}

package/dist/scripts/x402-fetch.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env npx ts-node
+/**
+ * CLI for x402-agent-pay
+ * Make payment-enabled HTTP requests with policy enforcement
+ */
+export {};
+//# sourceMappingURL=x402-fetch.d.ts.map

package/dist/scripts/x402-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-fetch.d.ts","sourceRoot":"","sources":["../../scripts/x402-fetch.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/scripts/x402-fetch.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env npx ts-node
+"use strict";
+/**
+ * CLI for x402-agent-pay
+ * Make payment-enabled HTTP requests with policy enforcement
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_1 = require("../src/client");
+const balance_1 = require("../src/balance");
+const config_1 = require("../src/config");
+const args = process.argv.slice(2);
+function printUsage() {
+    console.log(`
+x402-agent-pay CLI
+
+Usage:
+  x402-fetch.ts <url> [options]          Make a payment-enabled request
+  x402-fetch.ts balance <wallet>         Check USDC balance
+  x402-fetch.ts status                   Show spending status
+  x402-fetch.ts history [limit]          Show payment history
+
+Options:
+  --method <METHOD>     HTTP method (default: GET)
+  --body <JSON>         Request body
+  --network <NETWORK>   Network: base, ethereum, arbitrum, optimism, polygon, baseSepolia
+  --dry-run             Show payment details without paying
+  --skip-policy         Skip policy checks (dangerous!)
+  --max-per-tx <USD>    Override max per transaction (default: ${config_1.DEFAULT_POLICY.maxPerTransaction})
+  --daily-limit <USD>   Override daily limit (default: ${config_1.DEFAULT_POLICY.dailyLimit})
+
+Environment:
+  WALLET_PRIVATE_KEY    Required: Your wallet private key (0x...)
+
+Examples:
+  # Make a paid request
+  x402-fetch.ts https://api.example.com/paid-endpoint
+
+  # Check balance on Base
+  x402-fetch.ts balance 0xYourWallet --network base
+
+  # Custom limits
+  x402-fetch.ts https://api.example.com/data --max-per-tx 5 --daily-limit 50
+`);
+}
+async function main() {
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        printUsage();
+        process.exit(0);
+    }
+    const privateKey = process.env.WALLET_PRIVATE_KEY;
+    if (!privateKey && args[0] !== 'balance') {
+        console.error('Error: WALLET_PRIVATE_KEY environment variable is required');
+        process.exit(1);
+    }
+    const command = args[0];
+    // Balance command
+    if (command === 'balance') {
+        const wallet = args[1];
+        if (!wallet) {
+            console.error('Error: wallet address required');
+            process.exit(1);
+        }
+        const networkIdx = args.indexOf('--network');
+        const network = (networkIdx > -1 ? args[networkIdx + 1] : 'base');
+        const result = await (0, balance_1.checkBalance)(wallet, network);
+        console.log(`\n💰 Balance for ${wallet} on ${network}:`);
+        console.log(`   ${result.balanceUsdc} USDC`);
+        return;
+    }
+    // Status command
+    if (command === 'status') {
+        const client = new client_1.AgentPayClient({ privateKey: privateKey });
+        const status = client.getSpendingStatus();
+        console.log('\n📊 Spending Status:');
+        console.log(`   Today: $${status.daily.spent.toFixed(2)} spent (${status.daily.transactions} transactions)`);
+        console.log(`   Remaining: $${status.daily.remaining.toFixed(2)} of $${status.policy.dailyLimit.toFixed(2)} daily limit`);
+        console.log(`   Max per tx: $${status.policy.maxPerTransaction.toFixed(2)}`);
+        return;
+    }
+    // History command
+    if (command === 'history') {
+        const limit = parseInt(args[1]) || 10;
+        const client = new client_1.AgentPayClient({ privateKey: privateKey });
+        const history = client.getHistory(limit);
+        console.log(`\n📜 Last ${limit} payments:`);
+        if (history.length === 0) {
+            console.log('   No payments recorded yet.');
+        }
+        else {
+            for (const r of history) {
+                const status = r.status === 'success' ? '✅' : r.status === 'blocked' ? '🚫' : '⏳';
+                console.log(`   ${status} ${r.timestamp} | ${r.amount} USDC | ${r.url.substring(0, 50)}...`);
+                if (r.txHash)
+                    console.log(`      tx: ${r.txHash}`);
+                if (r.blockReason)
+                    console.log(`      reason: ${r.blockReason}`);
+            }
+        }
+        return;
+    }
+    // Default: fetch URL
+    const url = command;
+    // Parse options
+    const methodIdx = args.indexOf('--method');
+    const method = methodIdx > -1 ? args[methodIdx + 1] : 'GET';
+    const bodyIdx = args.indexOf('--body');
+    const body = bodyIdx > -1 ? args[bodyIdx + 1] : undefined;
+    const networkIdx = args.indexOf('--network');
+    const network = (networkIdx > -1 ? args[networkIdx + 1] : 'base');
+    const dryRun = args.includes('--dry-run');
+    const skipPolicy = args.includes('--skip-policy');
+    const maxPerTxIdx = args.indexOf('--max-per-tx');
+    const maxPerTransaction = maxPerTxIdx > -1 ? parseFloat(args[maxPerTxIdx + 1]) : config_1.DEFAULT_POLICY.maxPerTransaction;
+    const dailyLimitIdx = args.indexOf('--daily-limit');
+    const dailyLimit = dailyLimitIdx > -1 ? parseFloat(args[dailyLimitIdx + 1]) : config_1.DEFAULT_POLICY.dailyLimit;
+    console.log(`[x402] Requesting: ${method} ${url}`);
+    console.log(`[x402] Network: ${network}`);
+    console.log(`[x402] Policy: max $${maxPerTransaction}/tx, $${dailyLimit}/day`);
+    const client = new client_1.AgentPayClient({
+        privateKey: privateKey,
+        network,
+        policy: {
+            maxPerTransaction,
+            dailyLimit,
+        },
+        onPayment: (receipt) => {
+            console.log(`\n✅ Payment successful!`);
+            console.log(`   Amount: ${receipt.amount} USDC`);
+            console.log(`   Recipient: ${receipt.recipient}`);
+            if (receipt.txHash)
+                console.log(`   TX: ${receipt.txHash}`);
+        },
+        onBlocked: (reason) => {
+            console.log(`\n🚫 Payment blocked: ${reason}`);
+        },
+    });
+    try {
+        const response = await client.fetch(url, {
+            method,
+            body,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+        }, {
+            network,
+            skipPolicyCheck: skipPolicy,
+        });
+        console.log(`[x402] Response: ${response.status} ${response.statusText}`);
+        const text = await response.text();
+        console.log('\n--- Response ---');
+        console.log(text.substring(0, 2000));
+        if (text.length > 2000)
+            console.log('... (truncated)');
+    }
+    catch (error) {
+        if (error.name === 'PaymentBlockedError') {
+            console.error(`\n🚫 Payment blocked by policy: ${error.message}`);
+            process.exit(1);
+        }
+        throw error;
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=x402-fetch.js.map

package/dist/scripts/x402-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-fetch.js","sourceRoot":"","sources":["../../scripts/x402-fetch.ts"],"names":[],"mappings":"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"}

package/dist/src/balance.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Balance checking utilities for x402 payments
+ */
+import { NetworkName } from './config';
+export interface BalanceResult {
+    wallet: string;
+    network: NetworkName;
+    balanceRaw: bigint;
+    balanceUsdc: string;
+    sufficient: boolean;
+    requiredAmount?: string;
+}
+/**
+ * Get USDC address for a network
+ */
+export declare function getUsdcAddress(network: NetworkName): `0x${string}`;
+/**
+ * Check USDC balance for a wallet on a specific network
+ */
+export declare function checkBalance(wallet: string, network?: NetworkName, requiredAmount?: string): Promise<BalanceResult>;
+/**
+ * Check if wallet has sufficient balance for a payment
+ */
+export declare function hasSufficientBalance(wallet: string, amount: string, network?: NetworkName): Promise<boolean>;
+/**
+ * Get balances across all supported networks
+ */
+export declare function checkAllBalances(wallet: string): Promise<Record<NetworkName, BalanceResult>>;
+//# sourceMappingURL=balance.d.ts.map

package/dist/src/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/balance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA0B,WAAW,EAAE,MAAM,UAAU,CAAC;AAY/D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,KAAK,MAAM,EAAE,CAMlE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,WAAoB,EAC7B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC,CAoCxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,WAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAqB7C"}

package/dist/src/balance.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Balance checking utilities for x402 payments
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUsdcAddress = getUsdcAddress;
+exports.checkBalance = checkBalance;
+exports.hasSufficientBalance = hasSufficientBalance;
+exports.checkAllBalances = checkAllBalances;
+const viem_1 = require("viem");
+const config_1 = require("./config");
+const ERC20_BALANCE_ABI = [
+    {
+        inputs: [{ name: 'account', type: 'address' }],
+        name: 'balanceOf',
+        outputs: [{ name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+/**
+ * Get USDC address for a network
+ */
+function getUsdcAddress(network) {
+    const address = config_1.USDC_ADDRESSES[network];
+    if (!address) {
+        throw new Error(`Unsupported network: ${network}`);
+    }
+    return address;
+}
+/**
+ * Check USDC balance for a wallet on a specific network
+ */
+async function checkBalance(wallet, network = 'base', requiredAmount) {
+    const chain = config_1.CHAINS[network];
+    if (!chain) {
+        throw new Error(`Unsupported network: ${network}`);
+    }
+    const client = (0, viem_1.createPublicClient)({
+        chain,
+        transport: (0, viem_1.http)(),
+    });
+    const usdcAddress = config_1.USDC_ADDRESSES[network];
+    const balanceRaw = await client.readContract({
+        address: usdcAddress,
+        abi: ERC20_BALANCE_ABI,
+        functionName: 'balanceOf',
+        args: [wallet],
+    });
+    const balanceUsdc = (0, viem_1.formatUnits)(balanceRaw, 6); // USDC has 6 decimals
+    let sufficient = true;
+    if (requiredAmount) {
+        const required = BigInt(Math.floor(parseFloat(requiredAmount) * 1e6));
+        sufficient = balanceRaw >= required;
+    }
+    return {
+        wallet,
+        network,
+        balanceRaw,
+        balanceUsdc,
+        sufficient,
+        requiredAmount,
+    };
+}
+/**
+ * Check if wallet has sufficient balance for a payment
+ */
+async function hasSufficientBalance(wallet, amount, network = 'base') {
+    const result = await checkBalance(wallet, network, amount);
+    return result.sufficient;
+}
+/**
+ * Get balances across all supported networks
+ */
+async function checkAllBalances(wallet) {
+    const networks = ['base', 'ethereum', 'arbitrum', 'optimism', 'polygon'];
+    const results = {};
+    await Promise.all(networks.map(async (network) => {
+        try {
+            results[network] = await checkBalance(wallet, network);
+        }
+        catch (e) {
+            results[network] = {
+                wallet,
+                network,
+                balanceRaw: 0n,
+                balanceUsdc: '0',
+                sufficient: false,
+            };
+        }
+    }));
+    return results;
+}
+//# sourceMappingURL=balance.js.map

package/dist/src/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/balance.ts"],"names":[],"mappings":"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"}

package/dist/src/client.d.ts

@@ -0,0 +1,90 @@
+/**
+ * x402 Agent Pay Client
+ * Wraps official @x402/fetch with spending controls and receipt tracking
+ */
+import { AgentPayConfig, PaymentReceipt, NetworkName } from './config';
+export interface PaymentDetails {
+    amount: string;
+    amountRaw: string;
+    recipient: string;
+    network: NetworkName;
+}
+/**
+ * Agent Pay Client with policy enforcement
+ */
+export declare class AgentPayClient {
+    private fetchWithPayment;
+    private policy;
+    private receipts;
+    private config;
+    private account;
+    private protocolFeesEnabled;
+    constructor(config: AgentPayConfig);
+    /**
+     * Transfer protocol fee to x402-agent-pay maintainers
+     * Called automatically after each successful payment
+     */
+    private transferProtocolFee;
+    /**
+     * Get wallet address
+     */
+    getAddress(): string;
+    /**
+     * Make a payment-enabled request with policy enforcement
+     */
+    fetch(url: string, init?: RequestInit, options?: {
+        skipPolicyCheck?: boolean;
+        network?: NetworkName;
+    }): Promise<Response>;
+    /**
+     * Get spending status
+     */
+    getSpendingStatus(): {
+        daily: {
+            spent: number;
+            limit: number;
+            remaining: number;
+            transactions: number;
+        };
+        weekly?: {
+            spent: number;
+            limit: number;
+            remaining: number;
+        };
+        monthly?: {
+            spent: number;
+            limit: number;
+            remaining: number;
+        };
+        velocity?: {
+            count: number;
+            limit: number;
+            remaining: number;
+        };
+        policy: import("./config").PaymentPolicy;
+    };
+    /**
+     * Get payment history
+     */
+    getHistory(limit?: number): PaymentReceipt[];
+    /**
+     * Get today's receipts
+     */
+    getTodayReceipts(): PaymentReceipt[];
+    /**
+     * Export receipts as CSV
+     */
+    exportReceiptsCsv(): string;
+}
+/**
+ * Error thrown when payment is blocked by policy
+ */
+export declare class PaymentBlockedError extends Error {
+    receipt: PaymentReceipt;
+    constructor(reason: string, receipt: PaymentReceipt);
+}
+/**
+ * Create a simple wrapped fetch (no policy, direct SDK usage)
+ */
+export declare function createSimpleFetch(privateKey: string): typeof fetch;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EAOZ,MAAM,UAAU,CAAC;AAIlB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,mBAAmB,CAAU;gBAEzB,MAAM,EAAE,cAAc;IAkBlC;;;OAGG;YACW,mBAAmB;IA8DjC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE,GAC7D,OAAO,CAAC,QAAQ,CAAC;IAoGpB;;OAEG;IACH,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;IAIjB;;OAEG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM;IAIzB;;OAEG;IACH,gBAAgB;IAIhB;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IACrC,OAAO,EAAE,cAAc,CAAC;gBAEnB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAKpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,KAAK,CAWlE"}