four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/domains/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 '../../../core/constants/index.js';
+import { getGasPriceConfig, getTxType, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI, } from './config.js';
+import { buildTransactionRequest } from '../../../core/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/domains/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/domains/flap/portal-bundle-merkle/swap-types.js

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

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

@@ -0,0 +1,8 @@
+/**
+ * swap - barrel re-export（兼容 index/exports）
+ */
+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';

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

@@ -0,0 +1,7 @@
+/**
+ * swap - barrel re-export（兼容 index/exports）
+ */
+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';

package/dist/{shared → domains}/flap/portal-bundle-merkle/types.d.ts

@@ -24,13 +24,21 @@ export type TaxDistributionConfig = {
     minimumShareBalance?: number;
 };
 /**
- * Tax Token V2 高级税收参数（用于 Portal.newTokenV6 TOKEN_TAXED_V3 / VaultPortal.newTokenV6WithVault）
+ * Tax Token V2/V3 高级税收参数（用于 newTokenV6 TOKEN_TAXED_V3）
  */
 export type TaxV2Config = {
     /** 税收持续时间（秒，最大 100 年，0 = 永久） */
     taxDuration: number;
     /** 防打新持续时间（秒，最大 1 年） */
     antiFarmerDuration: number;
+    /** 买入税率（bps，100 = 1%） */
+    buyTaxRate?: number;
+    /** 卖出税率（bps，100 = 1%） */
+    sellTaxRate?: number;
+    /** 分红代币地址（零地址 = 原生/quote token） */
+    dividendToken?: string;
+    /** 佣金接收地址（零地址 = 无佣金） */
+    commissionReceiver?: string;
     /** 税收分配配置 */
     distribution: TaxDistributionConfig;
     /** ✅ Tax Vault 金库配置（可选） */
@@ -47,6 +55,11 @@ export type FlapSignConfig = {
     gasPrice?: bigint;
     bribeAmount?: number;
     profitMode?: FlapProfitMode;
+    /**
+     * 发币+捆绑买是否刮利润（默认 true，与 emitservice 提交校验对齐）。
+     * 设为 false 时不追加利润多跳，需后端允许末笔为 Portal 买入。
+     */
+    extractProfitOnLaunch?: boolean;
 };
 export type FlapBundleMerkleConfig = {
     apiKey: string;
@@ -85,6 +98,10 @@ export type MerkleBundleStatus = {
     totalGasUsed: bigint;
     targetBlock: number;
 };
+/** Merkle 结果 metadata 字段值（各方法返回的键不固定，值类型统一收窄） */
+export type MerkleResultMetadataValue = string | number | boolean | string[] | undefined;
+/** Merkle 结果 metadata */
+export type MerkleResultMetadata = Record<string, MerkleResultMetadataValue>;
 /**
  * 统一的 Merkle 方法返回类型
  * SDK 不再内部提交，只返回签名交易和元数据
@@ -97,9 +114,7 @@ export type MerkleSignedResult = {
     /** ✅ 利润多跳钱包（用于导出私钥） */
     profitHopWallets?: GeneratedWallet[];
     /** 元数据（如利润信息等） */
-    metadata?: {
-        [key: string]: any;
-    };
+    metadata?: MerkleResultMetadata;
 };
 /** ✅ Flap 创建代币 + 购买参数（Merkle 版本 - 完整） */
 export type FlapCreateWithBundleBuyMerkleParams = {
@@ -118,12 +133,9 @@ export type FlapCreateWithBundleBuyMerkleParams = {
     dexThresh?: number;
     migratorType?: number;
     taxRate?: number;
-    buyTaxRate?: number;
-    sellTaxRate?: number;
     salt?: string;
     extensionID?: string;
     extensionData?: string;
-    taxV2Config?: TaxV2Config;
 };
 /** ✅ Flap 创建代币 + 购买参数（仅签名版本 - 精简） */
 export type FlapCreateWithBundleBuySignParams = {
@@ -151,12 +163,8 @@ export type FlapCreateWithBundleBuySignParams = {
     dexId?: number;
     /** LP 费率档位：0=STANDARD(0.25%), 1=LOW(0.01%), 2=HIGH(1%) */
     lpFeeProfile?: number;
-    /** Tax Token 高级税收配置 */
+    /** Tax Token V2/V3 高级税收配置 */
     taxV2Config?: TaxV2Config;
-    /** 买入税率（bps，可选；默认与 taxRate 相同） */
-    buyTaxRate?: number;
-    /** 卖出税率（bps，可选；默认与 taxRate 相同） */
-    sellTaxRate?: number;
 };
 /**
  * ✅ Flap 创建代币 + 购买结果（简化版）
@@ -363,3 +371,71 @@ export type PancakeProxyApprovalBatchResult = {
     bundleHash?: string;
     message: string;
 };
+export type FlapDisperseSignParams = {
+    chain: 'BSC' | 'MONAD' | 'XLAYER';
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    items?: {
+        recipient: string;
+        amount: string | bigint;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }[];
+    config: FlapSignConfig;
+    startNonce?: number;
+};
+export type FlapDisperseMerkleResult = {
+    signedTransactions: string[];
+    hopWallets?: (string | GeneratedWallet)[][];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        totalAmount: string;
+        profitAmount: string;
+        profitRecipient: string;
+        recipientCount: number;
+        isNative: boolean;
+        tokenAddress?: string;
+    };
+};
+export type FlapSweepSignParams = {
+    chain: 'BSC' | 'MONAD' | 'XLAYER';
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    ratios?: number[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    skipIfInsufficient?: boolean;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    sources?: {
+        privateKey: string;
+        ratioPct?: number;
+        amount?: string;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }[];
+    config: FlapSignConfig;
+    startNonce?: number;
+};
+export type FlapSweepMerkleResult = {
+    signedTransactions: string[];
+    hopWallets?: (string | GeneratedWallet)[][];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        totalAmount: string;
+        profitAmount: string;
+        profitRecipient: string;
+        sourceCount: number;
+        isNative: boolean;
+        tokenAddress?: string;
+    };
+};

package/dist/domains/flap/portal-bundle-merkle/types.js

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

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

@@ -0,0 +1,10 @@
+import type { FlapDisperseMerkleResult, FlapDisperseSignParams, FlapSweepMerkleResult, FlapSweepSignParams } from './types.js';
+export declare function flapDisperseWithBundleMerkle(params: FlapDisperseSignParams): Promise<FlapDisperseMerkleResult>;
+/**
+ * Flap Protocol: 归集（仅签名版本）
+ * ✅ 支持利润提取（按地址数量收取固定费用）
+ * ✅ 查询余额最大的钱包支付利润
+ * ✅ 支持多跳
+ * ✅ 支持 Multicall3 批量获取余额
+ */
+export declare function flapSweepWithBundleMerkle(params: FlapSweepSignParams): Promise<FlapSweepMerkleResult>;