four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{contracts/tm-bundle-merkle → bundle/four-meme}/swap-buy-first.js

@@ -4,11 +4,13 @@
  * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
  */
 import { ethers, Contract, Wallet } from 'ethers';
-import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
-import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, PROFIT_CONFIG } from '../../utils/constants.js';
+import { createSignProvider } from '../sign-context-helpers.js';
+import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../utils/bundle-helpers.js';
+import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, CHAINS, getProfitRateBps as getSharedProfitRateBps, } from '../../core/constants/index.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';
+import { getTxType, getGasPriceConfig, getProfitRecipient, getBribeAmount, } from '../config-helpers.js';
+import { trySell } from '../../domains/four/contracts/tm.js';
+import { splitAmountByWeight as splitAmount } from '../../core/amount/split-by-weight.js';
 // ✅ 本地 getGasLimit（FourAnyConfig 支持 bigint gasLimit）
 function getGasLimit(config, defaultGas = 800000) {
     if (config.gasLimit !== undefined) {
@@ -31,9 +33,9 @@ const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COU
  */
 function getProfitRatePerTxBps(userType) {
     if (userType === 'v1') {
-        return PROFIT_CONFIG.RATE_BPS_V1_DOUBLE;
+        return getSharedProfitRateBps('v1Double');
     }
-    return PROFIT_CONFIG.RATE_BPS_V0_DOUBLE; // v0 或默认
+    return getSharedProfitRateBps('v0Double');
 }
 /**
  * 验证买卖笔数
@@ -51,49 +53,10 @@ function validateSwapCounts(buyCount, sellCount) {
             `最大签名数为 ${MAX_BUNDLE_SIGNATURES}（${BRIBE_TX_COUNT} 贿赂 + ${PROFIT_TX_COUNT} 利润 + ${MAX_SWAP_TX_COUNT} 买卖）`);
     }
 }
-/**
- * ✅ 将金额随机拆分成多份（更自然，不像机器人）
- * 每份金额在平均值的 50%-150% 之间随机浮动
- */
-function splitAmount(totalAmount, count) {
-    if (count <= 0) {
-        throw new Error('拆分份数必须大于 0');
-    }
-    if (count === 1) {
-        return [totalAmount];
-    }
-    // 生成随机权重（0.5 - 1.5 之间）
-    const weights = [];
-    for (let i = 0; i < count; i++) {
-        // 随机值在 0.5 - 1.5 之间，使每份金额有 ±50% 的浮动
-        weights.push(0.5 + Math.random());
-    }
-    // 计算权重总和
-    const totalWeight = weights.reduce((a, b) => a + b, 0);
-    // 根据权重分配金额
-    const amounts = [];
-    let allocated = 0n;
-    for (let i = 0; i < count - 1; i++) {
-        // 按权重比例分配
-        const ratio = weights[i] / totalWeight;
-        const amount = BigInt(Math.floor(Number(totalAmount) * ratio));
-        amounts.push(amount);
-        allocated += amount;
-    }
-    // 最后一份分配剩余的全部（确保总和精确）
-    amounts.push(totalAmount - allocated);
-    // 随机打乱顺序（让大小金额交错出现）
-    for (let i = amounts.length - 1; i > 0; i--) {
-        const j = Math.floor(Math.random() * (i + 1));
-        [amounts[i], amounts[j]] = [amounts[j], amounts[i]];
-    }
-    return amounts;
-}
 export async function fourBundleBuyFirstMerkle(params) {
-    const { buyerPrivateKey, buyerPrivateKeys, buyerFunds, buyerFundsPercentage, sellerPrivateKey, sellerPrivateKeys, tokenAddress, config, buyCount: _buyCount, sellCount: _sellCount } = params;
+    const { buyerPrivateKey, buyerPrivateKeys, buyerFunds, buyerFundsPercentage, sellerPrivateKey, sellerPrivateKeys, tokenAddress, config, buyCount: _buyCount, sellCount: _sellCount, } = params;
     // ✅ 判断是否为多钱包模式
-    const isMultiWalletMode = !!(buyerPrivateKeys && buyerPrivateKeys.length > 0) ||
-        !!(sellerPrivateKeys && sellerPrivateKeys.length > 0);
+    const isMultiWalletMode = !!(buyerPrivateKeys && buyerPrivateKeys.length > 0) || !!(sellerPrivateKeys && sellerPrivateKeys.length > 0);
     const buyCount = _buyCount ?? 1;
     const sellCount = _sellCount ?? 1;
     // ✅ 多钱包模式：使用单独的处理逻辑
@@ -103,7 +66,7 @@ export async function fourBundleBuyFirstMerkle(params) {
             sellerPrivateKeys: sellerPrivateKeys || (sellerPrivateKey ? [sellerPrivateKey] : []),
             tokenAddress,
             buyerFunds,
-            config
+            config,
         });
     }
     // ✅ 单钱包模式（向后兼容）
@@ -114,11 +77,8 @@ export async function fourBundleBuyFirstMerkle(params) {
     // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
     const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
-    const chainIdNum = config.chainId ?? 56;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chainIdNum,
-        name: 'BSC'
-    });
+    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
+    const provider = createSignProvider(config.rpcUrl, chainIdNum, 'BSC');
     const buyer = new Wallet(buyerPrivateKey, provider);
     const seller = new Wallet(sellerPrivateKey, provider);
     const sameAddress = buyer.address.toLowerCase() === seller.address.toLowerCase();
@@ -129,7 +89,7 @@ export async function fourBundleBuyFirstMerkle(params) {
     // ✅ 优化：第一批并行 - buyerBalance、gasPrice
     const [buyerBalance, gasPrice] = await Promise.all([
         provider.getBalance(buyer.address),
-        getOptimizedGasPrice(provider, getGasPriceConfig(config))
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
     ]);
     // 计算买方投入资金
     let buyerFundsWei;
@@ -149,14 +109,11 @@ export async function fourBundleBuyFirstMerkle(params) {
     }
     // ✅ 优化：第二批并行 - buyQuote、sellerTokenBal、decimals
     const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
-    const erc20 = new Contract(tokenAddress, [
-        'function balanceOf(address) view returns (uint256)',
-        'function decimals() view returns (uint8)'
-    ], provider);
+    const erc20 = new Contract(tokenAddress, ['function balanceOf(address) view returns (uint256)', 'function decimals() view returns (uint8)'], provider);
     const [buyQuote, sellerTokenBal, decimals] = await Promise.all([
         helper3.tryBuy(tokenAddress, 0n, buyerFundsWei),
         erc20.balanceOf(seller.address),
-        erc20.decimals()
+        erc20.decimals(),
     ]);
     const estimatedTokenAmount = buyQuote.estimatedAmount ?? buyQuote[2];
     if (!estimatedTokenAmount || estimatedTokenAmount <= 0n) {
@@ -180,8 +137,8 @@ export async function fourBundleBuyFirstMerkle(params) {
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
     // ✅ 构建多笔买入和卖出交易
-    const buyUnsignedPromises = buyAmountsWei.map(amount => tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, amount, 0n, { value: amount }));
-    const sellUnsignedPromises = sellAmountsWei.map(amount => tmSeller.sellToken.populateTransaction(0n, tokenAddress, amount, 0n));
+    const buyUnsignedPromises = buyAmountsWei.map((amount) => tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, amount, 0n, { value: amount }));
+    const sellUnsignedPromises = sellAmountsWei.map((amount) => tmSeller.sellToken.populateTransaction(0n, tokenAddress, amount, 0n));
     // ✅ 规划多笔交易 nonce（与 Flap 一致，不含授权）
     const multiNoncePlan = await planMultiNonces({
         buyer,
@@ -191,12 +148,12 @@ export async function fourBundleBuyFirstMerkle(params) {
         extractProfit,
         needBribeTx,
         sameAddress,
-        nonceManager
+        nonceManager,
     });
     const [sellResult, buyUnsignedArray, sellUnsignedArray] = await Promise.all([
         trySell('BSC', config.rpcUrl, tokenAddress, sellAmountWei),
         Promise.all(buyUnsignedPromises),
-        Promise.all(sellUnsignedPromises)
+        Promise.all(sellUnsignedPromises),
     ]);
     const estimatedSellFunds = sellResult.funds;
     const profitAmount = extractProfit ? (estimatedSellFunds * BigInt(profitRateBps)) / 10000n : 0n;
@@ -209,8 +166,8 @@ export async function fourBundleBuyFirstMerkle(params) {
             nonce: multiNoncePlan.bribeNonce,
             gasPrice,
             gasLimit: 21000n,
-            chainId: chainIdNum,
-            type: txType
+            chainId: BigInt(chainIdNum),
+            type: txType,
         });
     }
     // ✅ 并行签名所有买入和卖出交易
@@ -220,9 +177,9 @@ export async function fourBundleBuyFirstMerkle(params) {
         nonce: multiNoncePlan.buyerNonces[i],
         gasLimit: finalGasLimit,
         gasPrice,
-        chainId: chainIdNum,
+        chainId: BigInt(chainIdNum),
         type: txType,
-        value: buyAmountsWei[i]
+        value: buyAmountsWei[i],
     }));
     const sellSignPromises = sellUnsignedArray.map((unsigned, i) => seller.signTransaction({
         ...unsigned,
@@ -230,14 +187,11 @@ export async function fourBundleBuyFirstMerkle(params) {
         nonce: multiNoncePlan.sellerNonces[i],
         gasLimit: finalGasLimit,
         gasPrice,
-        chainId: chainIdNum,
+        chainId: BigInt(chainIdNum),
         type: txType,
-        value: 0n
+        value: 0n,
     }));
-    const [signedBuys, signedSells] = await Promise.all([
-        Promise.all(buySignPromises),
-        Promise.all(sellSignPromises)
-    ]);
+    const [signedBuys, signedSells] = await Promise.all([Promise.all(buySignPromises), Promise.all(sellSignPromises)]);
     nonceManager.clearTemp();
     // ✅ 组装交易列表：贿赂 → 买入(多笔) → 卖出(多笔)（与 Flap 一致）
     const allTransactions = [];
@@ -256,7 +210,7 @@ export async function fourBundleBuyFirstMerkle(params) {
             gasPrice,
             chainId: chainIdNum,
             txType,
-            startNonce: multiNoncePlan.profitNonce
+            startNonce: multiNoncePlan.profitNonce,
         });
         allTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -274,16 +228,16 @@ export async function fourBundleBuyFirstMerkle(params) {
             buyCount,
             sellCount,
             // ✅ 返回每笔交易的具体金额（随机分配后的数组）
-            buyAmounts: buyAmountsWei.map(amt => ethers.formatEther(amt)),
-            sellAmounts: sellAmountsWei.map(amt => ethers.formatUnits(amt, decimals))
-        }
+            buyAmounts: buyAmountsWei.map((amt) => ethers.formatEther(amt)),
+            sellAmounts: sellAmountsWei.map((amt) => ethers.formatUnits(amt, decimals)),
+        },
     };
 }
 /**
  * ✅ 规划多笔交易 nonce（与 Flap 一致）
  * 交易顺序：贿赂 → 买入(多笔) → 卖出(多笔) → 利润
  */
-async function planMultiNonces({ buyer, seller, buyCount, sellCount, extractProfit, needBribeTx, sameAddress, nonceManager }) {
+async function planMultiNonces({ buyer, seller, buyCount, sellCount, extractProfit, needBribeTx, sameAddress, nonceManager, }) {
     const profitNonceCount = extractProfit ? 1 : 0;
     if (sameAddress) {
         // 同一地址：贿赂(可选) + 买入(多笔) + 卖出(多笔) + 利润(可选)
@@ -306,7 +260,7 @@ async function planMultiNonces({ buyer, seller, buyCount, sellCount, extractProf
     const sellerTxCount = bribeTxCount + sellCount + profitNonceCount;
     const [buyerNonces, sellerNoncesAll] = await Promise.all([
         nonceManager.getNextNonceBatch(buyer, buyCount),
-        nonceManager.getNextNonceBatch(seller, sellerTxCount)
+        nonceManager.getNextNonceBatch(seller, sellerTxCount),
     ]);
     let idx = 0;
     const bribeNonce = needBribeTx ? sellerNoncesAll[idx++] : undefined;
@@ -335,15 +289,12 @@ async function fourBundleBuyFirstMultiWallet(params) {
     // ✅ 计算利润比例（根据 userType 动态调整）
     const totalTxCount = buyCount + sellCount;
     const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
-    const chainIdNum = config.chainId ?? 56;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chainIdNum,
-        name: 'BSC'
-    });
+    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
+    const provider = createSignProvider(config.rpcUrl, chainIdNum, 'BSC');
     const nonceManager = new NonceManager(provider);
     // 创建所有钱包实例
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, provider));
-    const sellers = sellerPrivateKeys.map(pk => new Wallet(pk, provider));
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, provider));
+    const sellers = sellerPrivateKeys.map((pk) => new Wallet(pk, provider));
     // 使用第一个卖方作为主卖方（支付贿赂和利润）
     const mainSeller = sellers[0];
     // ✅ 计算总交易金额
@@ -360,13 +311,11 @@ async function fourBundleBuyFirstMultiWallet(params) {
     const needBribeTx = bribeAmount > 0n;
     // ✅ 第一批并行：报价 + Gas价格 + 代币精度
     const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
-    const erc20 = new Contract(tokenAddress, [
-        'function decimals() view returns (uint8)'
-    ], provider);
+    const erc20 = new Contract(tokenAddress, ['function decimals() view returns (uint8)'], provider);
     const [buyQuote, gasPrice, decimals] = await Promise.all([
         helper3.tryBuy(tokenAddress, 0n, totalFundsWei),
         getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-        erc20.decimals()
+        erc20.decimals(),
     ]);
     const estimatedTokenAmount = buyQuote.estimatedAmount ?? buyQuote[2];
     if (!estimatedTokenAmount || estimatedTokenAmount <= 0n) {
@@ -379,15 +328,14 @@ async function fourBundleBuyFirstMultiWallet(params) {
     // ✅ 第二批并行：估算利润 + 获取所有钱包 nonces
     // 预先计算所有唯一钱包地址（去重）
     const allWallets = [...sellers, ...buyers];
-    const uniqueAddresses = new Set(allWallets.map(w => w.address.toLowerCase()));
     const uniqueWallets = allWallets.filter((w, i) => {
         const addr = w.address.toLowerCase();
-        const firstIdx = allWallets.findIndex(x => x.address.toLowerCase() === addr);
+        const firstIdx = allWallets.findIndex((x) => x.address.toLowerCase() === addr);
         return firstIdx === i;
     });
     const [sellResult, noncesArray] = await Promise.all([
         trySell('BSC', config.rpcUrl, tokenAddress, estimatedTokenAmount),
-        nonceManager.getNextNoncesForWallets(uniqueWallets)
+        nonceManager.getNextNoncesForWallets(uniqueWallets),
     ]);
     // 构建 nonces Map
     const noncesMap = new Map();
@@ -411,20 +359,20 @@ async function fourBundleBuyFirstMultiWallet(params) {
             nonce: bribeNonce,
             gasPrice,
             gasLimit: 21000n,
-            chainId: chainIdNum,
-            type: txType
+            chainId: BigInt(chainIdNum),
+            type: txType,
         });
     }
     // 2. 预分配所有 nonces（同步操作，避免竞态）
     const buyerNonces = [];
     const sellerNonces = [];
-    buyers.forEach(buyer => {
+    buyers.forEach((buyer) => {
         const addr = buyer.address.toLowerCase();
         const nonce = noncesMap.get(addr);
         buyerNonces.push(nonce);
         noncesMap.set(addr, nonce + 1);
     });
-    sellers.forEach(seller => {
+    sellers.forEach((seller) => {
         const addr = seller.address.toLowerCase();
         const nonce = noncesMap.get(addr);
         sellerNonces.push(nonce);
@@ -440,9 +388,9 @@ async function fourBundleBuyFirstMultiWallet(params) {
             nonce: buyerNonces[i],
             gasLimit: finalGasLimit,
             gasPrice,
-            chainId: chainIdNum,
+            chainId: BigInt(chainIdNum),
             type: txType,
-            value: buyAmountsWei[i]
+            value: buyAmountsWei[i],
         });
     });
     // 4. 并行构建所有卖出交易
@@ -455,16 +403,16 @@ async function fourBundleBuyFirstMultiWallet(params) {
             nonce: sellerNonces[i],
             gasLimit: finalGasLimit,
             gasPrice,
-            chainId: chainIdNum,
+            chainId: BigInt(chainIdNum),
             type: txType,
-            value: 0n
+            value: 0n,
         });
     });
     // ✅ 并行签名所有交易（贿赂 + 买入 + 卖出）
     const [bribeTx, signedBuys, signedSells] = await Promise.all([
         bribeTxPromise,
         Promise.all(buyTxPromises),
-        Promise.all(sellTxPromises)
+        Promise.all(sellTxPromises),
     ]);
     // 组装交易顺序：贿赂 → 买入 → 卖出
     if (bribeTx)
@@ -484,7 +432,7 @@ async function fourBundleBuyFirstMultiWallet(params) {
             gasPrice,
             chainId: chainIdNum,
             txType,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         allTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets;
@@ -494,15 +442,15 @@ async function fourBundleBuyFirstMultiWallet(params) {
         signedTransactions: allTransactions,
         profitHopWallets,
         metadata: {
-            buyerAddress: buyers.map(b => b.address).join(','),
-            sellerAddress: sellers.map(s => s.address).join(','),
+            buyerAddress: buyers.map((b) => b.address).join(','),
+            sellerAddress: sellers.map((s) => s.address).join(','),
             buyAmount: ethers.formatEther(totalFundsWei),
             sellAmount: ethers.formatUnits(estimatedTokenAmount, decimals),
             profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
             buyCount,
             sellCount,
-            buyAmounts: buyAmountsWei.map(amt => ethers.formatEther(amt)),
-            sellAmounts: sellAmountsWei.map(amt => ethers.formatUnits(amt, decimals))
-        }
+            buyAmounts: buyAmountsWei.map((amt) => ethers.formatEther(amt)),
+            sellAmounts: sellAmountsWei.map((amt) => ethers.formatUnits(amt, decimals)),
+        },
     };
 }

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

@@ -0,0 +1,6 @@
+import { Wallet, type JsonRpcProvider } from 'ethers';
+import type { DisperseHopPath } from './types.js';
+export declare const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
+export type { DisperseHopPath } from './types.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

@@ -0,0 +1,63 @@
+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;
+}

package/dist/{contracts/tm-bundle-merkle → bundle/four-meme}/swap-internal.js

@@ -1,18 +1,18 @@
 // 共享的 Swap 内部常量与 ABI
 // ✅ 从公共模块重新导出
-import { TM2_ABI, HELPER3_ABI as _HELPER3_ABI } from '../../shared/abis/common.js';
-import { ADDRESSES } from '../../utils/constants.js';
+import { TM2_ABI, HELPER3_ABI as _HELPER3_ABI } from '../../abis/common.js';
+import { ADDRESSES } from '../../core/constants/index.js';
 // ✅ Four.meme 内盘 ABI（与公共 TM2_ABI 扩展）
 export const TM_ABI = [
     ...TM2_ABI,
     'function sellToken(uint256 origin, address token, uint256 amount, uint256 minFunds) returns (uint256)',
-    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable returns (uint256)'
+    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable returns (uint256)',
 ];
 // ✅ Helper3 ABI（与公共 HELPER3_ABI 扩展）
 export const HELPER3_ABI = [
     ..._HELPER3_ABI,
     'function tryBuy(address token, uint256 amount, uint256 funds) view returns (address tokenManager, address quote, uint256 estimatedAmount, uint256 estimatedCost, uint256 estimatedFee, uint256 amountMsgValue, uint256 amountApproval, uint256 amountFunds)',
-    'function trySell(address token, uint256 amount) view returns (address tokenManager, address quote, uint256 funds, uint256 fee)'
+    'function trySell(address token, uint256 amount) view returns (address tokenManager, address quote, uint256 funds, uint256 fee)',
 ];
 // ✅ Four.meme 使用 TokenManagerOriginal（代理合约已移除）
 export const TM_ADDRESS = ADDRESSES.BSC.TokenManagerOriginal;

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

@@ -0,0 +1,28 @@
+import { Wallet, type JsonRpcProvider } from 'ethers';
+import { type CommonBundleConfig } from '../../utils/bundle-helpers.js';
+import type { FourSwapSignConfig, SellerNoncePlan, UserType } from './types.js';
+export type { SellerNoncePlan } from './types.js';
+export declare function getFourSwapProfitRateBps(userType?: UserType): number;
+export declare function needsTmTokenApproval(currentAllowance: bigint, decimals: number): boolean;
+export declare function countSellerNonceSlots(needBribeTx: boolean, needApproval: boolean, includeProfit: boolean): number;
+export declare function planSellerNonces(sellerNonces: number[], needBribeTx: boolean, needApproval: boolean, extractProfit: boolean): SellerNoncePlan;
+export declare function signTmMaxApprovalTx(seller: Wallet, tokenAddress: string, approvalNonce: number, gasPrice: bigint, chainIdNum: number, txType: 0 | 2): Promise<string>;
+export declare function quoteFourSwapSellFunds(provider: JsonRpcProvider, tokenAddress: string, sellAmountWei: bigint): Promise<bigint>;
+export declare function fetchFourSwapSellQuoteAndAllowance(provider: JsonRpcProvider, tokenAddress: string, sellerAddress: string, sellAmountWei: bigint): Promise<{
+    sellFunds: bigint;
+    allowance: bigint;
+}>;
+export declare function fetchFourSwapSellQuoteAllowanceAndBalances(provider: JsonRpcProvider, tokenAddress: string, sellerAddress: string, sellAmountWei: bigint, buyerAddresses: string[]): Promise<{
+    sellFunds: bigint;
+    allowance: bigint;
+    buyerBalances: bigint[];
+}>;
+export declare function toCommonBundleConfig(config: FourSwapSignConfig): CommonBundleConfig;
+export type FourSwapGasContext = {
+    chainIdNum: number;
+    provider: JsonRpcProvider;
+    bundleConfig: CommonBundleConfig;
+    finalGasLimit: bigint;
+    txType: 0 | 2;
+};
+export declare function createFourSwapGasContext(config: FourSwapSignConfig): FourSwapGasContext;

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

@@ -0,0 +1,105 @@
+import { ethers, Contract } from 'ethers';
+import { getGasLimit } from '../../utils/bundle-helpers.js';
+import { ADDRESSES, CHAINS } from '../../core/constants/index.js';
+import { getProfitRateBps as getSharedProfitRateBps } from '../../core/constants/index.js';
+import { getTxType } from '../config-helpers.js';
+import { createSignProvider } from '../sign-context-helpers.js';
+import { HELPER3_ABI, TM_ADDRESS } from './swap-internal.js';
+const APPROVE_INTERFACE = new ethers.Interface(['function approve(address,uint256) returns (bool)']);
+const ERC20_ALLOWANCE_ABI = ['function allowance(address,address) view returns (uint256)'];
+export function getFourSwapProfitRateBps(userType) {
+    if (userType === 'v0')
+        return getSharedProfitRateBps('v0Single');
+    if (userType === 'v1')
+        return getSharedProfitRateBps('v1Single');
+    return getSharedProfitRateBps('v0Single');
+}
+export function needsTmTokenApproval(currentAllowance, decimals) {
+    const threshold = ethers.parseUnits('1000000000', decimals);
+    return currentAllowance < threshold;
+}
+export function countSellerNonceSlots(needBribeTx, needApproval, includeProfit) {
+    let count = 1;
+    if (needBribeTx)
+        count++;
+    if (needApproval)
+        count++;
+    if (includeProfit)
+        count++;
+    return count;
+}
+export function planSellerNonces(sellerNonces, needBribeTx, needApproval, extractProfit) {
+    let idx = 0;
+    const plan = { sellerNonce: sellerNonces[0] };
+    if (needBribeTx)
+        plan.bribeNonce = sellerNonces[idx++];
+    if (needApproval)
+        plan.approvalNonce = sellerNonces[idx++];
+    plan.sellerNonce = sellerNonces[idx++];
+    if (extractProfit)
+        plan.profitNonce = sellerNonces[idx];
+    return plan;
+}
+export async function signTmMaxApprovalTx(seller, tokenAddress, approvalNonce, gasPrice, chainIdNum, txType) {
+    const approveData = APPROVE_INTERFACE.encodeFunctionData('approve', [TM_ADDRESS, ethers.MaxUint256]);
+    return seller.signTransaction({
+        to: tokenAddress,
+        data: approveData,
+        value: 0n,
+        nonce: approvalNonce,
+        gasLimit: 80000n,
+        gasPrice,
+        chainId: chainIdNum,
+        type: txType,
+    });
+}
+export async function quoteFourSwapSellFunds(provider, tokenAddress, sellAmountWei) {
+    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
+    const sellQuote = await helper3.trySell(tokenAddress, sellAmountWei);
+    return sellQuote.funds;
+}
+export async function fetchFourSwapSellQuoteAndAllowance(provider, tokenAddress, sellerAddress, sellAmountWei) {
+    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
+    const erc20 = new Contract(tokenAddress, ERC20_ALLOWANCE_ABI, provider);
+    const [sellQuote, allowance] = await Promise.all([
+        helper3.trySell(tokenAddress, sellAmountWei),
+        erc20.allowance(sellerAddress, TM_ADDRESS),
+    ]);
+    return { sellFunds: sellQuote.funds, allowance };
+}
+export async function fetchFourSwapSellQuoteAllowanceAndBalances(provider, tokenAddress, sellerAddress, sellAmountWei, buyerAddresses) {
+    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
+    const erc20 = new Contract(tokenAddress, ERC20_ALLOWANCE_ABI, provider);
+    const [sellQuote, allowance, ...buyerBalances] = await Promise.all([
+        helper3.trySell(tokenAddress, sellAmountWei),
+        erc20.allowance(sellerAddress, TM_ADDRESS),
+        ...buyerAddresses.map((addr) => provider.getBalance(addr)),
+    ]);
+    return {
+        sellFunds: sellQuote.funds,
+        allowance,
+        buyerBalances,
+    };
+}
+export function toCommonBundleConfig(config) {
+    return {
+        minGasPriceGwei: config.minGasPriceGwei,
+        maxGasPriceGwei: config.maxGasPriceGwei,
+        gasLimit: typeof config.gasLimit === 'bigint' ? Number(config.gasLimit) : config.gasLimit,
+        gasLimitMultiplier: config.gasLimitMultiplier,
+        txType: config.txType,
+        chainId: config.chainId,
+    };
+}
+export function createFourSwapGasContext(config) {
+    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
+    const provider = createSignProvider(config.rpcUrl, chainIdNum, 'BSC');
+    const bundleConfig = toCommonBundleConfig(config);
+    return {
+        chainIdNum,
+        provider,
+        bundleConfig,
+        finalGasLimit: getGasLimit(bundleConfig),
+        txType: getTxType(bundleConfig),
+    };
+}

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

@@ -0,0 +1,17 @@
+/**
+ * Four.meme 内盘捆绑换手（Merkle Bundle）
+ */
+import type { FourBatchSwapResult, FourBatchSwapSignParams, FourBundleSwapSignParams, FourQuickBatchSwapResult, FourQuickBatchSwapSignParams, FourSwapResult } from './types.js';
+export type { UserType, FourSwapSignConfig, FourSwapConfig, FourBundleSwapSignParams, FourBundleSwapParams, FourSwapResult, FourBatchSwapSignParams, FourBatchSwapResult, FourQuickBatchSwapSignParams, FourQuickBatchSwapResult, } from './types.js';
+/**
+ * Four内盘捆绑换手
+ */
+export declare function fourBundleSwapMerkle(params: FourBundleSwapSignParams): Promise<FourSwapResult>;
+/**
+ * Four 内盘批量换手（一卖多买）
+ */
+export declare function fourBatchSwapMerkle(params: FourBatchSwapSignParams): Promise<FourBatchSwapResult>;
+/**
+ * Four 内盘快捷批量换手（资金利用率模式）
+ */
+export declare function fourQuickBatchSwapMerkle(params: FourQuickBatchSwapSignParams): Promise<FourQuickBatchSwapResult>;