four-flap-meme-sdk 2.2.0 → 2.2.2

package/dist/chains/xlayer/eip7702/volume.js

@@ -1,5 +1,16 @@
 /**
- * volume - 主函数
+ * EIP-7702 XLayer 刷量功能
+ *
+ * 支持两种模式：
+ * 1. 无币模式 (Wash): 单钱包买入+卖出，不需要预先持有代币
+ * 2. 捆绑模式 (Bundle): 多钱包批量买入 + 批量卖出
+ *
+ * 支持池子类型：
+ * - FLAP: 内盘 (Flap Portal)
+ * - V2: PotatoSwap V2 外盘
+ * - V3: PotatoSwap V3 外盘
+ *
+ * 只生成签名，由调用方决定如何提交
  */
 import { ethers, Contract } from 'ethers';
 import { getCachedProvider, createWallet, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync, calculateProfitAmountByTxCount, getProfitRecipient, } from './utils.js';
@@ -7,7 +18,40 @@ import { UNIFIED_DELEGATE_ADDRESS, UNIFIED_DELEGATE_ABI, FLAP_PORTAL_ABI, FLAP_P
 import { bundleBuy } from './bundle-buy.js';
 import { bundleSell } from './bundle-sell.js';
 import { bundleSwap } from './bundle-swap.js';
-import { truncateDecimals, } from './volume-helpers.js';
+/**
+ * 截断小数位数，避免 parseEther/parseUnits 报错
+ * @param value 数值字符串
+ * @param decimals 保留的小数位数（默认 18）
+ */
+function truncateDecimals(value, decimals = 18) {
+    if (!value || value === '0')
+        return value;
+    const parts = String(value).split('.');
+    if (parts.length === 1)
+        return value;
+    const intPart = parts[0] || '0';
+    const decPart = (parts[1] || '').slice(0, decimals);
+    return decPart ? `${intPart}.${decPart}` : intPart;
+}
+/**
+ * 无币刷量 - 每个钱包执行买入+卖出
+ *
+ * 核心逻辑：[利润刮取] + [钱包1买入] + [钱包1卖出] + [钱包2买入] + [钱包2卖出] + ...
+ *
+ * 特点：
+ * - 钱包不需要预先持有代币
+ * - 每个钱包在同一笔交易中完成买入和卖出
+ * - 利润从主钱包统一支付
+ *
+ * @example
+ * const result = await washVolume({
+ *   privateKeys: ['0x...', '0x...'],
+ *   tokenAddress: '0x...',
+ *   buyAmountPerWallet: '0.01',
+ *   sellPercent: 100,
+ *   poolType: 'V3',
+ * });
+ */
 export async function washVolume(params) {
     const { mainPrivateKey, privateKeys, tokenAddress, tokenDecimals = 18, buyAmountPerWallet, sellPercent = 100, poolType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', // ✅ 用户类型（影响利润率）
     config, } = params;
@@ -25,10 +69,14 @@ export async function washVolume(params) {
     if (!isValidPrivateKey(mainPrivateKey)) {
         throw new Error('mainPrivateKey 格式无效');
     }
-    const validPrivateKeys = privateKeys.filter((pk) => isValidPrivateKey(pk));
+    const validPrivateKeys = privateKeys.filter(pk => isValidPrivateKey(pk));
     if (validPrivateKeys.length === 0) {
         throw new Error('没有有效的私钥（私钥必须是 0x 开头的 66 位或 64 位十六进制字符串）');
     }
+    if (validPrivateKeys.length !== privateKeys.length) {
+        console.warn(`[washVolume] 跳过 ${privateKeys.length - validPrivateKeys.length} 个无效私钥`);
+    }
+    // 使用验证后的私钥
     const actualPrivateKeys = validPrivateKeys;
     const provider = getCachedProvider(config?.rpcUrl);
     // ✅ 空字符串也使用默认值
@@ -40,7 +88,7 @@ export async function washVolume(params) {
     // ✅ 创建 Payer 钱包（支付 Gas 费）
     const mainWallet = createWallet(mainPrivateKey, provider);
     // 创建交易钱包（使用验证后的私钥）
-    const wallets = actualPrivateKeys.map((pk) => createWallet(pk, provider));
+    const wallets = actualPrivateKeys.map(pk => createWallet(pk, provider));
     // 计算金额（无币刷量：每个钱包 1买 + 1卖 = 2笔交易）
     const buyAmountWei = ethers.parseEther(truncateDecimals(buyAmountPerWallet));
     const totalBuyAmount = buyAmountWei * BigInt(wallets.length);
@@ -53,20 +101,21 @@ export async function washVolume(params) {
     // ========================================
     const allWalletsMap = new Map();
     allWalletsMap.set(mainWallet.address.toLowerCase(), mainWallet);
-    wallets.forEach((w) => allWalletsMap.set(w.address.toLowerCase(), w));
+    wallets.forEach(w => allWalletsMap.set(w.address.toLowerCase(), w));
     const allWallets = Array.from(allWalletsMap.values());
     // 找出 mainWallet 在 allWallets 中的索引
-    const mainWalletIndex = allWallets.findIndex((w) => w.address.toLowerCase() === mainWallet.address.toLowerCase());
+    const mainWalletIndex = allWallets.findIndex(w => w.address.toLowerCase() === mainWallet.address.toLowerCase());
     // ========================================
     // 并行获取数据
     // ========================================
-    const allAddresses = allWallets.map((w) => w.address);
+    const allAddresses = allWallets.map(w => w.address);
     // ✅ 对所有模式，使用【总金额报价 + 按比例分配】
     // 因为所有钱包在同一笔交易中执行，会累积影响价格
     // 这确保了「买多少就卖多少」，避免清空钱包预存代币
     let estimatedTokenAmounts = [];
     const totalBuyWei = buyAmountWei * BigInt(wallets.length);
     if (poolType === 'FLAP') {
+        console.log(`[washVolume] FLAP 总金额报价: ${wallets.length} 个钱包, 每个 ${buyAmountWei} wei, 总计 ${totalBuyWei} wei`);
         try {
             const portalContract = new Contract(FLAP_PORTAL_ADDRESS, FLAP_PORTAL_ABI, provider);
             // ✅ 使用 previewBuy（与 AA 模式一致），降级到 quoteExactInput
@@ -74,16 +123,21 @@ export async function washVolume(params) {
             let totalTokenAmount = 0n;
             try {
                 totalTokenAmount = await portalContract.previewBuy(tokenAddress, totalBuyWei);
+                console.log(`[washVolume] FLAP previewBuy 总预估: ${totalBuyWei} wei OKB -> ${totalTokenAmount} wei 代币`);
             }
-            catch {
+            catch (previewErr) {
+                console.warn(`[washVolume] previewBuy 失败，尝试 quoteExactInput:`, previewErr);
                 try {
+                    // ✅ 降级到 quoteExactInput（与 AA 模式相同的降级策略）
                     totalTokenAmount = await portalContract.quoteExactInput.staticCall({
                         inputToken: ethers.ZeroAddress, // OKB
                         outputToken: tokenAddress, // Token
                         inputAmount: totalBuyWei,
                     });
+                    console.log(`[washVolume] FLAP quoteExactInput 总预估: ${totalBuyWei} wei OKB -> ${totalTokenAmount} wei 代币`);
                 }
-                catch {
+                catch (quoteErr) {
+                    console.warn(`[washVolume] quoteExactInput 也失败:`, quoteErr);
                     totalTokenAmount = 0n;
                 }
             }
@@ -100,23 +154,27 @@ export async function washVolume(params) {
                     return sharePerWallet;
                 });
             }
+            console.log(`[washVolume] FLAP 代币分配:`, estimatedTokenAmounts.map(a => a.toString()));
         }
-        catch {
-            // FLAP quote failed
+        catch (e) {
+            console.warn(`[washVolume] FLAP 报价失败:`, e);
         }
     }
     else if (poolType === 'V2' || poolType === 'V3') {
         // ✅ V2/V3 外盘模式：通过报价获取预估代币数量，确保买卖对等
+        console.log(`[washVolume] ${poolType} 总金额报价: ${wallets.length} 个钱包, 每个 ${buyAmountWei} wei, 总计 ${totalBuyWei} wei`);
         try {
             const { quoteV2, quoteV3 } = await import('../../../utils/quote-helpers.js');
             let totalTokenAmount = 0n;
             if (poolType === 'V3') {
                 const result = await quoteV3(provider, WOKB_ADDRESS, tokenAddress, totalBuyWei, 'XLAYER', fee);
                 totalTokenAmount = result.amountOut;
+                console.log(`[washVolume] V3 报价成功: ${totalBuyWei} wei OKB -> ${totalTokenAmount} wei 代币 (fee: ${fee})`);
             }
             else {
                 const result = await quoteV2(provider, WOKB_ADDRESS, tokenAddress, totalBuyWei, 'XLAYER');
                 totalTokenAmount = result.amountOut;
+                console.log(`[washVolume] V2 报价成功: ${totalBuyWei} wei OKB -> ${totalTokenAmount} wei 代币`);
             }
             // 均分到每个钱包
             if (totalBuyWei > 0n && totalTokenAmount > 0n) {
@@ -129,17 +187,22 @@ export async function washVolume(params) {
                     allocated += sharePerWallet;
                     return sharePerWallet;
                 });
+                console.log(`[washVolume] ${poolType} 代币分配:`, estimatedTokenAmounts.map(a => a.toString()));
             }
         }
-        catch {
-            // V2/V3 quote failed
+        catch (e) {
+            console.warn(`[washVolume] ${poolType} 报价失败，将使用 sellPercent 模式:`, e);
         }
     }
-    const [nonces, feeData] = await Promise.all([batchGetNonces(allAddresses, provider), provider.getFeeData()]);
+    const [nonces, feeData] = await Promise.all([
+        batchGetNonces(allAddresses, provider),
+        provider.getFeeData(),
+    ]);
     // ========================================
     // 同步签署授权
     // ========================================
-    const authorizations = signAuthorizationsWithNonces(allWallets, nonces, delegateAddress, mainWalletIndex);
+    const authorizations = signAuthorizationsWithNonces(allWallets, nonces, delegateAddress, mainWalletIndex // mainWallet 是交易发起者
+    );
     // ========================================
     // 构建调用
     // ========================================
@@ -188,13 +251,25 @@ export async function washVolume(params) {
         },
     };
 }
-// ========================================
-// 捆绑刷量 (Bundle Mode)
-// ========================================
 /**
  * 捆绑刷量 - 多钱包批量买入 + 批量卖出
  *
  * 核心逻辑：[利润刮取] + [买入Ops...] + [卖出Ops...]
+ *
+ * 特点：
+ * - 买入和卖出可以使用不同的钱包
+ * - 所有操作在一笔交易中原子执行
+ * - 卖出钱包需要预先持有代币
+ *
+ * @example
+ * const result = await bundleVolume({
+ *   buyerPrivateKeys: ['0x...', '0x...'],
+ *   buyAmounts: ['0.01', '0.02'],
+ *   sellerPrivateKeys: ['0x...'],
+ *   sellPercent: 100,
+ *   tokenAddress: '0x...',
+ *   poolType: 'FLAP',
+ * });
  */
 export async function bundleVolume(params) {
     const { mainPrivateKey, buyerPrivateKeys, buyAmounts, sellerPrivateKeys, sellAmounts, sellPercent = 100, tokenAddress, tokenDecimals = 18, poolType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', // ✅ 用户类型（影响利润率）
@@ -222,10 +297,13 @@ export async function bundleVolume(params) {
         throw new Error('没有有效的买家私钥');
     }
     // ✅ 验证卖家私钥
-    const validSellerPrivateKeys = sellerPrivateKeys.filter((pk) => isValidPrivateKey(pk));
+    const validSellerPrivateKeys = sellerPrivateKeys.filter(pk => isValidPrivateKey(pk));
     if (validSellerPrivateKeys.length === 0) {
         throw new Error('没有有效的卖家私钥');
     }
+    if (validBuyerPrivateKeys.length !== buyerPrivateKeys.length || validSellerPrivateKeys.length !== sellerPrivateKeys.length) {
+        console.warn(`[bundleVolume] 跳过无效私钥: 买家 ${buyerPrivateKeys.length - validBuyerPrivateKeys.length} 个, 卖家 ${sellerPrivateKeys.length - validSellerPrivateKeys.length} 个`);
+    }
     const provider = getCachedProvider(config?.rpcUrl);
     // ✅ 空字符串也使用默认值
     const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
@@ -235,18 +313,18 @@ export async function bundleVolume(params) {
     // ✅ 创建 Payer 钱包（支付 Gas 费）
     const mainWallet = createWallet(mainPrivateKey, provider);
     // 创建钱包（使用验证后的私钥）
-    const buyerWallets = validBuyerPrivateKeys.map((pk) => createWallet(pk, provider));
-    const sellerWallets = validSellerPrivateKeys.map((pk) => createWallet(pk, provider));
+    const buyerWallets = validBuyerPrivateKeys.map(pk => createWallet(pk, provider));
+    const sellerWallets = validSellerPrivateKeys.map(pk => createWallet(pk, provider));
     // 合并所有钱包（去重，包括 mainWallet）
     const allWalletsMap = new Map();
     allWalletsMap.set(mainWallet.address.toLowerCase(), mainWallet);
-    buyerWallets.forEach((w) => allWalletsMap.set(w.address.toLowerCase(), w));
-    sellerWallets.forEach((w) => allWalletsMap.set(w.address.toLowerCase(), w));
+    buyerWallets.forEach(w => allWalletsMap.set(w.address.toLowerCase(), w));
+    sellerWallets.forEach(w => allWalletsMap.set(w.address.toLowerCase(), w));
     const allWallets = Array.from(allWalletsMap.values());
     // 找出 mainWallet 在 allWallets 中的索引
-    const mainWalletIndex = allWallets.findIndex((w) => w.address.toLowerCase() === mainWallet.address.toLowerCase());
+    const mainWalletIndex = allWallets.findIndex(w => w.address.toLowerCase() === mainWallet.address.toLowerCase());
     // 计算买入金额（使用验证后的金额数组）
-    const buyAmountsWei = validBuyAmounts.map((amt) => ethers.parseEther(truncateDecimals(amt)));
+    const buyAmountsWei = validBuyAmounts.map(amt => ethers.parseEther(truncateDecimals(amt)));
     const totalBuyAmount = buyAmountsWei.reduce((sum, amt) => sum + amt, 0n);
     // ✅ 计算利润（捆绑刷量：买家数 + 卖家数 = 总交易数）
     const totalTxCount = buyerWallets.length + sellerWallets.length;
@@ -255,13 +333,16 @@ export async function bundleVolume(params) {
     // ========================================
     // 并行获取数据
     // ========================================
-    const allAddresses = allWallets.map((w) => w.address);
+    const allAddresses = allWallets.map(w => w.address);
     // 获取卖出钱包的代币余额（如果需要）
     const needBalanceQuery = !sellAmounts || sellAmounts.length !== sellerWallets.length;
-    const parallelPromises = [batchGetNonces(allAddresses, provider), provider.getFeeData()];
+    const parallelPromises = [
+        batchGetNonces(allAddresses, provider),
+        provider.getFeeData(),
+    ];
     if (needBalanceQuery && sellerWallets.length > 0) {
         const tokenContract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
-        parallelPromises.push(Promise.all(sellerWallets.map((w) => tokenContract.balanceOf(w.address))));
+        parallelPromises.push(Promise.all(sellerWallets.map(w => tokenContract.balanceOf(w.address))));
     }
     const results = await Promise.all(parallelPromises);
     const nonces = results[0];
@@ -270,9 +351,12 @@ export async function bundleVolume(params) {
     let sellAmountsWei;
     if (sellAmounts && sellAmounts.length === sellerWallets.length) {
         // ✅ 如果有指定卖出金额，直接使用
-        sellAmountsWei = sellAmounts.map((amt) => ethers.parseUnits(truncateDecimals(amt, tokenDecimals), tokenDecimals));
+        sellAmountsWei = sellAmounts.map(amt => ethers.parseUnits(truncateDecimals(amt, tokenDecimals), tokenDecimals));
     }
     else if (needBalanceQuery && results[2]) {
+        // ✅ 没有指定卖出金额，需要根据买入金额预估应卖出的代币数量
+        const balances = results[2].map(b => typeof b === 'bigint' ? b : BigInt(b.toString()));
+        const totalSellerBalance = balances.reduce((sum, b) => sum + b, 0n);
         // ✅ 根据 poolType 预估买入能获得的代币数量
         let estimatedTokenAmount = 0n;
         try {
@@ -281,28 +365,36 @@ export async function bundleVolume(params) {
                 const portalContract = new ethers.Contract(FLAP_PORTAL_ADDRESS, FLAP_PORTAL_ABI, provider);
                 try {
                     estimatedTokenAmount = await portalContract.previewBuy(tokenAddress, totalBuyAmount);
+                    console.log(`[bundleVolume] FLAP previewBuy: ${totalBuyAmount} wei OKB -> ${estimatedTokenAmount} wei 代币`);
                 }
-                catch {
+                catch (previewErr) {
+                    console.warn(`[bundleVolume] previewBuy 失败，尝试 quoteBuy:`, previewErr);
                     try {
                         estimatedTokenAmount = await portalContract.quoteBuy(tokenAddress, totalBuyAmount);
+                        console.log(`[bundleVolume] FLAP quoteBuy: ${totalBuyAmount} wei OKB -> ${estimatedTokenAmount} wei 代币`);
                     }
-                    catch {
+                    catch (quoteBuyErr) {
+                        console.warn(`[bundleVolume] quoteBuy 失败，尝试 quoteExactInput:`, quoteBuyErr);
                         try {
                             estimatedTokenAmount = await portalContract.quoteExactInput.staticCall({
                                 inputToken: ethers.ZeroAddress,
                                 outputToken: tokenAddress,
                                 inputAmount: totalBuyAmount,
                             });
+                            console.log(`[bundleVolume] FLAP quoteExactInput: ${totalBuyAmount} wei OKB -> ${estimatedTokenAmount} wei 代币`);
                         }
-                        catch {
+                        catch (quoteErr) {
+                            console.warn(`[bundleVolume] quoteExactInput 也失败，尝试 V2 路由作为终极兜底:`, quoteErr);
                             try {
+                                // 终极兜底：当内盘接口全部失效时，尝试使用 V2 代码进行报价
                                 const v2Router = new ethers.Contract(POTATOSWAP_V2_ROUTER, V2_ROUTER_ABI, provider);
                                 const path = [WOKB_ADDRESS, tokenAddress];
                                 const amounts = await v2Router.getAmountsOut(totalBuyAmount, path);
                                 estimatedTokenAmount = amounts[amounts.length - 1];
+                                console.log(`[bundleVolume] FLAP 终极回退 V2 quote: ${totalBuyAmount} wei OKB -> ${estimatedTokenAmount} wei 代币`);
                             }
-                            catch {
-                                // all quote paths failed
+                            catch (v2Err) {
+                                console.warn(`[bundleVolume] 终极回退 V2 quote 也失败:`, v2Err);
                             }
                         }
                     }
@@ -320,7 +412,7 @@ export async function bundleVolume(params) {
                     else {
                         // V3: 使用 V3 Quoter
                         const v3Quoter = new ethers.Contract('0x27d52F6D9Ed2eBb3E6a4c0Af6b1f5dc85A4d5b2C', [
-                            'function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96)) external returns (uint256 amountOut)',
+                            'function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96)) external returns (uint256 amountOut)'
                         ], provider);
                         estimatedTokenAmount = await v3Quoter.quoteExactInputSingle.staticCall({
                             tokenIn: WOKB_ADDRESS,
@@ -330,14 +422,15 @@ export async function bundleVolume(params) {
                             sqrtPriceLimitX96: 0n,
                         });
                     }
+                    console.log(`[bundleVolume] ${poolType} quote: ${totalBuyAmount} wei OKB -> ${estimatedTokenAmount} wei 代币`);
                 }
-                catch {
-                    // pool quote failed
+                catch (quoteErr) {
+                    console.warn(`[bundleVolume] ${poolType} 报价失败:`, quoteErr);
                 }
             }
         }
-        catch {
-            // quote estimate failed
+        catch (e) {
+            console.warn(`[bundleVolume] 报价预估失败:`, e);
         }
         // ✅ 修正卖出数量计算逻辑：卖出数额仅基于本次交易买入的代币预估值，忽略原有余额
         const percentBigInt = BigInt(Math.min(100, Math.max(0, sellPercent)));
@@ -367,9 +460,11 @@ export async function bundleVolume(params) {
                     }
                 });
             }
+            console.log(`[bundleVolume] 每个卖家随机分配的卖出量:`, walletSellAmounts.map(a => a.toString()));
         }
         // ✅ 修复：不再重复应用 sellPercent，因为 totalToSell 已经按 sellPercent 计算过了
         sellAmountsWei = walletSellAmounts;
+        console.log(`[bundleVolume] 最终卖出数量 (sellPercent=${sellPercent}%):`, sellAmountsWei.map(a => a.toString()));
     }
     else {
         // ✅ 即使没有余额查询结果，也初始化数组
@@ -430,10 +525,11 @@ export async function bundleVolume(params) {
         },
     };
 }
-// ========================================
-// 单轮刷量（买入+卖出分开签名）
-// ========================================
-/** 生成单轮刷量签名（买入 + 卖出分开，两笔独立交易） */
+/**
+ * 生成单轮刷量签名（买入 + 卖出分开）
+ *
+ * 注意：买入和卖出是两笔独立交易
+ */
 export async function singleRoundVolume(params) {
     const { privateKeys, tokenAddress, tokenDecimals = 18, buyAmountPerWallet, sellPercent = 100, tradeType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, config, } = params;
     const mainPrivateKey = privateKeys[0];
@@ -471,10 +567,12 @@ export async function singleRoundVolume(params) {
         },
     };
 }
-// ========================================
-// 多轮刷量
-// ========================================
-/** 生成多轮刷量签名（由于 nonce 限制，仅预生成第一轮） */
+/**
+ * 生成多轮刷量签名
+ *
+ * 注意：由于 nonce 问题，只能预生成第一轮
+ * 后续轮次需要在前一轮交易确认后才能生成
+ */
 export async function makeVolume(params) {
     const { privateKeys, tokenAddress, tokenDecimals = 18, buyAmountPerRound, rounds, tradeType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, onProgress, config, } = params;
     const buyAmountPerWallet = (parseFloat(buyAmountPerRound) / privateKeys.length).toString();
@@ -505,10 +603,9 @@ export async function makeVolume(params) {
         },
     };
 }
-// ========================================
-// 换手刷量
-// ========================================
-/** 生成换手刷量签名 */
+/**
+ * 生成换手刷量签名
+ */
 export async function makeVolumeWithSwap(params) {
     const { sellerPrivateKey, buyerPrivateKey, tokenAddress, tokenDecimals = 18, sellAmount, hopCount = 2, tradeType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, config, } = params;
     const result = await bundleSwap({
@@ -551,15 +648,13 @@ function buildBuyCall(wallet, amount, tokenAddress, poolType, routerAddress, fee
         case 'FLAP': {
             // ✅ 修复：使用 swapExactInput 代替 buy 函数，明确指定 inputAmount
             // buy(token) 依赖 msg.value，当 value=0n 时会失败
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [
-                {
+            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
                     inputToken: ethers.ZeroAddress, // 0x0 = OKB (原生代币)
                     outputToken: tokenAddress,
                     inputAmount: amount,
                     minOutputAmount: 0n,
                     permitData: '0x',
-                },
-            ]);
+                }]);
             const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: amount, data: portalCallData }];
             return {
                 target: wallet.address,
@@ -585,11 +680,7 @@ function buildBuyCall(wallet, amount, tokenAddress, poolType, routerAddress, fee
                 allowFailure: false,
                 value: 0n,
                 callData: delegateInterface.encodeFunctionData('executeBuy', [
-                    routerAddress,
-                    WOKB_ADDRESS,
-                    tokenAddress,
-                    fee,
-                    amount,
+                    routerAddress, WOKB_ADDRESS, tokenAddress, fee, amount
                 ]),
             };
         }
@@ -604,15 +695,13 @@ tokenAddress, sellPercent, tokenDecimals, poolType, routerAddress, fee, delegate
             // ✅ 使用 swapExactInput 卖出（与 AA 模式保持一致）
             // 注意：inputAmount=0 会失败，FLAP 需要先获取余额再调用
             // 这里需要传入实际的代币余额，外层调用者应该提前查询
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [
-                {
+            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
                     inputToken: tokenAddress,
                     outputToken: ethers.ZeroAddress, // 0x0 = OKB
                     inputAmount: 1n, // 占位符，如果调用 buildSellCall 时不指定 amount，通常意味逻辑上有问题
                     minOutputAmount: 0n,
                     permitData: '0x',
-                },
-            ]);
+                }]);
             const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: 0n, data: portalCallData }];
             return {
                 target: wallet.address,
@@ -628,11 +717,7 @@ tokenAddress, sellPercent, tokenDecimals, poolType, routerAddress, fee, delegate
                 target: wallet.address,
                 allowFailure: false,
                 value: 0n,
-                callData: delegateInterface.encodeFunctionData('executeSellV2', [
-                    routerAddress,
-                    path,
-                    sellPercent === 100 ? 0 : amount,
-                ]),
+                callData: delegateInterface.encodeFunctionData('executeSellV2', [routerAddress, path, sellPercent === 100 ? 0 : amount]),
             };
         }
         case 'V3': {
@@ -642,11 +727,7 @@ tokenAddress, sellPercent, tokenDecimals, poolType, routerAddress, fee, delegate
                 allowFailure: false,
                 value: 0n,
                 callData: delegateInterface.encodeFunctionData('executeSell', [
-                    routerAddress,
-                    tokenAddress,
-                    WOKB_ADDRESS,
-                    fee,
-                    sellPercent === 100 ? 0 : amount,
+                    routerAddress, tokenAddress, WOKB_ADDRESS, fee, sellPercent === 100 ? 0 : amount
                 ]),
             };
         }
@@ -656,15 +737,13 @@ function buildSellCallWithAmount(wallet, amount, tokenAddress, poolType, routerA
     switch (poolType) {
         case 'FLAP': {
             // ✅ 使用 swapExactInput 卖出（与 AA 模式保持一致）
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [
-                {
+            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
                     inputToken: tokenAddress,
                     outputToken: ethers.ZeroAddress, // 0x0 = OKB
                     inputAmount: amount,
                     minOutputAmount: 0n,
                     permitData: '0x',
-                },
-            ]);
+                }]);
             const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: 0n, data: portalCallData }];
             return {
                 target: wallet.address,
@@ -688,11 +767,7 @@ function buildSellCallWithAmount(wallet, amount, tokenAddress, poolType, routerA
                 allowFailure: false,
                 value: 0n,
                 callData: delegateInterface.encodeFunctionData('executeSell', [
-                    routerAddress,
-                    tokenAddress,
-                    WOKB_ADDRESS,
-                    fee,
-                    amount,
+                    routerAddress, tokenAddress, WOKB_ADDRESS, fee, amount
                 ]),
             };
         }

package/dist/chains/xlayer/eoa/constants.js

@@ -6,7 +6,7 @@
  *
  * ⚠️ 通用常量请使用 shared/constants，此文件仅包含 XLayer 特有的配置
  */
-import { CHAINS, ADDRESSES, GAS_LIMITS, GAS_CONFIG, ZERO_ADDRESS as SHARED_ZERO_ADDRESS, } from '../../../shared/constants/index.js';
+import { CHAINS, ADDRESSES, GAS_LIMITS, GAS_CONFIG, ZERO_ADDRESS as SHARED_ZERO_ADDRESS } from '../../../shared/constants/index.js';
 // ============================================================================
 // 从 shared/constants 重新导出（向后兼容）
 // ============================================================================

package/dist/chains/xlayer/eoa/dex-helpers.js

@@ -1,7 +1,7 @@
 /**
  * XLayer AA DEX 工具函数
  */
-import { getProfitRecipient, getProfitRateBps } from '../../../shared/constants/index.js';
+import { PROFIT_CONFIG } from '../../../utils/constants.js';
 export function getDexDeadline(minutes = 20) {
     return Math.floor(Date.now() / 1000) + minutes * 60;
 }
@@ -14,9 +14,9 @@ export function calculateProfitWei(amountWei, profitBps) {
 }
 export function resolveProfitSettings(config) {
     const extractProfit = config?.extractProfit !== false;
-    const profitBpsRaw = config?.profitBps ?? getProfitRateBps('bundleSwap');
-    const profitBps = Math.max(0, Math.min(10_000, Number(profitBpsRaw)));
-    const profitRecipient = config?.profitRecipient ?? getProfitRecipient();
+    const profitBpsRaw = config?.profitBps ?? PROFIT_CONFIG.RATE_BPS_SWAP;
+    const profitBps = Math.max(0, Math.min(10000, Number(profitBpsRaw)));
+    const profitRecipient = config?.profitRecipient ?? PROFIT_CONFIG.RECIPIENT;
     return { extractProfit, profitBps, profitRecipient };
 }
 function shuffle(arr) {
@@ -36,7 +36,7 @@ export function splitAmount(totalAmount, count) {
         return new Array(count).fill(0n);
     const weights = [];
     for (let i = 0; i < count; i++) {
-        const w = BigInt(500_000 + Math.floor(Math.random() * 1_000_000));
+        const w = BigInt(500000 + Math.floor(Math.random() * 1000000));
         weights.push(w);
     }
     const totalWeight = weights.reduce((a, b) => a + b, 0n);

package/dist/chains/xlayer/eoa/eoa-bundle-swap.d.ts

@@ -1,4 +1,98 @@
-import { RouteParams, XLayerCrossSwapParams, XLayerCrossSwapResult, XLayerEoaSwapConfig, XLayerQuickBatchSwapParams, XLayerQuickBatchSwapResult } from './eoa-bundle-swap-helpers.js';
+/**
+ * XLayer EOA 模式批量换手
+ *
+ * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
+ * - 使用 PotatoSwap V3 Quoter
+ * - 使用 WOKB 作为 Wrapped Native Token
+ * - 支持多跳转账和利润刮取
+ */
+import { type GeneratedWallet } from '../../../utils/wallet.js';
+export type UserType = 'v0' | 'v1';
+export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
+export interface V2RouteParams {
+    routeType: 'v2';
+    v2Path: string[];
+}
+export interface V3SingleRouteParams {
+    routeType: 'v3-single';
+    v3TokenIn: string;
+    v3TokenOut: string;
+    v3Fee: number;
+    v2Path?: string[];
+}
+export interface V3MultiRouteParams {
+    routeType: 'v3-multi';
+    v3LpAddresses: string[];
+    v3ExactTokenIn: string;
+    v2Path?: string[];
+}
+export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
+export interface XLayerEoaSwapConfig {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    reserveGasBNB?: number;
+    userType?: UserType;
+    bribeAmount?: number;
+}
+export interface XLayerQuickBatchSwapParams {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: XLayerEoaSwapConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    disperseHopCount?: number;
+    startNonces?: number[];
+}
+export interface XLayerQuickBatchSwapResult {
+    signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedOutput: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        useNativeToken: boolean;
+        disperseHopCount?: number;
+    };
+}
+export interface XLayerCrossSwapParams {
+    sellerPrivateKeys: string[];
+    sellAmounts: string[];
+    buyerPrivateKeys: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    config: XLayerEoaSwapConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    buyersPerSell?: number;
+    disperseHopCount?: number;
+    /** ✅ 预获取的 nonce（地址 -> nonce），避免 nonce 不同步 */
+    startNonces?: Map<string, number>;
+}
+export interface XLayerCrossSwapResult {
+    signedTransactions: string[];
+    rounds: Array<{
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        bundleHash?: string;
+    }>;
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+}
 export declare function xlayerQuickBatchSwapMerkle(params: XLayerQuickBatchSwapParams): Promise<XLayerQuickBatchSwapResult>;
 export declare function xlayerCrossSwapMerkle(params: XLayerCrossSwapParams): Promise<XLayerCrossSwapResult>;
 /**