four-flap-meme-sdk 1.4.91 → 1.4.93

package/dist/xlayer/bundle.js

@@ -0,0 +1,472 @@
+/**
+ * XLayer 捆绑交易 SDK
+ *
+ * 通过 ERC-4337 handleOps 实现多个地址的原子化交易：
+ * - 捆绑买入：多个 sender 同一笔 handleOps 买入
+ * - 捆绑卖出：多个 sender 同一笔 handleOps 卖出
+ * - 买卖一体化：买入 -> 授权 -> 卖出 -> 归集
+ * - OKB 归集：将 sender 的 OKB 转回 owner
+ */
+import { Interface, Contract } from 'ethers';
+import { FLAP_PORTAL, ENTRYPOINT_ABI, DEFAULT_CALL_GAS_LIMIT_SELL, DEFAULT_WITHDRAW_RESERVE, } from './constants.js';
+import { AAAccountManager, encodeExecute, createWallet } from './aa-account.js';
+import { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, parseOkb, formatOkb, } from './portal-ops.js';
+// ============================================================================
+// 捆绑交易执行器
+// ============================================================================
+/**
+ * XLayer 捆绑交易执行器
+ *
+ * 核心设计原则：
+ * 1. 用户只需操控 AA 地址（Sender）
+ * 2. 如果指定了 Paymaster，不需要往 AA 转手续费
+ * 3. 多个 UserOp 放入同一笔 handleOps 保证原子性
+ */
+export class BundleExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.aaManager = new AAAccountManager(config);
+        this.portalQuery = new PortalQuery({
+            rpcUrl: config.rpcUrl,
+            chainId: config.chainId,
+        });
+        this.portalAddress = FLAP_PORTAL;
+    }
+    /**
+     * 获取 AA 管理器
+     */
+    getAAManager() {
+        return this.aaManager;
+    }
+    /**
+     * 获取 Portal 查询器
+     */
+    getPortalQuery() {
+        return this.portalQuery;
+    }
+    /**
+     * 执行 handleOps 并解析结果
+     */
+    async runHandleOps(label, ops, bundlerSigner, beneficiary) {
+        if (ops.length === 0) {
+            console.log(`\n[${label}] 没有 ops，跳过`);
+            return null;
+        }
+        const provider = this.aaManager.getProvider();
+        const entryPointAddress = this.aaManager.getEntryPointAddress();
+        const feeData = await provider.getFeeData();
+        console.log(`\n[${label}] 发送 handleOps，ops=${ops.length} ...`);
+        // 使用 bundlerSigner 创建新的合约实例以调用 handleOps
+        const entryPointWithSigner = new Contract(entryPointAddress, ENTRYPOINT_ABI, bundlerSigner);
+        const tx = await entryPointWithSigner.handleOps(ops, beneficiary, { gasPrice: feeData.gasPrice ?? 100000000n });
+        console.log(`[${label}] txHash:`, tx.hash);
+        const receipt = await tx.wait();
+        console.log(`[${label}] mined block=${receipt.blockNumber} status=${receipt.status}`);
+        // 解析 UserOperationEvent
+        const epIface = new Interface(ENTRYPOINT_ABI);
+        const userOpEvents = [];
+        for (const log of receipt.logs) {
+            try {
+                const parsed = epIface.parseLog(log);
+                if (parsed?.name === 'UserOperationEvent') {
+                    const e = parsed.args;
+                    userOpEvents.push({
+                        userOpHash: e.userOpHash,
+                        sender: e.sender,
+                        paymaster: e.paymaster,
+                        success: e.success,
+                        actualGasCost: e.actualGasCost,
+                        actualGasUsed: e.actualGasUsed,
+                    });
+                    console.log(` - userOpHash=${e.userOpHash} sender=${e.sender} success=${e.success} gasUsed=${e.actualGasUsed}`);
+                }
+            }
+            catch { }
+        }
+        // 检查是否有失败的 UserOp
+        const failed = userOpEvents.filter((e) => !e.success);
+        if (failed.length > 0) {
+            console.warn(`[${label}] 有 ${failed.length} 个 UserOp 执行失败`);
+        }
+        return {
+            txHash: tx.hash,
+            blockNumber: receipt.blockNumber,
+            status: receipt.status,
+            userOpEvents,
+        };
+    }
+    /**
+     * 构建买入 UserOp
+     */
+    async buildBuyUserOp(ownerWallet, tokenAddress, buyAmountWei, ownerName) {
+        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
+        const initCode = accountInfo.deployed
+            ? '0x'
+            : this.aaManager.generateInitCode(ownerWallet.address);
+        // 构建 callData: execute(portal, value=buyAmountWei, swapExactInput)
+        const swapData = encodeBuyCall(tokenAddress, buyAmountWei, 0n);
+        const callData = encodeExecute(this.portalAddress, buyAmountWei, swapData);
+        // 估算前确保 sender 有足够余额（用于模拟）
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, buyAmountWei + parseOkb('0.0003'), `${ownerName ?? 'owner'}/buy-prefund-before-estimate`);
+        // 使用 Bundler 估算
+        const { userOp, prefundWei } = await this.aaManager.buildUserOpWithBundlerEstimate({
+            ownerWallet,
+            sender: accountInfo.sender,
+            callData,
+            nonce: accountInfo.nonce,
+            initCode,
+        });
+        // 补足 prefund + 买入金额
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, buyAmountWei + prefundWei + parseOkb('0.0002'), `${ownerName ?? 'owner'}/buy-fund`);
+        // 签名
+        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
+        return {
+            ...signed,
+            prefundWei,
+            ownerName,
+        };
+    }
+    /**
+     * 构建授权 UserOp
+     */
+    async buildApproveUserOp(ownerWallet, tokenAddress, spender, nonce, ownerName) {
+        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
+        const approveData = encodeApproveCall(spender);
+        const callData = encodeExecute(tokenAddress, 0n, approveData);
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, parseOkb('0.0002'), `${ownerName ?? 'owner'}/approve-prefund`);
+        const { userOp, prefundWei } = await this.aaManager.buildUserOpWithLocalEstimate({
+            ownerWallet,
+            sender: accountInfo.sender,
+            callData,
+            nonce,
+        });
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, prefundWei + parseOkb('0.00005'), `${ownerName ?? 'owner'}/approve-fund`);
+        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
+        return { ...signed, prefundWei, ownerName };
+    }
+    /**
+     * 构建卖出 UserOp
+     */
+    async buildSellUserOp(ownerWallet, tokenAddress, sellAmount, nonce, needApprove, ownerName) {
+        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
+        const sellData = encodeSellCall(tokenAddress, sellAmount, 0n);
+        const callData = encodeExecute(this.portalAddress, 0n, sellData);
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, parseOkb('0.0003'), `${ownerName ?? 'owner'}/sell-prefund`);
+        // 如果需要 approve（还未执行），estimateGas 会 revert，使用固定值
+        const { userOp, prefundWei } = needApprove
+            ? await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet,
+                sender: accountInfo.sender,
+                callData,
+                nonce,
+                callGasLimit: DEFAULT_CALL_GAS_LIMIT_SELL,
+            })
+            : await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet,
+                sender: accountInfo.sender,
+                callData,
+                nonce,
+            });
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, prefundWei + parseOkb('0.00005'), `${ownerName ?? 'owner'}/sell-fund`);
+        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
+        return { ...signed, prefundWei, ownerName };
+    }
+    /**
+     * 构建归集 UserOp（将 OKB 从 sender 转回 owner）
+     */
+    async buildWithdrawUserOp(ownerWallet, reserveWei, ownerName) {
+        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
+        const senderBalance = await this.portalQuery.getOkbBalance(accountInfo.sender);
+        if (senderBalance <= reserveWei) {
+            console.log(`\n[${ownerName ?? 'owner'}] sender OKB 太少，跳过归集：${formatOkb(senderBalance)} OKB`);
+            return null;
+        }
+        // 先估算 prefund
+        const tempCallData = encodeExecute(ownerWallet.address, 0n, '0x');
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, parseOkb('0.0002'), `${ownerName ?? 'owner'}/withdraw-prefund`);
+        const { prefundWei } = await this.aaManager.buildUserOpWithLocalEstimate({
+            ownerWallet,
+            sender: accountInfo.sender,
+            callData: tempCallData,
+            nonce: accountInfo.nonce,
+        });
+        // 计算可归集金额
+        const currentBalance = await this.portalQuery.getOkbBalance(accountInfo.sender);
+        const withdrawAmount = currentBalance > prefundWei + reserveWei
+            ? currentBalance - prefundWei - reserveWei
+            : 0n;
+        if (withdrawAmount <= 0n) {
+            console.log(`\n[${ownerName ?? 'owner'}] 归集后可转出=0（余额不足以覆盖 prefund+reserve）`);
+            return null;
+        }
+        // 真正的 callData
+        const callData = encodeExecute(ownerWallet.address, withdrawAmount, '0x');
+        const { userOp } = await this.aaManager.buildUserOpWithLocalEstimate({
+            ownerWallet,
+            sender: accountInfo.sender,
+            callData,
+            nonce: accountInfo.nonce,
+        });
+        console.log(`\n[${ownerName ?? 'owner'}] withdraw: ${formatOkb(withdrawAmount)} OKB`);
+        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
+        return { ...signed, prefundWei, ownerName };
+    }
+    /**
+     * 构建代币转账 UserOp（将代币从 sender 转回 owner）
+     */
+    async buildTransferTokenUserOp(ownerWallet, tokenAddress, ownerName) {
+        const accountInfo = await this.aaManager.getAccountInfo(ownerWallet.address);
+        const tokenBalance = await this.portalQuery.getTokenBalance(tokenAddress, accountInfo.sender);
+        if (tokenBalance === 0n) {
+            console.log(`\n[${ownerName ?? 'owner'}] sender 没有代币，跳过转账`);
+            return null;
+        }
+        const transferData = encodeTransferCall(ownerWallet.address, tokenBalance);
+        const callData = encodeExecute(tokenAddress, 0n, transferData);
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, parseOkb('0.0002'), `${ownerName ?? 'owner'}/transfer-prefund`);
+        const { userOp, prefundWei } = await this.aaManager.buildUserOpWithBundlerEstimate({
+            ownerWallet,
+            sender: accountInfo.sender,
+            callData,
+            nonce: accountInfo.nonce,
+        });
+        await this.aaManager.ensureSenderBalance(ownerWallet, accountInfo.sender, prefundWei + parseOkb('0.00005'), `${ownerName ?? 'owner'}/transfer-fund`);
+        console.log(`\n[${ownerName ?? 'owner'}] transfer token: ${tokenBalance.toString()}`);
+        const signed = await this.aaManager.signUserOp(userOp, ownerWallet);
+        return { ...signed, prefundWei, ownerName };
+    }
+    // ============================================================================
+    // 公开 API
+    // ============================================================================
+    /**
+     * 捆绑买入
+     *
+     * 多个地址同一笔 handleOps 买入代币
+     */
+    async bundleBuy(params) {
+        const { tokenAddress, privateKeys, buyAmounts, transferBackToOwner, config } = params;
+        if (privateKeys.length !== buyAmounts.length) {
+            throw new Error('私钥数量和购买金额数量必须一致');
+        }
+        // 使用第一个 owner 作为 bundler signer
+        const wallets = privateKeys.map((pk) => createWallet(pk, this.config));
+        const bundlerSigner = wallets[0];
+        const beneficiary = bundlerSigner.address;
+        console.log('=== XLayer Bundle Buy ===');
+        console.log('token:', tokenAddress);
+        console.log('owners:', wallets.length);
+        // 1. 构建买入 UserOps
+        const buyOps = [];
+        for (let i = 0; i < wallets.length; i++) {
+            const wallet = wallets[i];
+            const buyWei = parseOkb(buyAmounts[i]);
+            const signed = await this.buildBuyUserOp(wallet, tokenAddress, buyWei, `owner${i + 1}`);
+            buyOps.push(signed.userOp);
+        }
+        // 2. 执行买入
+        const buyResult = await this.runHandleOps('buyBundle', buyOps, bundlerSigner, beneficiary);
+        if (!buyResult) {
+            throw new Error('买入交易失败');
+        }
+        // 3. 获取代币余额
+        const senders = await Promise.all(wallets.map((w) => this.aaManager.predictSenderAddress(w.address)));
+        const tokenBalances = await this.portalQuery.getMultipleTokenBalances(tokenAddress, senders);
+        // 4. 可选：转账代币回 owner
+        let transferResult;
+        if (transferBackToOwner) {
+            const transferOps = [];
+            for (let i = 0; i < wallets.length; i++) {
+                const signed = await this.buildTransferTokenUserOp(wallets[i], tokenAddress, `owner${i + 1}`);
+                if (signed) {
+                    transferOps.push(signed.userOp);
+                }
+            }
+            if (transferOps.length > 0) {
+                transferResult = await this.runHandleOps('transferBundle', transferOps, bundlerSigner, beneficiary) ?? undefined;
+            }
+        }
+        return { buyResult, transferResult, tokenBalances };
+    }
+    /**
+     * 捆绑卖出
+     *
+     * 多个地址同一笔 handleOps 卖出代币
+     */
+    async bundleSell(params) {
+        const { tokenAddress, privateKeys, sellPercent = 100, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, } = params;
+        const wallets = privateKeys.map((pk) => createWallet(pk, this.config));
+        const bundlerSigner = wallets[0];
+        const beneficiary = bundlerSigner.address;
+        const reserveWei = parseOkb(withdrawReserve);
+        console.log('=== XLayer Bundle Sell ===');
+        console.log('token:', tokenAddress);
+        console.log('owners:', wallets.length);
+        console.log('sellPercent:', sellPercent);
+        // 获取 sender 列表和余额
+        const senders = await Promise.all(wallets.map((w) => this.aaManager.predictSenderAddress(w.address)));
+        const tokenBalances = await this.portalQuery.getMultipleTokenBalances(tokenAddress, senders);
+        const allowances = await this.portalQuery.getMultipleAllowances(tokenAddress, senders);
+        // 1. 检查授权，必要时先 approve
+        const approveOps = [];
+        for (let i = 0; i < wallets.length; i++) {
+            const sender = senders[i];
+            const balance = tokenBalances.get(sender) ?? 0n;
+            const allowance = allowances.get(sender) ?? 0n;
+            if (balance === 0n)
+                continue;
+            if (allowance >= balance)
+                continue;
+            const accountInfo = await this.aaManager.getAccountInfo(wallets[i].address);
+            const signed = await this.buildApproveUserOp(wallets[i], tokenAddress, this.portalAddress, accountInfo.nonce, `owner${i + 1}`);
+            approveOps.push(signed.userOp);
+        }
+        let approveResult;
+        if (approveOps.length > 0) {
+            approveResult = await this.runHandleOps('approveBundle', approveOps, bundlerSigner, beneficiary) ?? undefined;
+        }
+        // 2. 卖出
+        const sellOps = [];
+        for (let i = 0; i < wallets.length; i++) {
+            const sender = senders[i];
+            const balance = tokenBalances.get(sender) ?? 0n;
+            if (balance === 0n)
+                continue;
+            const sellAmount = (balance * BigInt(sellPercent)) / 100n;
+            if (sellAmount === 0n)
+                continue;
+            const accountInfo = await this.aaManager.getAccountInfo(wallets[i].address);
+            const allowance = allowances.get(sender) ?? 0n;
+            const needApprove = allowance < sellAmount && approveOps.length > 0;
+            const signed = await this.buildSellUserOp(wallets[i], tokenAddress, sellAmount, accountInfo.nonce, needApprove, `owner${i + 1}`);
+            sellOps.push(signed.userOp);
+        }
+        const sellResult = await this.runHandleOps('sellBundle', sellOps, bundlerSigner, beneficiary);
+        if (!sellResult) {
+            throw new Error('卖出交易失败');
+        }
+        // 3. 可选：归集 OKB
+        let withdrawResult;
+        if (withdrawToOwner) {
+            const withdrawOps = [];
+            for (let i = 0; i < wallets.length; i++) {
+                const signed = await this.buildWithdrawUserOp(wallets[i], reserveWei, `owner${i + 1}`);
+                if (signed) {
+                    withdrawOps.push(signed.userOp);
+                }
+            }
+            if (withdrawOps.length > 0) {
+                withdrawResult = await this.runHandleOps('withdrawBundle', withdrawOps, bundlerSigner, beneficiary) ?? undefined;
+            }
+        }
+        return { approveResult, sellResult, withdrawResult };
+    }
+    /**
+     * 捆绑买卖（先买后卖）
+     *
+     * 完整流程：买入 -> 授权 -> 卖出 -> 归集
+     */
+    async bundleBuySell(params) {
+        const { tokenAddress, privateKeys, buyAmounts, sellPercent = 100, withdrawToOwner = true, withdrawReserve = DEFAULT_WITHDRAW_RESERVE, } = params;
+        if (privateKeys.length !== buyAmounts.length) {
+            throw new Error('私钥数量和购买金额数量必须一致');
+        }
+        const wallets = privateKeys.map((pk) => createWallet(pk, this.config));
+        const bundlerSigner = wallets[0];
+        const beneficiary = bundlerSigner.address;
+        const reserveWei = parseOkb(withdrawReserve);
+        console.log('=== XLayer Bundle Buy -> Sell ===');
+        console.log('token:', tokenAddress);
+        console.log('owners:', wallets.length);
+        console.log('sellPercent:', sellPercent);
+        // 获取 sender 列表
+        const senders = await Promise.all(wallets.map((w) => this.aaManager.predictSenderAddress(w.address)));
+        // 1. 买入
+        const buyOps = [];
+        for (let i = 0; i < wallets.length; i++) {
+            const buyWei = parseOkb(buyAmounts[i]);
+            const signed = await this.buildBuyUserOp(wallets[i], tokenAddress, buyWei, `owner${i + 1}`);
+            buyOps.push(signed.userOp);
+        }
+        const buyResult = await this.runHandleOps('buyBundle', buyOps, bundlerSigner, beneficiary);
+        if (!buyResult) {
+            throw new Error('买入交易失败');
+        }
+        // 获取买入后的代币余额
+        const tokenBalances = await this.portalQuery.getMultipleTokenBalances(tokenAddress, senders);
+        const allowances = await this.portalQuery.getMultipleAllowances(tokenAddress, senders);
+        // 2. 授权 + 卖出（可以合并到同一笔 handleOps）
+        const sellOps = [];
+        for (let i = 0; i < wallets.length; i++) {
+            const sender = senders[i];
+            const balance = tokenBalances.get(sender) ?? 0n;
+            if (balance === 0n) {
+                console.log(`[owner${i + 1}] 没买到代币，跳过卖出`);
+                continue;
+            }
+            const allowance = allowances.get(sender) ?? 0n;
+            let baseNonce = (await this.aaManager.getAccountInfo(wallets[i].address)).nonce;
+            // 如果需要授权，先添加 approve op
+            const needApprove = allowance < balance;
+            if (needApprove) {
+                const approveOp = await this.buildApproveUserOp(wallets[i], tokenAddress, this.portalAddress, baseNonce, `owner${i + 1}`);
+                sellOps.push(approveOp.userOp);
+                baseNonce = baseNonce + 1n;
+            }
+            // 添加 sell op
+            const sellAmount = (balance * BigInt(sellPercent)) / 100n;
+            const sellOp = await this.buildSellUserOp(wallets[i], tokenAddress, sellAmount, baseNonce, needApprove, `owner${i + 1}`);
+            sellOps.push(sellOp.userOp);
+        }
+        const sellResult = await this.runHandleOps('sellBundle', sellOps, bundlerSigner, beneficiary);
+        if (!sellResult) {
+            throw new Error('卖出交易失败');
+        }
+        // 3. 可选：归集 OKB
+        let withdrawResult;
+        if (withdrawToOwner) {
+            const withdrawOps = [];
+            for (let i = 0; i < wallets.length; i++) {
+                const signed = await this.buildWithdrawUserOp(wallets[i], reserveWei, `owner${i + 1}`);
+                if (signed) {
+                    withdrawOps.push(signed.userOp);
+                }
+            }
+            if (withdrawOps.length > 0) {
+                withdrawResult = await this.runHandleOps('withdrawBundle', withdrawOps, bundlerSigner, beneficiary) ?? undefined;
+            }
+        }
+        // 最终余额
+        const finalBalances = await this.portalQuery.getMultipleOkbBalances(senders);
+        return { buyResult, sellResult, withdrawResult, finalBalances };
+    }
+}
+// ============================================================================
+// 便捷函数
+// ============================================================================
+/**
+ * 创建捆绑交易执行器
+ */
+export function createBundleExecutor(config) {
+    return new BundleExecutor(config);
+}
+/**
+ * 快速捆绑买入
+ */
+export async function bundleBuy(params) {
+    const executor = createBundleExecutor(params.config);
+    return executor.bundleBuy(params);
+}
+/**
+ * 快速捆绑卖出
+ */
+export async function bundleSell(params) {
+    const executor = createBundleExecutor(params.config);
+    return executor.bundleSell(params);
+}
+/**
+ * 快速捆绑买卖
+ */
+export async function bundleBuySell(params) {
+    const executor = createBundleExecutor(params.config);
+    return executor.bundleBuySell(params);
+}

package/dist/xlayer/bundler.d.ts

@@ -0,0 +1,111 @@
+/**
+ * XLayer Bundler 客户端
+ *
+ * 与 Particle Bundler 交互，提供 ERC-4337 相关 RPC 方法
+ */
+import type { UserOperation, GasEstimate } from './types.js';
+export interface BundlerConfig {
+    /** Bundler URL */
+    url?: string;
+    /** Chain ID */
+    chainId?: number;
+    /** EntryPoint 地址 */
+    entryPoint?: string;
+    /** 请求超时时间（毫秒） */
+    timeoutMs?: number;
+    /** 额外请求头 */
+    headers?: Record<string, string>;
+}
+export interface BundlerReceipt {
+    userOpHash: string;
+    sender: string;
+    nonce: string;
+    actualGasCost: string;
+    actualGasUsed: string;
+    success: boolean;
+    logs: any[];
+    receipt: {
+        transactionHash: string;
+        transactionIndex: number;
+        blockHash: string;
+        blockNumber: number;
+        from: string;
+        to: string;
+        gasUsed: string;
+        status: string;
+    };
+}
+/**
+ * Particle Bundler 客户端
+ *
+ * 提供与 ERC-4337 Bundler 交互的方法：
+ * - eth_supportedEntryPoints
+ * - eth_estimateUserOperationGas
+ * - eth_sendUserOperation
+ * - eth_getUserOperationReceipt
+ * - eth_getUserOperationByHash
+ */
+export declare class BundlerClient {
+    private url;
+    private chainId;
+    private entryPoint;
+    private timeoutMs;
+    private headers;
+    constructor(config?: BundlerConfig);
+    /**
+     * 发送 JSON-RPC 请求到 Bundler
+     */
+    private rpc;
+    /**
+     * 获取支持的 EntryPoint 列表
+     */
+    getSupportedEntryPoints(): Promise<string[]>;
+    /**
+     * 估算 UserOperation Gas
+     *
+     * @param userOp 未签名的 UserOperation（signature 可为空）
+     * @returns Gas 估算结果
+     */
+    estimateUserOperationGas(userOp: UserOperation): Promise<GasEstimate>;
+    /**
+     * 发送 UserOperation
+     *
+     * @param userOp 已签名的 UserOperation
+     * @returns userOpHash
+     */
+    sendUserOperation(userOp: UserOperation): Promise<string>;
+    /**
+     * 获取 UserOperation 回执
+     *
+     * @param userOpHash UserOperation 哈希
+     * @returns 回执（如果还未被打包则返回 null）
+     */
+    getUserOperationReceipt(userOpHash: string): Promise<BundlerReceipt | null>;
+    /**
+     * 根据 hash 获取 UserOperation
+     *
+     * @param userOpHash UserOperation 哈希
+     */
+    getUserOperationByHash(userOpHash: string): Promise<any>;
+    /**
+     * 等待 UserOperation 被打包
+     *
+     * @param userOpHash UserOperation 哈希
+     * @param maxTries 最大轮询次数（默认 80）
+     * @param intervalMs 轮询间隔（默认 1500ms）
+     * @returns 回执
+     */
+    waitForUserOperationReceipt(userOpHash: string, maxTries?: number, intervalMs?: number): Promise<BundlerReceipt | null>;
+    /**
+     * 获取当前使用的 EntryPoint 地址
+     */
+    getEntryPoint(): string;
+    /**
+     * 获取当前链 ID
+     */
+    getChainId(): number;
+}
+/**
+ * 创建默认的 Bundler 客户端
+ */
+export declare function createBundlerClient(config?: BundlerConfig): BundlerClient;