agentwallet-sdk 1.0.0 → 2.0.1

package/dist/x402/budget.js

@@ -0,0 +1,113 @@
+/**
+ * [MAX-ADDED] In-memory budget tracker for x402 payments.
+ * Enforces per-service caps, daily limits, and per-request maximums.
+ * On-chain spend limits are ALSO enforced by the AgentWallet contract —
+ * this is an additional client-side layer for granular service-level control.
+ */
+export class X402BudgetTracker {
+    constructor(config = {}) {
+        this.serviceBudgets = new Map();
+        this.dailySpend = new Map(); // service -> today's total
+        this.globalDailySpend = 0n;
+        this.transactionLog = [];
+        this.globalDailyLimit = config.globalDailyLimit ?? BigInt('0xFFFFFFFFFFFFFFFFFFFFFFFF'); // effectively unlimited
+        this.globalPerRequestMax = config.globalPerRequestMax ?? BigInt('0xFFFFFFFFFFFFFFFFFFFFFFFF');
+        this.dailyResetTimestamp = this.startOfDay();
+        if (config.serviceBudgets) {
+            for (const budget of config.serviceBudgets) {
+                this.serviceBudgets.set(budget.service, budget);
+            }
+        }
+    }
+    /**
+     * Check if a payment is within budget limits.
+     * Returns { allowed: true } or { allowed: false, reason: string }.
+     */
+    checkBudget(service, amount) {
+        this.maybeResetDaily();
+        // Global per-request check
+        if (amount > this.globalPerRequestMax) {
+            return { allowed: false, reason: `Amount ${amount} exceeds global per-request max ${this.globalPerRequestMax}` };
+        }
+        // Global daily check
+        if (this.globalDailySpend + amount > this.globalDailyLimit) {
+            return { allowed: false, reason: `Would exceed global daily limit ${this.globalDailyLimit}` };
+        }
+        // Service-specific checks
+        const budget = this.findServiceBudget(service);
+        if (budget) {
+            if (amount > budget.maxPerRequest) {
+                return { allowed: false, reason: `Amount ${amount} exceeds service per-request max ${budget.maxPerRequest} for ${service}` };
+            }
+            const serviceDailySpend = this.dailySpend.get(service) ?? 0n;
+            if (serviceDailySpend + amount > budget.dailyLimit) {
+                return { allowed: false, reason: `Would exceed daily limit ${budget.dailyLimit} for ${service}` };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record a completed payment.
+     */
+    recordPayment(log) {
+        this.maybeResetDaily();
+        this.transactionLog.push(log);
+        if (log.success) {
+            const service = log.service;
+            this.dailySpend.set(service, (this.dailySpend.get(service) ?? 0n) + log.amount);
+            this.globalDailySpend += log.amount;
+        }
+    }
+    /**
+     * Get transaction history, optionally filtered.
+     */
+    getTransactionLog(filter) {
+        let logs = this.transactionLog;
+        if (filter?.service) {
+            logs = logs.filter(l => l.service === filter.service);
+        }
+        if (filter?.since) {
+            logs = logs.filter(l => l.timestamp >= filter.since);
+        }
+        return logs;
+    }
+    /**
+     * Get current daily spend summary.
+     */
+    getDailySpendSummary() {
+        this.maybeResetDaily();
+        const byService = {};
+        for (const [service, amount] of this.dailySpend) {
+            byService[service] = amount;
+        }
+        return {
+            global: this.globalDailySpend,
+            byService,
+            resetsAt: this.dailyResetTimestamp + 86400,
+        };
+    }
+    /**
+     * Add or update a service budget at runtime.
+     */
+    setServiceBudget(budget) {
+        this.serviceBudgets.set(budget.service, budget);
+    }
+    // ─── Internals ───
+    findServiceBudget(service) {
+        // Exact match first, then wildcard
+        return this.serviceBudgets.get(service) ?? this.serviceBudgets.get('*');
+    }
+    maybeResetDaily() {
+        const now = this.startOfDay();
+        if (now > this.dailyResetTimestamp) {
+            this.dailySpend.clear();
+            this.globalDailySpend = 0n;
+            this.dailyResetTimestamp = now;
+        }
+    }
+    startOfDay() {
+        const now = Math.floor(Date.now() / 1000);
+        return now - (now % 86400);
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/x402/budget.js.map

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

package/dist/x402/client.d.ts

@@ -0,0 +1,60 @@
+import type { X402PaymentRequired, X402PaymentRequirements, X402ClientConfig, X402TransactionLog } from './types.js';
+import { X402BudgetTracker } from './budget.js';
+/**
+ * [MAX-ADDED] x402 Payment Client for AgentWallet.
+ *
+ * Handles the full x402 payment flow:
+ * 1. Detects 402 Payment Required responses
+ * 2. Parses payment instructions from PAYMENT-REQUIRED header
+ * 3. Validates against budget controls
+ * 4. Executes USDC payment via AgentWallet contract
+ * 5. Retries original request with payment proof
+ */
+export declare class X402Client {
+    private wallet;
+    private config;
+    private budget;
+    private supportedNetworks;
+    constructor(wallet: any, config?: X402ClientConfig);
+    /**
+     * Make an x402-aware fetch request. Automatically handles 402 responses.
+     */
+    fetch(url: string | URL, init?: RequestInit): Promise<Response>;
+    /**
+     * Parse a 402 response to extract payment requirements.
+     */
+    parse402Response(response: Response): Promise<X402PaymentRequired | null>;
+    /**
+     * Select the best compatible payment option from offered requirements.
+     * Prefers: Base network, USDC, exact scheme.
+     */
+    selectPaymentOption(accepts: X402PaymentRequirements[]): X402PaymentRequirements | null;
+    /**
+     * Execute the payment via AgentWallet's agentTransferToken.
+     */
+    private executePayment;
+    /** Get the budget tracker for direct inspection */
+    get budgetTracker(): X402BudgetTracker;
+    /** Get transaction log */
+    getTransactionLog(filter?: {
+        service?: string;
+        since?: number;
+    }): X402TransactionLog[];
+    /** Get daily spend summary */
+    getDailySpendSummary(): {
+        global: bigint;
+        byService: Record<string, bigint>;
+        resetsAt: number;
+    };
+}
+export declare class X402PaymentError extends Error {
+    readonly paymentRequirements: X402PaymentRequirements;
+    constructor(message: string, paymentRequirements: X402PaymentRequirements);
+}
+export declare class X402BudgetExceededError extends Error {
+    readonly reason: string;
+    readonly url: string;
+    readonly paymentRequirements: X402PaymentRequirements;
+    constructor(reason: string, url: string, paymentRequirements: X402PaymentRequirements);
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/x402/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EAGvB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQhD;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,iBAAiB,CAAc;gBAE3B,MAAM,EAAE,GAAG,EAAE,MAAM,GAAE,gBAAqB;IAYtD;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmFrE;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IA2B/E;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,uBAAuB,GAAG,IAAI;IAmBvF;;OAEG;YACW,cAAc;IA+B5B,mDAAmD;IACnD,IAAI,aAAa,IAAI,iBAAiB,CAErC;IAED,0BAA0B;IAC1B,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,kBAAkB,EAAE;IAItF,8BAA8B;IAC9B,oBAAoB;;;;;CAGrB;AAID,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,mBAAmB,EAAE,uBAAuB;gBAD5D,OAAO,EAAE,MAAM,EACC,mBAAmB,EAAE,uBAAuB;CAK/D;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,MAAM;aACX,mBAAmB,EAAE,uBAAuB;gBAF5C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,mBAAmB,EAAE,uBAAuB;CAK/D"}

package/dist/x402/client.js

@@ -0,0 +1,205 @@
+import { parseAbi } from 'viem';
+import { USDC_ADDRESSES, DEFAULT_SUPPORTED_NETWORKS } from './types.js';
+import { X402BudgetTracker } from './budget.js';
+import { agentTransferToken, checkBudget } from '../index.js';
+// ERC20 transfer ABI for encoding
+const ERC20_TRANSFER_ABI = parseAbi([
+    'function transfer(address to, uint256 amount) returns (bool)',
+]);
+/**
+ * [MAX-ADDED] x402 Payment Client for AgentWallet.
+ *
+ * Handles the full x402 payment flow:
+ * 1. Detects 402 Payment Required responses
+ * 2. Parses payment instructions from PAYMENT-REQUIRED header
+ * 3. Validates against budget controls
+ * 4. Executes USDC payment via AgentWallet contract
+ * 5. Retries original request with payment proof
+ */
+export class X402Client {
+    constructor(wallet, config = {}) {
+        this.wallet = wallet;
+        this.config = {
+            autoPay: true,
+            maxRetries: 1,
+            supportedNetworks: [...DEFAULT_SUPPORTED_NETWORKS],
+            ...config,
+        };
+        this.budget = new X402BudgetTracker(config);
+        this.supportedNetworks = new Set(this.config.supportedNetworks);
+    }
+    /**
+     * Make an x402-aware fetch request. Automatically handles 402 responses.
+     */
+    async fetch(url, init) {
+        const urlStr = url.toString();
+        const response = await globalThis.fetch(url, init);
+        if (response.status !== 402) {
+            return response;
+        }
+        if (!this.config.autoPay) {
+            return response;
+        }
+        // Parse the 402 response
+        const paymentRequired = await this.parse402Response(response);
+        if (!paymentRequired) {
+            return response; // Couldn't parse — return original 402
+        }
+        // Find a compatible payment option
+        const selected = this.selectPaymentOption(paymentRequired.accepts);
+        if (!selected) {
+            return response; // No compatible payment option
+        }
+        // Check budget
+        const amount = BigInt(selected.amount);
+        const service = new URL(urlStr).hostname;
+        const budgetCheck = this.budget.checkBudget(service, amount);
+        if (!budgetCheck.allowed) {
+            throw new X402BudgetExceededError(budgetCheck.reason, urlStr, selected);
+        }
+        // Callback check
+        if (this.config.onBeforePayment) {
+            const proceed = await this.config.onBeforePayment(selected, urlStr);
+            if (!proceed) {
+                return response;
+            }
+        }
+        // Execute payment
+        const paymentResult = await this.executePayment(selected);
+        // Build payment payload
+        const paymentPayload = {
+            x402Version: paymentRequired.x402Version,
+            resource: paymentRequired.resource,
+            accepted: selected,
+            payload: {
+                txHash: paymentResult.txHash,
+                network: selected.network,
+            },
+        };
+        // Log the transaction
+        const log = {
+            timestamp: Math.floor(Date.now() / 1000),
+            service,
+            url: urlStr,
+            amount,
+            token: selected.asset,
+            recipient: selected.payTo,
+            txHash: paymentResult.txHash,
+            network: selected.network,
+            scheme: selected.scheme,
+            success: true,
+        };
+        this.budget.recordPayment(log);
+        this.config.onPaymentComplete?.(log);
+        // Retry request with payment proof
+        const retryHeaders = new Headers(init?.headers);
+        const payloadB64 = btoa(JSON.stringify(paymentPayload));
+        retryHeaders.set('X-PAYMENT', payloadB64);
+        const retryResponse = await globalThis.fetch(url, {
+            ...init,
+            headers: retryHeaders,
+        });
+        return retryResponse;
+    }
+    /**
+     * Parse a 402 response to extract payment requirements.
+     */
+    async parse402Response(response) {
+        // Try PAYMENT-REQUIRED header first (standard x402)
+        const headerValue = response.headers.get('payment-required')
+            ?? response.headers.get('x-payment-required');
+        if (headerValue) {
+            try {
+                const decoded = JSON.parse(atob(headerValue));
+                return decoded;
+            }
+            catch {
+                // Fall through to body parsing
+            }
+        }
+        // Try JSON body as fallback
+        try {
+            const body = await response.clone().json();
+            if (body.x402Version && body.accepts) {
+                return body;
+            }
+        }
+        catch {
+            // Not parseable
+        }
+        return null;
+    }
+    /**
+     * Select the best compatible payment option from offered requirements.
+     * Prefers: Base network, USDC, exact scheme.
+     */
+    selectPaymentOption(accepts) {
+        // Filter to supported networks and known assets
+        const compatible = accepts.filter(req => {
+            if (!this.supportedNetworks.has(req.network))
+                return false;
+            const networkAssets = this.config.supportedAssets?.[req.network]
+                ?? [USDC_ADDRESSES[req.network]].filter(Boolean);
+            return networkAssets.some(a => a.toLowerCase() === req.asset.toLowerCase());
+        });
+        if (compatible.length === 0)
+            return null;
+        // Prefer "exact" scheme, then lowest amount
+        const exact = compatible.filter(r => r.scheme === 'exact');
+        const candidates = exact.length > 0 ? exact : compatible;
+        candidates.sort((a, b) => Number(BigInt(a.amount) - BigInt(b.amount)));
+        return candidates[0];
+    }
+    /**
+     * Execute the payment via AgentWallet's agentTransferToken.
+     */
+    async executePayment(req) {
+        // First check on-chain budget
+        const onChainBudget = await checkBudget(this.wallet, req.asset);
+        const amount = BigInt(req.amount);
+        if (amount > onChainBudget.perTxLimit) {
+            throw new X402PaymentError(`Amount ${amount} exceeds on-chain per-tx limit ${onChainBudget.perTxLimit}`, req);
+        }
+        if (amount > onChainBudget.remainingInPeriod) {
+            throw new X402PaymentError(`Amount ${amount} exceeds remaining period budget ${onChainBudget.remainingInPeriod}`, req);
+        }
+        // Execute the ERC20 transfer via AgentWallet
+        const txHash = await agentTransferToken(this.wallet, {
+            token: req.asset,
+            to: req.payTo,
+            amount,
+        });
+        return { txHash };
+    }
+    // ─── Budget Access ───
+    /** Get the budget tracker for direct inspection */
+    get budgetTracker() {
+        return this.budget;
+    }
+    /** Get transaction log */
+    getTransactionLog(filter) {
+        return this.budget.getTransactionLog(filter);
+    }
+    /** Get daily spend summary */
+    getDailySpendSummary() {
+        return this.budget.getDailySpendSummary();
+    }
+}
+// ─── Error Types ───
+export class X402PaymentError extends Error {
+    constructor(message, paymentRequirements) {
+        super(`x402 payment error: ${message}`);
+        this.paymentRequirements = paymentRequirements;
+        this.name = 'X402PaymentError';
+    }
+}
+export class X402BudgetExceededError extends Error {
+    constructor(reason, url, paymentRequirements) {
+        super(`x402 budget exceeded: ${reason}`);
+        this.reason = reason;
+        this.url = url;
+        this.paymentRequirements = paymentRequirements;
+        this.name = 'X402BudgetExceededError';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/x402/client.js.map

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

package/dist/x402/index.d.ts

@@ -0,0 +1,6 @@
+export { X402Client, X402PaymentError, X402BudgetExceededError } from './client.js';
+export { X402BudgetTracker } from './budget.js';
+export { createX402Client, createX402Fetch, wrapWithX402 } from './middleware.js';
+export type { X402PaymentRequired, X402PaymentRequirements, X402PaymentPayload, X402SettlementResponse, X402ResourceInfo, X402ServiceBudget, X402TransactionLog, X402ClientConfig, } from './types.js';
+export { USDC_ADDRESSES, DEFAULT_SUPPORTED_NETWORKS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/x402/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/x402/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClF,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/x402/index.js

@@ -0,0 +1,6 @@
+// [MAX-ADDED] x402 Protocol Module — HTTP 402 payment support for AgentWallet
+export { X402Client, X402PaymentError, X402BudgetExceededError } from './client.js';
+export { X402BudgetTracker } from './budget.js';
+export { createX402Client, createX402Fetch, wrapWithX402 } from './middleware.js';
+export { USDC_ADDRESSES, DEFAULT_SUPPORTED_NETWORKS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/x402/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/x402/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAWlF,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/x402/middleware.d.ts

@@ -0,0 +1,37 @@
+import type { X402ClientConfig } from './types.js';
+import { X402Client } from './client.js';
+/**
+ * [MAX-ADDED] Create an x402-aware HTTP client.
+ *
+ * Usage:
+ *   const client = createX402Client(wallet, { globalDailyLimit: 10_000_000n });
+ *   const response = await client.fetch('https://api.example.com/data');
+ *   // If the endpoint returns 402, payment is handled automatically
+ *
+ * @param wallet - AgentWallet instance from createWallet()
+ * @param config - Optional x402 client configuration
+ * @returns X402Client with .fetch() method and budget controls
+ */
+export declare function createX402Client(wallet: any, config?: X402ClientConfig): X402Client;
+/**
+ * [MAX-ADDED] Create an x402-aware fetch function (drop-in replacement).
+ *
+ * Usage:
+ *   const x402Fetch = createX402Fetch(wallet);
+ *   const response = await x402Fetch('https://api.example.com/data');
+ *
+ * @param wallet - AgentWallet instance from createWallet()
+ * @param config - Optional x402 client configuration
+ * @returns A fetch-compatible function that handles 402 payments
+ */
+export declare function createX402Fetch(wallet: any, config?: X402ClientConfig): typeof globalThis.fetch;
+/**
+ * [MAX-ADDED] Wrap an existing fetch-like function to be x402-aware.
+ * Useful for wrapping custom HTTP clients or test mocks.
+ *
+ * @param fetchFn - The original fetch function to wrap
+ * @param wallet - AgentWallet instance
+ * @param config - Optional x402 client configuration
+ */
+export declare function wrapWithX402(fetchFn: typeof globalThis.fetch, wallet: any, config?: X402ClientConfig): typeof globalThis.fetch;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/x402/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/x402/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAEnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,UAAU,CAAC,KAAK,CAMzB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK,EAChC,MAAM,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,UAAU,CAAC,KAAK,CAyBzB"}

package/dist/x402/middleware.js

@@ -0,0 +1,65 @@
+import { X402Client } from './client.js';
+/**
+ * [MAX-ADDED] Create an x402-aware HTTP client.
+ *
+ * Usage:
+ *   const client = createX402Client(wallet, { globalDailyLimit: 10_000_000n });
+ *   const response = await client.fetch('https://api.example.com/data');
+ *   // If the endpoint returns 402, payment is handled automatically
+ *
+ * @param wallet - AgentWallet instance from createWallet()
+ * @param config - Optional x402 client configuration
+ * @returns X402Client with .fetch() method and budget controls
+ */
+export function createX402Client(wallet, config) {
+    return new X402Client(wallet, config);
+}
+/**
+ * [MAX-ADDED] Create an x402-aware fetch function (drop-in replacement).
+ *
+ * Usage:
+ *   const x402Fetch = createX402Fetch(wallet);
+ *   const response = await x402Fetch('https://api.example.com/data');
+ *
+ * @param wallet - AgentWallet instance from createWallet()
+ * @param config - Optional x402 client configuration
+ * @returns A fetch-compatible function that handles 402 payments
+ */
+export function createX402Fetch(wallet, config) {
+    const client = new X402Client(wallet, config);
+    return (input, init) => {
+        const url = input instanceof Request ? input.url : input.toString();
+        return client.fetch(url, init);
+    };
+}
+/**
+ * [MAX-ADDED] Wrap an existing fetch-like function to be x402-aware.
+ * Useful for wrapping custom HTTP clients or test mocks.
+ *
+ * @param fetchFn - The original fetch function to wrap
+ * @param wallet - AgentWallet instance
+ * @param config - Optional x402 client configuration
+ */
+export function wrapWithX402(fetchFn, wallet, config) {
+    const client = new X402Client(wallet, config);
+    // Override the global fetch used by X402Client
+    const originalGlobalFetch = globalThis.fetch;
+    const wrappedClient = new X402Client(wallet, config);
+    return async (input, init) => {
+        const url = input instanceof Request ? input.url : input.toString();
+        const response = await fetchFn(input, init);
+        if (response.status !== 402) {
+            return response;
+        }
+        // Parse and handle 402 via the client
+        const paymentRequired = await wrappedClient.parse402Response(response);
+        if (!paymentRequired)
+            return response;
+        const selected = wrappedClient.selectPaymentOption(paymentRequired.accepts);
+        if (!selected)
+            return response;
+        // Use the client's fetch for retry (which calls globalThis.fetch)
+        return wrappedClient.fetch(url, init);
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/x402/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/x402/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAW,EAAE,MAAyB;IACrE,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAW,EACX,MAAyB;IAEzB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,KAA6B,EAAE,IAAkB,EAAE,EAAE;QAC3D,MAAM,GAAG,GAAG,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpE,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAgC,EAChC,MAAW,EACX,MAAyB;IAEzB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C,+CAA+C;IAC/C,MAAM,mBAAmB,GAAG,UAAU,CAAC,KAAK,CAAC;IAC7C,MAAM,aAAa,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErD,OAAO,KAAK,EAAE,KAA6B,EAAE,IAAkB,EAAE,EAAE;QACjE,MAAM,GAAG,GAAG,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAE5C,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,sCAAsC;QACtC,MAAM,eAAe,GAAG,MAAM,aAAa,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACvE,IAAI,CAAC,eAAe;YAAE,OAAO,QAAQ,CAAC;QAEtC,MAAM,QAAQ,GAAG,aAAa,CAAC,mBAAmB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE/B,kEAAkE;QAClE,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}

package/dist/x402/types.d.ts

@@ -0,0 +1,91 @@
+import type { Address, Hash } from 'viem';
+/** Resource information included in x402 responses */
+export interface X402ResourceInfo {
+    url: string;
+    description: string;
+    mimeType: string;
+}
+/** Payment requirements returned in 402 response PAYMENT-REQUIRED header */
+export interface X402PaymentRequirements {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown>;
+}
+/** Full 402 response payload (base64-decoded from PAYMENT-REQUIRED header) */
+export interface X402PaymentRequired {
+    x402Version: number;
+    error?: string;
+    resource: X402ResourceInfo;
+    accepts: X402PaymentRequirements[];
+    extensions?: Record<string, unknown>;
+}
+/** Payment payload sent back with PAYMENT-SIGNATURE header */
+export interface X402PaymentPayload {
+    x402Version: number;
+    resource: X402ResourceInfo;
+    accepted: X402PaymentRequirements;
+    payload: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+/** Settlement response returned in PAYMENT-RESPONSE header */
+export interface X402SettlementResponse {
+    success: boolean;
+    txHash?: string;
+    network?: string;
+    error?: string;
+}
+/** Per-service spending cap configuration */
+export interface X402ServiceBudget {
+    /** Domain or URL pattern (e.g. "api.example.com" or "*") */
+    service: string;
+    /** Max spend per single request in token base units */
+    maxPerRequest: bigint;
+    /** Max total spend per day in token base units */
+    dailyLimit: bigint;
+}
+/** Transaction log entry for x402 payments */
+export interface X402TransactionLog {
+    timestamp: number;
+    service: string;
+    url: string;
+    amount: bigint;
+    token: Address;
+    recipient: Address;
+    txHash: Hash;
+    network: string;
+    scheme: string;
+    success: boolean;
+    error?: string;
+}
+/** Configuration for the x402 client */
+export interface X402ClientConfig {
+    /** Service-level budget controls */
+    serviceBudgets?: X402ServiceBudget[];
+    /** Global daily spending limit (token base units, default: unlimited) */
+    globalDailyLimit?: bigint;
+    /** Global per-request max (token base units, default: unlimited) */
+    globalPerRequestMax?: bigint;
+    /** Supported networks (default: ["base:8453"]) */
+    supportedNetworks?: string[];
+    /** Supported assets by network (default: USDC on Base) */
+    supportedAssets?: Record<string, Address[]>;
+    /** Max retries after payment (default: 1) */
+    maxRetries?: number;
+    /** Custom facilitator URL (optional, for verify/settle) */
+    facilitatorUrl?: string;
+    /** Whether to auto-pay 402 responses (default: true) */
+    autoPay?: boolean;
+    /** Callback before payment — return false to reject */
+    onBeforePayment?: (req: X402PaymentRequirements, url: string) => Promise<boolean> | boolean;
+    /** Callback after payment */
+    onPaymentComplete?: (log: X402TransactionLog) => void;
+}
+/** USDC contract addresses by network */
+export declare const USDC_ADDRESSES: Record<string, Address>;
+/** Default supported networks */
+export declare const DEFAULT_SUPPORTED_NETWORKS: readonly ["base:8453"];
+//# sourceMappingURL=types.d.ts.map

package/dist/x402/types.d.ts.map

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

package/dist/x402/types.js

@@ -0,0 +1,9 @@
+// ─── Well-known Assets ───
+/** USDC contract addresses by network */
+export const USDC_ADDRESSES = {
+    'base:8453': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    'base-sepolia:84532': '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+};
+/** Default supported networks */
+export const DEFAULT_SUPPORTED_NETWORKS = ['base:8453'];
+//# sourceMappingURL=types.js.map

package/dist/x402/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/x402/types.ts"],"names":[],"mappings":"AAoGA,4BAA4B;AAE5B,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,WAAW,EAAE,4CAA4C;IACzD,oBAAoB,EAAE,4CAA4C;CAC1D,CAAC;AAEX,iCAAiC;AACjC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,WAAW,CAAU,CAAC"}