four-flap-meme-sdk 1.6.53 → 1.6.55

package/dist/utils/holders-maker.js

@@ -10,7 +10,7 @@ import { generateWallets } from './wallet.js';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, getDeadline } from './bundle-helpers.js';
 import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, PROFIT_CONFIG } from './constants.js';
 import { FLAP_PORTAL_ADDRESSES } from '../flap/constants.js';
-import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_ABI } from '../abis/common.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, ERC20_ABI } from '../abis/common.js';
 // Four 内盘 ABI
 const FOUR_TM2_ABI = [
     'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable'
@@ -423,32 +423,59 @@ async function buildV2BuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, ga
  * 构建 V3 单跳买入交易
  * BNB/OKB → Token (使用 exactInputSingle + multicall)
  *
- * ✅ 修复：使用 ethers.Interface 手动编码 calldata，避免 multicall 重载问题
+ * ✅ 修复：根据链类型选择正确的 Router ABI 版本
+ * - XLayer/Monad: 旧版 Router（exactInputSingle 包含 deadline，multicall(bytes[])）
+ * - BSC: 新版 SwapRouter02（exactInputSingle 不含 deadline，multicall(uint256,bytes[])）
  */
 async function buildV3BuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, v3Fee = 2500, // 默认 0.25% 手续费
 chain) {
     const deadline = getDeadline();
-    const v3RouterIface = new ethers.Interface(V3_ROUTER02_ABI);
     const wrappedNative = getWrappedNativeAddress(chain);
     const routerAddress = chain === 'XLAYER' ? XLAYER_V3_ROUTER_ADDRESS : PANCAKE_V3_ROUTER_ADDRESS;
-    // 构建 exactInputSingle calldata
-    const swapParams = {
-        tokenIn: wrappedNative,
-        tokenOut: tokenAddress,
-        fee: v3Fee,
-        recipient: wallet.address,
-        amountIn: buyAmount,
-        amountOutMinimum: 0n,
-        sqrtPriceLimitX96: 0n
-    };
-    const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
-    // ✅ 添加 refundETH，退还多余的 ETH/OKB
-    const refundETHData = v3RouterIface.encodeFunctionData('refundETH', []);
-    // ✅ 使用明确的函数签名编码 multicall，避免重载问题
-    const multicallData = v3RouterIface.encodeFunctionData('multicall(uint256,bytes[])', [
-        deadline,
-        [exactInputSingleData, refundETHData]
-    ]);
+    // ✅ 根据链类型选择正确的 ABI 版本
+    // XLayer/Monad 使用旧版 Router（exactInputSingle 包含 deadline）
+    // BSC 使用新版 SwapRouter02（exactInputSingle 不含 deadline）
+    const useLegacyRouter = chain === 'XLAYER' || chain === 'MONAD';
+    const v3RouterIface = new ethers.Interface(useLegacyRouter ? V3_ROUTER_LEGACY_ABI : V3_ROUTER02_ABI);
+    let multicallData;
+    if (useLegacyRouter) {
+        // ✅ 旧版 Router：swapParams 包含 deadline，multicall(bytes[])
+        const swapParams = {
+            tokenIn: wrappedNative,
+            tokenOut: tokenAddress,
+            fee: v3Fee,
+            recipient: wallet.address,
+            deadline, // ✅ 旧版包含 deadline
+            amountIn: buyAmount,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n
+        };
+        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
+        const refundETHData = v3RouterIface.encodeFunctionData('refundETH', []);
+        // ✅ 旧版 multicall：只有 bytes[] 参数
+        multicallData = v3RouterIface.encodeFunctionData('multicall(bytes[])', [
+            [exactInputSingleData, refundETHData]
+        ]);
+    }
+    else {
+        // ✅ 新版 SwapRouter02：swapParams 不含 deadline，multicall(uint256,bytes[])
+        const swapParams = {
+            tokenIn: wrappedNative,
+            tokenOut: tokenAddress,
+            fee: v3Fee,
+            recipient: wallet.address,
+            amountIn: buyAmount,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n
+        };
+        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
+        const refundETHData = v3RouterIface.encodeFunctionData('refundETH', []);
+        // ✅ 新版 multicall：deadline 作为第一个参数
+        multicallData = v3RouterIface.encodeFunctionData('multicall(uint256,bytes[])', [
+            deadline,
+            [exactInputSingleData, refundETHData]
+        ]);
+    }
     const tx = {
         to: routerAddress,
         data: multicallData,

package/dist/xlayer/bundle-buy-first.d.ts

@@ -0,0 +1,102 @@
+/**
+ * XLayer AA 捆绑刷量模式（Bundle Buy-First）
+ *
+ * 核心逻辑：多钱包分开执行买入和卖出，所有操作合并到一个 handleOps 中原子执行
+ *
+ * 结构：[买入Ops...] + [卖出Ops...] + [统一利润Op]
+ *
+ * 支持池子类型：
+ * - flap: 内盘 (Portal)
+ * - v2: 土豆 V2 外盘
+ * - v3: 土豆 V3 外盘
+ *
+ * 安全说明：利润配置硬编码在 SDK 内部，前端无法篡改
+ */
+import type { UserOperation, XLayerConfig } from './types.js';
+export type BundlePoolType = 'flap' | 'v2' | 'v3';
+export interface BundleBuyOpsParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 买家 Owner 私钥列表 */
+    ownerPrivateKeys: string[];
+    /** 每个 Owner 的买入金额 (OKB) */
+    buyAmountsOkb: string[];
+    /** 池子类型 */
+    poolType?: BundlePoolType;
+    /** V2/V3 Router 地址（poolType 为 v2/v3 时必填） */
+    routerAddress?: string;
+    /** V3 pool fee */
+    v3Fee?: number;
+    /** Wrapped OKB 地址（默认 WOKB） */
+    wrappedOkbAddress?: string;
+    /** 交易截止时间（分钟），默认 20 */
+    deadlineMinutes?: number;
+    /** SDK 配置 */
+    config?: Partial<XLayerConfig>;
+}
+export interface BundleSellOpsParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 卖家 Owner 私钥列表 */
+    ownerPrivateKeys: string[];
+    /** 每个 Owner 要卖出的代币数量（字符串） */
+    sellAmounts: string[];
+    /** 代币精度（默认 18） */
+    tokenDecimals?: number;
+    /** 池子类型 */
+    poolType?: BundlePoolType;
+    /** V2/V3 Router 地址 */
+    routerAddress?: string;
+    /** V3 pool fee */
+    v3Fee?: number;
+    /** Wrapped OKB 地址 */
+    wrappedOkbAddress?: string;
+    /** 交易截止时间（分钟） */
+    deadlineMinutes?: number;
+    /** Nonce 偏移量映射（用于处理同一 sender 既买又卖的情况） */
+    nonceOffsetMap?: Map<string, number>;
+    /** 是否跳过授权（假设已预先授权） */
+    skipApprove?: boolean;
+    /** SDK 配置 */
+    config?: Partial<XLayerConfig>;
+}
+export interface BundleOpsResult {
+    /** 构建的 UserOps */
+    ops: UserOperation[];
+    /** Sender 地址列表 */
+    senders: string[];
+    /** 利润金额 (wei) */
+    profitWei: bigint;
+}
+export interface BundleProfitOpParams {
+    /** Owner 私钥 */
+    ownerPrivateKey: string;
+    /** 利润金额 (wei) */
+    profitWei: bigint;
+    /** Nonce 偏移量 */
+    nonceOffset?: number;
+    /** SDK 配置 */
+    config?: Partial<XLayerConfig>;
+}
+/**
+ * 构建捆绑买入 UserOps
+ */
+export declare function buildBundleBuyOps(params: BundleBuyOpsParams): Promise<BundleOpsResult>;
+/**
+ * 构建捆绑卖出 UserOps
+ */
+export declare function buildBundleSellOps(params: BundleSellOpsParams): Promise<BundleOpsResult>;
+/**
+ * 构建独立的利润 UserOp
+ */
+export declare function buildBundleProfitOp(params: BundleProfitOpParams): Promise<{
+    op: UserOperation;
+    sender: string;
+} | null>;
+/**
+ * 过滤掉利润 UserOps（通过检查 callData 是否包含利润接收地址来识别）
+ */
+export declare function filterOutProfitOps(ops: UserOperation[]): {
+    filteredOps: UserOperation[];
+    removedCount: number;
+};

package/dist/xlayer/bundle-buy-first.js

@@ -0,0 +1,336 @@
+/**
+ * XLayer AA 捆绑刷量模式（Bundle Buy-First）
+ *
+ * 核心逻辑：多钱包分开执行买入和卖出，所有操作合并到一个 handleOps 中原子执行
+ *
+ * 结构：[买入Ops...] + [卖出Ops...] + [统一利润Op]
+ *
+ * 支持池子类型：
+ * - flap: 内盘 (Portal)
+ * - v2: 土豆 V2 外盘
+ * - v3: 土豆 V3 外盘
+ *
+ * 安全说明：利润配置硬编码在 SDK 内部，前端无法篡改
+ */
+import { ethers } from 'ethers';
+import { createAAAccountManager, encodeExecute, createWallet } from './aa-account.js';
+import { encodeBuyCall, encodeSellCall } from './portal-ops.js';
+import { encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, encodeSwapExactETHForTokensV3, encodeSwapExactTokensForETHV3, } from './dex.js';
+import { encodeApproveCall } from './portal-ops.js';
+import { FLAP_PORTAL, WOKB, } from './constants.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+import { mapWithConcurrency } from '../utils/concurrency.js';
+// ============================================================================
+// 买入 UserOps 构建
+// ============================================================================
+/**
+ * 构建捆绑买入 UserOps
+ */
+export async function buildBundleBuyOps(params) {
+    const poolType = params.poolType || 'flap';
+    const wokb = params.wrappedOkbAddress || WOKB;
+    const v3Fee = params.v3Fee || 2500;
+    const deadline = Math.floor(Date.now() / 1000) + 60 * Math.max(1, Number(params.deadlineMinutes ?? 20));
+    const portal = FLAP_PORTAL;
+    const routerAddress = params.routerAddress || '';
+    // 参数校验
+    if ((poolType === 'v2' || poolType === 'v3') && !routerAddress) {
+        throw new Error(`[buildBundleBuyOps] poolType=${poolType} 时必须提供 routerAddress`);
+    }
+    if (params.ownerPrivateKeys.length !== params.buyAmountsOkb.length) {
+        throw new Error('[buildBundleBuyOps] 私钥数量与买入金额数量不一致');
+    }
+    const config = { ...(params.config ?? {}) };
+    const aaManager = createAAAccountManager(config);
+    const ownerWallets = params.ownerPrivateKeys.map(pk => createWallet(pk, config));
+    const owners = ownerWallets.map(w => w.address);
+    const accounts = await aaManager.getMultipleAccountInfo(owners);
+    const senders = accounts.map(ai => String(ai?.sender || ''));
+    // 利润计算
+    const profitBps = PROFIT_CONFIG.RATE_BPS;
+    const profitRecipient = PROFIT_CONFIG.RECIPIENT;
+    const buyWeis = [];
+    let totalProfitWei = 0n;
+    for (const amt of params.buyAmountsOkb) {
+        const original = ethers.parseEther(String(amt || '0'));
+        if (original > 0n) {
+            const profit = (original * BigInt(profitBps)) / 10000n;
+            buyWeis.push(original - profit);
+            totalProfitWei += profit;
+        }
+        else {
+            buyWeis.push(original);
+        }
+    }
+    // Nonce 和 initCode 管理
+    const nonceNext = new Map();
+    const nextNonce = (sender, startNonce) => {
+        const k = sender.toLowerCase();
+        if (!nonceNext.has(k))
+            nonceNext.set(k, startNonce);
+        const n = nonceNext.get(k);
+        nonceNext.set(k, n + 1n);
+        return n;
+    };
+    const initCodeBySender = new Map();
+    const consumeInitCode = (sender, deployed, ownerAddress) => {
+        const k = sender.toLowerCase();
+        if (!initCodeBySender.has(k)) {
+            initCodeBySender.set(k, deployed ? '0x' : aaManager.generateInitCode(ownerAddress));
+        }
+        const cur = initCodeBySender.get(k);
+        if (cur !== '0x')
+            initCodeBySender.set(k, '0x');
+        return cur;
+    };
+    const callGasLimit = 800000n;
+    const unsignedOps = [];
+    const opOwnerIndex = [];
+    for (let i = 0; i < ownerWallets.length; i++) {
+        const ownerWallet = ownerWallets[i];
+        const acc = accounts[i];
+        const sender = String(acc?.sender || '');
+        if (!/^0x[a-fA-F0-9]{40}$/.test(sender))
+            continue;
+        const buyWei = buyWeis[i] ?? 0n;
+        if (buyWei <= 0n)
+            continue;
+        let swapData;
+        let targetContract;
+        if (poolType === 'flap') {
+            swapData = encodeBuyCall(params.tokenAddress, buyWei, 0n);
+            targetContract = portal;
+        }
+        else if (poolType === 'v3') {
+            swapData = encodeSwapExactETHForTokensV3({
+                tokenIn: wokb,
+                tokenOut: params.tokenAddress,
+                fee: v3Fee,
+                recipient: sender,
+                deadline,
+                amountIn: buyWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            });
+            targetContract = routerAddress;
+        }
+        else {
+            swapData = encodeSwapExactETHForTokensSupportingFee(0n, [wokb, params.tokenAddress], sender, deadline);
+            targetContract = routerAddress;
+        }
+        const callData = encodeExecute(targetContract, buyWei, swapData);
+        const nonce = nextNonce(sender, BigInt(acc?.nonce ?? 0n));
+        const initCode = consumeInitCode(sender, !!acc?.deployed, ownerWallet.address);
+        const { userOp } = await aaManager.buildUserOpWithFixedGas({
+            ownerWallet,
+            sender,
+            callData,
+            nonce,
+            initCode,
+            deployed: initCode === '0x',
+            fixedGas: { callGasLimit },
+        });
+        unsignedOps.push(userOp);
+        opOwnerIndex.push(i);
+    }
+    // 添加利润 UserOp
+    if (totalProfitWei > 0n && ownerWallets.length > 0) {
+        const profitSenderIndex = 0;
+        const profitSender = senders[profitSenderIndex] || '';
+        const profitOwner = ownerWallets[profitSenderIndex];
+        const profitAi = accounts[profitSenderIndex];
+        if (profitSender && profitOwner) {
+            const profitCallData = encodeExecute(profitRecipient, totalProfitWei, '0x');
+            const profitNonce = nextNonce(profitSender, BigInt(profitAi?.nonce ?? 0n));
+            const profitInitCode = consumeInitCode(profitSender, !!profitAi?.deployed, profitOwner.address);
+            const { userOp: profitOp } = await aaManager.buildUserOpWithFixedGas({
+                ownerWallet: profitOwner,
+                sender: profitSender,
+                callData: profitCallData,
+                nonce: profitNonce,
+                initCode: profitInitCode,
+                deployed: profitInitCode === '0x',
+                fixedGas: { callGasLimit: 120000n },
+            });
+            unsignedOps.push(profitOp);
+            opOwnerIndex.push(profitSenderIndex);
+        }
+    }
+    // 签名
+    const signedOps = await mapWithConcurrency(unsignedOps.map((op, i) => ({ op, ownerIdx: opOwnerIndex[i] })), 20, async ({ op, ownerIdx }) => {
+        const ownerWallet = ownerWallets[ownerIdx];
+        const signed = await aaManager.signUserOp(op, ownerWallet);
+        return signed.userOp;
+    });
+    return { ops: signedOps, senders, profitWei: totalProfitWei };
+}
+// ============================================================================
+// 卖出 UserOps 构建
+// ============================================================================
+/**
+ * 构建捆绑卖出 UserOps
+ */
+export async function buildBundleSellOps(params) {
+    const poolType = params.poolType || 'flap';
+    const wokb = params.wrappedOkbAddress || WOKB;
+    const v3Fee = params.v3Fee || 2500;
+    const deadline = Math.floor(Date.now() / 1000) + 60 * Math.max(1, Number(params.deadlineMinutes ?? 20));
+    const portal = FLAP_PORTAL;
+    const routerAddress = params.routerAddress || '';
+    const tokenDecimals = params.tokenDecimals ?? 18;
+    const nonceOffsetMap = params.nonceOffsetMap ?? new Map();
+    if ((poolType === 'v2' || poolType === 'v3') && !routerAddress) {
+        throw new Error(`[buildBundleSellOps] poolType=${poolType} 时必须提供 routerAddress`);
+    }
+    if (params.ownerPrivateKeys.length !== params.sellAmounts.length) {
+        throw new Error('[buildBundleSellOps] 私钥数量与卖出金额数量不一致');
+    }
+    const config = { ...(params.config ?? {}) };
+    const aaManager = createAAAccountManager(config);
+    const ownerWallets = params.ownerPrivateKeys.map(pk => createWallet(pk, config));
+    const owners = ownerWallets.map(w => w.address);
+    const accounts = await aaManager.getMultipleAccountInfo(owners);
+    const senders = accounts.map(ai => String(ai?.sender || ''));
+    // 利润计算（从卖出金额中扣除）
+    const profitBps = PROFIT_CONFIG.RATE_BPS;
+    const profitRecipient = PROFIT_CONFIG.RECIPIENT;
+    let totalProfitWei = 0n;
+    const unsignedOps = [];
+    const opOwnerIndex = [];
+    for (let i = 0; i < ownerWallets.length; i++) {
+        const ownerWallet = ownerWallets[i];
+        const acc = accounts[i];
+        const sender = String(acc?.sender || '');
+        if (!/^0x[a-fA-F0-9]{40}$/.test(sender))
+            continue;
+        const sellAmountStr = String(params.sellAmounts[i] || '0');
+        const sellAmount = ethers.parseUnits(sellAmountStr, tokenDecimals);
+        if (sellAmount <= 0n)
+            continue;
+        const senderKey = sender.toLowerCase();
+        const nonceOffset = nonceOffsetMap.get(senderKey) || 0;
+        let currentNonce = BigInt(acc?.nonce ?? 0n) + BigInt(nonceOffset);
+        // Approve（如果需要，外盘模式需要先授权）
+        if (!params.skipApprove && poolType !== 'flap') {
+            const approveCallData = encodeApproveCall(routerAddress);
+            const approveExecuteData = encodeExecute(params.tokenAddress, 0n, approveCallData);
+            const initCode = acc.deployed ? '0x' : aaManager.generateInitCode(ownerWallet.address);
+            const { userOp: approveOp } = await aaManager.buildUserOpWithFixedGas({
+                ownerWallet,
+                sender,
+                callData: approveExecuteData,
+                nonce: currentNonce,
+                initCode,
+                deployed: initCode === '0x',
+                fixedGas: { callGasLimit: 100000n },
+            });
+            unsignedOps.push(approveOp);
+            opOwnerIndex.push(i);
+            currentNonce += 1n;
+        }
+        // Sell
+        let swapData;
+        let targetContract;
+        if (poolType === 'flap') {
+            swapData = encodeSellCall(params.tokenAddress, sellAmount, 0n);
+            targetContract = portal;
+        }
+        else if (poolType === 'v3') {
+            swapData = encodeSwapExactTokensForETHV3({
+                tokenIn: params.tokenAddress,
+                tokenOut: wokb,
+                fee: v3Fee,
+                recipient: sender,
+                unwrapRecipient: sender,
+                deadline,
+                amountIn: sellAmount,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            });
+            targetContract = routerAddress;
+        }
+        else {
+            swapData = encodeSwapExactTokensForETHSupportingFee(sellAmount, 0n, [params.tokenAddress, wokb], sender, deadline);
+            targetContract = routerAddress;
+        }
+        const callData = encodeExecute(targetContract, 0n, swapData);
+        const initCode = acc.deployed ? '0x' : aaManager.generateInitCode(ownerWallet.address);
+        const { userOp } = await aaManager.buildUserOpWithFixedGas({
+            ownerWallet,
+            sender,
+            callData,
+            nonce: currentNonce,
+            initCode: (currentNonce > BigInt(acc?.nonce ?? 0n)) ? '0x' : initCode, // 如果有 approve，则 initCode 已用
+            deployed: true,
+            fixedGas: { callGasLimit: 400000n },
+        });
+        unsignedOps.push(userOp);
+        opOwnerIndex.push(i);
+    }
+    // 签名
+    const signedOps = await mapWithConcurrency(unsignedOps.map((op, i) => ({ op, ownerIdx: opOwnerIndex[i] })), 20, async ({ op, ownerIdx }) => {
+        const ownerWallet = ownerWallets[ownerIdx];
+        const signed = await aaManager.signUserOp(op, ownerWallet);
+        return signed.userOp;
+    });
+    return { ops: signedOps, senders, profitWei: totalProfitWei };
+}
+// ============================================================================
+// 利润 UserOp 构建
+// ============================================================================
+/**
+ * 构建独立的利润 UserOp
+ */
+export async function buildBundleProfitOp(params) {
+    if (params.profitWei <= 0n)
+        return null;
+    const config = { ...(params.config ?? {}) };
+    const aaManager = createAAAccountManager(config);
+    const ownerWallet = createWallet(params.ownerPrivateKey, config);
+    const accountInfo = await aaManager.getAccountInfo(ownerWallet.address);
+    const sender = String(accountInfo?.sender || '');
+    if (!/^0x[a-fA-F0-9]{40}$/.test(sender))
+        return null;
+    const profitRecipient = PROFIT_CONFIG.RECIPIENT;
+    const profitCallData = encodeExecute(profitRecipient, params.profitWei, '0x');
+    const nonce = BigInt(accountInfo?.nonce ?? 0n) + BigInt(params.nonceOffset || 0);
+    const initCode = accountInfo?.deployed ? '0x' : aaManager.generateInitCode(ownerWallet.address);
+    const { userOp } = await aaManager.buildUserOpWithFixedGas({
+        ownerWallet,
+        sender,
+        callData: profitCallData,
+        nonce,
+        initCode,
+        deployed: initCode === '0x',
+        fixedGas: { callGasLimit: 120000n },
+    });
+    const signedResult = await aaManager.signUserOp(userOp, ownerWallet);
+    const signedOp = signedResult.userOp;
+    console.log(`[buildBundleProfitOp] 构建利润 UserOp: sender=${sender.slice(0, 10)}..., profit=${params.profitWei} wei`);
+    return { op: signedOp, sender };
+}
+// ============================================================================
+// 过滤利润 UserOps 工具函数
+// ============================================================================
+/**
+ * 过滤掉利润 UserOps（通过检查 callData 是否包含利润接收地址来识别）
+ */
+export function filterOutProfitOps(ops) {
+    const filteredOps = [];
+    let removedCount = 0;
+    const profitRecipient = PROFIT_CONFIG.RECIPIENT.toLowerCase();
+    for (const op of ops) {
+        const callData = String(op.callData || '').toLowerCase();
+        // 利润 UserOp 的 callData 包含利润接收地址
+        if (callData.includes(profitRecipient.slice(2))) {
+            // 确认这是一个转账到利润地址的 execute 调用
+            const isExecute = callData.startsWith('0xb61d27f6');
+            if (isExecute) {
+                removedCount++;
+                continue;
+            }
+        }
+        filteredOps.push(op);
+    }
+    return { filteredOps, removedCount };
+}

package/dist/xlayer/buy-first-volume.d.ts

@@ -3,12 +3,17 @@
  *
  * - tradeType=FLAP：内盘（Flap Portal）
  * - tradeType=V2：外盘（PotatoSwap V2）
+ * - tradeType=V3：外盘（PotatoSwap V3）
  *
  * 代码实现分离：
  * - 内盘执行器：`portal-buy-first.ts`
  * - 外盘执行器：`dex-buy-first.ts`
+ * - 无币刷量：`wash-ops.ts`（仅生成签名，不执行）
+ * - 捆绑刷量：`bundle-buy-first.ts`（仅生成签名，不执行）
  */
 import type { BuyFirstVolumeParams, BuyFirstVolumeResult, XLayerConfig } from './types.js';
+export { buildWashOps, type WashOpsParams, type WashOpsResult, type WashPoolType, } from './wash-ops.js';
+export { buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, type BundleBuyOpsParams, type BundleSellOpsParams, type BundleProfitOpParams, type BundleOpsResult, type BundlePoolType, } from './bundle-buy-first.js';
 export declare class BuyFirstVolumeExecutor {
     private config;
     constructor(config?: XLayerConfig);

package/dist/xlayer/buy-first-volume.js

@@ -3,14 +3,22 @@
  *
  * - tradeType=FLAP：内盘（Flap Portal）
  * - tradeType=V2：外盘（PotatoSwap V2）
+ * - tradeType=V3：外盘（PotatoSwap V3）
  *
  * 代码实现分离：
  * - 内盘执行器：`portal-buy-first.ts`
  * - 外盘执行器：`dex-buy-first.ts`
+ * - 无币刷量：`wash-ops.ts`（仅生成签名，不执行）
+ * - 捆绑刷量：`bundle-buy-first.ts`（仅生成签名，不执行）
  */
 import { parseOkb } from './portal-ops.js';
 import { AAPortalBuyFirstExecutor } from './portal-buy-first.js';
 import { AADexBuyFirstExecutor } from './dex-buy-first.js';
+// ============================================================================
+// ✅ 重新导出无币刷量和捆绑刷量（仅生成签名）
+// ============================================================================
+export { buildWashOps, } from './wash-ops.js';
+export { buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, } from './bundle-buy-first.js';
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/xlayer/index.d.ts

@@ -89,6 +89,8 @@ export { DexQuery, DexExecutor, createDexQuery, createDexExecutor, quoteOkbToTok
 export { buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, } from './dex-aa-buy.js';
 export { buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, } from './dex-aa-sell.js';
 export { buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, } from './aa-transfer-profit.js';
+export { buildWashOps, type WashOpsParams, type WashOpsResult, type WashPoolType, } from './wash-ops.js';
+export { buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, type BundleBuyOpsParams, type BundleSellOpsParams, type BundleProfitOpParams, type BundleOpsResult, type BundlePoolType, } from './bundle-buy-first.js';
 export declare const xlayer: {
     bundleBuy: (params: import("./types.js").BundleBuyParams) => Promise<import("./types.js").BundleBuyResult>;
     bundleSell: (params: import("./types.js").BundleSellParams) => Promise<import("./types.js").BundleSellResult>;

package/dist/xlayer/index.js

@@ -160,6 +160,14 @@ export { buildDexBatchSellOps, buildDexBatchSellOpsV3, } from './dex-aa-sell.js'
 // ============================================================================
 export { buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, } from './aa-transfer-profit.js';
 // ============================================================================
+// ✅ AA 无币刷量模式（Wash Trading）
+// ============================================================================
+export { buildWashOps, } from './wash-ops.js';
+// ============================================================================
+// ✅ AA 捆绑刷量模式（Bundle Buy-First）
+// ============================================================================
+export { buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, } from './bundle-buy-first.js';
+// ============================================================================
 // 便捷重导出
 // ============================================================================
 // 将最常用的函数放在默认导出对象中

package/dist/xlayer/wash-ops.d.ts

@@ -0,0 +1,55 @@
+/**
+ * XLayer AA 无币刷量模式（Wash Trading）
+ *
+ * 核心逻辑：每个钱包在一个 handleOps 中原子执行 [利润刮取 + 买入 + 卖出]
+ *
+ * 支持池子类型：
+ * - flap: 内盘 (Portal)
+ * - v2: 土豆 V2 外盘
+ * - v3: 土豆 V3 外盘
+ *
+ * 安全说明：利润配置硬编码在 SDK 内部，前端无法篡改
+ * - 利润比例：PROFIT_CONFIG.RATE_BPS (40 bps = 0.4%)
+ * - 利润接收者：PROFIT_CONFIG.RECIPIENT
+ */
+import type { UserOperation, XLayerConfig } from './types.js';
+export type WashPoolType = 'flap' | 'v2' | 'v3';
+export interface WashOpsParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** Owner 私钥列表 */
+    ownerPrivateKeys: string[];
+    /** 每个 Owner 的买入金额 (OKB) */
+    buyAmountsOkb: string[];
+    /** 池子类型 */
+    poolType?: WashPoolType;
+    /** V2/V3 Router 地址（poolType 为 v2/v3 时必填） */
+    routerAddress?: string;
+    /** V3 pool fee (poolType 为 v3 时必填，e.g., 100, 500, 2500, 10000) */
+    v3Fee?: number;
+    /** Wrapped OKB 地址（默认 WOKB） */
+    wrappedOkbAddress?: string;
+    /** 交易截止时间（分钟），默认 20 */
+    deadlineMinutes?: number;
+    /** SDK 配置 */
+    config?: Partial<XLayerConfig>;
+}
+export interface WashOpsResult {
+    /** 构建的 UserOps（可直接传递给 handleOps） */
+    ops: UserOperation[];
+    /** 所有 Sender 地址（唯一） */
+    senders: string[];
+    /** 总利润金额 (wei) */
+    profitWei: bigint;
+}
+/**
+ * 构建无币刷量 UserOps
+ *
+ * 每个钱包生成 2-3 个 UserOps：
+ * - [可选] 利润刮取 (nonce=N)
+ * - 买入 (nonce=N+1)
+ * - 卖出 (nonce=N+2)
+ *
+ * 所有 UserOps 合并到一个 handleOps 中原子执行
+ */
+export declare function buildWashOps(params: WashOpsParams): Promise<WashOpsResult>;

package/dist/xlayer/wash-ops.js

@@ -0,0 +1,248 @@
+/**
+ * XLayer AA 无币刷量模式（Wash Trading）
+ *
+ * 核心逻辑：每个钱包在一个 handleOps 中原子执行 [利润刮取 + 买入 + 卖出]
+ *
+ * 支持池子类型：
+ * - flap: 内盘 (Portal)
+ * - v2: 土豆 V2 外盘
+ * - v3: 土豆 V3 外盘
+ *
+ * 安全说明：利润配置硬编码在 SDK 内部，前端无法篡改
+ * - 利润比例：PROFIT_CONFIG.RATE_BPS (40 bps = 0.4%)
+ * - 利润接收者：PROFIT_CONFIG.RECIPIENT
+ */
+import { ethers } from 'ethers';
+import { createAAAccountManager, encodeExecute, createWallet } from './aa-account.js';
+import { encodeBuyCall, encodeSellCall, PortalQuery } from './portal-ops.js';
+import { encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, encodeSwapExactETHForTokensV3, encodeSwapExactTokensForETHV3, DexQuery, } from './dex.js';
+import { FLAP_PORTAL, WOKB, } from './constants.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+import { mapWithConcurrency } from '../utils/concurrency.js';
+// ============================================================================
+// 核心实现
+// ============================================================================
+/**
+ * 构建无币刷量 UserOps
+ *
+ * 每个钱包生成 2-3 个 UserOps：
+ * - [可选] 利润刮取 (nonce=N)
+ * - 买入 (nonce=N+1)
+ * - 卖出 (nonce=N+2)
+ *
+ * 所有 UserOps 合并到一个 handleOps 中原子执行
+ */
+export async function buildWashOps(params) {
+    const poolType = params.poolType || 'flap';
+    const wokb = params.wrappedOkbAddress || WOKB;
+    const v3Fee = params.v3Fee || 2500;
+    const deadline = Math.floor(Date.now() / 1000) + 60 * Math.max(1, Number(params.deadlineMinutes ?? 20));
+    const portal = FLAP_PORTAL;
+    const routerAddress = params.routerAddress || '';
+    // 参数校验
+    if (poolType === 'v2' && !routerAddress) {
+        throw new Error('[buildWashOps] poolType=v2 时必须提供 routerAddress');
+    }
+    if (poolType === 'v3' && !routerAddress) {
+        throw new Error('[buildWashOps] poolType=v3 时必须提供 routerAddress');
+    }
+    if (poolType === 'v3' && !params.v3Fee) {
+        throw new Error('[buildWashOps] poolType=v3 时必须提供 v3Fee');
+    }
+    if (params.ownerPrivateKeys.length !== params.buyAmountsOkb.length) {
+        throw new Error('[buildWashOps] 私钥数量与买入金额数量不一致');
+    }
+    const config = { ...(params.config ?? {}) };
+    const aaManager = createAAAccountManager(config);
+    // 创建 Owner 钱包
+    const ownerWallets = params.ownerPrivateKeys.map(pk => createWallet(pk, config));
+    const owners = ownerWallets.map(w => w.address);
+    // 批量获取 accountInfo
+    const accounts = await aaManager.getMultipleAccountInfo(owners);
+    // 利润配置（硬编码）
+    const profitBps = PROFIT_CONFIG.RATE_BPS;
+    const profitRecipient = PROFIT_CONFIG.RECIPIENT;
+    // 计算每个钱包的净买入金额（扣除利润后）
+    const buyWeiList = [];
+    let totalProfitWei = 0n;
+    for (let i = 0; i < ownerWallets.length; i++) {
+        const amt = String(params.buyAmountsOkb[i] || '0');
+        const originalBuyWei = ethers.parseEther(amt);
+        const profitWei = (originalBuyWei * BigInt(profitBps)) / 10000n;
+        const buyWei = originalBuyWei - profitWei;
+        buyWeiList.push(buyWei);
+        totalProfitWei += profitWei;
+    }
+    // 批量预测买入后获得的代币数量（用于卖出，避免 maxUint256 问题）
+    let expectedTokenAmounts = [];
+    if (poolType === 'flap') {
+        const portalQuery = new PortalQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+        expectedTokenAmounts = await mapWithConcurrency(buyWeiList, 4, async (buyWei) => {
+            if (buyWei <= 0n)
+                return 0n;
+            try {
+                return await portalQuery.previewBuy(params.tokenAddress, buyWei);
+            }
+            catch {
+                try {
+                    return await portalQuery.quoteExactInput('0x0000000000000000000000000000000000000000', params.tokenAddress, buyWei);
+                }
+                catch {
+                    return 0n;
+                }
+            }
+        });
+    }
+    else if (poolType === 'v2') {
+        const dexQuery = new DexQuery({ rpcUrl: config.rpcUrl, routerAddress, wokbAddress: wokb });
+        expectedTokenAmounts = await mapWithConcurrency(buyWeiList, 4, async (buyWei) => {
+            if (buyWei <= 0n)
+                return 0n;
+            try {
+                return await dexQuery.quoteOkbToToken(buyWei, params.tokenAddress);
+            }
+            catch {
+                return 0n;
+            }
+        });
+    }
+    else if (poolType === 'v3') {
+        // V3 使用 Portal 的 quoteExactInput 作为 fallback（理想情况下应使用 Quoter 合约）
+        const portalQuery = new PortalQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
+        expectedTokenAmounts = await mapWithConcurrency(buyWeiList, 4, async (buyWei) => {
+            if (buyWei <= 0n)
+                return 0n;
+            try {
+                return await portalQuery.quoteExactInput(wokb, params.tokenAddress, buyWei);
+            }
+            catch {
+                return 0n;
+            }
+        });
+    }
+    console.log(`[buildWashOps] 预测买入代币数量 (${poolType}):`, expectedTokenAmounts.map(a => a.toString()));
+    // 构建所有 UserOps 的骨架
+    const allSkeletons = [];
+    for (let i = 0; i < ownerWallets.length; i++) {
+        const ownerWallet = ownerWallets[i];
+        const acc = accounts[i];
+        const amt = String(params.buyAmountsOkb[i] || '0');
+        const originalBuyWei = ethers.parseEther(amt);
+        const profitWei = (originalBuyWei * BigInt(profitBps)) / 10000n;
+        const buyWei = buyWeiList[i];
+        let currentNonce = BigInt(acc.nonce || 0);
+        const initCode = acc.deployed ? '0x' : aaManager.generateInitCode(ownerWallet.address);
+        // 1) 利润刮取 UserOp（强制执行）
+        if (profitWei > 0n) {
+            const profitCallData = encodeExecute(profitRecipient, profitWei, '0x');
+            allSkeletons.push({
+                ownerWallet,
+                sender: acc.sender,
+                nonce: currentNonce,
+                initCode: initCode, // 第一个 Op 需要 initCode
+                callData: profitCallData,
+                opType: 'profit',
+            });
+            currentNonce += 1n;
+        }
+        // 2) 买入 UserOp
+        let buyCallData;
+        let sellCallData;
+        if (poolType === 'flap') {
+            const buySwapData = encodeBuyCall(params.tokenAddress, buyWei, 0n);
+            buyCallData = encodeExecute(portal, buyWei, buySwapData);
+            const expectedTokenAmount = expectedTokenAmounts[i] || 0n;
+            const sellSwapData = encodeSellCall(params.tokenAddress, expectedTokenAmount, 0n);
+            sellCallData = encodeExecute(portal, 0n, sellSwapData);
+        }
+        else if (poolType === 'v3') {
+            const buySwapData = encodeSwapExactETHForTokensV3({
+                tokenIn: wokb,
+                tokenOut: params.tokenAddress,
+                fee: v3Fee,
+                recipient: acc.sender,
+                deadline,
+                amountIn: buyWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            });
+            buyCallData = encodeExecute(routerAddress, buyWei, buySwapData);
+            const expectedTokenAmount = expectedTokenAmounts[i] || 0n;
+            const sellSwapData = encodeSwapExactTokensForETHV3({
+                tokenIn: params.tokenAddress,
+                tokenOut: wokb,
+                fee: v3Fee,
+                recipient: acc.sender,
+                unwrapRecipient: acc.sender,
+                deadline,
+                amountIn: expectedTokenAmount,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            });
+            sellCallData = encodeExecute(routerAddress, 0n, sellSwapData);
+        }
+        else {
+            // V2
+            const buySwapData = encodeSwapExactETHForTokensSupportingFee(0n, [wokb, params.tokenAddress], acc.sender, deadline);
+            buyCallData = encodeExecute(routerAddress, buyWei, buySwapData);
+            const expectedTokenAmount = expectedTokenAmounts[i] || 0n;
+            const sellSwapData = encodeSwapExactTokensForETHSupportingFee(expectedTokenAmount, 0n, [params.tokenAddress, wokb], acc.sender, deadline);
+            sellCallData = encodeExecute(routerAddress, 0n, sellSwapData);
+        }
+        // 买入 Op 的 initCode：如果有利润 Op，则利润 Op 已处理部署
+        const buyInitCode = profitWei > 0n ? '0x' : initCode;
+        allSkeletons.push({
+            ownerWallet,
+            sender: acc.sender,
+            nonce: currentNonce,
+            initCode: buyInitCode,
+            callData: buyCallData,
+            opType: 'buy',
+        });
+        currentNonce += 1n;
+        // 3) 卖出 UserOp
+        allSkeletons.push({
+            ownerWallet,
+            sender: acc.sender,
+            nonce: currentNonce,
+            initCode: '0x', // 前面已经部署
+            callData: sellCallData,
+            opType: 'sell',
+        });
+    }
+    // 固定 Gas
+    const profitCallGasLimit = 120000n;
+    const tradeCallGasLimit = 400000n;
+    // 构造 UserOps
+    const built = await mapWithConcurrency(allSkeletons, 20, async (sk) => {
+        const callGasLimit = sk.opType === 'profit' ? profitCallGasLimit : tradeCallGasLimit;
+        const { userOp } = await aaManager.buildUserOpWithFixedGas({
+            ownerWallet: sk.ownerWallet,
+            sender: sk.sender,
+            callData: sk.callData,
+            nonce: sk.nonce,
+            initCode: sk.initCode,
+            deployed: String(sk.initCode) === '0x',
+            fixedGas: { callGasLimit },
+        });
+        return userOp;
+    });
+    // 签名
+    const opOwnerIndex = [];
+    for (const sk of allSkeletons) {
+        const ownerIdx = ownerWallets.findIndex(w => w.address === sk.ownerWallet.address);
+        opOwnerIndex.push(ownerIdx >= 0 ? ownerIdx : 0);
+    }
+    const signedOps = await mapWithConcurrency(built.map((op, i) => ({ op, ownerIdx: opOwnerIndex[i] })), 20, async ({ op, ownerIdx }) => {
+        const ownerWallet = ownerWallets[ownerIdx];
+        const signed = await aaManager.signUserOp(op, ownerWallet);
+        return signed.userOp;
+    });
+    const senders = [...new Set(allSkeletons.map(s => s.sender))];
+    // 统计
+    const profitOpCount = allSkeletons.filter(s => s.opType === 'profit').length;
+    const buyOpCount = allSkeletons.filter(s => s.opType === 'buy').length;
+    const sellOpCount = allSkeletons.filter(s => s.opType === 'sell').length;
+    console.log(`[buildWashOps] 构建 ${signedOps.length} 个 UserOps（${ownerWallets.length} 个钱包）:`, `利润=${profitOpCount}, 买入=${buyOpCount}, 卖出=${sellOpCount}`, totalProfitWei > 0n ? `| 总利润=${ethers.formatEther(totalProfitWei)} OKB` : '');
+    return { ops: signedOps, senders, profitWei: totalProfitWei };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.6.53",
+  "version": "1.6.55",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",