four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/bundle/four-meme/private.js

@@ -1,465 +1,7 @@
-import { ethers, Wallet } from 'ethers';
-import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../utils/bundle-helpers.js';
-import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, CHAINS } from '../../core/constants/index.js';
-import { TM2_ABI } from '../../abis/common.js';
-import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, calculateBatchProfit, getProfitRecipient, getBribeAmount, } from '../config-helpers.js';
-import { trySell } from '../../domains/four/contracts/tm.js';
-import { createSignProvider } from '../sign-context-helpers.js';
-const CHAIN_ID = CHAINS.BSC.chainId;
-const DEFAULT_GAS_LIMIT = 800000;
-// ✅ TM2_ABI 从公共模块导入
-// ✅ 本地 getGasLimit（FourAnyConfig 支持 bigint gasLimit）
-function getGasLimit(config, defaultGas = DEFAULT_GAS_LIMIT) {
-    if (config.gasLimit !== undefined) {
-        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
-    }
-    const multiplier = config.gasLimitMultiplier ?? 1.0;
-    return BigInt(Math.ceil(defaultGas * multiplier));
-}
 /**
- * 私有购买（单笔）（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化：并行获取 gasPrice 和 nonce
+ * 私有交易（仅签名版本 - 不依赖 Merkle）
+ *
+ * 原超长文件按职责拆分为 private/ 目录下的多个子文件，
+ * 对外 export 符号与路径保持不变（见 private/index.ts）。
  */
-export async function fourPrivateBuyMerkle(params) {
-    const { privateKey, tokenAddress, funds, to, config } = params;
-    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
-    const provider = createSignProvider(config.rpcUrl, CHAIN_ID, 'BSC');
-    const wallet = new Wallet(privateKey, provider);
-    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
-    const txType = getTxType(config);
-    const gasLimit = getGasLimit(config);
-    const originalFundsWei = ethers.parseEther(funds);
-    // ✅ 利润提取配置（同步计算）
-    const extractProfit = shouldExtractProfit();
-    let profitWei = 0n;
-    let actualFundsWei = originalFundsWei;
-    if (extractProfit) {
-        const { profit, remaining } = calculateProfit(originalFundsWei);
-        profitWei = profit;
-        actualFundsWei = remaining;
-    }
-    const tm2 = new ethers.Contract(tmAddr, TM2_ABI, wallet);
-    // ✅ 获取贿赂金额
-    const bribeAmount = getBribeAmount(config);
-    const needBribeTx = bribeAmount > 0n;
-    const needProfitTx = extractProfit && profitWei > 0n;
-    // ✅ 优化：并行获取 gasPrice、nonce 和构建未签名交易
-    const [gasPrice, baseNonce, unsigned] = await Promise.all([
-        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-        wallet.getNonce(),
-        tm2.buyTokenAMAP.populateTransaction(0n, tokenAddress, to ?? wallet.address, actualFundsWei, 0n, {
-            value: actualFundsWei,
-        }),
-    ]);
-    // ✅ 分配 nonces：贿赂 → 买入 → 利润
-    let nonceIdx = 0;
-    const bribeNonce = needBribeTx ? baseNonce + nonceIdx++ : undefined;
-    const buyNonce = baseNonce + nonceIdx++;
-    const profitNonce = needProfitTx ? baseNonce + nonceIdx : undefined;
-    // ✅ 并行签名所有交易（贿赂、买入、利润）
-    const signPromises = [];
-    // 贿赂交易
-    if (needBribeTx && bribeNonce !== undefined) {
-        signPromises.push(wallet.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: CHAIN_ID,
-            type: txType,
-        }));
-    }
-    // 买入交易
-    signPromises.push(wallet.signTransaction({
-        ...unsigned,
-        from: wallet.address,
-        nonce: buyNonce,
-        gasLimit,
-        gasPrice,
-        chainId: CHAIN_ID,
-        type: txType,
-        value: actualFundsWei,
-    }));
-    // ✅ 并行签名完成后按顺序返回
-    const signedTxs = await Promise.all(signPromises);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    let profitHopWallets;
-    if (needProfitTx && profitNonce !== undefined) {
-        const profitHopResult = await buildProfitHopTransactions({
-            provider,
-            payerWallet: wallet,
-            profitAmount: profitWei,
-            profitRecipient: getProfitRecipient(),
-            hopCount: PROFIT_HOP_COUNT,
-            gasPrice,
-            chainId: CHAIN_ID,
-            txType,
-            startNonce: profitNonce,
-        });
-        signedTxs.push(...profitHopResult.signedTransactions);
-        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-    }
-    return {
-        signedTransactions: signedTxs,
-        profitHopWallets, // ✅ 返回利润多跳钱包
-    };
-}
-/**
- * 私有卖出（单笔）（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 自动检查授权，智能处理授权+卖出
- * ✅ 优化：并行获取 gasPrice、allowance、nonce
- */
-export async function fourPrivateSellMerkle(params) {
-    const { privateKey, tokenAddress, amount, minFunds, config } = params;
-    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
-    const provider = createSignProvider(config.rpcUrl, CHAIN_ID, 'BSC');
-    const wallet = new Wallet(privateKey, provider);
-    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
-    const txType = getTxType(config);
-    const sellGasLimit = getGasLimit(config);
-    const amountWei = ethers.parseUnits(amount, 18);
-    const minOut = minFunds ?? 0n;
-    const tm2 = new ethers.Contract(tmAddr, TM2_ABI, wallet);
-    // ✅ 优化：并行获取 gasPrice、nonce 和构建未签名交易（已移除授权检查）
-    const [gasPrice, sellNonce, sellUnsigned] = await Promise.all([
-        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-        wallet.getNonce(),
-        tm2.sellToken.populateTransaction(0n, tokenAddress, amountWei, 0n), // ✅ 已移除滑点保护：minOut 固定为 0
-    ]);
-    // ✅ 已移除授权检查（前端负责确保授权）
-    // ✅ 利润计算（同步）
-    const extractProfit = shouldExtractProfit();
-    const { profit } = extractProfit ? calculateProfit(minOut) : { profit: 0n };
-    // ✅ 获取贿赂金额
-    const bribeAmount = getBribeAmount(config);
-    const needBribeTx = bribeAmount > 0n;
-    const needProfitTx = extractProfit && profit > 0n;
-    // ✅ 分配 nonces：贿赂 → 卖出 → 利润
-    let nonceIdx = 0;
-    const bribeNonce = needBribeTx ? sellNonce + nonceIdx++ : undefined;
-    const actualSellNonce = sellNonce + nonceIdx++;
-    const profitNonce = needProfitTx ? sellNonce + nonceIdx : undefined;
-    // ✅ 并行签名所有交易（贿赂、卖出、利润）
-    const signPromises = [];
-    // 贿赂交易
-    if (needBribeTx && bribeNonce !== undefined) {
-        signPromises.push(wallet.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: CHAIN_ID,
-            type: txType,
-        }));
-    }
-    // 卖出交易
-    signPromises.push(wallet.signTransaction({
-        ...sellUnsigned,
-        from: wallet.address,
-        nonce: actualSellNonce,
-        gasLimit: sellGasLimit,
-        gasPrice,
-        chainId: CHAIN_ID,
-        type: txType,
-        value: 0n,
-    }));
-    // ✅ 并行签名完成后按顺序返回
-    const signedTxs = await Promise.all(signPromises);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    let profitHopWallets;
-    if (needProfitTx && profitNonce !== undefined) {
-        const profitHopResult = await buildProfitHopTransactions({
-            provider,
-            payerWallet: wallet,
-            profitAmount: profit,
-            profitRecipient: getProfitRecipient(),
-            hopCount: PROFIT_HOP_COUNT,
-            gasPrice,
-            chainId: CHAIN_ID,
-            txType,
-            startNonce: profitNonce,
-        });
-        signedTxs.push(...profitHopResult.signedTransactions);
-        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-    }
-    return {
-        signedTransactions: signedTxs,
-        profitHopWallets, // ✅ 返回利润多跳钱包
-    };
-}
-/**
- * 批量私有购买（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化：并行获取 gasPrice 和 nonces，批量构建交易
- */
-export async function fourBatchPrivateBuyMerkle(params) {
-    const { privateKeys, fundsList, tokenAddress, config } = params;
-    if (privateKeys.length !== fundsList.length) {
-        throw new Error('privateKeys and fundsList length mismatch');
-    }
-    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
-    const provider = createSignProvider(config.rpcUrl, CHAIN_ID, 'BSC');
-    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
-    const txType = getTxType(config);
-    const finalGasLimit = getGasLimit(config);
-    const wallets = privateKeys.map((k) => new Wallet(k, provider));
-    const originalAmountsWei = fundsList.map((a) => ethers.parseEther(a));
-    // ✅ 利润提取配置（同步计算）
-    const extractProfit = shouldExtractProfit();
-    const { totalProfit, remainingAmounts } = calculateBatchProfit(originalAmountsWei);
-    const actualAmountsWei = remainingAmounts;
-    // ✅ 获取贿赂金额
-    const bribeAmount = getBribeAmount(config);
-    const needBribeTx = bribeAmount > 0n;
-    // ✅ 找出投入金额最多的钱包（作为贿赂和利润支付者）- 同步计算
-    let maxFundsIndex = 0;
-    let maxFunds = originalAmountsWei[0];
-    for (let i = 1; i < originalAmountsWei.length; i++) {
-        if (originalAmountsWei[i] > maxFunds) {
-            maxFunds = originalAmountsWei[i];
-            maxFundsIndex = i;
-        }
-    }
-    const tm2Contracts = wallets.map((w) => new ethers.Contract(tmAddr, TM2_ABI, w));
-    const nonceManager = new NonceManager(provider);
-    const needProfitTx = extractProfit && totalProfit > 0n;
-    // ✅ 计算 payer 需要的 nonce 数量：贿赂(可选) + 买入 + 利润(可选)
-    const payerNonceCount = 1 + (needBribeTx ? 1 : 0) + (needProfitTx ? 1 : 0);
-    // ✅ 优化：并行获取 gasPrice、nonces 和构建未签名交易
-    const [gasPrice, unsignedList, noncesResult] = await Promise.all([
-        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-        Promise.all(tm2Contracts.map((c, i) => c.buyTokenAMAP.populateTransaction(0n, tokenAddress, wallets[i].address, actualAmountsWei[i], 0n, {
-            value: actualAmountsWei[i],
-        }))),
-        (async () => {
-            if (payerNonceCount > 1) {
-                // payer 需要多个连续 nonce
-                const payerNonces = await nonceManager.getNextNonceBatch(wallets[maxFundsIndex], payerNonceCount);
-                // 其他钱包各需要 1 个 nonce
-                const otherWallets = wallets.filter((_, i) => i !== maxFundsIndex);
-                const otherNonces = otherWallets.length > 0 ? await nonceManager.getNextNoncesForWallets(otherWallets) : [];
-                // 组装最终的 nonces 数组（保持原顺序）
-                const nonces = [];
-                let otherIdx = 0;
-                let nonceIdx = 0;
-                const bribeNonce = needBribeTx ? payerNonces[nonceIdx++] : undefined;
-                for (let i = 0; i < wallets.length; i++) {
-                    if (i === maxFundsIndex) {
-                        nonces.push(payerNonces[nonceIdx++]); // 买入交易
-                    }
-                    else {
-                        nonces.push(otherNonces[otherIdx++]);
-                    }
-                }
-                const profitNonce = needProfitTx ? payerNonces[nonceIdx] : undefined;
-                return { nonces, bribeNonce, profitNonce };
-            }
-            else {
-                // 所有钱包各 1 个 nonce
-                const nonces = await nonceManager.getNextNoncesForWallets(wallets);
-                return { nonces, bribeNonce: undefined, profitNonce: undefined };
-            }
-        })(),
-    ]);
-    const { nonces, bribeNonce, profitNonce } = noncesResult;
-    // ✅ 贿赂交易放在首位（提高 BlockRazor 打包优先级）
-    const signedTxs = [];
-    if (needBribeTx && bribeNonce !== undefined) {
-        const bribeTx = await wallets[maxFundsIndex].signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: CHAIN_ID,
-            type: txType,
-        });
-        signedTxs.push(bribeTx);
-    }
-    // ✅ 并行签名所有买入交易
-    const signedList = await Promise.all(unsignedList.map((unsigned, i) => wallets[i].signTransaction({
-        ...unsigned,
-        from: wallets[i].address,
-        nonce: nonces[i],
-        gasLimit: finalGasLimit,
-        gasPrice,
-        chainId: CHAIN_ID,
-        type: txType,
-        value: actualAmountsWei[i],
-    })));
-    signedTxs.push(...signedList);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    let profitHopWallets;
-    if (needProfitTx && profitNonce !== undefined) {
-        const profitHopResult = await buildProfitHopTransactions({
-            provider,
-            payerWallet: wallets[maxFundsIndex],
-            profitAmount: totalProfit,
-            profitRecipient: getProfitRecipient(),
-            hopCount: PROFIT_HOP_COUNT,
-            gasPrice,
-            chainId: CHAIN_ID,
-            txType,
-            startNonce: profitNonce,
-        });
-        signedTxs.push(...profitHopResult.signedTransactions);
-        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-    }
-    nonceManager.clearTemp();
-    return {
-        signedTransactions: signedTxs,
-        profitHopWallets, // ✅ 返回利润多跳钱包
-    };
-}
-/**
- * 批量私有卖出（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 自动包含授权交易，无需前端单独调用
- * ✅ 优化：并行获取所有查询数据，批量获取 nonces
- */
-export async function fourBatchPrivateSellMerkle(params) {
-    const { privateKeys, amounts, tokenAddress, config, minFundsEach } = params;
-    if (privateKeys.length !== amounts.length) {
-        throw new Error('privateKeys and amounts length mismatch');
-    }
-    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
-    const provider = createSignProvider(config.rpcUrl, CHAIN_ID, 'BSC');
-    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
-    const txType = getTxType(config);
-    const sellGasLimit = getGasLimit(config);
-    const wallets = privateKeys.map((k) => new Wallet(k, provider));
-    const amountsWei = amounts.map((a) => ethers.parseUnits(a, 18));
-    const rpcUrl = config.rpcUrl;
-    // ✅ 优化：并行获取 gasPrice 和 quotedOutputs（已移除授权和余额检查）
-    const [gasPrice, quotedOutputs] = await Promise.all([
-        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-        // 获取预期收益（用于计算利润）
-        minFundsEach !== undefined
-            ? Promise.resolve((() => {
-                const minOutWei = typeof minFundsEach === 'string' ? ethers.parseEther(minFundsEach) : minFundsEach;
-                return new Array(wallets.length).fill((minOutWei * 100n) / 95n);
-            })())
-            : Promise.all(amountsWei.map(async (amount) => {
-                try {
-                    const result = await trySell('BSC', rpcUrl, tokenAddress, amount);
-                    return result.funds;
-                }
-                catch {
-                    return 0n;
-                }
-            })),
-    ]);
-    // ✅ 已移除滑点保护：minOuts 固定为 0
-    const minOuts = new Array(wallets.length).fill(0n);
-    // ✅ 计算总利润和找出收益最高的钱包（同步计算）
-    const extractProfit = shouldExtractProfit();
-    let totalProfit = 0n;
-    let maxRevenueIndex = 0;
-    let maxRevenue = 0n;
-    if (extractProfit) {
-        for (let i = 0; i < wallets.length; i++) {
-            if (quotedOutputs[i] > 0n) {
-                const { profit } = calculateProfit(quotedOutputs[i]);
-                totalProfit += profit;
-                if (quotedOutputs[i] > maxRevenue) {
-                    maxRevenue = quotedOutputs[i];
-                    maxRevenueIndex = i;
-                }
-            }
-        }
-    }
-    // ✅ 获取贿赂金额
-    const bribeAmount = getBribeAmount(config);
-    const needBribeTx = bribeAmount > 0n;
-    const tm2Contracts = wallets.map((w) => new ethers.Contract(tmAddr, TM2_ABI, w));
-    const nonceManager = new NonceManager(provider);
-    const needProfitTx = extractProfit && totalProfit > 0n;
-    // ✅ 计算 payer 需要的 nonce 数量：贿赂(可选) + 卖出 + 利润(可选)
-    const payerNonceCount = 1 + (needBribeTx ? 1 : 0) + (needProfitTx ? 1 : 0);
-    // ✅ 优化：第二批并行获取 - nonces 和构建未签名交易
-    const [sellUnsigned, noncesResult] = await Promise.all([
-        Promise.all(tm2Contracts.map((c, i) => c.sellToken.populateTransaction(0n, tokenAddress, amountsWei[i], minOuts[i]))),
-        (async () => {
-            if (payerNonceCount > 1) {
-                // payer 需要多个连续 nonce
-                const payerNonces = await nonceManager.getNextNonceBatch(wallets[maxRevenueIndex], payerNonceCount);
-                // 其他钱包各需要 1 个 nonce
-                const otherWallets = wallets.filter((_, i) => i !== maxRevenueIndex);
-                const otherNonces = otherWallets.length > 0 ? await nonceManager.getNextNoncesForWallets(otherWallets) : [];
-                // 组装最终的 nonces 数组（保持原顺序）
-                const nonces = [];
-                let otherIdx = 0;
-                let nonceIdx = 0;
-                const bribeNonce = needBribeTx ? payerNonces[nonceIdx++] : undefined;
-                for (let i = 0; i < wallets.length; i++) {
-                    if (i === maxRevenueIndex) {
-                        nonces.push(payerNonces[nonceIdx++]); // 卖出交易
-                    }
-                    else {
-                        nonces.push(otherNonces[otherIdx++]);
-                    }
-                }
-                const profitNonce = needProfitTx ? payerNonces[nonceIdx] : undefined;
-                return { nonces, bribeNonce, profitNonce };
-            }
-            else {
-                // 所有钱包各 1 个 nonce
-                const nonces = await nonceManager.getNextNoncesForWallets(wallets);
-                return { nonces, bribeNonce: undefined, profitNonce: undefined };
-            }
-        })(),
-    ]);
-    const { nonces, bribeNonce, profitNonce } = noncesResult;
-    // ✅ 贿赂交易放在首位（提高 BlockRazor 打包优先级）
-    const signedTxs = [];
-    if (needBribeTx && bribeNonce !== undefined) {
-        const bribeTx = await wallets[maxRevenueIndex].signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: CHAIN_ID,
-            type: txType,
-        });
-        signedTxs.push(bribeTx);
-    }
-    // ✅ 并行签名所有卖出交易
-    const signedSells = await Promise.all(sellUnsigned.map((unsigned, i) => wallets[i].signTransaction({
-        ...unsigned,
-        from: wallets[i].address,
-        nonce: nonces[i],
-        gasLimit: sellGasLimit,
-        gasPrice,
-        chainId: CHAIN_ID,
-        type: txType,
-        value: 0n,
-    })));
-    signedTxs.push(...signedSells);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    let profitHopWallets;
-    if (needProfitTx && profitNonce !== undefined) {
-        const profitHopResult = await buildProfitHopTransactions({
-            provider,
-            payerWallet: wallets[maxRevenueIndex],
-            profitAmount: totalProfit,
-            profitRecipient: getProfitRecipient(),
-            hopCount: PROFIT_HOP_COUNT,
-            gasPrice,
-            chainId: CHAIN_ID,
-            txType,
-            startNonce: profitNonce,
-        });
-        signedTxs.push(...profitHopResult.signedTransactions);
-        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-    }
-    nonceManager.clearTemp();
-    return {
-        signedTransactions: signedTxs,
-        profitHopWallets, // ✅ 返回利润多跳钱包
-    };
-}
+export * from './private/index.js';

package/dist/bundle/four-meme/swap/batch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Four.meme 内盘批量换手（Merkle Bundle）— 一卖多买流程
+ */
+import type { FourBatchSwapResult, FourBatchSwapSignParams } from '../types/index.js';
+/**
+ * Four 内盘批量换手（一卖多买）
+ */
+export declare function fourBatchSwapMerkle(params: FourBatchSwapSignParams): Promise<FourBatchSwapResult>;

package/dist/bundle/four-meme/swap/batch.js

@@ -0,0 +1,170 @@
+/**
+ * Four.meme 内盘批量换手（Merkle Bundle）— 一卖多买流程
+ */
+import { ethers, Contract, Wallet } from 'ethers';
+import { countSellerNonceSlots, createFourSwapGasContext, fetchFourSwapSellQuoteAllowanceAndBalances, getFourSwapProfitRateBps, needsTmTokenApproval, planSellerNonces, signTmMaxApprovalTx, } from '../swap-sign-helpers.js';
+import { signBribeTransaction } from '../../../core/sign-context-helpers.js';
+import { calculateSellAmount } from '../../../utils/swap-helpers.js';
+import { NonceManager, getOptimizedGasPrice, getGasPriceConfig, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
+import { getBribeAmount, getProfitRecipient } from '../../config-helpers.js';
+import { TM_ABI, TM_ADDRESS } from '../swap-internal.js';
+/**
+ * Four 内盘批量换手（一卖多买）
+ */
+export async function fourBatchSwapMerkle(params) {
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, startNonces, // ✅ 可选：前端预获取的 nonces
+     } = params;
+    // ✅ 校验买方数量（最多 24 个）
+    const MAX_BUYERS = 24;
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方钱包');
+    }
+    if (buyerPrivateKeys.length > MAX_BUYERS) {
+        throw new Error(`买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+    }
+    const { chainIdNum, provider, bundleConfig, finalGasLimit, txType } = createFourSwapGasContext(config);
+    const seller = new Wallet(sellerPrivateKey, provider);
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, provider));
+    const nonceManager = new NonceManager(provider);
+    // ✅ 并行获取：卖出数量、gasPrice
+    const [sellAmountResult, gasPrice] = await Promise.all([
+        calculateSellAmount(provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig)),
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    const { sellFunds: totalBuyerFunds, allowance: currentAllowance, buyerBalances, } = await fetchFourSwapSellQuoteAllowanceAndBalances(provider, tokenAddress, seller.address, sellAmountWei, buyers.map((b) => b.address));
+    // ✅ 计算每个买方的买入金额（按比例分配）
+    let buyAmountsWei;
+    if (params.buyerRatios && params.buyerRatios.length === buyers.length) {
+        // 按比例分配
+        buyAmountsWei = params.buyerRatios.map((ratio) => {
+            const amount = (totalBuyerFunds * BigInt(Math.round(ratio * 10000))) / 10000n;
+            return amount;
+        });
+    }
+    else {
+        // 平均分配
+        const amountPerBuyer = totalBuyerFunds / BigInt(buyers.length);
+        buyAmountsWei = buyers.map(() => amountPerBuyer);
+    }
+    // ✅ 验证所有买方余额
+    const reserveGas = ethers.parseEther((config.reserveGasBNB || 0.0005).toString());
+    buyers.forEach((buyer, i) => {
+        const required = buyAmountsWei[i] + reserveGas;
+        if (buyerBalances[i] < required) {
+            throw new Error(`买方 ${i + 1} 余额不足: 需要 ${ethers.formatEther(required)} BNB, 实际 ${ethers.formatEther(buyerBalances[i])} BNB`);
+        }
+    });
+    // 检查是否需要授权
+    const needApproval = needsTmTokenApproval(currentAllowance, decimals);
+    // 利润配置
+    const profitRateBps = getFourSwapProfitRateBps(config.userType);
+    const profitAmount = totalBuyerFunds > 0n ? (totalBuyerFunds * BigInt(profitRateBps)) / 10000n : 0n;
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 并行构建所有交易
+    const tmSeller = new Contract(TM_ADDRESS, TM_ABI, seller);
+    const [sellUnsigned, ...buyUnsignedList] = await Promise.all([
+        // 卖出交易
+        tmSeller.sellToken.populateTransaction(0n, tokenAddress, sellAmountWei, 0n),
+        // 所有买入交易
+        ...buyers.map((buyer, i) => {
+            const tmBuyer = new Contract(TM_ADDRESS, TM_ABI, buyer);
+            const buyAmount = buyAmountsWei[i];
+            return tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyAmount, 0n, {
+                value: buyAmount,
+            });
+        }),
+    ]);
+    const sellerNonceCount = countSellerNonceSlots(needBribeTx, needApproval, true);
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    // 否则从链上获取
+    const allWallets = [seller, ...buyers];
+    const initialNonces = startNonces && startNonces.length >= allWallets.length
+        ? startNonces
+        : await nonceManager.getNextNoncesForWallets(allWallets);
+    // 分配 seller nonces
+    const sellerNonces = Array.from({ length: sellerNonceCount }, (_, i) => initialNonces[0] + i);
+    const noncePlan = planSellerNonces(sellerNonces, needBribeTx, needApproval, true);
+    const profitNonce = noncePlan.profitNonce;
+    const buyerNonces = initialNonces.slice(1);
+    const signPromises = [];
+    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
+        signPromises.push(signBribeTransaction(seller, bribeAmount, noncePlan.bribeNonce, gasPrice, chainIdNum, txType));
+    }
+    if (needApproval && noncePlan.approvalNonce !== undefined) {
+        signPromises.push(signTmMaxApprovalTx(seller, tokenAddress, noncePlan.approvalNonce, gasPrice, chainIdNum, txType));
+    }
+    signPromises.push(seller.signTransaction({
+        ...sellUnsigned,
+        from: seller.address,
+        nonce: noncePlan.sellerNonce,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: chainIdNum,
+        type: txType,
+    }));
+    // 所有买入交易
+    buyers.forEach((buyer, i) => {
+        signPromises.push(buyer.signTransaction({
+            ...buyUnsignedList[i],
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: chainIdNum,
+            type: txType,
+            value: buyAmountsWei[i],
+        }));
+    });
+    const signedTxs = await Promise.all(signPromises);
+    // 解析签名结果
+    let signIdx = 0;
+    let bribeTx = null;
+    let approvalTx = null;
+    if (needBribeTx)
+        bribeTx = signedTxs[signIdx++];
+    if (needApproval)
+        approvalTx = signedTxs[signIdx++];
+    const signedSell = signedTxs[signIdx++];
+    const signedBuys = signedTxs.slice(signIdx, signIdx + buyers.length);
+    nonceManager.clearTemp();
+    // ✅ 按顺序组装交易数组：贿赂 → 授权 → 卖出 → 买入
+    const signedTransactions = [];
+    if (bribeTx)
+        signedTransactions.push(bribeTx);
+    if (approvalTx)
+        signedTransactions.push(approvalTx);
+    signedTransactions.push(signedSell);
+    signedTransactions.push(...signedBuys);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: seller,
+            profitAmount: profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: chainIdNum,
+            txType,
+            startNonce: profitNonce,
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return {
+        signedTransactions,
+        profitHopWallets, // ✅ 导出利润多跳钱包
+        metadata: {
+            sellerAddress: seller.address,
+            buyerAddresses: buyers.map((b) => b.address),
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            buyAmounts: buyAmountsWei.map((amt) => ethers.formatEther(amt)),
+            hasApproval: !!approvalTx,
+            profitAmount: ethers.formatEther(profitAmount),
+        },
+    };
+}

package/dist/bundle/four-meme/swap/bundle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Four.meme 内盘捆绑换手（Merkle Bundle）— 单卖单买流程
+ */
+import type { FourBundleSwapSignParams, FourSwapResult } from '../types/index.js';
+/**
+ * Four内盘捆绑换手
+ */
+export declare function fourBundleSwapMerkle(params: FourBundleSwapSignParams): Promise<FourSwapResult>;