four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/chains/bsc/pancake/bundle-swap-helpers.js

@@ -0,0 +1,565 @@
+import { ethers, Wallet, Contract } from 'ethers';
+import { generateWallets } from '../../../utils/wallet.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../../../abis/common.js';
+import { createSignProvider } from '../../../bundle-core/sign-context-helpers.js';
+import { quoteV2, quoteV3 } from '../../../utils/quote-helpers.js';
+import { GAS_LIMITS } from '../../../shared/constants/index.js';
+import { getDeadline } from '../../../utils/bundle-helpers.js';
+import { ADDRESSES } from '../../../shared/constants/index.js';
+// ==================== 多跳转账常量（使用统一常量） ====================
+export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+export const ERC20_TRANSFER_GAS_LIMIT_HOP = GAS_LIMITS.ERC20_TRANSFER;
+export const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
+/**
+ * 生成分发多跳路径
+ */
+export function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
+    if (hopCount <= 0) {
+        return targetAddresses.map((addr) => ({
+            targetAddress: addr,
+            hopWallets: [],
+            hopWalletsInfo: [],
+        }));
+    }
+    return targetAddresses.map((targetAddress) => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
+        return { targetAddress, hopWallets, hopWalletsInfo };
+    });
+}
+/**
+ * 构建原生代币多跳转账链
+ */
+export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        const tx = {
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType,
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
+ */
+export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    if (hopCount === 0) {
+        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    const firstTx = {
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        chainId,
+        type: txType,
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+export async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        // 无多跳时不需要转 gas
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    // 每个中间钱包需要: BNB 转发 gas + ERC20 转发 gas
+    const gasPerHop = hopGasCost + erc20GasCost * 2n; // 2倍安全系数
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType,
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target (nonce=0)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalGasAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+// ==================== 工具函数 ====================
+export function createPancakeContext(config) {
+    const chainId = config.chainId ?? 56;
+    const provider = createSignProvider(config.rpcUrl, chainId);
+    return { chainId, provider };
+}
+export async function quoteSellOutput({ routeParams, sellAmountWei, provider, v2RouterAddress, }) {
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const tokenIn = v2Path[0];
+        const tokenOut = v2Path[v2Path.length - 1];
+        const result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, 'BSC', v2RouterAddress);
+        if (result.amountOut > 0n) {
+            return { estimatedBNBOut: result.amountOut };
+        }
+        throw new Error('V2 报价失败: 所有路径均无效');
+    }
+    // ==================== V3 单跳报价 ====================
+    if (routeParams.routeType === 'v3-single') {
+        const params = routeParams;
+        const result = await quoteV3(provider, params.v3TokenIn, params.v3TokenOut, sellAmountWei, 'BSC', params.v3Fee);
+        if (result.amountOut > 0n) {
+            return { estimatedBNBOut: result.amountOut };
+        }
+        // ❌ V3 报价失败时不再 fallback 到 V2，因为价格可能差异很大
+        throw new Error(`V3 单跳报价失败: tokenIn=${params.v3TokenIn}, tokenOut=${params.v3TokenOut}, fee=${params.v3Fee}`);
+    }
+    // ==================== V3 多跳报价 ====================
+    if (routeParams.routeType === 'v3-multi') {
+        const params = routeParams;
+        if (params.v3LpAddresses && params.v3LpAddresses.length > 0) {
+            const tokenIn = params.v3ExactTokenIn;
+            const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
+            const result = await quoteV3(provider, tokenIn, WBNB, sellAmountWei, 'BSC');
+            if (result.amountOut > 0n) {
+                return { estimatedBNBOut: result.amountOut };
+            }
+        }
+        // ❌ V3 多跳报价失败时不再 fallback 到 V2，因为价格可能差异很大
+        throw new Error(`V3 多跳报价失败: LPs=${params.v3LpAddresses?.join(', ')}, tokenIn=${params.v3ExactTokenIn}`);
+    }
+    throw new Error(`不支持的路由类型: ${routeParams.routeType}`);
+}
+export async function buildSwapTransactions({ routeParams, sellAmountWei, buyAmountBNB, buyer, seller, tokenAddress, useNativeToken = true, v2RouterAddress, }) {
+    void tokenAddress;
+    const deadline = getDeadline();
+    const buyValue = useNativeToken ? buyAmountBNB + FLAT_FEE : 0n;
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const reversePath = [...v2Path].reverse();
+        const routerAddr = v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS;
+        const v2RouterSeller = new Contract(routerAddr, PANCAKE_V2_ROUTER_ABI, seller);
+        const v2RouterBuyer = new Contract(routerAddr, PANCAKE_V2_ROUTER_ABI, buyer);
+        let sellUnsigned;
+        let buyUnsigned;
+        if (useNativeToken) {
+            // ✅ 原生代币模式（BNB）
+            // 卖出：Token → WBNB → BNB
+            sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+            // 买入：BNB → WBNB → Token
+            buyUnsigned = await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
+        }
+        else {
+            // ✅ ERC20 模式（如 USDT）
+            // 卖出：Token → USDT
+            sellUnsigned = await v2RouterSeller.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+            // 买入：USDT → Token
+            buyUnsigned = await v2RouterBuyer.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmountBNB, // USDT 数量
+            0n, reversePath, buyer.address, deadline);
+        }
+        return { sellUnsigned, buyUnsigned };
+    }
+    if (routeParams.routeType === 'v3-single') {
+        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
+        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
+        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+        // 卖出：Token → WBNB，需要 unwrapWETH9
+        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+            {
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: PANCAKE_V3_ROUTER_ADDRESS, // 先发给 Router
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            },
+        ]);
+        const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+        const sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
+        // 买入：WBNB → Token
+        const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
+            {
+                tokenIn: v3TokenOut,
+                tokenOut: v3TokenIn,
+                fee: v3Fee,
+                recipient: buyer.address,
+                amountIn: buyAmountBNB,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n,
+            },
+        ]);
+        const buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
+        return { sellUnsigned, buyUnsigned };
+    }
+    // V3 多跳暂不支持官方合约
+    throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
+}
+export async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider, }) {
+    const reserveGas = ethers.parseEther((reserveGasBNB ?? 0.0005).toString());
+    // ✅ 已移除滑点保护：直接使用报价金额
+    const buyAmountBNB = quotedBNBOut;
+    // ✅ 根据是否使用原生代币获取不同的余额
+    let buyerBalance;
+    if (useNativeToken) {
+        buyerBalance = await buyer.provider.getBalance(buyer.address);
+        const requiredBalance = buyAmountBNB + FLAT_FEE + reserveGas;
+        if (buyerBalance < requiredBalance) {
+            throw new Error(`买方余额不足: 需要 ${ethers.formatEther(requiredBalance)} BNB, 实际 ${ethers.formatEther(buyerBalance)} BNB`);
+        }
+        return { buyerBalance, reserveGas, requiredBalance, buyAmountBNB, useNativeToken };
+    }
+    else {
+        // ERC20 代币余额
+        const erc20 = new Contract(quoteToken, ERC20_BALANCE_OF_ABI, provider || buyer.provider);
+        buyerBalance = await erc20.balanceOf(buyer.address);
+        const requiredBalance = buyAmountBNB + FLAT_FEE; // ERC20 不需要预留 Gas 在代币余额中
+        if (buyerBalance < requiredBalance) {
+            throw new Error(`买方代币余额不足: 需要 ${ethers.formatUnits(requiredBalance, quoteTokenDecimals)}, 实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
+        }
+        // ✅ ERC20 购买时，还需要检查买方是否有足够 BNB 支付 Gas
+        const buyerBnbBalance = await buyer.provider.getBalance(buyer.address);
+        if (buyerBnbBalance < reserveGas) {
+            throw new Error(`买方 BNB 余额不足 (用于支付 Gas): 需要 ${ethers.formatEther(reserveGas)} BNB, 实际 ${ethers.formatEther(buyerBnbBalance)} BNB`);
+        }
+        return { buyerBalance, reserveGas, requiredBalance, buyAmountBNB, useNativeToken };
+    }
+}
+/**
+ * ✅ 从前端传入的 startNonces 构建 NoncePlan（用于性能优化）
+ * 顺序：[sellerBaseNonce, buyerNonce]
+ */
+export function buildNoncePlanFromNonces(startNonces, sameAddress, approvalExists, profitNeeded, needBribeTx) {
+    if (sameAddress) {
+        let idx = 0;
+        const bribeNonce = needBribeTx ? startNonces[0] + idx++ : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = startNonces[0] + idx++;
+        const buyerNonce = startNonces[0] + idx++;
+        const profitNonce = profitNeeded ? startNonces[0] + idx : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    let sellerIdx = 0;
+    const bribeNonce = needBribeTx ? startNonces[0] + sellerIdx++ : undefined;
+    if (approvalExists)
+        sellerIdx++;
+    const sellerNonce = startNonces[0] + sellerIdx++;
+    const profitNonce = profitNeeded ? startNonces[0] + sellerIdx : undefined;
+    const buyerNonce = startNonces[1];
+    return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+}
+/**
+ * ✅ 规划 nonce
+ * 交易顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
+ * 贿赂和利润由卖方发送
+ */
+export async function planNonces({ seller, buyer, sameAddress, approvalExists, profitNeeded, needBribeTx, nonceManager, }) {
+    if (sameAddress) {
+        // 同一地址：贿赂(可选) + 授权(可选) + 卖出 + 买入 + 利润(可选)
+        const txCount = countTruthy([needBribeTx, approvalExists, true, true, profitNeeded]);
+        const nonces = await nonceManager.getNextNonceBatch(buyer, txCount);
+        let idx = 0;
+        const bribeNonce = needBribeTx ? nonces[idx++] : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = nonces[idx++];
+        const buyerNonce = nonces[idx++];
+        const profitNonce = profitNeeded ? nonces[idx] : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    if (needBribeTx || approvalExists || profitNeeded) {
+        // 卖方需要多个 nonce：贿赂(可选) + 授权(可选) + 卖出 + 利润(可选)
+        const sellerTxCount = countTruthy([needBribeTx, approvalExists, true, profitNeeded]);
+        // ✅ 并行获取 seller 和 buyer 的 nonce
+        const [sellerNonces, buyerNonce] = await Promise.all([
+            nonceManager.getNextNonceBatch(seller, sellerTxCount),
+            nonceManager.getNextNonce(buyer),
+        ]);
+        let idx = 0;
+        const bribeNonce = needBribeTx ? sellerNonces[idx++] : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = sellerNonces[idx++];
+        const profitNonce = profitNeeded ? sellerNonces[idx] : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    // ✅ 并行获取 seller 和 buyer 的 nonce
+    const [sellerNonce, buyerNonce] = await Promise.all([
+        nonceManager.getNextNonce(seller),
+        nonceManager.getNextNonce(buyer),
+    ]);
+    return { sellerNonce, buyerNonce };
+}
+/**
+ * 根据 userType 计算利润率
+ */
+export function getProfitRateBps(userType) {
+    if (userType === 'v0') {
+        return 4; // 0.06%
+    }
+    else if (userType === 'v1') {
+        return 5; // 0.05%
+    }
+    return 4; // 默认 0.06%
+}
+export function calculateProfitAmount(estimatedBNBOut, userType) {
+    if (estimatedBNBOut <= 0n) {
+        return 0n;
+    }
+    const rateBps = getProfitRateBps(userType);
+    return (estimatedBNBOut * BigInt(rateBps)) / 10000n;
+}
+/**
+ * ✅ 获取 ERC20 代币 → 原生代币（BNB）的报价
+ * 用于将 ERC20 利润转换为 BNB
+ * 使用共享的报价函数
+ */
+export async function getERC20ToNativeQuote(provider, tokenAddress, tokenAmount, version = 'v2', fee) {
+    if (tokenAmount <= 0n)
+        return 0n;
+    const tokenLower = tokenAddress.toLowerCase();
+    const wbnbLower = WBNB_ADDRESS.toLowerCase();
+    // 如果代币本身就是 WBNB，直接返回
+    if (tokenLower === wbnbLower) {
+        return tokenAmount;
+    }
+    // 使用共享的报价函数
+    if (version === 'v3') {
+        const result = await quoteV3(provider, tokenAddress, WBNB_ADDRESS, tokenAmount, 'BSC', fee);
+        if (result.amountOut > 0n) {
+            return result.amountOut;
+        }
+        return 0n;
+    }
+    const result = await quoteV2(provider, tokenAddress, WBNB_ADDRESS, tokenAmount, 'BSC');
+    return result.amountOut > 0n ? result.amountOut : 0n;
+}
+export async function validateFinalBalances({ sameAddress, buyerBalance, buyAmountBNB, reserveGas, gasLimit, gasPrice, useNativeToken = true, quoteTokenDecimals = 18, provider, buyerAddress, }) {
+    const gasCost = gasLimit * gasPrice;
+    if (sameAddress) {
+        // 同一地址：需要足够的余额支付两笔交易
+        if (useNativeToken) {
+            const requiredCombined = buyAmountBNB + FLAT_FEE * 2n + gasCost * 2n;
+            if (buyerBalance < requiredCombined) {
+                throw new Error(`账户余额不足:\n  - 需要: ${ethers.formatEther(requiredCombined)} BNB（含两笔Gas与两笔手续费）\n  - 实际: ${ethers.formatEther(buyerBalance)} BNB`);
+            }
+        }
+        else {
+            // ERC20：检查代币余额 + BNB Gas 余额
+            const requiredToken = buyAmountBNB + FLAT_FEE * 2n;
+            if (buyerBalance < requiredToken) {
+                throw new Error(`账户代币余额不足:\n  - 需要: ${ethers.formatUnits(requiredToken, quoteTokenDecimals)}\n  - 实际: ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
+            }
+            // 检查 BNB Gas
+            if (provider && buyerAddress) {
+                const bnbBalance = await provider.getBalance(buyerAddress);
+                const requiredGas = gasCost * 2n;
+                if (bnbBalance < requiredGas) {
+                    throw new Error(`账户 BNB 余额不足 (用于支付 Gas):\n  - 需要: ${ethers.formatEther(requiredGas)} BNB\n  - 实际: ${ethers.formatEther(bnbBalance)} BNB`);
+                }
+            }
+        }
+        return;
+    }
+    // 不同地址
+    if (useNativeToken) {
+        const requiredBuyer = buyAmountBNB + FLAT_FEE + reserveGas;
+        if (buyerBalance < requiredBuyer) {
+            throw new Error(`买方余额不足:\n  - 需要: ${ethers.formatEther(requiredBuyer)} BNB\n  - 实际: ${ethers.formatEther(buyerBalance)} BNB`);
+        }
+    }
+    // ERC20 余额已在 calculateBuyerBudget 中检查过
+}
+export function countTruthy(values) {
+    return values.filter(Boolean).length;
+}
+/**
+ * 获取 Gas Limit
+ */
+export function getGasLimit(config, defaultGas = 800000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    const calculatedGas = Math.ceil(defaultGas * multiplier);
+    return BigInt(calculatedGas);
+}
+export async function getGasPrice(provider, config) {
+    const feeData = await provider.getFeeData();
+    let gasPrice = feeData.gasPrice || ethers.parseUnits('3', 'gwei');
+    if (config.minGasPriceGwei) {
+        const minGas = ethers.parseUnits(config.minGasPriceGwei.toString(), 'gwei');
+        if (gasPrice < minGas)
+            gasPrice = minGas;
+    }
+    if (config.maxGasPriceGwei) {
+        const maxGas = ethers.parseUnits(config.maxGasPriceGwei.toString(), 'gwei');
+        if (gasPrice > maxGas)
+            gasPrice = maxGas;
+    }
+    return gasPrice;
+}
+// ✅ ABI 别名（从公共模块导入）
+export const PANCAKE_V2_ROUTER_ABI = V2_ROUTER_ABI;
+export const PANCAKE_V3_ROUTER_ABI = V3_ROUTER02_ABI;
+export const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+// ✅ 使用官方 PancakeSwap Router 地址
+export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+// 常量
+export const FLAT_FEE = 0n;
+export const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+// ✅ ERC20_BALANCE_OF_ABI 已在文件开头定义
+/**
+ * PancakeSwap捆绑换手（V2/V3通用）
+ * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
+ */

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

@@ -1,83 +1,5 @@
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
 import { type GeneratedWallet } from '../../../utils/wallet.js';
-export type UserType = 'v0' | 'v1';
-export interface PancakeSwapSignConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    chainId?: number;
-    reserveGasBNB?: number;
-    userType?: UserType;
-    bribeAmount?: number;
-    v2RouterAddress?: string;
-}
-export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
-export interface PancakeSwapConfig extends CommonBundleConfig {
-    apiKey: string;
-    customRpcUrl?: string;
-    bundleBlockOffset?: number;
-    reserveGasBNB?: number;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-}
-export interface V2RouteParams {
-    routeType: 'v2';
-    v2Path: string[];
-}
-export interface V3SingleRouteParams {
-    routeType: 'v3-single';
-    v3TokenIn: string;
-    v3TokenOut: string;
-    v3Fee: number;
-    v2Path?: string[];
-}
-export interface V3MultiRouteParams {
-    routeType: 'v3-multi';
-    v3LpAddresses: string[];
-    v3ExactTokenIn: string;
-    v2Path?: string[];
-}
-export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
-export interface PancakeBundleSwapSignParams {
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    routeParams: RouteParams;
-    config: PancakeSwapSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-}
-export interface PancakeBundleSwapParams {
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    routeParams: RouteParams;
-    config: PancakeSwapConfig;
-}
-/** ✅ Pancake Swap 结果（简化版） */
-export type PancakeSwapResult = {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        sellerAddress: string;
-        buyerAddress: string;
-        sellAmount: string;
-        buyAmount: string;
-        profitAmount?: string;
-    };
-};
-/**
- * PancakeSwap捆绑换手（V2/V3通用）
- * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
- */
+import { PancakeBundleSwapSignParams, PancakeSwapResult, PancakeSwapSignConfig, RouteParams } from './bundle-swap-helpers.js';
 export declare function pancakeBundleSwapMerkle(params: PancakeBundleSwapSignParams): Promise<PancakeSwapResult>;
 /**
  * 批量换手参数（一卖多买）