agentwallet-sdk 5.0.0 → 5.0.2

package/dist/x402/__tests__/budget.test.js.map

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

package/dist/x402/__tests__/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../../src/x402/__tests__/client.test.ts"],"names":[],"mappings":""}

package/dist/x402/__tests__/client.test.js

@@ -0,0 +1,107 @@
+// [MAX-ADDED] Tests for x402 Client — protocol parsing and payment selection
+import { describe, it, expect } from 'vitest';
+import { X402Client } from '../client.js';
+// Mock wallet (we test protocol logic, not on-chain execution)
+const mockWallet = {};
+describe('X402Client', () => {
+    describe('parse402Response', () => {
+        it('parses base64 PAYMENT-REQUIRED header', async () => {
+            const client = new X402Client(mockWallet, { autoPay: false });
+            const paymentRequired = {
+                x402Version: 1,
+                resource: { url: '/api/data', description: 'Data API', mimeType: 'application/json' },
+                accepts: [
+                    {
+                        scheme: 'exact',
+                        network: 'base:8453',
+                        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+                        amount: '1000000',
+                        payTo: '0xRecipient',
+                        maxTimeoutSeconds: 30,
+                        extra: {},
+                    },
+                ],
+            };
+            const b64 = btoa(JSON.stringify(paymentRequired));
+            const response = new Response(null, {
+                status: 402,
+                headers: { 'payment-required': b64 },
+            });
+            const parsed = await client.parse402Response(response);
+            expect(parsed).not.toBeNull();
+            expect(parsed.x402Version).toBe(1);
+            expect(parsed.accepts).toHaveLength(1);
+            expect(parsed.accepts[0].scheme).toBe('exact');
+            expect(parsed.accepts[0].amount).toBe('1000000');
+        });
+        it('parses JSON body fallback', async () => {
+            const client = new X402Client(mockWallet, { autoPay: false });
+            const paymentRequired = {
+                x402Version: 1,
+                resource: { url: '/api/data', description: 'Data', mimeType: 'application/json' },
+                accepts: [
+                    {
+                        scheme: 'exact',
+                        network: 'base:8453',
+                        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+                        amount: '500000',
+                        payTo: '0xRecipient',
+                        maxTimeoutSeconds: 30,
+                        extra: {},
+                    },
+                ],
+            };
+            const response = new Response(JSON.stringify(paymentRequired), {
+                status: 402,
+                headers: { 'content-type': 'application/json' },
+            });
+            const parsed = await client.parse402Response(response);
+            expect(parsed).not.toBeNull();
+            expect(parsed.accepts[0].amount).toBe('500000');
+        });
+        it('returns null for unparseable 402', async () => {
+            const client = new X402Client(mockWallet, { autoPay: false });
+            const response = new Response('Payment Required', { status: 402 });
+            const parsed = await client.parse402Response(response);
+            expect(parsed).toBeNull();
+        });
+    });
+    describe('selectPaymentOption', () => {
+        it('selects Base USDC exact scheme', () => {
+            const client = new X402Client(mockWallet);
+            const accepts = [
+                { scheme: 'exact', network: 'ethereum:1', asset: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+                { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected).not.toBeNull();
+            expect(selected.network).toBe('base:8453');
+        });
+        it('prefers lowest amount among compatible options', () => {
+            const client = new X402Client(mockWallet);
+            const accepts = [
+                { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '5000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+                { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected.amount).toBe('1000000');
+        });
+        it('returns null when no compatible option exists', () => {
+            const client = new X402Client(mockWallet);
+            const accepts = [
+                { scheme: 'exact', network: 'solana:mainnet', asset: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', amount: '1000000', payTo: 'sol_addr', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            expect(client.selectPaymentOption(accepts)).toBeNull();
+        });
+        it('prefers exact scheme over others', () => {
+            const client = new X402Client(mockWallet);
+            const accepts = [
+                { scheme: 'upto', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '500000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+                { scheme: 'exact', network: 'base:8453', asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', amount: '1000000', payTo: '0x1', maxTimeoutSeconds: 30, extra: {} },
+            ];
+            const selected = client.selectPaymentOption(accepts);
+            expect(selected.scheme).toBe('exact');
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/x402/__tests__/client.test.js.map

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

package/dist/x402/budget.d.ts

@@ -0,0 +1,52 @@
+import type { X402ServiceBudget, X402TransactionLog, X402ClientConfig } from './types.js';
+/**
+ * [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 declare class X402BudgetTracker {
+    private serviceBudgets;
+    private dailySpend;
+    private globalDailySpend;
+    private dailyResetTimestamp;
+    private transactionLog;
+    private globalDailyLimit;
+    private globalPerRequestMax;
+    constructor(config?: X402ClientConfig);
+    /**
+     * Check if a payment is within budget limits.
+     * Returns { allowed: true } or { allowed: false, reason: string }.
+     */
+    checkBudget(service: string, amount: bigint): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Record a completed payment.
+     */
+    recordPayment(log: X402TransactionLog): void;
+    /**
+     * Get transaction history, optionally filtered.
+     */
+    getTransactionLog(filter?: {
+        service?: string;
+        since?: number;
+    }): X402TransactionLog[];
+    /**
+     * Get current daily spend summary.
+     */
+    getDailySpendSummary(): {
+        global: bigint;
+        byService: Record<string, bigint>;
+        resetsAt: number;
+    };
+    /**
+     * Add or update a service budget at runtime.
+     */
+    setServiceBudget(budget: X402ServiceBudget): void;
+    private findServiceBudget;
+    private maybeResetDaily;
+    private startOfDay;
+}
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/x402/budget.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1F;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAA4B;IAElD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;gBAExB,MAAM,GAAE,gBAAqB;IAYzC;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IA4BnF;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAW5C;;OAEG;IACH,iBAAiB,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,kBAAkB,EAAE;IAWtF;;OAEG;IACH,oBAAoB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAa/F;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAMjD,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,UAAU;CAInB"}

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/chains/abstract/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Abstract x402 Delegated Payment Facilitator Adapter
+ *
+ * Abstract's x402 implementation uses a delegated facilitator pattern:
+ * 1. The agent wallet does NOT sign the payment tx directly
+ * 2. A "payment facilitator" contract is designated per-merchant
+ * 3. The agent's wallet delegates authorization via a signed EIP-712 permit
+ * 4. The facilitator executes the actual chain transaction
+ *
+ * Chain IDs:
+ *   - Abstract Mainnet: 2741
+ *   - Abstract Testnet: 11124
+ */
+import type { Address, Hex, WalletClient } from 'viem';
+export declare const ABSTRACT_CHAIN_IDS: {
+    readonly mainnet: 2741;
+    readonly testnet: 11124;
+};
+/** USDC on Abstract Mainnet (official Bridged USDC) */
+export declare const ABSTRACT_USDC: Record<number, Address>;
+/** Abstract's approved payment facilitator contracts */
+export declare const ABSTRACT_APPROVED_FACILITATORS: Address[];
+export interface AbstractDelegatedPaymentConfig {
+    /** The facilitator contract address (must be on approved list or user-allowlisted) */
+    facilitatorAddress: Address;
+    /** Token to pay with (default: USDC on Abstract) */
+    token?: Address;
+    /** Permit deadline in seconds from now (default: 300 = 5 min) */
+    deadlineSeconds?: number;
+    /** User-allowlisted facilitator addresses (extends the approved list) */
+    userAllowlist?: Address[];
+}
+export interface DelegatedPaymentPermit {
+    facilitator: Address;
+    token: Address;
+    amount: bigint;
+    payTo: Address;
+    nonce: bigint;
+    deadline: bigint;
+    resource: string;
+}
+export interface AbstractPaymentResult {
+    /** EIP-712 signature for the facilitator permit */
+    permitSignature: Hex;
+    /** Encoded permit data to submit to the facilitator contract */
+    permitData: Hex;
+    /** The permit fields for verification */
+    permit: DelegatedPaymentPermit;
+    /** Chain ID this payment is valid on */
+    chainId: number;
+}
+/**
+ * Adapter for Abstract's delegated payment facilitator x402 model.
+ *
+ * Instead of signing a direct payment transaction, the agent signs an EIP-712
+ * permit authorizing a facilitator contract to execute the payment on its behalf.
+ * This is Abstract's model — the agent's keys never touch the chain directly.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new AbstractDelegatedFacilitatorAdapter(walletClient, {
+ *   facilitatorAddress: '0x5FbDB2315678afecb367f032d93F642f64180aa3',
+ * });
+ *
+ * const result = await adapter.signPaymentPermit({
+ *   amount: 1_000_000n, // 1 USDC (6 decimals)
+ *   payTo: '0xmerchant...',
+ *   nonce: 0n,
+ *   resource: 'https://api.example.com/resource',
+ * });
+ * ```
+ */
+export declare class AbstractDelegatedFacilitatorAdapter {
+    private walletClient;
+    private config;
+    private chainId;
+    constructor(walletClient: WalletClient, config: AbstractDelegatedPaymentConfig, chainId?: number);
+    /**
+     * Sign an EIP-712 delegated payment permit for the Abstract facilitator.
+     * This replaces direct tx signing — the permit is submitted to the facilitator contract.
+     */
+    signPaymentPermit(params: {
+        amount: bigint;
+        payTo: Address;
+        nonce: bigint;
+        resource: string;
+    }): Promise<AbstractPaymentResult>;
+    /**
+     * Build the x402 payment payload for Abstract's delegated facilitator model.
+     * This payload replaces the standard txHash payload in the X-PAYMENT header.
+     */
+    buildX402Payload(params: {
+        amount: bigint;
+        payTo: Address;
+        nonce: bigint;
+        resource: string;
+    }): Promise<Record<string, unknown>>;
+    /** Check if a chain ID is an Abstract chain */
+    static isAbstractChain(chainId: number): boolean;
+    /** Get the network string for x402 payment requirements (e.g. "abstract:2741") */
+    static getNetworkString(chainId: number): string;
+}
+/**
+ * Abstract chain IDs to add to SUPPORTED_CHAINS in the main SDK.
+ * These route through AbstractDelegatedFacilitatorAdapter for x402 payments.
+ */
+export declare const ABSTRACT_SUPPORTED_CHAINS: {
+    readonly 'abstract:2741': {
+        readonly chainId: 2741;
+        readonly name: "Abstract Mainnet";
+        readonly rpcUrl: "https://api.mainnet.abs.xyz";
+        readonly nativeCurrency: {
+            readonly name: "Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        readonly blockExplorer: "https://explorer.mainnet.abs.xyz";
+        readonly x402Model: "delegated-facilitator";
+        readonly usdc: `0x${string}`;
+    };
+    readonly 'abstract-testnet:11124': {
+        readonly chainId: 11124;
+        readonly name: "Abstract Testnet";
+        readonly rpcUrl: "https://api.testnet.abs.xyz";
+        readonly nativeCurrency: {
+            readonly name: "Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        readonly blockExplorer: "https://explorer.testnet.abs.xyz";
+        readonly x402Model: "delegated-facilitator";
+        readonly usdc: `0x${string}`;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/x402/chains/abstract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAQ,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAK7D,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAGjD,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,8BAA8B,EAAE,OAAO,EAEnD,CAAC;AAwBF,MAAM,WAAW,8BAA8B;IAC7C,sFAAsF;IACtF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,eAAe,EAAE,GAAG,CAAC;IACrB,gEAAgE;IAChE,UAAU,EAAE,GAAG,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mCAAmC;IAC9C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,OAAO,CAAS;gBAGtB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,8BAA8B,EACtC,OAAO,GAAE,MAAmC;IA4B9C;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoDlC;;;OAGG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkBpC,+CAA+C;IAC/C,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhD,kFAAkF;IAClF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGjD;AAID;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmB5B,CAAC"}

package/dist/x402/chains/abstract/index.js

@@ -0,0 +1,190 @@
+/**
+ * Abstract x402 Delegated Payment Facilitator Adapter
+ *
+ * Abstract's x402 implementation uses a delegated facilitator pattern:
+ * 1. The agent wallet does NOT sign the payment tx directly
+ * 2. A "payment facilitator" contract is designated per-merchant
+ * 3. The agent's wallet delegates authorization via a signed EIP-712 permit
+ * 4. The facilitator executes the actual chain transaction
+ *
+ * Chain IDs:
+ *   - Abstract Mainnet: 2741
+ *   - Abstract Testnet: 11124
+ */
+import { encodeAbiParameters, parseAbiParameters } from 'viem';
+// ─── Abstract Chain Constants ────────────────────────────────────────────────
+export const ABSTRACT_CHAIN_IDS = {
+    mainnet: 2741,
+    testnet: 11124,
+};
+/** USDC on Abstract Mainnet (official Bridged USDC) */
+export const ABSTRACT_USDC = {
+    2741: '0x84A71ccD554Cc1b02749b35d22F684CC8ec987e1', // Abstract Mainnet USDC
+    11124: '0x3eBdeaA0DB3FfDe96E7a0DBBAFEC961FC50F725f', // Abstract Testnet USDC
+};
+/** Abstract's approved payment facilitator contracts */
+export const ABSTRACT_APPROVED_FACILITATORS = [
+    '0x5FbDB2315678afecb367f032d93F642f64180aa3', // Abstract official facilitator (mainnet)
+];
+// ─── EIP-712 Types for Abstract Delegated Payment ───────────────────────────
+const ABSTRACT_PERMIT_DOMAIN = {
+    name: 'AbstractDelegatedPayment',
+    version: '1',
+    chainId: ABSTRACT_CHAIN_IDS.mainnet,
+};
+const ABSTRACT_PERMIT_TYPES = {
+    DelegatedPaymentPermit: [
+        { name: 'facilitator', type: 'address' },
+        { name: 'token', type: 'address' },
+        { name: 'amount', type: 'uint256' },
+        { name: 'payTo', type: 'address' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'deadline', type: 'uint256' },
+        { name: 'resource', type: 'string' },
+    ],
+};
+// ─── AbstractDelegatedFacilitatorAdapter ─────────────────────────────────────
+/**
+ * Adapter for Abstract's delegated payment facilitator x402 model.
+ *
+ * Instead of signing a direct payment transaction, the agent signs an EIP-712
+ * permit authorizing a facilitator contract to execute the payment on its behalf.
+ * This is Abstract's model — the agent's keys never touch the chain directly.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new AbstractDelegatedFacilitatorAdapter(walletClient, {
+ *   facilitatorAddress: '0x5FbDB2315678afecb367f032d93F642f64180aa3',
+ * });
+ *
+ * const result = await adapter.signPaymentPermit({
+ *   amount: 1_000_000n, // 1 USDC (6 decimals)
+ *   payTo: '0xmerchant...',
+ *   nonce: 0n,
+ *   resource: 'https://api.example.com/resource',
+ * });
+ * ```
+ */
+export class AbstractDelegatedFacilitatorAdapter {
+    constructor(walletClient, config, chainId = ABSTRACT_CHAIN_IDS.mainnet) {
+        this.walletClient = walletClient;
+        this.chainId = chainId;
+        // Validate facilitator
+        const approved = [
+            ...ABSTRACT_APPROVED_FACILITATORS,
+            ...(config.userAllowlist ?? []),
+        ];
+        const isApproved = approved.some((a) => a.toLowerCase() === config.facilitatorAddress.toLowerCase());
+        if (!isApproved) {
+            throw new Error(`Facilitator ${config.facilitatorAddress} is not on the Abstract approved list. ` +
+                `Pass it in userAllowlist to explicitly allow it.`);
+        }
+        this.config = {
+            facilitatorAddress: config.facilitatorAddress,
+            token: config.token ?? ABSTRACT_USDC[chainId] ?? ABSTRACT_USDC[ABSTRACT_CHAIN_IDS.mainnet],
+            deadlineSeconds: config.deadlineSeconds ?? 300,
+            userAllowlist: config.userAllowlist ?? [],
+        };
+    }
+    /**
+     * Sign an EIP-712 delegated payment permit for the Abstract facilitator.
+     * This replaces direct tx signing — the permit is submitted to the facilitator contract.
+     */
+    async signPaymentPermit(params) {
+        const deadline = BigInt(Math.floor(Date.now() / 1000) + this.config.deadlineSeconds);
+        const permit = {
+            facilitator: this.config.facilitatorAddress,
+            token: this.config.token,
+            amount: params.amount,
+            payTo: params.payTo,
+            nonce: params.nonce,
+            deadline,
+            resource: params.resource,
+        };
+        const domain = {
+            ...ABSTRACT_PERMIT_DOMAIN,
+            chainId: this.chainId,
+        };
+        const account = this.walletClient.account;
+        if (!account)
+            throw new Error('WalletClient has no account attached');
+        const signature = await this.walletClient.signTypedData({
+            account,
+            domain,
+            types: ABSTRACT_PERMIT_TYPES,
+            primaryType: 'DelegatedPaymentPermit',
+            message: permit,
+        });
+        // Encode the permit for submission to the facilitator contract
+        const permitData = encodeAbiParameters(parseAbiParameters('address facilitator, address token, uint256 amount, address payTo, uint256 nonce, uint256 deadline, string resource, bytes signature'), [
+            permit.facilitator,
+            permit.token,
+            permit.amount,
+            permit.payTo,
+            permit.nonce,
+            permit.deadline,
+            permit.resource,
+            signature,
+        ]);
+        return {
+            permitSignature: signature,
+            permitData,
+            permit,
+            chainId: this.chainId,
+        };
+    }
+    /**
+     * Build the x402 payment payload for Abstract's delegated facilitator model.
+     * This payload replaces the standard txHash payload in the X-PAYMENT header.
+     */
+    async buildX402Payload(params) {
+        const result = await this.signPaymentPermit(params);
+        return {
+            scheme: 'abstract-delegated',
+            chainId: result.chainId,
+            facilitator: result.permit.facilitator,
+            token: result.permit.token,
+            amount: result.permit.amount.toString(),
+            payTo: result.permit.payTo,
+            nonce: result.permit.nonce.toString(),
+            deadline: result.permit.deadline.toString(),
+            resource: result.permit.resource,
+            permitSignature: result.permitSignature,
+            permitData: result.permitData,
+        };
+    }
+    /** Check if a chain ID is an Abstract chain */
+    static isAbstractChain(chainId) {
+        return Object.values(ABSTRACT_CHAIN_IDS).includes(chainId);
+    }
+    /** Get the network string for x402 payment requirements (e.g. "abstract:2741") */
+    static getNetworkString(chainId) {
+        return `abstract:${chainId}`;
+    }
+}
+// ─── SUPPORTED_CHAINS Extension ──────────────────────────────────────────────
+/**
+ * Abstract chain IDs to add to SUPPORTED_CHAINS in the main SDK.
+ * These route through AbstractDelegatedFacilitatorAdapter for x402 payments.
+ */
+export const ABSTRACT_SUPPORTED_CHAINS = {
+    'abstract:2741': {
+        chainId: ABSTRACT_CHAIN_IDS.mainnet,
+        name: 'Abstract Mainnet',
+        rpcUrl: 'https://api.mainnet.abs.xyz',
+        nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+        blockExplorer: 'https://explorer.mainnet.abs.xyz',
+        x402Model: 'delegated-facilitator',
+        usdc: ABSTRACT_USDC[ABSTRACT_CHAIN_IDS.mainnet],
+    },
+    'abstract-testnet:11124': {
+        chainId: ABSTRACT_CHAIN_IDS.testnet,
+        name: 'Abstract Testnet',
+        rpcUrl: 'https://api.testnet.abs.xyz',
+        nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+        blockExplorer: 'https://explorer.testnet.abs.xyz',
+        x402Model: 'delegated-facilitator',
+        usdc: ABSTRACT_USDC[ABSTRACT_CHAIN_IDS.testnet],
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/x402/chains/abstract/index.js.map

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