four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/bundle/four-meme/approve-tokenmanager.d.ts

@@ -1,5 +1,5 @@
-import type { ApproveFourTokenManagerBatchParams, ApproveFourTokenManagerBatchResult } from './types.js';
-export type { ApproveFourTokenManagerBatchParams, ApproveFourTokenManagerBatchResult } from './types.js';
+import type { ApproveFourTokenManagerBatchParams, ApproveFourTokenManagerBatchResult } from './types/index.js';
+export type { ApproveFourTokenManagerBatchParams, ApproveFourTokenManagerBatchResult } from './types/index.js';
 /**
  * 批量授权代币给 TokenManager（用于 Private Buy/Sell）
  * ✅ 直接通过 RPC 提交到链上并等待确认

package/dist/bundle/four-meme/approve-tokenmanager.js

@@ -4,8 +4,8 @@ import { ADDRESSES, CHAINS } from '../../core/constants/index.js';
 import { ERC20_ABI } from '../../abis/common.js';
 import { getErrorMessageFromUnknown } from '../../core/index.js';
 import { getTxType, getGasPriceConfig } from '../config-helpers.js';
-import { createSignProvider } from '../sign-context-helpers.js';
-import { batchCheckAllowances } from '../../core/erc20.js';
+import { createSignProvider } from '../../core/sign-context-helpers.js';
+import { batchCheckAllowances } from '../../core/erc20/index.js';
 const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;
 function resolveApprovalGasLimit(config) {
     if (config.gasLimit)
@@ -38,7 +38,7 @@ export async function approveFourTokenManagerBatch(params) {
                     return await tokenContract.decimals();
                 }
                 catch (error) {
-                    throw new Error(`查询代币 decimals 失败: ${getErrorMessageFromUnknown(error)}`);
+                    throw new Error(`查询代币 decimals 失败: ${getErrorMessageFromUnknown(error)}`, { cause: error });
                 }
             })(),
         batchCheckAllowances(provider, tokenAddress, wallets.map((w) => w.address), tmAddr),

package/dist/bundle/four-meme/core/buy-flow.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Four.meme Bundle 核心方法 — 批量买入流程
+ */
+import type { FourBatchBuySignParams, FourBatchBuyMerkleResult } from '../types/index.js';
+export declare function batchBuyWithBundleMerkle(params: FourBatchBuySignParams): Promise<FourBatchBuyMerkleResult>;

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

@@ -0,0 +1,147 @@
+/**
+ * Four.meme Bundle 核心方法 — 批量买入流程
+ */
+import { ethers } 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 { getBundleErrorMessage } from '../../errors.js';
+import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, } from '../../config-helpers.js';
+import { signBribeTransaction } from '../../../core/sign-context-helpers.js';
+import { createChainContext, createWallets } from '../core-helpers.js';
+import { TM2_ABI } from './constants.js';
+export async function batchBuyWithBundleMerkle(params) {
+    const { privateKeys, buyAmounts, tokenAddress, config } = params;
+    if (privateKeys.length === 0 || buyAmounts.length !== privateKeys.length) {
+        throw new Error(getBundleErrorMessage('KEY_AMOUNT_MISMATCH'));
+    }
+    const { provider, chainId } = createChainContext(config.rpcUrl);
+    const txType = getTxType(config);
+    const buyers = createWallets(privateKeys, provider);
+    // ✅ 优化：并行初始化 nonceManager 和获取 gasPrice
+    const [nonceManager, gasPrice] = await Promise.all([
+        Promise.resolve(new NonceManager(provider)),
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+    ]);
+    const buyFlow = await executeBuyFlow({
+        wallets: buyers,
+        buyAmounts,
+        tokenAddress,
+        config,
+        provider,
+        nonceManager,
+        contractAddress: ADDRESSES.BSC.TokenManagerOriginal,
+        gasPrice,
+        chainId,
+        profitMode: { type: 'aggregated', payer: buyers[0] },
+        txType,
+    });
+    nonceManager.clearTemp();
+    return {
+        signedTransactions: buyFlow.signedTxs,
+        profitHopWallets: buyFlow.profitHopWallets, // ✅ 返回利润多跳钱包
+        metadata: buyFlow.metadata,
+    };
+}
+async function executeBuyFlow(options) {
+    const { wallets, buyAmounts, tokenAddress, config, provider, nonceManager, contractAddress, gasPrice, chainId, profitMode, txType, } = options;
+    const extractProfit = shouldExtractProfit();
+    const analysis = analyzeBuyFunds(buyAmounts, extractProfit);
+    const finalGasLimit = getGasLimit(config, 800000);
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    const payer = profitMode.type === 'aggregated' ? (profitMode.payer ?? wallets[0]) : wallets[0];
+    // ✅ 贿赂交易放在首位
+    const signedTxs = [];
+    let bribeNonceOffset = 0;
+    if (needBribeTx) {
+        const bribeNonce = await nonceManager.getNextNonce(payer);
+        signedTxs.push(await signBribeTransaction(payer, bribeAmount, bribeNonce, gasPrice, chainId, txType));
+        bribeNonceOffset = 1; // payer 的买入交易 nonce 需要偏移
+    }
+    // ✅ 优化：并行执行 populateBuyTransactions 和批量获取 nonces（JSON-RPC 批量请求）
+    const [unsignedBuys, nonces] = await Promise.all([
+        populateBuyTransactions({
+            buyers: wallets,
+            contractAddress,
+            tokenAddress,
+            fundsList: analysis.fundsList,
+        }),
+        nonceManager.getNextNoncesForWallets(wallets), // ✅ 批量获取 nonce
+    ]);
+    // ✅ 调整 payer 的 nonce（如果有贿赂交易，需要偏移）
+    const payerIndex = wallets.findIndex((w) => w.address.toLowerCase() === payer.address.toLowerCase());
+    const adjustedNonces = nonces.map((n, i) => (i === payerIndex ? n + bribeNonceOffset : n));
+    // ✅ 并行签名所有买入交易
+    const signedBuys = await Promise.all(unsignedBuys.map((unsigned, index) => wallets[index].signTransaction({
+        ...unsigned,
+        from: wallets[index].address,
+        nonce: adjustedNonces[index],
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId,
+        type: txType,
+        value: analysis.fundsList[index],
+    })));
+    signedTxs.push(...signedBuys);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (extractProfit && analysis.totalProfit > 0n && profitMode.type === 'aggregated') {
+        const profitNonce = await nonceManager.getNextNonce(payer);
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: payer,
+            profitAmount: analysis.totalProfit,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType,
+            startNonce: profitNonce,
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    const metadata = buildBuyMetadata(extractProfit, analysis.totalBuyAmount, analysis.totalProfit, wallets.length);
+    return { signedTxs, metadata, profitHopWallets }; // ✅ 返回利润多跳钱包
+}
+function analyzeBuyFunds(buyAmounts, extractProfit) {
+    const fundsList = [];
+    const profitList = [];
+    let totalProfit = 0n;
+    let totalBuyAmount = 0n;
+    buyAmounts.forEach((amount) => {
+        const originalAmount = ethers.parseEther(amount);
+        totalBuyAmount += originalAmount;
+        if (extractProfit) {
+            const { remaining, profit } = calculateProfit(originalAmount);
+            fundsList.push(remaining);
+            profitList.push(profit);
+            totalProfit += profit;
+        }
+        else {
+            fundsList.push(originalAmount);
+            profitList.push(0n);
+        }
+    });
+    return { fundsList, profitList, totalProfit, totalBuyAmount };
+}
+async function populateBuyTransactions(params) {
+    const { buyers, contractAddress, tokenAddress, fundsList } = params;
+    const contracts = buyers.map((wallet) => new ethers.Contract(contractAddress, TM2_ABI, wallet));
+    return Promise.all(contracts.map((contract, index) => contract.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyers[index].address, fundsList[index], 0n, {
+        value: fundsList[index],
+    })));
+}
+function buildBuyMetadata(extractProfit, totalBuyAmount, totalProfit, buyerCount) {
+    if (!extractProfit || totalBuyAmount <= 0n || totalProfit <= 0n) {
+        return undefined;
+    }
+    return {
+        totalBuyAmount: ethers.formatEther(totalBuyAmount),
+        profitAmount: ethers.formatEther(totalProfit),
+        profitRecipient: getProfitRecipient(),
+        buyerCount,
+    };
+}

package/dist/bundle/four-meme/core/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Four.meme Bundle 核心方法 — 常量与扩展 ABI
+ */
+export declare const MULTICALL3_ADDRESS: "0xcA11bde05977b3631167028862bE2a173976CA11";
+export declare const TM2_ABI: string[];
+export declare const PLATFORM_CREATE_FEE: bigint;

package/dist/bundle/four-meme/core/constants.js

@@ -0,0 +1,15 @@
+/**
+ * Four.meme Bundle 核心方法 — 常量与扩展 ABI
+ */
+import { ethers } from 'ethers';
+import { ADDRESSES } from '../../../core/constants/index.js';
+import { TM2_ABI as _TM2_ABI } from '../../../abis/common.js';
+// ✅ 常量
+export const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
+// ✅ TM2 扩展 ABI（包含创建代币方法和事件）
+export const TM2_ABI = [
+    ..._TM2_ABI,
+    'function createToken(bytes args, bytes signature) payable',
+    'event TokenCreate(address indexed creator, address indexed token, uint256 timestamp)',
+];
+export const PLATFORM_CREATE_FEE = ethers.parseEther('0.01');

package/dist/bundle/four-meme/core/create-token.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Four.meme Bundle 核心方法 — 创建代币 + 创建者买入
+ */
+import type { FourCreateWithBundleBuySignParams, FourCreateWithBundleBuyMerkleResult } from '../types/index.js';
+export declare function createTokenWithBundleBuyMerkle(params: FourCreateWithBundleBuySignParams): Promise<FourCreateWithBundleBuyMerkleResult>;

package/dist/bundle/four-meme/core/create-token.js

@@ -0,0 +1,137 @@
+/**
+ * Four.meme Bundle 核心方法 — 创建代币 + 创建者买入
+ */
+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, ZERO_ADDRESS } from '../../../core/constants/index.js';
+import { FourClient } from '../../../core/clients/four.js';
+import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, } from '../../config-helpers.js';
+import { signBribeTransaction } from '../../../core/sign-context-helpers.js';
+import { createChainContext, loginFourClient, resolveTokenImage } from '../core-helpers.js';
+import { TM2_ABI, PLATFORM_CREATE_FEE } from './constants.js';
+export async function createTokenWithBundleBuyMerkle(params) {
+    const { privateKeys, buyAmounts, tokenInfo, config } = params;
+    // ⚠️ 限制: 只支持创建者买入,不支持其他钱包
+    if (privateKeys.length !== 1) {
+        throw new Error('只支持创建者买入,privateKeys 只能有1个元素');
+    }
+    if (buyAmounts.length !== 1) {
+        throw new Error('只支持买入一次,buyAmounts 只能有1个元素');
+    }
+    const creatorKey = privateKeys[0];
+    // ✅ 使用公共 BSC RPC 节点（支持浏览器 CORS）
+    // 48.club 的 RPC 不支持浏览器跨域访问，所以使用公共节点进行余额查询和 gas 估算
+    const rpcUrl = config.rpcUrl || 'https://bsc-dataseed.binance.org';
+    const { provider, chainId } = createChainContext(rpcUrl);
+    const devWallet = new Wallet(creatorKey, provider);
+    const fourClient = new FourClient({ baseUrl: config.fourApiUrl });
+    const accessToken = await loginFourClient(devWallet, fourClient);
+    const imgUrl = await resolveTokenImage(fourClient, tokenInfo, accessToken);
+    // ✅ 兼容：历史调用可能把 Dev 首买金额塞在 buyAmounts[0]，而不是 tokenInfo.preSale
+    // Four 官方 API/链上 createArg 使用 preSale 表达“创建者预购金额”
+    const effectivePreSaleStr = tokenInfo.preSale && String(tokenInfo.preSale).trim().length > 0
+        ? String(tokenInfo.preSale)
+        : String(buyAmounts[0] ?? '0');
+    const createResp = await fourClient.createToken(accessToken, {
+        name: tokenInfo.name,
+        shortName: tokenInfo.symbol,
+        desc: tokenInfo.description,
+        imgUrl,
+        launchTime: Date.now(),
+        label: tokenInfo.label || 'Meme',
+        webUrl: tokenInfo.webUrl,
+        twitterUrl: tokenInfo.twitterUrl,
+        telegramUrl: tokenInfo.telegramUrl,
+        preSale: effectivePreSaleStr || '0',
+        onlyMPC: false,
+        // ✅ AntiSniperFeeMode（开盘高税模式）
+        ...(tokenInfo.feePlan ? { feePlan: true } : {}),
+        // ✅ 税币配置（Tax Token, creatorType=5）
+        ...(tokenInfo.tokenTaxInfo ? { tokenTaxInfo: tokenInfo.tokenTaxInfo } : {}),
+        lpTradingFee: 0.0025,
+        symbol: 'BNB',
+        totalSupply: 1000000000,
+        raisedAmount: 24,
+        saleRate: 0.8,
+        reserveRate: 0,
+        funGroup: false,
+        clickFun: false,
+    });
+    const gasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));
+    const nonceManager = new NonceManager(provider);
+    const txType = getTxType(config);
+    const signedTxs = [];
+    const tmCreateAddr = ADDRESSES.BSC.TokenManagerOriginal;
+    // ✅ 单笔交易: 和 Four.meme 官网一样
+    // 计算利润
+    const extractProfit = shouldExtractProfit();
+    // ✅ 对 create 流程来说，“买入金额”就是 preSale（创建者预购）
+    const originalBuyAmount = ethers.parseEther(effectivePreSaleStr || '0');
+    const profitAmount = extractProfit ? calculateProfit(originalBuyAmount).profit : 0n;
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    const b0AmountWei = ethers.parseEther(params.b0Amount ?? '0');
+    const preSaleWei = effectivePreSaleStr ? ethers.parseEther(effectivePreSaleStr) : 0n;
+    // ✅ 关键修复：
+    // createToken 的预购金额由 createArg.preSale 决定；因此这里只需要支付：创建费 + b0Amount + preSale
+    // 不要把“其它买入金额”额外塞进 msg.value，否则会被合约退回，造成“看起来没买到”的误解。
+    const valueWei = PLATFORM_CREATE_FEE + b0AmountWei + preSaleWei;
+    const tmCreate = new ethers.Contract(tmCreateAddr, TM2_ABI, devWallet);
+    const createTxUnsigned = await tmCreate.createToken.populateTransaction(createResp.createArg, createResp.signature, {
+        value: valueWei,
+    });
+    // ✅ 贿赂交易放在首位（由 devWallet 发送）
+    let bribeNonce;
+    if (needBribeTx) {
+        bribeNonce = await nonceManager.getNextNonce(devWallet);
+        signedTxs.push(await signBribeTransaction(devWallet, bribeAmount, bribeNonce, gasPrice, chainId, txType));
+    }
+    const createTxRequest = {
+        ...createTxUnsigned,
+        from: devWallet.address,
+        nonce: await nonceManager.getNextNonce(devWallet),
+        gasLimit: getGasLimit(config, 1500000),
+        gasPrice,
+        chainId,
+        type: getTxType(config),
+        value: valueWei,
+    };
+    signedTxs.push(await devWallet.signTransaction(createTxRequest));
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (extractProfit && profitAmount > 0n) {
+        const profitNonce = await nonceManager.getNextNonce(devWallet);
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: devWallet,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType,
+            startNonce: profitNonce,
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    nonceManager.clearTemp();
+    // ⚠️ 只返回签名交易,不提交
+    // 构建元数据
+    const metadata = extractProfit && profitAmount > 0n
+        ? {
+            totalBuyAmount: ethers.formatEther(originalBuyAmount),
+            profitAmount: ethers.formatEther(profitAmount),
+            profitRecipient: getProfitRecipient(),
+            buyerCount: 1,
+        }
+        : undefined;
+    return {
+        signedTransactions: signedTxs,
+        tokenAddress: ZERO_ADDRESS, // ⚠️ 占位符,实际地址需要等交易确认后从事件解析
+        profitHopWallets, // ✅ 返回利润多跳钱包
+        metadata,
+    };
+}

package/dist/bundle/four-meme/core/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Four.meme Bundle 核心方法 barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - constants.ts：常量与扩展 ABI
+ * - create-token.ts：创建代币 + 创建者买入
+ * - buy-flow.ts：批量买入流程
+ * - sell-flow.ts：批量卖出流程
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { createTokenWithBundleBuyMerkle } from './create-token.js';
+export { batchBuyWithBundleMerkle } from './buy-flow.js';
+export { batchSellWithBundleMerkle } from './sell-flow.js';

package/dist/bundle/four-meme/core/index.js

@@ -0,0 +1,14 @@
+/**
+ * Four.meme Bundle 核心方法 barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - constants.ts：常量与扩展 ABI
+ * - create-token.ts：创建代币 + 创建者买入
+ * - buy-flow.ts：批量买入流程
+ * - sell-flow.ts：批量卖出流程
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { createTokenWithBundleBuyMerkle } from './create-token.js';
+export { batchBuyWithBundleMerkle } from './buy-flow.js';
+export { batchSellWithBundleMerkle } from './sell-flow.js';

package/dist/bundle/four-meme/core/sell-flow.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Four.meme Bundle 核心方法 — 批量卖出流程
+ */
+import type { FourBatchSellSignParams, FourBatchSellMerkleResult } from '../types/index.js';
+export declare function batchSellWithBundleMerkle(params: FourBatchSellSignParams): Promise<FourBatchSellMerkleResult>;

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

@@ -0,0 +1,240 @@
+/**
+ * Four.meme Bundle 核心方法 — 批量卖出流程
+ */
+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 { MULTICALL3_ABI, ERC20_ABI } from '../../../abis/common.js';
+import { getBundleErrorMessage } from '../../errors.js';
+import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, } from '../../config-helpers.js';
+import { createSignProvider, signBribeTransaction } from '../../../core/sign-context-helpers.js';
+import { trySell } from '../../../domains/four/contracts/tm.js';
+import { createChainContext, createWallets } from '../core-helpers.js';
+import { TokenManagerHelper3 as Helper3Abi } from '../../../abis/contracts/index.js';
+import { TM2_ABI, MULTICALL3_ADDRESS } from './constants.js';
+export async function batchSellWithBundleMerkle(params) {
+    const { privateKeys, sellAmounts, tokenAddress, minOutputAmounts, config } = params;
+    if (privateKeys.length === 0 || sellAmounts.length !== privateKeys.length) {
+        throw new Error(getBundleErrorMessage('SELL_KEY_AMOUNT_MISMATCH'));
+    }
+    const { provider, chainId } = createChainContext(config.rpcUrl);
+    const txType = getTxType(config);
+    const sellers = createWallets(privateKeys, provider);
+    // ✅ 优化：并行初始化 nonceManager 和获取 gasPrice
+    const [nonceManager, gasPrice] = await Promise.all([
+        Promise.resolve(new NonceManager(provider)),
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+    ]);
+    const sellFlow = await executeSellFlow({
+        wallets: sellers,
+        sellAmounts,
+        tokenAddress,
+        minOutputAmounts,
+        config,
+        provider,
+        nonceManager,
+        contractAddress: ADDRESSES.BSC.TokenManagerOriginal,
+        gasPrice,
+        chainId,
+        rpcUrl: config.rpcUrl,
+        txType,
+    });
+    nonceManager.clearTemp();
+    return {
+        signedTransactions: sellFlow.signedTxs,
+        profitHopWallets: sellFlow.profitHopWallets, // ✅ 返回利润多跳钱包
+    };
+}
+async function executeSellFlow(options) {
+    const { wallets, sellAmounts, tokenAddress, minOutputAmounts, config, provider, nonceManager, contractAddress, gasPrice, chainId, rpcUrl, txType, } = options;
+    const amountsWei = sellAmounts.map((amount) => ethers.parseUnits(amount, 18));
+    const finalGasLimit = getGasLimit(config, 800000);
+    const extractProfit = shouldExtractProfit();
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 优化：并行执行 resolveSellOutputs、ensureSellerBalances 和批量获取 nonces（已移除授权检查）
+    const [sellOutputs, , nonces] = await Promise.all([
+        resolveSellOutputs({
+            minOutputAmounts,
+            sellers: wallets,
+            amountsWei,
+            rpcUrl,
+            tokenAddress,
+        }),
+        ensureSellerBalances({ provider, tokenAddress, sellers: wallets, amountsWei }),
+        nonceManager.getNextNoncesForWallets(wallets), // ✅ 批量获取 nonce（JSON-RPC 批量请求）
+    ]);
+    // ✅ 找出收益最多的钱包作为 payer（贿赂和利润都由它发送）
+    const { totalProfit, payer } = summarizeSellProfits(sellOutputs.quotedOutputs, wallets);
+    const payerWallet = payer ?? wallets[0];
+    const payerIndex = wallets.findIndex((w) => w.address.toLowerCase() === payerWallet.address.toLowerCase());
+    // ✅ 贿赂交易放在首位
+    const signedTxs = [];
+    let bribeNonceOffset = 0;
+    if (needBribeTx) {
+        const bribeNonce = nonces[payerIndex];
+        signedTxs.push(await signBribeTransaction(payerWallet, bribeAmount, bribeNonce, gasPrice, chainId, txType));
+        bribeNonceOffset = 1;
+    }
+    // ✅ 调整 payer 的 nonce（如果有贿赂交易，需要偏移）
+    const adjustedNonces = nonces.map((n, i) => (i === payerIndex ? n + bribeNonceOffset : n));
+    // ✅ 构建未签名交易
+    const unsignedSells = await populateSellTransactions({
+        sellers: wallets,
+        contractAddress,
+        tokenAddress,
+        amountsWei,
+        minOuts: sellOutputs.minOuts,
+    });
+    // ✅ 并行签名所有卖出交易
+    const signedSells = await Promise.all(unsignedSells.map((unsigned, index) => wallets[index].signTransaction({
+        ...unsigned,
+        from: wallets[index].address,
+        nonce: adjustedNonces[index],
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId,
+        type: txType,
+    })));
+    signedTxs.push(...signedSells);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    const profitHopWallets = await appendAggregatedProfitTransfer({
+        extractProfit,
+        totalProfit,
+        payer: payerWallet,
+        nonceManager,
+        provider,
+        gasPrice,
+        chainId,
+        txType,
+        signedTxs,
+        baseNonce: adjustedNonces[payerIndex] + 1, // ✅ 传入基础 nonce
+    });
+    return { signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
+}
+/**
+ * ✅ 使用 Multicall3 批量获取卖出报价（单次 RPC）
+ * 比 Promise.all 更高效，N 个报价只需 1 次网络请求
+ */
+async function resolveSellOutputs(params) {
+    const { minOutputAmounts, sellers, amountsWei, rpcUrl, tokenAddress } = 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);
+        return { minOuts, quotedOutputs };
+    }
+    // 如果只有 1 个，直接调用（避免 multicall 开销）
+    if (amountsWei.length === 1) {
+        try {
+            const result = await trySell('BSC', rpcUrl, tokenAddress, amountsWei[0]);
+            const quotedOutputs = [result.funds];
+            // ✅ 已移除滑点保护：minOuts 固定为 0
+            const minOuts = [0n];
+            return { minOuts, quotedOutputs };
+        }
+        catch {
+            return { minOuts: [0n], quotedOutputs: [0n] };
+        }
+    }
+    // ✅ 使用 Multicall3 批量获取报价
+    const provider = createSignProvider(rpcUrl, 56, 'BSC');
+    const helper3Address = ADDRESSES.BSC.TokenManagerHelper3;
+    const helper3Iface = new Interface(Helper3Abi);
+    const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+    // 构建批量调用
+    const calls = amountsWei.map((amount) => ({
+        target: helper3Address,
+        allowFailure: true, // 允许单个失败
+        callData: helper3Iface.encodeFunctionData('trySell', [tokenAddress, amount]),
+    }));
+    try {
+        const results = await multicall.aggregate3.staticCall(calls);
+        const quotedOutputs = results.map((r) => {
+            if (r.success && r.returnData && r.returnData !== '0x') {
+                try {
+                    const decoded = helper3Iface.decodeFunctionResult('trySell', r.returnData);
+                    // trySell 返回 (tokenManager, quote, funds, fee)，我们需要 funds
+                    return BigInt(decoded.funds);
+                }
+                catch {
+                    return 0n;
+                }
+            }
+            return 0n;
+        });
+        // ✅ 已移除滑点保护：minOuts 固定为 0
+        const minOuts = quotedOutputs.map(() => 0n);
+        return { minOuts, quotedOutputs };
+    }
+    catch {
+        // Multicall 失败，回退到并行调用
+        const quotedOutputs = await Promise.all(amountsWei.map(async (amount) => {
+            try {
+                const result = await trySell('BSC', rpcUrl, tokenAddress, amount);
+                return result.funds;
+            }
+            catch {
+                return 0n;
+            }
+        }));
+        // ✅ 已移除滑点保护：minOuts 固定为 0
+        const minOuts = quotedOutputs.map(() => 0n);
+        return { minOuts, quotedOutputs };
+    }
+}
+async function ensureSellerBalances(params) {
+    const { provider, tokenAddress, sellers, amountsWei } = params;
+    const tokenContract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
+    const balances = await Promise.all(sellers.map((wallet) => tokenContract.balanceOf(wallet.address)));
+    for (let i = 0; i < sellers.length; i++) {
+        if (balances[i] < amountsWei[i]) {
+            throw new Error(`钱包 ${i} 代币余额不足：需要 ${ethers.formatUnits(amountsWei[i], 18)}，实际 ${ethers.formatUnits(balances[i], 18)}`);
+        }
+    }
+}
+async function populateSellTransactions(params) {
+    const { sellers, contractAddress, tokenAddress, amountsWei, minOuts } = params;
+    const contracts = sellers.map((wallet) => new ethers.Contract(contractAddress, TM2_ABI, wallet));
+    return Promise.all(contracts.map((contract, index) => contract.sellToken.populateTransaction(0n, tokenAddress, amountsWei[index], minOuts[index])));
+}
+function summarizeSellProfits(quotedOutputs, sellers) {
+    let totalProfit = 0n;
+    let maxRevenue = 0n;
+    let payer;
+    quotedOutputs.forEach((output, index) => {
+        if (output <= 0n) {
+            return;
+        }
+        const { profit } = calculateProfit(output);
+        totalProfit += profit;
+        if (output > maxRevenue) {
+            maxRevenue = output;
+            payer = sellers[index];
+        }
+    });
+    return { totalProfit, payer };
+}
+async function appendAggregatedProfitTransfer(params) {
+    const { extractProfit, totalProfit, payer, nonceManager, provider, gasPrice, chainId, txType, signedTxs, baseNonce } = params;
+    if (!extractProfit || totalProfit <= 0n || !payer) {
+        return undefined;
+    }
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    const profitNonce = baseNonce ?? (await nonceManager.getNextNonce(payer));
+    const profitHopResult = await buildProfitHopTransactions({
+        provider,
+        payerWallet: payer,
+        profitAmount: totalProfit,
+        profitRecipient: getProfitRecipient(),
+        hopCount: PROFIT_HOP_COUNT,
+        gasPrice,
+        chainId,
+        txType,
+        startNonce: profitNonce,
+    });
+    signedTxs.push(...profitHopResult.signedTransactions);
+    return profitHopResult.hopWallets; // ✅ 返回利润多跳钱包
+}

package/dist/bundle/four-meme/core-helpers.js

@@ -1,7 +1,7 @@
 import { Wallet } from 'ethers';
 import { CHAINS } from '../../core/constants/index.js';
 import { buildLoginMessage } from '../../core/clients/four.js';
-import { createSignProvider } from '../sign-context-helpers.js';
+import { createSignProvider } from '../../core/sign-context-helpers.js';
 import { getBundleErrorMessage } from '../errors.js';
 export const CORE_CHAIN_ID = CHAINS.BSC.chainId;
 export function createChainContext(rpcUrl) {

package/dist/bundle/four-meme/core.d.ts

@@ -1,4 +1,7 @@
-import type { FourCreateWithBundleBuySignParams, FourCreateWithBundleBuyMerkleResult, FourBatchBuySignParams, FourBatchBuyMerkleResult, FourBatchSellSignParams, FourBatchSellMerkleResult } from './types.js';
-export declare function createTokenWithBundleBuyMerkle(params: FourCreateWithBundleBuySignParams): Promise<FourCreateWithBundleBuyMerkleResult>;
-export declare function batchBuyWithBundleMerkle(params: FourBatchBuySignParams): Promise<FourBatchBuyMerkleResult>;
-export declare function batchSellWithBundleMerkle(params: FourBatchSellSignParams): Promise<FourBatchSellMerkleResult>;
+/**
+ * Four.meme Bundle 核心方法
+ *
+ * 原超长文件按职责拆分为 core/ 目录下的多个子文件，
+ * 对外 export 符号与路径保持不变（见 core/index.ts）。
+ */
+export * from './core/index.js';