four-flap-meme-sdk 1.4.14 → 1.4.16

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

@@ -91,3 +91,43 @@ export interface FourBatchSwapResult {
  * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
  */
 export declare function fourBatchSwapMerkle(params: FourBatchSwapSignParams): Promise<FourBatchSwapResult>;
+/**
+ * Four 快捷批量换手参数
+ */
+export interface FourQuickBatchSwapSignParams {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+}
+/**
+ * Four 快捷批量换手结果
+ */
+export interface FourQuickBatchSwapResult {
+    signedTransactions: string[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedBNBOut: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+    };
+}
+/**
+ * Four 内盘快捷批量换手（资金利用率模式）
+ *
+ * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ *
+ * 特点：
+ * - 子钱包不需要预先有 BNB
+ * - 资金来自主钱包卖出代币所得
+ * - 提升资金利用率
+ *
+ * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ */
+export declare function fourQuickBatchSwapMerkle(params: FourQuickBatchSwapSignParams): Promise<FourQuickBatchSwapResult>;

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

@@ -425,3 +425,210 @@ export async function fourBatchSwapMerkle(params) {
         }
     };
 }
+/**
+ * Four 内盘快捷批量换手（资金利用率模式）
+ *
+ * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ *
+ * 特点：
+ * - 子钱包不需要预先有 BNB
+ * - 资金来自主钱包卖出代币所得
+ * - 提升资金利用率
+ *
+ * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ */
+export async function fourQuickBatchSwapMerkle(params) {
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config } = params;
+    // ✅ 校验买方数量
+    // 贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
+    const MAX_BUYERS = 23;
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方钱包');
+    }
+    if (buyerPrivateKeys.length > MAX_BUYERS) {
+        throw new Error(`资金利用率模式买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+    }
+    // ✅ 校验分配模式
+    if (!buyerRatios && !buyerAmounts) {
+        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
+    }
+    if (buyerRatios && buyerRatios.length !== buyerPrivateKeys.length) {
+        throw new Error(`buyerRatios 长度 (${buyerRatios.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
+    }
+    if (buyerAmounts && buyerAmounts.length !== buyerPrivateKeys.length) {
+        throw new Error(`buyerAmounts 长度 (${buyerAmounts.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
+    }
+    const chainIdNum = config.chainId ?? 56;
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId: chainIdNum,
+        name: 'BSC'
+    });
+    const seller = new Wallet(sellerPrivateKey, provider);
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, provider));
+    const nonceManager = new NonceManager(provider);
+    // 创建适配的配置对象
+    const bundleConfig = {
+        minGasPriceGwei: config.minGasPriceGwei,
+        maxGasPriceGwei: config.maxGasPriceGwei,
+        gasLimit: typeof config.gasLimit === 'bigint' ? Number(config.gasLimit) : config.gasLimit,
+        gasLimitMultiplier: config.gasLimitMultiplier,
+        txType: config.txType,
+        chainId: config.chainId
+    };
+    const finalGasLimit = getGasLimit(bundleConfig);
+    const txType = getTxType(bundleConfig);
+    // ✅ 并行获取：卖出数量、gasPrice
+    const [sellAmountResult, gasPrice] = await Promise.all([
+        calculateSellAmount(provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig))
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    // ✅ 获取卖出报价
+    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
+    const sellQuote = await helper3.trySell(tokenAddress, sellAmountWei);
+    const estimatedBNBOut = sellQuote.funds;
+    console.log(`[fourQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
+    console.log(`[fourQuickBatchSwapMerkle] 预估卖出所得: ${ethers.formatEther(estimatedBNBOut)} BNB`);
+    // ✅ 计算利润
+    const profitRateBps = PROFIT_CONFIG.RATE_BPS;
+    const profitAmount = estimatedBNBOut > 0n
+        ? (estimatedBNBOut * BigInt(profitRateBps)) / 10000n
+        : 0n;
+    const distributableAmount = estimatedBNBOut - profitAmount;
+    // ✅ 计算每个买方分到的金额
+    let transferAmountsWei;
+    if (buyerAmounts && buyerAmounts.length === buyers.length) {
+        // 数量模式
+        transferAmountsWei = buyerAmounts.map(amt => ethers.parseEther(amt));
+        const totalTransfer = transferAmountsWei.reduce((a, b) => a + b, 0n);
+        if (totalTransfer > distributableAmount) {
+            throw new Error(`指定的买入总金额超过可分配金额 (${ethers.formatEther(distributableAmount)} BNB)`);
+        }
+    }
+    else if (buyerRatios && buyerRatios.length === buyers.length) {
+        // 比例模式
+        transferAmountsWei = buyerRatios.map(ratio => {
+            return (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
+        });
+    }
+    else {
+        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
+    }
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    // ✅ 验证主钱包余额
+    const sellerBalance = await seller.provider.getBalance(seller.address);
+    // 主钱包只需要支付：贿赂 + Gas（卖出后有 BNB 可用于转账和利润）
+    const sellerGasCost = gasPrice * (21000n + finalGasLimit + 21000n * BigInt(buyers.length) + 21000n);
+    const sellerRequired = bribeAmount + sellerGasCost;
+    if (sellerBalance < sellerRequired) {
+        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);
+    // ==================== 1. 贿赂交易 ====================
+    let bribeTx = null;
+    if (bribeAmount > 0n) {
+        bribeTx = await seller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainIdNum,
+            type: txType
+        });
+        console.log(`[fourQuickBatchSwapMerkle] 贿赂交易已签名`);
+    }
+    // ==================== 2. 卖出交易 ====================
+    const tmSeller = new Contract(TM_ADDRESS, TM_ABI, seller);
+    const sellUnsigned = await tmSeller.sellToken.populateTransaction(0n, tokenAddress, sellAmountWei, 0n);
+    const signedSell = await seller.signTransaction({
+        ...sellUnsigned,
+        from: seller.address,
+        nonce: sellerNonce++,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: chainIdNum,
+        type: txType
+    });
+    console.log(`[fourQuickBatchSwapMerkle] 卖出交易已签名`);
+    // ==================== 3. 转账交易 ====================
+    const transferTxs = [];
+    const reserveGas = ethers.parseEther((config.reserveGasBNB || 0.0005).toString());
+    for (let i = 0; i < buyers.length; i++) {
+        // 转账金额 = 买入金额 + Gas 预留
+        const buyerGasCost = gasPrice * finalGasLimit;
+        const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
+        const transferTx = await seller.signTransaction({
+            to: buyers[i].address,
+            value: transferValue,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainIdNum,
+            type: txType
+        });
+        transferTxs.push(transferTx);
+    }
+    console.log(`[fourQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
+    // ==================== 4. 买入交易 ====================
+    const buyerNonces = 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);
+        const buyUnsigned = await tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyAmount, 0n, { value: buyAmount });
+        return buyer.signTransaction({
+            ...buyUnsigned,
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: chainIdNum,
+            type: txType,
+            value: buyAmount
+        });
+    }));
+    console.log(`[fourQuickBatchSwapMerkle] ${signedBuys.length} 笔买入交易已签名`);
+    // ==================== 5. 利润交易 ====================
+    let profitTx = null;
+    if (profitAmount > 0n) {
+        profitTx = await seller.signTransaction({
+            to: PROFIT_CONFIG.RECIPIENT,
+            value: profitAmount,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainIdNum,
+            type: txType
+        });
+        console.log(`[fourQuickBatchSwapMerkle] 利润交易已签名`);
+    }
+    nonceManager.clearTemp();
+    // ==================== 组装交易数组 ====================
+    const signedTransactions = [];
+    if (bribeTx)
+        signedTransactions.push(bribeTx);
+    signedTransactions.push(signedSell);
+    signedTransactions.push(...transferTxs);
+    signedTransactions.push(...signedBuys);
+    if (profitTx)
+        signedTransactions.push(profitTx);
+    console.log(`[fourQuickBatchSwapMerkle] 交易组装完成: ${signedTransactions.length} 笔`);
+    console.log(`  - 贿赂: ${bribeTx ? 1 : 0}`);
+    console.log(`  - 卖出: 1`);
+    console.log(`  - 转账: ${transferTxs.length}`);
+    console.log(`  - 买入: ${signedBuys.length}`);
+    console.log(`  - 利润: ${profitTx ? 1 : 0}`);
+    return {
+        signedTransactions,
+        metadata: {
+            sellerAddress: seller.address,
+            buyerAddresses: buyers.map(b => b.address),
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            estimatedBNBOut: ethers.formatEther(estimatedBNBOut),
+            transferAmounts: transferAmountsWei.map(amt => ethers.formatEther(amt)),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined
+        }
+    };
+}

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

@@ -101,3 +101,48 @@ export interface FlapBatchSwapResult {
  * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
  */
 export declare function flapBatchSwapMerkle(params: FlapBatchSwapSignParams): Promise<FlapBatchSwapResult>;
+/**
+ * Flap 快捷批量换手参数
+ */
+export interface FlapQuickBatchSwapSignParams {
+    chain: FlapChain;
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    config: FlapSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+}
+/**
+ * Flap 快捷批量换手结果
+ */
+export interface FlapQuickBatchSwapResult {
+    signedTransactions: string[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedOutput: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        useNativeToken: boolean;
+    };
+}
+/**
+ * Flap 内盘快捷批量换手（资金利用率模式）
+ *
+ * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ *
+ * 特点：
+ * - 子钱包不需要预先有余额
+ * - 资金来自主钱包卖出代币所得
+ * - 提升资金利用率
+ * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
+ *
+ * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ */
+export declare function flapQuickBatchSwapMerkle(params: FlapQuickBatchSwapSignParams): Promise<FlapQuickBatchSwapResult>;

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

@@ -668,3 +668,278 @@ export async function flapBatchSwapMerkle(params) {
         }
     };
 }
+/**
+ * Flap 内盘快捷批量换手（资金利用率模式）
+ *
+ * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ *
+ * 特点：
+ * - 子钱包不需要预先有余额
+ * - 资金来自主钱包卖出代币所得
+ * - 提升资金利用率
+ * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
+ *
+ * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ */
+export async function flapQuickBatchSwapMerkle(params) {
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18 } = 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
+    const MAX_BUYERS = 23;
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方钱包');
+    }
+    if (buyerPrivateKeys.length > MAX_BUYERS) {
+        throw new Error(`资金利用率模式买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+    }
+    // ✅ 校验分配模式
+    if (!buyerRatios && !buyerAmounts) {
+        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
+    }
+    if (buyerRatios && buyerRatios.length !== buyerPrivateKeys.length) {
+        throw new Error(`buyerRatios 长度 (${buyerRatios.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
+    }
+    if (buyerAmounts && buyerAmounts.length !== buyerPrivateKeys.length) {
+        throw new Error(`buyerAmounts 长度 (${buyerAmounts.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
+    }
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    const ERC20_TRANSFER_GAS = 65000n;
+    const chainContext = createChainContext(chain, config);
+    const seller = new Wallet(sellerPrivateKey, chainContext.provider);
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
+    const nonceManager = new NonceManager(chainContext.provider);
+    const finalGasLimit = getGasLimit(config);
+    const txType = getTxType(config);
+    // ✅ 并行获取：卖出数量、gasPrice
+    const [sellAmountResult, gasPrice] = await Promise.all([
+        calculateSellAmount(chainContext.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config))
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+    // ✅ 获取卖出报价
+    const quote = await quoteSellOutput({
+        portalAddress: chainContext.portalAddress,
+        tokenAddress,
+        sellAmountWei,
+        provider: chainContext.provider,
+        skipQuoteOnError: config.skipQuoteOnError,
+        outputToken
+    });
+    const estimatedOutput = quote.quotedNative;
+    const outputFormatted = useNativeToken
+        ? ethers.formatEther(estimatedOutput)
+        : ethers.formatUnits(estimatedOutput, quoteTokenDecimals);
+    console.log(`[flapQuickBatchSwapMerkle] 模式: ${useNativeToken ? '原生代币' : 'ERC20'}`);
+    console.log(`[flapQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
+    console.log(`[flapQuickBatchSwapMerkle] 预估卖出所得: ${outputFormatted}`);
+    // ✅ 计算利润（基于原生代币价值）
+    let tokenProfitAmount = calculateProfitAmount(estimatedOutput);
+    let nativeProfitAmount = tokenProfitAmount;
+    if (!useNativeToken && tokenProfitAmount > 0n) {
+        // ERC20 模式：将代币利润转换为等值原生代币
+        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, quoteToken, tokenProfitAmount, chainContext.chainId);
+        console.log(`[flapQuickBatchSwapMerkle] ERC20→原生代币 报价: ${ethers.formatUnits(tokenProfitAmount, quoteTokenDecimals)} → ${ethers.formatEther(nativeProfitAmount)}`);
+    }
+    const distributableAmount = useNativeToken
+        ? estimatedOutput - tokenProfitAmount
+        : estimatedOutput; // ERC20 模式利润从原生代币扣
+    // ✅ 计算每个买方分到的金额
+    let transferAmountsWei;
+    if (buyerAmounts && buyerAmounts.length === buyers.length) {
+        // 数量模式
+        transferAmountsWei = buyerAmounts.map(amt => useNativeToken
+            ? ethers.parseEther(amt)
+            : ethers.parseUnits(amt, quoteTokenDecimals));
+        const totalTransfer = transferAmountsWei.reduce((a, b) => a + b, 0n);
+        if (totalTransfer > distributableAmount) {
+            const formatted = useNativeToken
+                ? ethers.formatEther(distributableAmount)
+                : ethers.formatUnits(distributableAmount, quoteTokenDecimals);
+            throw new Error(`指定的买入总金额超过可分配金额 (${formatted})`);
+        }
+    }
+    else if (buyerRatios && buyerRatios.length === buyers.length) {
+        // 比例模式
+        transferAmountsWei = buyerRatios.map(ratio => {
+            return (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
+        });
+    }
+    else {
+        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
+    }
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    // ✅ 验证主钱包余额
+    const sellerBalance = await seller.provider.getBalance(seller.address);
+    let sellerGasCost;
+    let sellerRequired;
+    if (useNativeToken) {
+        // 原生代币模式：贿赂 + Gas（卖出 + 转账 + 利润）
+        sellerGasCost = gasPrice * (21000n + finalGasLimit + 21000n * BigInt(buyers.length) + 21000n);
+        sellerRequired = bribeAmount + sellerGasCost;
+    }
+    else {
+        // ERC20 模式：贿赂 + Gas（卖出 + ERC20转账 + 利润）
+        sellerGasCost = gasPrice * (21000n + finalGasLimit + ERC20_TRANSFER_GAS * BigInt(buyers.length) + 21000n);
+        sellerRequired = bribeAmount + sellerGasCost;
+    }
+    if (sellerBalance < sellerRequired) {
+        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);
+    // ==================== 1. 贿赂交易 ====================
+    let bribeTx = null;
+    if (bribeAmount > 0n) {
+        bribeTx = await seller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainContext.chainId,
+            type: txType
+        });
+        console.log(`[flapQuickBatchSwapMerkle] 贿赂交易已签名`);
+    }
+    // ==================== 2. 卖出交易 ====================
+    const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
+    const sellUnsigned = await portalSeller.swapExactInput.populateTransaction({
+        inputToken: tokenAddress,
+        outputToken,
+        inputAmount: sellAmountWei,
+        minOutputAmount: 0,
+        permitData: '0x'
+    });
+    const sellTx = buildTransactionRequest(sellUnsigned, {
+        from: seller.address,
+        nonce: sellerNonce++,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        priorityFee,
+        chainId: chainContext.chainId,
+        txType,
+        value: 0n
+    });
+    const signedSell = await seller.signTransaction(sellTx);
+    console.log(`[flapQuickBatchSwapMerkle] 卖出交易已签名`);
+    // ==================== 3. 转账交易 ====================
+    const transferTxs = [];
+    const reserveGas = ethers.parseEther((config.reserveGasETH || 0.0005).toString());
+    if (useNativeToken) {
+        // 原生代币模式：直接转账
+        for (let i = 0; i < buyers.length; i++) {
+            const buyerGasCost = gasPrice * finalGasLimit;
+            const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
+            const transferTx = await seller.signTransaction({
+                to: buyers[i].address,
+                value: transferValue,
+                nonce: sellerNonce++,
+                gasPrice,
+                gasLimit: 21000n,
+                chainId: chainContext.chainId,
+                type: txType
+            });
+            transferTxs.push(transferTx);
+        }
+    }
+    else {
+        // ERC20 模式：ERC20 transfer（子钱包已预留原生代币）
+        const erc20Interface = new ethers.Interface([
+            'function transfer(address to, uint256 amount) returns (bool)'
+        ]);
+        for (let i = 0; i < buyers.length; i++) {
+            const transferData = erc20Interface.encodeFunctionData('transfer', [
+                buyers[i].address,
+                transferAmountsWei[i]
+            ]);
+            const transferTx = await seller.signTransaction({
+                to: quoteToken,
+                data: transferData,
+                value: 0n,
+                nonce: sellerNonce++,
+                gasPrice,
+                gasLimit: ERC20_TRANSFER_GAS,
+                chainId: chainContext.chainId,
+                type: txType
+            });
+            transferTxs.push(transferTx);
+        }
+    }
+    console.log(`[flapQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
+    // ==================== 4. 买入交易 ====================
+    const buyerNonces = 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);
+        const buyUnsigned = await portalBuyer.swapExactInput.populateTransaction({
+            inputToken: outputToken,
+            outputToken: tokenAddress,
+            inputAmount: buyAmount,
+            minOutputAmount: 0,
+            permitData: '0x'
+        }, useNativeToken ? { value: buyAmount } : {});
+        const buyTx = buildTransactionRequest(buyUnsigned, {
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            priorityFee,
+            chainId: chainContext.chainId,
+            txType,
+            value: useNativeToken ? buyAmount : 0n
+        });
+        return buyer.signTransaction(buyTx);
+    }));
+    console.log(`[flapQuickBatchSwapMerkle] ${signedBuys.length} 笔买入交易已签名`);
+    // ==================== 5. 利润交易 ====================
+    let profitTx = null;
+    if (nativeProfitAmount > 0n) {
+        profitTx = await seller.signTransaction({
+            to: getProfitRecipient(),
+            value: nativeProfitAmount,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainContext.chainId,
+            type: txType
+        });
+        console.log(`[flapQuickBatchSwapMerkle] 利润交易已签名`);
+    }
+    nonceManager.clearTemp();
+    // ==================== 组装交易数组 ====================
+    const signedTransactions = [];
+    if (bribeTx)
+        signedTransactions.push(bribeTx);
+    signedTransactions.push(signedSell);
+    signedTransactions.push(...transferTxs);
+    signedTransactions.push(...signedBuys);
+    if (profitTx)
+        signedTransactions.push(profitTx);
+    console.log(`[flapQuickBatchSwapMerkle] 交易组装完成: ${signedTransactions.length} 笔`);
+    console.log(`  - 贿赂: ${bribeTx ? 1 : 0}`);
+    console.log(`  - 卖出: 1`);
+    console.log(`  - 转账: ${transferTxs.length}`);
+    console.log(`  - 买入: ${signedBuys.length}`);
+    console.log(`  - 利润: ${profitTx ? 1 : 0}`);
+    return {
+        signedTransactions,
+        metadata: {
+            sellerAddress: seller.address,
+            buyerAddresses: buyers.map(b => b.address),
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            estimatedOutput: useNativeToken
+                ? ethers.formatEther(estimatedOutput)
+                : ethers.formatUnits(estimatedOutput, quoteTokenDecimals),
+            transferAmounts: transferAmountsWei.map(amt => useNativeToken
+                ? ethers.formatEther(amt)
+                : ethers.formatUnits(amt, quoteTokenDecimals)),
+            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined,
+            useNativeToken
+        }
+    };
+}

package/dist/index.d.ts

@@ -36,8 +36,8 @@ export { validatePrivateKeys, type PrivateKeyValidation } from './utils/wallet.j
 export { stealthTransfer, type StealthTransferResult, type StealthTransferSimpleParams } from './utils/stealth-transfer.js';
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, type LPInfo, type LPPlatform, type InspectOptions, type DexConfig, type ChainDexConfig, } from './utils/lp-inspect.js';
 export { disperseWithBundle, sweepWithBundle, type DisperseSignParams, type SweepSignParams, type SignedTransactionsResult, type DisperseParams, type SweepParams, type BundleSubmitResult } from './utils/airdrop-sweep.js';
-export { fourBundleSwapMerkle, fourBatchSwapMerkle, type FourSwapSignConfig, type FourSwapConfig, type FourBundleSwapSignParams, type FourBundleSwapParams, type FourSwapResult, type FourBatchSwapSignParams, type FourBatchSwapResult } from './contracts/tm-bundle-merkle/swap.js';
-export { flapBundleSwapMerkle, flapBatchSwapMerkle, type FlapSwapSignConfig, type FlapSwapConfig, type FlapBundleSwapSignParams, type FlapBundleSwapParams, type FlapSwapResult, type FlapBatchSwapSignParams, type FlapBatchSwapResult } from './flap/portal-bundle-merkle/swap.js';
+export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, type FourSwapSignConfig, type FourSwapConfig, type FourBundleSwapSignParams, type FourBundleSwapParams, type FourSwapResult, type FourBatchSwapSignParams, type FourBatchSwapResult, type FourQuickBatchSwapSignParams, type FourQuickBatchSwapResult } from './contracts/tm-bundle-merkle/swap.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, type FlapSwapSignConfig, type FlapSwapConfig, type FlapBundleSwapSignParams, type FlapBundleSwapParams, type FlapSwapResult, type FlapBatchSwapSignParams, type FlapBatchSwapResult, type FlapQuickBatchSwapSignParams, type FlapQuickBatchSwapResult } from './flap/portal-bundle-merkle/swap.js';
 export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, type PancakeSwapSignConfig, type PancakeBundleSwapSignParams, type PancakeSwapConfig, type PancakeBundleSwapParams, type PancakeSwapResult, type PancakeBatchSwapSignParams, type PancakeBatchSwapResult, type PancakeQuickBatchSwapParams, type PancakeQuickBatchSwapResult, type SwapRouteType, type V2RouteParams, type V3SingleRouteParams, type V3MultiRouteParams, type RouteParams } from './pancake/bundle-swap.js';
 export { fourBundleBuyFirstMerkle, type FourBuyFirstConfig, type FourBundleBuyFirstParams, type FourBuyFirstSignConfig, type FourBundleBuyFirstSignParams, type FourBuyFirstResult } from './contracts/tm-bundle-merkle/swap-buy-first.js';
 export { flapBundleBuyFirstMerkle, type FlapBuyFirstSignConfig, type FlapBuyFirstConfig, type FlapBundleBuyFirstSignParams, type FlapBundleBuyFirstParams, type FlapBuyFirstResult } from './flap/portal-bundle-merkle/swap-buy-first.js';

package/dist/index.js

@@ -52,9 +52,9 @@ export { disperseWithBundle, sweepWithBundle } from './utils/airdrop-sweep.js';
 // 捆绑换手功能（Bundle Swap）
 // ============================================================
 // Four内盘换手
-export { fourBundleSwapMerkle, fourBatchSwapMerkle } from './contracts/tm-bundle-merkle/swap.js';
+export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle } from './contracts/tm-bundle-merkle/swap.js';
 // Flap内盘换手
-export { flapBundleSwapMerkle, flapBatchSwapMerkle } from './flap/portal-bundle-merkle/swap.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle } from './flap/portal-bundle-merkle/swap.js';
 // PancakeSwap V2/V3通用换手
 export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle } from './pancake/bundle-swap.js';
 // 先买后卖（Buy-First）入口

package/dist/pancake/bundle-swap.js

@@ -693,12 +693,10 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     // ✅ 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c'.toLowerCase();
-    // ✅ 校验买方数量（已移除授权交易）
+    // ✅ 校验买方数量（子钱包已预留 BNB，不需要主钱包转 Gas）
     // BNB 模式：贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
-    // ERC20 模式：贿赂(1) + 卖出(1) + ERC20转账(N) + BNB Gas转账(N) + 买入(N) + 利润(1) ≤ 50 → 3N + 3 ≤ 50 → N ≤ 15
-    const MAX_BUYERS_NATIVE = 23;
-    const MAX_BUYERS_ERC20 = 15;
-    const MAX_BUYERS = useNativeToken ? MAX_BUYERS_NATIVE : MAX_BUYERS_ERC20;
+    // ERC20 模式：贿赂(1) + 卖出(1) + ERC20转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
+    const MAX_BUYERS = 23;
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
@@ -833,12 +831,10 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         sellerRequired = bribeAmount + sellerGasCost;
     }
     else {
-        // ERC20 模式（已移除授权）：
-        // - 卖方 Gas: 贿赂(21000) + 卖出(gasLimit) + N个ERC20转账(65000 each) + N个BNB Gas转账(21000 each) + 利润(21000)
-        // - 买方 Gas: N个买入(gasLimit each) + N个FLAT_FEE
-        sellerGasCost = gasPrice * (21000n + finalGasLimit + (ERC20_TRANSFER_GAS + 21000n) * BigInt(buyers.length) + 21000n);
-        const buyerGasNeeded = gasPrice * finalGasLimit * BigInt(buyers.length) + FLAT_FEE * BigInt(buyers.length);
-        sellerRequired = bribeAmount + sellerGasCost + buyerGasNeeded;
+        // ERC20 模式：子钱包已预留 BNB，不需要主钱包转 Gas
+        // 卖方 Gas: 贿赂(21000) + 卖出(gasLimit) + N个ERC20转账(65000 each) + 利润(21000)
+        sellerGasCost = gasPrice * (21000n + finalGasLimit + ERC20_TRANSFER_GAS * BigInt(buyers.length) + 21000n);
+        sellerRequired = bribeAmount + sellerGasCost;
     }
     if (sellerBalance < sellerRequired) {
         throw new Error(`主钱包 BNB 余额不足: 需要约 ${ethers.formatEther(sellerRequired)} BNB (贿赂: ${ethers.formatEther(bribeAmount)}, Gas: ${ethers.formatEther(sellerGasCost)}), 实际 ${ethers.formatEther(sellerBalance)} BNB`);
@@ -905,7 +901,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         }
     }
     else {
-        // ✅ ERC20 模式：ERC20 transfer 调用
+        // ✅ ERC20 模式：ERC20 transfer 调用（子钱包已预留 BNB，不需要转 Gas）
         const erc20Interface = new ethers.Interface([
             'function transfer(address to, uint256 amount) returns (bool)'
         ]);
@@ -926,20 +922,6 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             });
             transferTxs.push(transferTx);
         }
-        // ERC20 模式：额外转账 Gas 费用给买家（用于支付买入 Gas 和 FLAT_FEE）
-        for (let i = 0; i < buyers.length; i++) {
-            const buyerGasCost = gasPrice * finalGasLimit + FLAT_FEE;
-            const gasTx = await seller.signTransaction({
-                to: buyers[i].address,
-                value: buyerGasCost,
-                nonce: sellerNonce++,
-                gasPrice,
-                gasLimit: 21000n,
-                chainId: context.chainId,
-                type: txType
-            });
-            transferTxs.push(gasTx);
-        }
     }
     console.log(`[pancakeQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
     // ==================== 4. 买入交易 ====================

package/package.json

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