four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/shared/flap/portal-bundle-merkle/private.js

@@ -1,10 +1,10 @@
-import { ethers, Wallet } from 'ethers';
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
 import { MerkleClient } from '../../clients/merkle.js';
 import { getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
 import { FLAP_PORTAL_ADDRESSES } from '../constants.js';
-import { ZERO_ADDRESS } from '../../../utils/constants.js';
+import { ZERO_ADDRESS } from '../../../shared/constants/index.js';
 import { GAS_LIMITS, CHAINS } from '../../constants/index.js';
-import { CHAIN_ID_MAP, PORTAL_ABI, getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, calculateBatchProfit, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA } from './config.js';
+import { CHAIN_ID_MAP, PORTAL_ABI, getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, calculateBatchProfit, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, } from './config.js';
 const DEFAULT_GAS_LIMIT = 800000;
 /**
  * 私有购买（单笔）（Merkle 版本）
@@ -16,8 +16,8 @@ export async function flapPrivateBuyMerkle(params) {
     const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
     const originalAmountWei = ethers.parseEther(amountIn);
     // ✅ 利润提取配置
-    const extractProfit = shouldExtractProfit(config);
-    const { actualAmountWei, profitWei } = splitBuyAmount(originalAmountWei, extractProfit, config);
+    const extractProfit = shouldExtractProfit();
+    const { actualAmountWei, profitWei } = splitBuyAmount(originalAmountWei, extractProfit);
     const minAmountOut = parseMinOutput(minOutputAmount);
     const portal = new ethers.Contract(portalAddr, PORTAL_ABI, wallet);
     // ✅ 并行获取 gasPrice、nonce 和构建未签名交易
@@ -31,7 +31,7 @@ export async function flapPrivateBuyMerkle(params) {
             inputAmount: actualAmountWei,
             minOutputAmount: minAmountOut,
             permitData: '0x',
-        }, { value: actualAmountWei })
+        }, { value: actualAmountWei }),
     ]);
     const gasLimit = resolveGasLimit(config.gasLimitMultiplier);
     // ✅ 获取贿赂金额
@@ -55,7 +55,7 @@ export async function flapPrivateBuyMerkle(params) {
             gasPrice,
             gasLimit: GAS_LIMITS.BRIBE,
             chainId,
-            type: txType
+            type: txType,
         }));
     }
     // 买入交易
@@ -67,7 +67,7 @@ export async function flapPrivateBuyMerkle(params) {
         gasPrice,
         chainId,
         type: txType,
-        value: actualAmountWei
+        value: actualAmountWei,
     }));
     // ✅ 并行签名完成后按顺序返回
     const signedTxs = await Promise.all(signPromises);
@@ -83,7 +83,7 @@ export async function flapPrivateBuyMerkle(params) {
             gasPrice,
             chainId,
             txType,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTxs.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -112,7 +112,7 @@ export async function flapPrivateSellMerkle(params) {
             inputAmount: amountWei,
             minOutputAmount: 0n, // ✅ 已移除滑点保护
             permitData: '0x',
-        })
+        }),
     ]);
     const gasLimit = resolveGasLimit(config.gasLimitMultiplier);
     const txType = getTxType(config);
@@ -120,10 +120,8 @@ export async function flapPrivateSellMerkle(params) {
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
     // ✅ 利润计算
-    const extractProfit = shouldExtractProfit(config);
-    const { profit: profitWei } = extractProfit && quotedOutput > 0n
-        ? calculateProfit(quotedOutput, config)
-        : { profit: 0n };
+    const extractProfit = shouldExtractProfit();
+    const { profit: profitWei } = extractProfit && quotedOutput > 0n ? calculateProfit(quotedOutput) : { profit: 0n };
     const needProfitTx = extractProfit && profitWei > 0n;
     // ✅ 分配 nonces：贿赂 → 卖出 → 利润
     let nonceIdx = 0;
@@ -141,7 +139,7 @@ export async function flapPrivateSellMerkle(params) {
             gasPrice,
             gasLimit: GAS_LIMITS.BRIBE,
             chainId,
-            type: txType
+            type: txType,
         }));
     }
     // 卖出交易
@@ -152,7 +150,7 @@ export async function flapPrivateSellMerkle(params) {
         gasLimit,
         gasPrice,
         chainId,
-        type: txType
+        type: txType,
     }));
     // ✅ 并行签名完成后按顺序返回
     const signedTxs = await Promise.all(signPromises);
@@ -168,7 +166,7 @@ export async function flapPrivateSellMerkle(params) {
             gasPrice,
             chainId,
             txType,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTxs.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -185,15 +183,15 @@ export async function flapBatchPrivateBuyMerkle(params) {
     }
     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 wallets = privateKeys.map((k) => new Wallet(k, provider));
+    const originalAmountsWei = amountsIn.map((a) => ethers.parseEther(a));
     // ✅ 利润提取配置
-    const extractProfit = shouldExtractProfit(config);
-    const { totalProfit, remainingAmounts } = calculateBatchProfit(originalAmountsWei, config);
+    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 portals = wallets.map((w) => new ethers.Contract(portalAddr, PORTAL_ABI, w));
     // ✅ 获取贿赂金额
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
@@ -202,14 +200,14 @@ export async function flapBatchPrivateBuyMerkle(params) {
     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(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] })))
+        }, { value: actualAmountsWei[i] }))),
     ]);
     // ✅ 分配 nonces：贿赂(可选) → 买入 → 利润(可选)
     let payerNonceOffset = 0;
@@ -224,9 +222,7 @@ export async function flapBatchPrivateBuyMerkle(params) {
         }
         return n;
     });
-    const profitNonce = needProfitTx && maxFundsIndex >= 0
-        ? initialNonces[maxFundsIndex] + payerNonceOffset + 1
-        : undefined;
+    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 = [];
@@ -239,7 +235,7 @@ export async function flapBatchPrivateBuyMerkle(params) {
             gasPrice,
             gasLimit: GAS_LIMITS.BRIBE,
             chainId,
-            type: getTxType(config)
+            type: getTxType(config),
         });
         signedTxs.push(bribeTx);
     }
@@ -252,7 +248,7 @@ export async function flapBatchPrivateBuyMerkle(params) {
         gasPrice,
         chainId,
         config,
-        values: actualAmountsWei
+        values: actualAmountsWei,
     });
     signedTxs.push(...signedList);
     // ✅ 利润多跳转账（强制 2 跳中转）
@@ -267,7 +263,7 @@ export async function flapBatchPrivateBuyMerkle(params) {
             gasPrice,
             chainId,
             txType: getTxType(config),
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTxs.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -278,37 +274,39 @@ export async function flapBatchPrivateBuyMerkle(params) {
  * 批量私有卖出（Merkle 版本）
  */
 export async function flapBatchPrivateSellMerkle(params) {
-    const { chain, privateKeys, amounts, tokenAddress, minOutputAmounts, config } = 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 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));
+    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({
+        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))),
+            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'
-        })))
+            permitData: '0x',
+        }))),
     ]);
-    const extractProfit = shouldExtractProfit(config);
-    const { totalProfit, maxRevenueIndex } = summarizeSellProfits(quotedOutputs, extractProfit, config);
+    const extractProfit = shouldExtractProfit();
+    const { totalProfit, maxRevenueIndex } = summarizeSellProfits(quotedOutputs, extractProfit);
     // ✅ 获取贿赂金额
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
@@ -326,9 +324,7 @@ export async function flapBatchPrivateSellMerkle(params) {
         }
         return n;
     });
-    const profitNonce = needProfitTx && maxRevenueIndex >= 0
-        ? initialNonces[maxRevenueIndex] + payerNonceOffset + 1
-        : undefined;
+    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 = [];
@@ -341,7 +337,7 @@ export async function flapBatchPrivateSellMerkle(params) {
             gasPrice,
             gasLimit: GAS_LIMITS.BRIBE,
             chainId,
-            type: getTxType(config)
+            type: getTxType(config),
         });
         signedTxs.push(bribeTx);
     }
@@ -353,7 +349,7 @@ export async function flapBatchPrivateSellMerkle(params) {
         gasLimits,
         gasPrice,
         chainId,
-        config
+        config,
     });
     signedTxs.push(...signedList);
     // ✅ 利润多跳转账（强制 2 跳中转）
@@ -368,7 +364,7 @@ export async function flapBatchPrivateSellMerkle(params) {
             gasPrice,
             chainId,
             txType: getTxType(config),
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTxs.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -385,28 +381,27 @@ function createMerkleContext(chain, config) {
         if (!config.customRpcUrl) {
             throw new Error(`Chain ${chain} (chainId: ${chainId}) does not support Merkle bundle service. Please provide customRpcUrl.`);
         }
-        const { JsonRpcProvider } = require('ethers');
-        // ✅ 禁用 ENS: 避免 "network does not support ENS" 错误
         return {
             chainId,
-            provider: new JsonRpcProvider(config.customRpcUrl, { chainId, name: chain.toLowerCase(), ensAddress: undefined })
+            // ✅ 禁用 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
+        customRpcUrl: config.customRpcUrl,
     });
     return {
         chainId,
-        provider: merkle.getProvider()
+        provider: merkle.getProvider(),
     };
 }
-function splitBuyAmount(amount, extractProfit, config) {
+function splitBuyAmount(amount, extractProfit) {
     if (!extractProfit) {
         return { actualAmountWei: amount, profitWei: 0n };
     }
-    const { remaining, profit } = calculateProfit(amount, config);
+    const { remaining, profit } = calculateProfit(amount);
     return { actualAmountWei: remaining, profitWei: profit };
 }
 function parseMinOutput(value) {
@@ -419,83 +414,35 @@ function resolveGasLimit(multiplier, defaultGas = DEFAULT_GAS_LIMIT) {
     const factor = multiplier ?? 1.0;
     return BigInt(Math.ceil(defaultGas * factor));
 }
-/**
- * 追加利润多跳转账交易（强制 2 跳中转）
- */
-async function appendSingleProfitTransfer({ extractProfit, profitWei, wallet, baseNonce, provider, gasPrice, chainId, config, signedTxs }) {
-    if (!extractProfit || profitWei === 0n) {
-        return undefined;
-    }
-    const profitHopResult = await buildProfitHopTransactions({
-        provider,
-        payerWallet: wallet,
-        profitAmount: profitWei,
-        profitRecipient: getProfitRecipient(),
-        hopCount: PROFIT_HOP_COUNT,
-        gasPrice,
-        chainId,
-        txType: getTxType(config),
-        startNonce: baseNonce + 1
-    });
-    signedTxs.push(...profitHopResult.signedTransactions);
-    return profitHopResult.hopWallets; // ✅ 返回利润多跳钱包
-}
 async function resolveSingleSellOutputs(portal, tokenAddress, amountWei, minOutputAmount) {
     if (minOutputAmount !== undefined) {
-        const minOut = typeof minOutputAmount === 'string'
-            ? ethers.parseEther(minOutputAmount)
-            : minOutputAmount;
+        const minOut = typeof minOutputAmount === 'string' ? ethers.parseEther(minOutputAmount) : minOutputAmount;
         return {
             quotedOutput: minOut,
-            minOut
+            minOut,
         };
     }
     try {
         const quotedOutput = await portal.quoteExactInput.staticCall({
             inputToken: tokenAddress,
             outputToken: ZERO_ADDRESS,
-            inputAmount: amountWei
+            inputAmount: amountWei,
         });
         return {
             quotedOutput,
-            minOut: 0n // ✅ 已移除滑点保护：minOut 固定为 0
+            minOut: 0n, // ✅ 已移除滑点保护：minOut 固定为 0
         };
     }
     catch {
         return {
             quotedOutput: 0n,
-            minOut: 0n
+            minOut: 0n,
         };
     }
 }
-/**
- * 追加卖出利润多跳转账交易（强制 2 跳中转）
- */
-async function appendSingleSellProfitTransfer({ extractProfit, quotedOutput, wallet, baseNonce, provider, gasPrice, chainId, config, signedTxs }) {
-    if (!extractProfit || quotedOutput <= 0n) {
-        return undefined;
-    }
-    const { profit } = calculateProfit(quotedOutput, config);
-    if (profit === 0n) {
-        return undefined;
-    }
-    const profitHopResult = await buildProfitHopTransactions({
-        provider,
-        payerWallet: wallet,
-        profitAmount: profit,
-        profitRecipient: getProfitRecipient(),
-        hopCount: PROFIT_HOP_COUNT,
-        gasPrice,
-        chainId,
-        txType: getTxType(config),
-        startNonce: baseNonce + 1
-    });
-    signedTxs.push(...profitHopResult.signedTransactions);
-    return profitHopResult.hopWallets; // ✅ 返回利润多跳钱包
-}
 function resolveBatchMinOutputs(minOutputAmounts, walletCount) {
     if (minOutputAmounts && minOutputAmounts.length === walletCount) {
-        return minOutputAmounts.map(m => typeof m === 'string' ? ethers.parseUnits(m, 18) : m);
+        return minOutputAmounts.map((m) => (typeof m === 'string' ? ethers.parseUnits(m, 18) : m));
     }
     return new Array(walletCount).fill(0n);
 }
@@ -513,9 +460,9 @@ function findMaxIndex(values) {
     }
     return maxIndex;
 }
-async function signBatchTransactions({ unsignedList, wallets, nonces, gasLimits, gasPrice, chainId, config, values }) {
+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;
+        const value = values ? values[i] : (unsigned.value ?? 0n);
         return wallets[i].signTransaction({
             ...unsigned,
             from: wallets[i].address,
@@ -524,11 +471,11 @@ async function signBatchTransactions({ unsignedList, wallets, nonces, gasLimits,
             gasPrice,
             chainId,
             type: getTxType(config),
-            value
+            value,
         });
     }));
 }
-function summarizeSellProfits(quotedOutputs, extractProfit, config) {
+function summarizeSellProfits(quotedOutputs, extractProfit) {
     let totalProfit = 0n;
     let maxRevenueIndex = -1;
     let maxRevenue = 0n;
@@ -536,7 +483,7 @@ function summarizeSellProfits(quotedOutputs, extractProfit, config) {
         for (let i = 0; i < quotedOutputs.length; i++) {
             const quoted = quotedOutputs[i];
             if (quoted > 0n) {
-                const { profit } = calculateProfit(quoted, config);
+                const { profit } = calculateProfit(quoted);
                 totalProfit += profit;
                 if (quoted > maxRevenue) {
                     maxRevenue = quoted;

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

@@ -0,0 +1,125 @@
+/**
+ * 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;

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

@@ -0,0 +1,113 @@
+/**
+ * Flap Protocol 内盘捆绑换手（Merkle Bundle）- 先买后卖
+ *
+ * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
+ */
+import { Contract } from 'ethers';
+import { PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
+import { ADDRESSES } from '../../../shared/constants/index.js';
+import { CHAINS, getProfitRateBps } from '../../constants/index.js';
+import { V2_ROUTER_QUOTE_ABI } from '../../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，移除本地重复实现