four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/create-to-dex/constants.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Flap 发币 + 一键到外盘 — 常量（ABI / DEX 地址 / 链配置）
+ */
+import type { CreateToDexChain } from './types.js';
+export declare const ERC20_ABI: {
+    type: string;
+    name: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+}[];
+export declare const PANCAKE_ROUTER_ABI: ({
+    type: string;
+    name: string;
+    inputs: {
+        name: string;
+        type: string;
+        components: {
+            name: string;
+            type: string;
+        }[];
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+} | {
+    type: string;
+    name: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+})[];
+export declare const DEX_ADDRESSES: {
+    BSC: {
+        PANCAKE_SMART_ROUTER: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+        WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+    };
+    XLAYER: {
+        PANCAKE_SMART_ROUTER: "0xB45D0149249488333E3F3f9F359807F4b810C1FC";
+        WBNB: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+    };
+    BASE: {
+        UNISWAP_SMART_ROUTER: "0x2626664c2603336E57B271c5C0b26F421741e481";
+        WETH: "0x4200000000000000000000000000000000000006";
+    };
+};
+export declare function getChainConfig(chain: CreateToDexChain): {
+    chainId: 196;
+    nativeSymbol: string;
+} | {
+    chainId: 8453;
+    nativeSymbol: string;
+} | {
+    chainId: 56;
+    nativeSymbol: string;
+};

package/dist/domains/flap/portal-bundle-merkle/create-to-dex/constants.js

@@ -0,0 +1,90 @@
+/**
+ * Flap 发币 + 一键到外盘 — 常量（ABI / DEX 地址 / 链配置）
+ */
+import { ADDRESSES, CHAINS } from '../../../../core/constants/index.js';
+// ==================== ERC20 ABI ====================
+export const ERC20_ABI = [
+    {
+        type: 'function',
+        name: 'approve',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+        stateMutability: 'nonpayable',
+    },
+];
+// ==================== PancakeSwap Router ABI ====================
+export const PANCAKE_ROUTER_ABI = [
+    {
+        type: 'function',
+        name: 'exactInputSingle',
+        inputs: [
+            {
+                name: 'params',
+                type: 'tuple',
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'fee', type: 'uint24' },
+                    { name: 'recipient', type: 'address' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'amountOutMinimum', type: 'uint256' },
+                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                ],
+            },
+        ],
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+        stateMutability: 'payable',
+    },
+    {
+        type: 'function',
+        name: 'multicall',
+        inputs: [{ name: 'data', type: 'bytes[]' }],
+        outputs: [{ name: 'results', type: 'bytes[]' }],
+        stateMutability: 'payable',
+    },
+    {
+        type: 'function',
+        name: 'swapExactTokensForTokens',
+        inputs: [
+            { name: 'amountIn', type: 'uint256' },
+            { name: 'amountOutMin', type: 'uint256' },
+            { name: 'path', type: 'address[]' },
+            { name: 'to', type: 'address' },
+        ],
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+        stateMutability: 'payable',
+    },
+];
+// ==================== DEX 地址常量 ====================
+export const DEX_ADDRESSES = {
+    BSC: {
+        PANCAKE_SMART_ROUTER: ADDRESSES.BSC.PancakeV3Router,
+        WBNB: ADDRESSES.BSC.WBNB,
+    },
+    XLAYER: {
+        // xLayer 使用 PotatoSwap
+        PANCAKE_SMART_ROUTER: ADDRESSES.XLAYER.PotatoSwapSwapRouter02,
+        WBNB: ADDRESSES.XLAYER.WOKB,
+    },
+    BASE: {
+        // ✅ Base 使用 Uniswap V3 SwapRouter02
+        UNISWAP_SMART_ROUTER: ADDRESSES.BASE.UniswapV3Router,
+        WETH: ADDRESSES.BASE.WETH,
+    },
+};
+// ==================== 链常量 ====================
+// 获取链配置
+export function getChainConfig(chain) {
+    switch (chain) {
+        case 'xlayer':
+            return { chainId: CHAINS.XLAYER.chainId, nativeSymbol: 'OKB' };
+        case 'base':
+            return { chainId: CHAINS.BASE.chainId, nativeSymbol: 'ETH' };
+        case 'bsc':
+        default:
+            return { chainId: CHAINS.BSC.chainId, nativeSymbol: 'BNB' };
+    }
+}

package/dist/domains/flap/portal-bundle-merkle/create-to-dex/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Flap 发币 + 一键到外盘（Create → Curve → DEX）barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - types.ts：类型定义
+ * - constants.ts：ABI / DEX 地址 / 链配置常量
+ * - main.ts：flapBundleCreateToDex 主流程
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { flapBundleCreateToDex } from './main.js';
+export type { CreateToDexChain, DexPoolType, CreateToDexSignConfig, CreateTokenInfo, CurveBuyerConfig, DexBuyerConfig, FlapCreateToDexParams, FlapCreateToDexResult, } from './types.js';

package/dist/domains/flap/portal-bundle-merkle/create-to-dex/index.js

@@ -0,0 +1,11 @@
+/**
+ * Flap 发币 + 一键到外盘（Create → Curve → DEX）barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - types.ts：类型定义
+ * - constants.ts：ABI / DEX 地址 / 链配置常量
+ * - main.ts：flapBundleCreateToDex 主流程
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { flapBundleCreateToDex } from './main.js';

package/dist/domains/flap/portal-bundle-merkle/create-to-dex/main.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Flap 发币 + 一键到外盘 — 主流程（flapBundleCreateToDex）
+ */
+import type { FlapCreateToDexParams, FlapCreateToDexResult } from './types.js';
+/**
+ * Flap 发币 + 一键买到外盘捆绑交易
+ *
+ * 交易顺序：
+ * 1. 贿赂交易（BlockRazor）
+ * 2. 发币交易（Dev 钱包创建代币）
+ * 3. 内盘买入（多个钱包在 Bonding Curve 买入，买到毕业）
+ * 4. 外盘买入（多个钱包在 PancakeSwap 买入）
+ * 5. 利润多跳转账
+ */
+export declare function flapBundleCreateToDex(params: FlapCreateToDexParams): Promise<FlapCreateToDexResult>;

package/dist/domains/flap/portal-bundle-merkle/create-to-dex/main.js

@@ -0,0 +1,432 @@
+/**
+ * Flap 发币 + 一键到外盘 — 主流程（flapBundleCreateToDex）
+ */
+import { getGasLimit } from '../../../../core/gas/bundle-gas.js';
+import { ethers, Contract, Wallet } from 'ethers';
+import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../../utils/bundle-helpers.js';
+import { FLAP_PORTAL_ADDRESSES, FLAP_ORIGINAL_PORTAL_ADDRESSES } from '../../constants.js';
+import { normalizeTaxLaunchConfig, populateCreateTokenTransaction, } from '../../portal-create-token.js';
+import { MigratorType } from '../../portal.js';
+import { ZERO_ADDRESS, CHAINS, GAS_LIMITS } from '../../../../core/constants/index.js';
+import { getGasPriceConfig, getTxType, getProfitRecipient, getProfitRateBps, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI, } from '../config.js';
+import { splitAmountByWeight as splitAmount } from '../../../../core/amount/split-by-weight.js';
+import { ERC20_ABI, PANCAKE_ROUTER_ABI, DEX_ADDRESSES, getChainConfig } from './constants.js';
+// ==================== 工具函数 ====================
+/** 构建 ERC20 approve 交易 */
+async function buildApproveTransaction(wallet, tokenAddress, spenderAddress, amount, nonce, gasPrice, txType, chainId = CHAINS.BSC.chainId) {
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    const data = erc20Interface.encodeFunctionData('approve', [spenderAddress, amount]);
+    const tx = {
+        to: tokenAddress,
+        data,
+        from: wallet.address,
+        nonce,
+        gasLimit: BigInt(100_000), // approve 交易 gas 较低
+        chainId,
+        type: txType,
+    };
+    if (txType === 2) {
+        const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = priorityFee;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+    }
+    return wallet.signTransaction(tx);
+}
+/** 解析输入金额字符串为 bigint（按是否原生币选择 parseEther / parseUnits） */
+function parseQuoteAmount(amount, useNativeToken, quoteTokenDecimals) {
+    const v = String(amount ?? '').trim();
+    if (!v)
+        return 0n;
+    return useNativeToken ? ethers.parseEther(v) : ethers.parseUnits(v, quoteTokenDecimals);
+}
+/**
+ * 计算每个买家的买入金额（优先使用 params 传入的 buyAmount；否则 fallback 到按总额随机拆分）
+ * 说明：memeweb 前端已根据 average/random/custom 计算出每个钱包 buyAmount；
+ * 若 SDK 这里再次 splitAmount，会导致实际 buyAmount 与 UI/预期不一致，并引发余额不足（insufficient funds）。
+ */
+function resolveBuyerAmounts(buyers, totalAmountStr, useNativeToken, quoteTokenDecimals) {
+    const provided = buyers.map((b) => b?.buyAmount).filter((v) => v != null && String(v).trim() !== '');
+    const allProvided = provided.length === buyers.length;
+    if (allProvided) {
+        // ✅ 所有买家都显式提供了 buyAmount：按传入金额构建，但要修正“浮点/四舍五入导致总和偏差”
+        const amounts = buyers.map((b) => parseQuoteAmount(String(b.buyAmount), useNativeToken, quoteTokenDecimals));
+        const totalWei = parseQuoteAmount(totalAmountStr, useNativeToken, quoteTokenDecimals);
+        const sum = amounts.reduce((a, b) => a + b, 0n);
+        const delta = totalWei - sum;
+        if (delta !== 0n && amounts.length > 0) {
+            // 优先修正最后一个金额（对应 create-to-dex 里“最后一单可能触发毕业”的假设）
+            const lastIdx = amounts.length - 1;
+            const next = amounts[lastIdx] + delta;
+            if (next <= 0n) {
+                throw new Error(`买入金额总和与总额不一致且无法修正：sum=${sum} total=${totalWei} delta=${delta}`);
+            }
+            amounts[lastIdx] = next;
+        }
+        return amounts;
+    }
+    const totalWei = parseQuoteAmount(totalAmountStr, useNativeToken, quoteTokenDecimals);
+    return splitAmount(totalWei, buyers.length);
+}
+// ==================== 主函数 ====================
+/**
+ * Flap 发币 + 一键买到外盘捆绑交易
+ *
+ * 交易顺序：
+ * 1. 贿赂交易（BlockRazor）
+ * 2. 发币交易（Dev 钱包创建代币）
+ * 3. 内盘买入（多个钱包在 Bonding Curve 买入，买到毕业）
+ * 4. 外盘买入（多个钱包在 PancakeSwap 买入）
+ * 5. 利润多跳转账
+ */
+export async function flapBundleCreateToDex(params) {
+    const { chain, devPrivateKey, tokenInfo, tokenAddress, quoteToken, quoteTokenDecimals = 18, curveBuyers, curveTotalBuyAmount, enableDexBuy = false, dexBuyers = [], dexTotalBuyAmount, dexPoolType = 'v3', v3Fee = 2500, config, } = params;
+    // 验证参数
+    if (curveBuyers.length === 0) {
+        throw new Error('至少需要一个内盘买入钱包');
+    }
+    // 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const inputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    // ✅ 计算实际使用的 V3 费率
+    // 优先级：lpFeeProfile > v3Fee > 默认 2500
+    // lpFeeProfile: 0=STANDARD(0.25%), 1=LOW(0.01%), 2=HIGH(1%)
+    let actualV3Fee;
+    if (params.lpFeeProfile !== undefined) {
+        switch (params.lpFeeProfile) {
+            case 1:
+                actualV3Fee = 100;
+                break; // LOW: 0.01%
+            case 2:
+                actualV3Fee = 10000;
+                break; // HIGH: 1%
+            default:
+                actualV3Fee = 2500;
+                break; // STANDARD: 0.25%
+        }
+    }
+    else {
+        actualV3Fee = v3Fee ?? 2500;
+    }
+    // ✅ 获取链配置
+    const chainConfig = getChainConfig(chain);
+    const chainId = chainConfig.chainId;
+    // 创建 Provider
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId,
+        name: chain.toUpperCase(),
+    });
+    const portalAddress = FLAP_PORTAL_ADDRESSES[chain.toUpperCase()];
+    const originalPortalAddress = FLAP_ORIGINAL_PORTAL_ADDRESSES[chain.toUpperCase()];
+    const nonceManager = new NonceManager(provider);
+    // 创建钱包实例
+    const devWallet = new Wallet(devPrivateKey, provider);
+    const curveWallets = curveBuyers.map((b) => ({
+        wallet: new Wallet(b.privateKey, provider),
+        buyAmount: b.buyAmount,
+    }));
+    const dexWallets = (enableDexBuy ? dexBuyers : []).map((b) => ({
+        wallet: new Wallet(b.privateKey, provider),
+        buyAmount: b.buyAmount,
+    }));
+    // ✅ 并行获取 gasPrice + 所有钱包 nonces
+    const allWallets = [devWallet, ...curveWallets.map((c) => c.wallet), ...dexWallets.map((d) => d.wallet)];
+    const uniqueWallets = allWallets.filter((w, i) => {
+        const addr = w.address.toLowerCase();
+        return allWallets.findIndex((x) => x.address.toLowerCase() === addr) === i;
+    });
+    const [gasPrice, noncesArray] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        nonceManager.getNextNoncesForWallets(uniqueWallets),
+    ]);
+    // 构建 nonces Map
+    const noncesMap = new Map();
+    uniqueWallets.forEach((wallet, i) => {
+        noncesMap.set(wallet.address.toLowerCase(), noncesArray[i]);
+    });
+    const finalGasLimit = getGasLimit(config, 800000);
+    const txType = getTxType(config);
+    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 计算内盘买入金额
+    const curveBuyAmounts = resolveBuyerAmounts(curveBuyers, curveTotalBuyAmount, useNativeToken, quoteTokenDecimals);
+    // ✅ 计算外盘买入金额
+    let dexBuyAmounts = [];
+    if (enableDexBuy && dexBuyers.length > 0 && dexTotalBuyAmount) {
+        dexBuyAmounts = resolveBuyerAmounts(dexBuyers, dexTotalBuyAmount, useNativeToken, quoteTokenDecimals);
+    }
+    // ✅ 计算利润
+    const totalBuyAmount = curveBuyAmounts.reduce((a, b) => a + b, 0n) + dexBuyAmounts.reduce((a, b) => a + b, 0n);
+    const profitAmount = (totalBuyAmount * BigInt(getProfitRateBps())) / 10000n;
+    // ==================== 构建交易 ====================
+    const allTransactions = [];
+    // 使用第一个内盘买家作为贿赂支付者（提高 bundle 打包优先级）
+    const mainBuyerWallet = curveWallets[0].wallet;
+    // 1. 贿赂交易
+    if (needBribeTx) {
+        const mainAddr = mainBuyerWallet.address.toLowerCase();
+        const bribeNonce = noncesMap.get(mainAddr);
+        noncesMap.set(mainAddr, bribeNonce + 1);
+        const bribeTx = await mainBuyerWallet.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: GAS_LIMITS.BRIBE,
+            chainId,
+            type: txType,
+        });
+        allTransactions.push(bribeTx);
+    }
+    // 2. 发币交易
+    {
+        const devAddr = devWallet.address.toLowerCase();
+        const devNonce = noncesMap.get(devAddr);
+        noncesMap.set(devAddr, devNonce + 1);
+        const originalPortal = new Contract(originalPortalAddress, PORTAL_ABI, devWallet);
+        const normalizedTax = normalizeTaxLaunchConfig(params.taxV2Config, params.taxRate);
+        const isTaxLaunch = !!normalizedTax || (params.taxRate ?? 0) > 0;
+        const hasVault = !!normalizedTax?.vaultConfig && normalizedTax.vaultConfig.vaultType !== 'none';
+        const useV7Portal = !isTaxLaunch &&
+            !hasVault &&
+            (params.lpFeeProfile !== undefined ||
+                params.dexId !== undefined ||
+                params.migratorType === MigratorType.PCS_INFINITY_CL_MIGRATOR);
+        const createUnsigned = await populateCreateTokenTransaction({
+            chain,
+            devWallet,
+            originalPortal,
+            tokenInfo,
+            quoteToken: inputToken,
+            beneficiary: devWallet.address,
+            dexThresh: params.dexThresh,
+            salt: params.salt,
+            migratorType: params.migratorType,
+            taxRate: params.taxRate,
+            dexId: params.dexId,
+            lpFeeProfile: params.lpFeeProfile,
+            extensionID: params.extensionID,
+            extensionData: params.extensionData,
+            useV7Portal,
+            taxConfig: normalizedTax,
+        });
+        const createTx = {
+            ...createUnsigned,
+            from: devWallet.address,
+            nonce: devNonce,
+            gasLimit: finalGasLimit,
+            chainId,
+            type: txType,
+        };
+        if (txType === 2) {
+            createTx.maxFeePerGas = gasPrice;
+            createTx.maxPriorityFeePerGas = priorityFee;
+        }
+        else {
+            createTx.gasPrice = gasPrice;
+        }
+        const signedCreate = await devWallet.signTransaction(createTx);
+        allTransactions.push(signedCreate);
+    }
+    // 3. 内盘买入交易（包含毕业触发）
+    // 最后一个买入交易会触发毕业，需要更多 gas
+    // ✅ ERC20 需要先 approve，再买入
+    const curveBuyTxPromises = curveWallets.map(async ({ wallet }, i) => {
+        const addr = wallet.address.toLowerCase();
+        const signedTxs = [];
+        // ✅ ERC20: 先构建 approve 交易
+        if (!useNativeToken) {
+            const approveNonce = noncesMap.get(addr);
+            noncesMap.set(addr, approveNonce + 1);
+            const approveTx = await buildApproveTransaction(wallet, quoteToken, portalAddress, curveBuyAmounts[i], approveNonce, gasPrice, txType, chainId);
+            signedTxs.push(approveTx);
+        }
+        // 构建买入交易
+        const buyNonce = noncesMap.get(addr);
+        noncesMap.set(addr, buyNonce + 1);
+        const portal = new Contract(portalAddress, PORTAL_ABI, wallet);
+        // ✅ 交易阶段统一优先使用 swapExactInputV3（支持 extensionData；无扩展时传 0x 即可）
+        // 说明：这里的 V3 指“交易接口版本（扩展支持）”，不是“外盘 V3 池子”
+        const extensionData = params.extensionData ?? '0x';
+        const unsigned = await portal.swapExactInputV3.populateTransaction({
+            inputToken,
+            outputToken: tokenAddress,
+            inputAmount: curveBuyAmounts[i],
+            minOutputAmount: 0n,
+            permitData: '0x', // 不使用 permit，使用链上 approve
+            extensionData,
+        }, useNativeToken ? { value: curveBuyAmounts[i] } : {});
+        // 最后一个买家触发毕业，需要更多 gas
+        const isLastBuyer = i === curveWallets.length - 1;
+        // ⚠️ 触发毕业（创建 Pancake V3 池 + Mint 初始流动性）会非常耗 gas。
+        // 链上成功样例 0x29b173... 的 gasLimit=8,000,000，gasUsed≈6,647,149。
+        // Flap 官方示例脚本也使用 last_buy=8_000_000。
+        const LAST_BUY_GAS_LIMIT = BigInt(8_000_000);
+        const buyGasLimit = isLastBuyer
+            ? finalGasLimit > LAST_BUY_GAS_LIMIT
+                ? finalGasLimit
+                : LAST_BUY_GAS_LIMIT
+            : finalGasLimit;
+        const tx = {
+            ...unsigned,
+            from: wallet.address,
+            nonce: buyNonce,
+            gasLimit: buyGasLimit,
+            chainId,
+            type: txType,
+            value: useNativeToken ? curveBuyAmounts[i] : 0n,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = priorityFee;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        const signedBuy = await wallet.signTransaction(tx);
+        signedTxs.push(signedBuy);
+        return signedTxs;
+    });
+    const curveBuyResults = await Promise.all(curveBuyTxPromises);
+    // 展平数组：每个钱包可能有 [approve, buy] 或只有 [buy]
+    curveBuyResults.forEach((txs) => allTransactions.push(...txs));
+    // 4. 外盘买入交易（直接调用 PancakeSwap Router）
+    // ✅ 重要修改：直接调用 PancakeSwap SmartRouter
+    // 参考官方代码: flap-bundle-release/app/v2/pvp/001_launch_buy.ts
+    //
+    // ⚠️ 关键：税代币（migratorType=1）毕业到 V2 池，必须用 swapExactTokensForTokens
+    //         普通代币（migratorType=0）毕业到 V3 池，使用 exactInputSingle
+    if (enableDexBuy && dexWallets.length > 0) {
+        // 获取 DEX 地址（Base 使用 Uniswap V3 SwapRouter02，BSC 使用 PancakeSwap SmartRouter）
+        let smartRouterAddress;
+        let wrappedNativeAddress;
+        if (chain === 'base') {
+            smartRouterAddress = DEX_ADDRESSES.BASE.UNISWAP_SMART_ROUTER;
+            wrappedNativeAddress = DEX_ADDRESSES.BASE.WETH;
+        }
+        else if (chain === 'xlayer') {
+            smartRouterAddress = DEX_ADDRESSES.XLAYER.PANCAKE_SMART_ROUTER;
+            wrappedNativeAddress = DEX_ADDRESSES.XLAYER.WBNB;
+        }
+        else {
+            smartRouterAddress = DEX_ADDRESSES.BSC.PANCAKE_SMART_ROUTER;
+            wrappedNativeAddress = DEX_ADDRESSES.BSC.WBNB;
+        }
+        // ✅ 根据 migratorType 确定实际的 DEX 池类型
+        // migratorType === 1 (V2_MIGRATOR) → 毕业到 V2 池 → 必须使用 V2 买入
+        // migratorType === 0 (V3_MIGRATOR) → 毕业到 V3 池 → 使用 V3 买入
+        // 参考: flap-bundle-release 中税代币使用 PoolType.V2，普通代币使用 PoolType.V3
+        const effectiveDexPoolType = params.migratorType === 1 ? 'v2' : dexPoolType || 'v3';
+        // 获取 V3 费率（仅 V3 池使用）
+        const dexV3Fee = actualV3Fee;
+        const dexBuyTxPromises = dexWallets.map(async ({ wallet }, i) => {
+            const addr = wallet.address.toLowerCase();
+            const signedTxs = [];
+            const buyAmount = dexBuyAmounts[i];
+            // ✅ ERC20: 先构建 approve 交易（approve 给 PancakeSwap Router）
+            if (!useNativeToken) {
+                const approveNonce = noncesMap.get(addr);
+                noncesMap.set(addr, approveNonce + 1);
+                const approveTx = await buildApproveTransaction(wallet, quoteToken, smartRouterAddress, // ✅ approve 给 PancakeSwap SmartRouter
+                buyAmount, approveNonce, gasPrice, txType, chainId);
+                signedTxs.push(approveTx);
+            }
+            // 构建 PancakeSwap 买入交易（使用 multicall 方式，与官方一致）
+            const buyNonce = noncesMap.get(addr);
+            noncesMap.set(addr, buyNonce + 1);
+            // 对于原生代币（BNB/ETH），使用 Wrapped 版本作为 tokenIn（Router 会自动 wrap）
+            const tokenIn = useNativeToken ? wrappedNativeAddress : quoteToken;
+            const routerInterface = new ethers.Interface(PANCAKE_ROUTER_ABI);
+            let multicallData;
+            if (effectiveDexPoolType === 'v2') {
+                // ✅ V2 池：使用 swapExactTokensForTokens
+                // 参考: flap-bundle-release/app/v2/pvp/001_launch_buy.ts (PoolType.V2 分支)
+                const swapData = routerInterface.encodeFunctionData('swapExactTokensForTokens', [
+                    buyAmount,
+                    0n, // amountOutMin: 不设置滑点保护（Bundle 中可以接受）
+                    [tokenIn, tokenAddress], // path: WBNB/QuoteToken → Token
+                    wallet.address, // recipient
+                ]);
+                multicallData = routerInterface.encodeFunctionData('multicall', [[swapData]]);
+            }
+            else {
+                // ✅ V3 池：使用 exactInputSingle
+                const exactInputSingleParams = {
+                    tokenIn,
+                    tokenOut: tokenAddress,
+                    fee: dexV3Fee, // ✅ 使用与 newTokenV4 创建池子匹配的费率
+                    recipient: wallet.address,
+                    amountIn: buyAmount,
+                    amountOutMinimum: 0n, // 不设置滑点保护（Bundle 中可以接受）
+                    sqrtPriceLimitX96: 0n,
+                };
+                const exactInputSingleData = routerInterface.encodeFunctionData('exactInputSingle', [exactInputSingleParams]);
+                multicallData = routerInterface.encodeFunctionData('multicall', [[exactInputSingleData]]);
+            }
+            // ⚠️ Pancake SmartRouter 外盘买的 gas 不能太小，否则 bundle 预执行会直接失败。
+            // Flap 官方示例配置 dex_buy=5_000_000（flap-bundle-release/app/configs/global.ts）。
+            const DEX_BUY_GAS_LIMIT = BigInt(8_000_000);
+            const tx = {
+                to: smartRouterAddress,
+                data: multicallData,
+                nonce: buyNonce,
+                gasLimit: DEX_BUY_GAS_LIMIT,
+                chainId,
+                type: txType,
+                value: useNativeToken ? buyAmount : 0n,
+            };
+            if (txType === 2) {
+                tx.maxFeePerGas = gasPrice;
+                tx.maxPriorityFeePerGas = priorityFee;
+            }
+            else {
+                tx.gasPrice = gasPrice;
+            }
+            const signedBuy = await wallet.signTransaction(tx);
+            signedTxs.push(signedBuy);
+            return signedTxs;
+        });
+        const dexBuyResults = await Promise.all(dexBuyTxPromises);
+        // 展平数组：每个钱包可能有 [approve, buy] 或只有 [buy]
+        dexBuyResults.forEach((txs) => allTransactions.push(...txs));
+    }
+    // 5. 利润多跳转账
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        // ✅ 调整：利润从 Dev 钱包（devPrivateKey）支付，避免第一个内盘买家余额不足导致 want 过高
+        // 注意：利润交易会额外消耗原生币（profitAmount + gas），请确保 Dev 钱包留足余额
+        const devAddr = devWallet.address.toLowerCase();
+        const profitNonce = noncesMap.get(devAddr);
+        const profitResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: devWallet,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType,
+            startNonce: profitNonce,
+        });
+        allTransactions.push(...profitResult.signedTransactions);
+        profitHopWallets = profitResult.hopWallets;
+    }
+    nonceManager.clearTemp();
+    // 返回结果
+    return {
+        signedTransactions: allTransactions,
+        tokenAddress,
+        profitHopWallets,
+        metadata: {
+            curveBuyerCount: curveBuyers.length,
+            curveTotalBuy: ethers.formatEther(curveBuyAmounts.reduce((a, b) => a + b, 0n)),
+            enableDexBuy,
+            dexBuyerCount: dexBuyers.length,
+            dexTotalBuy: dexBuyAmounts.length > 0 ? ethers.formatEther(dexBuyAmounts.reduce((a, b) => a + b, 0n)) : '0',
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+        },
+    };
+}