four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/utils/quote-helpers/index.d.ts

@@ -1,107 +0,0 @@
-import type { QuoteParams, QuoteResult } from './types.js';
-export type { QuoteParams, QuoteResult } from './types.js';
-/** 支持的链 */
-export type SupportedChain = keyof typeof QUOTE_CONFIG;
-/**
- * V2/V3 报价工具函数
- *
- * 提供统一的代币报价功能，支持：
- * - V2 Router 报价（直接路径 + 多跳路径）
- * - V3 Quoter 报价（多费率尝试 + 多跳路径）
- * - ERC20 → 原生代币转换报价
- */
-import { JsonRpcProvider } from 'ethers';
-/** V3 常用费率档位 */
-export declare const V3_FEE_TIERS: number[];
-/** 各链的报价配置 */
-export declare const QUOTE_CONFIG: {
-    readonly BSC: {
-        readonly v2Router: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
-        readonly v3Quoter: "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997";
-        readonly wrappedNative: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
-        readonly stableCoins: readonly ["0x55d398326f99059fF775485246999027B3197955", "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56"];
-    };
-    readonly MONAD: {
-        readonly v2Router: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
-        readonly v3Quoter: "";
-        readonly wrappedNative: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
-        readonly stableCoins: readonly [];
-    };
-    readonly XLAYER: {
-        readonly v2Router: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
-        readonly v3Quoter: "0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e";
-        readonly wrappedNative: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
-        readonly stableCoins: readonly ["0x1E4a5963aBFD975d8c9021ce480b42188849D41d", "0x74b7f16337b8972027f6196a17a631ac6de26d22", "0x779ded0c9e1022225f8e0630b35a9b54be713736"];
-    };
-    readonly ENI: {
-        readonly v2Router: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
-        readonly v3Quoter: "";
-        readonly wrappedNative: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";
-        readonly stableCoins: readonly ["0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a", "0xaFF944b96c1BAEA587159ec446280E468B32ee15"];
-    };
-};
-/**
- * V2 报价（直接路径 + 多跳路径）
- * ✅ 优化：并行尝试直接路径和多跳路径
- *
- * @param provider - Provider 实例
- * @param tokenIn - 输入代币地址
- * @param tokenOut - 输出代币地址
- * @param amountIn - 输入数量（wei）
- * @param chain - 链名称
- * @returns 报价结果
- */
-export declare function quoteV2(provider: JsonRpcProvider, tokenIn: string, tokenOut: string, amountIn: bigint, chain: string, routerOverride?: string): Promise<QuoteResult>;
-/**
- * V3 报价（多费率尝试 + 多跳路径）
- * ✅ 优化：并行尝试多个费率
- *
- * @param provider - Provider 实例
- * @param tokenIn - 输入代币地址
- * @param tokenOut - 输出代币地址
- * @param amountIn - 输入数量（wei）
- * @param chain - 链名称
- * @param preferredFee - 优先尝试的费率（可选）
- * @returns 报价结果
- */
-export declare function quoteV3(provider: JsonRpcProvider, tokenIn: string, tokenOut: string, amountIn: bigint, chain: string, preferredFee?: number): Promise<QuoteResult>;
-/**
- * 统一报价接口（根据版本自动选择 V2 或 V3）
- *
- * @param params - 报价参数
- * @returns 报价结果
- */
-export declare function quote(params: QuoteParams): Promise<QuoteResult>;
-/**
- * 获取 ERC20 代币 → 原生代币（WBNB/WMON 等）的报价
- *
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param tokenAmount - 代币数量（wei）
- * @param chain - 链名称
- * @param version - 'v2' | 'v3'
- * @param fee - V3 费率档位（仅 V3 时使用）
- * @param routerOverride - V2 时使用指定 Router（如 IROSwap，用于利润报价）
- * @returns 等值的原生代币数量（wei），失败返回 0n
- */
-export declare function getTokenToNativeQuote(provider: JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, chain: string, version?: 'v2' | 'v3', fee?: number, routerOverride?: string): Promise<bigint>;
-/**
- * 获取原生代币 → ERC20 代币的报价
- *
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param nativeAmount - 原生代币数量（wei）
- * @param chain - 链名称
- * @param version - 'v2' | 'v3'
- * @param fee - V3 费率档位（仅 V3 时使用）
- * @returns 等值的 ERC20 代币数量（wei），失败返回 0n
- */
-export declare function getNativeToTokenQuote(provider: JsonRpcProvider, tokenAddress: string, nativeAmount: bigint, chain: string, version?: 'v2' | 'v3', fee?: number): Promise<bigint>;
-/**
- * 获取链的包装原生代币地址
- */
-export declare function getWrappedNativeAddress(chain: string): string;
-/**
- * 获取链的稳定币列表
- */
-export declare function getStableCoins(chain: string): string[];

package/dist/utils/quote-helpers/index.js

@@ -1,346 +0,0 @@
-/**
- * V2/V3 报价工具函数
- *
- * 提供统一的代币报价功能，支持：
- * - V2 Router 报价（直接路径 + 多跳路径）
- * - V3 Quoter 报价（多费率尝试 + 多跳路径）
- * - ERC20 → 原生代币转换报价
- */
-import { ethers, Contract } from 'ethers';
-import { V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../../shared/abis/common.js';
-// ============================================================================
-// 常量配置
-// ============================================================================
-// ✅ V2_ROUTER_ABI 和 V3_QUOTER_ABI 从公共模块导入
-const V2_ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
-/** V3 常用费率档位 */
-export const V3_FEE_TIERS = [100, 500, 2500, 10000]; // 0.01%, 0.05%, 0.25%, 1%
-/** 各链的报价配置 */
-export const QUOTE_CONFIG = {
-    BSC: {
-        v2Router: '0x10ED43C718714eb63d5aA57B78B54704E256024E', // PancakeSwap V2 Router
-        v3Quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997', // PancakeSwap V3 Quoter
-        wrappedNative: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c', // WBNB
-        stableCoins: [
-            '0x55d398326f99059fF775485246999027B3197955', // USDT
-            '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', // USDC
-            '0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56', // BUSD
-        ],
-    },
-    MONAD: {
-        v2Router: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9', // PancakeSwap V2
-        v3Quoter: '', // TODO: 添加 Monad V3 Quoter
-        wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a', // WMON
-        stableCoins: [],
-    },
-    XLAYER: {
-        v2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e', // PotatoSwap V2
-        v3Quoter: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e', // ✅ PotatoSwap V3 QuoterV2
-        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b', // WOKB
-        stableCoins: [
-            '0x1E4a5963aBFD975d8c9021ce480b42188849D41d', // USDT
-            '0x74b7f16337b8972027f6196a17a631ac6de26d22', // USDC
-            '0x779ded0c9e1022225f8e0630b35a9b54be713736', // USD₮0
-        ],
-    },
-    ENI: {
-        v2Router: '0x97ed8be49d9a8b86247090aa41e908e76b8fcf22', // DSWAP V2 Router
-        v3Quoter: '',
-        wrappedNative: '0x6d1e851446f4d004ae2a72f9afed85e8829a205e', // WEGAS
-        stableCoins: [
-            '0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a', // USDT (18 decimals)
-            '0xaFF944b96c1BAEA587159ec446280E468B32ee15', // USDC (18 decimals)
-        ],
-    },
-};
-// ============================================================================
-// V2 报价
-// ============================================================================
-/**
- * V2 报价（直接路径 + 多跳路径）
- * ✅ 优化：并行尝试直接路径和多跳路径
- *
- * @param provider - Provider 实例
- * @param tokenIn - 输入代币地址
- * @param tokenOut - 输出代币地址
- * @param amountIn - 输入数量（wei）
- * @param chain - 链名称
- * @returns 报价结果
- */
-export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, routerOverride) {
-    if (amountIn <= 0n) {
-        return { amountOut: 0n };
-    }
-    const chainUpper = chain.toUpperCase();
-    const config = QUOTE_CONFIG[chainUpper];
-    if (!config) {
-        console.warn(`[quoteV2] 不支持的链: ${chain}`);
-        return { amountOut: 0n };
-    }
-    const routerAddress = routerOverride || config.v2Router;
-    const router = new Contract(routerAddress, V2_ROUTER_ABI, provider);
-    const tokenInLower = tokenIn.toLowerCase();
-    const tokenOutLower = tokenOut.toLowerCase();
-    // ✅ 构建所有可能的路径
-    const paths = [];
-    // 直接路径
-    paths.push([tokenIn, tokenOut]);
-    // 多跳路径（通过稳定币）
-    for (const stableCoin of config.stableCoins) {
-        const stableLower = stableCoin.toLowerCase();
-        if (tokenInLower !== stableLower && tokenOutLower !== stableLower) {
-            paths.push([tokenIn, stableCoin, tokenOut]);
-        }
-    }
-    // ✅ 并行尝试所有路径
-    console.log(`[quoteV2] 输入: ${amountIn} wei, tokenIn=${tokenIn}, tokenOut=${tokenOut}`);
-    const quotePromises = paths.map(async (path) => {
-        try {
-            const amounts = await router.getAmountsOut(amountIn, path);
-            const amountOut = amounts[amounts.length - 1];
-            console.log(`[quoteV2] 路径 ${path.map(p => p.slice(0, 10) + '...').join(' → ')}: ${amountOut} wei`);
-            return { amountOut, path, success: amountOut > 0n };
-        }
-        catch (e) {
-            console.log(`[quoteV2] 路径失败 ${path.map(p => p.slice(0, 10) + '...').join(' → ')}: ${e.message?.slice(0, 50)}`);
-            return { amountOut: 0n, path, success: false };
-        }
-    });
-    const results = await Promise.all(quotePromises);
-    // 找到第一个成功的结果（优先直接路径）
-    for (const result of results) {
-        if (result.success) {
-            console.log(`[quoteV2] 路径成功 (${result.path.length === 2 ? '直接' : '多跳'}): ${ethers.formatEther(result.amountOut)}`);
-            return { amountOut: result.amountOut, path: result.path };
-        }
-    }
-    console.warn(`[quoteV2] 所有路径均失败`);
-    return { amountOut: 0n };
-}
-// ============================================================================
-// V3 报价
-// ============================================================================
-/**
- * V3 报价（多费率尝试 + 多跳路径）
- * ✅ 优化：并行尝试多个费率
- *
- * @param provider - Provider 实例
- * @param tokenIn - 输入代币地址
- * @param tokenOut - 输出代币地址
- * @param amountIn - 输入数量（wei）
- * @param chain - 链名称
- * @param preferredFee - 优先尝试的费率（可选）
- * @returns 报价结果
- */
-export async function quoteV3(provider, tokenIn, tokenOut, amountIn, chain, preferredFee) {
-    if (amountIn <= 0n) {
-        return { amountOut: 0n };
-    }
-    const chainUpper = chain.toUpperCase();
-    const config = QUOTE_CONFIG[chainUpper];
-    if (!config) {
-        console.warn(`[quoteV3] 不支持的链: ${chain}`);
-        return { amountOut: 0n };
-    }
-    if (!config.v3Quoter) {
-        console.warn(`[quoteV3] 该链不支持 V3 Quoter: ${chain}`);
-        return { amountOut: 0n };
-    }
-    const quoter = new Contract(config.v3Quoter, V3_QUOTER_ABI, provider);
-    const tokenInLower = tokenIn.toLowerCase();
-    const tokenOutLower = tokenOut.toLowerCase();
-    // 如果指定了费率，优先尝试；否则尝试所有费率
-    const feesToTry = preferredFee ? [preferredFee, ...V3_FEE_TIERS.filter(f => f !== preferredFee)] : V3_FEE_TIERS;
-    console.log(`[quoteV3] 开始报价: tokenIn=${tokenIn.slice(0, 10)}..., tokenOut=${tokenOut.slice(0, 10)}..., feesToTry=${feesToTry}`);
-    // ✅ 策略 1：并行尝试所有费率的直接路径
-    const directQuotePromises = feesToTry.map(async (fee) => {
-        try {
-            const result = await quoter.quoteExactInputSingle.staticCall({
-                tokenIn,
-                tokenOut,
-                amountIn,
-                fee,
-                sqrtPriceLimitX96: 0n
-            });
-            const amountOut = Array.isArray(result) ? result[0] : result;
-            return { amountOut: amountOut || 0n, fee, success: amountOut && amountOut > 0n };
-        }
-        catch {
-            return { amountOut: 0n, fee, success: false };
-        }
-    });
-    const directResults = await Promise.all(directQuotePromises);
-    // 按费率优先级返回第一个成功的结果
-    for (const result of directResults) {
-        if (result.success) {
-            console.log(`[quoteV3] 直接路径成功 (fee=${result.fee}): ${ethers.formatEther(result.amountOut)}`);
-            return { amountOut: result.amountOut, fee: result.fee };
-        }
-    }
-    // ✅ 策略 2：并行尝试多跳路径（通过稳定币）
-    const validStableCoins = config.stableCoins.filter(sc => {
-        const stableLower = sc.toLowerCase();
-        return tokenInLower !== stableLower && tokenOutLower !== stableLower;
-    });
-    // 并行尝试所有稳定币的第一跳
-    const firstHopPromises = validStableCoins.flatMap(stableCoin => feesToTry.map(async (fee1) => {
-        try {
-            const midResult = await quoter.quoteExactInputSingle.staticCall({
-                tokenIn,
-                tokenOut: stableCoin,
-                amountIn,
-                fee: fee1,
-                sqrtPriceLimitX96: 0n
-            });
-            const midAmount = Array.isArray(midResult) ? midResult[0] : midResult;
-            return { midAmount: midAmount || 0n, stableCoin, fee1, success: midAmount && midAmount > 0n };
-        }
-        catch {
-            return { midAmount: 0n, stableCoin, fee1, success: false };
-        }
-    }));
-    const firstHopResults = await Promise.all(firstHopPromises);
-    const successfulFirstHops = firstHopResults.filter(r => r.success);
-    // 对成功的第一跳，并行尝试第二跳
-    const stableFees = [100, 500, 2500];
-    const secondHopPromises = successfulFirstHops.flatMap(hop => stableFees.map(async (fee2) => {
-        try {
-            const finalResult = await quoter.quoteExactInputSingle.staticCall({
-                tokenIn: hop.stableCoin,
-                tokenOut,
-                amountIn: hop.midAmount,
-                fee: fee2,
-                sqrtPriceLimitX96: 0n
-            });
-            const amountOut = Array.isArray(finalResult) ? finalResult[0] : finalResult;
-            return { amountOut: amountOut || 0n, fee1: hop.fee1, fee2, success: amountOut && amountOut > 0n };
-        }
-        catch {
-            return { amountOut: 0n, fee1: hop.fee1, fee2, success: false };
-        }
-    }));
-    const secondHopResults = await Promise.all(secondHopPromises);
-    // 返回第一个成功的多跳结果
-    for (const result of secondHopResults) {
-        if (result.success) {
-            console.log(`[quoteV3] 多跳路径成功 (${result.fee1}→${result.fee2}): ${ethers.formatEther(result.amountOut)}`);
-            return { amountOut: result.amountOut, fee: result.fee1 };
-        }
-    }
-    console.warn(`[quoteV3] 所有路径均失败`);
-    return { amountOut: 0n };
-}
-// ============================================================================
-// 统一报价接口
-// ============================================================================
-/**
- * 统一报价接口（根据版本自动选择 V2 或 V3）
- *
- * @param params - 报价参数
- * @returns 报价结果
- */
-export async function quote(params) {
-    const { provider, tokenIn, tokenOut, amountIn, chain, version = 'v2', fee, routerOverride } = params;
-    if (version === 'v3') {
-        return quoteV3(provider, tokenIn, tokenOut, amountIn, chain, fee);
-    }
-    return quoteV2(provider, tokenIn, tokenOut, amountIn, chain, routerOverride);
-}
-// ============================================================================
-// 代币 → 原生代币报价
-// ============================================================================
-/**
- * 获取 ERC20 代币 → 原生代币（WBNB/WMON 等）的报价
- *
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param tokenAmount - 代币数量（wei）
- * @param chain - 链名称
- * @param version - 'v2' | 'v3'
- * @param fee - V3 费率档位（仅 V3 时使用）
- * @param routerOverride - V2 时使用指定 Router（如 IROSwap，用于利润报价）
- * @returns 等值的原生代币数量（wei），失败返回 0n
- */
-export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chain, version = 'v2', fee, routerOverride) {
-    if (tokenAmount <= 0n)
-        return 0n;
-    const chainUpper = chain.toUpperCase();
-    const config = QUOTE_CONFIG[chainUpper];
-    if (!config) {
-        console.warn(`[getTokenToNativeQuote] 不支持的链: ${chain}`);
-        return 0n;
-    }
-    const tokenLower = tokenAddress.toLowerCase();
-    const wrappedNativeLower = config.wrappedNative.toLowerCase();
-    // 如果代币本身就是包装原生代币，直接返回
-    if (tokenLower === wrappedNativeLower) {
-        return tokenAmount;
-    }
-    const result = await quote({
-        provider,
-        tokenIn: tokenAddress,
-        tokenOut: config.wrappedNative,
-        amountIn: tokenAmount,
-        chain,
-        version,
-        fee,
-        routerOverride
-    });
-    return result.amountOut;
-}
-/**
- * 获取原生代币 → ERC20 代币的报价
- *
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param nativeAmount - 原生代币数量（wei）
- * @param chain - 链名称
- * @param version - 'v2' | 'v3'
- * @param fee - V3 费率档位（仅 V3 时使用）
- * @returns 等值的 ERC20 代币数量（wei），失败返回 0n
- */
-export async function getNativeToTokenQuote(provider, tokenAddress, nativeAmount, chain, version = 'v2', fee) {
-    if (nativeAmount <= 0n)
-        return 0n;
-    const chainUpper = chain.toUpperCase();
-    const config = QUOTE_CONFIG[chainUpper];
-    if (!config) {
-        console.warn(`[getNativeToTokenQuote] 不支持的链: ${chain}`);
-        return 0n;
-    }
-    const tokenLower = tokenAddress.toLowerCase();
-    const wrappedNativeLower = config.wrappedNative.toLowerCase();
-    // 如果代币本身就是包装原生代币，直接返回
-    if (tokenLower === wrappedNativeLower) {
-        return nativeAmount;
-    }
-    const result = await quote({
-        provider,
-        tokenIn: config.wrappedNative,
-        tokenOut: tokenAddress,
-        amountIn: nativeAmount,
-        chain,
-        version,
-        fee
-    });
-    return result.amountOut;
-}
-// ============================================================================
-// 工具函数
-// ============================================================================
-/**
- * 获取链的包装原生代币地址
- */
-export function getWrappedNativeAddress(chain) {
-    const chainUpper = chain.toUpperCase();
-    const config = QUOTE_CONFIG[chainUpper];
-    return config?.wrappedNative || '';
-}
-/**
- * 获取链的稳定币列表
- */
-export function getStableCoins(chain) {
-    const chainUpper = chain.toUpperCase();
-    const config = QUOTE_CONFIG[chainUpper];
-    return config?.stableCoins ? [...config.stableCoins] : [];
-}