four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/lp-inspect/inspect.js

@@ -0,0 +1,332 @@
+/**
+ * lp-inspect — 检查主函数（inspect）
+ *
+ * inspectTokenLP 主查询流程。V2/V3 批量查询、fallback、平台判断与格式化工具
+ * 已抽取到 inspect-helpers.ts（内部 helper，不对外暴露）。
+ */
+import { Contract, formatEther } from 'ethers';
+import { ADDRESSES, ZERO_ADDRESS } from '../../core/constants/index.js';
+import { Helper3 } from '../four/contracts/helper3.js';
+import { FlapPortal } from '../flap/portal.js';
+import { DEFAULT_V3_FEE_TIERS } from './lp-inspect-helpers.js';
+import { getChainConfig } from './registry.js';
+import { determinePlatform, formatBalance, getProvider, getTokenDecimals, normalizeLiquidity, queryV2Pairs, queryV3Pools, } from './inspect-helpers.js';
+// ============================================================================
+// 常量（从公共模块导入）
+// ============================================================================
+const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
+// ============================================================================
+// 主查询函数
+// ============================================================================
+export async function inspectTokenLP(token, opts) {
+    const provider = getProvider(opts.rpcUrl);
+    const shouldFormat = opts.formatBalances !== false;
+    const multicall3 = opts.multicall3 || MULTICALL3_ADDRESS;
+    const v3FeeTiers = opts.v3FeeTiers || DEFAULT_V3_FEE_TIERS;
+    // 初始化返回结构
+    const result = {
+        platform: 'UNKNOWN',
+        allPools: [],
+        bestPools: [],
+    };
+    // 获取链配置
+    let chainConfig = getChainConfig(opts.chain);
+    if (!chainConfig) {
+        return result;
+    }
+    // 应用自定义配置
+    if (opts.customDexConfig) {
+        chainConfig = { ...chainConfig, ...opts.customDexConfig };
+    }
+    // 查询代币精度和总供应量
+    let tokenDecimals;
+    let totalSupplyRaw;
+    try {
+        const tokenContract = new Contract(token, ['function decimals() view returns (uint8)', 'function totalSupply() view returns (uint256)'], provider);
+        const [decimals, supply] = await Promise.all([
+            tokenContract.decimals().catch(() => 18),
+            tokenContract.totalSupply().catch(() => undefined),
+        ]);
+        tokenDecimals = Number(decimals);
+        totalSupplyRaw = supply ? BigInt(supply) : undefined;
+        result.decimals = tokenDecimals;
+        if (totalSupplyRaw !== undefined) {
+            result.totalSupplyRaw = totalSupplyRaw;
+            result.totalSupply = formatBalance(totalSupplyRaw, shouldFormat, tokenDecimals);
+        }
+    }
+    catch {
+        tokenDecimals = 18;
+    }
+    // ========================================
+    // 1. 内盘检测：Flap
+    // ========================================
+    if (opts.flapChain) {
+        try {
+            const flap = new FlapPortal({ chain: opts.flapChain, rpcUrl: opts.rpcUrl });
+            // ✅ 优先尝试 getTokenV7（包含 taxRate），失败则 fallback 到 getTokenV5
+            let st = null;
+            let taxRate;
+            try {
+                const stV7 = await flap.getTokenV7(token);
+                st = stV7;
+                taxRate = Number(stV7.taxRate ?? 0n);
+            }
+            catch {
+                st = await flap.getTokenV5(token);
+            }
+            if (st && st.status !== undefined && Number(st.status) !== 4) {
+                result.platform = 'FLAP';
+                let quoteDecimals = 18;
+                let quoteSymbol = chainConfig.wrappedNativeSymbol;
+                const quoteTokenAddress = st.quoteTokenAddress;
+                if (quoteTokenAddress && quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS) {
+                    quoteDecimals = await getTokenDecimals(quoteTokenAddress, provider);
+                    const stableCoin = chainConfig.stableCoins.find((c) => c.address.toLowerCase() === quoteTokenAddress.toLowerCase());
+                    quoteSymbol = stableCoin?.symbol || 'TOKEN';
+                }
+                result.flap = {
+                    quoteToken: quoteTokenAddress,
+                    quoteSymbol,
+                    quoteDecimals,
+                    reserveNative: formatBalance(st.reserve, shouldFormat, quoteDecimals),
+                    circulatingSupply: formatBalance(st.circulatingSupply, shouldFormat, tokenDecimals ?? 18),
+                    price: formatBalance(st.price, shouldFormat),
+                    taxRate, // ✅ 包含税率
+                };
+                // ✅ 同时设置顶层税率，方便统一读取
+                if (taxRate && taxRate > 0) {
+                    result.taxRate = taxRate;
+                }
+                return result;
+            }
+        }
+        catch {
+            // Flap 检测失败，继续其他平台检测
+        }
+    }
+    // ========================================
+    // 1b. 内盘检测：DAOaaS Portal（ENI 链）
+    // ========================================
+    if (opts.chain === 'ENI') {
+        try {
+            const portalAddress = ADDRESSES.ENI.DaoaasPortal;
+            const portalAbi = [
+                'function getTokenState(address token) view returns (uint256)',
+                'function getPrice(address token) view returns (uint256)',
+                'function getOKAmountBySale(address token, uint256 tokenAmount) view returns (uint256)',
+            ];
+            const portal = new Contract(portalAddress, portalAbi, provider);
+            const status = Number(await portal.getTokenState(token));
+            // status: 0=不存在, 1=交易中(内盘), 2=已毕业(外盘)
+            if (status === 1) {
+                result.platform = 'DAOAAS';
+                const price = (await portal.getPrice(token));
+                const tokenContract = new Contract(token, ['function totalSupply() view returns (uint256)', 'function balanceOf(address) view returns (uint256)'], provider);
+                const [totalSupply, portalTokenBalance] = await Promise.all([
+                    tokenContract.totalSupply(),
+                    tokenContract.balanceOf(portalAddress),
+                ]);
+                const circulatingSupply = totalSupply - portalTokenBalance;
+                let reserveNative = '0';
+                try {
+                    if (circulatingSupply > 0n) {
+                        const saleValue = (await portal.getOKAmountBySale(token, circulatingSupply));
+                        reserveNative = formatBalance(saleValue, shouldFormat, 18);
+                    }
+                }
+                catch {
+                    try {
+                        const egasBalance = await provider.getBalance(portalAddress);
+                        reserveNative = formatBalance(egasBalance, shouldFormat, 18);
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+                result.daoaas = {
+                    quoteToken: ZERO_ADDRESS,
+                    quoteSymbol: 'EGAS',
+                    quoteDecimals: 18,
+                    reserveNative,
+                    circulatingSupply: formatBalance(circulatingSupply, shouldFormat, tokenDecimals ?? 18),
+                    price: formatEther(price),
+                    status,
+                };
+                return result;
+            }
+            // status === 2 (Graduated): 已毕业到 DSWAP V2，继续走外盘检测
+        }
+        catch {
+            // DAOaaS Portal 检测失败，继续其他平台检测
+        }
+    }
+    // ========================================
+    // 2. 内盘检测：Four.meme（仅 BSC）
+    // ========================================
+    if (opts.chain === 'BSC') {
+        try {
+            const helper = Helper3.connectByChain('BSC', opts.rpcUrl);
+            const info = await helper.getTokenInfo(token);
+            const tokenManager = info.tokenManager;
+            const versionNum = Number(info.version);
+            const liquidityAdded = info.liquidityAdded;
+            const isValid = tokenManager && tokenManager !== ZERO_ADDRESS && (versionNum === 1 || versionNum === 2);
+            if (isValid && !liquidityAdded) {
+                result.platform = 'FOUR';
+                const reserveNative = formatBalance(info.funds, shouldFormat);
+                const offerTokens = formatBalance(info.offers, shouldFormat);
+                const lastPrice = formatBalance(info.lastPrice, shouldFormat);
+                result.four = { helper: ADDRESSES.BSC.TokenManagerHelper3, reserveNative, offerTokens, lastPrice };
+                return result;
+            }
+        }
+        catch {
+            // Four.meme 检测失败，继续外盘检测
+        }
+    }
+    // ========================================
+    // 3. 外盘检测：多 DEX 批量查询
+    // ========================================
+    const enabledDexes = Object.entries(chainConfig.dexes).filter(([_, dex]) => dex.enabled);
+    // 构建报价代币列表
+    const quoteTokens = [
+        { address: chainConfig.wrappedNative, symbol: chainConfig.wrappedNativeSymbol, decimals: 18 },
+        ...chainConfig.stableCoins,
+    ];
+    // 所有最佳池子候选
+    const allBestPoolCandidates = [];
+    // 并行查询所有 DEX
+    const dexPromises = enabledDexes.map(async ([dexKey, dexConfig]) => {
+        const dexPoolInfo = {
+            dexName: dexConfig.name,
+            dexKey,
+            v2Pairs: [],
+            v3Pools: [],
+        };
+        // V2 查询
+        if (dexConfig.v2Factory) {
+            try {
+                const v2Pairs = await queryV2Pairs(token, dexConfig.v2Factory, quoteTokens, provider, multicall3, tokenDecimals ?? 18, shouldFormat);
+                dexPoolInfo.v2Pairs = v2Pairs;
+                // 添加到最佳池子候选
+                for (const pair of v2Pairs) {
+                    if (pair.reserveQuoteRaw && pair.reserveQuoteRaw > 0n) {
+                        allBestPoolCandidates.push({
+                            dex: dexConfig.name,
+                            dexKey,
+                            version: 'v2',
+                            quoteToken: pair.quoteToken,
+                            quoteSymbol: pair.quoteSymbol,
+                            quoteDecimals: pair.quoteDecimals,
+                            pairAddress: pair.pairAddress,
+                            liquidity: pair.reserveQuote,
+                            liquidityRaw: normalizeLiquidity(pair.reserveQuoteRaw, pair.quoteDecimals),
+                            reserveToken: pair.reserveToken, // ✅ 新增
+                            reserveTokenRaw: pair.reserveTokenRaw, // ✅ 新增
+                        });
+                    }
+                }
+            }
+            catch {
+                // 单个 DEX V2 查询失败，继续其他 DEX
+            }
+        }
+        // V3 查询
+        if (dexConfig.v3Factory) {
+            try {
+                const v3Pools = await queryV3Pools(token, dexConfig.v3Factory, quoteTokens, v3FeeTiers, provider, multicall3, tokenDecimals ?? 18, shouldFormat);
+                dexPoolInfo.v3Pools = v3Pools;
+                // 添加到最佳池子候选
+                for (const pool of v3Pools) {
+                    if (pool.reserveQuoteRaw && pool.reserveQuoteRaw > 0n) {
+                        allBestPoolCandidates.push({
+                            dex: dexConfig.name,
+                            dexKey,
+                            version: 'v3',
+                            fee: pool.fee,
+                            quoteToken: pool.quoteToken,
+                            quoteSymbol: pool.quoteSymbol,
+                            quoteDecimals: pool.quoteDecimals,
+                            pairAddress: pool.pairAddress,
+                            liquidity: pool.reserveQuote,
+                            liquidityRaw: normalizeLiquidity(pool.reserveQuoteRaw, pool.quoteDecimals),
+                            reserveToken: pool.reserveToken, // ✅ 新增
+                            reserveTokenRaw: pool.reserveTokenRaw, // ✅ 新增
+                        });
+                    }
+                }
+            }
+            catch {
+                // 单个 DEX V3 查询失败，继续其他 DEX
+            }
+        }
+        return dexPoolInfo;
+    });
+    // 等待所有 DEX 查询完成
+    const dexResults = await Promise.all(dexPromises);
+    // 过滤出有流动性的 DEX
+    result.allPools = dexResults.filter((dex) => dex.v2Pairs.length > 0 || dex.v3Pools.length > 0);
+    // 按流动性排序最佳池子，并计算 poolRatio
+    result.bestPools = allBestPoolCandidates
+        .sort((a, b) => {
+        // 降序排列
+        if (b.liquidityRaw > a.liquidityRaw)
+            return 1;
+        if (b.liquidityRaw < a.liquidityRaw)
+            return -1;
+        return 0;
+    })
+        .slice(0, 10) // 最多返回 10 个
+        .map((pool) => {
+        // ✅ 计算池子代币占比
+        if (pool.reserveTokenRaw && totalSupplyRaw && totalSupplyRaw > 0n) {
+            // 计算百分比：(reserveTokenRaw / totalSupplyRaw) * 100
+            // 为了保持精度，先乘以 10000，再除以 totalSupply，得到万分比
+            const ratioBps = (pool.reserveTokenRaw * 10000n) / totalSupplyRaw;
+            const ratioPercent = Number(ratioBps) / 100; // 转为百分比
+            pool.poolRatio = `${ratioPercent.toFixed(2)}%`;
+        }
+        return pool;
+    });
+    // ✅ 同时为 allPools 中的每个池子计算 poolRatio
+    if (totalSupplyRaw && totalSupplyRaw > 0n) {
+        for (const dexPool of result.allPools) {
+            for (const pair of dexPool.v2Pairs) {
+                if (pair.reserveTokenRaw) {
+                    const ratioBps = (pair.reserveTokenRaw * 10000n) / totalSupplyRaw;
+                    const ratioPercent = Number(ratioBps) / 100;
+                    pair.poolRatio = `${ratioPercent.toFixed(2)}%`;
+                }
+            }
+            for (const pool of dexPool.v3Pools) {
+                if (pool.reserveTokenRaw) {
+                    const ratioBps = (pool.reserveTokenRaw * 10000n) / totalSupplyRaw;
+                    const ratioPercent = Number(ratioBps) / 100;
+                    pool.poolRatio = `${ratioPercent.toFixed(2)}%`;
+                }
+            }
+        }
+    }
+    // 确定平台类型
+    result.platform = determinePlatform(result.allPools);
+    // ========================================
+    // 4. 外盘税率查询（仅 Flap 链）
+    // ========================================
+    // 对于已毕业到外盘的代币，尝试从 Flap Portal 获取税率
+    if (opts.flapChain && !result.flap && result.platform !== 'UNKNOWN') {
+        try {
+            const flap = new FlapPortal({ chain: opts.flapChain, rpcUrl: opts.rpcUrl });
+            const stV7 = await flap.getTokenV7(token);
+            // taxRate 是 bigint，需要转换为 number
+            const taxRate = Number(stV7.taxRate ?? 0n);
+            if (taxRate > 0) {
+                result.taxRate = taxRate;
+            }
+        }
+        catch {
+            // V7 不支持或代币不是 Flap 创建的，忽略
+        }
+    }
+    return result;
+}

package/dist/domains/lp-inspect/lp-inspect.d.ts

@@ -1,40 +1,12 @@
-import type { ChainDexConfig, DexConfig, InspectOptions, LPInfo } from './types.js';
-export declare function getFactoryFromRouter(routerAddress: string, rpcUrl: string, routerType?: 'v2' | 'v3'): Promise<{
-    v2Factory?: string;
-    v3Factory?: string;
-}>;
 /**
- * 动态注册 DYORSwap（从 Router 获取 Factory）
+ * lp-inspect barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - registry.ts：DEX/稳定币注册表、链配置、报价代币列表
+ * - inspect.ts：inspectTokenLP 主查询流程 + V2/V3 批量查询
+ *
+ * 对外 export 符号与路径保持不变。
  */
-export declare function registerDYORSwap(rpcUrl: string): Promise<boolean>;
-/** 注册新的 DEX */
-export declare function registerDex(chain: string, dexKey: string, config: DexConfig): void;
-/** 注册新的稳定币 */
-export declare function registerStableCoin(chain: string, coin: {
-    address: string;
-    symbol: string;
-    decimals: number;
-}): void;
-/** 获取链配置（优先运行时配置） */
-export declare function getChainConfig(chain: string): ChainDexConfig | undefined;
-/** 获取支持的 DEX 列表 */
-export declare function getSupportedDexes(chain: string): Array<{
-    key: string;
-    name: string;
-    enabled: boolean;
-}>;
-/** 获取支持的稳定币列表 */
-export declare function getSupportedStableCoins(chain: string): Array<{
-    address: string;
-    symbol: string;
-    decimals: number;
-}>;
-/** 获取所有报价代币（包装原生 + 稳定币） */
-export declare function getQuoteTokens(chain: string): Array<{
-    address: string;
-    symbol: string;
-    decimals: number;
-    isNative: boolean;
-}>;
-export declare function inspectTokenLP(token: string, opts: InspectOptions): Promise<LPInfo>;
+export * from './registry.js';
+export * from './inspect.js';
 export type { LPInfo, LPPlatform, InspectOptions, DexConfig, ChainDexConfig } from './types.js';