four-flap-meme-sdk 2.2.18 → 2.2.20

package/dist/bundle-core/four-meme/swap-buy-first.js

@@ -0,0 +1,456 @@
+/**
+ * Four.meme 内盘捆绑换手（Merkle Bundle）- 先买后卖
+ *
+ * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
+ */
+import { ethers, Contract, Wallet } from 'ethers';
+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 '../../shared/constants/index.js';
+import { TM_ABI, HELPER3_ABI, TM_ADDRESS } from './swap-internal.js';
+import { getTxType, getGasPriceConfig, getProfitRecipient, getBribeAmount, } from '../config-helpers.js';
+import { trySell } from '../../contracts/tm.js';
+import { splitAmountByWeight as splitAmount } from '../../shared/foundation/amount/split-by-weight.js';
+// ✅ 本地 getGasLimit（FourAnyConfig 支持 bigint gasLimit）
+function getGasLimit(config, defaultGas = 800000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    return BigInt(Math.ceil(defaultGas * multiplier));
+}
+// ==================== 多笔买卖常量 ====================
+/** 最大 Bundle 签名数 */
+const MAX_BUNDLE_SIGNATURES = 50;
+/** 贿赂交易数 */
+const BRIBE_TX_COUNT = 1;
+/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_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
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return getSharedProfitRateBps('v1Double');
+    }
+    return getSharedProfitRateBps('v0Double');
+}
+/**
+ * 验证买卖笔数
+ */
+function validateSwapCounts(buyCount, sellCount) {
+    if (buyCount < 1) {
+        throw new Error(`买入笔数必须至少为 1，当前为 ${buyCount}`);
+    }
+    if (sellCount < 1) {
+        throw new Error(`卖出笔数必须至少为 1，当前为 ${sellCount}`);
+    }
+    const totalSwaps = buyCount + sellCount;
+    if (totalSwaps > MAX_SWAP_TX_COUNT) {
+        throw new Error(`买卖笔数总和 (${totalSwaps}) 超出限制 (${MAX_SWAP_TX_COUNT})，` +
+            `最大签名数为 ${MAX_BUNDLE_SIGNATURES}（${BRIBE_TX_COUNT} 贿赂 + ${PROFIT_TX_COUNT} 利润 + ${MAX_SWAP_TX_COUNT} 买卖）`);
+    }
+}
+export async function fourBundleBuyFirstMerkle(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 buyCount = _buyCount ?? 1;
+    const sellCount = _sellCount ?? 1;
+    // ✅ 多钱包模式：使用单独的处理逻辑
+    if (isMultiWalletMode) {
+        return await fourBundleBuyFirstMultiWallet({
+            buyerPrivateKeys: buyerPrivateKeys || (buyerPrivateKey ? [buyerPrivateKey] : []),
+            sellerPrivateKeys: sellerPrivateKeys || (sellerPrivateKey ? [sellerPrivateKey] : []),
+            tokenAddress,
+            buyerFunds,
+            config,
+        });
+    }
+    // ✅ 单钱包模式（向后兼容）
+    if (!buyerPrivateKey || !sellerPrivateKey) {
+        throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
+    }
+    validateSwapCounts(buyCount, sellCount);
+    // ✅ 计算利润比例（根据 userType 动态调整）
+    const totalTxCount = buyCount + sellCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
+    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();
+    const finalGasLimit = getGasLimit(config);
+    const txType = getTxType(config);
+    const nonceManager = new NonceManager(provider);
+    const reserveGas = ethers.parseEther((config.reserveGasBNB || 0.0005).toString());
+    // ✅ 优化：第一批并行 - buyerBalance、gasPrice
+    const [buyerBalance, gasPrice] = await Promise.all([
+        provider.getBalance(buyer.address),
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+    ]);
+    // 计算买方投入资金
+    let buyerFundsWei;
+    if (buyerFunds !== undefined) {
+        buyerFundsWei = ethers.parseEther(String(buyerFunds));
+    }
+    else if (buyerFundsPercentage !== undefined) {
+        const pct = Math.max(0, Math.min(100, buyerFundsPercentage));
+        const spendable = buyerBalance > reserveGas ? buyerBalance - reserveGas : 0n;
+        buyerFundsWei = (spendable * BigInt(Math.round(pct * 100))) / 10000n;
+    }
+    else {
+        throw new Error('必须提供 buyerFunds 或 buyerFundsPercentage');
+    }
+    if (buyerFundsWei <= 0n) {
+        throw new Error('buyerFunds 需要大于 0');
+    }
+    // ✅ 优化：第二批并行 - 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 [buyQuote, sellerTokenBal, decimals] = await Promise.all([
+        helper3.tryBuy(tokenAddress, 0n, buyerFundsWei),
+        erc20.balanceOf(seller.address),
+        erc20.decimals(),
+    ]);
+    const estimatedTokenAmount = buyQuote.estimatedAmount ?? buyQuote[2];
+    if (!estimatedTokenAmount || estimatedTokenAmount <= 0n) {
+        throw new Error('报价失败：无法估算可买入的代币数量');
+    }
+    // ✅ 卖出数量直接使用估算的代币数量（无滑点保护）
+    const sellAmountWei = estimatedTokenAmount;
+    // 卖方余额检查
+    if (!sameAddress && sellerTokenBal < sellAmountWei) {
+        throw new Error(`卖方代币余额不足: 需要 ${ethers.formatUnits(sellAmountWei, decimals)}，实际 ${ethers.formatUnits(sellerTokenBal, decimals)}`);
+    }
+    // ✅ 优化：第三批并行 - trySell、构建交易、获取 nonces
+    const tmBuyer = new Contract(TM_ADDRESS, TM_ABI, buyer);
+    const tmSeller = new Contract(TM_ADDRESS, TM_ABI, seller);
+    // ✅ 拆分买入和卖出金额
+    const buyAmountsWei = splitAmount(buyerFundsWei, buyCount);
+    const sellAmountsWei = splitAmount(sellAmountWei, sellCount);
+    // 预先规划 nonces
+    const extractProfit = true;
+    // ✅ 获取贿赂金额
+    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));
+    // ✅ 规划多笔交易 nonce（与 Flap 一致，不含授权）
+    const multiNoncePlan = await planMultiNonces({
+        buyer,
+        seller,
+        buyCount,
+        sellCount,
+        extractProfit,
+        needBribeTx,
+        sameAddress,
+        nonceManager,
+    });
+    const [sellResult, buyUnsignedArray, sellUnsignedArray] = await Promise.all([
+        trySell('BSC', config.rpcUrl, tokenAddress, sellAmountWei),
+        Promise.all(buyUnsignedPromises),
+        Promise.all(sellUnsignedPromises),
+    ]);
+    const estimatedSellFunds = sellResult.funds;
+    const profitAmount = extractProfit ? (estimatedSellFunds * BigInt(profitRateBps)) / 10000n : 0n;
+    // ✅ 贿赂交易放在首位
+    let bribeTx = null;
+    if (needBribeTx && multiNoncePlan.bribeNonce !== undefined) {
+        bribeTx = await seller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: multiNoncePlan.bribeNonce,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: BigInt(chainIdNum),
+            type: txType,
+        });
+    }
+    // ✅ 并行签名所有买入和卖出交易
+    const buySignPromises = buyUnsignedArray.map((unsigned, i) => buyer.signTransaction({
+        ...unsigned,
+        from: buyer.address,
+        nonce: multiNoncePlan.buyerNonces[i],
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: BigInt(chainIdNum),
+        type: txType,
+        value: buyAmountsWei[i],
+    }));
+    const sellSignPromises = sellUnsignedArray.map((unsigned, i) => seller.signTransaction({
+        ...unsigned,
+        from: seller.address,
+        nonce: multiNoncePlan.sellerNonces[i],
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId: BigInt(chainIdNum),
+        type: txType,
+        value: 0n,
+    }));
+    const [signedBuys, signedSells] = await Promise.all([Promise.all(buySignPromises), Promise.all(sellSignPromises)]);
+    nonceManager.clearTemp();
+    // ✅ 组装交易列表：贿赂 → 买入(多笔) → 卖出(多笔)（与 Flap 一致）
+    const allTransactions = [];
+    if (bribeTx)
+        allTransactions.push(bribeTx);
+    allTransactions.push(...signedBuys, ...signedSells);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (extractProfit && profitAmount > 0n && multiNoncePlan.profitNonce !== undefined) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: seller,
+            profitAmount: profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: chainIdNum,
+            txType,
+            startNonce: multiNoncePlan.profitNonce,
+        });
+        allTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets, // ✅ 返回利润多跳钱包
+        metadata: {
+            buyerAddress: buyer.address,
+            sellerAddress: seller.address,
+            buyAmount: ethers.formatEther(buyerFundsWei),
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            profitAmount: extractProfit ? ethers.formatEther(profitAmount) : undefined,
+            // ✅ 返回多笔买卖信息
+            buyCount,
+            sellCount,
+            // ✅ 返回每笔交易的具体金额（随机分配后的数组）
+            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, }) {
+    const profitNonceCount = extractProfit ? 1 : 0;
+    if (sameAddress) {
+        // 同一地址：贿赂(可选) + 买入(多笔) + 卖出(多笔) + 利润(可选)
+        const bribeTxCount = needBribeTx ? 1 : 0;
+        const totalTxCount = bribeTxCount + buyCount + sellCount + profitNonceCount;
+        const nonces = await nonceManager.getNextNonceBatch(buyer, totalTxCount);
+        let idx = 0;
+        const bribeNonce = needBribeTx ? nonces[idx++] : undefined;
+        const buyerNonces = nonces.slice(idx, idx + buyCount);
+        idx += buyCount;
+        const sellerNonces = nonces.slice(idx, idx + sellCount);
+        idx += sellCount;
+        const profitNonce = extractProfit ? nonces[idx] : undefined;
+        return { buyerNonces, sellerNonces, bribeNonce, profitNonce };
+    }
+    // 不同地址
+    // 买方：buyCount 个 nonce
+    // 卖方：贿赂(可选) + sellCount + 利润(可选) 个 nonce
+    const bribeTxCount = needBribeTx ? 1 : 0;
+    const sellerTxCount = bribeTxCount + sellCount + profitNonceCount;
+    const [buyerNonces, sellerNoncesAll] = await Promise.all([
+        nonceManager.getNextNonceBatch(buyer, buyCount),
+        nonceManager.getNextNonceBatch(seller, sellerTxCount),
+    ]);
+    let idx = 0;
+    const bribeNonce = needBribeTx ? sellerNoncesAll[idx++] : undefined;
+    const sellerNonces = sellerNoncesAll.slice(idx, idx + sellCount);
+    idx += sellCount;
+    const profitNonce = extractProfit ? sellerNoncesAll[idx] : undefined;
+    return { buyerNonces, sellerNonces, bribeNonce, profitNonce };
+}
+/**
+ * ✅ Four 多钱包捆绑换手
+ * - 多个买方钱包执行买入（每个钱包1笔）
+ * - 多个卖方钱包执行卖出（每个钱包1笔）
+ * - 买入总价值 = 卖出总价值
+ * - ✅ 优化：最大化并行操作
+ */
+async function fourBundleBuyFirstMultiWallet(params) {
+    const { buyerPrivateKeys, sellerPrivateKeys, tokenAddress, buyerFunds, config } = params;
+    const buyCount = buyerPrivateKeys.length;
+    const sellCount = sellerPrivateKeys.length;
+    if (buyCount === 0)
+        throw new Error('买方钱包数量不能为0');
+    if (sellCount === 0)
+        throw new Error('卖方钱包数量不能为0');
+    // 验证总交易数不超过限制
+    validateSwapCounts(buyCount, sellCount);
+    // ✅ 计算利润比例（根据 userType 动态调整）
+    const totalTxCount = buyCount + sellCount;
+    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
+    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 mainSeller = sellers[0];
+    // ✅ 计算总交易金额
+    if (!buyerFunds) {
+        throw new Error('多钱包模式必须提供 buyerFunds（总交易金额）');
+    }
+    const totalFundsWei = ethers.parseEther(String(buyerFunds));
+    if (totalFundsWei <= 0n) {
+        throw new Error('交易金额必须大于0');
+    }
+    const finalGasLimit = getGasLimit(config);
+    const txType = getTxType(config);
+    const bribeAmount = getBribeAmount(config);
+    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 [buyQuote, gasPrice, decimals] = await Promise.all([
+        helper3.tryBuy(tokenAddress, 0n, totalFundsWei),
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        erc20.decimals(),
+    ]);
+    const estimatedTokenAmount = buyQuote.estimatedAmount ?? buyQuote[2];
+    if (!estimatedTokenAmount || estimatedTokenAmount <= 0n) {
+        throw new Error('报价失败：无法估算可买入的代币数量');
+    }
+    // ✅ 将总金额平均分配给买方
+    const buyAmountsWei = splitAmount(totalFundsWei, buyCount);
+    // ✅ 将代币平均分配给卖方
+    const sellAmountsWei = splitAmount(estimatedTokenAmount, sellCount);
+    // ✅ 第二批并行：估算利润 + 获取所有钱包 nonces
+    // 预先计算所有唯一钱包地址（去重）
+    const allWallets = [...sellers, ...buyers];
+    const uniqueWallets = allWallets.filter((w, i) => {
+        const addr = w.address.toLowerCase();
+        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),
+    ]);
+    // 构建 nonces Map
+    const noncesMap = new Map();
+    uniqueWallets.forEach((wallet, i) => {
+        noncesMap.set(wallet.address.toLowerCase(), noncesArray[i]);
+    });
+    const estimatedSellFunds = sellResult.funds;
+    const profitAmount = (estimatedSellFunds * BigInt(profitRateBps)) / 10000n;
+    // ✅ 第三批并行：构建并签名所有交易
+    const allTransactions = [];
+    const tm = new Contract(TM_ADDRESS, TM_ABI, provider);
+    // 1. 贿赂交易（由主卖方支付）- 先处理以确定 nonce 偏移
+    let bribeTxPromise = null;
+    if (needBribeTx) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const bribeNonce = noncesMap.get(mainSellerAddr);
+        noncesMap.set(mainSellerAddr, bribeNonce + 1);
+        bribeTxPromise = mainSeller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: 21000n,
+            chainId: BigInt(chainIdNum),
+            type: txType,
+        });
+    }
+    // 2. 预分配所有 nonces（同步操作，避免竞态）
+    const buyerNonces = [];
+    const sellerNonces = [];
+    buyers.forEach((buyer) => {
+        const addr = buyer.address.toLowerCase();
+        const nonce = noncesMap.get(addr);
+        buyerNonces.push(nonce);
+        noncesMap.set(addr, nonce + 1);
+    });
+    sellers.forEach((seller) => {
+        const addr = seller.address.toLowerCase();
+        const nonce = noncesMap.get(addr);
+        sellerNonces.push(nonce);
+        noncesMap.set(addr, nonce + 1);
+    });
+    // 3. 并行构建所有买入交易
+    const buyTxPromises = buyers.map(async (buyer, i) => {
+        const tmBuyer = tm.connect(buyer);
+        const unsigned = await tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyAmountsWei[i], 0n, { value: buyAmountsWei[i] });
+        return buyer.signTransaction({
+            ...unsigned,
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: BigInt(chainIdNum),
+            type: txType,
+            value: buyAmountsWei[i],
+        });
+    });
+    // 4. 并行构建所有卖出交易
+    const sellTxPromises = sellers.map(async (seller, i) => {
+        const tmSeller = tm.connect(seller);
+        const unsigned = await tmSeller.sellToken.populateTransaction(0n, tokenAddress, sellAmountsWei[i], 0n);
+        return seller.signTransaction({
+            ...unsigned,
+            from: seller.address,
+            nonce: sellerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            chainId: BigInt(chainIdNum),
+            type: txType,
+            value: 0n,
+        });
+    });
+    // ✅ 并行签名所有交易（贿赂 + 买入 + 卖出）
+    const [bribeTx, signedBuys, signedSells] = await Promise.all([
+        bribeTxPromise,
+        Promise.all(buyTxPromises),
+        Promise.all(sellTxPromises),
+    ]);
+    // 组装交易顺序：贿赂 → 买入 → 卖出
+    if (bribeTx)
+        allTransactions.push(bribeTx);
+    allTransactions.push(...signedBuys, ...signedSells);
+    // 5. 利润多跳转账（由主卖方支付）
+    let profitHopWallets;
+    if (profitAmount > 0n) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const profitNonce = noncesMap.get(mainSellerAddr);
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: mainSeller,
+            profitAmount,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: chainIdNum,
+            txType,
+            startNonce: profitNonce,
+        });
+        allTransactions.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets;
+    }
+    nonceManager.clearTemp();
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets,
+        metadata: {
+            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)),
+        },
+    };
+}

package/dist/bundle-core/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-core/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/bundle-core/four-meme/swap-internal.d.ts

@@ -0,0 +1,3 @@
+export declare const TM_ABI: string[];
+export declare const HELPER3_ABI: string[];
+export declare const TM_ADDRESS: "0x5c952063c7fc8610FFDB798152D69F0B9550762b";

package/dist/bundle-core/four-meme/swap-internal.js

@@ -0,0 +1,18 @@
+// 共享的 Swap 内部常量与 ABI
+// ✅ 从公共模块重新导出
+import { TM2_ABI, HELPER3_ABI as _HELPER3_ABI } from '../../abis/common.js';
+import { ADDRESSES } from '../../shared/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)',
+];
+// ✅ 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)',
+];
+// ✅ Four.meme 使用 TokenManagerOriginal（代理合约已移除）
+export const TM_ADDRESS = ADDRESSES.BSC.TokenManagerOriginal;

package/dist/bundle-core/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;