four-flap-meme-sdk 2.2.18 → 2.2.20

package/dist/shared/flap/portal-bundle-merkle/swap-single.js

@@ -0,0 +1,184 @@
+/**
+ * swap-single - 一卖一买换手
+ */
+import { ethers, Contract, Wallet } from 'ethers';
+import { calculateSellAmount } from '../../../utils/swap-helpers.js';
+import { NonceManager, getOptimizedGasPrice } from '../../../utils/bundle-helpers.js';
+import { ZERO_ADDRESS } from '../../../shared/constants/index.js';
+import { getGasPriceConfig, getTxType, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI, } from './config.js';
+import { buildTransactionRequest } from '../../foundation/tx/build-request.js';
+import { BRIBE_GAS_LIMIT, getGasLimit, getTokenToNativeQuote, } from './swap-helpers.js';
+import { buildApprovalTransaction, buildNoncePlan, buildProfitTransaction, calculateBuyerNeed, calculateProfitAmount, createChainContext, planNonces, quoteSellOutput, validateBalances, } from './swap-planning.js';
+export async function flapBundleSwapMerkle(params) {
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, quoteToken, quoteTokenDecimals, startNonces, // ✅ 可选：前端预获取的 nonces
+     } = params;
+    const chainContext = createChainContext(chain, config);
+    const seller = new Wallet(sellerPrivateKey, chainContext.provider);
+    const buyer = new Wallet(buyerPrivateKey, chainContext.provider);
+    const nonceManager = new NonceManager(chainContext.provider);
+    const finalGasLimit = getGasLimit(config);
+    const txType = getTxType(config);
+    // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    // ✅ 优化：第一批并行 - calculateSellAmount、gasPrice
+    const [sellAmountResult, gasPrice] = await Promise.all([
+        calculateSellAmount(chainContext.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config)),
+    ]);
+    const { amount: sellAmountWei, decimals } = sellAmountResult;
+    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
+    // ✅ 优化：第二批并行 - approval、quote（已移除滑点保护）
+    const [approvalTx, quote] = await Promise.all([
+        config.skipApprovalCheck
+            ? Promise.resolve(null)
+            : buildApprovalTransaction({
+                tokenAddress,
+                seller,
+                provider: chainContext.provider,
+                decimals,
+                portalAddress: chainContext.portalAddress,
+                chainId: chainContext.chainId,
+                config,
+            }),
+        quoteSellOutput({
+            portalAddress: chainContext.portalAddress,
+            tokenAddress,
+            sellAmountWei,
+            provider: chainContext.provider,
+            skipQuoteOnError: config.skipQuoteOnError,
+            outputToken, // ✅ 传递输出代币
+        }),
+    ]);
+    // ✅ 优化：第三批并行 - buyerNeed、validateBalances
+    const buyerNeed = await calculateBuyerNeed({
+        buyer,
+        quotedNative: quote.quotedNative,
+        reserveGasEth: config.reserveGasETH,
+        nativeToken: chainContext.nativeToken,
+        useNativeToken,
+        quoteToken,
+        quoteTokenDecimals,
+        provider: chainContext.provider,
+    });
+    // ✅ 计算利润（基于卖出报价，根据 userType 动态调整）
+    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative, config.userType);
+    // ✅ ERC20 输出：获取代币利润等值的原生代币（BNB）报价
+    let nativeProfitAmount = tokenProfitAmount; // 原生代币输出时直接使用
+    if (!useNativeToken && tokenProfitAmount > 0n) {
+        // 将代币利润转换为等值 BNB
+        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, quoteToken, tokenProfitAmount, chainContext.chainId);
+    }
+    // ✅ 获取贿赂金额
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // ✅ 优化：第四批并行 - 构建交易、获取 nonces、验证余额
+    const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
+    const portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);
+    const [sellUnsigned, buyUnsigned, noncePlan] = await Promise.all([
+        portalSeller.swapExactInput.populateTransaction({
+            inputToken: tokenAddress,
+            outputToken, // ✅ 使用动态输出代币
+            inputAmount: sellAmountWei,
+            minOutputAmount: 0,
+            permitData: '0x',
+        }),
+        portalBuyer.swapExactInput.populateTransaction({
+            inputToken: outputToken, // ✅ 使用动态输入代币
+            outputToken: tokenAddress,
+            inputAmount: buyerNeed.maxBuyerValue,
+            minOutputAmount: 0,
+            permitData: '0x',
+        }, useNativeToken ? { value: buyerNeed.maxBuyerValue } : {}),
+        // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
+        startNonces && startNonces.length >= 2
+            ? buildNoncePlan(startNonces, !!approvalTx, nativeProfitAmount > 0n, needBribeTx)
+            : planNonces({
+                seller,
+                buyer,
+                approvalExists: !!approvalTx,
+                extractProfit: nativeProfitAmount > 0n,
+                needBribeTx,
+                nonceManager,
+            }),
+        validateBalances({
+            buyerAddress: buyer.address,
+            portalGasCost: finalGasLimit * gasPrice,
+            provider: chainContext.provider,
+            chainContext,
+            seller,
+            useNativeToken,
+        }),
+    ]);
+    // 构建交易请求
+    // ✅ 卖出交易 value 必须为 0，不能发送原生代币
+    const sellTx = buildTransactionRequest(sellUnsigned, {
+        from: seller.address,
+        nonce: noncePlan.sellerNonce,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        priorityFee,
+        chainId: chainContext.chainId,
+        txType,
+        value: 0n, // ✅ 卖出交易不发送原生代币
+    });
+    const buyTx = buildTransactionRequest(buyUnsigned, {
+        from: buyer.address,
+        nonce: noncePlan.buyerNonce,
+        gasLimit: finalGasLimit,
+        gasPrice,
+        priorityFee,
+        chainId: chainContext.chainId,
+        txType,
+        value: useNativeToken ? buyerNeed.maxBuyerValue : 0n, // ✅ ERC20 购买时 value=0
+    });
+    // ✅ 贿赂交易放在首位
+    let bribeTx = null;
+    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
+        bribeTx = await seller.signTransaction({
+            to: BLOCKRAZOR_BUILDER_EOA,
+            value: bribeAmount,
+            nonce: noncePlan.bribeNonce,
+            gasPrice,
+            gasLimit: BRIBE_GAS_LIMIT,
+            chainId: chainContext.chainId,
+            type: txType,
+        });
+    }
+    // ✅ 并行签名卖出和买入交易
+    const [signedSell, signedBuy] = await Promise.all([seller.signTransaction(sellTx), buyer.signTransaction(buyTx)]);
+    nonceManager.clearTemp();
+    // ✅ 组装顺序：贿赂 → 授权 → 卖出 → 买入
+    const allTransactions = [];
+    if (bribeTx)
+        allTransactions.push(bribeTx);
+    if (approvalTx)
+        allTransactions.push(approvalTx);
+    allTransactions.push(signedSell, signedBuy);
+    // ✅ 利润多跳转账（强制 2 跳中转）
+    const profitResult = await buildProfitTransaction({
+        provider: chainContext.provider,
+        seller,
+        profitAmount: nativeProfitAmount,
+        profitNonce: noncePlan.profitNonce,
+        gasPrice,
+        chainId: chainContext.chainId,
+        txType,
+    });
+    if (profitResult)
+        allTransactions.push(...profitResult.signedTransactions);
+    return {
+        signedTransactions: allTransactions,
+        profitHopWallets: profitResult?.hopWallets, // ✅ 导出利润多跳钱包
+        metadata: {
+            sellerAddress: seller.address,
+            buyerAddress: buyer.address,
+            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
+            buyAmount: useNativeToken
+                ? ethers.formatEther(buyerNeed.maxBuyerValue)
+                : ethers.formatUnits(buyerNeed.maxBuyerValue, quoteTokenDecimals ?? 18),
+            hasApproval: !!approvalTx,
+            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined, // ✅ 显示原生代币利润
+        },
+    };
+}

package/dist/shared/flap/portal-bundle-merkle/swap-types.d.ts

@@ -0,0 +1,101 @@
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FlapChain, FlapSwapSignConfig } from './swap-helpers.js';
+/**
+ * Flap 批量换手参数（一卖多买）
+ */
+export interface FlapBatchSwapSignParams {
+    chain: FlapChain;
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    tokenAddress: string;
+    config: FlapSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    startNonces?: number[];
+}
+/**
+ * Flap 批量换手结果
+ */
+export interface FlapBatchSwapResult {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        buyAmounts: string[];
+        hasApproval?: boolean;
+        profitAmount?: string;
+    };
+}
+/**
+ * Flap 快捷批量换手参数
+ */
+export interface FlapQuickBatchSwapSignParams {
+    chain: FlapChain;
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    config: FlapSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    disperseHopCount?: number;
+    startNonces?: number[];
+}
+/**
+ * Flap 快捷批量换手结果
+ */
+export interface FlapQuickBatchSwapResult {
+    signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedOutput: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        useNativeToken: boolean;
+        disperseHopCount?: number;
+    };
+}
+/** 交叉换手参数 */
+export interface FlapCrossSwapParams {
+    chain: FlapChain;
+    /** 卖方私钥列表（按顺序轮流卖出） */
+    sellerPrivateKeys: string[];
+    /** 每个卖方的卖出数量（与 sellerPrivateKeys 长度一致） */
+    sellAmounts: string[];
+    /** 买方私钥列表（按顺序轮流分配，每笔平分） */
+    buyerPrivateKeys: string[];
+    tokenAddress: string;
+    config: FlapSwapSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    /** 每次卖出分配给多少个买方（默认使用全部买方平分） */
+    buyersPerSell?: number;
+    /** 转账多跳数（可选） */
+    disperseHopCount?: number;
+}
+/** 交叉换手结果 */
+export interface FlapCrossSwapResult {
+    signedTransactions: string[];
+    /** 每轮的元数据列表 */
+    rounds: Array<{
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        bundleHash?: string;
+    }>;
+    /** 汇总的中间钱包信息（转账/利润） */
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+}

package/dist/shared/flap/portal-bundle-merkle/swap-types.js

@@ -0,0 +1 @@
+export {};

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

@@ -1,201 +1,8 @@
 /**
- * Flap Protocol 内盘捆绑换手（Merkle Bundle）
- *
- * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
+ * swap - barrel re-export（兼容 index/exports）
  */
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
-import { type GeneratedWallet } from '../../../utils/wallet.js';
-export type UserType = 'v0' | 'v1';
-export interface FlapSwapSignConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    chainId?: number;
-    reserveGasETH?: number;
-    skipQuoteOnError?: boolean;
-    skipApprovalCheck?: boolean;
-    bribeAmount?: number;
-    userType?: UserType;
-}
-export type FlapChain = 'bsc' | 'xlayer' | 'base';
-export interface FlapSwapConfig extends CommonBundleConfig {
-    apiKey: string;
-    customRpcUrl?: string;
-    bundleBlockOffset?: number;
-    reserveGasETH?: number;
-    skipQuoteOnError?: boolean;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-    skipApprovalCheck?: boolean;
-}
-export interface FlapBundleSwapSignParams {
-    chain: FlapChain;
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    config: FlapSwapSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-}
-export interface FlapBundleSwapParams {
-    chain: FlapChain;
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKey: string;
-    tokenAddress: string;
-    config: FlapSwapConfig;
-}
-/** ✅ Flap Swap 结果（简化版） */
-export type FlapSwapResult = {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        sellerAddress: string;
-        buyerAddress: string;
-        sellAmount: string;
-        buyAmount: string;
-        hasApproval?: boolean;
-        profitAmount?: string;
-    };
-};
-/**
- * Flap内盘捆绑换手
- * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
- */
-export declare function flapBundleSwapMerkle(params: FlapBundleSwapSignParams): Promise<FlapSwapResult>;
-/**
- * Flap 批量换手参数（一卖多买）
- */
-export interface FlapBatchSwapSignParams {
-    chain: FlapChain;
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKeys: string[];
-    buyerRatios?: number[];
-    tokenAddress: string;
-    config: FlapSwapSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-}
-/**
- * Flap 批量换手结果
- */
-export interface FlapBatchSwapResult {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        buyAmounts: string[];
-        hasApproval?: boolean;
-        profitAmount?: string;
-    };
-}
-/**
- * Flap 内盘批量换手（一卖多买）
- *
- * 功能：主钱包一次卖出 → 多个子钱包同时买入 → 在同一个区块中完成
- * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
- */
-export declare function flapBatchSwapMerkle(params: FlapBatchSwapSignParams): Promise<FlapBatchSwapResult>;
-/**
- * Flap 快捷批量换手参数
- */
-export interface FlapQuickBatchSwapSignParams {
-    chain: FlapChain;
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKeys: string[];
-    buyerRatios?: number[];
-    buyerAmounts?: string[];
-    tokenAddress: string;
-    config: FlapSwapSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    disperseHopCount?: number;
-    startNonces?: number[];
-}
-/**
- * Flap 快捷批量换手结果
- */
-export interface FlapQuickBatchSwapResult {
-    signedTransactions: string[];
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        estimatedOutput: string;
-        transferAmounts: string[];
-        profitAmount?: string;
-        useNativeToken: boolean;
-        disperseHopCount?: number;
-    };
-}
-/** 交叉换手参数 */
-export interface FlapCrossSwapParams {
-    chain: FlapChain;
-    /** 卖方私钥列表（按顺序轮流卖出） */
-    sellerPrivateKeys: string[];
-    /** 每个卖方的卖出数量（与 sellerPrivateKeys 长度一致） */
-    sellAmounts: string[];
-    /** 买方私钥列表（按顺序轮流分配，每笔平分） */
-    buyerPrivateKeys: string[];
-    tokenAddress: string;
-    config: FlapSwapSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    /** 每次卖出分配给多少个买方（默认使用全部买方平分） */
-    buyersPerSell?: number;
-    /** 转账多跳数（可选） */
-    disperseHopCount?: number;
-}
-/** 交叉换手结果 */
-export interface FlapCrossSwapResult {
-    signedTransactions: string[];
-    /** 每轮的元数据列表 */
-    rounds: Array<{
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        bundleHash?: string;
-    }>;
-    /** 汇总的中间钱包信息（转账/利润） */
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-}
-/**
- * Flap 内盘快捷批量换手（资金利用率模式）
- *
- * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
- *
- * 特点：
- * - 子钱包不需要预先有余额
- * - 资金来自主钱包卖出代币所得
- * - 提升资金利用率
- * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
- * - ✅ 支持转账多跳，隐藏资金流向
- *
- * 限制：根据多跳数动态计算最大买方数量
- */
-export declare function flapQuickBatchSwapMerkle(params: FlapQuickBatchSwapSignParams): Promise<FlapQuickBatchSwapResult>;
-/**
- * Flap 交叉换手（多卖多买，循环执行）
- * - 每个卖方单独卖出，买入金额由卖出所得等分分配给当轮买方
- * - 利润刮取、转账多跳逻辑继承 flapQuickBatchSwapMerkle
- * - 结果按顺序拼接 signedTransactions（可交由前端/后端顺序广播）
- * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
- */
-export declare function flapCrossSwapMerkle(params: FlapCrossSwapParams): Promise<FlapCrossSwapResult>;
+export { flapBundleSwapMerkle } from './swap-single.js';
+export { flapBatchSwapMerkle } from './swap-batch.js';
+export { flapQuickBatchSwapMerkle } from './swap-quick-batch.js';
+export { flapCrossSwapMerkle } from './swap-cross.js';
+export type { FlapBatchSwapSignParams, FlapBatchSwapResult, FlapQuickBatchSwapSignParams, FlapQuickBatchSwapResult, FlapCrossSwapParams, FlapCrossSwapResult, } from './swap-types.js';