four-flap-meme-sdk 1.4.21 → 1.4.24

package/dist/contracts/tm-bundle-merkle/swap.d.ts

@@ -31,6 +31,7 @@ export interface FourBundleSwapSignParams {
     buyerPrivateKey: string;
     tokenAddress: string;
     config: FourSwapSignConfig;
+    startNonces?: number[];
 }
 export interface FourBundleSwapParams {
     sellerPrivateKey: string;
@@ -69,6 +70,7 @@ export interface FourBatchSwapSignParams {
     buyerRatios?: number[];
     tokenAddress: string;
     config: FourSwapSignConfig;
+    startNonces?: number[];
 }
 /**
  * Four 批量换手结果
@@ -103,6 +105,7 @@ export interface FourQuickBatchSwapSignParams {
     buyerAmounts?: string[];
     tokenAddress: string;
     config: FourSwapSignConfig;
+    startNonces?: number[];
 }
 /**
  * Four 快捷批量换手结果

package/dist/contracts/tm-bundle-merkle/swap.js

@@ -15,7 +15,8 @@ const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
  * Four内盘捆绑换手
  */
 export async function fourBundleSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     const chainIdNum = config.chainId ?? 56;
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
         chainId: chainIdNum,
@@ -83,21 +84,21 @@ export async function fourBundleSwapMerkle(params) {
     if (extractProfit)
         sellerNonceCount++; // 利润交易
     // ✅ 优化：使用批量 nonce 获取（JSON-RPC 批量请求）
-    // 先一次性获取 seller 和 buyer 的初始 nonce，然后分配连续 nonce
+    // 如果前端传入了 startNonces，直接使用；否则从链上获取
     const [sellUnsigned, buyUnsigned, noncesResult] = await Promise.all([
         tmSeller.sellToken.populateTransaction(0n, tokenAddress, sellAmountWei, 0n),
         tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyerFunds, 0n, { value: buyerFunds }),
         (async () => {
-            // ✅ 一次性获取两个地址的初始 nonce（单次网络往返）
+            // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+            if (startNonces && startNonces.length >= 2) {
+                const sellerNonces = Array.from({ length: sellerNonceCount }, (_, i) => startNonces[0] + i);
+                const buyerNonce = startNonces[1];
+                return { sellerNonces, buyerNonce };
+            }
+            // 否则从链上获取
             const initialNonces = await nonceManager.getNextNoncesForWallets([seller, buyer]);
-            // seller 需要 sellerNonceCount 个连续 nonce
             const sellerNonces = Array.from({ length: sellerNonceCount }, (_, i) => initialNonces[0] + i);
-            // buyer 只需要 1 个 nonce
             const buyerNonce = initialNonces[1];
-            // 更新 NonceManager 缓存（seller 需要额外的 nonce）
-            for (let i = 1; i < sellerNonceCount; i++) {
-                await nonceManager.getNextNonce(seller); // 递增缓存
-            }
             return { sellerNonces, buyerNonce };
         })()
     ]);
@@ -213,7 +214,8 @@ export async function fourBundleSwapMerkle(params) {
  * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
  */
 export async function fourBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
     if (buyerPrivateKeys.length === 0) {
@@ -309,9 +311,12 @@ export async function fourBatchSwapMerkle(params) {
     if (needApproval)
         sellerNonceCount++; // 授权交易
     sellerNonceCount++; // 利润交易
-    // 并行获取所有初始 nonce
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    // 否则从链上获取
     const allWallets = [seller, ...buyers];
-    const initialNonces = await nonceManager.getNextNoncesForWallets(allWallets);
+    const initialNonces = startNonces && startNonces.length >= allWallets.length
+        ? startNonces
+        : await nonceManager.getNextNoncesForWallets(allWallets);
     // 分配 seller nonces
     const sellerNonces = Array.from({ length: sellerNonceCount }, (_, i) => initialNonces[0] + i);
     let idx = 0;
@@ -438,7 +443,8 @@ export async function fourBatchSwapMerkle(params) {
  * 限制：最多 23 个买方（2N + 3 ≤ 50）
  */
 export async function fourQuickBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 校验买方数量
     // 贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
     const MAX_BUYERS = 23;
@@ -525,7 +531,10 @@ export async function fourQuickBatchSwapMerkle(params) {
         throw new Error(`主钱包 BNB 余额不足: 需要约 ${ethers.formatEther(sellerRequired)} BNB (贿赂: ${ethers.formatEther(bribeAmount)}, Gas: ${ethers.formatEther(sellerGasCost)}), 实际 ${ethers.formatEther(sellerBalance)} BNB`);
     }
     // ==================== 规划 Nonce ====================
-    let sellerNonce = await nonceManager.getNextNonce(seller);
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    let sellerNonce = startNonces && startNonces.length > 0
+        ? startNonces[0]
+        : await nonceManager.getNextNonce(seller);
     // ==================== 1. 贿赂交易 ====================
     let bribeTx = null;
     if (bribeAmount > 0n) {
@@ -573,7 +582,10 @@ export async function fourQuickBatchSwapMerkle(params) {
     }));
     console.log(`[fourQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
     // ==================== 4. 买入交易 ====================
-    const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+    // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
+    const buyerNonces = startNonces && startNonces.length > 1
+        ? startNonces.slice(1)
+        : await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         const tmBuyer = new Contract(TM_ADDRESS, TM_ABI, buyer);

package/dist/contracts/tm-bundle-merkle/types.d.ts

@@ -236,6 +236,10 @@ export type DisperseMerkleParams = {
     config: FourBundleMerkleConfig;
 };
 /** ✅ 分发参数（仅签名版本 - 精简） */
+/** 代币池子类型 */
+export type TokenPoolType = 'flap' | 'four' | 'v2' | 'v3';
+/** 报价代币类型（池子的计价代币） */
+export type QuoteTokenType = 'native' | 'usdt' | 'usdc';
 export type DisperseSignParams = {
     fromPrivateKey: string;
     recipients: string[];
@@ -254,6 +258,10 @@ export type DisperseSignParams = {
     config: FourSignConfig;
     /** ✅ 新增：起始 nonce（用于并行调用时避免 nonce 冲突） */
     startNonce?: number;
+    /** ✅ 新增：代币池子类型（用于利润报价），默认 'v2' */
+    tokenPoolType?: TokenPoolType;
+    /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
+    quoteToken?: QuoteTokenType;
 };
 /**
  * ✅ 分发结果（简化版）
@@ -305,6 +313,10 @@ export type SweepSignParams = {
     config: FourSignConfig;
     /** ✅ 新增：起始 nonce（用于并行调用时避免 nonce 冲突，仅对第一个源钱包生效） */
     startNonce?: number;
+    /** ✅ 新增：代币池子类型（用于利润报价），默认 'v2' */
+    tokenPoolType?: TokenPoolType;
+    /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
+    quoteToken?: QuoteTokenType;
 };
 /**
  * ✅ 归集结果（简化版）

package/dist/contracts/tm-bundle-merkle/utils.js

@@ -1,5 +1,4 @@
-import { ethers, Wallet, Contract } from 'ethers';
-// import { MerkleClient } from '../../clients/merkle.js';
+import { ethers, Wallet } from 'ethers';
 import { getOptimizedGasPrice, NonceManager } from '../../utils/bundle-helpers.js';
 import { PROFIT_CONFIG } from '../../utils/constants.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient } from './config.js';
@@ -15,46 +14,182 @@ function calculateProfit(amount) {
     return { profit, remaining };
 }
 // ==================== ERC20 → 原生代币报价 ====================
-// BSC 链常量
-const BSC_PANCAKE_V2_ROUTER = '0x10ED43C718714eb63d5aA57B78B54704E256024E';
-const BSC_WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
-// ✅ Monad 链常量
-const MONAD_PANCAKE_V2_ROUTER = '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9';
-const MONAD_WMON = '0x3bd359c1119da7da1d913d1c4d2b7c461115433a';
-const ROUTER_ABI = [
-    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)'
-];
+import { quote, QUOTE_CONFIG } from '../../utils/quote-helpers.js';
+import { Helper3 } from '../helper3.js';
+import { FlapPortal } from '../../flap/portal.js';
+/** 最低利润（Wei）：无法获取报价时使用，0.0001 BNB */
+const MIN_PROFIT_WEI = 100000000000000n; // 0.0001 BNB = 10^14 wei
+/** 链 ID → 链名称 映射 */
+const CHAIN_ID_TO_NAME = {
+    56: 'BSC',
+    143: 'MONAD',
+    196: 'XLAYER',
+};
+/** 各链的稳定币地址 */
+const STABLE_COINS = {
+    BSC: {
+        usdt: '0x55d398326f99059fF775485246999027B3197955',
+        usdc: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+    },
+    MONAD: {
+    // TODO: 添加 Monad 链的稳定币地址
+    },
+    XLAYER: {
+        usdt: '0x1E4a5963aBFD975d8c9021ce480b42188849D41d',
+    },
+};
+/**
+ * 获取 FOUR 内盘代币 → BNB 的报价
+ */
+async function getFourInnerQuote(rpcUrl, tokenAddress, tokenAmount) {
+    try {
+        const helper = Helper3.connectByChain('BSC', rpcUrl);
+        const result = await helper.trySell(tokenAddress, tokenAmount);
+        // result = { tokenManager, quote, funds, fee }
+        // funds 是卖出代币能获得的 BNB 数量
+        const funds = result.funds;
+        console.log(`[getFourInnerQuote] FOUR 内盘报价成功: ${funds} wei`);
+        return funds;
+    }
+    catch (error) {
+        console.warn(`[getFourInnerQuote] FOUR 内盘报价失败:`, error);
+        return 0n;
+    }
+}
+/** 零地址（原生代币） */
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/**
+ * 获取 FLAP 内盘代币 → 原生代币的报价
+ * ✅ 与 portal-bundle-merkle/core.ts 使用相同的 quoteExactInput 方法
+ */
+async function getFlapInnerQuote(rpcUrl, chainId, tokenAddress, tokenAmount) {
+    try {
+        // 根据链 ID 确定链名称
+        const chainName = chainId === 56 ? 'BSC' : chainId === 143 ? 'MONAD' : chainId === 196 ? 'XLAYER' : null;
+        if (!chainName) {
+            console.warn(`[getFlapInnerQuote] 不支持的链 ID: ${chainId}`);
+            return 0n;
+        }
+        const portal = new FlapPortal({ chain: chainName, rpcUrl });
+        // ✅ 使用 quoteExactInput 与 core.ts 保持一致
+        const funds = await portal.quoteExactInput({
+            inputToken: tokenAddress,
+            outputToken: ZERO_ADDRESS, // 输出原生代币
+            inputAmount: tokenAmount
+        });
+        console.log(`[getFlapInnerQuote] FLAP 内盘报价成功: ${funds} wei`);
+        return funds;
+    }
+    catch (error) {
+        console.warn(`[getFlapInnerQuote] FLAP 内盘报价失败:`, error);
+        return 0n;
+    }
+}
 /**
  * 获取 ERC20 代币 → 原生代币的报价
+ *
  * @param provider - Provider 实例
  * @param tokenAddress - ERC20 代币地址
  * @param tokenAmount - 代币数量（wei）
  * @param chainId - 链 ID（56=BSC, 143=Monad）
- * @returns 等值的原生代币数量（wei），失败返回 0n
+ * @param poolType - 池子类型：'flap'/'four' 内盘，'v2'/'v3' 外盘
+ * @param quoteToken - 报价代币：'native'（BNB/MON），'usdt'，'usdc'
+ * @param rpcUrl - RPC URL（内盘报价需要）
+ * @returns 等值的原生代币数量（wei），失败返回 MIN_PROFIT_WEI
  */
-async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId) {
+async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId, poolType = 'v2', quoteToken = 'native', rpcUrl) {
     if (tokenAmount <= 0n)
-        return 0n;
+        return MIN_PROFIT_WEI;
+    // ✅ FOUR 内盘：通过 Helper3.trySell 获取真实报价
+    if (poolType === 'four') {
+        const url = rpcUrl || provider._getConnection?.()?.url || '';
+        if (!url) {
+            console.warn(`[getTokenToNativeQuote] FOUR 内盘需要 rpcUrl，使用最低利润`);
+            return MIN_PROFIT_WEI;
+        }
+        const funds = await getFourInnerQuote(url, tokenAddress, tokenAmount);
+        return funds > 0n ? funds : MIN_PROFIT_WEI;
+    }
+    // ✅ FLAP 内盘：通过 FlapPortal.previewSell 获取真实报价
+    if (poolType === 'flap') {
+        const url = rpcUrl || provider._getConnection?.()?.url || '';
+        if (!url) {
+            console.warn(`[getTokenToNativeQuote] FLAP 内盘需要 rpcUrl，使用最低利润`);
+            return MIN_PROFIT_WEI;
+        }
+        const funds = await getFlapInnerQuote(url, chainId, tokenAddress, tokenAmount);
+        return funds > 0n ? funds : MIN_PROFIT_WEI;
+    }
+    const chainName = CHAIN_ID_TO_NAME[chainId];
+    if (!chainName) {
+        console.warn(`[getTokenToNativeQuote] 不支持的链 ID: ${chainId}，使用最低利润`);
+        return MIN_PROFIT_WEI;
+    }
+    const chainConfig = QUOTE_CONFIG[chainName];
+    if (!chainConfig) {
+        console.warn(`[getTokenToNativeQuote] 不支持的链: ${chainName}，使用最低利润`);
+        return MIN_PROFIT_WEI;
+    }
     try {
-        if (chainId === 56) {
-            // BSC: 使用 PancakeSwap V2 Router
-            const router = new Contract(BSC_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, BSC_WBNB]);
-            return amounts[1];
+        const version = poolType === 'v3' ? 'v3' : 'v2';
+        let nativeAmount = 0n;
+        if (quoteToken === 'native') {
+            // ✅ 直接路径：TOKEN → WBNB
+            console.log(`[getTokenToNativeQuote] 使用 ${version} 直接路径报价 (TOKEN → WBNB)`);
+            const result = await quote({
+                provider,
+                tokenIn: tokenAddress,
+                tokenOut: chainConfig.wrappedNative,
+                amountIn: tokenAmount,
+                chain: chainName,
+                version
+            });
+            nativeAmount = result.amountOut;
         }
-        if (chainId === 143) {
-            // ✅ Monad: 使用 PancakeSwap V2 Router
-            const router = new Contract(MONAD_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, MONAD_WMON]);
-            return amounts[1];
+        else {
+            // ✅ 稳定币路径：TOKEN → USDT/USDC → WBNB（两步报价）
+            const stableCoins = STABLE_COINS[chainName];
+            const stableCoinAddress = stableCoins?.[quoteToken];
+            if (!stableCoinAddress) {
+                console.warn(`[getTokenToNativeQuote] 链 ${chainName} 不支持 ${quoteToken}，使用最低利润`);
+                return MIN_PROFIT_WEI;
+            }
+            console.log(`[getTokenToNativeQuote] 使用 ${version} 稳定币路径报价 (TOKEN → ${quoteToken.toUpperCase()} → WBNB)`);
+            // 第一步：TOKEN → USDT/USDC
+            const step1 = await quote({
+                provider,
+                tokenIn: tokenAddress,
+                tokenOut: stableCoinAddress,
+                amountIn: tokenAmount,
+                chain: chainName,
+                version
+            });
+            if (step1.amountOut <= 0n) {
+                console.warn(`[getTokenToNativeQuote] TOKEN → ${quoteToken.toUpperCase()} 报价失败`);
+                return MIN_PROFIT_WEI;
+            }
+            // 第二步：USDT/USDC → WBNB
+            const step2 = await quote({
+                provider,
+                tokenIn: stableCoinAddress,
+                tokenOut: chainConfig.wrappedNative,
+                amountIn: step1.amountOut,
+                chain: chainName,
+                version
+            });
+            nativeAmount = step2.amountOut;
+        }
+        if (nativeAmount > 0n) {
+            console.log(`[getTokenToNativeQuote] 报价成功: ${nativeAmount} wei`);
+            return nativeAmount;
         }
-        // 其他链暂不支持报价，返回 0
-        return 0n;
     }
-    catch {
-        // 报价失败返回 0（可能是流动性不足或路径不存在）
-        return 0n;
+    catch (error) {
+        console.warn(`[getTokenToNativeQuote] 报价失败:`, error);
     }
+    // ✅ 报价失败，返回最低利润（0.0001 BNB）
+    console.log(`[getTokenToNativeQuote] 无法获取报价，使用最低利润: ${MIN_PROFIT_WEI}`);
+    return MIN_PROFIT_WEI;
 }
 /**
  * 分发（仅签名版本 - 不依赖 Merkle）
@@ -62,7 +197,7 @@ async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainI
  * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
  */
 export async function disperseWithBundleMerkle(params) {
-    const { fromPrivateKey, recipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce } = params;
+    const { fromPrivateKey, recipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native' } = params;
     // 快速返回空结果
     if (!recipients || recipients.length === 0) {
         return {
@@ -184,7 +319,7 @@ export async function disperseWithBundleMerkle(params) {
             // ✅ 获取 ERC20 利润等值的原生代币（BNB）报价
             let nativeProfitAmount = 0n;
             if (extractProfit && totalTokenProfit > 0n) {
-                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum);
+                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
                 totalProfit = nativeProfitAmount; // 更新为原生代币利润
             }
             // ✅ 并行签名所有交易
@@ -368,7 +503,7 @@ export async function disperseWithBundleMerkle(params) {
         }
         // ✅ ERC20 多跳：获取代币利润等值的原生代币报价
         if (!isNative && extractProfit && totalTokenProfit > 0n) {
-            const nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum);
+            const nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
             totalProfit = nativeProfitAmount; // 更新为原生代币利润
         }
         // 利润转账（转等值原生代币）
@@ -411,7 +546,7 @@ export async function disperseWithBundleMerkle(params) {
  * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
  */
 export async function sweepWithBundleMerkle(params) {
-    const { sourcePrivateKeys, target, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config, startNonce } = params;
+    const { sourcePrivateKeys, target, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native' } = params;
     // 快速返回空结果
     if (!sourcePrivateKeys || sourcePrivateKeys.length === 0) {
         return {
@@ -684,7 +819,7 @@ export async function sweepWithBundleMerkle(params) {
             // ✅ ERC20 归集：获取代币利润等值的原生代币（BNB）报价
             let nativeProfitAmount = 0n;
             if (extractProfit && totalProfit > 0n) {
-                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalProfit, chainIdNum);
+                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
             }
             // ✅ 如果需要提取利润，检查支付者是否有足够 BNB 支付利润转账的额外 gas
             if (extractProfit && nativeProfitAmount > 0n && maxSweepIndex >= 0 && config.checkBnbForErc20NoHop) {
@@ -1036,7 +1171,7 @@ export async function sweepWithBundleMerkle(params) {
             // ✅ ERC20 多跳归集：获取代币利润等值的原生代币报价
             let nativeProfitAmount = isNative ? totalProfit : 0n;
             if (!isNative && totalTokenProfit > 0n) {
-                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum);
+                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
                 totalProfit = nativeProfitAmount; // 更新为原生代币利润
             }
             // 由归集金额最大的钱包支付利润（转等值原生代币）

package/dist/flap/portal-bundle-merkle/swap.d.ts

@@ -38,6 +38,7 @@ export interface FlapBundleSwapSignParams {
     config: FlapSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    startNonces?: number[];
 }
 export interface FlapBundleSwapParams {
     chain: FlapChain;
@@ -79,6 +80,7 @@ export interface FlapBatchSwapSignParams {
     config: FlapSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    startNonces?: number[];
 }
 /**
  * Flap 批量换手结果
@@ -116,6 +118,7 @@ export interface FlapQuickBatchSwapSignParams {
     config: FlapSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    startNonces?: number[];
 }
 /**
  * Flap 快捷批量换手结果

package/dist/flap/portal-bundle-merkle/swap.js

@@ -99,7 +99,8 @@ function getNativeTokenName(chain) {
  * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
  */
 export async function flapBundleSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, quoteToken, quoteTokenDecimals } = params;
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, quoteToken, quoteTokenDecimals, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     const chainContext = createChainContext(chain, config);
     const seller = new Wallet(sellerPrivateKey, chainContext.provider);
     const buyer = new Wallet(buyerPrivateKey, chainContext.provider);
@@ -179,14 +180,17 @@ export async function flapBundleSwapMerkle(params) {
             permitData: '0x'
         }, useNativeToken ? { value: buyerNeed.maxBuyerValue } : {} // ✅ ERC20 购买时 value=0
         ),
-        planNonces({
-            seller,
-            buyer,
-            approvalExists: !!approvalTx,
-            extractProfit: nativeProfitAmount > 0n,
-            needBribeTx, // ✅ 新增：是否需要贿赂交易
-            nonceManager
-        }),
+        // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+        startNonces && startNonces.length >= 2
+            ? buildNoncePlan(startNonces, !!approvalTx, nativeProfitAmount > 0n, needBribeTx)
+            : planNonces({
+                seller,
+                buyer,
+                approvalExists: !!approvalTx,
+                extractProfit: nativeProfitAmount > 0n,
+                needBribeTx,
+                nonceManager
+            }),
         validateBalances({
             buyerNeed,
             buyerAddress: buyer.address,
@@ -393,6 +397,24 @@ async function validateBalances({ buyerNeed, buyerAddress, portalGasCost, provid
         throw new Error(`卖方余额不足: 需要 ${ethers.formatEther(portalGasCost)} ${chainContext.nativeToken} (Gas)，实际 ${ethers.formatEther(sellerBalance)} ${chainContext.nativeToken}`);
     }
 }
+/**
+ * ✅ 从前端传入的 startNonces 构建 NoncePlan（用于性能优化）
+ * 顺序：[sellerBaseNonce, buyerNonce]
+ */
+function buildNoncePlan(startNonces, approvalExists, extractProfit, needBribeTx) {
+    let sellerNonce = startNonces[0];
+    const buyerNonce = startNonces[1];
+    let bribeNonce;
+    let profitNonce;
+    if (needBribeTx)
+        bribeNonce = sellerNonce++;
+    if (approvalExists)
+        sellerNonce++; // 授权交易占用一个 nonce
+    const sellNonce = sellerNonce++;
+    if (extractProfit)
+        profitNonce = sellerNonce;
+    return { sellerNonce: sellNonce, buyerNonce, bribeNonce, profitNonce };
+}
 /**
  * ✅ 优化：使用批量 nonce 获取（JSON-RPC 批量请求）
  * 交易顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
@@ -470,7 +492,8 @@ function countTruthy(values) {
  * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
  */
 export async function flapBatchSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
     if (buyerPrivateKeys.length === 0) {
@@ -581,9 +604,18 @@ export async function flapBatchSwapMerkle(params) {
             }, useNativeToken ? { value: buyAmount } : {});
         })
     ]);
-    // ✅ 并行获取所有 nonce
-    const sellNonce = await nonceManager.getNextNonce(seller);
-    const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+    // ✅ 并行获取所有 nonce（如果前端传入了 startNonces，直接使用）
+    const allWallets = [seller, ...buyers];
+    let sellNonce;
+    let buyerNonces;
+    if (startNonces && startNonces.length >= allWallets.length) {
+        sellNonce = startNonces[0];
+        buyerNonces = startNonces.slice(1);
+    }
+    else {
+        sellNonce = await nonceManager.getNextNonce(seller);
+        buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+    }
     // ✅ 贿赂交易和利润交易都由卖方发送（保持一致）
     const bribeAmount = getBribeAmount(config);
     let bribeTx = null;
@@ -682,7 +714,8 @@ export async function flapBatchSwapMerkle(params) {
  * 限制：最多 23 个买方（2N + 3 ≤ 50）
  */
 export async function flapQuickBatchSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 校验买方数量
     // BNB 模式：贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
     // ERC20 模式：贿赂(1) + 卖出(1) + ERC20转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
@@ -791,7 +824,10 @@ export async function flapQuickBatchSwapMerkle(params) {
         throw new Error(`主钱包 ${chainContext.nativeToken} 余额不足: 需要约 ${ethers.formatEther(sellerRequired)} (贿赂: ${ethers.formatEther(bribeAmount)}, Gas: ${ethers.formatEther(sellerGasCost)}), 实际 ${ethers.formatEther(sellerBalance)}`);
     }
     // ==================== 规划 Nonce ====================
-    let sellerNonce = await nonceManager.getNextNonce(seller);
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    let sellerNonce = startNonces && startNonces.length > 0
+        ? startNonces[0]
+        : await nonceManager.getNextNonce(seller);
     // ==================== 1. 贿赂交易 ====================
     let bribeTx = null;
     if (bribeAmount > 0n) {
@@ -873,7 +909,10 @@ export async function flapQuickBatchSwapMerkle(params) {
     }
     console.log(`[flapQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
     // ==================== 4. 买入交易 ====================
-    const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+    // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
+    const buyerNonces = startNonces && startNonces.length > 1
+        ? startNonces.slice(1)
+        : await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         const portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);

package/dist/pancake/bundle-swap.d.ts

@@ -47,6 +47,7 @@ export interface PancakeBundleSwapSignParams {
     config: PancakeSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    startNonces?: number[];
 }
 export interface PancakeBundleSwapParams {
     sellerPrivateKey: string;
@@ -88,6 +89,7 @@ export interface PancakeBatchSwapSignParams {
     config: PancakeSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    startNonces?: number[];
 }
 /**
  * 批量换手结果
@@ -127,6 +129,7 @@ export interface PancakeQuickBatchSwapParams {
     config: PancakeSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    startNonces?: number[];
 }
 /**
  * 快捷批量换手结果

package/dist/pancake/bundle-swap.js

@@ -115,6 +115,30 @@ async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, useNat
         return { buyerBalance, reserveGas, requiredBalance, buyAmountBNB, useNativeToken };
     }
 }
+/**
+ * ✅ 从前端传入的 startNonces 构建 NoncePlan（用于性能优化）
+ * 顺序：[sellerBaseNonce, buyerNonce]
+ */
+function buildNoncePlanFromNonces(startNonces, sameAddress, approvalExists, profitNeeded, needBribeTx) {
+    if (sameAddress) {
+        let idx = 0;
+        const bribeNonce = needBribeTx ? startNonces[0] + idx++ : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = startNonces[0] + idx++;
+        const buyerNonce = startNonces[0] + idx++;
+        const profitNonce = profitNeeded ? startNonces[0] + idx : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    let sellerIdx = 0;
+    const bribeNonce = needBribeTx ? startNonces[0] + sellerIdx++ : undefined;
+    if (approvalExists)
+        sellerIdx++;
+    const sellerNonce = startNonces[0] + sellerIdx++;
+    const profitNonce = profitNeeded ? startNonces[0] + sellerIdx : undefined;
+    const buyerNonce = startNonces[1];
+    return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+}
 /**
  * ✅ 规划 nonce
  * 交易顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
@@ -294,7 +318,8 @@ const ERC20_BALANCE_OF_ABI = ['function balanceOf(address) view returns (uint256
  * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
  */
 export async function pancakeBundleSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const context = createPancakeContext(config);
@@ -358,15 +383,18 @@ export async function pancakeBundleSwapMerkle(params) {
         : 0n;
     const needBribeTx = bribeAmount > 0n;
     // ✅ 使用共享的 NonceManager 规划 nonce
-    const noncePlan = await planNonces({
-        seller,
-        buyer,
-        sameAddress,
-        approvalExists: false, // ✅ 已移除授权
-        profitNeeded: profitAmount > 0n,
-        needBribeTx,
-        nonceManager
-    });
+    // 如果前端传入了 startNonces，直接使用（性能优化）
+    const noncePlan = startNonces && startNonces.length >= (sameAddress ? 1 : 2)
+        ? buildNoncePlanFromNonces(startNonces, sameAddress, false, profitAmount > 0n, needBribeTx)
+        : await planNonces({
+            seller,
+            buyer,
+            sameAddress,
+            approvalExists: false, // ✅ 已移除授权
+            profitNeeded: profitAmount > 0n,
+            needBribeTx,
+            nonceManager
+        });
     // ✅ 并行签名所有交易
     const signPromises = [];
     // 贿赂交易
@@ -462,7 +490,8 @@ export async function pancakeBundleSwapMerkle(params) {
  * 交易顺序：[授权(可选)] → [卖出] → [买入1, 买入2, ..., 买入N] → [利润]
  */
 export async function pancakeBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
     if (buyerPrivateKeys.length === 0) {
@@ -577,16 +606,26 @@ export async function pancakeBatchSwapMerkle(params) {
         ? ethers.parseEther(String(config.bribeAmount))
         : 0n;
     // ✅ 规划 Nonce（贿赂和利润都由卖方发送）
-    // 卖方: [贿赂(可选)] → [授权(可选)] → [卖出] → [利润(可选)]
+    // 卖方: [贿赂(可选)] → [卖出] → [利润(可选)]
     let bribeNonce;
-    let sellNonceOffset = 0;
-    if (bribeAmount > 0n) {
-        bribeNonce = await nonceManager.getNextNonce(seller);
-        sellNonceOffset = 1; // 卖出交易 nonce 需要偏移
+    let sellNonce;
+    let buyerNonces;
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    if (startNonces && startNonces.length >= (1 + buyers.length)) {
+        let sellerIdx = 0;
+        if (bribeAmount > 0n) {
+            bribeNonce = startNonces[0] + sellerIdx++;
+        }
+        sellNonce = startNonces[0] + sellerIdx;
+        buyerNonces = startNonces.slice(1);
+    }
+    else {
+        if (bribeAmount > 0n) {
+            bribeNonce = await nonceManager.getNextNonce(seller);
+        }
+        sellNonce = await nonceManager.getNextNonce(seller);
+        buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     }
-    const sellNonce = await nonceManager.getNextNonce(seller);
-    // ✅ 并行获取所有买方的 nonce
-    const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     // ✅ 贿赂交易放在首位（由卖方发送）
     let bribeTx = null;
     if (bribeAmount > 0n && bribeNonce !== undefined) {
@@ -616,7 +655,10 @@ export async function pancakeBatchSwapMerkle(params) {
     let profitTx = null;
     if (profitAmount > 0n) {
         // ✅ 利润由卖方发送（与贿赂交易同一钱包）
-        const profitNonce = await nonceManager.getNextNonce(seller);
+        // 如果使用 startNonces，利润 nonce = 卖出 nonce + 1
+        const profitNonce = startNonces && startNonces.length >= 1
+            ? sellNonce + 1
+            : await nonceManager.getNextNonce(seller);
         profitTx = await seller.signTransaction({
             to: PROFIT_CONFIG.RECIPIENT,
             value: profitAmount,
@@ -689,7 +731,8 @@ export async function pancakeBatchSwapMerkle(params) {
  * 限制：最多 23 个买方（转账 + 买入 = 46 笔，加上贿赂/卖出/利润 = 50 笔限制）
  */
 export async function pancakeQuickBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+     } = params;
     // ✅ 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c'.toLowerCase();
@@ -840,7 +883,10 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         throw new Error(`主钱包 BNB 余额不足: 需要约 ${ethers.formatEther(sellerRequired)} BNB (贿赂: ${ethers.formatEther(bribeAmount)}, Gas: ${ethers.formatEther(sellerGasCost)}), 实际 ${ethers.formatEther(sellerBalance)} BNB`);
     }
     // ==================== 规划 Nonce ====================
-    let sellerNonce = await nonceManager.getNextNonce(seller);
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    let sellerNonce = startNonces && startNonces.length > 0
+        ? startNonces[0]
+        : await nonceManager.getNextNonce(seller);
     const deadline = Math.floor(Date.now() / 1000) + 600;
     // ==================== 1. 贿赂交易 ====================
     let bribeTx = null;
@@ -926,7 +972,10 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     console.log(`[pancakeQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
     // ==================== 4. 买入交易 ====================
-    const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+    // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
+    const buyerNonces = startNonces && startNonces.length > 1
+        ? startNonces.slice(1)
+        : await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         const proxyBuyer = new Contract(PANCAKE_PROXY_ADDRESS, PANCAKE_PROXY_ABI, buyer);

package/package.json

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