four-flap-meme-sdk 3.0.0 → 4.0.0

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

@@ -2,124 +2,14 @@
  * Flap Protocol 内盘捆绑换手（Merkle Bundle）- 先买后卖
  *
  * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { ethers } from 'ethers';
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
-import { FlapSignConfig } from './config.js';
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-export declare const BSC_PANCAKE_V2_ROUTER: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
-export declare const BSC_WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
-export declare const MONAD_PANCAKE_V2_ROUTER = "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
-export declare const MONAD_WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
-export declare const ROUTER_ABI: string[];
-/**
- * 获取 ERC20 代币 → 原生代币的报价
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param tokenAmount - 代币数量（wei）
- * @param chainId - 链 ID（56=BSC, 143=Monad）
- * @returns 等值的原生代币数量（wei），失败返回 0n
- */
-export declare function getTokenToNativeQuote(provider: ethers.JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, chainId: number): Promise<bigint>;
-export type FlapChain = 'bsc' | 'xlayer' | 'base';
-/**
- * 获取 Gas Limit（支持 FlapAnyConfig）
- */
-export declare function getGasLimit(config: FlapSignConfig | CommonBundleConfig, defaultGas?: number): bigint;
-/** 最大 Bundle 签名数 */
-export declare const MAX_BUNDLE_SIGNATURES = 50;
-/** 贿赂交易数 */
-export declare const BRIBE_TX_COUNT = 1;
-/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
-export declare const PROFIT_TX_COUNT: number;
-/** 最大买卖交易数 */
-export declare const MAX_SWAP_TX_COUNT: number;
-export type UserType = 'v0' | 'v1';
-/**
- * 根据 userType 获取每笔交易的利润率
- */
-export declare function getProfitRatePerTxBps(userType?: UserType): number;
-export interface FlapBuyFirstSignConfig extends FlapSignConfig {
-    reserveGasETH?: number;
-    skipQuoteOnError?: boolean;
-    userType?: UserType;
-}
-export interface FlapBuyFirstConfig extends CommonBundleConfig {
-    apiKey: string;
-    customRpcUrl?: string;
-    bundleBlockOffset?: number;
-    reserveGasETH?: number;
-    skipQuoteOnError?: boolean;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-}
-export interface FlapBundleBuyFirstSignParams {
-    chain: FlapChain;
-    buyerPrivateKey?: string;
-    buyerPrivateKeys?: string[];
-    sellerPrivateKey?: string;
-    sellerPrivateKeys?: string[];
-    tokenAddress: string;
-    buyerFunds?: string;
-    buyerFundsPercentage?: number;
-    config: FlapBuyFirstSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    buyCount?: number;
-    sellCount?: number;
-}
-export interface FlapBundleBuyFirstParams {
-    chain: FlapChain;
-    buyerPrivateKey: string;
-    sellerPrivateKey: string;
-    tokenAddress: string;
-    buyerFunds?: string;
-    buyerFundsPercentage?: number;
-    config: FlapBuyFirstConfig;
-}
-/** ✅ Flap BuyFirst 结果（简化版） */
-export type FlapBuyFirstResult = {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        buyerAddress: string;
-        sellerAddress: string;
-        buyAmount: string;
-        sellAmount: string;
-        profitAmount?: string;
-        buyCount?: number;
-        sellCount?: number;
-        buyAmounts?: string[];
-        sellAmounts?: string[];
-    };
-};
-export type ChainContext = {
-    chainId: number;
-    nativeToken: string;
-    portalAddress: string;
-    provider: ethers.JsonRpcProvider;
-};
-export type BuyerFundsResult = {
-    buyerFundsWei: bigint;
-    buyerBalance: bigint;
-};
-export type QuoteResult = {
-    quotedToken: bigint;
-    sellAmountWei: bigint;
-};
-export type SellerInfo = {
-    decimals: number;
-};
-/** ✅ 多笔买卖 nonce 规划 */
-export type MultiNoncePlan = {
-    buyerNonces: number[];
-    sellerNonces: number[];
-    bribeNonce?: number;
-    profitNonce?: number;
-};
-/**
- * 验证买卖笔数
- */
-export declare function validateSwapCounts(buyCount: number, sellCount: number): void;
-export declare function getChainId(chain: FlapChain): number;
-export declare function getNativeTokenName(chain: FlapChain): string;
+ *
+ * 拆分说明：类型/常量/链上下文/报价/规划/利润/多钱包 已拆到同名子文件，
+ * 本文件作为 barrel 保持对外 export 符号/路径/签名不变。
+ */
+export * from './swap-buy-first-types.js';
+export * from './swap-buy-first-constants.js';
+export * from './swap-buy-first-chain.js';
+export * from './swap-buy-first-quote.js';
+export * from './swap-buy-first-plan.js';
+export * from './swap-buy-first-profit.js';
+export * from './swap-buy-first-multi-wallet.js';

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

@@ -2,112 +2,14 @@
  * Flap Protocol 内盘捆绑换手（Merkle Bundle）- 先买后卖
  *
  * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { Contract } from 'ethers';
-import { PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
-import { ADDRESSES } from '../../../core/constants/index.js';
-import { CHAINS, getProfitRateBps } from '../../../core/constants/index.js';
-import { V2_ROUTER_QUOTE_ABI } from '../../../core/shared-abis/common.js';
-// ==================== 链常量 ====================
-export const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
-export const BSC_WBNB = ADDRESSES.BSC.WBNB;
-export const MONAD_PANCAKE_V2_ROUTER = '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9';
-export const MONAD_WMON = ADDRESSES.MONAD.WMON;
-export const ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
-/**
- * 获取 ERC20 代币 → 原生代币的报价
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param tokenAmount - 代币数量（wei）
- * @param chainId - 链 ID（56=BSC, 143=Monad）
- * @returns 等值的原生代币数量（wei），失败返回 0n
- */
-export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId) {
-    if (tokenAmount <= 0n)
-        return 0n;
-    try {
-        if (chainId === CHAINS.BSC.chainId) {
-            // BSC: 使用 PancakeSwap V2 Router
-            const router = new Contract(BSC_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, BSC_WBNB]);
-            return amounts[1];
-        }
-        if (chainId === CHAINS.MONAD.chainId) {
-            // ✅ Monad: 使用 PancakeSwap V2 Router
-            const router = new Contract(MONAD_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, MONAD_WMON]);
-            return amounts[1];
-        }
-        // ✅ Base (8453) / XLayer (196) 等链暂不支持 V2 报价，返回 0
-        return 0n;
-    }
-    catch {
-        // 报价失败返回 0（可能是流动性不足或路径不存在）
-        return 0n;
-    }
-}
-/**
- * 获取 Gas Limit（支持 FlapAnyConfig）
- */
-export 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 签名数 */
-export const MAX_BUNDLE_SIGNATURES = 50;
-/** 贿赂交易数 */
-export const BRIBE_TX_COUNT = 1;
-/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
-export const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
-/** 最大买卖交易数 */
-export const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
-/**
- * 根据 userType 获取每笔交易的利润率
- */
-export function getProfitRatePerTxBps(userType) {
-    if (userType === 'v1') {
-        return getProfitRateBps('v1Double');
-    }
-    return getProfitRateBps('v0Double'); // v0 或默认
-}
-/**
- * 验证买卖笔数
- */
-export 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 function getChainId(chain) {
-    switch (chain) {
-        case 'bsc':
-            return 56;
-        case 'xlayer':
-            return 196;
-        case 'base':
-            return 8453;
-    }
-}
-export function getNativeTokenName(chain) {
-    switch (chain) {
-        case 'bsc':
-            return 'BNB';
-        case 'xlayer':
-            return 'OKB';
-        case 'base':
-            return 'ETH';
-    }
-}
-// 使用公共工具的 getGasLimit，移除本地重复实现
+ *
+ * 拆分说明：类型/常量/链上下文/报价/规划/利润/多钱包 已拆到同名子文件，
+ * 本文件作为 barrel 保持对外 export 符号/路径/签名不变。
+ */
+export * from './swap-buy-first-types.js';
+export * from './swap-buy-first-constants.js';
+export * from './swap-buy-first-chain.js';
+export * from './swap-buy-first-quote.js';
+export * from './swap-buy-first-plan.js';
+export * from './swap-buy-first-profit.js';
+export * from './swap-buy-first-multi-wallet.js';

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

@@ -0,0 +1,20 @@
+import type { FlapBuyFirstResult, FlapBuyFirstSignConfig, FlapChain } from './swap-buy-first-types.js';
+interface FlapMultiWalletParams {
+    chain: FlapChain;
+    buyerPrivateKeys: string[];
+    sellerPrivateKeys: string[];
+    tokenAddress: string;
+    buyerFunds?: string;
+    config: FlapBuyFirstSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+}
+/**
+ * ✅ Flap 多钱包捆绑换手
+ * - 多个买方钱包执行买入（每个钱包1笔）
+ * - 多个卖方钱包执行卖出（每个钱包1笔）
+ * - 买入总价值 = 卖出总价值
+ * - ✅ 优化：最大化并行操作
+ */
+export declare function flapBundleBuyFirstMultiWallet(params: FlapMultiWalletParams): Promise<FlapBuyFirstResult>;
+export {};

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

@@ -0,0 +1,223 @@
+/**
+ * Flap BuyFirst 多钱包捆绑换手（从 swap-buy-first-helpers.ts 抽取）
+ */
+import { ethers, Contract, Wallet } from 'ethers';
+import { getGasLimit } from '../../../core/gas/bundle-gas.js';
+import { NonceManager, getOptimizedGasPrice } from '../../../utils/bundle-helpers.js';
+import { ZERO_ADDRESS, GAS_LIMITS } from '../../../core/constants/index.js';
+import { ERC20_BALANCE_ABI } from '../../../core/shared-abis/common.js';
+import { BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI, getBribeAmount, getGasPriceConfig, getTxType, } from './config.js';
+import { buildTransactionRequest } from '../../../core/tx/build-request.js';
+import { splitAmountByWeight as splitAmount } from '../../../core/amount/split-by-weight.js';
+import { createChainContext } from './swap-buy-first-chain.js';
+import { quoteBuyerOutput, estimateSellFunds, getTokenToNativeQuote } from './swap-buy-first-quote.js';
+import { getProfitRatePerTxBps, validateSwapCounts } from './swap-buy-first-plan.js';
+import { buildProfitTransaction } from './swap-buy-first-profit.js';
+/**
+ * ✅ Flap 多钱包捆绑换手
+ * - 多个买方钱包执行买入（每个钱包1笔）
+ * - 多个卖方钱包执行卖出（每个钱包1笔）
+ * - 买入总价值 = 卖出总价值
+ * - ✅ 优化：最大化并行操作
+ */
+export async function flapBundleBuyFirstMultiWallet(params) {
+    const { chain, buyerPrivateKeys, sellerPrivateKeys, tokenAddress, buyerFunds, config, quoteToken, quoteTokenDecimals = 18, } = 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 chainContext = createChainContext(chain, config.rpcUrl);
+    const nonceManager = new NonceManager(chainContext.provider);
+    // 创建所有钱包实例
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, chainContext.provider));
+    const sellers = sellerPrivateKeys.map((pk) => new Wallet(pk, chainContext.provider));
+    // 使用第一个卖方作为主卖方（支付贿赂和利润）
+    const mainSeller = sellers[0];
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const inputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    const outputToken = inputToken;
+    // ✅ 计算总交易金额
+    if (!buyerFunds) {
+        throw new Error('多钱包模式必须提供 buyerFunds（总交易金额）');
+    }
+    const totalFundsWei = useNativeToken
+        ? ethers.parseEther(String(buyerFunds))
+        : ethers.parseUnits(String(buyerFunds), quoteTokenDecimals);
+    if (totalFundsWei <= 0n) {
+        throw new Error('交易金额必须大于0');
+    }
+    const finalGasLimit = getGasLimit(config, 800000);
+    const txType = getTxType(config);
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 第一批并行：报价 + Gas价格 + 代币精度 + 所有钱包 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 erc20 = new Contract(tokenAddress, ERC20_BALANCE_ABI, chainContext.provider);
+    const [quoteResult, gasPrice, decimals, noncesArray] = await Promise.all([
+        quoteBuyerOutput({
+            portalAddress: chainContext.portalAddress,
+            tokenAddress,
+            buyerFundsWei: totalFundsWei,
+            provider: chainContext.provider,
+            skipQuoteOnError: config.skipQuoteOnError,
+            inputToken,
+        }),
+        getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config)),
+        erc20.decimals(),
+        nonceManager.getNextNoncesForWallets(uniqueWallets),
+    ]);
+    // 构建 nonces Map
+    const noncesMap = new Map();
+    uniqueWallets.forEach((wallet, i) => {
+        noncesMap.set(wallet.address.toLowerCase(), noncesArray[i]);
+    });
+    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+    // ✅ 将总金额平均分配给买方
+    const buyAmountsWei = splitAmount(totalFundsWei, buyCount);
+    // ✅ 将代币平均分配给卖方
+    const sellAmountsWei = splitAmount(quoteResult.sellAmountWei, sellCount);
+    // ✅ 第二批并行：估算利润 + ERC20 转原生代币报价（如需要）
+    const portal = new Contract(chainContext.portalAddress, PORTAL_ABI, chainContext.provider);
+    const estimatedSellFunds = await estimateSellFunds(portal, tokenAddress, quoteResult.sellAmountWei, outputToken);
+    const profitBase = estimatedSellFunds > 0n ? estimatedSellFunds : totalFundsWei;
+    const tokenProfitAmount = (profitBase * BigInt(profitRateBps)) / 10000n;
+    // ERC20 购买：获取代币利润等值的原生代币报价
+    let nativeProfitAmount = tokenProfitAmount;
+    if (!useNativeToken && tokenProfitAmount > 0n) {
+        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, inputToken, tokenProfitAmount, chainContext.chainId);
+    }
+    // ✅ 第三批并行：构建并签名所有交易
+    const allTransactions = [];
+    // 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: GAS_LIMITS.BRIBE,
+            chainId: chainContext.chainId,
+            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 portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);
+        const unsigned = await portalBuyer.swapExactInput.populateTransaction({
+            inputToken,
+            outputToken: tokenAddress,
+            inputAmount: buyAmountsWei[i],
+            minOutputAmount: 0n,
+            permitData: '0x',
+        }, useNativeToken ? { value: buyAmountsWei[i] } : {});
+        return buyer.signTransaction(buildTransactionRequest(unsigned, {
+            from: buyer.address,
+            nonce: buyerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            priorityFee,
+            chainId: chainContext.chainId,
+            txType,
+            value: useNativeToken ? buyAmountsWei[i] : 0n,
+        }));
+    });
+    // 4. 并行构建所有卖出交易
+    const sellTxPromises = sellers.map(async (seller, i) => {
+        const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
+        const unsigned = await portalSeller.swapExactInput.populateTransaction({
+            inputToken: tokenAddress,
+            outputToken,
+            inputAmount: sellAmountsWei[i],
+            minOutputAmount: 0n,
+            permitData: '0x',
+        });
+        return seller.signTransaction(buildTransactionRequest(unsigned, {
+            from: seller.address,
+            nonce: sellerNonces[i],
+            gasLimit: finalGasLimit,
+            gasPrice,
+            priorityFee,
+            chainId: chainContext.chainId,
+            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 (nativeProfitAmount > 0n) {
+        const mainSellerAddr = mainSeller.address.toLowerCase();
+        const profitNonce = noncesMap.get(mainSellerAddr);
+        const profitResult = await buildProfitTransaction({
+            provider: chainContext.provider,
+            seller: mainSeller,
+            profitAmount: nativeProfitAmount,
+            profitNonce,
+            gasPrice,
+            chainId: chainContext.chainId,
+            txType,
+        });
+        if (profitResult) {
+            allTransactions.push(...profitResult.signedTransactions);
+            profitHopWallets = profitResult.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(quoteResult.sellAmountWei, decimals),
+            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined,
+            buyCount,
+            sellCount,
+            buyAmounts: buyAmountsWei.map((amt) => ethers.formatEther(amt)),
+            sellAmounts: sellAmountsWei.map((amt) => ethers.formatUnits(amt, decimals)),
+        },
+    };
+}

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

@@ -0,0 +1,32 @@
+/**
+ * Flap BuyFirst nonce 规划与笔数校验（从 swap-buy-first-helpers.ts 抽取）
+ */
+import type { Wallet } from 'ethers';
+import type { NonceManager } from '../../../utils/bundle-helpers.js';
+import type { MultiNoncePlan, UserType } from './swap-buy-first-types.js';
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+export declare function getProfitRatePerTxBps(userType?: UserType): number;
+/**
+ * 验证买卖笔数
+ */
+export declare function validateSwapCounts(buyCount: number, sellCount: number): void;
+type PlanMultiNonceParams = {
+    buyer: Wallet;
+    seller: Wallet;
+    buyCount: number;
+    sellCount: number;
+    extractProfit: boolean;
+    needBribeTx: boolean;
+    sameAddress: boolean;
+    nonceManager: NonceManager;
+};
+/**
+ * ✅ 规划多笔交易 nonce
+ * 交易顺序：贿赂 → 买入(多笔) → 卖出(多笔) → 利润
+ *
+ * 利润中转需要 PROFIT_HOP_COUNT + 1 个 nonce（支付者→跳1→跳2→利润地址）
+ */
+export declare function planMultiNonces({ buyer, seller, buyCount, sellCount, extractProfit, needBribeTx, sameAddress, nonceManager, }: PlanMultiNonceParams): Promise<MultiNoncePlan>;
+export {};

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

@@ -0,0 +1,66 @@
+import { getProfitRateBps } from '../../../core/constants/index.js';
+import { BRIBE_TX_COUNT, MAX_BUNDLE_SIGNATURES, MAX_SWAP_TX_COUNT, PROFIT_TX_COUNT, } from './swap-buy-first-constants.js';
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+export function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return getProfitRateBps('v1Double');
+    }
+    return getProfitRateBps('v0Double'); // v0 或默认
+}
+/**
+ * 验证买卖笔数
+ */
+export 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} 买卖）`);
+    }
+}
+/**
+ * ✅ 规划多笔交易 nonce
+ * 交易顺序：贿赂 → 买入(多笔) → 卖出(多笔) → 利润
+ *
+ * 利润中转需要 PROFIT_HOP_COUNT + 1 个 nonce（支付者→跳1→跳2→利润地址）
+ */
+export async function planMultiNonces({ buyer, seller, buyCount, sellCount, extractProfit, needBribeTx, sameAddress, nonceManager, }) {
+    // 利润中转交易数（支付者只需要 1 个 nonce，中转钱包的 nonce 由 buildProfitHopTransactions 内部处理）
+    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 };
+}

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

@@ -0,0 +1,22 @@
+/**
+ * Flap BuyFirst 利润多跳转账 helper（从 swap-buy-first-helpers.ts 抽取）
+ */
+import type { ethers, Wallet } from 'ethers';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+type ProfitTxParams = {
+    provider: ethers.JsonRpcProvider;
+    seller: Wallet;
+    profitAmount: bigint;
+    profitNonce?: number;
+    gasPrice: bigint;
+    chainId: number;
+    txType: number;
+};
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+export declare function buildProfitTransaction({ provider, seller, profitAmount, profitNonce, gasPrice, chainId, txType, }: ProfitTxParams): Promise<{
+    signedTransactions: string[];
+    hopWallets?: GeneratedWallet[];
+} | null>;
+export {};

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

@@ -0,0 +1,22 @@
+import { buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
+import { getProfitRecipient } from './config.js';
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+export async function buildProfitTransaction({ provider, seller, profitAmount, profitNonce, gasPrice, chainId, txType, }) {
+    if (profitNonce === undefined || profitAmount === 0n) {
+        return null;
+    }
+    const profitHopResult = await buildProfitHopTransactions({
+        provider,
+        payerWallet: seller,
+        profitAmount,
+        profitRecipient: getProfitRecipient(),
+        hopCount: PROFIT_HOP_COUNT,
+        gasPrice,
+        chainId,
+        txType,
+        startNonce: profitNonce,
+    });
+    return { signedTransactions: profitHopResult.signedTransactions, hopWallets: profitHopResult.hopWallets };
+}