four-flap-meme-sdk 1.4.11 → 1.4.13

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

@@ -0,0 +1,111 @@
+/**
+ * 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: "";
+        readonly wrappedNative: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+        readonly stableCoins: readonly ["0x1E4a5963aBFD975d8c9021ce480b42188849D41d"];
+    };
+};
+export type SupportedChain = keyof typeof QUOTE_CONFIG;
+export interface QuoteParams {
+    provider: JsonRpcProvider;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: bigint;
+    chain: string;
+    version?: 'v2' | 'v3';
+    fee?: number;
+}
+export interface QuoteResult {
+    amountOut: bigint;
+    path?: string[];
+    fee?: number;
+}
+/**
+ * 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): 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 时使用）
+ * @returns 等值的原生代币数量（wei），失败返回 0n
+ */
+export declare function getTokenToNativeQuote(provider: JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, chain: string, version?: 'v2' | 'v3', fee?: number): 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.js

@@ -0,0 +1,358 @@
+/**
+ * V2/V3 报价工具函数
+ *
+ * 提供统一的代币报价功能，支持：
+ * - V2 Router 报价（直接路径 + 多跳路径）
+ * - V3 Quoter 报价（多费率尝试 + 多跳路径）
+ * - ERC20 → 原生代币转换报价
+ */
+import { ethers, Contract } from 'ethers';
+// ============================================================================
+// 常量配置
+// ============================================================================
+/** V2 Router ABI（用于报价） */
+const V2_ROUTER_ABI = [
+    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)'
+];
+/** V3 QuoterV2 ABI（用于报价）- 使用结构体参数 */
+const V3_QUOTER_ABI = [
+    {
+        "inputs": [{
+                "components": [
+                    { "name": "tokenIn", "type": "address" },
+                    { "name": "tokenOut", "type": "address" },
+                    { "name": "amountIn", "type": "uint256" },
+                    { "name": "fee", "type": "uint24" },
+                    { "name": "sqrtPriceLimitX96", "type": "uint160" }
+                ],
+                "name": "params",
+                "type": "tuple"
+            }],
+        "name": "quoteExactInputSingle",
+        "outputs": [
+            { "name": "amountOut", "type": "uint256" },
+            { "name": "sqrtPriceX96After", "type": "uint160" },
+            { "name": "initializedTicksCrossed", "type": "uint32" },
+            { "name": "gasEstimate", "type": "uint256" }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    }
+];
+/** 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: '', // TODO: 添加 XLayer V3 Quoter
+        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b', // WOKB
+        stableCoins: [
+            '0x1E4a5963aBFD975d8c9021ce480b42188849D41d', // USDT
+        ],
+    },
+};
+// ============================================================================
+// V2 报价
+// ============================================================================
+/**
+ * V2 报价（直接路径 + 多跳路径）
+ * ✅ 优化：并行尝试直接路径和多跳路径
+ *
+ * @param provider - Provider 实例
+ * @param tokenIn - 输入代币地址
+ * @param tokenOut - 输出代币地址
+ * @param amountIn - 输入数量（wei）
+ * @param chain - 链名称
+ * @returns 报价结果
+ */
+export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain) {
+    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 router = new Contract(config.v2Router, 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 } = params;
+    if (version === 'v3') {
+        return quoteV3(provider, tokenIn, tokenOut, amountIn, chain, fee);
+    }
+    return quoteV2(provider, tokenIn, tokenOut, amountIn, chain);
+}
+// ============================================================================
+// 代币 → 原生代币报价
+// ============================================================================
+/**
+ * 获取 ERC20 代币 → 原生代币（WBNB/WMON 等）的报价
+ *
+ * @param provider - Provider 实例
+ * @param tokenAddress - ERC20 代币地址
+ * @param tokenAmount - 代币数量（wei）
+ * @param chain - 链名称
+ * @param version - 'v2' | 'v3'
+ * @param fee - V3 费率档位（仅 V3 时使用）
+ * @returns 等值的原生代币数量（wei），失败返回 0n
+ */
+export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chain, version = 'v2', fee) {
+    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
+    });
+    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] : [];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.4.11",
+  "version": "1.4.13",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",