four-flap-meme-sdk 1.4.83 → 1.4.85

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

@@ -4,10 +4,11 @@
  * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
  */
 import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
-import { FourSignConfig } from './types.js';
+import { FourSignConfig, UserType } from './types.js';
 import type { GeneratedWallet } from '../../utils/wallet.js';
 export interface FourBuyFirstSignConfig extends FourSignConfig {
     reserveGasBNB?: number;
+    userType?: UserType;
 }
 export interface FourBuyFirstConfig extends CommonBundleConfig {
     apiKey: string;

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

@@ -5,7 +5,7 @@
  */
 import { ethers, Contract, Wallet } from 'ethers';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
-import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA } from '../../utils/constants.js';
+import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, PROFIT_CONFIG } from '../../utils/constants.js';
 import { TM_ABI, HELPER3_ABI, TM_ADDRESS } from './swap-internal.js';
 import { getTxType, getGasPriceConfig, getProfitRecipient, getBribeAmount } from './config.js';
 import { trySell } from '../tm.js';
@@ -26,8 +26,15 @@ const BRIBE_TX_COUNT = 1;
 const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
 /** 最大买卖交易数 */
 const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
-/** 每笔交易利润比例（基点）：6 bps = 0.06% = 万分之六 */
-const PROFIT_RATE_PER_TX_BPS = 6;
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1;
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // v0 或默认
+}
 /**
  * 验证买卖笔数
  */
@@ -104,9 +111,9 @@ export async function fourBundleBuyFirstMerkle(params) {
         throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
     }
     validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例：每笔万分之3
+    // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
-    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
     const chainIdNum = config.chainId ?? 56;
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
         chainId: chainIdNum,
@@ -325,9 +332,9 @@ async function fourBundleBuyFirstMultiWallet(params) {
         throw new Error('卖方钱包数量不能为0');
     // 验证总交易数不超过限制
     validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例：每笔万分之6
+    // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
-    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
     const chainIdNum = config.chainId ?? 56;
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
         chainId: chainIdNum,

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

@@ -5,6 +5,7 @@
  */
 import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
 import { type GeneratedWallet } from '../../utils/wallet.js';
+export type UserType = 'v0' | 'v1';
 export interface FourSwapSignConfig {
     rpcUrl: string;
     gasLimit?: number | bigint;
@@ -14,6 +15,7 @@ export interface FourSwapSignConfig {
     txType?: 0 | 2;
     chainId?: number;
     reserveGasBNB?: number;
+    userType?: UserType;
     bribeAmount?: number;
 }
 export interface FourSwapConfig extends CommonBundleConfig {

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

@@ -7,6 +7,18 @@ import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../../utils/swap-helpers.js';
 import { NonceManager, getOptimizedGasPrice, getGasLimit, getGasPriceConfig, getTxType, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
 import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../../utils/constants.js';
+/**
+ * 根据 userType 计算利润率
+ */
+function getProfitRateBps(userType) {
+    if (userType === 'v0') {
+        return PROFIT_CONFIG.RATE_BPS_V0; // 0.06%
+    }
+    else if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1; // 0.05%
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // 默认 0.06%
+}
 import { TM_ABI, HELPER3_ABI, TM_ADDRESS } from './swap-internal.js';
 import { getBribeAmount, getProfitRecipient } from './config.js';
 import { generateWallets } from '../../utils/wallet.js';
@@ -136,7 +148,7 @@ export async function fourBundleSwapMerkle(params) {
     const needApproval = currentAllowance < APPROVAL_THRESHOLD;
     // 利润配置
     const extractProfit = true;
-    const profitRateBps = PROFIT_CONFIG.RATE_BPS_SWAP;
+    const profitRateBps = getProfitRateBps(config.userType);
     const profitAmount = extractProfit && sellerWillGetBNB > 0n
         ? (sellerWillGetBNB * BigInt(profitRateBps)) / 10000n
         : 0n;
@@ -358,7 +370,7 @@ export async function fourBatchSwapMerkle(params) {
     const APPROVAL_THRESHOLD = ethers.parseUnits('1000000000', decimals);
     const needApproval = currentAllowance < APPROVAL_THRESHOLD;
     // 利润配置
-    const profitRateBps = PROFIT_CONFIG.RATE_BPS_SWAP;
+    const profitRateBps = getProfitRateBps(config.userType);
     const profitAmount = totalBuyerFunds > 0n
         ? (totalBuyerFunds * BigInt(profitRateBps)) / 10000n
         : 0n;
@@ -578,8 +590,8 @@ export async function fourQuickBatchSwapMerkle(params) {
     const estimatedBNBOut = sellQuote.funds;
     console.log(`[fourQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
     console.log(`[fourQuickBatchSwapMerkle] 预估卖出所得: ${ethers.formatEther(estimatedBNBOut)} BNB`);
-    // ✅ 计算利润（万分之六）
-    const profitRateBps = PROFIT_CONFIG.RATE_BPS_SWAP;
+    // ✅ 计算利润（根据 userType 动态调整）
+    const profitRateBps = getProfitRateBps(config.userType);
     const profitAmount = estimatedBNBOut > 0n
         ? (estimatedBNBOut * BigInt(profitRateBps)) / 10000n
         : 0n;

package/dist/contracts/tm-bundle-merkle/types.d.ts

@@ -244,6 +244,12 @@ export type DisperseMerkleParams = {
 export type TokenPoolType = 'flap' | 'four' | 'v2' | 'v3';
 /** 报价代币类型（池子的计价代币） */
 export type QuoteTokenType = 'native' | 'usdt' | 'usdc';
+/**
+ * 用户类型（用于利润费率）
+ * - v0: 万分之6 (6 bps = 0.06%)
+ * - v1: 万分之5 (5 bps = 0.05%)
+ */
+export type UserType = 'v0' | 'v1';
 export type DisperseSignParams = {
     fromPrivateKey: string;
     recipients: string[];
@@ -266,6 +272,8 @@ export type DisperseSignParams = {
     tokenPoolType?: TokenPoolType;
     /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
     quoteToken?: QuoteTokenType;
+    /** ✅ 新增：用户类型（用于利润费率），v0=万分之6，v1=万分之5，默认 v0 */
+    userType?: UserType;
 };
 /**
  * ✅ 分发结果（简化版）
@@ -321,6 +329,8 @@ export type SweepSignParams = {
     tokenPoolType?: TokenPoolType;
     /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
     quoteToken?: QuoteTokenType;
+    /** ✅ 新增：用户类型（用于利润费率），v0=万分之6，v1=万分之5，默认 v0 */
+    userType?: UserType;
 };
 /**
  * ✅ 归集结果（简化版）

package/dist/contracts/tm-bundle-merkle/utils.js

@@ -3,13 +3,23 @@ import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_
 import { PROFIT_CONFIG, ZERO_ADDRESS } from '../../utils/constants.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient } from './config.js';
 import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, normalizeAmounts as _normalizeAmounts, batchGetBalances as _batchGetBalances, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress } from './internal.js';
-// ==================== 本地利润计算（万分之三）====================
 /**
- * 计算利润金额（万分之三）
- * ✅ 归集和分散专用：3 bps = 0.03%
+ * 根据用户类型获取利润费率（bps）
+ * - v0: 万分之6 (6 bps = 0.06%)
+ * - v1: 万分之5 (5 bps = 0.05%)
  */
-function calculateProfit(amount) {
-    const profit = (amount * BigInt(PROFIT_CONFIG.RATE_BPS_CAPITAL)) / 10000n;
+function getProfitRateBps(userType) {
+    if (userType === 'v1')
+        return PROFIT_CONFIG.RATE_BPS_V1; // v1 用户：万分之5
+    return PROFIT_CONFIG.RATE_BPS_V0; // v0 用户（默认）：万分之6
+}
+/**
+ * 计算利润金额
+ * ✅ 归集和分散专用：根据 userType 使用不同费率
+ */
+function calculateProfit(amount, userType) {
+    const rateBps = getProfitRateBps(userType);
+    const profit = (amount * BigInt(rateBps)) / 10000n;
     const remaining = amount - profit;
     return { profit, remaining };
 }
@@ -196,7 +206,7 @@ async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainI
  * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
  */
 export async function disperseWithBundleMerkle(params) {
-    const { fromPrivateKey, recipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native' } = params;
+    const { fromPrivateKey, recipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native', userType = 'v0' } = params;
     // 快速返回空结果
     if (!recipients || recipients.length === 0) {
         return {
@@ -268,7 +278,7 @@ export async function disperseWithBundleMerkle(params) {
                 totalAmountBeforeProfit += originalAmount;
                 let actualAmount = originalAmount;
                 if (extractProfit) {
-                    const { profit, remaining } = calculateProfit(originalAmount);
+                    const { profit, remaining } = calculateProfit(originalAmount, userType);
                     actualAmount = remaining;
                     totalProfit += profit;
                 }
@@ -313,7 +323,7 @@ export async function disperseWithBundleMerkle(params) {
                 totalAmountBeforeProfit += originalAmount;
                 let actualAmount = originalAmount;
                 if (extractProfit) {
-                    const { profit, remaining } = calculateProfit(originalAmount);
+                    const { profit, remaining } = calculateProfit(originalAmount, userType);
                     actualAmount = remaining;
                     totalTokenProfit += profit; // 累计 ERC20 代币利润
                 }
@@ -410,7 +420,7 @@ export async function disperseWithBundleMerkle(params) {
             totalAmountBeforeProfit += originalAmountWei;
             let amountWei = originalAmountWei;
             if (extractProfit) {
-                const { profit, remaining } = calculateProfit(originalAmountWei);
+                const { profit, remaining } = calculateProfit(originalAmountWei, userType);
                 amountWei = remaining;
                 if (isNative) {
                     totalProfit += profit; // 原生币直接累加
@@ -631,7 +641,7 @@ export async function disperseWithBundleMerkle(params) {
  * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
  */
 export async function sweepWithBundleMerkle(params) {
-    const { sourcePrivateKeys, target, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native' } = params;
+    const { sourcePrivateKeys, target, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native', userType = 'v0' } = params;
     // 快速返回空结果
     if (!sourcePrivateKeys || sourcePrivateKeys.length === 0) {
         return {
@@ -754,7 +764,7 @@ export async function sweepWithBundleMerkle(params) {
                 }
                 // 累计总利润
                 if (extractProfit && toSend > 0n) {
-                    const { profit } = calculateProfit(toSend);
+                    const { profit } = calculateProfit(toSend, userType);
                     totalProfit += profit;
                 }
             }
@@ -772,7 +782,7 @@ export async function sweepWithBundleMerkle(params) {
                     totalProfit = 0n;
                     for (let i = 0; i < sweepAmounts.length; i++) {
                         if (sweepAmounts[i] > 0n) {
-                            totalProfit += calculateProfit(sweepAmounts[i]).profit;
+                            totalProfit += calculateProfit(sweepAmounts[i], userType).profit;
                         }
                     }
                 }
@@ -907,7 +917,7 @@ export async function sweepWithBundleMerkle(params) {
                 }
                 // 累计总代币利润（ERC20 归集）
                 if (extractProfit && toSend > 0n) {
-                    const { profit } = calculateProfit(toSend);
+                    const { profit } = calculateProfit(toSend, userType);
                     totalProfit += profit; // 先累计代币利润
                 }
             }
@@ -1329,7 +1339,7 @@ export async function sweepWithBundleMerkle(params) {
             let totalTokenProfit = 0n;
             for (let i = 0; i < sweepAmounts.length; i++) {
                 if (sweepAmounts[i] > 0n) {
-                    const { profit } = calculateProfit(sweepAmounts[i]);
+                    const { profit } = calculateProfit(sweepAmounts[i], userType);
                     if (isNative) {
                         totalProfit += profit;
                     }

package/dist/flap/constants.d.ts

@@ -27,7 +27,7 @@ export declare const FLAP_ORIGINAL_PORTAL_ADDRESSES: {
  */
 export declare const FLAP_TOKEN_IMPL_ADDRESSES: {
     readonly BSC_NORMAL: "0x8b4329947e34b6d56d71a3385cac122bade7d78d";
-    readonly BSC_TAXED: "0x5dd913731C12aD8DF3E574859FDe45412bF4aaD9";
+    readonly BSC_TAXED: "0x29e6383F0ce68507b5A72a53c2B118a118332aA8";
     readonly BASE: "0xF3c514E04f83166E80718f29f0d34F206be40A0A";
     readonly XLAYER: "0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9";
     readonly MORPH: "0x8b4329947e34b6d56d71a3385cac122bade7d78d";

package/dist/flap/constants.js

@@ -29,7 +29,7 @@ export const FLAP_ORIGINAL_PORTAL_ADDRESSES = {
  */
 export const FLAP_TOKEN_IMPL_ADDRESSES = {
     BSC_NORMAL: '0x8b4329947e34b6d56d71a3385cac122bade7d78d',
-    BSC_TAXED: '0x5dd913731C12aD8DF3E574859FDe45412bF4aaD9',
+    BSC_TAXED: '0x29e6383F0ce68507b5A72a53c2B118a118332aA8', // 官方文档: https://docs.flap.sh/flap/developers/deployed-contract-addresses
     BASE: '0xF3c514E04f83166E80718f29f0d34F206be40A0A',
     XLAYER: '0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9',
     MORPH: '0x8b4329947e34b6d56d71a3385cac122bade7d78d', // 暂时使用 BSC NORMAL 地址

package/dist/flap/portal-bundle-merkle/core.js

@@ -83,10 +83,37 @@ export async function createTokenWithBundleBuyMerkle(params) {
     const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
     const originalPortalAddr = FLAP_ORIGINAL_PORTAL_ADDRESSES[chain];
     const portal = new ethers.Contract(originalPortalAddr, PORTAL_ABI, devWallet);
-    const useV3 = !!params.extensionID;
+    // ✅ 判断使用哪个版本的 newToken
+    // V4: 提供了 dexId 或 lpFeeProfile（支持 DEX 选择和 LP 费率配置）
+    // V3: 提供了 extensionID（支持扩展数据）
+    // V2: 默认
+    const useV4 = params.dexId !== undefined || params.lpFeeProfile !== undefined;
+    const useV3 = !useV4 && !!params.extensionID;
     // ✅ 优化：并行获取 gasPrice、devWallet nonce 和 createTx
-    const createTxPromise = useV3
-        ? portal.newTokenV3.populateTransaction({
+    let createTxPromise;
+    if (useV4) {
+        // V4: 支持 DEX ID 和 LP 费率配置
+        createTxPromise = portal.newTokenV4.populateTransaction({
+            name: tokenInfo.name,
+            symbol: tokenInfo.symbol,
+            meta: tokenInfo.meta,
+            dexThresh: (params.dexThresh ?? 1) & 0xff,
+            salt: params.salt ?? '0x' + '00'.repeat(32),
+            taxRate: (params.taxRate ?? 0) & 0xffff,
+            migratorType: (params.migratorType ?? 0) & 0xff,
+            quoteToken: params.quoteToken || ZERO_ADDRESS,
+            quoteAmt: 0n,
+            beneficiary: devWallet.address,
+            permitData: '0x',
+            extensionID: params.extensionID ?? '0x' + '00'.repeat(32),
+            extensionData: params.extensionData ?? '0x',
+            dexId: (params.dexId ?? 0) & 0xff,
+            lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff
+        });
+    }
+    else if (useV3) {
+        // V3: 支持扩展数据
+        createTxPromise = portal.newTokenV3.populateTransaction({
             name: tokenInfo.name,
             symbol: tokenInfo.symbol,
             meta: tokenInfo.meta,
@@ -100,8 +127,11 @@ export async function createTokenWithBundleBuyMerkle(params) {
             permitData: '0x',
             extensionID: params.extensionID,
             extensionData: params.extensionData ?? '0x'
-        })
-        : portal.newTokenV2.populateTransaction({
+        });
+    }
+    else {
+        // V2: 基础版本
+        createTxPromise = portal.newTokenV2.populateTransaction({
             name: tokenInfo.name,
             symbol: tokenInfo.symbol,
             meta: tokenInfo.meta,
@@ -114,6 +144,7 @@ export async function createTokenWithBundleBuyMerkle(params) {
             beneficiary: devWallet.address,
             permitData: '0x'
         });
+    }
     const [gasPrice, createTxUnsigned, devNonce] = await Promise.all([
         resolveGasPrice(provider, config),
         createTxPromise,

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

@@ -66,6 +66,14 @@ export interface FlapCreateToDexParams {
     migratorType?: number;
     taxRate?: number;
     salt?: string;
+    /** V4 参数：DEX ID（0=DEX0, 1=DEX1, 2=DEX2） */
+    dexId?: number;
+    /** V4 参数：LP 费率档位（0=STANDARD 0.25%, 1=LOW 0.01%, 2=HIGH 1%） */
+    lpFeeProfile?: number;
+    /** V3 扩展 ID */
+    extensionID?: string;
+    /** V3 扩展数据 */
+    extensionData?: string;
     /** 配置 */
     config: CreateToDexSignConfig;
 }

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

@@ -12,6 +12,19 @@ import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_
 import { FLAP_PORTAL_ADDRESSES, FLAP_ORIGINAL_PORTAL_ADDRESSES } from '../constants.js';
 import { PROFIT_CONFIG, ADDRESSES, ZERO_ADDRESS } from '../../utils/constants.js';
 import { getGasPriceConfig, getTxType, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI } from './config.js';
+// ==================== ERC20 ABI ====================
+const ERC20_ABI = [
+    {
+        type: "function",
+        name: "approve",
+        inputs: [
+            { name: "spender", type: "address" },
+            { name: "amount", type: "uint256" }
+        ],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "nonpayable"
+    }
+];
 // ==================== 链常量 ====================
 const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
 const BSC_PANCAKE_V3_ROUTER = ADDRESSES.BSC.PancakeV3Router;
@@ -57,9 +70,36 @@ const PANCAKE_V3_ROUTER_ABI = [
         ],
         "outputs": [{ "name": "amountOut", "type": "uint256" }],
         "stateMutability": "payable"
-    }
+    },
 ];
+// ==================== V3 费率配置 ====================
+// USD1/USDT 使用 100 bps (0.01%)，其他使用 2500 bps (0.25%)
+const USD1_V3_FEE = 100;
+const DEFAULT_V3_FEE = 2500;
 // ==================== 工具函数 ====================
+/** 构建 ERC20 approve 交易 */
+async function buildApproveTransaction(wallet, tokenAddress, spenderAddress, amount, nonce, gasPrice, txType) {
+    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(100000), // approve 交易 gas 较低
+        chainId: 56,
+        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);
+}
 function getGasLimit(config, defaultGas = 800000) {
     if (config.gasLimit !== undefined) {
         return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
@@ -199,19 +239,67 @@ export async function flapBundleCreateToDex(params) {
         const devNonce = noncesMap.get(devAddr);
         noncesMap.set(devAddr, devNonce + 1);
         const originalPortal = new Contract(originalPortalAddress, PORTAL_ABI, devWallet);
-        const createUnsigned = await originalPortal.newTokenV2.populateTransaction({
-            name: tokenInfo.name,
-            symbol: tokenInfo.symbol,
-            meta: tokenInfo.meta,
-            dexThresh: (params.dexThresh ?? 1) & 0xff,
-            salt: params.salt ?? '0x' + '00'.repeat(32),
-            taxRate: (params.taxRate ?? 0) & 0xffff,
-            migratorType: (params.migratorType ?? 0) & 0xff,
-            quoteToken: inputToken,
-            quoteAmt: 0n,
-            beneficiary: devWallet.address,
-            permitData: '0x'
-        });
+        // ✅ 判断使用哪个版本的 newToken
+        // V4: 提供了 dexId 或 lpFeeProfile（支持 DEX 选择和 LP 费率配置）
+        // V3: 提供了 extensionID（支持扩展数据）
+        // V2: 默认
+        const useV4 = params.dexId !== undefined || params.lpFeeProfile !== undefined;
+        const useV3 = !useV4 && !!params.extensionID;
+        let createUnsigned;
+        if (useV4) {
+            // V4: 支持 DEX ID 和 LP 费率配置（用于选择池子费率）
+            createUnsigned = await originalPortal.newTokenV4.populateTransaction({
+                name: tokenInfo.name,
+                symbol: tokenInfo.symbol,
+                meta: tokenInfo.meta,
+                dexThresh: (params.dexThresh ?? 1) & 0xff,
+                salt: params.salt ?? '0x' + '00'.repeat(32),
+                taxRate: (params.taxRate ?? 0) & 0xffff,
+                migratorType: (params.migratorType ?? 0) & 0xff,
+                quoteToken: inputToken,
+                quoteAmt: 0n,
+                beneficiary: devWallet.address,
+                permitData: '0x',
+                extensionID: params.extensionID ?? '0x' + '00'.repeat(32),
+                extensionData: params.extensionData ?? '0x',
+                dexId: (params.dexId ?? 0) & 0xff,
+                lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff
+            });
+        }
+        else if (useV3) {
+            // V3: 支持扩展数据
+            createUnsigned = await originalPortal.newTokenV3.populateTransaction({
+                name: tokenInfo.name,
+                symbol: tokenInfo.symbol,
+                meta: tokenInfo.meta,
+                dexThresh: (params.dexThresh ?? 1) & 0xff,
+                salt: params.salt ?? '0x' + '00'.repeat(32),
+                taxRate: (params.taxRate ?? 0) & 0xffff,
+                migratorType: (params.migratorType ?? 0) & 0xff,
+                quoteToken: inputToken,
+                quoteAmt: 0n,
+                beneficiary: devWallet.address,
+                permitData: '0x',
+                extensionID: params.extensionID,
+                extensionData: params.extensionData ?? '0x'
+            });
+        }
+        else {
+            // V2: 基础版本
+            createUnsigned = await originalPortal.newTokenV2.populateTransaction({
+                name: tokenInfo.name,
+                symbol: tokenInfo.symbol,
+                meta: tokenInfo.meta,
+                dexThresh: (params.dexThresh ?? 1) & 0xff,
+                salt: params.salt ?? '0x' + '00'.repeat(32),
+                taxRate: (params.taxRate ?? 0) & 0xffff,
+                migratorType: (params.migratorType ?? 0) & 0xff,
+                quoteToken: inputToken,
+                quoteAmt: 0n,
+                beneficiary: devWallet.address,
+                permitData: '0x'
+            });
+        }
         const createTx = {
             ...createUnsigned,
             from: devWallet.address,
@@ -232,17 +320,27 @@ export async function flapBundleCreateToDex(params) {
     }
     // 3. 内盘买入交易（包含毕业触发）
     // 最后一个买入交易会触发毕业，需要更多 gas
+    // ✅ ERC20 需要先 approve，再买入
     const curveBuyTxPromises = curveWallets.map(async ({ wallet }, i) => {
         const addr = wallet.address.toLowerCase();
-        const nonce = noncesMap.get(addr);
-        noncesMap.set(addr, nonce + 1);
+        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);
+            signedTxs.push(approveTx);
+        }
+        // 构建买入交易
+        const buyNonce = noncesMap.get(addr);
+        noncesMap.set(addr, buyNonce + 1);
         const portal = new Contract(portalAddress, PORTAL_ABI, wallet);
         const unsigned = await portal.swapExactInput.populateTransaction({
             inputToken,
             outputToken: tokenAddress,
             inputAmount: curveBuyAmounts[i],
             minOutputAmount: 0n,
-            permitData: '0x'
+            permitData: '0x' // 不使用 permit，使用链上 approve
         }, useNativeToken ? { value: curveBuyAmounts[i] } : {});
         // 最后一个买家触发毕业，需要更多 gas
         const isLastBuyer = i === curveWallets.length - 1;
@@ -250,7 +348,7 @@ export async function flapBundleCreateToDex(params) {
         const tx = {
             ...unsigned,
             from: wallet.address,
-            nonce,
+            nonce: buyNonce,
             gasLimit: buyGasLimit,
             chainId: 56,
             type: txType,
@@ -263,67 +361,63 @@ export async function flapBundleCreateToDex(params) {
         else {
             tx.gasPrice = gasPrice;
         }
-        return wallet.signTransaction(tx);
+        const signedBuy = await wallet.signTransaction(tx);
+        signedTxs.push(signedBuy);
+        return signedTxs;
     });
-    const signedCurveBuys = await Promise.all(curveBuyTxPromises);
-    allTransactions.push(...signedCurveBuys);
+    const curveBuyResults = await Promise.all(curveBuyTxPromises);
+    // 展平数组：每个钱包可能有 [approve, buy] 或只有 [buy]
+    curveBuyResults.forEach(txs => allTransactions.push(...txs));
     // 4. 外盘买入交易（PancakeSwap）
+    // ✅ ERC20 需要先 approve，再 swap
     if (enableDexBuy && dexWallets.length > 0) {
         const dexBuyTxPromises = dexWallets.map(async ({ wallet }, i) => {
             const addr = wallet.address.toLowerCase();
-            const nonce = noncesMap.get(addr);
-            noncesMap.set(addr, nonce + 1);
+            const signedTxs = [];
             const buyAmount = dexBuyAmounts[i];
             const smartRouter = dexPoolType === 'v3' ? BSC_PANCAKE_V3_ROUTER : BSC_PANCAKE_V2_ROUTER;
-            let calldata;
+            // ✅ 根据 quoteToken 选择 V3 费率
+            const actualV3Fee = v3Fee || (useNativeToken ? DEFAULT_V3_FEE : USD1_V3_FEE);
+            // ✅ ERC20: 先构建 approve 交易
+            if (!useNativeToken) {
+                const approveNonce = noncesMap.get(addr);
+                noncesMap.set(addr, approveNonce + 1);
+                const approveTx = await buildApproveTransaction(wallet, quoteToken, smartRouter, buyAmount, approveNonce, gasPrice, txType);
+                signedTxs.push(approveTx);
+            }
+            // 构建买入交易
+            const buyNonce = noncesMap.get(addr);
+            noncesMap.set(addr, buyNonce + 1);
+            let multicallData = [];
             let value;
+            const routerInterface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
             if (dexPoolType === 'v3') {
-                if (useNativeToken) {
-                    const params = {
-                        tokenIn: BSC_WBNB,
-                        tokenOut: tokenAddress,
-                        fee: v3Fee,
-                        recipient: wallet.address,
-                        amountIn: buyAmount,
-                        amountOutMinimum: 0n,
-                        sqrtPriceLimitX96: 0n
-                    };
-                    const exactInputSingleData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('exactInputSingle', [params]);
-                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [[exactInputSingleData]]);
-                    value = buyAmount;
-                }
-                else {
-                    const params = {
-                        tokenIn: quoteToken,
-                        tokenOut: tokenAddress,
-                        fee: v3Fee,
-                        recipient: wallet.address,
-                        amountIn: buyAmount,
-                        amountOutMinimum: 0n,
-                        sqrtPriceLimitX96: 0n
-                    };
-                    const exactInputSingleData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('exactInputSingle', [params]);
-                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [[exactInputSingleData]]);
-                    value = 0n;
-                }
+                // V3: exactInputSingle
+                const params = {
+                    tokenIn: useNativeToken ? BSC_WBNB : quoteToken,
+                    tokenOut: tokenAddress,
+                    fee: actualV3Fee,
+                    recipient: wallet.address,
+                    amountIn: buyAmount,
+                    amountOutMinimum: 0n,
+                    sqrtPriceLimitX96: 0n
+                };
+                multicallData = [routerInterface.encodeFunctionData('exactInputSingle', [params])];
+                value = useNativeToken ? buyAmount : 0n;
             }
             else {
-                if (useNativeToken) {
-                    const swapData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('swapExactTokensForTokens', [buyAmount, 0n, [BSC_WBNB, tokenAddress], wallet.address]);
-                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [[swapData]]);
-                    value = buyAmount;
-                }
-                else {
-                    const swapData = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('swapExactTokensForTokens', [buyAmount, 0n, [quoteToken, tokenAddress], wallet.address]);
-                    calldata = new ethers.Interface(PANCAKE_V3_ROUTER_ABI).encodeFunctionData('multicall', [[swapData]]);
-                    value = 0n;
-                }
+                // V2: swapExactTokensForTokens
+                const path = useNativeToken ? [BSC_WBNB, tokenAddress] : [quoteToken, tokenAddress];
+                const swapData = routerInterface.encodeFunctionData('swapExactTokensForTokens', [buyAmount, 0n, path, wallet.address]);
+                multicallData = [swapData];
+                value = useNativeToken ? buyAmount : 0n;
             }
+            const calldata = routerInterface.encodeFunctionData('multicall', [multicallData]);
             const tx = {
                 to: smartRouter,
                 data: calldata,
                 from: wallet.address,
-                nonce,
+                nonce: buyNonce,
                 gasLimit: BigInt(500000),
                 chainId: 56,
                 type: txType,
@@ -336,10 +430,13 @@ export async function flapBundleCreateToDex(params) {
             else {
                 tx.gasPrice = gasPrice;
             }
-            return wallet.signTransaction(tx);
+            const signedBuy = await wallet.signTransaction(tx);
+            signedTxs.push(signedBuy);
+            return signedTxs;
         });
-        const signedDexBuys = await Promise.all(dexBuyTxPromises);
-        allTransactions.push(...signedDexBuys);
+        const dexBuyResults = await Promise.all(dexBuyTxPromises);
+        // 展平数组：每个钱包可能有 [approve, buy] 或只有 [buy]
+        dexBuyResults.forEach(txs => allTransactions.push(...txs));
     }
     // 5. 利润多跳转账
     let profitHopWallets;

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

@@ -7,9 +7,11 @@ import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
 import { FlapSignConfig } from './config.js';
 import type { GeneratedWallet } from '../../utils/wallet.js';
 export type FlapChain = 'bsc' | 'xlayer' | 'base';
+export type UserType = 'v0' | 'v1';
 export interface FlapBuyFirstSignConfig extends FlapSignConfig {
     reserveGasETH?: number;
     skipQuoteOnError?: boolean;
+    userType?: UserType;
 }
 export interface FlapBuyFirstConfig extends CommonBundleConfig {
     apiKey: string;

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

@@ -66,8 +66,15 @@ const BRIBE_TX_COUNT = 1;
 const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
 /** 最大买卖交易数 */
 const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
-/** 每笔交易利润比例（基点）：6 bps = 0.06% = 万分之六 */
-const PROFIT_RATE_PER_TX_BPS = 6;
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1;
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // v0 或默认
+}
 /**
  * 验证买卖笔数
  */
@@ -124,9 +131,9 @@ export async function flapBundleBuyFirstMerkle(params) {
         throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
     }
     validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例：每笔万分之3
+    // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
-    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
     const chainContext = createChainContext(chain, config.rpcUrl);
     const buyer = new Wallet(buyerPrivateKey, chainContext.provider);
     const seller = new Wallet(sellerPrivateKey, chainContext.provider);
@@ -404,12 +411,21 @@ async function estimateSellFunds(portal, tokenAddress, sellAmountWei, outputToke
         return 0n;
     }
 }
-function calculateProfitAmount(expectedFunds) {
+/**
+ * 根据 userType 获取利润率（基点）
+ */
+function getProfitRateBps(userType) {
+    if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1; // 0.05%
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // v0 或默认 0.06%
+}
+function calculateProfitAmount(expectedFunds, userType) {
     if (expectedFunds <= 0n) {
         return 0n;
     }
-    // 万分之六
-    return (expectedFunds * BigInt(PROFIT_CONFIG.RATE_BPS_SWAP)) / 10000n;
+    const rateBps = getProfitRateBps(userType);
+    return (expectedFunds * BigInt(rateBps)) / 10000n;
 }
 /**
  * 计算多笔交易的利润金额
@@ -621,9 +637,9 @@ async function flapBundleBuyFirstMultiWallet(params) {
         throw new Error('卖方钱包数量不能为0');
     // 验证总交易数不超过限制
     validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例：每笔万分之6
+    // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
-    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
     const chainContext = createChainContext(chain, config.rpcUrl);
     const nonceManager = new NonceManager(chainContext.provider);
     // 创建所有钱包实例

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

@@ -5,6 +5,7 @@
  */
 import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
 import { type GeneratedWallet } from '../../utils/wallet.js';
+export type UserType = 'v0' | 'v1';
 export interface FlapSwapSignConfig {
     rpcUrl: string;
     gasLimit?: number | bigint;
@@ -17,6 +18,7 @@ export interface FlapSwapSignConfig {
     skipQuoteOnError?: boolean;
     skipApprovalCheck?: boolean;
     bribeAmount?: number;
+    userType?: UserType;
 }
 export type FlapChain = 'bsc' | 'xlayer' | 'base';
 export interface FlapSwapConfig extends CommonBundleConfig {

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

@@ -305,8 +305,8 @@ export async function flapBundleSwapMerkle(params) {
         quoteTokenDecimals,
         provider: chainContext.provider
     });
-    // ✅ 计算利润（基于卖出报价）
-    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative);
+    // ✅ 计算利润（基于卖出报价，根据 userType 动态调整）
+    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative, config.userType);
     // ✅ ERC20 输出：获取代币利润等值的原生代币（BNB）报价
     let nativeProfitAmount = tokenProfitAmount; // 原生代币输出时直接使用
     if (!useNativeToken && tokenProfitAmount > 0n) {
@@ -642,11 +642,24 @@ async function buildProfitTransaction({ provider, seller, profitAmount, profitNo
         hopWallets: profitHopResult.hopWallets
     };
 }
-function calculateProfitAmount(quotedNative) {
+/**
+ * 根据 userType 计算利润率
+ */
+function getProfitRateBps(userType) {
+    if (userType === 'v0') {
+        return PROFIT_CONFIG.RATE_BPS_V0; // 0.06%
+    }
+    else if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1; // 0.05%
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // 默认 0.06%
+}
+function calculateProfitAmount(quotedNative, userType) {
     if (quotedNative <= 0n) {
         return 0n;
     }
-    return (quotedNative * BigInt(PROFIT_CONFIG.RATE_BPS_SWAP)) / 10000n;
+    const rateBps = getProfitRateBps(userType);
+    return (quotedNative * BigInt(rateBps)) / 10000n;
 }
 function countTruthy(values) {
     return values.filter(Boolean).length;
@@ -740,8 +753,8 @@ export async function flapBatchSwapMerkle(params) {
             }
         }
     }));
-    // ✅ 计算利润
-    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative);
+    // ✅ 计算利润（根据 userType 动态调整）
+    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative, config.userType);
     let nativeProfitAmount = tokenProfitAmount;
     if (!useNativeToken && tokenProfitAmount > 0n) {
         nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, quoteToken, tokenProfitAmount, chainContext.chainId);
@@ -952,8 +965,8 @@ export async function flapQuickBatchSwapMerkle(params) {
     console.log(`[flapQuickBatchSwapMerkle] 模式: ${useNativeToken ? '原生代币' : 'ERC20'}`);
     console.log(`[flapQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
     console.log(`[flapQuickBatchSwapMerkle] 预估卖出所得: ${outputFormatted}`);
-    // ✅ 计算利润（万分之六）
-    let tokenProfitAmount = calculateProfitAmount(estimatedOutput);
+    // ✅ 计算利润（根据 userType 动态调整）
+    let tokenProfitAmount = calculateProfitAmount(estimatedOutput, config.userType);
     let nativeProfitAmount = tokenProfitAmount;
     if (!useNativeToken && tokenProfitAmount > 0n) {
         // ERC20 模式：将代币利润转换为等值原生代币

package/dist/flap/portal-bundle-merkle/types.d.ts

@@ -106,6 +106,10 @@ export type FlapCreateWithBundleBuySignParams = {
     salt?: string;
     extensionID?: string;
     extensionData?: string;
+    /** DEX ID：0=DEX0, 1=DEX1, 2=DEX2（BSC: DEX0=PancakeSwap, Monad: DEX0=Uniswap, DEX1=PancakeSwap） */
+    dexId?: number;
+    /** LP 费率档位：0=STANDARD(0.25%), 1=LOW(0.01%), 2=HIGH(1%) */
+    lpFeeProfile?: number;
 };
 /**
  * ✅ Flap 创建代币 + 购买结果（简化版）

package/dist/flap/portal.d.ts

@@ -25,6 +25,30 @@ export declare enum MigratorType {
     V3_MIGRATOR = 0,
     V2_MIGRATOR = 1
 }
+/**
+ * V3 LP 费率档位
+ * 决定代币迁移到 Uniswap V3 或 PancakeSwap V3 时使用的费率
+ */
+export declare enum V3LPFeeProfile {
+    /** 标准费率: PancakeSwap 0.25%, Uniswap 0.3% */
+    LP_FEE_PROFILE_STANDARD = 0,
+    /** 低费率: PancakeSwap 0.01%, Uniswap 0.05% (BNB 链需要白名单) */
+    LP_FEE_PROFILE_LOW = 1,
+    /** 高费率: 1% (适用于特殊交易对) */
+    LP_FEE_PROFILE_HIGH = 2
+}
+/**
+ * DEX ID
+ * 决定代币迁移到哪个 DEX
+ * - BSC: DEX0 = PancakeSwap
+ * - xLayer: DEX0 = PotatoSwap
+ * - Monad: DEX0 = Uniswap, DEX1 = PancakeSwap, DEX2 = Monday
+ */
+export declare enum DEXId {
+    DEX0 = 0,
+    DEX1 = 1,
+    DEX2 = 2
+}
 export type TokenStateV2 = {
     status: number;
     reserve: bigint;
@@ -120,6 +144,27 @@ export type NewTokenV3Params = {
     extensionID: string;
     extensionData?: string;
 };
+/**
+ * newTokenV4 参数
+ * 相比 V3 新增了 DEX 选择和 LP 费率配置
+ */
+export type NewTokenV4Params = {
+    name: string;
+    symbol: string;
+    meta: string;
+    dexThresh: number;
+    salt: string;
+    taxRate: number;
+    migratorType: number;
+    quoteToken: string;
+    quoteAmt: bigint;
+    beneficiary: string;
+    permitData?: string;
+    extensionID: string;
+    extensionData?: string;
+    dexId: number;
+    lpFeeProfile: number;
+};
 export declare class FlapPortal {
     private rpcUrl;
     protected portal: string;
@@ -174,6 +219,39 @@ export declare class FlapPortalWriter extends FlapPortal {
     newTokenV3(args: NewTokenV3Params & {
         msgValue?: bigint;
     }): Promise<any>;
+    /**
+     * 创建代币 V4 版本
+     * 相比 V3 新增了 DEX 选择和 LP 费率配置
+     *
+     * @param args 创建代币参数
+     * @param args.dexId DEX ID，选择迁移到哪个 DEX（使用 DEXId 枚举）
+     * @param args.lpFeeProfile LP 费率档位（使用 V3LPFeeProfile 枚举）
+     *
+     * @example
+     * ```typescript
+     * await portal.newTokenV4({
+     *   name: 'My Token',
+     *   symbol: 'MTK',
+     *   meta: 'bafkreicwlkpvrcqg4bbhyp2fnhdwbqos5ghka6gdjra3tdkgxxs74hqsze',
+     *   dexThresh: DexThreshType.FOUR_FIFTHS,
+     *   salt: '0x...',
+     *   taxRate: 0,
+     *   migratorType: MigratorType.V3_MIGRATOR,
+     *   quoteToken: '0x0000000000000000000000000000000000000000',
+     *   quoteAmt: 0n,
+     *   beneficiary: '0x...',
+     *   extensionID: '0x0000000000000000000000000000000000000000000000000000000000000000',
+     *   dexId: DEXId.DEX0,
+     *   lpFeeProfile: V3LPFeeProfile.LP_FEE_PROFILE_STANDARD,
+     *   msgValue: parseEther('0.01'),
+     * });
+     * ```
+     *
+     * @note BNB 链上使用 LP_FEE_PROFILE_LOW (0.01%) 需要白名单地址
+     */
+    newTokenV4(args: NewTokenV4Params & {
+        msgValue?: bigint;
+    }): Promise<any>;
     claim(token: string): Promise<{
         txHash: string;
         tokenAmount: bigint;

package/dist/flap/portal.js

@@ -31,6 +31,32 @@ export var MigratorType;
     MigratorType[MigratorType["V3_MIGRATOR"] = 0] = "V3_MIGRATOR";
     MigratorType[MigratorType["V2_MIGRATOR"] = 1] = "V2_MIGRATOR";
 })(MigratorType || (MigratorType = {}));
+/**
+ * V3 LP 费率档位
+ * 决定代币迁移到 Uniswap V3 或 PancakeSwap V3 时使用的费率
+ */
+export var V3LPFeeProfile;
+(function (V3LPFeeProfile) {
+    /** 标准费率: PancakeSwap 0.25%, Uniswap 0.3% */
+    V3LPFeeProfile[V3LPFeeProfile["LP_FEE_PROFILE_STANDARD"] = 0] = "LP_FEE_PROFILE_STANDARD";
+    /** 低费率: PancakeSwap 0.01%, Uniswap 0.05% (BNB 链需要白名单) */
+    V3LPFeeProfile[V3LPFeeProfile["LP_FEE_PROFILE_LOW"] = 1] = "LP_FEE_PROFILE_LOW";
+    /** 高费率: 1% (适用于特殊交易对) */
+    V3LPFeeProfile[V3LPFeeProfile["LP_FEE_PROFILE_HIGH"] = 2] = "LP_FEE_PROFILE_HIGH";
+})(V3LPFeeProfile || (V3LPFeeProfile = {}));
+/**
+ * DEX ID
+ * 决定代币迁移到哪个 DEX
+ * - BSC: DEX0 = PancakeSwap
+ * - xLayer: DEX0 = PotatoSwap
+ * - Monad: DEX0 = Uniswap, DEX1 = PancakeSwap, DEX2 = Monday
+ */
+export var DEXId;
+(function (DEXId) {
+    DEXId[DEXId["DEX0"] = 0] = "DEX0";
+    DEXId[DEXId["DEX1"] = 1] = "DEX1";
+    DEXId[DEXId["DEX2"] = 2] = "DEX2";
+})(DEXId || (DEXId = {}));
 // Portal ABI (使用 ethers 标准格式)
 const PORTAL_ABI = [
     // Token 状态查询
@@ -52,6 +78,7 @@ const PORTAL_ABI = [
     // 创建代币
     'function newTokenV2((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData)) external payable returns (address)',
     'function newTokenV3((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData)) external payable returns (address)',
+    'function newTokenV4((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile)) external payable returns (address)',
     // 受益人领取
     'function claim(address token) external returns (uint256,uint256)',
     'function delegateClaim(address token) external returns (uint256,uint256)',
@@ -315,6 +342,56 @@ export class FlapPortalWriter extends FlapPortal {
         }, { value: args.msgValue });
         return await tx.wait();
     }
+    /**
+     * 创建代币 V4 版本
+     * 相比 V3 新增了 DEX 选择和 LP 费率配置
+     *
+     * @param args 创建代币参数
+     * @param args.dexId DEX ID，选择迁移到哪个 DEX（使用 DEXId 枚举）
+     * @param args.lpFeeProfile LP 费率档位（使用 V3LPFeeProfile 枚举）
+     *
+     * @example
+     * ```typescript
+     * await portal.newTokenV4({
+     *   name: 'My Token',
+     *   symbol: 'MTK',
+     *   meta: 'bafkreicwlkpvrcqg4bbhyp2fnhdwbqos5ghka6gdjra3tdkgxxs74hqsze',
+     *   dexThresh: DexThreshType.FOUR_FIFTHS,
+     *   salt: '0x...',
+     *   taxRate: 0,
+     *   migratorType: MigratorType.V3_MIGRATOR,
+     *   quoteToken: '0x0000000000000000000000000000000000000000',
+     *   quoteAmt: 0n,
+     *   beneficiary: '0x...',
+     *   extensionID: '0x0000000000000000000000000000000000000000000000000000000000000000',
+     *   dexId: DEXId.DEX0,
+     *   lpFeeProfile: V3LPFeeProfile.LP_FEE_PROFILE_STANDARD,
+     *   msgValue: parseEther('0.01'),
+     * });
+     * ```
+     *
+     * @note BNB 链上使用 LP_FEE_PROFILE_LOW (0.01%) 需要白名单地址
+     */
+    async newTokenV4(args) {
+        const tx = await this.contract.newTokenV4({
+            name: args.name,
+            symbol: args.symbol,
+            meta: args.meta,
+            dexThresh: args.dexThresh,
+            salt: args.salt,
+            taxRate: args.taxRate,
+            migratorType: args.migratorType,
+            quoteToken: args.quoteToken,
+            quoteAmt: args.quoteAmt,
+            beneficiary: args.beneficiary,
+            permitData: args.permitData ?? '0x',
+            extensionID: args.extensionID,
+            extensionData: args.extensionData ?? '0x',
+            dexId: args.dexId,
+            lpFeeProfile: args.lpFeeProfile,
+        }, { value: args.msgValue });
+        return await tx.wait();
+    }
     // 受益人领取收益
     async claim(token) {
         const tx = await this.contract.claim(token);

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { TM1, type FourChainV1 } from './contracts/tm1.js';
 export { TM2, type FourChainV2 } from './contracts/tm2.js';
 export { Helper3, Helper3Writer } from './contracts/helper3.js';
 export { CDPV2 } from './flap/curve.js';
-export { FlapPortal, FlapPortalWriter, type FlapChain, type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, TokenStatus, TokenVersion, DexThreshType, MigratorType } from './flap/portal.js';
+export { FlapPortal, FlapPortalWriter, type FlapChain, type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, type NewTokenV4Params, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, DEXId } from './flap/portal.js';
 export { uploadTokenMeta, type TokenMetaInput } from './flap/ipfs.js';
 export { buildPermitPiggybackAuto } from './flap/permit.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './flap/vanity.js';

package/dist/index.js

@@ -29,7 +29,7 @@ export { TM1 } from './contracts/tm1.js';
 export { TM2 } from './contracts/tm2.js';
 export { Helper3, Helper3Writer } from './contracts/helper3.js';
 export { CDPV2 } from './flap/curve.js';
-export { FlapPortal, FlapPortalWriter, TokenStatus, TokenVersion, DexThreshType, MigratorType } from './flap/portal.js';
+export { FlapPortal, FlapPortalWriter, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, DEXId } from './flap/portal.js';
 export { uploadTokenMeta } from './flap/ipfs.js';
 export { buildPermitPiggybackAuto } from './flap/permit.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './flap/vanity.js';

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

@@ -15,8 +15,10 @@ export interface PancakeBuyFirstSignConfig {
     chainId?: number;
     reserveGasBNB?: number;
     skipQuoteOnError?: boolean;
+    userType?: UserType;
     bribeAmount?: number;
 }
+export type UserType = 'v0' | 'v1';
 export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
 export interface V2RouteParams {
     routeType: 'v2';

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

@@ -52,8 +52,15 @@ const BRIBE_TX_COUNT = 1;
 const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
 /** 最大买卖交易数 */
 const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
-/** 每笔交易利润比例（基点）：6 bps = 0.06% = 万分之六 */
-const PROFIT_RATE_PER_TX_BPS = 6;
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1;
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // v0 或默认
+}
 /**
  * 验证买卖笔数
  */
@@ -136,9 +143,9 @@ export async function pancakeBundleBuyFirstMerkle(params) {
         throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
     }
     validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例：每笔万分之3
+    // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
-    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
     // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const context = createPancakeContext(config);
@@ -766,9 +773,9 @@ async function pancakeBundleBuyFirstMultiWallet(params) {
         throw new Error('卖方钱包数量不能为0');
     // 验证总交易数不超过限制
     validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例：每笔万分之6
+    // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
-    const profitRateBps = PROFIT_RATE_PER_TX_BPS * totalTxCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
     // ✅ 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const context = createPancakeContext(config);

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

@@ -1,5 +1,6 @@
 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;
@@ -9,6 +10,7 @@ export interface PancakeSwapSignConfig {
     txType?: 0 | 2;
     chainId?: number;
     reserveGasBNB?: number;
+    userType?: UserType;
     bribeAmount?: number;
 }
 export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';

package/dist/pancake/bundle-swap.js

@@ -439,11 +439,24 @@ async function planNonces({ seller, buyer, sameAddress, approvalExists, profitNe
     ]);
     return { sellerNonce, buyerNonce };
 }
-function calculateProfitAmount(estimatedBNBOut) {
+/**
+ * 根据 userType 计算利润率
+ */
+function getProfitRateBps(userType) {
+    if (userType === 'v0') {
+        return PROFIT_CONFIG.RATE_BPS_V0; // 0.06%
+    }
+    else if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1; // 0.05%
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // 默认 0.06%
+}
+function calculateProfitAmount(estimatedBNBOut, userType) {
     if (estimatedBNBOut <= 0n) {
         return 0n;
     }
-    return (estimatedBNBOut * BigInt(PROFIT_CONFIG.RATE_BPS_SWAP)) / 10000n;
+    const rateBps = getProfitRateBps(userType);
+    return (estimatedBNBOut * BigInt(rateBps)) / 10000n;
 }
 /**
  * ✅ 获取 ERC20 代币 → 原生代币（BNB）的报价
@@ -619,8 +632,8 @@ export async function pancakeBundleSwapMerkle(params) {
     // 如果输出是 ERC20（如 USDT），需要先转换为 BNB 等值
     let profitAmount;
     if (useNativeToken) {
-        // 输出是 BNB，直接计算利润
-        profitAmount = calculateProfitAmount(quoteResult.estimatedBNBOut);
+        // 输出是 BNB，直接计算利润（根据 userType 动态调整）
+        profitAmount = calculateProfitAmount(quoteResult.estimatedBNBOut, config.userType);
         console.log(`[pancakeBundleSwapMerkle] 原生代币利润: ${ethers.formatEther(profitAmount)} BNB`);
     }
     else {
@@ -629,7 +642,7 @@ export async function pancakeBundleSwapMerkle(params) {
         const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
         const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, quoteResult.estimatedBNBOut, // 这实际上是 ERC20 数量
         version, fee);
-        profitAmount = calculateProfitAmount(estimatedBNBValue);
+        profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
         console.log(`[pancakeBundleSwapMerkle] ERC20→BNB 报价: ${ethers.formatUnits(quoteResult.estimatedBNBOut, quoteTokenDecimals)} ${quoteToken?.slice(0, 10)}... → ${ethers.formatEther(estimatedBNBValue)} BNB, 利润: ${ethers.formatEther(profitAmount)} BNB`);
     }
     // ✅ 获取贿赂金额
@@ -940,14 +953,14 @@ export async function pancakeBatchSwapMerkle(params) {
     // ✅ 修复：利润计算应基于 BNB 数量，不是 ERC20 数量
     let profitAmount;
     if (useNativeToken) {
-        profitAmount = calculateProfitAmount(estimatedBNBOut);
+        profitAmount = calculateProfitAmount(estimatedBNBOut, config.userType);
         console.log(`[pancakeBatchSwapMerkle] 原生代币利润: ${ethers.formatEther(profitAmount)} BNB`);
     }
     else {
         const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
         const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
         const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, estimatedBNBOut, version, fee);
-        profitAmount = calculateProfitAmount(estimatedBNBValue);
+        profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
         console.log(`[pancakeBatchSwapMerkle] ERC20→BNB 报价: ${ethers.formatUnits(estimatedBNBOut, quoteTokenDecimals)} → ${ethers.formatEther(estimatedBNBValue)} BNB, 利润: ${ethers.formatEther(profitAmount)} BNB`);
     }
     // 计算利润 nonce
@@ -1143,14 +1156,14 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     // ✅ 计算利润（万分之六）
     let profitAmount;
     if (useNativeToken) {
-        profitAmount = calculateProfitAmount(estimatedOutput);
+        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);
+        profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
         console.log(`[pancakeQuickBatchSwapMerkle] ERC20→BNB 报价: ${outputFormatted} → ${ethers.formatEther(estimatedBNBValue)} BNB`);
     }
     const distributableAmount = estimatedOutput - (useNativeToken ? profitAmount : 0n);

package/dist/utils/constants.d.ts

@@ -17,10 +17,12 @@ export declare const PROFIT_CONFIG: {
     readonly RECIPIENT: "0xe8D0334fAf713884133640CAEe4ECdd2106AF103";
     /** 利润比例（基点）：30 bps = 0.3% = 千分之三（普通模式） */
     readonly RATE_BPS: 30;
-    /** 利润比例（基点）：6 bps = 0.06% = 万分之六（资金利用率模式） */
-    readonly RATE_BPS_CAPITAL: 6;
     /** 利润比例（基点）：6 bps = 0.06% = 万分之六（捆绑换手模式） */
     readonly RATE_BPS_SWAP: 6;
+    /** 利润比例（基点）：6 bps = 0.06% = 万分之六（用户类型 v0） */
+    readonly RATE_BPS_V0: 6;
+    /** 利润比例（基点）：5 bps = 0.05% = 万分之五（用户类型 v1） */
+    readonly RATE_BPS_V1: 5;
 };
 export declare const CHAIN: {
     BSC: {

package/dist/utils/constants.js

@@ -23,10 +23,12 @@ export const PROFIT_CONFIG = {
     RECIPIENT: '0xe8D0334fAf713884133640CAEe4ECdd2106AF103',
     /** 利润比例（基点）：30 bps = 0.3% = 千分之三（普通模式） */
     RATE_BPS: 30,
-    /** 利润比例（基点）：6 bps = 0.06% = 万分之六（资金利用率模式） */
-    RATE_BPS_CAPITAL: 6,
     /** 利润比例（基点）：6 bps = 0.06% = 万分之六（捆绑换手模式） */
     RATE_BPS_SWAP: 6,
+    /** 利润比例（基点）：6 bps = 0.06% = 万分之六（用户类型 v0） */
+    RATE_BPS_V0: 6,
+    /** 利润比例（基点）：5 bps = 0.05% = 万分之五（用户类型 v1） */
+    RATE_BPS_V1: 5,
 };
 export const CHAIN = {
     BSC: {

package/dist/utils/holders-maker.js

@@ -620,7 +620,7 @@ export async function holdersMaker(params) {
         const totalBuyAmountForProfit = isERC20Mode
             ? ethers.parseEther(buyAmountPerHolder) * BigInt(holdersCount) // 按等值 BNB 计算
             : buyAmountWei * BigInt(holdersCount);
-        const profitRateBps = PROFIT_CONFIG.RATE_BPS_SWAP;
+        const profitRateBps = PROFIT_CONFIG.RATE_BPS;
         const totalProfit = (totalBuyAmountForProfit * BigInt(profitRateBps)) / 10000n;
         const profitPerBatch = totalProfit / BigInt(walletBatches.length);
         console.log(`[HoldersMaker] 总利润: ${ethers.formatEther(totalProfit)} BNB`);

package/package.json

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