four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/chains/bsc/pancake/swap-quick.js

@@ -0,0 +1,424 @@
+/**
+ * swap-quick - 快捷批量换手（资金自动流转）
+ */
+import { GAS_LIMITS, CHAINS, getProfitRecipient, ADDRESSES, BLOCKRAZOR_BUILDER_EOA } from '../../../core/constants/index.js';
+import { getGasLimit } from '../../../core/gas/bundle-gas.js';
+import { ethers, Contract, Wallet } from 'ethers';
+import { calculateSellAmount } from '../../../utils/swap-helpers.js';
+import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
+import { ERC20_ABI } from '../../../abis/common.js';
+import { BRIBE_GAS_LIMIT, FLAT_FEE, NATIVE_TRANSFER_GAS_LIMIT, PANCAKE_V2_ROUTER_ABI, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, PANCAKE_V3_ROUTER_ADDRESS, ZERO_ADDRESS, buildBNBHopChainForERC20, buildERC20HopChain, buildNativeHopChain, calculateProfitAmount, createPancakeContext, generateDisperseHopPaths, getERC20ToNativeQuote, getGasPrice, quoteSellOutput, } from './bundle-swap-helpers.js';
+/**
+ * PancakeSwap 快捷批量换手（资金自动流转）
+ *
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
+ *
+ * 特点：
+ * - 子钱包不需要预先有余额
+ * - 资金来自主钱包卖出代币所得
+ * - 提升资金利用率
+ * - 支持 BNB 和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
+ *
+ * 限制：根据多跳数动态计算最大买方数量
+ */
+export async function pancakeQuickBatchSwapMerkle(params) {
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
+    startNonces, // ✅ 可选：前端预获取的 nonces
+     } = params;
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    // ✅ 根据 chainId 获取正确的 Wrapped Native Token 地址
+    const chainId = config.chainId ?? CHAINS.BSC.chainId;
+    const WRAPPED_NATIVE = chainId === CHAINS.XLAYER.chainId
+        ? ADDRESSES.XLAYER.WOKB.toLowerCase() // XLayer: WOKB
+        : ADDRESSES.BSC.WBNB.toLowerCase(); // BSC: WBNB
+    // ✅ 动态计算最大买方数量（根据多跳数）
+    // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
+    // BNB 模式（无多跳）: 转账(N) + 买入(N) = 2N
+    // BNB 模式（有多跳H）: 转账(N*(H+1)) + 买入(N) = N*(H+2)
+    // ERC20 模式（无多跳）: 转账(N) + 买入(N) = 2N
+    // ERC20 模式（有多跳H）: BNB转账(N*(H+1)) + ERC20转账(N*(H+1)) + 买入(N) = N*(2H+3)
+    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1; // 贿赂 + 卖出 + 利润多跳
+    const maxTxs = 50 - fixedOverhead;
+    let MAX_BUYERS;
+    if (useNativeToken) {
+        // BNB 模式: N*(H+2) <= maxTxs => N <= maxTxs / (H+2)
+        MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
+    }
+    else {
+        // ERC20 模式: N*(2H+3) <= maxTxs => N <= maxTxs / (2H+3)
+        MAX_BUYERS = Math.floor(maxTxs / (2 * disperseHopCount + 3));
+    }
+    MAX_BUYERS = Math.max(1, MAX_BUYERS); // 至少1个
+    if (buyerPrivateKeys.length === 0) {
+        throw new Error('至少需要一个买方钱包');
+    }
+    if (buyerPrivateKeys.length > MAX_BUYERS) {
+        const mode = useNativeToken ? 'BNB' : 'ERC20';
+        throw new Error(`资金利用率模式(${mode}, ${disperseHopCount}跳)买方钱包数量超过限制: ${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 context = createPancakeContext(config);
+    const seller = new Wallet(sellerPrivateKey, context.provider);
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
+    // ✅ 校验卖出路径输出代币是否匹配
+    let sellOutputToken;
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        sellOutputToken = v2Path[v2Path.length - 1];
+    }
+    else if (routeParams.routeType === 'v3-single') {
+        const { v3TokenOut } = routeParams;
+        sellOutputToken = v3TokenOut;
+    }
+    else if (routeParams.routeType === 'v3-multi') {
+        const { v2Path } = routeParams;
+        if (v2Path && v2Path.length > 0) {
+            sellOutputToken = v2Path[v2Path.length - 1];
+        }
+    }
+    // 校验输出代币
+    const wrappedNativeName = chainId === CHAINS.XLAYER.chainId ? 'WOKB' : 'WBNB';
+    if (useNativeToken) {
+        // 原生代币模式：输出必须是 Wrapped Native Token（BSC: WBNB, XLayer: WOKB）
+        if (!sellOutputToken || sellOutputToken.toLowerCase() !== WRAPPED_NATIVE) {
+            throw new Error(`原生代币模式要求卖出路径以 ${wrappedNativeName} 结尾（当前输出: ${sellOutputToken || '未知'}）。` +
+                `请切换交易对或使用 ERC20 模式。`);
+        }
+    }
+    else {
+        // ERC20 模式：输出必须是指定的 quoteToken
+        if (!sellOutputToken || sellOutputToken.toLowerCase() !== quoteToken.toLowerCase()) {
+            throw new Error(`ERC20 模式要求卖出路径以 ${quoteToken} 结尾（当前输出: ${sellOutputToken || '未知'}）。`);
+        }
+    }
+    // ✅ 创建共享资源
+    const nonceManager = new NonceManager(context.provider);
+    const finalGasLimit = getGasLimit(config, 800000);
+    const txType = config.txType ?? 0;
+    const ERC20_TRANSFER_GAS = GAS_LIMITS.ERC20_TRANSFER; // ERC20 transfer 的 gas 限制
+    // ✅ 并行获取 gasPrice 和卖出数量
+    const [gasPrice, sellAmountResult] = await Promise.all([
+        getGasPrice(context.provider, config),
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    const quoteResult = await quoteSellOutput({
+        routeParams,
+        sellAmountWei,
+        provider: context.provider,
+        v2RouterAddress: config.v2RouterAddress,
+    });
+    const estimatedOutput = quoteResult.estimatedBNBOut;
+    // ✅ 计算利润（万分之六）
+    let profitAmount;
+    if (useNativeToken) {
+        profitAmount = calculateProfitAmount(estimatedOutput, config.userType);
+    }
+    else {
+        // ERC20 模式：需要将 ERC20 价值转换为 BNB
+        const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
+        const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
+        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, estimatedOutput, version, fee);
+        profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
+    }
+    const distributableAmount = estimatedOutput - (useNativeToken ? profitAmount : 0n);
+    // ✅ 计算每个买方分到的金额
+    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 = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
+    // ✅ 验证主钱包余额
+    const sellerBalance = await seller.provider.getBalance(seller.address);
+    let sellerGasCost;
+    let sellerRequired;
+    if (useNativeToken) {
+        // BNB 模式：贿赂(BRIBE) + 卖出(gasLimit) + N个原生转账(BRIBE each) + 利润(BRIBE)
+        sellerGasCost =
+            gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + BRIBE_GAS_LIMIT * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
+        sellerRequired = bribeAmount + sellerGasCost;
+    }
+    else {
+        // ERC20 模式：子钱包已预留 BNB，不需要主钱包转 Gas
+        // 卖方 Gas: 贿赂(BRIBE) + 卖出(gasLimit) + N个ERC20转账(65000 each) + 利润(BRIBE)
+        sellerGasCost =
+            gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + ERC20_TRANSFER_GAS * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
+        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 ====================
+    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+    let sellerNonce = startNonces && startNonces.length > 0 ? startNonces[0] : await nonceManager.getNextNonce(seller);
+    const deadline = Math.floor(Date.now() / 1000) + 600;
+    // ==================== 1. 贿赂交易 ====================
+    let bribeTx = null;
+    if (bribeAmount > 0n) {
+        bribeTx = await seller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: sellerNonce++,
+            gasPrice,
+            gasLimit: BRIBE_GAS_LIMIT,
+            chainId: context.chainId,
+            type: txType,
+        });
+    }
+    // ==================== 2. 卖出交易 ====================
+    const v3RouterIface2 = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
+    const quickV2Addr = config.v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS;
+    let sellUnsigned;
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const v2RouterSeller = new Contract(quickV2Addr, PANCAKE_V2_ROUTER_ABI, seller);
+        if (useNativeToken) {
+            // ✅ 原生代币模式（BNB）：Token → WBNB → BNB
+            sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+        }
+        else {
+            // ✅ ERC20 模式（USDT）：Token → USDT
+            sellUnsigned = await v2RouterSeller.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+        }
+    }
+    else if (routeParams.routeType === 'v3-single') {
+        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
+        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        const sellSwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [
+            {
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: useNativeToken ? PANCAKE_V3_ROUTER_ADDRESS : seller.address,
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            },
+        ]);
+        if (useNativeToken) {
+            // 原生代币：需要 unwrap WBNB
+            const sellUnwrapData = v3RouterIface2.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+            sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
+        }
+        else {
+            // ERC20：直接接收代币
+            sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData]);
+        }
+    }
+    else {
+        throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
+    }
+    const signedSell = await seller.signTransaction({
+        ...sellUnsigned,
+        from: seller.address,
+        nonce: sellerNonce++,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: context.chainId,
+        type: txType,
+    });
+    // ==================== 3. 转账交易（支持多跳）====================
+    const buyerGasCost = gasPrice * finalGasLimit;
+    // ✅ 生成多跳路径
+    const hopPaths = generateDisperseHopPaths(buyers.map((b) => b.address), disperseHopCount, context.provider);
+    // 收集所有中间钱包信息
+    const allHopWallets = [];
+    hopPaths.forEach((path) => {
+        allHopWallets.push(...path.hopWalletsInfo);
+    });
+    let transferTxs;
+    if (disperseHopCount === 0) {
+        // ✅ 无多跳：直接转账
+        const transferNonces = buyers.map((_, i) => sellerNonce + i);
+        sellerNonce += buyers.length;
+        if (useNativeToken) {
+            transferTxs = await Promise.all(buyers.map((buyer, i) => {
+                const transferValue = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
+                return seller.signTransaction({
+                    to: buyer.address,
+                    value: transferValue,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+                    chainId: context.chainId,
+                    type: txType,
+                });
+            }));
+        }
+        else {
+            const erc20Interface = new ethers.Interface(ERC20_ABI);
+            transferTxs = await Promise.all(buyers.map((buyer, i) => {
+                const transferData = erc20Interface.encodeFunctionData('transfer', [buyer.address, transferAmountsWei[i]]);
+                return seller.signTransaction({
+                    to: quoteToken,
+                    data: transferData,
+                    value: 0n,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: ERC20_TRANSFER_GAS,
+                    chainId: context.chainId,
+                    type: txType,
+                });
+            }));
+        }
+    }
+    else {
+        // ✅ 有多跳：构建多跳转账链
+        if (useNativeToken) {
+            // BNB 多跳转账
+            // ✅ 修复：payer 每次只发送 1 笔交易（到第一个hop钱包），hop钱包用自己的nonce=0
+            const hopChains = await Promise.all(hopPaths.map((path, i) => {
+                const finalAmount = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
+                const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
+                return buildNativeHopChain(seller, path, finalAmount, gasPrice, context.chainId, txType, payerNonce);
+            }));
+            transferTxs = hopChains.flat();
+            sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
+        }
+        else {
+            // ERC20 多跳转账：先转 BNB（给中间钱包 gas），再转 ERC20
+            // ✅ 修复：payer 每次只发送 1 笔交易（到第一个hop钱包），hop钱包用自己的nonce=0/1
+            // 1. 构建 BNB 多跳链（为中间钱包和最终钱包预留 gas）
+            const bnbHopChains = await Promise.all(hopPaths.map((path, i) => {
+                // 最终钱包需要的 gas（用于买入交易）
+                const finalGasAmount = buyerGasCost;
+                const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
+                return buildBNBHopChainForERC20(seller, path, finalGasAmount, gasPrice, context.chainId, txType, payerNonce);
+            }));
+            const bnbTxs = bnbHopChains.flat();
+            sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
+            // 2. 构建 ERC20 多跳链
+            const erc20HopChains = await Promise.all(hopPaths.map((path, i) => {
+                const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
+                return buildERC20HopChain(seller, path, quoteToken, transferAmountsWei[i], gasPrice, context.chainId, txType, payerNonce);
+            }));
+            const erc20Txs = erc20HopChains.flat();
+            sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
+            transferTxs = [...bnbTxs, ...erc20Txs];
+        }
+    }
+    // ==================== 4. 买入交易 ====================
+    // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
+    const buyerNonces = startNonces && startNonces.length > 1
+        ? startNonces.slice(1)
+        : await Promise.all(buyers.map((buyer) => nonceManager.getNextNonce(buyer)));
+    const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
+        const buyAmount = transferAmountsWei[i];
+        // ✅ ERC20 模式：value = 0（通过代币授权支付）
+        const buyValue = useNativeToken ? buyAmount + FLAT_FEE : 0n;
+        let buyUnsigned;
+        if (routeParams.routeType === 'v2') {
+            const { v2Path } = routeParams;
+            const reversePath = [...v2Path].reverse();
+            const v2RouterBuyer = new Contract(quickV2Addr, PANCAKE_V2_ROUTER_ABI, buyer);
+            if (useNativeToken) {
+                buyUnsigned = await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
+            }
+            else {
+                buyUnsigned = await v2RouterBuyer.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmount, 0n, reversePath, buyer.address, deadline);
+            }
+        }
+        else if (routeParams.routeType === 'v3-single') {
+            const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
+            const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+            const buySwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [
+                {
+                    tokenIn: v3TokenOut,
+                    tokenOut: v3TokenIn,
+                    fee: v3Fee,
+                    recipient: buyer.address,
+                    amountIn: buyAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n,
+                },
+            ]);
+            buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
+        }
+        else {
+            throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
+        }
+        return buyer.signTransaction({
+            ...buyUnsigned,
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: context.chainId,
+            type: txType,
+        });
+    }));
+    nonceManager.clearTemp();
+    // ==================== 组装交易数组 ====================
+    // BNB 模式：贿赂 → 卖出 → 转账 → 买入 → 利润多跳
+    // ERC20 模式：贿赂 → 卖出 → ERC20转账 → BNB Gas转账 → 买入 → 利润多跳
+    const signedTransactions = [];
+    if (bribeTx)
+        signedTransactions.push(bribeTx);
+    signedTransactions.push(signedSell);
+    signedTransactions.push(...transferTxs);
+    signedTransactions.push(...signedBuys);
+    // ==================== 5. 利润多跳转账（强制 2 跳中转）====================
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider: context.provider,
+            payerWallet: seller,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: context.chainId,
+            txType,
+            startNonce: sellerNonce++,
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+        // 多跳交易已签名
+    }
+    return {
+        signedTransactions,
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回转账多跳钱包
+        profitHopWallets, // ✅ 返回利润多跳钱包
+        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: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+            useNativeToken,
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined, // ✅ 返回多跳数
+        },
+    };
+}

package/dist/chains/bsc/pancake/swap-single.d.ts

@@ -0,0 +1,2 @@
+import { type PancakeBundleSwapSignParams, type PancakeSwapResult } from './bundle-swap-helpers.js';
+export declare function pancakeBundleSwapMerkle(params: PancakeBundleSwapSignParams): Promise<PancakeSwapResult>;

package/dist/chains/bsc/pancake/swap-single.js

@@ -0,0 +1,182 @@
+/**
+ * swap-single - 单笔换手（一卖一买）
+ */
+import { getProfitRecipient, BLOCKRAZOR_BUILDER_EOA } from '../../../core/constants/index.js';
+import { getGasLimit } from '../../../core/gas/bundle-gas.js';
+import { ethers, Wallet } from 'ethers';
+import { calculateSellAmount } from '../../../utils/swap-helpers.js';
+import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
+import { BRIBE_GAS_LIMIT, ZERO_ADDRESS, buildNoncePlanFromNonces, buildSwapTransactions, calculateBuyerBudget, calculateProfitAmount, createPancakeContext, getERC20ToNativeQuote, getGasPrice, planNonces, quoteSellOutput, validateFinalBalances, } from './bundle-swap-helpers.js';
+export async function pancakeBundleSwapMerkle(params) {
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
+     } = params;
+    // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const context = createPancakeContext(config);
+    const seller = new Wallet(sellerPrivateKey, context.provider);
+    const buyer = new Wallet(buyerPrivateKey, context.provider);
+    const sameAddress = seller.address.toLowerCase() === buyer.address.toLowerCase();
+    // ✅ 提前创建 NonceManager，供所有交易共享
+    const nonceManager = new NonceManager(context.provider);
+    const finalGasLimit = getGasLimit(config, 800000);
+    const txType = config.txType ?? 0;
+    // ✅ 并行获取 gasPrice 和卖出数量
+    const [gasPrice, sellAmountResult] = await Promise.all([
+        getGasPrice(context.provider, config),
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    const quoteResult = await quoteSellOutput({
+        routeParams,
+        sellAmountWei,
+        provider: context.provider,
+        v2RouterAddress: config.v2RouterAddress,
+    });
+    const buyerBudget = await calculateBuyerBudget({
+        buyer,
+        quotedBNBOut: quoteResult.estimatedBNBOut,
+        reserveGasBNB: config.reserveGasBNB,
+        useNativeToken,
+        quoteToken,
+        quoteTokenDecimals,
+        provider: context.provider,
+    });
+    const swapUnsigned = await buildSwapTransactions({
+        routeParams,
+        sellAmountWei,
+        buyAmountBNB: buyerBudget.buyAmountBNB,
+        buyer,
+        seller,
+        tokenAddress,
+        useNativeToken,
+        v2RouterAddress: config.v2RouterAddress,
+    });
+    // ✅ 修复：利润计算应基于 BNB 数量，不是 ERC20 数量
+    // 如果输出是原生代币（BNB），直接使用报价结果
+    // 如果输出是 ERC20（如 USDT），需要先转换为 BNB 等值
+    let profitAmount;
+    if (useNativeToken) {
+        // 输出是 BNB，直接计算利润（根据 userType 动态调整）
+        profitAmount = calculateProfitAmount(quoteResult.estimatedBNBOut, config.userType);
+        // 利润计算完成
+    }
+    else {
+        // 输出是 ERC20，需要先获取 ERC20 → BNB 的报价
+        const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
+        const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
+        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, quoteResult.estimatedBNBOut, // 这实际上是 ERC20 数量
+        version, fee);
+        profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
+        // ERC20→BNB 报价完成
+    }
+    // ✅ 获取贿赂金额
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 使用共享的 NonceManager 规划 nonce
+    // 如果前端传入了 startNonces，直接使用（性能优化）
+    const noncePlan = startNonces && startNonces.length >= (sameAddress ? 1 : 2)
+        ? buildNoncePlanFromNonces(startNonces, sameAddress, false, profitAmount > 0n, needBribeTx)
+        : await planNonces({
+            seller,
+            buyer,
+            sameAddress,
+            approvalExists: false, // ✅ 已移除授权
+            profitNeeded: profitAmount > 0n,
+            needBribeTx,
+            nonceManager,
+        });
+    // ✅ 并行签名所有交易
+    const signPromises = [];
+    // 贿赂交易
+    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
+        signPromises.push(seller
+            .signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: noncePlan.bribeNonce,
+            gasPrice,
+            gasLimit: BRIBE_GAS_LIMIT,
+            chainId: context.chainId,
+            type: txType,
+        })
+            .then((tx) => ({ type: 'bribe', tx })));
+    }
+    // 卖出交易
+    signPromises.push(seller
+        .signTransaction({
+        ...swapUnsigned.sellUnsigned,
+        from: seller.address,
+        nonce: noncePlan.sellerNonce,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: context.chainId,
+        type: txType,
+    })
+        .then((tx) => ({ type: 'sell', tx })));
+    // 买入交易
+    signPromises.push(buyer
+        .signTransaction({
+        ...swapUnsigned.buyUnsigned,
+        from: buyer.address,
+        nonce: noncePlan.buyerNonce,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: context.chainId,
+        type: txType,
+    })
+        .then((tx) => ({ type: 'buy', tx })));
+    // ✅ 并行执行所有签名
+    const signedResults = await Promise.all(signPromises);
+    // 按类型提取结果
+    const bribeTx = signedResults.find((r) => r.type === 'bribe')?.tx || null;
+    const signedSell = signedResults.find((r) => r.type === 'sell').tx;
+    const signedBuy = signedResults.find((r) => r.type === 'buy').tx;
+    nonceManager.clearTemp();
+    validateFinalBalances({
+        sameAddress,
+        buyerBalance: buyerBudget.buyerBalance,
+        buyAmountBNB: buyerBudget.buyAmountBNB,
+        reserveGas: buyerBudget.reserveGas,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        useNativeToken,
+        quoteTokenDecimals,
+        provider: context.provider,
+        buyerAddress: buyer.address,
+    });
+    // ✅ 组装顺序：贿赂 → 卖出 → 买入
+    const signedTransactions = [];
+    if (bribeTx)
+        signedTransactions.push(bribeTx);
+    signedTransactions.push(signedSell, signedBuy);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (profitAmount > 0n && noncePlan.profitNonce !== undefined) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider: context.provider,
+            payerWallet: seller,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: context.chainId,
+            txType,
+            startNonce: noncePlan.profitNonce,
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return {
+        signedTransactions,
+        profitHopWallets, // ✅ 导出利润多跳钱包
+        metadata: {
+            sellerAddress: seller.address,
+            buyerAddress: buyer.address,
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            buyAmount: useNativeToken
+                ? ethers.formatEther(buyerBudget.buyAmountBNB)
+                : ethers.formatUnits(buyerBudget.buyAmountBNB, quoteTokenDecimals),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+        },
+    };
+}

package/dist/chains/bsc/platforms/four/index.d.ts

@@ -1,6 +1,24 @@
 /**
- * BSC - Four.meme 平台模块
+ * BSC - Four.meme 平台模块（有意 facade）
  *
- * 从新位置重新导出
+ * 这是 chains/bsc 层的 Four.meme 快捷入口 facade，被 chains/bsc/index.ts 引用，
+ * 用于把 bundle 层的 Four.meme 实现以快捷别名暴露到 chains/bsc 命名空间下。
+ *
+ * 依赖说明：本文件仅从 `bundle/` 层重新导出（types / errors / config-helpers /
+ * four-meme 各子模块 / submit），不引入除 bundle 之外的其它反向依赖（如 domains/、
+ * chains/ 其它平台），故作为 facade 有意保留，不修改任何导出与逻辑。
  */
-export * from '../../four/index.js';
+export type * from '../../../../bundle/four-meme/types/index.js';
+export type { FourAnyConfig } from '../../../../bundle/four-meme/types/core-flow.js';
+export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage, } from '../../../../bundle/errors.js';
+export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../../bundle/config-helpers.js';
+export { createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWithBundleMerkle, } from '../../../../bundle/four-meme/core.js';
+export { fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, } from '../../../../bundle/four-meme/private.js';
+export { disperseWithBundleMerkle } from '../../../../bundle/four-meme/utils-disperse.js';
+export { sweepWithBundleMerkle } from '../../../../bundle/four-meme/utils-sweep.js';
+export { pairwiseTransferWithBundleMerkle } from '../../../../bundle/four-meme/utils-pairwise.js';
+export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, } from '../../../../bundle/four-meme/pancake-proxy.js';
+export { approveFourTokenManagerBatch } from '../../../../bundle/four-meme/approve-tokenmanager.js';
+export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from '../../../../bundle/submit.js';
+export { fourBundleBuyFirstMerkle } from '../../../../bundle/four-meme/swap-buy-first.js';
+export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, } from '../../../../bundle/four-meme/swap.js';