@agirails/sdk 2.2.3 → 2.3.1

package/dist/wallet/AutoWalletProvider.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * AutoWalletProvider — Tier 1 (Auto) wallet implementation.
+ *
+ * Creates a CoinbaseSmartWallet with gas-sponsored transactions:
+ *   1. Load/generate local encrypted key
+ *   2. Derive Smart Wallet address (counterfactual CREATE2)
+ *   3. Check AgentRegistry registration
+ *   4. Build UserOp with executeBatch
+ *   5. Get paymaster sponsorship (Coinbase → Pimlico fallback)
+ *   6. Submit via bundler
+ *
+ * If agent is NOT registered, falls back to EOA behavior with a warning.
+ *
+ * @module wallet/AutoWalletProvider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoWalletProvider = void 0;
+const ethers_1 = require("ethers");
+const UserOpBuilder_1 = require("./aa/UserOpBuilder");
+const UserOpBuilder_2 = require("./aa/UserOpBuilder");
+const BundlerClient_1 = require("./aa/BundlerClient");
+const PaymasterClient_1 = require("./aa/PaymasterClient");
+const DualNonceManager_1 = require("./aa/DualNonceManager");
+const TransactionBatcher_1 = require("./aa/TransactionBatcher");
+const Logger_1 = require("../utils/Logger");
+// ============================================================================
+// AutoWalletProvider
+// ============================================================================
+class AutoWalletProvider {
+    constructor(config, smartWalletAddress, isDeployed) {
+        this.smartWalletAddress = '';
+        this.isDeployed = false;
+        this.signer = config.signer;
+        this.provider = config.provider;
+        this.chainId = config.chainId;
+        this.smartWalletAddress = smartWalletAddress;
+        this.isDeployed = isDeployed;
+        this.bundler = new BundlerClient_1.BundlerClient({
+            primaryUrl: config.bundler.primaryUrl,
+            backupUrl: config.bundler.backupUrl,
+        });
+        this.paymaster = new PaymasterClient_1.PaymasterClient({
+            primaryUrl: config.paymaster.primaryUrl,
+            backupUrl: config.paymaster.backupUrl,
+            chainId: config.chainId,
+        });
+        this.nonceManager = new DualNonceManager_1.DualNonceManager(config.provider, smartWalletAddress, config.actpKernelAddress);
+    }
+    /**
+     * Factory method — computes counterfactual address and checks deployment.
+     */
+    static async create(config) {
+        const signerAddress = config.signer.address;
+        const smartWalletAddress = await (0, UserOpBuilder_1.computeSmartWalletAddress)(signerAddress, config.provider);
+        // Check if wallet is already deployed
+        const code = await config.provider.getCode(smartWalletAddress);
+        const isDeployed = code !== '0x';
+        Logger_1.sdkLogger.info('AutoWalletProvider initialized', {
+            signer: signerAddress,
+            smartWallet: smartWalletAddress,
+            deployed: isDeployed,
+        });
+        return new AutoWalletProvider(config, smartWalletAddress, isDeployed);
+    }
+    getAddress() {
+        return this.smartWalletAddress;
+    }
+    async sendTransaction(tx) {
+        return this.sendBatchTransaction([tx]);
+    }
+    async sendBatchTransaction(txs) {
+        if (txs.length === 0) {
+            throw new Error('sendBatchTransaction requires at least one transaction');
+        }
+        // Convert to SmartWalletCall[]
+        const calls = txs.map((tx) => ({
+            target: tx.to,
+            value: tx.value ? BigInt(tx.value) : 0n,
+            data: tx.data,
+        }));
+        // Use nonce manager for sequential ordering
+        // Note: We don't know if this specific batch increments ACTP nonce
+        // (that's handled at the ACTPClient level), so pass false here.
+        // The caller (ACTPClient.payBatched) manages ACTP nonce tracking.
+        return this.nonceManager.enqueue(async ({ entryPointNonce }) => {
+            const receipt = await this.submitUserOp(calls, entryPointNonce);
+            return { result: receipt, success: receipt.success };
+        }, false // ACTP nonce management is done at ACTPClient level
+        );
+    }
+    getWalletInfo() {
+        return {
+            address: this.smartWalletAddress,
+            tier: 'auto',
+            supportsBatching: true,
+            gasSponsored: true,
+            chainId: this.chainId,
+        };
+    }
+    /**
+     * Get the DualNonceManager (for ACTPClient to use for ACTP-aware batching).
+     */
+    getNonceManager() {
+        return this.nonceManager;
+    }
+    /**
+     * Check if the Smart Wallet is deployed on-chain.
+     */
+    getIsDeployed() {
+        return this.isDeployed;
+    }
+    /**
+     * Execute a batched ACTP payment atomically.
+     *
+     * Builds approve + createTransaction + linkEscrow as a single UserOp.
+     * Manages ACTP nonce inside the mutex queue for concurrent safety.
+     */
+    async payACTPBatched(params) {
+        return this.nonceManager.enqueue(async ({ entryPointNonce, actpNonce }) => {
+            const batch = (0, TransactionBatcher_1.buildACTPPayBatch)({
+                ...params,
+                actpNonce,
+            });
+            const receipt = await this.submitUserOp(batch.calls, entryPointNonce);
+            return {
+                result: {
+                    txId: batch.txId,
+                    hash: receipt.hash,
+                    success: receipt.success,
+                },
+                success: receipt.success,
+            };
+        }, true // Increment ACTP nonce on success
+        );
+    }
+    // ==========================================================================
+    // Internal
+    // ==========================================================================
+    /**
+     * Build, sponsor, sign, and submit a UserOp.
+     */
+    async submitUserOp(calls, entryPointNonce) {
+        const signerAddress = this.signer.address;
+        // 1. Build unsigned UserOp
+        const userOp = (0, UserOpBuilder_2.buildUserOp)({
+            sender: this.smartWalletAddress,
+            nonce: entryPointNonce,
+            calls,
+            isFirstDeploy: !this.isDeployed,
+            signerAddress,
+        });
+        // 2. Get fee data
+        const feeData = await this.provider.getFeeData();
+        userOp.maxFeePerGas = feeData.maxFeePerGas ?? 2000000000n;
+        userOp.maxPriorityFeePerGas = feeData.maxPriorityFeePerGas ?? 1000000000n;
+        // 3. Get stub paymaster data (for gas estimation)
+        const stubData = await this.paymaster.getPaymasterStubData(userOp);
+        userOp.paymasterAndData = stubData.paymasterAndData;
+        // 4. Dummy signature for gas estimation
+        userOp.signature = dummySignature();
+        // 5. Estimate gas
+        const gasEstimate = await this.bundler.estimateUserOperationGas(userOp);
+        userOp.callGasLimit = gasEstimate.callGasLimit;
+        userOp.verificationGasLimit = gasEstimate.verificationGasLimit;
+        userOp.preVerificationGas = gasEstimate.preVerificationGas;
+        // 6. Get final paymaster data (with real gas values)
+        const finalPaymaster = await this.paymaster.getPaymasterData(userOp);
+        userOp.paymasterAndData = finalPaymaster.paymasterAndData;
+        // 7. Sign
+        userOp.signature = await (0, UserOpBuilder_2.signUserOp)(userOp, this.signer, this.chainId);
+        // 8. Submit
+        const userOpHash = await this.bundler.sendUserOperation(userOp);
+        Logger_1.sdkLogger.info('UserOp submitted', { userOpHash });
+        // 9. Wait for receipt
+        const receipt = await this.bundler.waitForReceipt(userOpHash);
+        // Mark as deployed after first successful UserOp
+        if (!this.isDeployed && receipt.success) {
+            this.isDeployed = true;
+        }
+        return {
+            hash: receipt.transactionHash,
+            success: receipt.success,
+        };
+    }
+}
+exports.AutoWalletProvider = AutoWalletProvider;
+/**
+ * Dummy signature for gas estimation.
+ * CoinbaseSmartWallet expects abi.encode(uint256 ownerIndex, bytes sig)
+ * where sig is 65 bytes (r,s,v).
+ */
+function dummySignature() {
+    const dummySig = '0x' + 'ff'.repeat(65);
+    return ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(['uint256', 'bytes'], [0, dummySig]);
+}
+//# sourceMappingURL=AutoWalletProvider.js.map

package/dist/wallet/AutoWalletProvider.js.map

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

package/dist/wallet/EOAWalletProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * EOAWalletProvider — Tier 2 (BYOW) wallet implementation.
+ *
+ * Wraps an ethers.Wallet for traditional EOA signing.
+ * sendBatchTransaction() executes calls sequentially (no atomic batching).
+ * This is the backward-compatible path for agents that don't register.
+ *
+ * @module wallet/EOAWalletProvider
+ */
+import { ethers } from 'ethers';
+import { IWalletProvider, TransactionRequest, TransactionReceipt, WalletInfo } from './IWalletProvider';
+export declare class EOAWalletProvider implements IWalletProvider {
+    private readonly wallet;
+    private readonly chainId;
+    constructor(wallet: ethers.Wallet, chainId: number);
+    getAddress(): string;
+    sendTransaction(tx: TransactionRequest): Promise<TransactionReceipt>;
+    sendBatchTransaction(txs: TransactionRequest[]): Promise<TransactionReceipt>;
+    getWalletInfo(): WalletInfo;
+}
+//# sourceMappingURL=EOAWalletProvider.d.ts.map

package/dist/wallet/EOAWalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EOAWalletProvider.d.ts","sourceRoot":"","sources":["../../src/wallet/EOAWalletProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM;IAKlD,UAAU,IAAI,MAAM;IAId,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAapE,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAelF,aAAa,IAAI,UAAU;CAS5B"}

package/dist/wallet/EOAWalletProvider.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * EOAWalletProvider — Tier 2 (BYOW) wallet implementation.
+ *
+ * Wraps an ethers.Wallet for traditional EOA signing.
+ * sendBatchTransaction() executes calls sequentially (no atomic batching).
+ * This is the backward-compatible path for agents that don't register.
+ *
+ * @module wallet/EOAWalletProvider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EOAWalletProvider = void 0;
+class EOAWalletProvider {
+    constructor(wallet, chainId) {
+        this.wallet = wallet;
+        this.chainId = chainId;
+    }
+    getAddress() {
+        return this.wallet.address;
+    }
+    async sendTransaction(tx) {
+        const response = await this.wallet.sendTransaction({
+            to: tx.to,
+            data: tx.data,
+            value: tx.value ? BigInt(tx.value) : 0n,
+        });
+        const receipt = await response.wait();
+        return {
+            hash: receipt.hash,
+            success: receipt.status === 1,
+        };
+    }
+    async sendBatchTransaction(txs) {
+        if (txs.length === 0) {
+            throw new Error('sendBatchTransaction requires at least one transaction');
+        }
+        let lastReceipt;
+        for (const tx of txs) {
+            lastReceipt = await this.sendTransaction(tx);
+            if (!lastReceipt.success) {
+                return lastReceipt; // Fail fast
+            }
+        }
+        return lastReceipt;
+    }
+    getWalletInfo() {
+        return {
+            address: this.wallet.address,
+            tier: 'eoa',
+            supportsBatching: false,
+            gasSponsored: false,
+            chainId: this.chainId,
+        };
+    }
+}
+exports.EOAWalletProvider = EOAWalletProvider;
+//# sourceMappingURL=EOAWalletProvider.js.map

package/dist/wallet/EOAWalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EOAWalletProvider.js","sourceRoot":"","sources":["../../src/wallet/EOAWalletProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAUH,MAAa,iBAAiB;IAI5B,YAAY,MAAqB,EAAE,OAAe;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,EAAsB;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YACjD,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO;YACL,IAAI,EAAE,OAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,OAAQ,CAAC,MAAM,KAAK,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,GAAyB;QAClD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,WAA2C,CAAC;QAChD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC,CAAC,YAAY;YAClC,CAAC;QACH,CAAC;QACD,OAAO,WAAY,CAAC;IACtB,CAAC;IAED,aAAa;QACX,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,IAAI,EAAE,KAAK;YACX,gBAAgB,EAAE,KAAK;YACvB,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAlDD,8CAkDC"}

package/dist/wallet/IWalletProvider.d.ts

@@ -0,0 +1,115 @@
+/**
+ * IWalletProvider — Wallet abstraction for ACTP SDK.
+ *
+ * Enables pluggable wallet implementations:
+ * - EOAWalletProvider (Tier 2): Direct ethers.Wallet signing
+ * - AutoWalletProvider (Tier 1): CoinbaseSmartWallet + Paymaster (gasless)
+ *
+ * @module wallet/IWalletProvider
+ */
+/**
+ * Low-level transaction request.
+ * Plain strings only — no ethers or viem types at the interface boundary.
+ */
+export interface TransactionRequest {
+    /** Target contract address (0x-prefixed) */
+    to: string;
+    /** Calldata (0x-prefixed hex) */
+    data: string;
+    /** ETH value in wei (decimal string). Defaults to "0". */
+    value?: string;
+}
+/**
+ * Transaction receipt returned after submission.
+ */
+export interface TransactionReceipt {
+    /** Transaction hash (EOA) or UserOp hash (AA) */
+    hash: string;
+    /** Whether the transaction succeeded */
+    success: boolean;
+}
+/**
+ * Wallet tier — determines gas behavior.
+ */
+export type WalletTier = 'auto' | 'eoa';
+/**
+ * Information about the wallet provider.
+ */
+export interface WalletInfo {
+    /** The account address used for ACTP transactions */
+    address: string;
+    /** Wallet tier */
+    tier: WalletTier;
+    /** Whether this wallet supports atomic batching (AA = true, EOA = false) */
+    supportsBatching: boolean;
+    /** Whether gas is sponsored (AA with paymaster = true) */
+    gasSponsored: boolean;
+    /** Chain ID */
+    chainId: number;
+}
+/**
+ * Result of a batched ACTP payment via AA wallet.
+ */
+export interface BatchedPayResult {
+    /** Pre-computed ACTP transaction ID (bytes32) */
+    txId: string;
+    /** Transaction hash from the UserOp */
+    hash: string;
+    /** Whether the UserOp succeeded */
+    success: boolean;
+}
+/**
+ * Parameters for batched ACTP payment.
+ */
+export interface BatchedPayParams {
+    provider: string;
+    requester: string;
+    amount: string;
+    deadline: number;
+    disputeWindow: number;
+    serviceHash: string;
+    agentId: string;
+    contracts: {
+        usdc: string;
+        actpKernel: string;
+        escrowVault: string;
+    };
+}
+/**
+ * Wallet provider interface.
+ *
+ * All methods use plain strings (no ethers/viem types) to keep the
+ * interface decoupled from any specific library.
+ */
+export interface IWalletProvider {
+    /**
+     * Get the account address used as requester in ACTP transactions.
+     * For AA wallets this is the Smart Wallet address (not the signer EOA).
+     */
+    getAddress(): string;
+    /**
+     * Send a single transaction.
+     */
+    sendTransaction(tx: TransactionRequest): Promise<TransactionReceipt>;
+    /**
+     * Send multiple transactions atomically (AA) or sequentially (EOA).
+     *
+     * AA wallets batch all calls into a single UserOp.
+     * EOA wallets execute them one by one and return the last receipt.
+     */
+    sendBatchTransaction(txs: TransactionRequest[]): Promise<TransactionReceipt>;
+    /**
+     * Get wallet metadata.
+     */
+    getWalletInfo(): WalletInfo;
+    /**
+     * Execute a batched ACTP payment atomically (approve + createTx + linkEscrow).
+     *
+     * Only available on AA wallets (supportsBatching: true).
+     * Handles ACTP nonce management internally via the DualNonceManager mutex.
+     *
+     * Returns undefined if batched payments are not supported.
+     */
+    payACTPBatched?(params: BatchedPayParams): Promise<BatchedPayResult>;
+}
+//# sourceMappingURL=IWalletProvider.d.ts.map

package/dist/wallet/IWalletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWalletProvider.d.ts","sourceRoot":"","sources":["../../src/wallet/IWalletProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,4EAA4E;IAC5E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,IAAI,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAErE;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7E;;OAEG;IACH,aAAa,IAAI,UAAU,CAAC;IAE5B;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtE"}

package/dist/wallet/IWalletProvider.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * IWalletProvider — Wallet abstraction for ACTP SDK.
+ *
+ * Enables pluggable wallet implementations:
+ * - EOAWalletProvider (Tier 2): Direct ethers.Wallet signing
+ * - AutoWalletProvider (Tier 1): CoinbaseSmartWallet + Paymaster (gasless)
+ *
+ * @module wallet/IWalletProvider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IWalletProvider.js.map

package/dist/wallet/IWalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWalletProvider.js","sourceRoot":"","sources":["../../src/wallet/IWalletProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,70 @@
+/**
+ * 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
+ */
+import { UserOperationV06 } from './constants';
+export interface BundlerConfig {
+    /** Primary bundler URL (Coinbase CDP) */
+    primaryUrl: string;
+    /** Backup bundler URL (Pimlico) */
+    backupUrl?: string;
+    /** Max retry attempts per endpoint */
+    maxRetries?: number;
+    /** Base delay for exponential backoff (ms) */
+    baseDelayMs?: number;
+    /** Timeout for individual requests (ms) */
+    timeoutMs?: number;
+}
+export interface UserOpReceipt {
+    /** UserOp hash */
+    userOpHash: string;
+    /** Transaction hash on-chain */
+    transactionHash: string;
+    /** Block number */
+    blockNumber: number;
+    /** Whether the UserOp execution succeeded */
+    success: boolean;
+}
+export declare class BundlerClient {
+    private readonly primaryUrl;
+    private readonly backupUrl;
+    private readonly maxRetries;
+    private readonly baseDelayMs;
+    private readonly timeoutMs;
+    private requestId;
+    constructor(config: BundlerConfig);
+    /**
+     * Estimate gas for a UserOp.
+     */
+    estimateUserOperationGas(userOp: UserOperationV06): Promise<{
+        callGasLimit: bigint;
+        verificationGasLimit: bigint;
+        preVerificationGas: bigint;
+    }>;
+    /**
+     * Submit a signed UserOp to the bundler.
+     * Returns the UserOp hash.
+     */
+    sendUserOperation(userOp: UserOperationV06): Promise<string>;
+    /**
+     * Get the receipt for a submitted UserOp.
+     * Returns null if not yet mined.
+     */
+    getUserOperationReceipt(userOpHash: string): Promise<UserOpReceipt | null>;
+    /**
+     * Wait for UserOp receipt with polling.
+     */
+    waitForReceipt(userOpHash: string, timeoutMs?: number, pollIntervalMs?: number): Promise<UserOpReceipt>;
+    /**
+     * Call primary, fall back to backup, with retries and backoff.
+     */
+    private callWithFallback;
+    private callWithRetry;
+    private jsonRpc;
+}
+//# sourceMappingURL=BundlerClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BundlerClient.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/BundlerClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAS/C,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,EAAE,aAAa;IAQjC;;OAEG;IACG,wBAAwB,CAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB9F;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlE;;;OAGG;IACG,uBAAuB,CAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAqBhC;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAe,EAC1B,cAAc,GAAE,MAAc,GAC7B,OAAO,CAAC,aAAa,CAAC;IAiBzB;;OAEG;YACW,gBAAgB;YAqBhB,aAAa;YA2Bb,OAAO;CA2CtB"}