four-flap-meme-sdk 4.0.14 → 4.1.1

package/dist/bundle/four-meme/core/sell-flow.js

@@ -4,7 +4,7 @@
 import { ethers, Contract, Interface } from 'ethers';
 import { getGasLimit } from '../../../core/gas/bundle-gas.js';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
-import { ADDRESSES } from '../../../core/constants/index.js';
+import { ADDRESSES, CHAINS, applySlippageBps, reverseSlippageBps } from '../../../core/constants/index.js';
 import { MULTICALL3_ABI, ERC20_ABI } from '../../../abis/common.js';
 import { getBundleErrorMessage } from '../../errors.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, } from '../../config-helpers.js';
@@ -123,7 +123,7 @@ async function resolveSellOutputs(params) {
     // 如果已提供 minOutputAmounts，直接使用，跳过报价查询
     if (minOutputAmounts && minOutputAmounts.length === sellers.length) {
         const minOuts = minOutputAmounts.map((m) => (typeof m === 'string' ? ethers.parseEther(m) : m));
-        const quotedOutputs = minOuts.map((value) => (value * 100n) / 95n);
+        const quotedOutputs = minOuts.map((value) => reverseSlippageBps(value));
         return { minOuts, quotedOutputs };
     }
     // 如果只有 1 个，直接调用（避免 multicall 开销）
@@ -131,8 +131,7 @@ async function resolveSellOutputs(params) {
         try {
             const result = await trySell('BSC', rpcUrl, tokenAddress, amountsWei[0]);
             const quotedOutputs = [result.funds];
-            // ✅ 已移除滑点保护：minOuts 固定为 0
-            const minOuts = [0n];
+            const minOuts = [applySlippageBps(result.funds)];
             return { minOuts, quotedOutputs };
         }
         catch {
@@ -140,7 +139,7 @@ async function resolveSellOutputs(params) {
         }
     }
     // ✅ 使用 Multicall3 批量获取报价
-    const provider = createSignProvider(rpcUrl, 56, 'BSC');
+    const provider = createSignProvider(rpcUrl, CHAINS.BSC.chainId, 'BSC');
     const helper3Address = ADDRESSES.BSC.TokenManagerHelper3;
     const helper3Iface = new Interface(Helper3Abi);
     const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
@@ -165,8 +164,7 @@ async function resolveSellOutputs(params) {
             }
             return 0n;
         });
-        // ✅ 已移除滑点保护：minOuts 固定为 0
-        const minOuts = quotedOutputs.map(() => 0n);
+        const minOuts = quotedOutputs.map((q) => applySlippageBps(q));
         return { minOuts, quotedOutputs };
     }
     catch {
@@ -180,8 +178,7 @@ async function resolveSellOutputs(params) {
                 return 0n;
             }
         }));
-        // ✅ 已移除滑点保护：minOuts 固定为 0
-        const minOuts = quotedOutputs.map(() => 0n);
+        const minOuts = quotedOutputs.map((q) => applySlippageBps(q));
         return { minOuts, quotedOutputs };
     }
 }

package/dist/bundle/four-meme/pancake-proxy/helpers.d.ts

@@ -1,45 +1,12 @@
 /**
- * PancakeSwap 官方 Router 交易模块 — 共享辅助（报价 / 路由构建 / 授权目标）
+ * PancakeSwap 官方 Router 交易模块 — four-meme 辅助
+ *
+ * 交易构建 / 报价 / 授权目标与 flap 共用 utils/pancake-router-tx。
+ * decimals 不走缓存，与原先 four-meme 调用约定一致。
  */
-import { Wallet, Contract } from 'ethers';
 import type { JsonRpcProvider } from 'ethers';
-import type { ContractTransaction } from 'ethers/contract';
 import type { FourPancakeProxyBatchBuySignParams } from '../types/index.js';
-/**
- * 查询代币 decimals
- */
+export { buildV2Transactions, buildV3SingleTransactions, buildV3MultiHopTransactions, batchGetV2Quotes, getApprovalTarget, } from '../../../utils/pancake-router-tx.js';
 export declare function getTokenDecimals(tokenAddress: string, provider: JsonRpcProvider): Promise<number>;
-/**
- * 判断是否需要发送 BNB
- */
 export type PancakeBuyRouteFields = Pick<FourPancakeProxyBatchBuySignParams, 'v2Path' | 'v3TokenIn' | 'v3ExactTokenIn'>;
 export declare function needSendBNB(routeType: FourPancakeProxyBatchBuySignParams['routeType'], params: PancakeBuyRouteFields): boolean;
-/**
- * ✅ 构建 V2 交易（使用官方 Router）
- */
-export declare function buildV2Transactions(routers: Contract[], wallets: Wallet[], amountsWei: bigint[], minOuts: bigint[], path: string[], isBuy: boolean, needBNB: boolean): Promise<ContractTransaction[]>;
-/**
- * ✅ 构建 V3 单跳交易（使用官方 SwapRouter02 + multicall）
- */
-export declare function buildV3SingleTransactions(routers: Contract[], wallets: Wallet[], tokenIn: string, tokenOut: string, fee: number, amountsWei: bigint[], minOuts: bigint[], isBuy: boolean, needBNB: boolean): Promise<ContractTransaction[]>;
-/**
- * ✅ 构建 V3 多跳交易（使用官方 SwapRouter02 的 exactInput）
- *
- * @param routers - V3 Router 合约数组
- * @param wallets - 钱包数组
- * @param tokens - 代币路径 [tokenIn, tokenMid1, ..., tokenOut]
- * @param fees - 费率路径 [fee0, fee1, ...]
- * @param amountsWei - 每个钱包的输入金额
- * @param minOuts - 最小输出金额
- * @param isBuy - 是否为买入操作
- * @param needBNB - 是否需要发送 BNB
- */
-export declare function buildV3MultiHopTransactions(routers: Contract[], wallets: Wallet[], tokens: string[], fees: number[], amountsWei: bigint[], minOuts: bigint[], isBuy: boolean, needBNB: boolean): Promise<ContractTransaction[]>;
-/**
- * ✅ 使用 Multicall3 批量获取 V2 报价
- */
-export declare function batchGetV2Quotes(provider: JsonRpcProvider, amountsWei: bigint[], v2Path: string[]): Promise<bigint[]>;
-/**
- * 根据 routeType 获取授权目标地址
- */
-export declare function getApprovalTarget(routeType: string): string;

package/dist/bundle/four-meme/pancake-proxy/helpers.js

@@ -1,232 +1,9 @@
-/**
- * PancakeSwap 官方 Router 交易模块 — 共享辅助（报价 / 路由构建 / 授权目标）
- */
-import { Contract, Interface } from 'ethers';
-import { getDeadline, encodeV3Path } from '../../../utils/bundle-helpers.js';
-import { V2_ROUTER_ABI, ERC20_ABI, MULTICALL3_ABI } from '../../../abis/common.js';
-import { MULTICALL3_ADDRESS, WBNB_ADDRESS, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER_ABI, } from './constants.js';
-/**
- * 查询代币 decimals
- */
+import { getTokenDecimals as fetchTokenDecimals } from '../../../utils/swap-helpers.js';
+import { needSendBNBFromRoute } from '../../../utils/pancake-router-tx.js';
+export { buildV2Transactions, buildV3SingleTransactions, buildV3MultiHopTransactions, batchGetV2Quotes, getApprovalTarget, } from '../../../utils/pancake-router-tx.js';
 export async function getTokenDecimals(tokenAddress, provider) {
-    try {
-        const token = new Contract(tokenAddress, ERC20_ABI, provider);
-        const decimals = await token.decimals();
-        return Number(decimals);
-    }
-    catch {
-        return 18;
-    }
+    return fetchTokenDecimals(provider, tokenAddress, { fallback: 18 });
 }
 export function needSendBNB(routeType, params) {
-    if (routeType === 'v2' && params.v2Path && params.v2Path[0].toLowerCase() === WBNB_ADDRESS.toLowerCase()) {
-        return true;
-    }
-    if (routeType === 'v3-single' && params.v3TokenIn && params.v3TokenIn.toLowerCase() === WBNB_ADDRESS.toLowerCase()) {
-        return true;
-    }
-    if (routeType === 'v3-multi' &&
-        params.v3ExactTokenIn &&
-        params.v3ExactTokenIn.toLowerCase() === WBNB_ADDRESS.toLowerCase()) {
-        return true;
-    }
-    return false;
-}
-/**
- * ✅ 构建 V2 交易（使用官方 Router）
- */
-export async function buildV2Transactions(routers, wallets, amountsWei, minOuts, path, isBuy, needBNB) {
-    const deadline = getDeadline();
-    return Promise.all(routers.map(async (router, i) => {
-        if (isBuy && needBNB) {
-            // ✅ 买入：BNB → Token，使用 swapExactETHForTokensSupportingFeeOnTransferTokens
-            return router.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(minOuts[i], // amountOutMin
-            path, // path
-            wallets[i].address, // to
-            deadline, // deadline
-            { value: amountsWei[i] });
-        }
-        else {
-            // ✅ 卖出：Token → BNB，使用 swapExactTokensForETHSupportingFeeOnTransferTokens
-            return router.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(amountsWei[i], // amountIn
-            minOuts[i], // amountOutMin
-            path, // path
-            wallets[i].address, // to
-            deadline);
-        }
-    }));
-}
-/**
- * ✅ 构建 V3 单跳交易（使用官方 SwapRouter02 + multicall）
- */
-export async function buildV3SingleTransactions(routers, wallets, tokenIn, tokenOut, fee, amountsWei, minOuts, isBuy, needBNB) {
-    const deadline = getDeadline();
-    const v3RouterIface = new Interface(V3_ROUTER_ABI);
-    return Promise.all(routers.map(async (router, i) => {
-        const isTokenOutWBNB = tokenOut.toLowerCase() === WBNB_ADDRESS.toLowerCase();
-        // ✅ 构建 exactInputSingle calldata
-        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [
-            {
-                tokenIn: tokenIn,
-                tokenOut: tokenOut,
-                fee: fee,
-                recipient: isTokenOutWBNB ? PANCAKE_V3_ROUTER_ADDRESS : wallets[i].address, // 如果输出是 WBNB，先发给 Router
-                amountIn: amountsWei[i],
-                amountOutMinimum: minOuts[i],
-                sqrtPriceLimitX96: 0n,
-            },
-        ]);
-        if (isBuy && needBNB) {
-            // ✅ 买入：BNB → Token，只需要 exactInputSingle
-            // 通过 multicall 包装，传入 deadline 和 ETH value
-            return router.multicall.populateTransaction(deadline, [exactInputSingleData], { value: amountsWei[i] });
-        }
-        else if (!isBuy && isTokenOutWBNB) {
-            // ✅ 卖出：Token → WBNB → BNB，需要 exactInputSingle + unwrapWETH9
-            const unwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [
-                minOuts[i], // amountMinimum
-                wallets[i].address, // recipient
-            ]);
-            return router.multicall.populateTransaction(deadline, [exactInputSingleData, unwrapData]);
-        }
-        else {
-            // ✅ Token → Token，只需要 exactInputSingle
-            return router.multicall.populateTransaction(deadline, [exactInputSingleData]);
-        }
-    }));
-}
-/**
- * ✅ 构建 V3 多跳交易（使用官方 SwapRouter02 的 exactInput）
- *
- * @param routers - V3 Router 合约数组
- * @param wallets - 钱包数组
- * @param tokens - 代币路径 [tokenIn, tokenMid1, ..., tokenOut]
- * @param fees - 费率路径 [fee0, fee1, ...]
- * @param amountsWei - 每个钱包的输入金额
- * @param minOuts - 最小输出金额
- * @param isBuy - 是否为买入操作
- * @param needBNB - 是否需要发送 BNB
- */
-export async function buildV3MultiHopTransactions(routers, wallets, tokens, fees, amountsWei, minOuts, isBuy, needBNB) {
-    if (!tokens || tokens.length < 2) {
-        throw new Error('V3 多跳需要至少 2 个代币（v3Tokens）');
-    }
-    if (!fees || fees.length !== tokens.length - 1) {
-        throw new Error(`V3 多跳费率数量 (${fees?.length || 0}) 必须等于代币数量 - 1 (${tokens.length - 1})（v3Fees）`);
-    }
-    const deadline = getDeadline();
-    const v3RouterIface = new Interface(V3_ROUTER_ABI);
-    // 编码正向 path（用于买入：BNB → Token）
-    const forwardPath = encodeV3Path(tokens, fees);
-    // 编码反向 path（用于卖出：Token → BNB）
-    const reversedTokens = [...tokens].reverse();
-    const reversedFees = [...fees].reverse();
-    const reversePath = encodeV3Path(reversedTokens, reversedFees);
-    const tokenOut = tokens[tokens.length - 1];
-    const isTokenOutWBNB = tokenOut.toLowerCase() === WBNB_ADDRESS.toLowerCase();
-    return Promise.all(routers.map(async (router, i) => {
-        if (isBuy && needBNB) {
-            // ✅ 买入：BNB → ... → Token
-            const swapData = v3RouterIface.encodeFunctionData('exactInput', [
-                {
-                    path: forwardPath,
-                    recipient: wallets[i].address,
-                    amountIn: amountsWei[i],
-                    amountOutMinimum: minOuts[i],
-                },
-            ]);
-            return router.multicall.populateTransaction(deadline, [swapData], { value: amountsWei[i] });
-        }
-        else if (!isBuy) {
-            // ✅ 卖出：Token → ... → BNB
-            const swapData = v3RouterIface.encodeFunctionData('exactInput', [
-                {
-                    path: reversePath,
-                    recipient: isTokenOutWBNB ? PANCAKE_V3_ROUTER_ADDRESS : wallets[i].address,
-                    amountIn: amountsWei[i],
-                    amountOutMinimum: minOuts[i],
-                },
-            ]);
-            if (isTokenOutWBNB) {
-                // 需要 unwrapWETH9
-                const unwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [minOuts[i], wallets[i].address]);
-                return router.multicall.populateTransaction(deadline, [swapData, unwrapData]);
-            }
-            return router.multicall.populateTransaction(deadline, [swapData]);
-        }
-        else {
-            // Token → Token（不需要 BNB）
-            const swapData = v3RouterIface.encodeFunctionData('exactInput', [
-                {
-                    path: forwardPath,
-                    recipient: wallets[i].address,
-                    amountIn: amountsWei[i],
-                    amountOutMinimum: minOuts[i],
-                },
-            ]);
-            return router.multicall.populateTransaction(deadline, [swapData]);
-        }
-    }));
-}
-/**
- * ✅ 使用 Multicall3 批量获取 V2 报价
- */
-export async function batchGetV2Quotes(provider, amountsWei, v2Path) {
-    if (amountsWei.length === 0)
-        return [];
-    if (amountsWei.length === 1) {
-        try {
-            const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, provider);
-            const amounts = await v2Router.getAmountsOut(amountsWei[0], v2Path);
-            return [amounts[amounts.length - 1]];
-        }
-        catch {
-            return [0n];
-        }
-    }
-    try {
-        const v2RouterIface = new Interface(V2_ROUTER_ABI);
-        const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
-        const calls = amountsWei.map((amount) => ({
-            target: PANCAKE_V2_ROUTER_ADDRESS,
-            allowFailure: true,
-            callData: v2RouterIface.encodeFunctionData('getAmountsOut', [amount, v2Path]),
-        }));
-        const results = await multicall.aggregate3.staticCall(calls);
-        return results.map((r) => {
-            if (r.success && r.returnData && r.returnData !== '0x') {
-                try {
-                    const decoded = v2RouterIface.decodeFunctionResult('getAmountsOut', r.returnData);
-                    const amounts = decoded[0];
-                    return amounts[amounts.length - 1];
-                }
-                catch {
-                    return 0n;
-                }
-            }
-            return 0n;
-        });
-    }
-    catch {
-        return await Promise.all(amountsWei.map(async (amount) => {
-            try {
-                const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, provider);
-                const amounts = await v2Router.getAmountsOut(amount, v2Path);
-                return amounts[amounts.length - 1];
-            }
-            catch {
-                return 0n;
-            }
-        }));
-    }
-}
-/**
- * 根据 routeType 获取授权目标地址
- */
-export function getApprovalTarget(routeType) {
-    if (routeType === 'v2') {
-        return PANCAKE_V2_ROUTER_ADDRESS;
-    }
-    // V3 路由授权给 V3 Router
-    return PANCAKE_V3_ROUTER_ADDRESS;
+    return needSendBNBFromRoute(routeType, params);
 }

package/dist/bundle/four-meme/private/sell.js

@@ -4,7 +4,7 @@
 import { ethers, Wallet } from 'ethers';
 import { getGasLimit } from '../../../core/gas/bundle-gas.js';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
-import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, CHAINS } from '../../../core/constants/index.js';
+import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, CHAINS, applySlippageBps, reverseSlippageBps } from '../../../core/constants/index.js';
 import { TM2_ABI } from '../../../abis/common.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, } from '../../config-helpers.js';
 import { trySell } from '../../../domains/four/contracts/tm.js';
@@ -31,7 +31,7 @@ export async function fourPrivateSellMerkle(params) {
     const [gasPrice, sellNonce, sellUnsigned] = await Promise.all([
         getOptimizedGasPrice(provider, getGasPriceConfig(config)),
         wallet.getNonce(),
-        tm2.sellToken.populateTransaction(0n, tokenAddress, amountWei, 0n), // ✅ 已移除滑点保护：minOut 固定为 0
+        tm2.sellToken.populateTransaction(0n, tokenAddress, amountWei, minOut),
     ]);
     // ✅ 已移除授权检查（前端负责确保授权）
     // ✅ 利润计算（同步）
@@ -121,7 +121,7 @@ export async function fourBatchPrivateSellMerkle(params) {
         minFundsEach !== undefined
             ? Promise.resolve((() => {
                 const minOutWei = typeof minFundsEach === 'string' ? ethers.parseEther(minFundsEach) : minFundsEach;
-                return new Array(wallets.length).fill((minOutWei * 100n) / 95n);
+                return new Array(wallets.length).fill(reverseSlippageBps(minOutWei));
             })())
             : Promise.all(amountsWei.map(async (amount) => {
                 try {
@@ -133,8 +133,8 @@ export async function fourBatchPrivateSellMerkle(params) {
                 }
             })),
     ]);
-    // ✅ 已移除滑点保护：minOuts 固定为 0
-    const minOuts = new Array(wallets.length).fill(0n);
+    // 报价 × (1 - 100bps)
+    const minOuts = quotedOutputs.map((q) => applySlippageBps(q));
     // ✅ 计算总利润和找出收益最高的钱包（同步计算）
     const extractProfit = shouldExtractProfit();
     let totalProfit = 0n;

package/dist/bundle/four-meme/swap-hop-helpers.d.ts

@@ -1,6 +1,2 @@
-import { Wallet, type JsonRpcProvider } from 'ethers';
-import type { DisperseHopPath } from './types/index.js';
-export declare const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
+export { generateDisperseHopPaths, buildNativeHopChain, NATIVE_TRANSFER_GAS_LIMIT, } from '../../utils/hop-chains.js';
 export type { DisperseHopPath } from './types/index.js';
-export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
-export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;

package/dist/bundle/four-meme/swap-hop-helpers.js

@@ -1,63 +1 @@
-import { Wallet } from 'ethers';
-import { generateWallets } from '../../utils/wallet.js';
-export const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
-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) {
-        signedTxs.push(await payer.signTransaction({
-            to: path.targetAddress,
-            value: finalAmount,
-            nonce: payerNonce,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            gasPrice,
-            chainId,
-            type: txType,
-        }));
-        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));
-    }
-    signedTxs.push(await payer.signTransaction({
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        gasPrice,
-        chainId,
-        type: txType,
-    }));
-    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];
-        signedTxs.push(await fromWallet.signTransaction({
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            gasPrice,
-            chainId,
-            type: txType,
-        }));
-    }
-    return signedTxs;
-}
+export { generateDisperseHopPaths, buildNativeHopChain, NATIVE_TRANSFER_GAS_LIMIT, } from '../../utils/hop-chains.js';

package/dist/bundle/four-meme/types/bundle-ops.d.ts

@@ -0,0 +1,166 @@
+import type { FourTokenTaxInfo } from '../../../core/clients/four.js';
+import type { FourRaisedToken } from '../../../domains/four/raised-token.js';
+import type { FourBundleMerkleConfig, FourSignConfig, MerkleSignedResult } from './config.js';
+/** ✅ 创建代币 + 购买参数（Merkle 版本 - 完整） */
+export type FourCreateWithBundleBuyMerkleParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    b0Amount?: string;
+    tokenInfo: {
+        name: string;
+        symbol: string;
+        description: string;
+        imageUrl?: string;
+        imageFile?: Blob;
+        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
+        preSale?: string;
+        webUrl?: string;
+        twitterUrl?: string;
+        telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
+        /** 官网计价币 symbol，如 BNB / USDT / USD1 */
+        quoteSymbol?: string;
+        raisedToken?: FourRaisedToken;
+    };
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 创建代币 + 购买参数（仅签名版本 - 精简） */
+export type FourCreateWithBundleBuySignParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    b0Amount?: string;
+    tokenInfo: {
+        name: string;
+        symbol: string;
+        description: string;
+        imageUrl?: string;
+        imageFile?: Blob;
+        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
+        preSale?: string;
+        webUrl?: string;
+        twitterUrl?: string;
+        telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
+        quoteSymbol?: string;
+        raisedToken?: FourRaisedToken;
+    };
+    config: FourSignConfig;
+};
+/**
+ * ✅ 创建代币 + 购买结果（简化版）
+ * 包含 tokenAddress 用于返回创建的代币地址
+ */
+export type FourCreateWithBundleBuyMerkleResult = MerkleSignedResult;
+/** ✅ 批量购买参数（Merkle 版本 - 完整） */
+export type FourBatchBuyMerkleParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 批量购买参数（仅签名版本 - 精简） */
+export type FourBatchBuySignParams = {
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    config: FourSignConfig;
+};
+/** ✅ 批量购买结果（简化版） */
+export type FourBatchBuyMerkleResult = MerkleSignedResult;
+/** ✅ 批量卖出参数（Merkle 版本 - 完整） */
+export type FourBatchSellMerkleParams = {
+    privateKeys: string[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    minOutputAmounts?: (string | bigint)[];
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 批量卖出参数（仅签名版本 - 精简） */
+export type FourBatchSellSignParams = {
+    privateKeys: string[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    minOutputAmounts?: (string | bigint)[];
+    config: FourSignConfig;
+};
+/** ✅ 批量卖出结果（简化版） */
+export type FourBatchSellMerkleResult = MerkleSignedResult;
+/** ✅ 私有交易基础配置（Merkle 版本 - 完整） */
+export type FourPrivateMerkleBase = {
+    config: FourBundleMerkleConfig;
+};
+/** ✅ 私有交易基础配置（仅签名版本 - 精简） */
+export type FourPrivateSignBase = {
+    config: FourSignConfig;
+};
+/** ✅ 私有购买参数（Merkle 版本 - 完整） */
+export type FourPrivateBuyMerkleParams = FourPrivateMerkleBase & {
+    privateKey: string;
+    tokenAddress: string;
+    funds: string;
+    to?: string;
+};
+/** ✅ 私有购买参数（仅签名版本 - 精简） */
+export type FourPrivateBuySignParams = FourPrivateSignBase & {
+    privateKey: string;
+    tokenAddress: string;
+    funds: string;
+    to?: string;
+    /** ERC20 计价跟买；不传则按 BNB `msg.value` */
+    quoteTokenAddress?: string;
+    quoteDecimals?: number;
+};
+/** ✅ 私有卖出参数（Merkle 版本 - 完整） */
+export type FourPrivateSellMerkleParams = FourPrivateMerkleBase & {
+    privateKey: string;
+    tokenAddress: string;
+    amount: string;
+    minFunds?: bigint;
+};
+/** ✅ 私有卖出参数（仅签名版本 - 精简） */
+export type FourPrivateSellSignParams = FourPrivateSignBase & {
+    privateKey: string;
+    tokenAddress: string;
+    amount: string;
+    minFunds?: bigint;
+};
+/** ✅ 私有交易结果（简化版） */
+export type FourPrivateTransactionResult = MerkleSignedResult;
+/** ✅ 批量私有购买参数（Merkle 版本 - 完整） */
+export type FourBatchPrivateBuyMerkleParams = FourPrivateMerkleBase & {
+    privateKeys: string[];
+    fundsList: string[];
+    tokenAddress: string;
+    quoteTokenAddress?: string;
+    quoteDecimals?: number;
+};
+/** ✅ 批量私有购买参数（仅签名版本 - 精简） */
+export type FourBatchPrivateBuySignParams = FourPrivateSignBase & {
+    privateKeys: string[];
+    fundsList: string[];
+    tokenAddress: string;
+    quoteTokenAddress?: string;
+    quoteDecimals?: number;
+};
+/** ✅ 批量私有卖出参数（Merkle 版本 - 完整） */
+export type FourBatchPrivateSellMerkleParams = FourPrivateMerkleBase & {
+    privateKeys: string[];
+    amounts: string[];
+    tokenAddress: string;
+    minFundsEach?: bigint;
+};
+/** ✅ 批量私有卖出参数（仅签名版本 - 精简） */
+export type FourBatchPrivateSellSignParams = FourPrivateSignBase & {
+    privateKeys: string[];
+    amounts: string[];
+    tokenAddress: string;
+    minFundsEach?: bigint;
+};
+/** ✅ 批量私有交易结果（简化版） */
+export type FourBatchPrivateMerkleResult = MerkleSignedResult;

package/dist/bundle/four-meme/types/bundle-ops.js

@@ -0,0 +1,4 @@
+export {};
+// ========================================
+// 工具方法参数
+// ========================================

package/dist/bundle/four-meme/types/buy-first.d.ts

@@ -1,6 +1,6 @@
 import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
 import type { GeneratedWallet } from '../../../utils/wallet.js';
-import type { FourSignConfig, UserType } from './index.js';
+import type { FourSignConfig, UserType } from './config.js';
 export type FourBuyFirstSignConfig = FourSignConfig & {
     reserveGasBNB?: number;
     userType?: UserType;