@agirails/sdk 2.3.0 → 2.3.1

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;CAwCtB"}

package/dist/wallet/aa/PaymasterClient.js

@@ -0,0 +1,115 @@
+"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) {
+                throw new Error(`Paymaster RPC error ${json.error.code}: ${json.error.message}`);
+            }
+            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

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionBatcher.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/TransactionBatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAmBtD,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA+C1E;AAcD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,oBAAoB,EAAE,MAAM,EAC5B,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,iBAAiB,EAAE,GACtC,eAAe,EAAE,CAuBnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,eAAe,EAAE,CASnB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,EAAE,CAYpB"}

package/dist/wallet/aa/TransactionBatcher.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTestnetInitBatch = exports.buildTestnetMintBatch = exports.buildRegisterAgentBatch = exports.buildACTPPayBatch = exports.computeTransactionId = void 0;
+const ethers_1 = require("ethers");
+// ============================================================================
+// ABI fragments — minimal for encoding only
+// ============================================================================
+const ERC20_APPROVE_ABI = [
+    'function approve(address spender, uint256 amount)',
+];
+const ACTP_KERNEL_ABI = [
+    'function createTransaction(address provider, address requester, uint256 amount, uint256 deadline, uint256 disputeWindow, bytes32 serviceHash, uint256 agentId)',
+    'function linkEscrow(bytes32 txId, address escrowVault, bytes32 escrowId)',
+];
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Pre-compute ACTP transaction ID.
+ *
+ * Matches ACTPKernel.sol:
+ *   transactionId = keccak256(abi.encodePacked(requester, provider, amount, serviceHash, nonce))
+ */
+function computeTransactionId(requester, provider, amount, serviceHash, nonce) {
+    return ethers_1.ethers.keccak256(ethers_1.ethers.solidityPacked(['address', 'address', 'uint256', 'bytes32', 'uint256'], [requester, provider, BigInt(amount), serviceHash, nonce]));
+}
+exports.computeTransactionId = computeTransactionId;
+/**
+ * Build the 3-call ACTP payment batch.
+ *
+ * Returns SmartWalletCall[] for executeBatch and the pre-computed txId.
+ */
+function buildACTPPayBatch(params) {
+    const amount = BigInt(params.amount);
+    // Pre-compute txId
+    const txId = computeTransactionId(params.requester, params.provider, params.amount, params.serviceHash, params.actpNonce);
+    const erc20Iface = new ethers_1.ethers.Interface(ERC20_APPROVE_ABI);
+    const kernelIface = new ethers_1.ethers.Interface(ACTP_KERNEL_ABI);
+    // Call 1: USDC.approve(escrowVault, amount)
+    const approveData = erc20Iface.encodeFunctionData('approve', [
+        params.contracts.escrowVault,
+        amount,
+    ]);
+    // Call 2: ACTPKernel.createTransaction(...)
+    const createTxData = kernelIface.encodeFunctionData('createTransaction', [
+        params.provider,
+        params.requester,
+        amount,
+        params.deadline,
+        params.disputeWindow,
+        params.serviceHash,
+        BigInt(params.agentId || '0'),
+    ]);
+    // Call 3: ACTPKernel.linkEscrow(txId, escrowVault, escrowId)
+    // escrowId = txId (ACTP standard)
+    const linkEscrowData = kernelIface.encodeFunctionData('linkEscrow', [
+        txId,
+        params.contracts.escrowVault,
+        txId,
+    ]);
+    const calls = [
+        { target: params.contracts.usdc, value: 0n, data: approveData },
+        { target: params.contracts.actpKernel, value: 0n, data: createTxData },
+        { target: params.contracts.actpKernel, value: 0n, data: linkEscrowData },
+    ];
+    return { calls, txId };
+}
+exports.buildACTPPayBatch = buildACTPPayBatch;
+/**
+ * ABI fragment for AgentRegistry.registerAgent.
+ *
+ * Matches IAgentRegistry.sol:
+ *   registerAgent(string endpoint, ServiceDescriptor[] serviceDescriptors)
+ *
+ * ServiceDescriptor = (bytes32, string, string, uint256, uint256, uint256, string)
+ */
+const AGENT_REGISTRY_ABI = [
+    'function registerAgent(string endpoint, (bytes32 serviceTypeHash, string serviceType, string schemaURI, uint256 minPrice, uint256 maxPrice, uint256 avgCompletionTime, string metadataCID)[] serviceDescriptors)',
+];
+/**
+ * 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)
+ */
+function buildRegisterAgentBatch(agentRegistryAddress, endpoint, serviceDescriptors) {
+    if (serviceDescriptors.length === 0) {
+        throw new Error('At least one service descriptor is required for registration');
+    }
+    const iface = new ethers_1.ethers.Interface(AGENT_REGISTRY_ABI);
+    // Convert to contract format (bigint fields already correct)
+    const descriptors = serviceDescriptors.map(sd => ({
+        serviceTypeHash: sd.serviceTypeHash,
+        serviceType: sd.serviceType,
+        schemaURI: sd.schemaURI,
+        minPrice: sd.minPrice,
+        maxPrice: sd.maxPrice,
+        avgCompletionTime: sd.avgCompletionTime,
+        metadataCID: sd.metadataCID,
+    }));
+    const data = iface.encodeFunctionData('registerAgent', [endpoint, descriptors]);
+    return [
+        { target: agentRegistryAddress, value: 0n, data },
+    ];
+}
+exports.buildRegisterAgentBatch = buildRegisterAgentBatch;
+/**
+ * Build a MockUSDC mint call (testnet only).
+ */
+function buildTestnetMintBatch(mockUsdcAddress, recipient, amount) {
+    const iface = new ethers_1.ethers.Interface([
+        'function mint(address to, uint256 amount)',
+    ]);
+    const data = iface.encodeFunctionData('mint', [recipient, BigInt(amount)]);
+    return [
+        { target: mockUsdcAddress, value: 0n, data },
+    ];
+}
+exports.buildTestnetMintBatch = buildTestnetMintBatch;
+/**
+ * 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).
+ */
+function buildTestnetInitBatch(params) {
+    const registerCalls = buildRegisterAgentBatch(params.agentRegistryAddress, params.endpoint, params.serviceDescriptors);
+    const mintCalls = buildTestnetMintBatch(params.mockUsdcAddress, params.recipient, params.mintAmount);
+    return [...registerCalls, ...mintCalls];
+}
+exports.buildTestnetInitBatch = buildTestnetInitBatch;
+//# sourceMappingURL=TransactionBatcher.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * UserOpBuilder — Constructs ERC-4337 v0.6 UserOperations.
+ *
+ * Builds UserOps for CoinbaseSmartWallet:
+ * - Encodes executeBatch(Call[]) as callData
+ * - Adds initCode for first-time wallet deployment
+ * - Signs with owner's private key (EIP-191 over UserOp hash)
+ *
+ * Uses ethers v6 for ABI encoding (no viem dependency yet — see Phase 2 note).
+ * viem+permissionless will be added if needed for paymaster integration.
+ *
+ * @module wallet/aa/UserOpBuilder
+ */
+import { ethers } from 'ethers';
+import { UserOperationV06, SmartWalletCall } from './constants';
+/**
+ * Compute the counterfactual Smart Wallet address for a given signer.
+ *
+ * This address is deterministic (CREATE2) and can be computed off-chain
+ * without deploying the wallet.
+ */
+export declare function computeSmartWalletAddress(signerAddress: string, provider: ethers.JsonRpcProvider, nonce?: bigint): Promise<string>;
+/**
+ * Build initCode for first-time wallet deployment.
+ *
+ * initCode = factory address + createAccount calldata
+ * When the wallet already exists, pass '0x' as initCode.
+ */
+export declare function buildInitCode(signerAddress: string, nonce?: bigint): string;
+/**
+ * Encode executeBatch calldata from an array of calls.
+ */
+export declare function encodeExecuteBatch(calls: SmartWalletCall[]): string;
+/**
+ * Build a full UserOperation (unsigned).
+ *
+ * Gas limits and paymasterAndData must be filled by the caller
+ * (via BundlerClient.estimateGas and PaymasterClient.sponsor).
+ */
+export declare function buildUserOp(params: {
+    sender: string;
+    nonce: bigint;
+    calls: SmartWalletCall[];
+    isFirstDeploy: boolean;
+    signerAddress: string;
+}): UserOperationV06;
+/**
+ * Compute the UserOperation hash for signing (v0.6).
+ *
+ * hash = keccak256(abi.encode(
+ *   keccak256(pack(userOp)),
+ *   entryPoint,
+ *   chainId
+ * ))
+ */
+export declare function getUserOpHash(userOp: UserOperationV06, chainId: number): string;
+/**
+ * Sign a UserOperation with the owner's private key.
+ *
+ * CoinbaseSmartWallet expects the signature to be:
+ *   abi.encode(SignatureWrapper(0, abi.encodePacked(r,s,v)))
+ *
+ * where ownerIndex=0 for single-owner wallets.
+ */
+export declare function signUserOp(userOp: UserOperationV06, signer: ethers.Wallet, chainId: number): Promise<string>;
+/**
+ * Serialize UserOp for JSON-RPC (bundler API).
+ * Converts bigints to hex strings.
+ */
+export declare function serializeUserOp(userOp: UserOperationV06): Record<string, string>;
+//# sourceMappingURL=UserOpBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UserOpBuilder.d.ts","sourceRoot":"","sources":["../../../src/wallet/aa/UserOpBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,eAAe,EAIhB,MAAM,aAAa,CAAC;AAiCrB;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,eAAe,EAChC,KAAK,GAAE,MAA6B,GACnC,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAA6B,GACnC,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CASnE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,gBAAgB,CAoBnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAqCR;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAchF"}