four-flap-meme-sdk 2.2.13 → 2.2.15

package/dist/index.d.ts

@@ -15,7 +15,7 @@ export { TM2, type FourChainV2 } from './contracts/tm2.js';
 export { Helper3, Helper3Writer } from './contracts/helper3.js';
 export { CDPV2 } from './shared/flap/curve.js';
 export { FlapPortal, FlapPortalWriter, type FlapChain, type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type TokenStateV7, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, type NewTokenV4Params, type NewTokenV5Params, type TaxDistributionConfig, validateTaxDistribution, TokenStatus, TokenVersion, FeeType, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId } from './shared/flap/portal.js';
-export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, PCS_INFINITY_CL_POOL_MANAGER_BSC, FLAP_INFINITY_HOOKS_BSC, type GraduatedDexMetrics, type InfinityPoolKey, } from './shared/flap/graduated-dex.js';
+export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, PCS_INFINITY_CL_POOL_MANAGER_BSC, PCS_INFINITY_VAULT_BSC, FLAP_INFINITY_HOOKS_BSC, type GraduatedDexMetrics, type InfinityPoolKey, } from './shared/flap/graduated-dex.js';
 export { uploadTokenMeta, type TokenMetaInput } from './shared/flap/ipfs.js';
 export { buildPermitPiggybackAuto } from './shared/flap/permit.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './shared/flap/vanity.js';

package/dist/index.js

@@ -48,7 +48,7 @@ export { TM2 } from './contracts/tm2.js';
 export { Helper3, Helper3Writer } from './contracts/helper3.js';
 export { CDPV2 } from './shared/flap/curve.js';
 export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, TokenVersion, FeeType, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId } from './shared/flap/portal.js';
-export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, PCS_INFINITY_CL_POOL_MANAGER_BSC, FLAP_INFINITY_HOOKS_BSC, } from './shared/flap/graduated-dex.js';
+export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, PCS_INFINITY_CL_POOL_MANAGER_BSC, PCS_INFINITY_VAULT_BSC, FLAP_INFINITY_HOOKS_BSC, } from './shared/flap/graduated-dex.js';
 export { uploadTokenMeta } from './shared/flap/ipfs.js';
 export { buildPermitPiggybackAuto } from './shared/flap/permit.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './shared/flap/vanity.js';

package/dist/shared/flap/graduated-dex.d.ts

@@ -1 +1 @@
-export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, PCS_INFINITY_CL_POOL_MANAGER_BSC, FLAP_INFINITY_HOOKS_BSC, type GraduatedDexMetrics, type InfinityPoolKey, } from '../../utils/pcs-infinity-cl.js';
+export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, PCS_INFINITY_CL_POOL_MANAGER_BSC, PCS_INFINITY_VAULT_BSC, FLAP_INFINITY_HOOKS_BSC, type GraduatedDexMetrics, type InfinityPoolKey, } from '../../utils/pcs-infinity-cl.js';

package/dist/shared/flap/graduated-dex.js

@@ -1 +1 @@
-export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, PCS_INFINITY_CL_POOL_MANAGER_BSC, FLAP_INFINITY_HOOKS_BSC, } from '../../utils/pcs-infinity-cl.js';
+export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, PCS_INFINITY_CL_POOL_MANAGER_BSC, PCS_INFINITY_VAULT_BSC, FLAP_INFINITY_HOOKS_BSC, } from '../../utils/pcs-infinity-cl.js';

package/dist/utils/lp-inspect.js

@@ -3,7 +3,7 @@ import { ADDRESSES, ZERO_ADDRESS } from './constants.js';
 import { MULTICALL3_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, ERC20_ABI } from '../shared/abis/common.js';
 import { Helper3 } from '../contracts/helper3.js';
 import { FlapPortal } from '../shared/flap/portal.js';
-import { getFlapGraduatedDexMetrics, PCS_INFINITY_CL_POOL_MANAGER_BSC, } from './pcs-infinity-cl.js';
+import { getFlapGraduatedDexMetrics, PCS_INFINITY_CL_POOL_MANAGER_BSC, isFlapInfinityCLGraduated, } from './pcs-infinity-cl.js';
 // ============================================================================
 // 链配置
 // ============================================================================
@@ -363,7 +363,7 @@ export async function inspectTokenLP(token, opts) {
             }
             if (st && st.status !== undefined) {
                 const status = Number(st.status);
-                // ✅ 已毕业：PCS Infinity CL 外盘（Portal pool 字段为 CLPoolManager）
+                // ✅ 已毕业：按池类型分流（Infinity CL / Pancake V3 pair / 继续扫外盘）
                 if (status === 4) {
                     const quoteAddr = st.quoteTokenAddress && st.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS
                         ? st.quoteTokenAddress
@@ -381,40 +381,51 @@ export async function inspectTokenLP(token, opts) {
                         state: st,
                         rpcUrl: opts.rpcUrl,
                         wrappedNativeAddress: chainConfig.wrappedNative,
+                        chain: opts.chain,
                     });
-                    result.platform = 'FLAP';
-                    result.flap = {
-                        quoteToken: quoteAddr,
-                        quoteSymbol,
-                        quoteDecimals,
-                        reserveNative: metrics.poolBNBAmount,
-                        circulatingSupply: formatBalance(st.circulatingSupply, shouldFormat, tokenDecimals ?? 18),
-                        price: metrics.price,
-                        taxRate,
-                    };
-                    if (taxRate && taxRate > 0)
-                        result.taxRate = taxRate;
-                    const liqRaw = metrics.poolBNBAmount
-                        ? BigInt(Math.floor(parseFloat(metrics.poolBNBAmount) * 1e18))
-                        : 0n;
-                    const tokRaw = metrics.poolTokenAmount
-                        ? BigInt(Math.floor(parseFloat(metrics.poolTokenAmount) * 1e18))
-                        : 0n;
-                    result.bestPools.push({
-                        dex: 'PancakeSwap Infinity CL',
-                        dexKey: 'PCS_INFINITY_CL',
-                        version: 'v3',
-                        fee: metrics.infinityFee,
-                        quoteToken: quoteAddr,
-                        quoteSymbol,
-                        quoteDecimals,
-                        pairAddress: metrics.poolId ?? PCS_INFINITY_CL_POOL_MANAGER_BSC,
-                        liquidity: metrics.poolBNBAmount,
-                        liquidityRaw: liqRaw,
-                        reserveToken: metrics.poolTokenAmount,
-                        reserveTokenRaw: tokRaw,
-                    });
-                    return result;
+                    const hasMetrics = (metrics.price && metrics.price !== '0') ||
+                        parseFloat(metrics.poolBNBAmount || '0') > 0;
+                    if (hasMetrics) {
+                        result.platform = 'FLAP';
+                        result.flap = {
+                            quoteToken: quoteAddr,
+                            quoteSymbol,
+                            quoteDecimals,
+                            reserveNative: metrics.poolBNBAmount,
+                            circulatingSupply: formatBalance(st.circulatingSupply, shouldFormat, tokenDecimals ?? 18),
+                            price: metrics.price,
+                            taxRate,
+                        };
+                        if (taxRate && taxRate > 0)
+                            result.taxRate = taxRate;
+                        const liqRaw = metrics.poolBNBAmount
+                            ? BigInt(Math.floor(parseFloat(metrics.poolBNBAmount) * 1e18))
+                            : 0n;
+                        const tokRaw = metrics.poolTokenAmount
+                            ? BigInt(Math.floor(parseFloat(metrics.poolTokenAmount) * 1e18))
+                            : 0n;
+                        const isInfinity = isFlapInfinityCLGraduated(st, opts.chain);
+                        result.bestPools.push({
+                            dex: isInfinity ? 'PancakeSwap Infinity CL' : 'PancakeSwap V3',
+                            dexKey: isInfinity ? 'PCS_INFINITY_CL' : 'PANCAKESWAP_V3',
+                            version: 'v3',
+                            fee: metrics.infinityFee,
+                            quoteToken: quoteAddr,
+                            quoteSymbol,
+                            quoteDecimals,
+                            pairAddress: isInfinity
+                                ? (metrics.poolId ?? PCS_INFINITY_CL_POOL_MANAGER_BSC)
+                                : (st.pool || ''),
+                            liquidity: metrics.poolBNBAmount,
+                            liquidityRaw: liqRaw,
+                            reserveToken: metrics.poolTokenAmount,
+                            reserveTokenRaw: tokRaw,
+                        });
+                        return result;
+                    }
+                    if (opts.debug) {
+                        console.log('[LP Inspect] Flap graduated metrics empty, fallback to DEX scan');
+                    }
                 }
                 result.platform = 'FLAP';
                 let quoteDecimals = 18;

package/dist/utils/pcs-infinity-cl.d.ts

@@ -2,6 +2,8 @@ import type { FlapPortal } from '../shared/flap/portal.js';
 import type { TokenStateV7 } from '../shared/flap/portal.js';
 /** PancakeSwap Infinity CL PoolManager（BSC / Base 同址） */
 export declare const PCS_INFINITY_CL_POOL_MANAGER_BSC = "0xa0FfB9c1CE1Fe56963B0321B32E7A0302114058b";
+/** PancakeSwap Infinity Vault（全池代币记账；BSC / Base 同址） */
+export declare const PCS_INFINITY_VAULT_BSC = "0x238a358808379702088667322f80aC48bAd5e6c4";
 /** Flap Portal 毕业到 Infinity CL 时使用的 hooks（BSC） */
 export declare const FLAP_INFINITY_HOOKS_BSC = "0xF1A9aA042454b8553bE3896597ff11a0f011c1c1";
 export type InfinityPoolKey = {
@@ -12,6 +14,15 @@ export type InfinityPoolKey = {
     fee: number;
     parameters: string;
 };
+export type GraduatedDexMetrics = {
+    price: string;
+    progress: string;
+    poolBNBAmount: string;
+    poolTokenAmount: string;
+    poolId?: string;
+    infinityFee?: number;
+    dexKind?: 'PCS_INFINITY_CL' | 'PANCAKE_V3' | 'PORTAL_QUOTE';
+};
 export declare function sortInfinityCurrencies(a: string, b: string): [string, string];
 export declare function computeInfinityPoolId(key: InfinityPoolKey): string;
 export declare function buildFlapInfinityPoolKey(params: {
@@ -20,7 +31,15 @@ export declare function buildFlapInfinityPoolKey(params: {
     chain: string;
     lpFeeProfile?: number;
 }): InfinityPoolKey | null;
-/** 由 slot0 计算 quote per token（与 memeweb V3 spot 公式一致） */
+/** 判断 getTokenV7.pool 是否为 Infinity CL PoolManager（而非 V3 pair） */
+export declare function isInfinityCLPoolManagerAddress(pool: string, chain: string): boolean;
+/** 仅 V7 + Infinity CL 才走 Infinity 专用逻辑 */
+export declare function isFlapInfinityCLGraduated(state: {
+    pool?: string;
+    tokenVersion?: bigint | number;
+}, chain: string): boolean;
+/** Portal quoteExactInput：链上 quoteToken 为 0 时必须用 native(0)，不能用 WBNB */
+export declare function resolvePortalQuoteInputToken(quoteTokenAddress: string, wrappedNativeAddress: string): string;
 export declare function infinitySpotPriceQuotePerToken(params: {
     sqrtPriceX96: bigint;
     tokenAddress: string;
@@ -30,26 +49,11 @@ export declare function infinitySpotPriceQuotePerToken(params: {
     tokenDecimals?: number;
     quoteDecimals?: number;
 }): string | null;
-/** 用活跃流动性 L 与 sqrtPrice 估算两侧虚拟储备（UI 展示用） */
-export declare function estimateInfinityReserves(params: {
-    liquidity: bigint;
-    sqrtPriceX96: bigint;
-    tokenIsCurrency0: boolean;
-}): {
-    reserveToken: string;
-    reserveQuote: string;
-};
-export type GraduatedDexMetrics = {
-    price: string;
-    progress: string;
-    poolBNBAmount: string;
-    poolTokenAmount: string;
-    poolId?: string;
-    infinityFee?: number;
-};
 /**
- * Flap 毕业后（status=4）外盘：PCS Infinity CL + Portal quote
- * getTokenV7().pool 在 V7 标准币上为 CLPoolManager 合约地址，非 V3 pair。
+ * Flap 毕业后（status=4）外盘统一入口：
+ * - V7 / Infinity CL → Infinity + Portal quote 深度
+ * - 旧版 V3/V2（pool 为 pair 地址）→ 读 pair 余额 + slot0
+ * - 否则仅 Portal quote
  */
 export declare function getFlapGraduatedDexMetrics(params: {
     portal: FlapPortal;
@@ -57,6 +61,5 @@ export declare function getFlapGraduatedDexMetrics(params: {
     state: TokenStateV7;
     rpcUrl: string;
     wrappedNativeAddress?: string;
+    chain?: string;
 }): Promise<GraduatedDexMetrics>;
-/** 判断 getTokenV7.pool 是否为 Infinity CL PoolManager（而非 V3 pair） */
-export declare function isInfinityCLPoolManagerAddress(pool: string, chain: string): boolean;

package/dist/utils/pcs-infinity-cl.js

@@ -1,13 +1,21 @@
 import { AbiCoder, Contract, JsonRpcProvider, formatEther, formatUnits, keccak256 } from 'ethers';
-import { FLAP_TOTAL_SUPPLY, ZERO_ADDRESS } from '../shared/flap/constants.js';
+import { ZERO_ADDRESS } from '../shared/flap/constants.js';
+import { ERC20_ABI } from '../shared/abis/common.js';
 /** PancakeSwap Infinity CL PoolManager（BSC / Base 同址） */
 export const PCS_INFINITY_CL_POOL_MANAGER_BSC = '0xa0FfB9c1CE1Fe56963B0321B32E7A0302114058b';
+/** PancakeSwap Infinity Vault（全池代币记账；BSC / Base 同址） */
+export const PCS_INFINITY_VAULT_BSC = '0x238a358808379702088667322f80aC48bAd5e6c4';
 /** Flap Portal 毕业到 Infinity CL 时使用的 hooks（BSC） */
 export const FLAP_INFINITY_HOOKS_BSC = '0xF1A9aA042454b8553bE3896597ff11a0f011c1c1';
 const CL_POOL_MANAGER_ABI = [
     'function getSlot0(bytes32 id) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',
     'function getLiquidity(bytes32 id) view returns (uint128 liquidity)',
 ];
+const V3_PAIR_ABI = [
+    'function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16 observationIndex,uint16 observationCardinality,uint16 observationCardinalityNext,uint8 feeProtocol,bool unlocked)',
+    'function token0() view returns (address)',
+    'function token1() view returns (address)',
+];
 /** BSC：lpFeeProfile → Infinity PoolKey 的 fee / parameters（与链上 Initialize 一致） */
 const BSC_INFINITY_POOL_KEY_BY_PROFILE = {
     0: {
@@ -31,7 +39,7 @@ export function buildFlapInfinityPoolKey(params) {
     const quote = params.quoteTokenAddress &&
         params.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS
         ? params.quoteTokenAddress
-        : '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c'; // WBNB
+        : '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
     const [currency0, currency1] = sortInfinityCurrencies(params.tokenAddress, quote);
     return {
         currency0,
@@ -42,6 +50,32 @@ export function buildFlapInfinityPoolKey(params) {
         parameters: meta.parameters,
     };
 }
+/** 判断 getTokenV7.pool 是否为 Infinity CL PoolManager（而非 V3 pair） */
+export function isInfinityCLPoolManagerAddress(pool, chain) {
+    if (!pool)
+        return false;
+    const c = String(chain || '').toUpperCase();
+    if (c === 'BSC' || c === 'BASE') {
+        return pool.toLowerCase() === PCS_INFINITY_CL_POOL_MANAGER_BSC.toLowerCase();
+    }
+    return false;
+}
+/** 仅 V7 + Infinity CL 才走 Infinity 专用逻辑 */
+export function isFlapInfinityCLGraduated(state, chain) {
+    if (isInfinityCLPoolManagerAddress(state.pool ?? '', chain))
+        return true;
+    return Number(state.tokenVersion ?? 0) === 7;
+}
+/** Portal quoteExactInput：链上 quoteToken 为 0 时必须用 native(0)，不能用 WBNB */
+export function resolvePortalQuoteInputToken(quoteTokenAddress, wrappedNativeAddress) {
+    if (!quoteTokenAddress || quoteTokenAddress.toLowerCase() === ZERO_ADDRESS) {
+        return ZERO_ADDRESS;
+    }
+    if (quoteTokenAddress.toLowerCase() === wrappedNativeAddress.toLowerCase()) {
+        return ZERO_ADDRESS;
+    }
+    return quoteTokenAddress;
+}
 function formatRatio(n, d, precision = 18) {
     if (d === 0n)
         return '0';
@@ -52,7 +86,6 @@ function formatRatio(n, d, precision = 18) {
     const frac = s.slice(-precision).replace(/0+$/, '');
     return frac ? `${int}.${frac}` : int;
 }
-/** 由 slot0 计算 quote per token（与 memeweb V3 spot 公式一致） */
 export function infinitySpotPriceQuotePerToken(params) {
     const tokenLower = params.tokenAddress.toLowerCase();
     const quoteLower = params.quoteTokenAddress.toLowerCase();
@@ -80,32 +113,58 @@ export function infinitySpotPriceQuotePerToken(params) {
     }
     return formatRatio(n, d, 18);
 }
-/** 用活跃流动性 L 与 sqrtPrice 估算两侧虚拟储备（UI 展示用） */
-export function estimateInfinityReserves(params) {
-    const Q96 = 2n ** 96n;
-    if (params.liquidity === 0n || params.sqrtPriceX96 === 0n) {
-        return { reserveToken: '0', reserveQuote: '0' };
+function v3SpotPriceQuotePerToken(params) {
+    return infinitySpotPriceQuotePerToken({
+        sqrtPriceX96: params.sqrtPriceX96,
+        tokenAddress: params.tokenAddress,
+        currency0: params.token0,
+        currency1: params.token1,
+        quoteTokenAddress: params.quoteTokenAddress,
+    });
+}
+/** Infinity CL：用 quote 估算当前可卖出的 WBNB 深度（贴近 GMGN，勿把探测代币量当池子持仓） */
+async function estimateInfinityPoolQuoteBnbDepth(portal, tokenAddress) {
+    const inputQuote = ZERO_ADDRESS;
+    const probeTokens = [110000000n, 100000000n, 50000000n, 10000000n].map((m) => m * 10n ** 18n);
+    for (const amt of probeTokens) {
+        try {
+            const bnbOut = await portal.quoteExactInput({
+                inputToken: tokenAddress,
+                outputToken: inputQuote,
+                inputAmount: amt,
+            });
+            if (bnbOut > 0n)
+                return formatEther(bnbOut);
+        }
+        catch {
+            /* try smaller */
+        }
     }
-    // float 估算即可满足面板展示
-    const sqrtP = Number(params.sqrtPriceX96) / Number(Q96);
-    const L = Number(params.liquidity);
-    if (!Number.isFinite(sqrtP) || sqrtP <= 0) {
-        return { reserveToken: '0', reserveQuote: '0' };
+    return '0';
+}
+/**
+ * Infinity CL 池内代币量：读 Vault 中该 token 余额（与 GMGN 池子代币列一致）
+ * 注意：Vault 为全协议记账层，对 Flap 毕业主池通常即该交易对持仓。
+ */
+async function getInfinityCLPoolTokenReserve(params) {
+    const chain = String(params.chain || '').toUpperCase();
+    const vault = chain === 'BSC' || chain === 'BASE' ? PCS_INFINITY_VAULT_BSC : '';
+    if (!vault)
+        return '0';
+    try {
+        const provider = new JsonRpcProvider(params.rpcUrl);
+        const bal = (await new Contract(params.tokenAddress, ERC20_ABI, provider).balanceOf(vault));
+        return formatEther(bal);
     }
-    const amount1 = (L * sqrtP) / 1e18;
-    const amount0 = L / sqrtP / 1e18;
-    if (params.tokenIsCurrency0) {
-        return { reserveToken: String(amount0), reserveQuote: String(amount1) };
+    catch {
+        return '0';
     }
-    return { reserveToken: String(amount1), reserveQuote: String(amount0) };
 }
-async function quotePortalPrice(portal, tokenAddress, quoteTokenAddress) {
+async function quotePortalPrice(portal, tokenAddress, quoteTokenAddress, wrappedNativeAddress) {
     try {
-        const buyAmt = 10n ** 16n; // 0.01 native
-        const sellAmt = 10n ** 21n; // 1000 tokens
-        const inputQuote = quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
-            ? ZERO_ADDRESS
-            : quoteTokenAddress;
+        const buyAmt = 10n ** 16n;
+        const sellAmt = 10n ** 21n;
+        const inputQuote = resolvePortalQuoteInputToken(quoteTokenAddress, wrappedNativeAddress);
         const [tokensOut, quoteOut] = await Promise.all([
             portal.quoteExactInput({
                 inputToken: inputQuote,
@@ -116,11 +175,13 @@ async function quotePortalPrice(portal, tokenAddress, quoteTokenAddress) {
                 inputToken: tokenAddress,
                 outputToken: inputQuote,
                 inputAmount: sellAmt,
-            }),
+            }).catch(() => 0n),
         ]);
-        if (tokensOut <= 0n || quoteOut <= 0n)
+        if (tokensOut <= 0n)
             return null;
         const buyPrice = Number(formatEther(buyAmt)) / Number(formatEther(tokensOut));
+        if (quoteOut <= 0n)
+            return String(buyPrice);
         const sellPrice = Number(formatEther(quoteOut)) / Number(formatEther(sellAmt));
         return String((buyPrice + sellPrice) / 2);
     }
@@ -128,31 +189,67 @@ async function quotePortalPrice(portal, tokenAddress, quoteTokenAddress) {
         return null;
     }
 }
-/**
- * Flap 毕业后（status=4）外盘：PCS Infinity CL + Portal quote
- * getTokenV7().pool 在 V7 标准币上为 CLPoolManager 合约地址，非 V3 pair。
- */
-export async function getFlapGraduatedDexMetrics(params) {
-    const tokenAddress = params.tokenAddress;
-    const quoteToken = params.state.quoteTokenAddress &&
-        params.state.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS
-        ? params.state.quoteTokenAddress
-        : params.wrappedNativeAddress ?? '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
-    const progressRaw = params.state.progress ?? 0n;
-    const progress = progressRaw > 10n ** 18n
-        ? formatUnits(progressRaw, 18)
-        : progressRaw >= 100n
-            ? '100'
-            : String(progressRaw);
-    let price = await quotePortalPrice(params.portal, tokenAddress, quoteToken);
+function formatProgress(state) {
+    const progressRaw = state.progress ?? 0n;
+    if (progressRaw > 10n ** 18n)
+        return formatUnits(progressRaw, 18);
+    if (progressRaw >= 100n)
+        return '100';
+    return String(progressRaw);
+}
+async function getGraduatedV3PairMetrics(params) {
+    try {
+        const provider = new JsonRpcProvider(params.rpcUrl);
+        const pool = new Contract(params.poolAddress, V3_PAIR_ABI, provider);
+        const [t0, t1, slot0] = await Promise.all([
+            pool.token0(),
+            pool.token1(),
+            pool.slot0(),
+        ]);
+        const sqrtPriceX96 = BigInt(Array.isArray(slot0) ? slot0[0] : slot0.sqrtPriceX96);
+        const tokenLower = params.tokenAddress.toLowerCase();
+        const quoteAddr = params.quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
+            ? params.wrappedNativeAddress
+            : params.quoteTokenAddress;
+        const spot = v3SpotPriceQuotePerToken({
+            sqrtPriceX96,
+            tokenAddress: params.tokenAddress,
+            token0: t0,
+            token1: t1,
+            quoteTokenAddress: quoteAddr,
+        });
+        const price = spot ??
+            (await quotePortalPrice(params.portal, params.tokenAddress, params.quoteTokenAddress, params.wrappedNativeAddress));
+        const bal0 = (await new Contract(t0, ERC20_ABI, provider).balanceOf(params.poolAddress));
+        const bal1 = (await new Contract(t1, ERC20_ABI, provider).balanceOf(params.poolAddress));
+        const tokenIs0 = t0.toLowerCase() === tokenLower;
+        const poolTokenAmount = formatEther(tokenIs0 ? bal0 : bal1);
+        const poolBNBAmount = formatEther(tokenIs0 ? bal1 : bal0);
+        if (!price && poolTokenAmount === '0' && poolBNBAmount === '0')
+            return null;
+        return {
+            price: price ?? '0',
+            progress: '100',
+            poolBNBAmount,
+            poolTokenAmount,
+            dexKind: 'PANCAKE_V3',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function getInfinityCLGraduatedMetrics(params) {
+    const progress = formatProgress(params.state);
+    let price = await quotePortalPrice(params.portal, params.tokenAddress, params.quoteTokenAddress, params.wrappedNativeAddress);
     let poolBNBAmount = '0';
     let poolTokenAmount = '0';
     let poolId;
     let infinityFee;
     const poolKey = buildFlapInfinityPoolKey({
-        tokenAddress,
-        quoteTokenAddress: quoteToken,
-        chain: 'BSC',
+        tokenAddress: params.tokenAddress,
+        quoteTokenAddress: params.quoteTokenAddress,
+        chain: params.chain,
         lpFeeProfile: params.state.lpFeeProfile,
     });
     if (poolKey) {
@@ -161,48 +258,41 @@ export async function getFlapGraduatedDexMetrics(params) {
         try {
             const provider = new JsonRpcProvider(params.rpcUrl);
             const manager = new Contract(poolKey.poolManager, CL_POOL_MANAGER_ABI, provider);
-            const [slot0, liquidity] = await Promise.all([
-                manager.getSlot0(poolId),
-                manager.getLiquidity(poolId),
-            ]);
+            const [slot0] = await Promise.all([manager.getSlot0(poolId)]);
             const sqrtPriceX96 = BigInt(slot0[0]);
-            const liq = BigInt(liquidity);
             if (sqrtPriceX96 > 0n) {
-                const tokenIs0 = poolKey.currency0.toLowerCase() === tokenAddress.toLowerCase();
+                const quoteAddr = params.quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
+                    ? params.wrappedNativeAddress
+                    : params.quoteTokenAddress;
                 const spot = infinitySpotPriceQuotePerToken({
                     sqrtPriceX96,
-                    tokenAddress,
+                    tokenAddress: params.tokenAddress,
                     currency0: poolKey.currency0,
                     currency1: poolKey.currency1,
-                    quoteTokenAddress: quoteToken,
+                    quoteTokenAddress: quoteAddr,
                 });
                 if (spot)
                     price = spot;
-                const reserves = estimateInfinityReserves({
-                    liquidity: liq,
-                    sqrtPriceX96,
-                    tokenIsCurrency0: tokenIs0,
-                });
-                poolBNBAmount = reserves.reserveQuote;
-                poolTokenAmount = reserves.reserveToken;
             }
         }
         catch {
-            // slot0 失败时保留 portal quote 价格
+            /* keep portal quote */
         }
     }
+    const [bnbDepth, tokenReserve] = await Promise.all([
+        estimateInfinityPoolQuoteBnbDepth(params.portal, params.tokenAddress),
+        getInfinityCLPoolTokenReserve({
+            tokenAddress: params.tokenAddress,
+            rpcUrl: params.rpcUrl,
+            chain: params.chain,
+        }),
+    ]);
+    if (parseFloat(bnbDepth) > 0)
+        poolBNBAmount = bnbDepth;
+    if (parseFloat(tokenReserve) > 0)
+        poolTokenAmount = tokenReserve;
     if (!price)
         price = '0';
-    if (poolTokenAmount === '0' || poolTokenAmount === '0.0') {
-        try {
-            const circ = formatEther(params.state.circulatingSupply ?? 0n);
-            const total = formatEther(FLAP_TOTAL_SUPPLY);
-            poolTokenAmount = String(Math.max(0, Number(total) - Number(circ)));
-        }
-        catch {
-            poolTokenAmount = '0';
-        }
-    }
     return {
         price,
         progress,
@@ -210,15 +300,53 @@ export async function getFlapGraduatedDexMetrics(params) {
         poolTokenAmount,
         poolId,
         infinityFee,
+        dexKind: 'PCS_INFINITY_CL',
     };
 }
-/** 判断 getTokenV7.pool 是否为 Infinity CL PoolManager（而非 V3 pair） */
-export function isInfinityCLPoolManagerAddress(pool, chain) {
-    if (!pool)
-        return false;
-    const c = String(chain || '').toUpperCase();
-    if (c === 'BSC' || c === 'BASE') {
-        return pool.toLowerCase() === PCS_INFINITY_CL_POOL_MANAGER_BSC.toLowerCase();
+/**
+ * Flap 毕业后（status=4）外盘统一入口：
+ * - V7 / Infinity CL → Infinity + Portal quote 深度
+ * - 旧版 V3/V2（pool 为 pair 地址）→ 读 pair 余额 + slot0
+ * - 否则仅 Portal quote
+ */
+export async function getFlapGraduatedDexMetrics(params) {
+    const chain = String(params.chain || 'BSC').toUpperCase();
+    const wrappedNative = params.wrappedNativeAddress ?? '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
+    const quoteToken = params.state.quoteTokenAddress &&
+        params.state.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS
+        ? params.state.quoteTokenAddress
+        : wrappedNative;
+    const progress = formatProgress(params.state);
+    if (isFlapInfinityCLGraduated(params.state, chain)) {
+        return getInfinityCLGraduatedMetrics({
+            portal: params.portal,
+            tokenAddress: params.tokenAddress,
+            state: params.state,
+            rpcUrl: params.rpcUrl,
+            quoteTokenAddress: quoteToken,
+            wrappedNativeAddress: wrappedNative,
+            chain,
+        });
     }
-    return false;
+    const pool = params.state.pool;
+    if (pool && pool.toLowerCase() !== ZERO_ADDRESS && !isInfinityCLPoolManagerAddress(pool, chain)) {
+        const v3 = await getGraduatedV3PairMetrics({
+            rpcUrl: params.rpcUrl,
+            tokenAddress: params.tokenAddress,
+            poolAddress: pool,
+            quoteTokenAddress: quoteToken,
+            wrappedNativeAddress: wrappedNative,
+            portal: params.portal,
+        });
+        if (v3)
+            return v3;
+    }
+    const price = await quotePortalPrice(params.portal, params.tokenAddress, quoteToken, wrappedNative);
+    return {
+        price: price ?? '0',
+        progress,
+        poolBNBAmount: '0',
+        poolTokenAmount: '0',
+        dexKind: 'PORTAL_QUOTE',
+    };
 }

package/package.json

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