four-flap-meme-sdk 2.2.14 → 2.2.16

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, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, 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, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, 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, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, 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, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, 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/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 = {

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

@@ -3,6 +3,8 @@ 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 = [
@@ -120,54 +122,73 @@ function v3SpotPriceQuotePerToken(params) {
         quoteTokenAddress: params.quoteTokenAddress,
     });
 }
-/** Infinity CL：用 quote 估算当前可卖出的 WBNB 深度（贴近 GMGN，避免 L*sqrtP 高估） */
-async function estimateInfinityPoolQuoteDepth(portal, tokenAddress, wrappedNative) {
-    const inputQuote = ZERO_ADDRESS;
-    const probeTokens = [110000000n, 100000000n, 50000000n, 10000000n].map((m) => m * 10n ** 18n);
-    for (const amt of probeTokens) {
+const providerByRpc = new Map();
+const gradMetricsCache = new Map();
+const GRAD_METRICS_TTL_MS = 2500;
+function getCachedRpcProvider(rpcUrl) {
+    let p = providerByRpc.get(rpcUrl);
+    if (!p) {
+        p = new JsonRpcProvider(rpcUrl);
+        providerByRpc.set(rpcUrl, p);
+    }
+    return p;
+}
+/** 单次 quote 估 WBNB 深度（市值场景优先速度） */
+async function estimateInfinityPoolQuoteBnbDepth(portal, tokenAddress) {
+    try {
+        const bnbOut = await portal.quoteExactInput({
+            inputToken: tokenAddress,
+            outputToken: ZERO_ADDRESS,
+            inputAmount: 110000000n * 10n ** 18n,
+        });
+        if (bnbOut > 0n)
+            return formatEther(bnbOut);
+    }
+    catch {
         try {
             const bnbOut = await portal.quoteExactInput({
                 inputToken: tokenAddress,
-                outputToken: inputQuote,
-                inputAmount: amt,
+                outputToken: ZERO_ADDRESS,
+                inputAmount: 100000000n * 10n ** 18n,
             });
-            if (bnbOut > 0n) {
-                return {
-                    poolBNBAmount: formatEther(bnbOut),
-                    poolTokenAmount: formatEther(amt),
-                };
-            }
-        }
-        catch {
-            /* try smaller */
+            if (bnbOut > 0n)
+                return formatEther(bnbOut);
         }
+        catch { /* ignore */ }
     }
-    return { poolBNBAmount: '0', poolTokenAmount: '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 = params.provider ?? getCachedRpcProvider(params.rpcUrl);
+        const bal = (await new Contract(params.tokenAddress, ERC20_ABI, provider).balanceOf(vault));
+        return formatEther(bal);
+    }
+    catch {
+        return '0';
+    }
+}
+/** 单笔 buy quote 估价（比买卖双 quote 少一次 RPC） */
 async function quotePortalPrice(portal, tokenAddress, quoteTokenAddress, wrappedNativeAddress) {
     try {
         const buyAmt = 10n ** 16n;
-        const sellAmt = 10n ** 21n;
         const inputQuote = resolvePortalQuoteInputToken(quoteTokenAddress, wrappedNativeAddress);
-        const [tokensOut, quoteOut] = await Promise.all([
-            portal.quoteExactInput({
-                inputToken: inputQuote,
-                outputToken: tokenAddress,
-                inputAmount: buyAmt,
-            }),
-            portal.quoteExactInput({
-                inputToken: tokenAddress,
-                outputToken: inputQuote,
-                inputAmount: sellAmt,
-            }).catch(() => 0n),
-        ]);
+        const tokensOut = await portal.quoteExactInput({
+            inputToken: inputQuote,
+            outputToken: tokenAddress,
+            inputAmount: buyAmt,
+        });
         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);
+        return String(Number(formatEther(buyAmt)) / Number(formatEther(tokensOut)));
     }
     catch {
         return null;
@@ -183,18 +204,22 @@ function formatProgress(state) {
 }
 async function getGraduatedV3PairMetrics(params) {
     try {
-        const provider = new JsonRpcProvider(params.rpcUrl);
+        const provider = getCachedRpcProvider(params.rpcUrl);
         const pool = new Contract(params.poolAddress, V3_PAIR_ABI, provider);
+        const tokenLower = params.tokenAddress.toLowerCase();
+        const quoteAddr = params.quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
+            ? params.wrappedNativeAddress
+            : params.quoteTokenAddress;
         const [t0, t1, slot0] = await Promise.all([
             pool.token0(),
             pool.token1(),
             pool.slot0(),
         ]);
+        const [bal0, bal1] = await Promise.all([
+            new Contract(t0, ERC20_ABI, provider).balanceOf(params.poolAddress),
+            new Contract(t1, ERC20_ABI, provider).balanceOf(params.poolAddress),
+        ]);
         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,
@@ -202,13 +227,16 @@ async function getGraduatedV3PairMetrics(params) {
             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);
+        let price = spot;
+        if (!price && parseFloat(poolTokenAmount) > 0) {
+            price = String(parseFloat(poolBNBAmount) / parseFloat(poolTokenAmount));
+        }
+        if (!price) {
+            price = await quotePortalPrice(params.portal, params.tokenAddress, params.quoteTokenAddress, params.wrappedNativeAddress);
+        }
         if (!price && poolTokenAmount === '0' && poolBNBAmount === '0')
             return null;
         return {
@@ -225,53 +253,65 @@ async function getGraduatedV3PairMetrics(params) {
 }
 async function getInfinityCLGraduatedMetrics(params) {
     const progress = formatProgress(params.state);
-    let price = await quotePortalPrice(params.portal, params.tokenAddress, params.quoteTokenAddress, params.wrappedNativeAddress);
+    const provider = getCachedRpcProvider(params.rpcUrl);
     let poolBNBAmount = '0';
     let poolTokenAmount = '0';
     let poolId;
     let infinityFee;
+    let price = null;
     const poolKey = buildFlapInfinityPoolKey({
         tokenAddress: params.tokenAddress,
         quoteTokenAddress: params.quoteTokenAddress,
         chain: params.chain,
         lpFeeProfile: params.state.lpFeeProfile,
     });
-    if (poolKey) {
+    const quoteAddr = params.quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
+        ? params.wrappedNativeAddress
+        : params.quoteTokenAddress;
+    const slot0Promise = (async () => {
+        if (!poolKey)
+            return null;
         poolId = computeInfinityPoolId(poolKey);
         infinityFee = poolKey.fee;
         try {
-            const provider = new JsonRpcProvider(params.rpcUrl);
             const manager = new Contract(poolKey.poolManager, CL_POOL_MANAGER_ABI, provider);
-            const [slot0] = await Promise.all([manager.getSlot0(poolId)]);
-            const sqrtPriceX96 = BigInt(slot0[0]);
-            if (sqrtPriceX96 > 0n) {
-                const quoteAddr = params.quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
-                    ? params.wrappedNativeAddress
-                    : params.quoteTokenAddress;
-                const spot = infinitySpotPriceQuotePerToken({
-                    sqrtPriceX96,
-                    tokenAddress: params.tokenAddress,
-                    currency0: poolKey.currency0,
-                    currency1: poolKey.currency1,
-                    quoteTokenAddress: quoteAddr,
-                });
-                if (spot)
-                    price = spot;
-            }
+            const slot0 = await manager.getSlot0(poolId);
+            return BigInt(slot0[0]);
         }
         catch {
-            /* keep portal quote */
+            return null;
         }
+    })();
+    const [sqrtPriceX96, tokenReserve, bnbDepth] = await Promise.all([
+        slot0Promise,
+        getInfinityCLPoolTokenReserve({
+            tokenAddress: params.tokenAddress,
+            rpcUrl: params.rpcUrl,
+            chain: params.chain,
+            provider,
+        }),
+        estimateInfinityPoolQuoteBnbDepth(params.portal, params.tokenAddress),
+    ]);
+    if (sqrtPriceX96 && sqrtPriceX96 > 0n && poolKey) {
+        const spot = infinitySpotPriceQuotePerToken({
+            sqrtPriceX96,
+            tokenAddress: params.tokenAddress,
+            currency0: poolKey.currency0,
+            currency1: poolKey.currency1,
+            quoteTokenAddress: quoteAddr,
+        });
+        if (spot)
+            price = spot;
     }
-    const depth = await estimateInfinityPoolQuoteDepth(params.portal, params.tokenAddress, params.wrappedNativeAddress);
-    if (parseFloat(depth.poolBNBAmount) > 0) {
-        poolBNBAmount = depth.poolBNBAmount;
-        poolTokenAmount = depth.poolTokenAmount;
+    if (parseFloat(tokenReserve) > 0)
+        poolTokenAmount = tokenReserve;
+    if (parseFloat(bnbDepth) > 0)
+        poolBNBAmount = bnbDepth;
+    if (!price) {
+        price = await quotePortalPrice(params.portal, params.tokenAddress, params.quoteTokenAddress, params.wrappedNativeAddress);
     }
-    if (!price)
-        price = '0';
     return {
-        price,
+        price: price ?? '0',
         progress,
         poolBNBAmount,
         poolTokenAmount,
@@ -288,14 +328,20 @@ async function getInfinityCLGraduatedMetrics(params) {
  */
 export async function getFlapGraduatedDexMetrics(params) {
     const chain = String(params.chain || 'BSC').toUpperCase();
+    const tokenKey = `${chain}:${params.tokenAddress.toLowerCase()}`;
+    const cached = gradMetricsCache.get(tokenKey);
+    if (cached && Date.now() - cached.at < GRAD_METRICS_TTL_MS) {
+        return cached.data;
+    }
     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);
+    let data;
     if (isFlapInfinityCLGraduated(params.state, chain)) {
-        return getInfinityCLGraduatedMetrics({
+        data = await getInfinityCLGraduatedMetrics({
             portal: params.portal,
             tokenAddress: params.tokenAddress,
             state: params.state,
@@ -305,25 +351,42 @@ export async function getFlapGraduatedDexMetrics(params) {
             chain,
         });
     }
-    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;
+    else {
+        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) {
+                data = v3;
+            }
+            else {
+                const price = await quotePortalPrice(params.portal, params.tokenAddress, quoteToken, wrappedNative);
+                data = {
+                    price: price ?? '0',
+                    progress,
+                    poolBNBAmount: '0',
+                    poolTokenAmount: '0',
+                    dexKind: 'PORTAL_QUOTE',
+                };
+            }
+        }
+        else {
+            const price = await quotePortalPrice(params.portal, params.tokenAddress, quoteToken, wrappedNative);
+            data = {
+                price: price ?? '0',
+                progress,
+                poolBNBAmount: '0',
+                poolTokenAmount: '0',
+                dexKind: 'PORTAL_QUOTE',
+            };
+        }
     }
-    const price = await quotePortalPrice(params.portal, params.tokenAddress, quoteToken, wrappedNative);
-    return {
-        price: price ?? '0',
-        progress,
-        poolBNBAmount: '0',
-        poolTokenAmount: '0',
-        dexKind: 'PORTAL_QUOTE',
-    };
+    gradMetricsCache.set(tokenKey, { at: Date.now(), data });
+    return data;
 }

package/package.json

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