four-flap-meme-sdk 2.2.0 → 2.2.2

package/dist/shared/flap/portal-bundle-merkle/core-helpers.js

@@ -1,83 +0,0 @@
-import { Contract } from 'ethers';
-import { ADDRESSES } from '../../../shared/constants/index.js';
-import { CHAINS } from '../../constants/index.js';
-import { V2_ROUTER_QUOTE_ABI } from '../../abis/common.js';
-// ✅ 常量
-export const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
-// ==================== ERC20 → 原生代币报价 ====================
-// BSC 链常量
-export const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
-export const BSC_WBNB = ADDRESSES.BSC.WBNB;
-// ✅ Monad 链常量
-export const MONAD_PANCAKE_V2_ROUTER = '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9';
-export const MONAD_WMON = ADDRESSES.MONAD.WMON;
-// ✅ XLAYER 链常量（PotatoSwap V2）
-export const XLAYER_POTATOSWAP_V2_ROUTER = ADDRESSES.XLAYER.PotatoSwapV2Router;
-export const XLAYER_WOKB = ADDRESSES.XLAYER.WOKB;
-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];
-        }
-        if (chainId === CHAINS.XLAYER.chainId) {
-            // ✅ XLAYER: 使用 PotatoSwap V2 Router（USDT0 → WOKB）
-            const router = new Contract(XLAYER_POTATOSWAP_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, XLAYER_WOKB]);
-            return amounts[1];
-        }
-        if (chainId === CHAINS.BASE.chainId) {
-            // ✅ Base: 目前大部分 Flap 交易使用 ETH（原生代币），ERC20 报价暂不支持
-            // Base 主力 DEX 是 Uniswap V3，V2 Router 流动性有限，暂返回 0
-            // TODO: 后续可接入 Uniswap V3 QuoterV2 进行精确报价
-            return 0n;
-        }
-        // 其他链暂不支持报价，返回 0
-        return 0n;
-    }
-    catch {
-        // 报价失败返回 0（可能是流动性不足或路径不存在）
-        return 0n;
-    }
-}
-/**
- * 获取 Gas Limit
- * 优先使用 config.gasLimit，否则使用默认值 * multiplier
- *
- * ✅ ethers v6 最佳实践：直接使用 bigint 类型
- */
-export function getGasLimit(config, defaultGas = 800000) {
-    // 优先使用前端传入的 gasLimit
-    if (config.gasLimit !== undefined) {
-        // 如果已经是 bigint，直接返回；否则转换
-        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
-    }
-    // 使用默认值 * multiplier
-    const multiplier = config.gasLimitMultiplier ?? 1.0;
-    const calculatedGas = Math.ceil(defaultGas * multiplier);
-    // JavaScript 原生 BigInt 转换（ethers v6 兼容）
-    return BigInt(calculatedGas);
-}
-/**
- * Flap Protocol: 创建代币 + 捆绑购买（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- */

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

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

@@ -1,113 +0,0 @@
-/**
- * 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，移除本地重复实现

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

@@ -1,149 +0,0 @@
-/**
- * Flap Protocol 内盘捆绑换手（Merkle Bundle）
- *
- * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
- */
-import { ethers, Wallet, JsonRpcProvider } from 'ethers';
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
-import { type GeneratedWallet } from '../../../utils/wallet.js';
-export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
-export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 65000n;
-export declare const BRIBE_GAS_LIMIT: 21000n;
-/**
- * 分发多跳路径信息
- */
-export type DisperseHopPath = {
-    targetAddress: string;
-    hopWallets: Wallet[];
-    hopWalletsInfo: GeneratedWallet[];
-};
-/**
- * 生成分发多跳路径
- */
-export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
-/**
- * 构建原生代币多跳转账链
- */
-export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, chainId: number, txType: number, payerNonce: number): Promise<string[]>;
-/**
- * 构建 ERC20 多跳转账链
- */
-export declare function buildERC20HopChain(payer: Wallet, path: DisperseHopPath, erc20Address: string, erc20Amount: bigint, gasPrice: bigint, chainId: number, txType: number, payerNonce: number): Promise<string[]>;
-/**
- * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
- */
-export declare function buildBNBHopChainForERC20(payer: Wallet, path: DisperseHopPath, finalGasAmount: bigint, gasPrice: bigint, chainId: number, txType: number, payerNonce: number): Promise<string[]>;
-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;
-}
-/**
- * 获取 Gas Limit
- */
-export declare function getGasLimit(config: FlapSwapSignConfig | FlapSwapConfig, defaultGas?: number): bigint;
-export declare const ROUTER_ABI: string[];
-export declare const ERC20_BALANCE_OF_ABI: string[];
-export declare const APPROVE_INTERFACE: ethers.Interface;
-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";
-/**
- * 获取 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';
-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;
-    };
-};
-export type ChainContext = {
-    chainId: number;
-    nativeToken: string;
-    portalAddress: string;
-    provider: ethers.JsonRpcProvider;
-};
-export type QuoteResult = {
-    quotedNative: bigint;
-    minOutNative: bigint;
-};
-export type BuyerNeed = {
-    reserveGas: bigint;
-    buyerBalance: bigint;
-    buyerNeedTotal: bigint;
-    maxBuyerValue: bigint;
-};
-export type NoncePlan = {
-    sellerNonce: number;
-    buyerNonce: number;
-    bribeNonce?: number;
-    profitNonce?: number;
-};
-/**
- * 获取链ID
- */
-export declare function getChainId(chain: FlapChain): number;
-/**
- * 获取原生代币名称
- */
-export declare function getNativeTokenName(chain: FlapChain): string;
-/**
- * Flap内盘捆绑换手
- * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
- */