@agirails/sdk 2.3.0 → 2.3.3

package/dist/wallet/aa/BundlerClient.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * BundlerClient — JSON-RPC client for ERC-4337 bundlers.
+ *
+ * Supports Coinbase (primary) and Pimlico (backup) bundlers.
+ * Handles gas estimation, UserOp submission, and receipt polling.
+ * Retry with exponential backoff on transient failures.
+ *
+ * @module wallet/aa/BundlerClient
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundlerClient = void 0;
+const UserOpBuilder_1 = require("./UserOpBuilder");
+const constants_1 = require("./constants");
+const Logger_1 = require("../../utils/Logger");
+// ============================================================================
+// BundlerClient
+// ============================================================================
+class BundlerClient {
+    constructor(config) {
+        this.requestId = 1;
+        this.primaryUrl = config.primaryUrl;
+        this.backupUrl = config.backupUrl;
+        this.maxRetries = config.maxRetries ?? 2;
+        this.baseDelayMs = config.baseDelayMs ?? 1000;
+        this.timeoutMs = config.timeoutMs ?? 30000;
+    }
+    /**
+     * Estimate gas for a UserOp.
+     */
+    async estimateUserOperationGas(userOp) {
+        const result = await this.callWithFallback('eth_estimateUserOperationGas', [
+            (0, UserOpBuilder_1.serializeUserOp)(userOp),
+            constants_1.ENTRYPOINT_V06,
+        ]);
+        return {
+            callGasLimit: BigInt(result.callGasLimit),
+            verificationGasLimit: BigInt(result.verificationGasLimit),
+            preVerificationGas: BigInt(result.preVerificationGas),
+        };
+    }
+    /**
+     * Submit a signed UserOp to the bundler.
+     * Returns the UserOp hash.
+     */
+    async sendUserOperation(userOp) {
+        return this.callWithFallback('eth_sendUserOperation', [
+            (0, UserOpBuilder_1.serializeUserOp)(userOp),
+            constants_1.ENTRYPOINT_V06,
+        ]);
+    }
+    /**
+     * Get the receipt for a submitted UserOp.
+     * Returns null if not yet mined.
+     */
+    async getUserOperationReceipt(userOpHash) {
+        const result = await this.callWithFallback('eth_getUserOperationReceipt', [userOpHash]);
+        if (!result)
+            return null;
+        return {
+            userOpHash: result.userOpHash,
+            transactionHash: result.receipt.transactionHash,
+            blockNumber: parseInt(result.receipt.blockNumber, 16),
+            success: result.success,
+        };
+    }
+    /**
+     * Wait for UserOp receipt with polling.
+     */
+    async waitForReceipt(userOpHash, timeoutMs = 60000, pollIntervalMs = 2000) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const receipt = await this.getUserOperationReceipt(userOpHash);
+            if (receipt)
+                return receipt;
+            await sleep(pollIntervalMs);
+        }
+        throw new Error(`UserOp ${userOpHash} not mined after ${timeoutMs}ms. ` +
+            'The transaction may still be pending — check the bundler or block explorer.');
+    }
+    // ==========================================================================
+    // Internal
+    // ==========================================================================
+    /**
+     * Call primary, fall back to backup, with retries and backoff.
+     */
+    async callWithFallback(method, params) {
+        // Try primary
+        try {
+            return await this.callWithRetry(this.primaryUrl, method, params);
+        }
+        catch (primaryError) {
+            if (!this.backupUrl) {
+                throw primaryError;
+            }
+            Logger_1.sdkLogger.warn('Primary bundler failed, trying backup', {
+                method,
+                error: primaryError instanceof Error ? primaryError.message : String(primaryError),
+            });
+        }
+        // Try backup
+        return this.callWithRetry(this.backupUrl, method, params);
+    }
+    async callWithRetry(url, method, params) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await this.jsonRpc(url, method, params);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Don't retry non-transient errors
+                if (isNonTransient(lastError))
+                    throw lastError;
+                if (attempt < this.maxRetries) {
+                    const delay = this.baseDelayMs * Math.pow(2, attempt);
+                    Logger_1.sdkLogger.warn('Bundler request failed, retrying', {
+                        attempt: attempt + 1,
+                        method,
+                        delayMs: delay,
+                    });
+                    await sleep(delay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    async jsonRpc(url, method, params) {
+        const body = JSON.stringify({
+            jsonrpc: '2.0',
+            id: this.requestId++,
+            method,
+            params,
+        });
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const json = (await response.json());
+            if (json.error) {
+                const dataStr = json.error.data ? ` | data: ${JSON.stringify(json.error.data)}` : '';
+                const err = new Error(`Bundler RPC error ${json.error.code}: ${json.error.message}${dataStr}`);
+                err.code = json.error.code;
+                err.data = json.error.data;
+                throw err;
+            }
+            return json.result;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+exports.BundlerClient = BundlerClient;
+// ============================================================================
+// Helpers
+// ============================================================================
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Detect non-transient errors that shouldn't be retried.
+ */
+function isNonTransient(error) {
+    const code = error.code;
+    // AA errors from bundler (invalid signature, insufficient funds, etc.)
+    if (typeof code === 'number' && code >= -32700 && code <= -32600) {
+        return true; // JSON-RPC parse/invalid request errors
+    }
+    const msg = error.message.toLowerCase();
+    if (msg.includes('aa') && (msg.includes('invalid') || msg.includes('rejected'))) {
+        return true; // AA validation errors
+    }
+    return false;
+}
+//# sourceMappingURL=BundlerClient.js.map

package/dist/wallet/aa/BundlerClient.js.map

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

package/dist/wallet/aa/DualNonceManager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DualNonceManager — Manages both EntryPoint and ACTP nonces.
+ *
+ * ERC-4337 UserOps need two independent nonces:
+ *   1. EntryPoint nonce — anti-replay for the UserOp itself
+ *   2. ACTP nonce — used to compute deterministic txId
+ *
+ * This manager uses a sequential mutex queue to ensure:
+ *   - Only one UserOp is in-flight at a time
+ *   - ACTP nonce increments only on confirmed receipt
+ *   - On failure, next call re-reads from chain
+ *
+ * @module wallet/aa/DualNonceManager
+ */
+import { ethers } from 'ethers';
+export declare class DualNonceManager {
+    private readonly provider;
+    private readonly senderAddress;
+    private readonly actpKernelAddress;
+    private readonly mutex;
+    /** Locally cached ACTP nonce — undefined means "re-read from chain" */
+    private cachedActpNonce;
+    constructor(provider: ethers.JsonRpcProvider, senderAddress: string, actpKernelAddress: string);
+    /**
+     * Execute a callback while holding the nonce mutex.
+     *
+     * The callback receives current nonces and must return whether
+     * the operation succeeded (to decide ACTP nonce increment).
+     *
+     * @param fn Callback receiving { entryPointNonce, actpNonce }
+     * @param incrementsActpNonce Whether success increments the ACTP nonce
+     */
+    enqueue<T>(fn: (nonces: {
+        entryPointNonce: bigint;
+        actpNonce: bigint;
+    }) => Promise<{
+        result: T;
+        success: boolean;
+    }>, incrementsActpNonce?: boolean): Promise<T>;
+    /**
+     * Read current EntryPoint nonce for the sender.
+     * Key 0 is the default key for CoinbaseSmartWallet.
+     */
+    private readEntryPointNonce;
+    /**
+     * Read current ACTP nonce for the requester.
+     * requesterNonces is public on ACTPKernel (added in v2).
+     * Older deployments may not expose this — fall back to 0n.
+     */
+    private readActpNonce;
+    /**
+     * Invalidate cached ACTP nonce (forces re-read on next operation).
+     */
+    invalidateCache(): void;
+}
+//# sourceMappingURL=DualNonceManager.d.ts.map

package/dist/wallet/aa/DualNonceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DualNonceManager.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/DualNonceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAgDhC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAAqB;gBAG1C,QAAQ,EAAE,MAAM,CAAC,eAAe,EAChC,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM;IAO3B;;;;;;;;OAQG;IACG,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,CAAC,MAAM,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QACtE,MAAM,EAAE,CAAC,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,EACF,mBAAmB,GAAE,OAAc,GAClC,OAAO,CAAC,CAAC,CAAC;IA+Bb;;;OAGG;YACW,mBAAmB;IASjC;;;;OAIG;YACW,aAAa;IAoB3B;;OAEG;IACH,eAAe,IAAI,IAAI;CAGxB"}

package/dist/wallet/aa/DualNonceManager.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * DualNonceManager — Manages both EntryPoint and ACTP nonces.
+ *
+ * ERC-4337 UserOps need two independent nonces:
+ *   1. EntryPoint nonce — anti-replay for the UserOp itself
+ *   2. ACTP nonce — used to compute deterministic txId
+ *
+ * This manager uses a sequential mutex queue to ensure:
+ *   - Only one UserOp is in-flight at a time
+ *   - ACTP nonce increments only on confirmed receipt
+ *   - On failure, next call re-reads from chain
+ *
+ * @module wallet/aa/DualNonceManager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DualNonceManager = void 0;
+const ethers_1 = require("ethers");
+const constants_1 = require("./constants");
+const Logger_1 = require("../../utils/Logger");
+// ============================================================================
+// ABI fragments
+// ============================================================================
+const ENTRYPOINT_NONCE_ABI = [
+    'function getNonce(address sender, uint192 key) view returns (uint256)',
+];
+const ACTP_KERNEL_NONCE_ABI = [
+    'function requesterNonces(address requester) view returns (uint256)',
+];
+// ============================================================================
+// Mutex
+// ============================================================================
+class Mutex {
+    constructor() {
+        this.locked = false;
+        this.queue = [];
+    }
+    async acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        if (this.queue.length > 0) {
+            const next = this.queue.shift();
+            next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+}
+// ============================================================================
+// DualNonceManager
+// ============================================================================
+class DualNonceManager {
+    constructor(provider, senderAddress, actpKernelAddress) {
+        this.mutex = new Mutex();
+        this.provider = provider;
+        this.senderAddress = senderAddress;
+        this.actpKernelAddress = actpKernelAddress;
+    }
+    /**
+     * Execute a callback while holding the nonce mutex.
+     *
+     * The callback receives current nonces and must return whether
+     * the operation succeeded (to decide ACTP nonce increment).
+     *
+     * @param fn Callback receiving { entryPointNonce, actpNonce }
+     * @param incrementsActpNonce Whether success increments the ACTP nonce
+     */
+    async enqueue(fn, incrementsActpNonce = true) {
+        await this.mutex.acquire();
+        try {
+            // Read nonces
+            const entryPointNonce = await this.readEntryPointNonce();
+            const actpNonce = this.cachedActpNonce ?? await this.readActpNonce();
+            Logger_1.sdkLogger.info('Nonces acquired', {
+                entryPointNonce: entryPointNonce.toString(),
+                actpNonce: actpNonce.toString(),
+            });
+            const { result, success } = await fn({ entryPointNonce, actpNonce });
+            if (success && incrementsActpNonce) {
+                this.cachedActpNonce = actpNonce + 1n;
+            }
+            else if (!success) {
+                // Reset cache on failure — next call re-reads from chain
+                this.cachedActpNonce = undefined;
+            }
+            return result;
+        }
+        catch (error) {
+            // Reset on error
+            this.cachedActpNonce = undefined;
+            throw error;
+        }
+        finally {
+            this.mutex.release();
+        }
+    }
+    /**
+     * Read current EntryPoint nonce for the sender.
+     * Key 0 is the default key for CoinbaseSmartWallet.
+     */
+    async readEntryPointNonce() {
+        const entryPoint = new ethers_1.ethers.Contract(constants_1.ENTRYPOINT_V06, ENTRYPOINT_NONCE_ABI, this.provider);
+        return await entryPoint.getNonce(this.senderAddress, 0);
+    }
+    /**
+     * Read current ACTP nonce for the requester.
+     * requesterNonces is public on ACTPKernel (added in v2).
+     * Older deployments may not expose this — fall back to 0n.
+     */
+    async readActpNonce() {
+        try {
+            const kernel = new ethers_1.ethers.Contract(this.actpKernelAddress, ACTP_KERNEL_NONCE_ABI, this.provider);
+            const nonce = await kernel.requesterNonces(this.senderAddress);
+            this.cachedActpNonce = nonce;
+            return nonce;
+        }
+        catch {
+            // Older ACTPKernel deployments don't expose requesterNonces.
+            // Return 0n — registration doesn't need it, and payment batches
+            // will fail at the contract level anyway if nonces are wrong.
+            Logger_1.sdkLogger.warn('requesterNonces not available on ACTPKernel — using 0 (older deployment?)');
+            this.cachedActpNonce = 0n;
+            return 0n;
+        }
+    }
+    /**
+     * Invalidate cached ACTP nonce (forces re-read on next operation).
+     */
+    invalidateCache() {
+        this.cachedActpNonce = undefined;
+    }
+}
+exports.DualNonceManager = DualNonceManager;
+//# sourceMappingURL=DualNonceManager.js.map

package/dist/wallet/aa/DualNonceManager.js.map

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

package/dist/wallet/aa/PaymasterClient.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PaymasterClient — Gas sponsorship via ERC-7677 paymasters.
+ *
+ * Fallback chain: Coinbase CDP (primary) → Pimlico (backup).
+ * Both implement ERC-7677 pm_getPaymasterStubData / pm_getPaymasterData.
+ *
+ * The paymaster fills the `paymasterAndData` field of the UserOp,
+ * which the EntryPoint uses to debit gas from the paymaster instead
+ * of the sender's ETH balance.
+ *
+ * @module wallet/aa/PaymasterClient
+ */
+import { UserOperationV06 } from './constants';
+export interface PaymasterConfig {
+    /** Primary paymaster URL (Coinbase CDP) */
+    primaryUrl: string;
+    /** Backup paymaster URL (Pimlico) */
+    backupUrl?: string;
+    /** Chain ID (8453 for Base Mainnet, 84532 for Sepolia) */
+    chainId: number;
+    /** Request timeout (ms) */
+    timeoutMs?: number;
+}
+export declare class PaymasterClient {
+    private readonly primaryUrl;
+    private readonly backupUrl;
+    private readonly chainId;
+    private readonly timeoutMs;
+    private requestId;
+    constructor(config: PaymasterConfig);
+    /**
+     * Get stub paymaster data for gas estimation.
+     *
+     * Returns approximate paymasterAndData that the bundler can use
+     * for gas estimation (exact values come from getPaymasterData).
+     */
+    getPaymasterStubData(userOp: UserOperationV06): Promise<{
+        paymasterAndData: string;
+    }>;
+    /**
+     * Get final paymaster data for the signed UserOp.
+     *
+     * This is called after gas estimation with final gas values.
+     * Returns the paymaster signature that goes into paymasterAndData.
+     */
+    getPaymasterData(userOp: UserOperationV06): Promise<{
+        paymasterAndData: string;
+    }>;
+    private callWithFallback;
+    private jsonRpc;
+}
+//# sourceMappingURL=PaymasterClient.d.ts.map

package/dist/wallet/aa/PaymasterClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymasterClient.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/PaymasterClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAS/C,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,EAAE,eAAe;IAOnC;;;;;OAKG;IACG,oBAAoB,CACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAYxC;;;;;OAKG;IACG,gBAAgB,CACpB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;YAgB1B,gBAAgB;YA8BhB,OAAO;CAyCtB"}

package/dist/wallet/aa/PaymasterClient.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * PaymasterClient — Gas sponsorship via ERC-7677 paymasters.
+ *
+ * Fallback chain: Coinbase CDP (primary) → Pimlico (backup).
+ * Both implement ERC-7677 pm_getPaymasterStubData / pm_getPaymasterData.
+ *
+ * The paymaster fills the `paymasterAndData` field of the UserOp,
+ * which the EntryPoint uses to debit gas from the paymaster instead
+ * of the sender's ETH balance.
+ *
+ * @module wallet/aa/PaymasterClient
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymasterClient = void 0;
+const UserOpBuilder_1 = require("./UserOpBuilder");
+const constants_1 = require("./constants");
+const Logger_1 = require("../../utils/Logger");
+// ============================================================================
+// PaymasterClient
+// ============================================================================
+class PaymasterClient {
+    constructor(config) {
+        this.requestId = 1;
+        this.primaryUrl = config.primaryUrl;
+        this.backupUrl = config.backupUrl;
+        this.chainId = config.chainId;
+        this.timeoutMs = config.timeoutMs ?? 15000;
+    }
+    /**
+     * Get stub paymaster data for gas estimation.
+     *
+     * Returns approximate paymasterAndData that the bundler can use
+     * for gas estimation (exact values come from getPaymasterData).
+     */
+    async getPaymasterStubData(userOp) {
+        return this.callWithFallback('pm_getPaymasterStubData', [
+            (0, UserOpBuilder_1.serializeUserOp)(userOp),
+            constants_1.ENTRYPOINT_V06,
+            '0x' + this.chainId.toString(16),
+            {}, // context
+        ]);
+    }
+    /**
+     * Get final paymaster data for the signed UserOp.
+     *
+     * This is called after gas estimation with final gas values.
+     * Returns the paymaster signature that goes into paymasterAndData.
+     */
+    async getPaymasterData(userOp) {
+        return this.callWithFallback('pm_getPaymasterData', [
+            (0, UserOpBuilder_1.serializeUserOp)(userOp),
+            constants_1.ENTRYPOINT_V06,
+            '0x' + this.chainId.toString(16),
+            {}, // context
+        ]);
+    }
+    // ==========================================================================
+    // Internal
+    // ==========================================================================
+    async callWithFallback(method, params) {
+        try {
+            return await this.jsonRpc(this.primaryUrl, method, params);
+        }
+        catch (primaryError) {
+            if (!this.backupUrl) {
+                throw new Error(`Gas sponsorship unavailable: ${primaryError instanceof Error ? primaryError.message : String(primaryError)}. ` +
+                    'No backup paymaster configured.');
+            }
+            Logger_1.sdkLogger.warn('Primary paymaster failed, trying backup', {
+                method,
+                error: primaryError instanceof Error ? primaryError.message : String(primaryError),
+            });
+        }
+        try {
+            return await this.jsonRpc(this.backupUrl, method, params);
+        }
+        catch (backupError) {
+            throw new Error('Gas sponsorship temporarily unavailable — both Coinbase and Pimlico paymasters failed. ' +
+                'Please retry later. ' +
+                `Primary: ${backupError instanceof Error ? backupError.message : String(backupError)}`);
+        }
+    }
+    async jsonRpc(url, method, params) {
+        const body = JSON.stringify({
+            jsonrpc: '2.0',
+            id: this.requestId++,
+            method,
+            params,
+        });
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const json = (await response.json());
+            if (json.error) {
+                const dataStr = json.error.data ? ` | data: ${JSON.stringify(json.error.data)}` : '';
+                throw new Error(`Paymaster RPC error ${json.error.code}: ${json.error.message}${dataStr}`);
+            }
+            return json.result;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+exports.PaymasterClient = PaymasterClient;
+//# sourceMappingURL=PaymasterClient.js.map

package/dist/wallet/aa/PaymasterClient.js.map

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

package/dist/wallet/aa/TransactionBatcher.d.ts

@@ -0,0 +1,87 @@
+/**
+ * TransactionBatcher — Encodes ACTP multi-call batches.
+ *
+ * An ACTP payment requires 3 contract calls:
+ *   1. USDC.approve(escrowVault, amount)
+ *   2. ACTPKernel.createTransaction(provider, requester, amount, deadline, disputeWindow, serviceHash, agentId)
+ *   3. ACTPKernel.linkEscrow(txId, escrowVault, escrowId)
+ *
+ * TransactionBatcher encodes all 3 as SmartWalletCall[] for executeBatch.
+ * It pre-computes the txId using the same keccak256 formula as the contract.
+ *
+ * @module wallet/aa/TransactionBatcher
+ */
+import { SmartWalletCall } from './constants';
+import { ServiceDescriptor } from '../../types/agent';
+export interface ACTPBatchParams {
+    /** Provider address */
+    provider: string;
+    /** Requester address (= Smart Wallet address) */
+    requester: string;
+    /** Amount in USDC wei (e.g., "1000000" for 1 USDC) */
+    amount: string;
+    /** Unix timestamp deadline */
+    deadline: number;
+    /** Dispute window in seconds */
+    disputeWindow: number;
+    /** Service hash (bytes32) */
+    serviceHash: string;
+    /** ERC-8004 agent ID (0 if none) */
+    agentId: string;
+    /** Current ACTP nonce for the requester (from ACTPKernel.requesterNonces) */
+    actpNonce: bigint;
+    /** Contract addresses */
+    contracts: {
+        usdc: string;
+        actpKernel: string;
+        escrowVault: string;
+    };
+}
+export interface ACTPBatchResult {
+    /** Encoded SmartWalletCall[] ready for executeBatch */
+    calls: SmartWalletCall[];
+    /** Pre-computed transaction ID */
+    txId: string;
+}
+/**
+ * Pre-compute ACTP transaction ID.
+ *
+ * Matches ACTPKernel.sol:
+ *   transactionId = keccak256(abi.encodePacked(requester, provider, amount, serviceHash, nonce))
+ */
+export declare function computeTransactionId(requester: string, provider: string, amount: string, serviceHash: string, nonce: bigint): string;
+/**
+ * Build the 3-call ACTP payment batch.
+ *
+ * Returns SmartWalletCall[] for executeBatch and the pre-computed txId.
+ */
+export declare function buildACTPPayBatch(params: ACTPBatchParams): ACTPBatchResult;
+/**
+ * Build a register-agent batch for AgentRegistry.
+ *
+ * Used for bootstrap registration (gasless even before registration — chicken-and-egg).
+ *
+ * @param agentRegistryAddress - AgentRegistry contract address
+ * @param endpoint - Agent webhook / IPFS gateway URL
+ * @param serviceDescriptors - At least 1 service descriptor (contract requirement)
+ */
+export declare function buildRegisterAgentBatch(agentRegistryAddress: string, endpoint: string, serviceDescriptors: ServiceDescriptor[]): SmartWalletCall[];
+/**
+ * Build a MockUSDC mint call (testnet only).
+ */
+export declare function buildTestnetMintBatch(mockUsdcAddress: string, recipient: string, amount: string): SmartWalletCall[];
+/**
+ * Build a combined register + mint batch for testnet init.
+ *
+ * Single UserOp: register on AgentRegistry + mint test USDC.
+ * Both are bootstrap-allowed (gasless without prior registration).
+ */
+export declare function buildTestnetInitBatch(params: {
+    agentRegistryAddress: string;
+    endpoint: string;
+    serviceDescriptors: ServiceDescriptor[];
+    mockUsdcAddress: string;
+    recipient: string;
+    mintAmount: string;
+}): SmartWalletCall[];
+//# sourceMappingURL=TransactionBatcher.d.ts.map