four-flap-meme-sdk 1.4.78 → 1.4.79

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

@@ -18,10 +18,12 @@ export interface FourBuyFirstConfig extends CommonBundleConfig {
     waitTimeoutMs?: number;
 }
 export interface FourBundleBuyFirstSignParams {
-    buyerPrivateKey: string;
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
     buyerFunds?: string;
     buyerFundsPercentage?: number;
-    sellerPrivateKey: string;
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
     tokenAddress: string;
     config: FourBuyFirstSignConfig;
     buyCount?: number;

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

@@ -83,10 +83,26 @@ function splitAmount(totalAmount, count) {
     return amounts;
 }
 export async function fourBundleBuyFirstMerkle(params) {
-    const { buyerPrivateKey, buyerFunds, buyerFundsPercentage, sellerPrivateKey, tokenAddress, config, buyCount: _buyCount, sellCount: _sellCount } = params;
-    // ✅ 解析并验证买卖笔数
+    const { buyerPrivateKey, buyerPrivateKeys, buyerFunds, buyerFundsPercentage, sellerPrivateKey, sellerPrivateKeys, tokenAddress, config, buyCount: _buyCount, sellCount: _sellCount } = params;
+    // ✅ 判断是否为多钱包模式
+    const isMultiWalletMode = !!(buyerPrivateKeys && buyerPrivateKeys.length > 0) ||
+        !!(sellerPrivateKeys && sellerPrivateKeys.length > 0);
     const buyCount = _buyCount ?? 1;
     const sellCount = _sellCount ?? 1;
+    // ✅ 多钱包模式：使用单独的处理逻辑
+    if (isMultiWalletMode) {
+        return await fourBundleBuyFirstMultiWallet({
+            buyerPrivateKeys: buyerPrivateKeys || (buyerPrivateKey ? [buyerPrivateKey] : []),
+            sellerPrivateKeys: sellerPrivateKeys || (sellerPrivateKey ? [sellerPrivateKey] : []),
+            tokenAddress,
+            buyerFunds,
+            config
+        });
+    }
+    // ✅ 单钱包模式（向后兼容）
+    if (!buyerPrivateKey || !sellerPrivateKey) {
+        throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
+    }
     validateSwapCounts(buyCount, sellCount);
     // ✅ 计算利润比例：每笔万分之3
     const totalTxCount = buyCount + sellCount;
@@ -292,3 +308,176 @@ async function planMultiNonces({ buyer, seller, buyCount, sellCount, extractProf
     const profitNonce = extractProfit ? sellerNoncesAll[idx] : undefined;
     return { buyerNonces, sellerNonces, bribeNonce, profitNonce };
 }
+/**
+ * ✅ Four 多钱包捆绑换手
+ * - 多个买方钱包执行买入（每个钱包1笔）
+ * - 多个卖方钱包执行卖出（每个钱包1笔）
+ * - 买入总价值 = 卖出总价值
+ */
+async function fourBundleBuyFirstMultiWallet(params) {
+    const { buyerPrivateKeys, sellerPrivateKeys, tokenAddress, buyerFunds, config } = params;
+    const buyCount = buyerPrivateKeys.length;
+    const sellCount = sellerPrivateKeys.length;
+    if (buyCount === 0)
+        throw new Error('买方钱包数量不能为0');
+    if (sellCount === 0)
+        throw new Error('卖方钱包数量不能为0');
+    // 验证总交易数不超过限制
+    validateSwapCounts(buyCount, sellCount);
+    // ✅ 计算利润比例：每笔万分之6
+    const totalTxCount = buyCount + sellCount;
+    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const chainIdNum = config.chainId ?? 56;
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId: chainIdNum,
+        name: 'BSC'
+    });
+    const nonceManager = new NonceManager(provider);
+    // 创建所有钱包实例
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, provider));
+    const sellers = sellerPrivateKeys.map(pk => new Wallet(pk, provider));
+    // 使用第一个卖方作为主卖方（支付贿赂和利润）
+    const mainSeller = sellers[0];
+    // ✅ 计算总交易金额
+    if (!buyerFunds) {
+        throw new Error('多钱包模式必须提供 buyerFunds（总交易金额）');
+    }
+    const totalFundsWei = ethers.parseEther(String(buyerFunds));
+    if (totalFundsWei <= 0n) {
+        throw new Error('交易金额必须大于0');
+    }
+    // ✅ 获取报价：买入能获得多少代币
+    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
+    const buyQuote = await helper3.tryBuy(tokenAddress, 0n, totalFundsWei);
+    const estimatedTokenAmount = buyQuote.estimatedAmount ?? buyQuote[2];
+    if (!estimatedTokenAmount || estimatedTokenAmount <= 0n) {
+        throw new Error('报价失败：无法估算可买入的代币数量');
+    }
+    // ✅ 将总金额平均分配给买方
+    const buyAmountsWei = splitAmount(totalFundsWei, buyCount);
+    // ✅ 将代币平均分配给卖方
+    const sellAmountsWei = splitAmount(estimatedTokenAmount, sellCount);
+    const finalGasLimit = getGasLimit(config);
+    const gasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));
+    const txType = getTxType(config);
+    // ✅ 估算利润
+    const sellResult = await trySell('BSC', config.rpcUrl, tokenAddress, estimatedTokenAmount);
+    const estimatedSellFunds = sellResult.funds;
+    const profitAmount = (estimatedSellFunds * BigInt(profitRateBps)) / 10000n;
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 获取所有钱包的 nonces
+    const noncesMap = new Map();
+    await Promise.all([...sellers, ...buyers].map(async (wallet) => {
+        const addr = wallet.address.toLowerCase();
+        if (!noncesMap.has(addr)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            noncesMap.set(addr, nonce);
+        }
+    }));
+    // ✅ 构建交易列表
+    const allTransactions = [];
+    // 1. 贿赂交易（由主卖方支付）
+    if (needBribeTx) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const bribeNonce = noncesMap.get(mainSellerAddr);
+        noncesMap.set(mainSellerAddr, bribeNonce + 1);
+        const bribeTx = await mainSeller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainIdNum,
+            type: txType
+        });
+        allTransactions.push(bribeTx);
+    }
+    // 2. 构建所有买入交易
+    const tm = new Contract(TM_ADDRESS, TM_ABI, provider);
+    const buyTxPromises = buyers.map(async (buyer, i) => {
+        const buyAmount = buyAmountsWei[i];
+        const buyerAddr = buyer.address.toLowerCase();
+        const nonce = noncesMap.get(buyerAddr);
+        noncesMap.set(buyerAddr, nonce + 1);
+        const tmBuyer = tm.connect(buyer);
+        const unsigned = await tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyAmount, 0n, { value: buyAmount });
+        return buyer.signTransaction({
+            ...unsigned,
+            from: buyer.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: chainIdNum,
+            type: txType,
+            value: buyAmount
+        });
+    });
+    // 3. 构建所有卖出交易
+    const sellTxPromises = sellers.map(async (seller, i) => {
+        const sellAmount = sellAmountsWei[i];
+        const sellerAddr = seller.address.toLowerCase();
+        const nonce = noncesMap.get(sellerAddr);
+        noncesMap.set(sellerAddr, nonce + 1);
+        const tmSeller = tm.connect(seller);
+        const unsigned = await tmSeller.sellToken.populateTransaction(0n, tokenAddress, sellAmount, 0n);
+        return seller.signTransaction({
+            ...unsigned,
+            from: seller.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: chainIdNum,
+            type: txType,
+            value: 0n
+        });
+    });
+    // ✅ 并行签名所有买卖交易
+    const [signedBuys, signedSells] = await Promise.all([
+        Promise.all(buyTxPromises),
+        Promise.all(sellTxPromises)
+    ]);
+    // 先买后卖：买入交易在前
+    allTransactions.push(...signedBuys, ...signedSells);
+    // 4. 利润多跳转账（由主卖方支付）
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const profitNonce = noncesMap.get(mainSellerAddr);
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: mainSeller,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: chainIdNum,
+            txType,
+            startNonce: profitNonce
+        });
+        allTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets;
+    }
+    nonceManager.clearTemp();
+    // 获取代币精度用于显示
+    const erc20 = new Contract(tokenAddress, [
+        'function decimals() view returns (uint8)'
+    ], provider);
+    const decimals = await erc20.decimals();
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets,
+        metadata: {
+            buyerAddress: buyers.map(b => b.address).join(','),
+            sellerAddress: sellers.map(s => s.address).join(','),
+            buyAmount: ethers.formatEther(totalFundsWei),
+            sellAmount: ethers.formatUnits(estimatedTokenAmount, decimals),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+            buyCount,
+            sellCount,
+            buyAmounts: buyAmountsWei.map(amt => ethers.formatEther(amt)),
+            sellAmounts: sellAmountsWei.map(amt => ethers.formatUnits(amt, decimals))
+        }
+    };
+}

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

@@ -22,8 +22,10 @@ export interface FlapBuyFirstConfig extends CommonBundleConfig {
 }
 export interface FlapBundleBuyFirstSignParams {
     chain: FlapChain;
-    buyerPrivateKey: string;
-    sellerPrivateKey: string;
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
     tokenAddress: string;
     buyerFunds?: string;
     buyerFundsPercentage?: number;

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

@@ -100,10 +100,29 @@ function getNativeTokenName(chain) {
 }
 // 使用公共工具的 getGasLimit，移除本地重复实现
 export async function flapBundleBuyFirstMerkle(params) {
-    const { chain, buyerPrivateKey, sellerPrivateKey, tokenAddress, buyerFunds, buyerFundsPercentage, config, quoteToken, quoteTokenDecimals, buyCount: _buyCount, sellCount: _sellCount } = params;
-    // ✅ 解析并验证买卖笔数
+    const { chain, buyerPrivateKey, buyerPrivateKeys, sellerPrivateKey, sellerPrivateKeys, tokenAddress, buyerFunds, buyerFundsPercentage, config, quoteToken, quoteTokenDecimals, buyCount: _buyCount, sellCount: _sellCount } = params;
+    // ✅ 判断是否为多钱包模式
+    const isMultiWalletMode = !!(buyerPrivateKeys && buyerPrivateKeys.length > 0) ||
+        !!(sellerPrivateKeys && sellerPrivateKeys.length > 0);
     const buyCount = _buyCount ?? 1;
     const sellCount = _sellCount ?? 1;
+    // ✅ 多钱包模式：使用单独的处理逻辑
+    if (isMultiWalletMode) {
+        return await flapBundleBuyFirstMultiWallet({
+            chain,
+            buyerPrivateKeys: buyerPrivateKeys || (buyerPrivateKey ? [buyerPrivateKey] : []),
+            sellerPrivateKeys: sellerPrivateKeys || (sellerPrivateKey ? [sellerPrivateKey] : []),
+            tokenAddress,
+            buyerFunds,
+            config,
+            quoteToken,
+            quoteTokenDecimals
+        });
+    }
+    // ✅ 单钱包模式（向后兼容）
+    if (!buyerPrivateKey || !sellerPrivateKey) {
+        throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
+    }
     validateSwapCounts(buyCount, sellCount);
     // ✅ 计算利润比例：每笔万分之3
     const totalTxCount = buyCount + sellCount;
@@ -585,3 +604,201 @@ function createChainContext(chain, rpcUrl) {
     }
     return { chainId, nativeToken, portalAddress, provider };
 }
+/**
+ * ✅ Flap 多钱包捆绑换手
+ * - 多个买方钱包执行买入（每个钱包1笔）
+ * - 多个卖方钱包执行卖出（每个钱包1笔）
+ * - 买入总价值 = 卖出总价值
+ */
+async function flapBundleBuyFirstMultiWallet(params) {
+    const { chain, buyerPrivateKeys, sellerPrivateKeys, tokenAddress, buyerFunds, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const buyCount = buyerPrivateKeys.length;
+    const sellCount = sellerPrivateKeys.length;
+    if (buyCount === 0)
+        throw new Error('买方钱包数量不能为0');
+    if (sellCount === 0)
+        throw new Error('卖方钱包数量不能为0');
+    // 验证总交易数不超过限制
+    validateSwapCounts(buyCount, sellCount);
+    // ✅ 计算利润比例：每笔万分之6
+    const totalTxCount = buyCount + sellCount;
+    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const chainContext = createChainContext(chain, config.rpcUrl);
+    const nonceManager = new NonceManager(chainContext.provider);
+    // 创建所有钱包实例
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
+    const sellers = sellerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
+    // 使用第一个卖方作为主卖方（支付贿赂和利润）
+    const mainSeller = sellers[0];
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const inputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    const outputToken = inputToken;
+    // ✅ 计算总交易金额
+    if (!buyerFunds) {
+        throw new Error('多钱包模式必须提供 buyerFunds（总交易金额）');
+    }
+    const totalFundsWei = useNativeToken
+        ? ethers.parseEther(String(buyerFunds))
+        : ethers.parseUnits(String(buyerFunds), quoteTokenDecimals);
+    if (totalFundsWei <= 0n) {
+        throw new Error('交易金额必须大于0');
+    }
+    // ✅ 获取报价：买入能获得多少代币
+    const quoteResult = await quoteBuyerOutput({
+        portalAddress: chainContext.portalAddress,
+        tokenAddress,
+        buyerFundsWei: totalFundsWei,
+        provider: chainContext.provider,
+        skipQuoteOnError: config.skipQuoteOnError,
+        inputToken
+    });
+    // ✅ 将总金额平均分配给买方
+    const buyAmountsWei = splitAmount(totalFundsWei, buyCount);
+    // ✅ 将代币平均分配给卖方
+    const sellAmountsWei = splitAmount(quoteResult.sellAmountWei, sellCount);
+    const finalGasLimit = getGasLimit(config);
+    const gasPrice = await getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config));
+    const txType = getTxType(config);
+    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+    // ✅ 估算利润
+    const portal = new Contract(chainContext.portalAddress, PORTAL_ABI, chainContext.provider);
+    const estimatedSellFunds = await estimateSellFunds(portal, tokenAddress, quoteResult.sellAmountWei, outputToken);
+    const profitBase = estimatedSellFunds > 0n ? estimatedSellFunds : totalFundsWei;
+    const tokenProfitAmount = (profitBase * BigInt(profitRateBps)) / 10000n;
+    // ERC20 购买：获取代币利润等值的原生代币报价
+    let nativeProfitAmount = tokenProfitAmount;
+    if (!useNativeToken && tokenProfitAmount > 0n) {
+        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, inputToken, tokenProfitAmount, chainContext.chainId);
+    }
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 获取所有钱包的 nonces
+    const noncesMap = new Map();
+    await Promise.all([...sellers, ...buyers].map(async (wallet) => {
+        const addr = wallet.address.toLowerCase();
+        if (!noncesMap.has(addr)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            noncesMap.set(addr, nonce);
+        }
+    }));
+    // ✅ 构建交易列表
+    const allTransactions = [];
+    // 1. 贿赂交易（由主卖方支付）
+    if (needBribeTx) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const bribeNonce = noncesMap.get(mainSellerAddr);
+        noncesMap.set(mainSellerAddr, bribeNonce + 1);
+        const bribeTx = await mainSeller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: chainContext.chainId,
+            type: txType
+        });
+        allTransactions.push(bribeTx);
+    }
+    // 2. 构建所有买入交易
+    const buyTxPromises = buyers.map(async (buyer, i) => {
+        const buyAmount = buyAmountsWei[i];
+        const buyerAddr = buyer.address.toLowerCase();
+        const nonce = noncesMap.get(buyerAddr);
+        noncesMap.set(buyerAddr, nonce + 1);
+        const portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);
+        const unsigned = await portalBuyer.swapExactInput.populateTransaction({
+            inputToken,
+            outputToken: tokenAddress,
+            inputAmount: buyAmount,
+            minOutputAmount: 0n,
+            permitData: '0x'
+        }, useNativeToken ? { value: buyAmount } : {});
+        return buyer.signTransaction(buildTransactionRequest(unsigned, {
+            from: buyer.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            gasPrice,
+            priorityFee,
+            chainId: chainContext.chainId,
+            txType,
+            value: useNativeToken ? buyAmount : 0n
+        }));
+    });
+    // 3. 构建所有卖出交易
+    const sellTxPromises = sellers.map(async (seller, i) => {
+        const sellAmount = sellAmountsWei[i];
+        const sellerAddr = seller.address.toLowerCase();
+        const nonce = noncesMap.get(sellerAddr);
+        noncesMap.set(sellerAddr, nonce + 1);
+        const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
+        const unsigned = await portalSeller.swapExactInput.populateTransaction({
+            inputToken: tokenAddress,
+            outputToken,
+            inputAmount: sellAmount,
+            minOutputAmount: 0n,
+            permitData: '0x'
+        });
+        return seller.signTransaction(buildTransactionRequest(unsigned, {
+            from: seller.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            gasPrice,
+            priorityFee,
+            chainId: chainContext.chainId,
+            txType,
+            value: 0n
+        }));
+    });
+    // ✅ 并行签名所有买卖交易
+    const [signedBuys, signedSells] = await Promise.all([
+        Promise.all(buyTxPromises),
+        Promise.all(sellTxPromises)
+    ]);
+    // 先买后卖：买入交易在前
+    allTransactions.push(...signedBuys, ...signedSells);
+    // 4. 利润多跳转账（由主卖方支付）
+    let profitHopWallets;
+    if (nativeProfitAmount > 0n) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const profitNonce = noncesMap.get(mainSellerAddr);
+        const profitResult = await buildProfitTransaction({
+            provider: chainContext.provider,
+            seller: mainSeller,
+            profitAmount: nativeProfitAmount,
+            profitNonce,
+            gasPrice,
+            chainId: chainContext.chainId,
+            txType
+        });
+        if (profitResult) {
+            allTransactions.push(...profitResult.signedTransactions);
+            profitHopWallets = profitResult.hopWallets;
+        }
+    }
+    nonceManager.clearTemp();
+    // 获取代币精度
+    const sellerInfo = await ensureSellerBalance({
+        tokenAddress,
+        provider: chainContext.provider,
+        seller: mainSeller,
+        sellAmountWei: 0n,
+        skipBalanceCheck: true
+    });
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets,
+        metadata: {
+            buyerAddress: buyers.map(b => b.address).join(','),
+            sellerAddress: sellers.map(s => s.address).join(','),
+            buyAmount: ethers.formatEther(totalFundsWei),
+            sellAmount: ethers.formatUnits(quoteResult.sellAmountWei, sellerInfo.decimals),
+            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined,
+            buyCount,
+            sellCount,
+            buyAmounts: buyAmountsWei.map(amt => ethers.formatEther(amt)),
+            sellAmounts: sellAmountsWei.map(amt => ethers.formatUnits(amt, sellerInfo.decimals))
+        }
+    };
+}

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

@@ -45,8 +45,10 @@ export interface PancakeBuyFirstConfig extends CommonBundleConfig {
     waitTimeoutMs?: number;
 }
 export interface PancakeBundleBuyFirstSignParams {
-    buyerPrivateKey: string;
-    sellerPrivateKey: string;
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
     tokenAddress: string;
     routeParams: RouteParams;
     buyerFunds?: string;

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

@@ -109,11 +109,32 @@ function splitAmount(totalAmount, count) {
     return amounts;
 }
 export async function pancakeBundleBuyFirstMerkle(params) {
-    const { buyerPrivateKey, sellerPrivateKey, tokenAddress, routeParams, buyerFunds, buyerFundsPercentage, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
+    const { buyerPrivateKey, buyerPrivateKeys, sellerPrivateKey, sellerPrivateKeys, tokenAddress, routeParams, buyerFunds, buyerFundsPercentage, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
     buyCount: _buyCount, sellCount: _sellCount } = params;
-    // ✅ 解析并验证买卖笔数
+    // ✅ 判断是否为多钱包模式
+    const isMultiWalletMode = !!(buyerPrivateKeys && buyerPrivateKeys.length > 0) ||
+        !!(sellerPrivateKeys && sellerPrivateKeys.length > 0);
+    // ✅ 多钱包模式：buyCount/sellCount 代表钱包数量
+    // 单钱包模式（向后兼容）：buyCount/sellCount 代表同一钱包执行的交易笔数
     const buyCount = _buyCount ?? 1;
     const sellCount = _sellCount ?? 1;
+    // ✅ 多钱包模式：使用单独的处理逻辑
+    if (isMultiWalletMode) {
+        return await pancakeBundleBuyFirstMultiWallet({
+            buyerPrivateKeys: buyerPrivateKeys || (buyerPrivateKey ? [buyerPrivateKey] : []),
+            sellerPrivateKeys: sellerPrivateKeys || (sellerPrivateKey ? [sellerPrivateKey] : []),
+            tokenAddress,
+            routeParams,
+            buyerFunds,
+            config,
+            quoteToken,
+            quoteTokenDecimals
+        });
+    }
+    // ✅ 单钱包模式（向后兼容）：验证买卖笔数
+    if (!buyerPrivateKey || !sellerPrivateKey) {
+        throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
+    }
     validateSwapCounts(buyCount, sellCount);
     // ✅ 计算利润比例：每笔万分之3
     const totalTxCount = buyCount + sellCount;
@@ -728,3 +749,270 @@ function buildNoncePlanFromStartNonces(startNonces, sameAddress, profitNeeded, n
     const buyerNonce = startNonces[1];
     return { buyerNonce, sellerNonce, bribeNonce, profitNonce };
 }
+/**
+ * ✅ 多钱包捆绑换手
+ * - 多个买方钱包执行买入（每个钱包1笔）
+ * - 多个卖方钱包执行卖出（每个钱包1笔）
+ * - 买入总价值 = 卖出总价值
+ */
+async function pancakeBundleBuyFirstMultiWallet(params) {
+    const { buyerPrivateKeys, sellerPrivateKeys, tokenAddress, routeParams, buyerFunds, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const buyCount = buyerPrivateKeys.length;
+    const sellCount = sellerPrivateKeys.length;
+    if (buyCount === 0)
+        throw new Error('买方钱包数量不能为0');
+    if (sellCount === 0)
+        throw new Error('卖方钱包数量不能为0');
+    // 验证总交易数不超过限制
+    validateSwapCounts(buyCount, sellCount);
+    // ✅ 计算利润比例：每笔万分之6
+    const totalTxCount = buyCount + sellCount;
+    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const context = createPancakeContext(config);
+    const nonceManager = new NonceManager(context.provider);
+    // 创建所有钱包实例
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    const sellers = sellerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    // 使用第一个卖方作为主卖方（支付贿赂和利润）
+    const mainSeller = sellers[0];
+    // ✅ 计算总交易金额
+    let totalFundsWei;
+    if (buyerFunds) {
+        totalFundsWei = useNativeToken
+            ? ethers.parseEther(String(buyerFunds))
+            : ethers.parseUnits(String(buyerFunds), quoteTokenDecimals);
+    }
+    else {
+        throw new Error('多钱包模式必须提供 buyerFunds（总交易金额）');
+    }
+    if (totalFundsWei <= 0n) {
+        throw new Error('交易金额必须大于0');
+    }
+    // ✅ 获取报价：买入能获得多少代币
+    const quoteResult = await quoteTokenOutput({
+        routeParams,
+        buyerFundsWei: totalFundsWei,
+        provider: context.provider
+    });
+    // ✅ 将总金额平均分配给买方
+    const buyAmountsWei = splitAmount(totalFundsWei, buyCount);
+    // ✅ 将代币平均分配给卖方
+    const sellAmountsWei = splitAmount(quoteResult.quotedTokenOut, sellCount);
+    const finalGasLimit = getGasLimit(config);
+    const gasPrice = await getGasPrice(context.provider, config);
+    const txType = config.txType ?? 0;
+    const deadline = BigInt(getDeadline());
+    // ✅ 估算利润
+    const estimatedProfitFromSell = await estimateProfitAmount({
+        provider: context.provider,
+        tokenAddress,
+        sellAmountToken: quoteResult.quotedTokenOut,
+        routeParams
+    });
+    const profitBase = estimatedProfitFromSell > 0n ? estimatedProfitFromSell : totalFundsWei;
+    const profitAmount = (profitBase * BigInt(profitRateBps)) / 10000n;
+    // ✅ 获取贿赂金额
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
+        ? ethers.parseEther(String(config.bribeAmount))
+        : 0n;
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 获取所有钱包的 nonces
+    const allWallets = [...sellers, ...buyers];
+    const noncesMap = new Map();
+    await Promise.all(allWallets.map(async (wallet) => {
+        const addr = wallet.address.toLowerCase();
+        if (!noncesMap.has(addr)) {
+            const nonce = await nonceManager.getNextNonce(wallet);
+            noncesMap.set(addr, nonce);
+        }
+    }));
+    // ✅ 构建交易列表
+    const allTransactions = [];
+    // 1. 贿赂交易（由主卖方支付）
+    if (needBribeTx) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const bribeNonce = noncesMap.get(mainSellerAddr);
+        noncesMap.set(mainSellerAddr, bribeNonce + 1);
+        const bribeTx = await mainSeller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: context.chainId,
+            type: txType
+        });
+        allTransactions.push(bribeTx);
+    }
+    // 2. 构建所有买入交易
+    const buyTxPromises = buyers.map(async (buyer, i) => {
+        const buyAmount = buyAmountsWei[i];
+        const buyerAddr = buyer.address.toLowerCase();
+        const nonce = noncesMap.get(buyerAddr);
+        noncesMap.set(buyerAddr, nonce + 1);
+        const unsigned = await buildSingleBuyTx({
+            routeParams,
+            buyAmount,
+            buyer,
+            tokenAddress,
+            useNativeToken,
+            deadline
+        });
+        return buyer.signTransaction({
+            ...unsigned,
+            from: buyer.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: context.chainId,
+            type: txType
+        });
+    });
+    // 3. 构建所有卖出交易
+    const sellTxPromises = sellers.map(async (seller, i) => {
+        const sellAmount = sellAmountsWei[i];
+        const sellerAddr = seller.address.toLowerCase();
+        const nonce = noncesMap.get(sellerAddr);
+        noncesMap.set(sellerAddr, nonce + 1);
+        const unsigned = await buildSingleSellTx({
+            routeParams,
+            sellAmount,
+            seller,
+            tokenAddress,
+            useNativeToken,
+            deadline
+        });
+        return seller.signTransaction({
+            ...unsigned,
+            from: seller.address,
+            nonce,
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: context.chainId,
+            type: txType
+        });
+    });
+    // ✅ 并行签名所有买卖交易
+    const [signedBuys, signedSells] = await Promise.all([
+        Promise.all(buyTxPromises),
+        Promise.all(sellTxPromises)
+    ]);
+    // 先买后卖：买入交易在前
+    allTransactions.push(...signedBuys, ...signedSells);
+    // 4. 利润多跳转账（由主卖方支付）
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const profitNonce = noncesMap.get(mainSellerAddr);
+        const profitResult = await buildProfitTransaction({
+            provider: context.provider,
+            seller: mainSeller,
+            profitAmount,
+            profitNonce,
+            gasPrice,
+            chainId: context.chainId,
+            txType
+        });
+        if (profitResult) {
+            allTransactions.push(...profitResult.signedTransactions);
+            profitHopWallets = profitResult.hopWallets;
+        }
+    }
+    nonceManager.clearTemp();
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets,
+        metadata: {
+            buyerAddress: buyers.map(b => b.address).join(','),
+            sellerAddress: sellers.map(s => s.address).join(','),
+            buyAmount: useNativeToken
+                ? ethers.formatEther(totalFundsWei)
+                : ethers.formatUnits(totalFundsWei, quoteTokenDecimals),
+            sellAmount: quoteResult.quotedTokenOut.toString(),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+            buyCount,
+            sellCount,
+            buyAmounts: buyAmountsWei.map(amt => useNativeToken
+                ? ethers.formatEther(amt)
+                : ethers.formatUnits(amt, quoteTokenDecimals)),
+            sellAmounts: sellAmountsWei.map(amt => amt.toString())
+        }
+    };
+}
+// ✅ 构建单笔买入交易
+async function buildSingleBuyTx({ routeParams, buyAmount, buyer, tokenAddress, useNativeToken, deadline }) {
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, buyer);
+        if (useNativeToken) {
+            return await v2Router.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, v2Path, buyer.address, deadline, { value: buyAmount });
+        }
+        else {
+            return await v2Router.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmount, 0n, v2Path, buyer.address, deadline);
+        }
+    }
+    if (routeParams.routeType === 'v3-single') {
+        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
+        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
+        const v3Router = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+        const buyValue = useNativeToken ? buyAmount : 0n;
+        const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: buyer.address,
+                amountIn: buyAmount,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        return await v3Router.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
+    }
+    throw new Error('V3 多跳路由暂不支持');
+}
+// ✅ 构建单笔卖出交易
+async function buildSingleSellTx({ routeParams, sellAmount, seller, tokenAddress, useNativeToken, deadline }) {
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const reversePath = [...v2Path].reverse();
+        const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, seller);
+        if (useNativeToken) {
+            return await v2Router.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmount, 0n, reversePath, seller.address, deadline);
+        }
+        else {
+            return await v2Router.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(sellAmount, 0n, reversePath, seller.address, deadline);
+        }
+    }
+    if (routeParams.routeType === 'v3-single') {
+        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
+        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
+        const v3Router = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        if (useNativeToken) {
+            const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                    tokenIn: v3TokenOut,
+                    tokenOut: v3TokenIn,
+                    fee: v3Fee,
+                    recipient: PANCAKE_V3_ROUTER_ADDRESS,
+                    amountIn: sellAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n
+                }]);
+            const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+            return await v3Router.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
+        }
+        else {
+            const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                    tokenIn: v3TokenOut,
+                    tokenOut: v3TokenIn,
+                    fee: v3Fee,
+                    recipient: seller.address,
+                    amountIn: sellAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n
+                }]);
+            return await v3Router.multicall.populateTransaction(deadline, [sellSwapData]);
+        }
+    }
+    throw new Error('V3 多跳路由暂不支持');
+}

package/package.json

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