four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/private/buy.d.ts

@@ -0,0 +1,9 @@
+import type { FlapPrivateBuyMerkleParams, FlapPrivateTransactionResult, FlapBatchPrivateBuyMerkleParams, FlapBatchPrivateMerkleResult } from '../types.js';
+/**
+ * 私有购买（单笔）（Merkle 版本）
+ */
+export declare function flapPrivateBuyMerkle(params: FlapPrivateBuyMerkleParams): Promise<FlapPrivateTransactionResult>;
+/**
+ * 批量私有购买（Merkle 版本）
+ */
+export declare function flapBatchPrivateBuyMerkle(params: FlapBatchPrivateBuyMerkleParams): Promise<FlapBatchPrivateMerkleResult>;

package/dist/domains/flap/portal-bundle-merkle/private/buy.js

@@ -0,0 +1,188 @@
+import { ethers, Wallet } from 'ethers';
+import { getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../../utils/bundle-helpers.js';
+import { FLAP_PORTAL_ADDRESSES } from '../../constants.js';
+import { ZERO_ADDRESS } from '../../../../core/constants/index.js';
+import { GAS_LIMITS } from '../../../../core/constants/index.js';
+import { PORTAL_ABI, getTxType, getGasPriceConfig, shouldExtractProfit, calculateBatchProfit, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, } from '../config.js';
+import { createMerkleContext, splitBuyAmount, parseMinOutput, resolveGasLimit, resolveBatchMinOutputs, findMaxIndex, signBatchTransactions, } from './helpers.js';
+/**
+ * 私有购买（单笔）（Merkle 版本）
+ */
+export async function flapPrivateBuyMerkle(params) {
+    const { chain, privateKey, tokenAddress, amountIn, minOutputAmount, config } = params;
+    const { chainId, provider } = createMerkleContext(chain, config);
+    const wallet = new Wallet(privateKey, provider);
+    const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
+    const originalAmountWei = ethers.parseEther(amountIn);
+    // ✅ 利润提取配置
+    const extractProfit = shouldExtractProfit();
+    const { actualAmountWei, profitWei } = splitBuyAmount(originalAmountWei, extractProfit);
+    const minAmountOut = parseMinOutput(minOutputAmount);
+    const portal = new ethers.Contract(portalAddr, PORTAL_ABI, wallet);
+    // ✅ 并行获取 gasPrice、nonce 和构建未签名交易
+    const [gasPrice, currentNonce, unsigned] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        // ✅ 使用 pending nonce，避免 xLayer 等链上“已有 pending 交易”导致 nonce too low
+        provider.getTransactionCount(wallet.address, 'pending'),
+        portal.swapExactInput.populateTransaction({
+            inputToken: ZERO_ADDRESS,
+            outputToken: tokenAddress,
+            inputAmount: actualAmountWei,
+            minOutputAmount: minAmountOut,
+            permitData: '0x',
+        }, { value: actualAmountWei }),
+    ]);
+    const gasLimit = resolveGasLimit(config.gasLimitMultiplier);
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    const needProfitTx = extractProfit && profitWei > 0n;
+    // ✅ 分配 nonces：贿赂 → 买入 → 利润
+    let nonceIdx = 0;
+    const bribeNonce = needBribeTx ? currentNonce + nonceIdx++ : undefined;
+    const buyNonce = currentNonce + nonceIdx++;
+    const profitNonce = needProfitTx ? currentNonce + nonceIdx : undefined;
+    // ✅ 并行签名所有交易（贿赂、买入、利润）
+    const signPromises = [];
+    const txType = getTxType(config);
+    // 贿赂交易
+    if (needBribeTx && bribeNonce !== undefined) {
+        signPromises.push(wallet.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: GAS_LIMITS.BRIBE,
+            chainId,
+            type: txType,
+        }));
+    }
+    // 买入交易
+    signPromises.push(wallet.signTransaction({
+        ...unsigned,
+        from: wallet.address,
+        nonce: buyNonce,
+        gasLimit,
+        gasPrice,
+        chainId,
+        type: txType,
+        value: actualAmountWei,
+    }));
+    // ✅ 并行签名完成后按顺序返回
+    const signedTxs = await Promise.all(signPromises);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (needProfitTx && profitNonce !== undefined) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: wallet,
+            profitAmount: profitWei,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType,
+            startNonce: profitNonce,
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return { signedTransactions: signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
+}
+/**
+ * 批量私有购买（Merkle 版本）
+ */
+export async function flapBatchPrivateBuyMerkle(params) {
+    const { chain, privateKeys, amountsIn, tokenAddress, minOutputAmounts, config } = params;
+    if (privateKeys.length !== amountsIn.length) {
+        throw new Error('privateKeys and amountsIn length mismatch');
+    }
+    const { chainId, provider } = createMerkleContext(chain, config);
+    const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
+    const wallets = privateKeys.map((k) => new Wallet(k, provider));
+    const originalAmountsWei = amountsIn.map((a) => ethers.parseEther(a));
+    // ✅ 利润提取配置
+    const extractProfit = shouldExtractProfit();
+    const { totalProfit, remainingAmounts } = calculateBatchProfit(originalAmountsWei);
+    const actualAmountsWei = remainingAmounts;
+    const maxFundsIndex = findMaxIndex(originalAmountsWei);
+    const minOuts = resolveBatchMinOutputs(minOutputAmounts, wallets.length);
+    const portals = wallets.map((w) => new ethers.Contract(portalAddr, PORTAL_ABI, w));
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    const needProfitTx = extractProfit && totalProfit > 0n;
+    // ✅ 并行获取 gasPrice、所有 nonces 和构建未签名交易
+    const [gasPrice, initialNonces, unsignedList] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        // ✅ 使用 pending nonce，避免 xLayer 等链上“已有 pending 交易”导致 nonce too low
+        Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending'))),
+        Promise.all(portals.map((portal, i) => portal.swapExactInput.populateTransaction({
+            inputToken: ZERO_ADDRESS,
+            outputToken: tokenAddress,
+            inputAmount: actualAmountsWei[i],
+            minOutputAmount: minOuts[i],
+            permitData: '0x',
+        }, { value: actualAmountsWei[i] }))),
+    ]);
+    // ✅ 分配 nonces：贿赂(可选) → 买入 → 利润(可选)
+    let payerNonceOffset = 0;
+    let bribeNonce;
+    if (needBribeTx && maxFundsIndex >= 0) {
+        bribeNonce = initialNonces[maxFundsIndex];
+        payerNonceOffset++;
+    }
+    const nonces = initialNonces.map((n, i) => {
+        if (i === maxFundsIndex) {
+            return n + payerNonceOffset; // payer 的买入 nonce 需要偏移
+        }
+        return n;
+    });
+    const profitNonce = needProfitTx && maxFundsIndex >= 0 ? initialNonces[maxFundsIndex] + payerNonceOffset + 1 : undefined;
+    const gasLimit = resolveGasLimit(config.gasLimitMultiplier);
+    const gasLimits = new Array(wallets.length).fill(gasLimit);
+    const signedTxs = [];
+    // ✅ 贿赂交易放在首位
+    if (needBribeTx && bribeNonce !== undefined && maxFundsIndex >= 0) {
+        const bribeTx = await wallets[maxFundsIndex].signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: GAS_LIMITS.BRIBE,
+            chainId,
+            type: getTxType(config),
+        });
+        signedTxs.push(bribeTx);
+    }
+    // ✅ 并行签名所有买入交易
+    const signedList = await signBatchTransactions({
+        unsignedList,
+        wallets,
+        nonces,
+        gasLimits,
+        gasPrice,
+        chainId,
+        config,
+        values: actualAmountsWei,
+    });
+    signedTxs.push(...signedList);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (needProfitTx && profitNonce !== undefined && maxFundsIndex >= 0) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: wallets[maxFundsIndex],
+            profitAmount: totalProfit,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType: getTxType(config),
+            startNonce: profitNonce,
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return { signedTransactions: signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
+}

package/dist/domains/flap/portal-bundle-merkle/private/helpers.d.ts

@@ -0,0 +1,36 @@
+import { ethers, Wallet } from 'ethers';
+import type { FlapPrivateBuyMerkleParams } from '../types.js';
+type FlapChain = FlapPrivateBuyMerkleParams['chain'];
+type FlapConfig = FlapPrivateBuyMerkleParams['config'];
+export declare function createMerkleContext(chain: FlapChain, config: FlapConfig): {
+    chainId: number;
+    provider: ethers.JsonRpcProvider;
+};
+export declare function splitBuyAmount(amount: bigint, extractProfit: boolean): {
+    actualAmountWei: bigint;
+    profitWei: bigint;
+};
+export declare function parseMinOutput(value?: string | bigint): bigint;
+export declare function resolveGasLimit(multiplier?: number, defaultGas?: number): bigint;
+export declare function resolveSingleSellOutputs(portal: ethers.Contract, tokenAddress: string, amountWei: bigint, minOutputAmount?: string | bigint): Promise<{
+    quotedOutput: any;
+    minOut: bigint;
+}>;
+export declare function resolveBatchMinOutputs(minOutputAmounts: (string | bigint)[] | undefined, walletCount: number): any[];
+export declare function findMaxIndex(values: bigint[]): number;
+type SignBatchParams = {
+    unsignedList: ethers.TransactionLike[];
+    wallets: Wallet[];
+    nonces: number[];
+    gasLimits: bigint[];
+    gasPrice: bigint;
+    chainId: number;
+    config: FlapConfig;
+    values?: bigint[];
+};
+export declare function signBatchTransactions({ unsignedList, wallets, nonces, gasLimits, gasPrice, chainId, config, values, }: SignBatchParams): Promise<string[]>;
+export declare function summarizeSellProfits(quotedOutputs: bigint[], extractProfit: boolean): {
+    totalProfit: bigint;
+    maxRevenueIndex: number;
+};
+export {};

package/dist/domains/flap/portal-bundle-merkle/private/helpers.js

@@ -0,0 +1,127 @@
+import { ethers, JsonRpcProvider } from 'ethers';
+import { MerkleClient } from '../../../../core/clients/merkle.js';
+import { ZERO_ADDRESS, CHAINS } from '../../../../core/constants/index.js';
+import { CHAIN_ID_MAP, getTxType, calculateProfit, } from '../config.js';
+const DEFAULT_GAS_LIMIT = 800000;
+export function createMerkleContext(chain, config) {
+    const chainId = CHAIN_ID_MAP[chain];
+    // ✅ 检查是否为 Merkle 支持的链（BSC, ETH）
+    // Monad 不支持 Merkle 捆绑服务，使用普通 RPC
+    if (chainId !== CHAINS.BSC.chainId && chainId !== CHAINS.ETHEREUM.chainId) {
+        // 对于不支持 Merkle 的链（如 Monad），必须提供自定义 RPC
+        if (!config.customRpcUrl) {
+            throw new Error(`Chain ${chain} (chainId: ${chainId}) does not support Merkle bundle service. Please provide customRpcUrl.`);
+        }
+        return {
+            chainId,
+            // ✅ 禁用 ENS: 避免 "network does not support ENS" 错误
+            provider: new JsonRpcProvider(config.customRpcUrl, { chainId, name: chain.toLowerCase(), ensAddress: undefined }),
+        };
+    }
+    const merkle = new MerkleClient({
+        apiKey: config.apiKey,
+        chainId: chainId, // 类型断言为 Merkle 支持的 chainId
+        customRpcUrl: config.customRpcUrl,
+    });
+    return {
+        chainId,
+        provider: merkle.getProvider(),
+    };
+}
+export function splitBuyAmount(amount, extractProfit) {
+    if (!extractProfit) {
+        return { actualAmountWei: amount, profitWei: 0n };
+    }
+    const { remaining, profit } = calculateProfit(amount);
+    return { actualAmountWei: remaining, profitWei: profit };
+}
+export function parseMinOutput(value) {
+    if (value === undefined) {
+        return 0n;
+    }
+    return typeof value === 'string' ? ethers.parseUnits(value, 18) : value;
+}
+export function resolveGasLimit(multiplier, defaultGas = DEFAULT_GAS_LIMIT) {
+    const factor = multiplier ?? 1.0;
+    return BigInt(Math.ceil(defaultGas * factor));
+}
+export async function resolveSingleSellOutputs(portal, tokenAddress, amountWei, minOutputAmount) {
+    if (minOutputAmount !== undefined) {
+        const minOut = typeof minOutputAmount === 'string' ? ethers.parseEther(minOutputAmount) : minOutputAmount;
+        return {
+            quotedOutput: minOut,
+            minOut,
+        };
+    }
+    try {
+        const quotedOutput = await portal.quoteExactInput.staticCall({
+            inputToken: tokenAddress,
+            outputToken: ZERO_ADDRESS,
+            inputAmount: amountWei,
+        });
+        return {
+            quotedOutput,
+            minOut: 0n, // ✅ 已移除滑点保护：minOut 固定为 0
+        };
+    }
+    catch {
+        return {
+            quotedOutput: 0n,
+            minOut: 0n,
+        };
+    }
+}
+export function resolveBatchMinOutputs(minOutputAmounts, walletCount) {
+    if (minOutputAmounts && minOutputAmounts.length === walletCount) {
+        return minOutputAmounts.map((m) => (typeof m === 'string' ? ethers.parseUnits(m, 18) : m));
+    }
+    return new Array(walletCount).fill(0n);
+}
+export function findMaxIndex(values) {
+    if (values.length === 0) {
+        return -1;
+    }
+    let maxIndex = 0;
+    let maxValue = values[0];
+    for (let i = 1; i < values.length; i++) {
+        if (values[i] > maxValue) {
+            maxValue = values[i];
+            maxIndex = i;
+        }
+    }
+    return maxIndex;
+}
+export async function signBatchTransactions({ unsignedList, wallets, nonces, gasLimits, gasPrice, chainId, config, values, }) {
+    return await Promise.all(unsignedList.map((unsigned, i) => {
+        const value = values ? values[i] : (unsigned.value ?? 0n);
+        return wallets[i].signTransaction({
+            ...unsigned,
+            from: wallets[i].address,
+            nonce: nonces[i],
+            gasLimit: gasLimits[i],
+            gasPrice,
+            chainId,
+            type: getTxType(config),
+            value,
+        });
+    }));
+}
+export function summarizeSellProfits(quotedOutputs, extractProfit) {
+    let totalProfit = 0n;
+    let maxRevenueIndex = -1;
+    let maxRevenue = 0n;
+    if (extractProfit) {
+        for (let i = 0; i < quotedOutputs.length; i++) {
+            const quoted = quotedOutputs[i];
+            if (quoted > 0n) {
+                const { profit } = calculateProfit(quoted);
+                totalProfit += profit;
+                if (quoted > maxRevenue) {
+                    maxRevenue = quoted;
+                    maxRevenueIndex = i;
+                }
+            }
+        }
+    }
+    return { totalProfit, maxRevenueIndex: maxRevenueIndex < 0 ? 0 : maxRevenueIndex };
+}

package/dist/domains/flap/portal-bundle-merkle/private/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 私有交易（Merkle 版本）barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - helpers.ts：Merkle 上下文 / 金额解析 / nonce 分配 / 批量签名 / 利润汇总
+ * - buy.ts：flapPrivateBuyMerkle / flapBatchPrivateBuyMerkle
+ * - sell.ts：flapPrivateSellMerkle / flapBatchPrivateSellMerkle
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { flapPrivateBuyMerkle, flapBatchPrivateBuyMerkle } from './buy.js';
+export { flapPrivateSellMerkle, flapBatchPrivateSellMerkle } from './sell.js';

package/dist/domains/flap/portal-bundle-merkle/private/index.js

@@ -0,0 +1,12 @@
+/**
+ * 私有交易（Merkle 版本）barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - helpers.ts：Merkle 上下文 / 金额解析 / nonce 分配 / 批量签名 / 利润汇总
+ * - buy.ts：flapPrivateBuyMerkle / flapBatchPrivateBuyMerkle
+ * - sell.ts：flapPrivateSellMerkle / flapBatchPrivateSellMerkle
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { flapPrivateBuyMerkle, flapBatchPrivateBuyMerkle } from './buy.js';
+export { flapPrivateSellMerkle, flapBatchPrivateSellMerkle } from './sell.js';

package/dist/domains/flap/portal-bundle-merkle/private/sell.d.ts

@@ -0,0 +1,9 @@
+import type { FlapPrivateSellMerkleParams, FlapPrivateTransactionResult, FlapBatchPrivateSellMerkleParams, FlapBatchPrivateMerkleResult } from '../types.js';
+/**
+ * 私有卖出（单笔）（Merkle 版本）
+ */
+export declare function flapPrivateSellMerkle(params: FlapPrivateSellMerkleParams): Promise<FlapPrivateTransactionResult>;
+/**
+ * 批量私有卖出（Merkle 版本）
+ */
+export declare function flapBatchPrivateSellMerkle(params: FlapBatchPrivateSellMerkleParams): Promise<FlapBatchPrivateMerkleResult>;

package/dist/domains/flap/portal-bundle-merkle/private/sell.js

@@ -0,0 +1,191 @@
+import { ethers, Wallet } from 'ethers';
+import { getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../../utils/bundle-helpers.js';
+import { FLAP_PORTAL_ADDRESSES } from '../../constants.js';
+import { ZERO_ADDRESS } from '../../../../core/constants/index.js';
+import { GAS_LIMITS } from '../../../../core/constants/index.js';
+import { PORTAL_ABI, getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, } from '../config.js';
+import { createMerkleContext, resolveGasLimit, resolveSingleSellOutputs, signBatchTransactions, summarizeSellProfits, } from './helpers.js';
+/**
+ * 私有卖出（单笔）（Merkle 版本）
+ */
+export async function flapPrivateSellMerkle(params) {
+    const { chain, privateKey, tokenAddress, amount, minOutputAmount, config } = params;
+    const { chainId, provider } = createMerkleContext(chain, config);
+    const wallet = new Wallet(privateKey, provider);
+    const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
+    const amountWei = ethers.parseUnits(amount, 18);
+    const portal = new ethers.Contract(portalAddr, PORTAL_ABI, wallet);
+    // ✅ 并行获取 gasPrice、nonce、报价和构建未签名交易
+    const [gasPrice, currentNonce, { quotedOutput }, unsigned] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        // ✅ 使用 pending nonce，避免 xLayer 等链上“已有 pending 交易”导致 nonce too low
+        provider.getTransactionCount(wallet.address, 'pending'),
+        resolveSingleSellOutputs(portal, tokenAddress, amountWei, minOutputAmount),
+        portal.swapExactInput.populateTransaction({
+            inputToken: tokenAddress,
+            outputToken: ZERO_ADDRESS,
+            inputAmount: amountWei,
+            minOutputAmount: 0n, // ✅ 已移除滑点保护
+            permitData: '0x',
+        }),
+    ]);
+    const gasLimit = resolveGasLimit(config.gasLimitMultiplier);
+    const txType = getTxType(config);
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 利润计算
+    const extractProfit = shouldExtractProfit();
+    const { profit: profitWei } = extractProfit && quotedOutput > 0n ? calculateProfit(quotedOutput) : { profit: 0n };
+    const needProfitTx = extractProfit && profitWei > 0n;
+    // ✅ 分配 nonces：贿赂 → 卖出 → 利润
+    let nonceIdx = 0;
+    const bribeNonce = needBribeTx ? currentNonce + nonceIdx++ : undefined;
+    const sellNonce = currentNonce + nonceIdx++;
+    const profitNonce = needProfitTx ? currentNonce + nonceIdx : undefined;
+    // ✅ 并行签名所有交易（贿赂、卖出、利润）
+    const signPromises = [];
+    // 贿赂交易
+    if (needBribeTx && bribeNonce !== undefined) {
+        signPromises.push(wallet.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: GAS_LIMITS.BRIBE,
+            chainId,
+            type: txType,
+        }));
+    }
+    // 卖出交易
+    signPromises.push(wallet.signTransaction({
+        ...unsigned,
+        from: wallet.address,
+        nonce: sellNonce,
+        gasLimit,
+        gasPrice,
+        chainId,
+        type: txType,
+    }));
+    // ✅ 并行签名完成后按顺序返回
+    const signedTxs = await Promise.all(signPromises);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (needProfitTx && profitNonce !== undefined) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: wallet,
+            profitAmount: profitWei,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType,
+            startNonce: profitNonce,
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return { signedTransactions: signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
+}
+/**
+ * 批量私有卖出（Merkle 版本）
+ */
+export async function flapBatchPrivateSellMerkle(params) {
+    const { chain, privateKeys, amounts, tokenAddress, config } = params;
+    if (privateKeys.length !== amounts.length) {
+        throw new Error('privateKeys and amounts length mismatch');
+    }
+    const { chainId, provider } = createMerkleContext(chain, config);
+    const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
+    const wallets = privateKeys.map((k) => new Wallet(k, provider));
+    const amountsWei = amounts.map((a) => ethers.parseUnits(a, 18));
+    const portal = new ethers.Contract(portalAddr, PORTAL_ABI, provider);
+    const portals = wallets.map((w) => new ethers.Contract(portalAddr, PORTAL_ABI, w));
+    // ✅ 并行获取 gasPrice、所有 nonces、所有报价和构建未签名交易
+    const [gasPrice, initialNonces, quotedOutputs, unsignedList] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        // ✅ 使用 pending nonce，避免 xLayer 等链上“已有 pending 交易”导致 nonce too low
+        Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending'))),
+        Promise.all(amountsWei.map((amount) => portal.quoteExactInput
+            .staticCall({
+            inputToken: tokenAddress,
+            outputToken: ZERO_ADDRESS,
+            inputAmount: amount,
+        })
+            .catch(() => 0n))),
+        // ✅ 并行构建未签名交易（已移除滑点保护：minOuts 固定为 0）
+        Promise.all(portals.map((p, i) => p.swapExactInput.populateTransaction({
+            inputToken: tokenAddress,
+            outputToken: ZERO_ADDRESS,
+            inputAmount: amountsWei[i],
+            minOutputAmount: 0n,
+            permitData: '0x',
+        }))),
+    ]);
+    const extractProfit = shouldExtractProfit();
+    const { totalProfit, maxRevenueIndex } = summarizeSellProfits(quotedOutputs, extractProfit);
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    const needProfitTx = extractProfit && totalProfit > 0n;
+    // ✅ 分配 nonces：贿赂(可选) → 卖出 → 利润(可选)
+    let payerNonceOffset = 0;
+    let bribeNonce;
+    if (needBribeTx && maxRevenueIndex >= 0) {
+        bribeNonce = initialNonces[maxRevenueIndex];
+        payerNonceOffset++;
+    }
+    const nonces = initialNonces.map((n, i) => {
+        if (i === maxRevenueIndex) {
+            return n + payerNonceOffset; // payer 的卖出 nonce 需要偏移
+        }
+        return n;
+    });
+    const profitNonce = needProfitTx && maxRevenueIndex >= 0 ? initialNonces[maxRevenueIndex] + payerNonceOffset + 1 : undefined;
+    const gasLimit = resolveGasLimit(config.gasLimitMultiplier);
+    const gasLimits = new Array(wallets.length).fill(gasLimit);
+    const signedTxs = [];
+    // ✅ 贿赂交易放在首位
+    if (needBribeTx && bribeNonce !== undefined && maxRevenueIndex >= 0) {
+        const bribeTx = await wallets[maxRevenueIndex].signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: bribeNonce,
+            gasPrice,
+            gasLimit: GAS_LIMITS.BRIBE,
+            chainId,
+            type: getTxType(config),
+        });
+        signedTxs.push(bribeTx);
+    }
+    // ✅ 并行签名所有卖出交易
+    const signedList = await signBatchTransactions({
+        unsignedList,
+        wallets,
+        nonces,
+        gasLimits,
+        gasPrice,
+        chainId,
+        config,
+    });
+    signedTxs.push(...signedList);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    let profitHopWallets;
+    if (needProfitTx && profitNonce !== undefined && maxRevenueIndex >= 0) {
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: wallets[maxRevenueIndex],
+            profitAmount: totalProfit,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId,
+            txType: getTxType(config),
+            startNonce: profitNonce,
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
+    }
+    return { signedTransactions: signedTxs, profitHopWallets }; // ✅ 返回利润多跳钱包
+}

package/dist/domains/flap/portal-bundle-merkle/private.d.ts

@@ -1,17 +1,7 @@
-import { FlapPrivateBuyMerkleParams, FlapPrivateSellMerkleParams, FlapPrivateTransactionResult, FlapBatchPrivateBuyMerkleParams, FlapBatchPrivateSellMerkleParams, FlapBatchPrivateMerkleResult } from './types.js';
 /**
- * 私有购买（单笔）（Merkle 版本）
+ * 私有交易（Merkle 版本）
+ *
+ * 原超长文件按职责拆分为 private/ 目录下的多个子文件，
+ * 对外 export 符号与路径保持不变（见 private/index.ts）。
  */
-export declare function flapPrivateBuyMerkle(params: FlapPrivateBuyMerkleParams): Promise<FlapPrivateTransactionResult>;
-/**
- * 私有卖出（单笔）（Merkle 版本）
- */
-export declare function flapPrivateSellMerkle(params: FlapPrivateSellMerkleParams): Promise<FlapPrivateTransactionResult>;
-/**
- * 批量私有购买（Merkle 版本）
- */
-export declare function flapBatchPrivateBuyMerkle(params: FlapBatchPrivateBuyMerkleParams): Promise<FlapBatchPrivateMerkleResult>;
-/**
- * 批量私有卖出（Merkle 版本）
- */
-export declare function flapBatchPrivateSellMerkle(params: FlapBatchPrivateSellMerkleParams): Promise<FlapBatchPrivateMerkleResult>;
+export * from './private/index.js';