@w3lib/evm-batch-call 0.6.0 → 0.8.0

package/dist/simulateDecode.d.ts

@@ -0,0 +1,33 @@
+export type DecodedType = 'transfer' | 'swap' | 'approve' | 'liquidity' | 'contract' | 'unknown';
+export interface DecodedCall {
+    type: DecodedType;
+    /** 协议 / 合约名：Router 地址在内置协议表里时用表里的名字，否则是 ABI 所属的类别（如 "Uniswap V2 Router"） */
+    protocol?: string;
+    /** 方法名（unknown 时没有） */
+    method?: string;
+    /** 一句话描述（simulate 会在有余额变化时补上数量） */
+    summary: string;
+    /** 参数（地址 / 数字都是字符串，可以直接 JSON 序列化）；unknown 时是 { selector } */
+    args?: Record<string, unknown>;
+    /** multicall / Universal Router 等里面包含的子调用 */
+    calls?: DecodedCall[];
+}
+/**
+ * 解码一笔交易的 calldata。`to` 和 `chainId` 用来按内置协议表给 Router 标协议名。
+ *
+ * ```ts
+ * decodeCalldata(data, { to: router, chainId: 1 })
+ * // { type: 'swap', protocol: 'Uniswap SwapRouter02', method: 'exactInputSingle', summary: 'Uniswap SwapRouter02 exactInputSingle', args: {…} }
+ * ```
+ */
+export declare function decodeCalldata(data: string | undefined, ctx?: {
+    to?: string;
+    chainId?: number;
+    value?: bigint;
+}, depth?: number): DecodedCall;
+/**
+ * revert 数据 → 可读的原因：Error(string)、Panic（带含义），常见的自定义错误（Universal Router、Permit2、OpenZeppelin）带参数，
+ * 认不出的是 `custom error 0x选择器`。没有数据时返回 null
+ */
+export declare function decodeRevert(data: string | null | undefined, depth?: number): string | null;
+//# sourceMappingURL=simulateDecode.d.ts.map

package/dist/simulateDecode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulateDecode.d.ts","sourceRoot":"","sources":["../src/simulateDecode.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;AAEhG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;CACtB;AA0LD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAAE,KAAK,SAAI,GAAG,WAAW,CAqC5I;AAwED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,GAAG,IAAI,CAoBtF"}

package/dist/simulateDecode.js

@@ -0,0 +1,321 @@
+/**
+ * 模拟用的解码：calldata（ERC20 / 721 / 1155、WETH、Uniswap V2 / V3 Router、Universal Router、V3 仓位合约、Permit2、Multicall3、Disperse，
+ * 其中 Router / 仓位合约的地址按内置协议表标出协议名）和 revert 数据（Error / Panic、常见的自定义错误）。
+ * 不查网络（不用 4byte）：认不出的选择器返回 unknown 和原始选择器。
+ */
+import { Interface, dataSlice } from 'ethers';
+import { knownSpenders } from './approvals.js';
+import { decodeRevertReason } from './errors.js';
+const TOKEN_ID = 'tuple(address token, uint160 amount, uint48 expiration, uint48 nonce)';
+const GROUPS = [
+    {
+        name: 'Token',
+        abi: [
+            'function transfer(address to, uint256 amount)',
+            'function transferFrom(address from, address to, uint256 amount)',
+            'function approve(address spender, uint256 amount)',
+            'function increaseAllowance(address spender, uint256 amount)',
+            'function decreaseAllowance(address spender, uint256 amount)',
+            'function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)',
+            'function setApprovalForAll(address operator, bool approved)',
+            'function safeTransferFrom(address from, address to, uint256 tokenId)',
+            'function safeTransferFrom(address from, address to, uint256 tokenId, bytes data)',
+            'function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes data)',
+            'function safeBatchTransferFrom(address from, address to, uint256[] ids, uint256[] amounts, bytes data)',
+            'function deposit() payable',
+            'function withdraw(uint256 amount)',
+        ],
+    },
+    {
+        name: 'Uniswap V2 Router',
+        abi: [
+            'function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)',
+            'function swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] path, address to, uint256 deadline)',
+            'function swapExactETHForTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable',
+            'function swapTokensForExactETH(uint256 amountOut, uint256 amountInMax, address[] path, address to, uint256 deadline)',
+            'function swapExactTokensForETH(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)',
+            'function swapETHForExactTokens(uint256 amountOut, address[] path, address to, uint256 deadline) payable',
+            'function swapExactTokensForTokensSupportingFeeOnTransferTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)',
+            'function swapExactETHForTokensSupportingFeeOnTransferTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable',
+            'function swapExactTokensForETHSupportingFeeOnTransferTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)',
+            'function addLiquidity(address tokenA, address tokenB, uint256 amountADesired, uint256 amountBDesired, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline)',
+            'function addLiquidityETH(address token, uint256 amountTokenDesired, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline) payable',
+            'function removeLiquidity(address tokenA, address tokenB, uint256 liquidity, uint256 amountAMin, uint256 amountBMin, address to, uint256 deadline)',
+            'function removeLiquidityETH(address token, uint256 liquidity, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline)',
+            'function removeLiquidityETHSupportingFeeOnTransferTokens(address token, uint256 liquidity, uint256 amountTokenMin, uint256 amountETHMin, address to, uint256 deadline)',
+        ],
+    },
+    {
+        name: 'Uniswap V3 Router',
+        abi: [
+            // SwapRouter（struct 里有 deadline）和 SwapRouter02（没有）
+            'function exactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 deadline, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable',
+            'function exactInput(tuple(bytes path, address recipient, uint256 deadline, uint256 amountIn, uint256 amountOutMinimum) params) payable',
+            'function exactOutputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 deadline, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96) params) payable',
+            'function exactOutput(tuple(bytes path, address recipient, uint256 deadline, uint256 amountOut, uint256 amountInMaximum) params) payable',
+            'function exactInputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable',
+            'function exactInput(tuple(bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum) params) payable',
+            'function exactOutputSingle(tuple(address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96) params) payable',
+            'function exactOutput(tuple(bytes path, address recipient, uint256 amountOut, uint256 amountInMaximum) params) payable',
+            'function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to) payable',
+            'function swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] path, address to) payable',
+            'function multicall(uint256 deadline, bytes[] data) payable',
+            'function multicall(bytes32 previousBlockhash, bytes[] data) payable',
+            'function multicall(bytes[] data) payable',
+            'function unwrapWETH9(uint256 amountMinimum, address recipient) payable',
+            'function unwrapWETH9(uint256 amountMinimum) payable',
+            'function wrapETH(uint256 value) payable',
+            'function refundETH() payable',
+            'function sweepToken(address token, uint256 amountMinimum, address recipient) payable',
+            'function sweepToken(address token, uint256 amountMinimum) payable',
+        ],
+    },
+    {
+        name: 'Uniswap V3 Positions',
+        abi: [
+            'function mint(tuple(address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, address recipient, uint256 deadline) params) payable',
+            'function increaseLiquidity(tuple(uint256 tokenId, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable',
+            'function decreaseLiquidity(tuple(uint256 tokenId, uint128 liquidity, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable',
+            'function collect(tuple(uint256 tokenId, address recipient, uint128 amount0Max, uint128 amount1Max) params) payable',
+            'function burn(uint256 tokenId) payable',
+            'function createAndInitializePoolIfNecessary(address token0, address token1, uint24 fee, uint160 sqrtPriceX96) payable',
+            'function modifyLiquidities(bytes unlockData, uint256 deadline) payable',
+        ],
+    },
+    {
+        name: 'Universal Router',
+        abi: ['function execute(bytes commands, bytes[] inputs, uint256 deadline) payable', 'function execute(bytes commands, bytes[] inputs) payable'],
+    },
+    {
+        name: 'Permit2',
+        abi: [
+            'function approve(address token, address spender, uint160 amount, uint48 expiration)',
+            `function permit(address owner, tuple(${TOKEN_ID} details, address spender, uint256 sigDeadline) permitSingle, bytes signature)`,
+            `function permit(address owner, tuple(${TOKEN_ID}[] details, address spender, uint256 sigDeadline) permitBatch, bytes signature)`,
+            'function transferFrom(address from, address to, uint160 amount, address token)',
+            'function lockdown(tuple(address token, address spender)[] approvals)',
+            'function invalidateNonces(address token, address spender, uint48 newNonce)',
+        ],
+    },
+    {
+        name: 'Multicall3',
+        abi: [
+            'function aggregate(tuple(address target, bytes callData)[] calls) payable',
+            'function tryAggregate(bool requireSuccess, tuple(address target, bytes callData)[] calls) payable',
+            'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable',
+            'function aggregate3Value(tuple(address target, bool allowFailure, uint256 value, bytes callData)[] calls) payable',
+        ],
+    },
+    {
+        name: 'Disperse',
+        abi: ['function disperseEther(address[] recipients, uint256[] values) payable', 'function disperseToken(address token, address[] recipients, uint256[] values)'],
+    },
+    { name: 'Smart account', abi: ['function executeBatch(tuple(address target, uint256 value, bytes data)[] calls)'] },
+];
+let table = null;
+function entries() {
+    if (!table) {
+        table = new Map();
+        for (const group of GROUPS) {
+            const iface = new Interface(group.abi);
+            iface.forEachFunction((fragment) => {
+                // 同一个选择器的第一个为准（Token 组里的 approve / transferFrom 同时是 ERC20 和 ERC721 的）
+                if (!table?.has(fragment.selector))
+                    table?.set(fragment.selector, { fragment, iface, group: group.name });
+            });
+        }
+    }
+    return table;
+}
+const typeOf = (method) => {
+    if (/^swap|^exact(Input|Output)/.test(method))
+        return 'swap';
+    if (/Liquidity|^collect$|^burn$|^mint$|^modifyLiquidities$|^createAndInitializePool/.test(method))
+        return 'liquidity';
+    if (/^(transfer|safeTransfer|safeBatchTransfer|disperse)/.test(method))
+        return 'transfer';
+    if (/^(approve|permit|setApprovalForAll|increaseAllowance|decreaseAllowance|lockdown|invalidate)/.test(method))
+        return 'approve';
+    return 'contract';
+};
+/** 子调用里最重要的类型，决定外层 multicall 的类型 */
+const PRIORITY = ['swap', 'liquidity', 'transfer', 'approve', 'contract', 'unknown'];
+/** Universal Router 的命令字节（低 6 位）→ 名字 */
+const UR_COMMANDS = {
+    0x00: 'V3_SWAP_EXACT_IN',
+    0x01: 'V3_SWAP_EXACT_OUT',
+    0x02: 'PERMIT2_TRANSFER_FROM',
+    0x03: 'PERMIT2_PERMIT_BATCH',
+    0x04: 'SWEEP',
+    0x05: 'TRANSFER',
+    0x06: 'PAY_PORTION',
+    0x08: 'V2_SWAP_EXACT_IN',
+    0x09: 'V2_SWAP_EXACT_OUT',
+    0x0a: 'PERMIT2_PERMIT',
+    0x0b: 'WRAP_ETH',
+    0x0c: 'UNWRAP_WETH',
+    0x0d: 'PERMIT2_TRANSFER_FROM_BATCH',
+    0x0e: 'BALANCE_CHECK_ERC20',
+    0x10: 'V4_SWAP',
+    0x11: 'V3_POSITION_MANAGER_PERMIT',
+    0x12: 'V3_POSITION_MANAGER_CALL',
+    0x13: 'V4_INITIALIZE_POOL',
+    0x14: 'V4_POSITION_MANAGER_CALL',
+    0x21: 'EXECUTE_SUB_PLAN',
+};
+const urType = (name) => (/SWAP/.test(name) ? 'swap' : /POSITION_MANAGER_CALL/.test(name) ? 'liquidity' : /PERMIT/.test(name) ? 'approve' : /TRANSFER|SWEEP|PAY_PORTION/.test(name) ? 'transfer' : 'contract');
+const MAX_DEPTH = 2;
+/** 参数转成可 JSON 序列化的值（bigint → 字符串，Result → 数组 / 对象） */
+function plain(value) {
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (Array.isArray(value))
+        return value.map(plain);
+    if (value && typeof value === 'object' && typeof value.toObject === 'function')
+        return plain(value.toObject());
+    return value;
+}
+const short = (a) => `${a.slice(0, 6)}…${a.slice(-4)}`;
+/**
+ * 解码一笔交易的 calldata。`to` 和 `chainId` 用来按内置协议表给 Router 标协议名。
+ *
+ * ```ts
+ * decodeCalldata(data, { to: router, chainId: 1 })
+ * // { type: 'swap', protocol: 'Uniswap SwapRouter02', method: 'exactInputSingle', summary: 'Uniswap SwapRouter02 exactInputSingle', args: {…} }
+ * ```
+ */
+export function decodeCalldata(data, ctx = {}, depth = 0) {
+    const hex = data && data !== '0x' ? data : '0x';
+    const name = ctx.to && ctx.chainId !== undefined ? knownSpenders(ctx.chainId).find((s) => s.address.toLowerCase() === ctx.to?.toLowerCase())?.name : undefined;
+    if (hex === '0x') {
+        return ctx.value && ctx.value > 0n ? { type: 'transfer', method: 'transfer', summary: `Send native token${ctx.to ? ` to ${short(ctx.to)}` : ''}`, args: { to: ctx.to, value: ctx.value.toString() } } : { type: 'unknown', summary: 'Empty call' };
+    }
+    if (hex.length < 10)
+        return { type: 'unknown', summary: 'Unknown call', args: { selector: hex } };
+    const selector = dataSlice(hex, 0, 4);
+    const entry = entries().get(selector);
+    if (!entry)
+        return { type: 'unknown', ...(name ? { protocol: name } : {}), summary: `Unknown method ${selector}${name ? ` on ${name}` : ''}`, args: { selector } };
+    const method = entry.fragment.name;
+    const args = {};
+    let parsed;
+    try {
+        parsed = entry.iface.decodeFunctionData(entry.fragment, hex);
+        // Result 按需解码，数据残缺时在读取参数时才报错
+        entry.fragment.inputs.forEach((input, i) => {
+            args[input.name || String(i)] = plain(parsed[i]);
+        });
+    }
+    catch {
+        return { type: 'unknown', ...(name ? { protocol: name } : {}), summary: `Undecodable ${method} call`, args: { selector, method } };
+    }
+    const protocol = name ?? (entry.group === 'Token' ? undefined : entry.group);
+    let type = typeOf(method);
+    const out = { type, ...(protocol ? { protocol } : {}), method, summary: protocol ? `${protocol} ${method}` : method, args };
+    // 子调用：multicall / aggregate / executeBatch / Universal Router
+    if (depth < MAX_DEPTH) {
+        const inner = innerCalls(method, parsed, ctx.chainId, depth);
+        if (inner?.length) {
+            out.calls = inner;
+            type = PRIORITY.find((t) => inner.some((c) => c.type === t)) ?? 'contract';
+            out.type = type;
+            out.summary = `${protocol ? `${protocol} ` : ''}${method}: ${inner.map((c) => c.method ?? 'unknown').join(' + ')}`;
+        }
+    }
+    return out;
+}
+function innerCalls(method, parsed, chainId, depth) {
+    const sub = (to, data, value) => decodeCalldata(data, { to, chainId, value }, depth + 1);
+    if (method === 'multicall') {
+        const list = parsed[parsed.length - 1];
+        return list.map((d) => sub(undefined, d));
+    }
+    if (method === 'aggregate' || method === 'tryAggregate' || method === 'aggregate3' || method === 'aggregate3Value') {
+        const calls = parsed[parsed.length - 1];
+        return calls.map((c) => sub(c.target, c.callData, c.value));
+    }
+    if (method === 'executeBatch')
+        return parsed[0].map((c) => sub(c.target, c.data, c.value));
+    if (method === 'execute') {
+        const commands = parsed[0].slice(2).match(/../g) ?? [];
+        return commands.map((byte) => {
+            const cmd = UR_COMMANDS[Number.parseInt(byte, 16) & 0x3f] ?? `COMMAND_0x${byte}`;
+            return { type: urType(cmd), method: cmd, summary: cmd };
+        });
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// revert 原因
+// ---------------------------------------------------------------------------
+const customErrors = new Interface([
+    // Universal Router
+    'error ExecutionFailed(uint256 commandIndex, bytes message)',
+    'error InvalidCommandType(uint256 commandType)',
+    'error TransactionDeadlinePassed()',
+    'error V3TooLittleReceived()',
+    'error V3TooMuchRequested()',
+    'error V2TooLittleReceived()',
+    'error V2TooMuchRequested()',
+    'error V3InvalidSwap()',
+    'error InsufficientETH()',
+    'error InsufficientToken()',
+    'error BalanceTooLow()',
+    'error InvalidBips()',
+    'error LengthMismatch()',
+    // Permit2
+    'error AllowanceExpired(uint256 deadline)',
+    'error InsufficientAllowance(uint256 amount)',
+    'error InvalidSigner()',
+    'error InvalidNonce()',
+    'error SignatureExpired(uint256 signatureDeadline)',
+    // OpenZeppelin 5
+    'error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed)',
+    'error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed)',
+    'error ERC20InvalidSender(address sender)',
+    'error ERC20InvalidReceiver(address receiver)',
+    'error ERC721InsufficientApproval(address operator, uint256 tokenId)',
+    'error ERC721NonexistentToken(uint256 tokenId)',
+    'error OwnableUnauthorizedAccount(address account)',
+    'error EnforcedPause()',
+    'error ReentrancyGuardReentrantCall()',
+    'error AddressEmptyCode(address target)',
+    'error SafeERC20FailedOperation(address token)',
+    'error FailedCall()',
+]);
+const PANIC = {
+    '1': 'assertion failed',
+    '17': 'arithmetic overflow / underflow',
+    '18': 'division by zero',
+    '33': 'invalid enum value',
+    '50': 'array index out of bounds',
+    '65': 'out of memory',
+};
+/**
+ * revert 数据 → 可读的原因：Error(string)、Panic（带含义），常见的自定义错误（Universal Router、Permit2、OpenZeppelin）带参数，
+ * 认不出的是 `custom error 0x选择器`。没有数据时返回 null
+ */
+export function decodeRevert(data, depth = 0) {
+    if (!data || data === '0x' || data.length < 10)
+        return null;
+    const basic = decodeRevertReason(data);
+    if (basic) {
+        const panic = /^Panic\((\d+)\)$/.exec(basic);
+        return panic ? `${basic}${PANIC[panic[1]] ? ` ${PANIC[panic[1]]}` : ''}` : basic;
+    }
+    try {
+        const parsed = customErrors.parseError(data);
+        if (parsed) {
+            if (parsed.name === 'ExecutionFailed' && depth < 2) {
+                const inner = decodeRevert(String(parsed.args[1]), depth + 1);
+                return `ExecutionFailed(command ${parsed.args[0]}${inner ? `: ${inner}` : ''})`;
+            }
+            return `${parsed.name}(${parsed.args.map((a) => String(a)).join(', ')})`;
+        }
+    }
+    catch {
+        // 落到下面
+    }
+    return `custom error ${dataSlice(data, 0, 4)}`;
+}
+//# sourceMappingURL=simulateDecode.js.map

package/dist/simulateDecode.js.map

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

package/dist/smartAccount/account.d.ts

@@ -0,0 +1,31 @@
+import type { WriteRpc } from '../write/rpc.js';
+import type { EntryPointVersion } from './userOp.js';
+/** eth-infinitism 的 SimpleAccountFactory（account-abstraction v0.7 / v0.8），各主流链上地址相同 */
+export declare const SIMPLE_ACCOUNT_FACTORY_V07 = "0x91E60e0613810449d098b0b5Ec8b51A0FE8c8985";
+export declare const SIMPLE_ACCOUNT_FACTORY_V08 = "0x13E9ed32155810FDbd067D4522C492D6f68E5944";
+/**
+ * 账户类型：
+ * - 'simple'：eth-infinitism SimpleAccount，工厂按 owner + salt 生成的合约账户（首次使用时随 UserOperation 部署）。账户地址不是 owner 的地址，资产要放在账户里
+ * - 'simple7702'：钱包自己（EOA 通过 EIP-7702 委托给 Simple7702Account），UserOperation 的 sender 就是钱包地址，只能用 EntryPoint v0.8
+ */
+export type SmartAccountKind = 'simple' | 'simple7702';
+export interface BatchItem {
+    to: string;
+    value: bigint;
+    data: string;
+}
+/** 账户执行一批调用的 calldata（v0.8 的账户用 Call[]，v0.7 的 SimpleAccount 用三个数组） */
+export declare function encodeExecuteBatch(version: EntryPointVersion, calls: readonly BatchItem[]): string;
+export declare function defaultFactory(version: EntryPointVersion): string;
+export interface CounterfactualAccount {
+    address: string;
+    deployed: boolean;
+    factory: string;
+    /** 还没部署时的 createAccount calldata */
+    factoryData: string;
+}
+/** SimpleAccount 的地址（部署前就能算出来：向工厂 getAddress）和部署状态 */
+export declare function resolveSimpleAccount(rpc: WriteRpc, owner: string, version: EntryPointVersion, salt?: bigint | number | string, factory?: string): Promise<CounterfactualAccount>;
+/** 查询账户地址（不发送任何东西），传入 owner 地址 */
+export declare function getSimpleAccountAddress(rpc: WriteRpc, owner: string, version?: EntryPointVersion, salt?: bigint | number | string, factory?: string): Promise<string>;
+//# sourceMappingURL=account.d.ts.map

package/dist/smartAccount/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/smartAccount/account.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,+CAA+C,CAAA;AACtF,eAAO,MAAM,0BAA0B,+CAA+C,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,CAAA;AAQtD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAKlG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAEjE;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,sDAAsD;AACtD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,GAAE,MAAM,GAAG,MAAM,GAAG,MAAW,EAAE,OAAO,SAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ3M;AAED,kCAAkC;AAClC,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAyB,EAAE,IAAI,GAAE,MAAM,GAAG,MAAM,GAAG,MAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtL"}

package/dist/smartAccount/account.js

@@ -0,0 +1,33 @@
+import { Interface, getAddress } from 'ethers';
+/** eth-infinitism 的 SimpleAccountFactory（account-abstraction v0.7 / v0.8），各主流链上地址相同 */
+export const SIMPLE_ACCOUNT_FACTORY_V07 = '0x91E60e0613810449d098b0b5Ec8b51A0FE8c8985';
+export const SIMPLE_ACCOUNT_FACTORY_V08 = '0x13E9ed32155810FDbd067D4522C492D6f68E5944';
+const factoryInterface = new Interface(['function createAccount(address owner, uint256 salt) returns (address)', 'function getAddress(address owner, uint256 salt) view returns (address)']);
+const callTuple = '(address target, uint256 value, bytes data)[]';
+const batchV08 = new Interface([`function executeBatch(${callTuple} calls)`]);
+const batchV07 = new Interface(['function executeBatch(address[] dest, uint256[] value, bytes[] func)']);
+/** 账户执行一批调用的 calldata（v0.8 的账户用 Call[]，v0.7 的 SimpleAccount 用三个数组） */
+export function encodeExecuteBatch(version, calls) {
+    if (version === '0.8') {
+        return batchV08.encodeFunctionData('executeBatch', [calls.map((c) => [c.to, c.value, c.data])]);
+    }
+    return batchV07.encodeFunctionData('executeBatch', [calls.map((c) => c.to), calls.map((c) => c.value), calls.map((c) => c.data)]);
+}
+export function defaultFactory(version) {
+    return version === '0.8' ? SIMPLE_ACCOUNT_FACTORY_V08 : SIMPLE_ACCOUNT_FACTORY_V07;
+}
+/** SimpleAccount 的地址（部署前就能算出来：向工厂 getAddress）和部署状态 */
+export async function resolveSimpleAccount(rpc, owner, version, salt = 0n, factory = defaultFactory(version)) {
+    const factoryAddress = getAddress(factory);
+    if ((await rpc.code(factoryAddress)) === '0x') {
+        throw new Error(`The SimpleAccountFactory ${factoryAddress} is not deployed on chain ${rpc.chainId}; pass smartAccount.factory`);
+    }
+    const [address] = factoryInterface.decodeFunctionResult('getAddress', await rpc.call({ to: factoryAddress, data: factoryInterface.encodeFunctionData('getAddress', [owner, salt]) }));
+    const code = await rpc.code(address);
+    return { address: getAddress(address), deployed: code !== '0x', factory: factoryAddress, factoryData: factoryInterface.encodeFunctionData('createAccount', [owner, salt]) };
+}
+/** 查询账户地址（不发送任何东西），传入 owner 地址 */
+export async function getSimpleAccountAddress(rpc, owner, version = '0.7', salt = 0n, factory) {
+    return (await resolveSimpleAccount(rpc, owner, version, salt, factory)).address;
+}
+//# sourceMappingURL=account.js.map

package/dist/smartAccount/account.js.map

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

package/dist/smartAccount/clients.d.ts

@@ -0,0 +1,77 @@
+import { type UserOperation } from './userOp.js';
+export interface RpcClientOptions {
+    /** 自定义 fetch（测试、代理） */
+    fetch?: typeof fetch;
+    /** 附加请求头（Authorization 等） */
+    headers?: Record<string, string>;
+}
+/** bundler 返回的 UserOperation 回执 */
+export interface UserOperationReceipt {
+    userOpHash: string;
+    sender: string;
+    success: boolean;
+    /** 执行失败时的原因（revert 数据） */
+    reason?: string;
+    actualGasCost: bigint;
+    actualGasUsed: bigint;
+    /** 打包它的那笔交易 */
+    transactionHash: string;
+    blockNumber: number | null;
+}
+export interface GasEstimate {
+    callGasLimit: bigint;
+    verificationGasLimit: bigint;
+    preVerificationGas: bigint;
+    paymasterVerificationGasLimit?: bigint;
+    paymasterPostOpGasLimit?: bigint;
+}
+/**
+ * ERC-4337 bundler 客户端：eth_sendUserOperation / eth_estimateUserOperationGas / eth_getUserOperationReceipt / eth_supportedEntryPoints。
+ *
+ * ```ts
+ * const bundler = new BundlerClient('https://public.pimlico.io/v2/8453/rpc')
+ * await bundler.supportedEntryPoints()
+ * ```
+ */
+export declare class BundlerClient {
+    #private;
+    constructor(url: string, options?: RpcClientOptions);
+    supportedEntryPoints(): Promise<string[]>;
+    chainId(): Promise<number>;
+    /** 估算 gas：signature 为空时用占位签名 */
+    estimateUserOperationGas(op: UserOperation, entryPoint: string): Promise<GasEstimate>;
+    /** 提交，返回 userOpHash */
+    sendUserOperation(op: UserOperation, entryPoint: string): Promise<string>;
+    /** 回执；还没上链为 null */
+    getUserOperationReceipt(hash: string): Promise<UserOperationReceipt | null>;
+    /** 轮询回执直到上链；超时返回 null（UserOperation 之后仍可能上链） */
+    waitForUserOperation(hash: string, options?: {
+        timeout?: number;
+        pollInterval?: number;
+        signal?: AbortSignal;
+    }): Promise<UserOperationReceipt | null>;
+}
+/** paymaster 返回的字段，合并进 UserOperation */
+export type PaymasterFields = Pick<UserOperation, 'paymaster' | 'paymasterData' | 'paymasterVerificationGasLimit' | 'paymasterPostOpGasLimit'>;
+export interface PaymasterContext {
+    entryPoint: string;
+    chainId: number;
+    /** 'stub'：估算 gas 前，要占位数据；'final'：gas 已定，要真正的签名数据 */
+    stage: 'stub' | 'final';
+}
+/** 自定义 paymaster：拿到 UserOperation 返回 paymaster 字段（verifying paymaster 自己签名、自家后端等） */
+export type PaymasterHook = (op: UserOperation, context: PaymasterContext) => Promise<PaymasterFields> | PaymasterFields;
+/**
+ * ERC-7677 paymaster 服务客户端：pm_getPaymasterStubData（估算 gas 用的占位数据）/ pm_getPaymasterData（最终数据）。
+ * URL / Key 由应用提供。`client.hook` 可直接作为 `paymaster` 选项
+ */
+export declare class PaymasterClient {
+    #private;
+    /** 服务商要求的 context（如 Pimlico 的 `{ sponsorshipPolicyId }`） */
+    readonly context: Record<string, unknown>;
+    constructor(url: string, 
+    /** 服务商要求的 context（如 Pimlico 的 `{ sponsorshipPolicyId }`） */
+    context?: Record<string, unknown>, options?: RpcClientOptions);
+    readonly hook: PaymasterHook;
+}
+//# sourceMappingURL=clients.d.ts.map

package/dist/smartAccount/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/smartAccount/clients.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAwBD,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;;gBAEZ,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAIvD,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1B,gCAAgC;IAC1B,wBAAwB,CAAC,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAY3F,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzE,oBAAoB;IACd,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAoBjF,gDAAgD;IAC1C,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAmBhK;AAED,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,eAAe,GAAG,+BAA+B,GAAG,yBAAyB,CAAC,CAAA;AAE9I,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CACxB;AAED,qFAAqF;AACrF,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;AAExH;;;GAGG;AACH,qBAAa,eAAe;;IAIxB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFzC,GAAG,EAAE,MAAM;IACX,4DAA4D;IACnD,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC9C,OAAO,GAAE,gBAAqB;IAKhC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAa3B;CACF"}