@agirails/sdk 2.5.3 → 2.5.5

package/dist/wallet/AutoWalletProvider.js

@@ -45,7 +45,7 @@ class AutoWalletProvider {
             backupUrl: config.paymaster.backupUrl,
             chainId: config.chainId,
         });
-        this.nonceManager = new DualNonceManager_1.DualNonceManager(config.provider, smartWalletAddress, config.actpKernelAddress);
+        this.nonceManager = new DualNonceManager_1.DualNonceManager(config.provider, smartWalletAddress, config.actpKernelAddress, config.actpKernelDeploymentBlock);
     }
     /**
      * Factory method — computes counterfactual address and checks deployment.
@@ -118,24 +118,89 @@ class AutoWalletProvider {
      */
     async payACTPBatched(params, prependCalls) {
         return this.nonceManager.enqueue(async ({ entryPointNonce, actpNonce }) => {
-            const batch = (0, TransactionBatcher_1.buildACTPPayBatch)({
-                ...params,
-                actpNonce,
-            });
-            // Combine activation calls (if any) with payment calls
-            const allCalls = prependCalls && prependCalls.length > 0
-                ? [...prependCalls, ...batch.calls]
-                : batch.calls;
-            const receipt = await this.submitUserOp(allCalls, entryPointNonce);
-            return {
-                result: {
-                    txId: batch.txId,
-                    hash: receipt.hash,
-                    success: receipt.success,
-                },
-                success: receipt.success,
-            };
-        }, true // Increment ACTP nonce on success
+            const MAX_NONCE_BUMPS = 12;
+            let candidateNonce = actpNonce;
+            for (let i = 0; i <= MAX_NONCE_BUMPS; i++) {
+                const batch = (0, TransactionBatcher_1.buildACTPPayBatch)({
+                    ...params,
+                    actpNonce: candidateNonce,
+                });
+                // Combine activation calls (if any) with payment calls
+                const allCalls = prependCalls && prependCalls.length > 0
+                    ? [...prependCalls, ...batch.calls]
+                    : batch.calls;
+                try {
+                    const receipt = await this.submitUserOp(allCalls, entryPointNonce);
+                    if (!receipt.success) {
+                        const failed = {
+                            result: {
+                                txId: batch.txId,
+                                hash: receipt.hash,
+                                success: false,
+                            },
+                            success: false,
+                        };
+                        return failed;
+                    }
+                    // Keep local nonce cache aligned with the nonce that actually succeeded.
+                    this.nonceManager.setCachedActpNonce(candidateNonce + 1n);
+                    const succeeded = {
+                        result: {
+                            txId: batch.txId,
+                            hash: receipt.hash,
+                            success: receipt.success,
+                        },
+                        success: receipt.success,
+                    };
+                    return succeeded;
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    // Bundlers may return either plain revert text or ABI-encoded revert data.
+                    const nonceCollision = /Escrow ID already used/i.test(message)
+                        || /457363726f7720494420616c72656164792075736564/i.test(message);
+                    if (!nonceCollision || i === MAX_NONCE_BUMPS) {
+                        throw error;
+                    }
+                    candidateNonce += 1n;
+                    Logger_1.sdkLogger.warn('ACTP nonce collision detected during batched pay; retrying with incremented nonce', {
+                        nextActpNonce: candidateNonce.toString(),
+                    });
+                }
+            }
+            throw new Error('Unable to submit batched ACTP payment after nonce retries');
+        }, false // payACTPBatched controls ACTP nonce cache explicitly
+        );
+    }
+    /**
+     * Create an ACTP transaction via Smart Wallet (without escrow linking).
+     *
+     * Encodes just ACTPKernel.createTransaction() as a single-call UserOp.
+     * Pre-computes the txId using the same keccak256 formula as the contract.
+     * Manages ACTP nonce inside the mutex queue for concurrent safety.
+     */
+    async createACTPTransaction(params) {
+        const kernelIface = new ethers_1.ethers.Interface([
+            'function createTransaction(address provider, address requester, uint256 amount, uint256 deadline, uint256 disputeWindow, bytes32 serviceHash, uint256 agentId)',
+        ]);
+        return this.nonceManager.enqueue(async ({ entryPointNonce, actpNonce }) => {
+            const txId = (0, TransactionBatcher_1.computeTransactionId)(params.requester, params.provider, params.amount, params.serviceHash, actpNonce);
+            const createTxData = kernelIface.encodeFunctionData('createTransaction', [
+                params.provider,
+                params.requester,
+                BigInt(params.amount),
+                params.deadline,
+                params.disputeWindow,
+                params.serviceHash,
+                BigInt(params.agentId || '0'),
+            ]);
+            const calls = [
+                { target: params.contracts.actpKernel, value: 0n, data: createTxData },
+            ];
+            const receipt = await this.submitUserOp(calls, entryPointNonce);
+            const result = { txId, receipt };
+            return { result, success: receipt.success };
+        }, true // createTransaction increments ACTP nonce
         );
     }
     // ==========================================================================

package/dist/wallet/AutoWalletProvider.js.map

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

package/dist/wallet/IWalletProvider.d.ts

@@ -58,6 +58,30 @@ export interface BatchedPayResult {
     /** Whether the UserOp succeeded */
     success: boolean;
 }
+/**
+ * Parameters for creating an ACTP transaction via Smart Wallet (without escrow).
+ */
+export interface CreateACTPTransactionParams {
+    provider: string;
+    requester: string;
+    amount: string;
+    deadline: number;
+    disputeWindow: number;
+    serviceHash: string;
+    agentId: string;
+    contracts: {
+        actpKernel: string;
+    };
+}
+/**
+ * Result of creating an ACTP transaction via Smart Wallet.
+ */
+export interface CreateACTPTransactionResult {
+    /** Pre-computed ACTP transaction ID (bytes32) */
+    txId: string;
+    /** Transaction receipt */
+    receipt: TransactionReceipt;
+}
 /**
  * Parameters for batched ACTP payment.
  */
@@ -113,5 +137,15 @@ export interface IWalletProvider {
      * @returns undefined if batched payments are not supported.
      */
     payACTPBatched?(params: BatchedPayParams, prependCalls?: import('./aa/constants').SmartWalletCall[]): Promise<BatchedPayResult>;
+    /**
+     * Create an ACTP transaction via Smart Wallet (without escrow linking).
+     *
+     * Only available on AA wallets (supportsBatching: true).
+     * Handles ACTP nonce management internally via the DualNonceManager mutex.
+     *
+     * @param params - Transaction creation parameters
+     * @returns Pre-computed txId and transaction receipt
+     */
+    createACTPTransaction?(params: CreateACTPTransactionParams): Promise<CreateACTPTransactionResult>;
 }
 //# sourceMappingURL=IWalletProvider.d.ts.map

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

@@ -1 +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;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO,gBAAgB,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjI"}
+{"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,2BAA2B;IAC1C,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,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,OAAO,EAAE,kBAAkB,CAAC;CAC7B;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;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO,gBAAgB,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhI;;;;;;;;OAQG;IACH,qBAAqB,CAAC,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACnG"}

package/dist/wallet/SmartWalletRouter.d.ts

@@ -0,0 +1,128 @@
+/**
+ * SmartWalletRouter - Shared utility for routing state transitions through Smart Wallet.
+ *
+ * Centralizes the logic for encoding ACTPKernel contract calls as TransactionRequests,
+ * validating release preconditions, and verifying attestations. Used by BasicAdapter,
+ * StandardAdapter, and ACTPClient to avoid code triplication.
+ *
+ * @module wallet/SmartWalletRouter
+ */
+import { IWalletProvider, TransactionRequest, TransactionReceipt } from './IWalletProvider';
+import { IACTPRuntime } from '../runtime/IACTPRuntime';
+import { EASHelper } from '../protocol/EASHelper';
+import type { MockTransaction } from '../runtime/types/MockState';
+/**
+ * Contract addresses needed for encoding Smart Wallet calls.
+ */
+export interface SmartWalletContractAddresses {
+    usdc: string;
+    actpKernel: string;
+    escrowVault: string;
+}
+/**
+ * SmartWalletRouter centralizes Smart Wallet routing logic.
+ *
+ * When a wallet provider with batched support is available (ERC-4337 Smart Wallet),
+ * state transitions must be sent as UserOps through the wallet provider so that
+ * msg.sender equals the Smart Wallet address (not the EOA signer).
+ */
+export declare class SmartWalletRouter {
+    private readonly walletProvider;
+    private readonly contractAddresses;
+    private readonly runtime;
+    private readonly easHelper?;
+    constructor(walletProvider: IWalletProvider, contractAddresses: SmartWalletContractAddresses, runtime: IACTPRuntime, easHelper?: EASHelper | undefined);
+    /**
+     * Check if state transitions should route through the wallet provider.
+     * True when walletProvider supports batching (i.e., is a Smart Wallet).
+     */
+    shouldRoute(): boolean;
+    /**
+     * Encode a transitionState call as a TransactionRequest.
+     */
+    encodeTransitionStateTx(txId: string, stateValue: number, proof?: string): TransactionRequest;
+    /**
+     * Encode a SETTLED state transition as a TransactionRequest.
+     * Mirrors BlockchainRuntime.releaseEscrow() secure settlement flow.
+     */
+    encodeSettleTx(txId: string): TransactionRequest;
+    /**
+     * Send a state transition through the wallet provider and check the receipt.
+     *
+     * @param txId - Transaction ID
+     * @param stateValue - Target state value (from TransactionStateValue enum)
+     * @param proof - Optional proof data
+     * @param label - Human-readable label for error messages (e.g., "startWork", "deliver")
+     * @returns Transaction receipt
+     */
+    sendTransition(txId: string, stateValue: number, proof?: string, label?: string): Promise<TransactionReceipt>;
+    /**
+     * Send a SETTLED transition through the wallet provider.
+     *
+     * @param txId - Transaction ID
+     * @returns Transaction receipt
+     */
+    sendSettle(txId: string): Promise<TransactionReceipt>;
+    /**
+     * Send a linkEscrow call through the wallet provider as a batched UserOp.
+     *
+     * Encodes USDC.approve(escrowVault, amount) + ACTPKernel.linkEscrow(txId, escrowVault, txId)
+     * and submits them as a single atomic batch.
+     *
+     * @param txId - Transaction ID (bytes32)
+     * @param amount - Amount in USDC wei (string)
+     * @param usdcAddress - USDC contract address
+     * @returns Transaction receipt
+     */
+    sendLinkEscrow(txId: string, amount: string, usdcAddress: string): Promise<TransactionReceipt>;
+    /**
+     * Validate release preconditions (state + dispute window).
+     *
+     * Handles both mock mode (disputeWindow = duration in seconds) and
+     * blockchain mode (disputeWindow = absolute timestamp). Uses a heuristic:
+     * values > 1 billion are absolute timestamps, smaller values are durations.
+     *
+     * @param txOrId - Transaction object or transaction ID to fetch
+     * @returns The validated transaction object (avoids double-fetch)
+     */
+    validateReleasePreconditions(txOrId: string | MockTransaction): Promise<MockTransaction>;
+    /**
+     * Verify/require attestation for wallet-routed release calls.
+     *
+     * Includes txId cross-check to prevent attestation replay attacks:
+     * ensures the provided attestation belongs to the transaction being released.
+     *
+     * @param txId - Transaction ID being released
+     * @param attestationUID - Optional attestation UID
+     */
+    verifyReleaseAttestation(txId: string, attestationUID?: string): Promise<void>;
+    /**
+     * Extract txId from escrowId, handling legacy format.
+     *
+     * @param escrowId - Escrow ID (may be txId or legacy "escrow-{txId}-{timestamp}" format)
+     * @returns The txId
+     */
+    static extractTxId(escrowId: string): string;
+}
+/**
+ * Compute the absolute end-time of the dispute window.
+ *
+ * Handles both representations transparently:
+ * - **Mock mode**: `disputeWindow` is a duration in seconds → `completedAt + disputeWindow`
+ * - **Blockchain mode**: `disputeWindow` is an absolute timestamp from on-chain → used as-is
+ *
+ * Heuristic: values > 1 billion are absolute timestamps (post-2001 epoch).
+ * Dispute window durations max at 30 days (~2.6M seconds). No overlap.
+ *
+ * @param completedAt - Delivery timestamp (0 in blockchain V1, real value in mock/V2)
+ * @param disputeWindow - Duration in seconds (mock) or absolute timestamp (blockchain)
+ * @returns Absolute timestamp when dispute window ends
+ */
+export declare function computeDisputeWindowEnds(completedAt: number, disputeWindow: number): number;
+/**
+ * Factory function to create a SmartWalletRouter if wallet provider supports batching.
+ *
+ * @returns SmartWalletRouter instance if Smart Wallet is available, undefined otherwise
+ */
+export declare function createSmartWalletRouter(walletProvider?: IWalletProvider, contractAddresses?: SmartWalletContractAddresses, runtime?: IACTPRuntime, easHelper?: EASHelper): SmartWalletRouter | undefined;
+//# sourceMappingURL=SmartWalletRouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SmartWalletRouter.d.ts","sourceRoot":"","sources":["../../src/wallet/SmartWalletRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAuBlE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAHV,cAAc,EAAE,eAAe,EAC/B,iBAAiB,EAAE,4BAA4B,EAC/C,OAAO,EAAE,YAAY,EACrB,SAAS,CAAC,uBAAW;IAGxC;;;OAGG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAa,GAAG,kBAAkB;IAOnG;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB;IAIhD;;;;;;;;OAQG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAa,EAAE,KAAK,GAAE,MAA0B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS5I;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS3D;;;;;;;;;;OAUG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0BpG;;;;;;;;;OASG;IACG,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA2C9F;;;;;;;;OAQG;IACG,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpF;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAI7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAO3F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,CAAC,EAAE,eAAe,EAChC,iBAAiB,CAAC,EAAE,4BAA4B,EAChD,OAAO,CAAC,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,SAAS,GACpB,iBAAiB,GAAG,SAAS,CAK/B"}

package/dist/wallet/SmartWalletRouter.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * SmartWalletRouter - Shared utility for routing state transitions through Smart Wallet.
+ *
+ * Centralizes the logic for encoding ACTPKernel contract calls as TransactionRequests,
+ * validating release preconditions, and verifying attestations. Used by BasicAdapter,
+ * StandardAdapter, and ACTPClient to avoid code triplication.
+ *
+ * @module wallet/SmartWalletRouter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSmartWalletRouter = exports.computeDisputeWindowEnds = exports.SmartWalletRouter = void 0;
+const ethers_1 = require("ethers");
+const MockState_1 = require("../runtime/types/MockState");
+/**
+ * Pre-compiled ABI interface for ACTPKernel.transitionState().
+ * Module-level constant to avoid re-instantiation on every call.
+ */
+const ACTP_KERNEL_IFACE = new ethers_1.ethers.Interface([
+    'function transitionState(bytes32 transactionId, uint8 newState, bytes proof)',
+    'function linkEscrow(bytes32 txId, address escrowVault, bytes32 escrowId)',
+]);
+const ERC20_IFACE = new ethers_1.ethers.Interface([
+    'function approve(address spender, uint256 amount)',
+]);
+/**
+ * Threshold to distinguish absolute timestamps from durations.
+ * Dispute window durations max at 30 days (~2.6M seconds).
+ * Absolute timestamps (post-2001) are > 1 billion.
+ * There's no overlap between these ranges.
+ */
+const ABSOLUTE_TIMESTAMP_THRESHOLD = 1000000000;
+/**
+ * SmartWalletRouter centralizes Smart Wallet routing logic.
+ *
+ * When a wallet provider with batched support is available (ERC-4337 Smart Wallet),
+ * state transitions must be sent as UserOps through the wallet provider so that
+ * msg.sender equals the Smart Wallet address (not the EOA signer).
+ */
+class SmartWalletRouter {
+    constructor(walletProvider, contractAddresses, runtime, easHelper) {
+        this.walletProvider = walletProvider;
+        this.contractAddresses = contractAddresses;
+        this.runtime = runtime;
+        this.easHelper = easHelper;
+    }
+    /**
+     * Check if state transitions should route through the wallet provider.
+     * True when walletProvider supports batching (i.e., is a Smart Wallet).
+     */
+    shouldRoute() {
+        return !!this.walletProvider.payACTPBatched;
+    }
+    /**
+     * Encode a transitionState call as a TransactionRequest.
+     */
+    encodeTransitionStateTx(txId, stateValue, proof = '0x') {
+        return {
+            to: this.contractAddresses.actpKernel,
+            data: ACTP_KERNEL_IFACE.encodeFunctionData('transitionState', [txId, stateValue, proof]),
+        };
+    }
+    /**
+     * Encode a SETTLED state transition as a TransactionRequest.
+     * Mirrors BlockchainRuntime.releaseEscrow() secure settlement flow.
+     */
+    encodeSettleTx(txId) {
+        return this.encodeTransitionStateTx(txId, MockState_1.TransactionStateValue.SETTLED, '0x');
+    }
+    /**
+     * Send a state transition through the wallet provider and check the receipt.
+     *
+     * @param txId - Transaction ID
+     * @param stateValue - Target state value (from TransactionStateValue enum)
+     * @param proof - Optional proof data
+     * @param label - Human-readable label for error messages (e.g., "startWork", "deliver")
+     * @returns Transaction receipt
+     */
+    async sendTransition(txId, stateValue, proof = '0x', label = 'transitionState') {
+        const tx = this.encodeTransitionStateTx(txId, stateValue, proof);
+        const receipt = await this.walletProvider.sendTransaction(tx);
+        if (!receipt.success) {
+            throw new Error(`${label} UserOp failed: ${receipt.hash}`);
+        }
+        return receipt;
+    }
+    /**
+     * Send a SETTLED transition through the wallet provider.
+     *
+     * @param txId - Transaction ID
+     * @returns Transaction receipt
+     */
+    async sendSettle(txId) {
+        const tx = this.encodeSettleTx(txId);
+        const receipt = await this.walletProvider.sendTransaction(tx);
+        if (!receipt.success) {
+            throw new Error(`release UserOp failed: ${receipt.hash}`);
+        }
+        return receipt;
+    }
+    /**
+     * Send a linkEscrow call through the wallet provider as a batched UserOp.
+     *
+     * Encodes USDC.approve(escrowVault, amount) + ACTPKernel.linkEscrow(txId, escrowVault, txId)
+     * and submits them as a single atomic batch.
+     *
+     * @param txId - Transaction ID (bytes32)
+     * @param amount - Amount in USDC wei (string)
+     * @param usdcAddress - USDC contract address
+     * @returns Transaction receipt
+     */
+    async sendLinkEscrow(txId, amount, usdcAddress) {
+        const amountBn = BigInt(amount);
+        const approveData = ERC20_IFACE.encodeFunctionData('approve', [
+            this.contractAddresses.escrowVault,
+            amountBn,
+        ]);
+        const linkEscrowData = ACTP_KERNEL_IFACE.encodeFunctionData('linkEscrow', [
+            txId,
+            this.contractAddresses.escrowVault,
+            txId, // escrowId = txId (ACTP standard)
+        ]);
+        const txs = [
+            { to: usdcAddress, data: approveData },
+            { to: this.contractAddresses.actpKernel, data: linkEscrowData },
+        ];
+        const receipt = await this.walletProvider.sendBatchTransaction(txs);
+        if (!receipt.success) {
+            throw new Error(`linkEscrow UserOp failed: ${receipt.hash}`);
+        }
+        return receipt;
+    }
+    /**
+     * Validate release preconditions (state + dispute window).
+     *
+     * Handles both mock mode (disputeWindow = duration in seconds) and
+     * blockchain mode (disputeWindow = absolute timestamp). Uses a heuristic:
+     * values > 1 billion are absolute timestamps, smaller values are durations.
+     *
+     * @param txOrId - Transaction object or transaction ID to fetch
+     * @returns The validated transaction object (avoids double-fetch)
+     */
+    async validateReleasePreconditions(txOrId) {
+        const tx = typeof txOrId === 'string'
+            ? await this.runtime.getTransaction(txOrId)
+            : txOrId;
+        const txId = typeof txOrId === 'string' ? txOrId : txOrId.id;
+        if (!tx) {
+            throw new Error(`Transaction ${txId} not found`);
+        }
+        if (tx.state !== 'DELIVERED') {
+            throw new Error(`Cannot release escrow: transaction ${txId} is in state ${tx.state}, expected DELIVERED.`);
+        }
+        // Dispute window check.
+        // Requester is allowed to approve early release before dispute window end.
+        // Mock mode: completedAt = delivery timestamp, disputeWindow = duration in seconds.
+        // Blockchain mode: completedAt = 0 (V1), disputeWindow = absolute timestamp from chain.
+        // Heuristic: if disputeWindow > 1 billion, it's an absolute timestamp (post-2001).
+        if (tx.completedAt !== null && tx.completedAt !== undefined) {
+            const disputeWindowEnds = computeDisputeWindowEnds(tx.completedAt, tx.disputeWindow);
+            const now = this.runtime.time.now();
+            if (now < disputeWindowEnds) {
+                const caller = this.walletProvider.getAddress().toLowerCase();
+                const requester = tx.requester.toLowerCase();
+                const isRequester = caller === requester;
+                if (!isRequester) {
+                    const remaining = disputeWindowEnds - now;
+                    throw new Error(`Cannot release escrow: dispute window still active for transaction ${txId}. ` +
+                        `Window expires in ${remaining} seconds.`);
+                }
+            }
+        }
+        return tx;
+    }
+    /**
+     * Verify/require attestation for wallet-routed release calls.
+     *
+     * Includes txId cross-check to prevent attestation replay attacks:
+     * ensures the provided attestation belongs to the transaction being released.
+     *
+     * @param txId - Transaction ID being released
+     * @param attestationUID - Optional attestation UID
+     */
+    async verifyReleaseAttestation(txId, attestationUID) {
+        const runtimeAny = this.runtime;
+        const runtimeSupportsAttestationFlag = typeof runtimeAny?.isAttestationRequired === 'function';
+        const attestationRequired = runtimeSupportsAttestationFlag
+            ? Boolean(runtimeAny.isAttestationRequired())
+            : Boolean(this.easHelper);
+        if (attestationRequired && !attestationUID) {
+            throw new Error('Attestation verification is REQUIRED for escrow release. ' +
+                'Provide attestationUID when using Smart Wallet release.');
+        }
+        if (attestationRequired && !this.easHelper) {
+            throw new Error('Attestation verification is required but EAS helper is not initialized.');
+        }
+        if (attestationUID && this.easHelper) {
+            await this.easHelper.verifyAndRecordForRelease(txId, attestationUID);
+        }
+    }
+    /**
+     * Extract txId from escrowId, handling legacy format.
+     *
+     * @param escrowId - Escrow ID (may be txId or legacy "escrow-{txId}-{timestamp}" format)
+     * @returns The txId
+     */
+    static extractTxId(escrowId) {
+        const legacyMatch = escrowId.match(/^escrow-(.+)-\d+$/);
+        return legacyMatch ? legacyMatch[1] : escrowId;
+    }
+}
+exports.SmartWalletRouter = SmartWalletRouter;
+/**
+ * Compute the absolute end-time of the dispute window.
+ *
+ * Handles both representations transparently:
+ * - **Mock mode**: `disputeWindow` is a duration in seconds → `completedAt + disputeWindow`
+ * - **Blockchain mode**: `disputeWindow` is an absolute timestamp from on-chain → used as-is
+ *
+ * Heuristic: values > 1 billion are absolute timestamps (post-2001 epoch).
+ * Dispute window durations max at 30 days (~2.6M seconds). No overlap.
+ *
+ * @param completedAt - Delivery timestamp (0 in blockchain V1, real value in mock/V2)
+ * @param disputeWindow - Duration in seconds (mock) or absolute timestamp (blockchain)
+ * @returns Absolute timestamp when dispute window ends
+ */
+function computeDisputeWindowEnds(completedAt, disputeWindow) {
+    if (disputeWindow > ABSOLUTE_TIMESTAMP_THRESHOLD) {
+        // Blockchain mode: disputeWindow IS the absolute end timestamp
+        return disputeWindow;
+    }
+    // Mock mode: disputeWindow is a duration relative to completedAt
+    return completedAt + disputeWindow;
+}
+exports.computeDisputeWindowEnds = computeDisputeWindowEnds;
+/**
+ * Factory function to create a SmartWalletRouter if wallet provider supports batching.
+ *
+ * @returns SmartWalletRouter instance if Smart Wallet is available, undefined otherwise
+ */
+function createSmartWalletRouter(walletProvider, contractAddresses, runtime, easHelper) {
+    if (walletProvider?.payACTPBatched && contractAddresses && runtime) {
+        return new SmartWalletRouter(walletProvider, contractAddresses, runtime, easHelper);
+    }
+    return undefined;
+}
+exports.createSmartWalletRouter = createSmartWalletRouter;
+//# sourceMappingURL=SmartWalletRouter.js.map

package/dist/wallet/SmartWalletRouter.js.map

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

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

@@ -20,7 +20,11 @@ export declare class DualNonceManager {
     private readonly mutex;
     /** Locally cached ACTP nonce — undefined means "re-read from chain" */
     private cachedActpNonce;
-    constructor(provider: ethers.JsonRpcProvider, senderAddress: string, actpKernelAddress: string);
+    /** Cached deployment block for ACTPKernel address */
+    private cachedKernelDeploymentBlock;
+    /** Whether the cached deployment block hint has been validated against the chain */
+    private deploymentBlockValidated;
+    constructor(provider: ethers.JsonRpcProvider, senderAddress: string, actpKernelAddress: string, knownDeploymentBlock?: number);
     /**
      * Execute a callback while holding the nonce mutex.
      *
@@ -52,5 +56,26 @@ export declare class DualNonceManager {
      * Invalidate cached ACTP nonce (forces re-read on next operation).
      */
     invalidateCache(): void;
+    /**
+     * Override cached ACTP nonce.
+     *
+     * Used when caller deterministically advances nonce (e.g. retrying batched
+     * creation after "Escrow ID already used" simulation failures).
+     */
+    setCachedActpNonce(nonce: bigint): void;
+    /**
+     * Find contract deployment block using binary search on getCode().
+     *
+     * If a knownDeploymentBlock was provided at construction, it is validated
+     * once by checking getCode() at that block. On mismatch the cache is
+     * discarded and the full binary search runs as fallback.
+     */
+    private findContractDeploymentBlock;
+    /**
+     * Count TransactionCreated logs for requester in chunks.
+     *
+     * Chunking avoids RPC range limits on providers that reject very large log windows.
+     */
+    private countRequesterTransactionCreatedEvents;
 }
 //# sourceMappingURL=DualNonceManager.d.ts.map

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

@@ -1 +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"}
+{"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;AAsDhC,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;IAC5C,qDAAqD;IACrD,OAAO,CAAC,2BAA2B,CAAqB;IACxD,oFAAoF;IACpF,OAAO,CAAC,wBAAwB,CAAS;gBAGvC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAChC,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,oBAAoB,CAAC,EAAE,MAAM;IAU/B;;;;;;;;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;IAgD3B;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvC;;;;;;OAMG;YACW,2BAA2B;IA2DzC;;;;OAIG;YACW,sCAAsC;CA0CrD"}