four-flap-meme-sdk 2.2.19 → 3.0.0

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

@@ -1,79 +0,0 @@
-import type { FlapBundleMerkleConfig, FlapSignConfig, FlapChainForMerkleBundle } from './types.js';
-export type { FlapBundleMerkleConfig, FlapSignConfig, FlapChainForMerkleBundle };
-export declare const BLOCKRAZOR_BUILDER_EOA: "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
-export type FlapAnyConfig = FlapBundleMerkleConfig | FlapSignConfig;
-export declare const CHAIN_ID_MAP: Record<FlapChainForMerkleBundle, number>;
-export declare const MERKLE_SUPPORTED_CHAIN_IDS: readonly [56, 1];
-export type MerkleSupportedChainId = typeof MERKLE_SUPPORTED_CHAIN_IDS[number];
-export declare const PORTAL_ABI: string[];
-export declare const ERRORS: {
-    NO_PRIVATE_KEY: {
-        en: string;
-        zh: string;
-    };
-    AMOUNT_MISMATCH: {
-        en: (buyCount: number, buyerCount: number) => string;
-        zh: (buyCount: number, buyerCount: number) => string;
-    };
-    KEY_AMOUNT_MISMATCH: {
-        en: string;
-        zh: string;
-    };
-    SELL_KEY_AMOUNT_MISMATCH: {
-        en: string;
-        zh: string;
-    };
-};
-export declare function getErrorMessage(key: keyof typeof ERRORS, ...args: any[]): string;
-export declare function getTxType(config: FlapAnyConfig): 0 | 2;
-export declare function getGasPriceMultiplier(config: FlapAnyConfig): number;
-export declare function getBundleOptions(config: FlapBundleMerkleConfig, blockOffset?: number): {
-    blockOffset: number;
-    minBlockOffset: number;
-    autoRetry: boolean;
-    maxRetries: number;
-};
-export declare function getGasPriceConfig(config: FlapAnyConfig): any;
-/**
- * 检查是否需要提取利润
- * ✅ 强制开启，始终返回 true
- */
-export declare function shouldExtractProfit(config?: FlapAnyConfig): boolean;
-/**
- * 获取利润率（单位：基点 bps，1 bps = 0.01%）
- * ✅ 硬编码：30 bps = 0.3% = 千分之3
- */
-export declare function getProfitRateBps(config?: FlapAnyConfig): number;
-/**
- * 获取利润接收地址
- */
-export declare function getProfitRecipient(config?: FlapAnyConfig): string;
-/**
- * 计算利润和剩余金额
- * ✅ 强制提取利润：使用硬编码的利润率
- * @param amount 原始金额
- * @param config 配置（保留参数但不使用，保持兼容性）
- * @returns { profit: 利润金额, remaining: 剩余金额 }
- */
-export declare function calculateProfit(amount: bigint, config?: FlapAnyConfig): {
-    profit: bigint;
-    remaining: bigint;
-};
-/**
- * 批量计算利润
- * ✅ 强制提取利润：使用硬编码的利润率
- * @param amounts 原始金额数组
- * @param config 配置（保留参数但不使用，保持兼容性）
- * @returns { totalProfit: 总利润, remainingAmounts: 剩余金额数组 }
- */
-export declare function calculateBatchProfit(amounts: bigint[], config?: FlapAnyConfig): {
-    totalProfit: bigint;
-    remainingAmounts: bigint[];
-};
-/**
- * 获取 BlockRazor 贿赂金额（wei）
- * ✅ 用于提高 bundle 打包优先级
- * @param config 配置
- * @returns 贿赂金额（wei），如果未配置则返回 0n
- */
-export declare function getBribeAmount(config?: FlapAnyConfig): bigint;

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

@@ -1,133 +0,0 @@
-import { ethers } from 'ethers';
-import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA as _BLOCKRAZOR_BUILDER_EOA } from '../../../utils/constants.js';
-import { FLAP_PORTAL_ABI } from '../../abis/common.js';
-// ✅ 从公共模块重新导出
-export const BLOCKRAZOR_BUILDER_EOA = _BLOCKRAZOR_BUILDER_EOA;
-// ✅ Chain ID 映射
-// 注意：Merkle 捆绑服务目前只支持 BSC (56) 和 ETH (1)
-// 其他链仅用于非捆绑的签名交易（顺序广播）
-export const CHAIN_ID_MAP = {
-    BSC: 56,
-    MONAD: 143,
-    XLAYER: 196,
-    BASE: 8453, // ✅ 新增 Base（非捆绑，顺序广播）
-};
-// Merkle 服务支持的 chainId（用于类型断言）
-export const MERKLE_SUPPORTED_CHAIN_IDS = [56, 1];
-// ✅ Portal ABI 从公共模块导入
-export const PORTAL_ABI = FLAP_PORTAL_ABI;
-// 错误信息国际化
-export const ERRORS = {
-    NO_PRIVATE_KEY: {
-        en: 'At least 1 private key (creator) is required',
-        zh: '至少需要 1 个私钥（创建者）'
-    },
-    AMOUNT_MISMATCH: {
-        en: (buyCount, buyerCount) => `Buy amount count (${buyCount}) must equal buyer count (${buyerCount})`,
-        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`
-    },
-    KEY_AMOUNT_MISMATCH: {
-        en: 'Private key count and amount count must match',
-        zh: '私钥和购买金额数量必须一致'
-    },
-    SELL_KEY_AMOUNT_MISMATCH: {
-        en: 'Private key count and sell amount count must match',
-        zh: '私钥和卖出数量必须一致'
-    }
-};
-export function getErrorMessage(key, ...args) {
-    const lang = (process.env.LANG || process.env.LANGUAGE || 'en').toLowerCase().includes('zh') ? 'zh' : 'en';
-    const message = ERRORS[key][lang];
-    return typeof message === 'function' ? message(...args) : message;
-}
-export function getTxType(config) {
-    return config.txType ?? 0;
-}
-export function getGasPriceMultiplier(config) {
-    return config.gasPriceMultiplierPercent ?? 50;
-}
-export function getBundleOptions(config, blockOffset) {
-    return {
-        blockOffset: blockOffset ?? config.bundleBlockOffset ?? 3,
-        minBlockOffset: config.minBlockOffset ?? 3,
-        autoRetry: config.autoRetryBundle ?? false,
-        maxRetries: config.maxBundleRetries ?? 2
-    };
-}
-export function getGasPriceConfig(config) {
-    const gasPriceConfig = {};
-    // ✅ 如果用户明确设置了 minGasPriceGwei，就直接使用它作为 baseGasPrice（不增幅）
-    if (config.minGasPriceGwei !== undefined) {
-        gasPriceConfig.baseGasPrice = ethers.parseUnits(String(config.minGasPriceGwei), 'gwei');
-        gasPriceConfig.multiplierPercent = 0; // 不增幅
-    }
-    else {
-        // 否则使用默认增幅策略
-        gasPriceConfig.multiplierPercent = getGasPriceMultiplier(config);
-    }
-    return gasPriceConfig;
-}
-/**
- * 检查是否需要提取利润
- * ✅ 强制开启，始终返回 true
- */
-export function shouldExtractProfit(config) {
-    return true; // 强制提取利润
-}
-/**
- * 获取利润率（单位：基点 bps，1 bps = 0.01%）
- * ✅ 硬编码：30 bps = 0.3% = 千分之3
- */
-export function getProfitRateBps(config) {
-    return PROFIT_CONFIG.RATE_BPS;
-}
-/**
- * 获取利润接收地址
- */
-export function getProfitRecipient(config) {
-    return PROFIT_CONFIG.RECIPIENT;
-}
-/**
- * 计算利润和剩余金额
- * ✅ 强制提取利润：使用硬编码的利润率
- * @param amount 原始金额
- * @param config 配置（保留参数但不使用，保持兼容性）
- * @returns { profit: 利润金额, remaining: 剩余金额 }
- */
-export function calculateProfit(amount, config) {
-    // ✅ 强制提取利润
-    const profit = (amount * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
-    const remaining = amount - profit;
-    return { profit, remaining };
-}
-/**
- * 批量计算利润
- * ✅ 强制提取利润：使用硬编码的利润率
- * @param amounts 原始金额数组
- * @param config 配置（保留参数但不使用，保持兼容性）
- * @returns { totalProfit: 总利润, remainingAmounts: 剩余金额数组 }
- */
-export function calculateBatchProfit(amounts, config) {
-    let totalProfit = 0n;
-    const remainingAmounts = [];
-    for (const amount of amounts) {
-        const { profit, remaining } = calculateProfit(amount, config);
-        totalProfit += profit;
-        remainingAmounts.push(remaining);
-    }
-    return { totalProfit, remainingAmounts };
-}
-/**
- * 获取 BlockRazor 贿赂金额（wei）
- * ✅ 用于提高 bundle 打包优先级
- * @param config 配置
- * @returns 贿赂金额（wei），如果未配置则返回 0n
- */
-export function getBribeAmount(config) {
-    if (!config)
-        return 0n;
-    const bribeAmount = config.bribeAmount;
-    if (!bribeAmount || bribeAmount <= 0)
-        return 0n;
-    return ethers.parseEther(String(bribeAmount));
-}

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

@@ -1,14 +0,0 @@
-/**
- * Flap Protocol Bundle 交易方法（Merkle 版本）
- * 使用 Merkle.io Bundle 服务实现原子化交易
- */
-export * from './config.js';
-export * from './types.js';
-export { createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWithBundleMerkle } from './core.js';
-export { flapBundleBuyFirstMerkle, type FlapChain, type FlapBuyFirstSignConfig, type FlapBuyFirstConfig, type FlapBundleBuyFirstSignParams, type FlapBundleBuyFirstParams, type FlapBuyFirstResult } from './swap-buy-first.js';
-export { flapPrivateBuyMerkle, flapPrivateSellMerkle, flapBatchPrivateBuyMerkle, flapBatchPrivateSellMerkle } from './private.js';
-export { pancakeProxyBatchBuyMerkle, pancakeProxyBatchSellMerkle, approvePancakeProxy, approvePancakeProxyBatch } from './pancake-proxy.js';
-export { flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle, type FlapDisperseSignParams, type FlapDisperseMerkleResult, type FlapSweepSignParams, type FlapSweepMerkleResult } from './utils.js';
-export { flapBundleCurveToDex, type CurveToDexChain, type DexPoolType, type CurveToDexSignConfig, type CurveBuyerConfig, type DexBuyerConfig, type FlapCurveToDexParams, type FlapCurveToDexResult } from './curve-to-dex.js';
-export { flapBundleCreateToDex, type CreateToDexChain, type CreateToDexSignConfig, type CreateTokenInfo, type FlapCreateToDexParams, type FlapCreateToDexResult, type CurveBuyerConfig as CreateCurveBuyerConfig, type DexBuyerConfig as CreateDexBuyerConfig, type DexPoolType as CreateDexPoolType } from './create-to-dex.js';
-export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, type FlapSwapSignConfig, type FlapSwapConfig, type FlapBundleSwapSignParams, type FlapBundleSwapParams, type FlapSwapResult, type FlapBatchSwapSignParams, type FlapBatchSwapResult, type FlapQuickBatchSwapSignParams, type FlapQuickBatchSwapResult, type FlapCrossSwapParams, type FlapCrossSwapResult, type UserType } from './swap.js';

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

@@ -1,65 +0,0 @@
-/**
- * Flap Protocol 内盘捆绑换手（Merkle Bundle）- 先买后卖
- *
- * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
-import { FlapSignConfig } from './config.js';
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-export type FlapChain = 'bsc' | 'xlayer' | 'base';
-export type UserType = 'v0' | 'v1';
-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 declare function flapBundleBuyFirstMerkle(params: FlapBundleBuyFirstSignParams): Promise<FlapBuyFirstResult>;

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

@@ -1,201 +0,0 @@
-/**
- * Flap Protocol 内盘捆绑换手（Merkle Bundle）
- *
- * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
- */
-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>;