four-flap-meme-sdk 2.2.11 → 2.2.13

package/dist/index.d.ts

@@ -15,6 +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 { 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,6 +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 { 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

@@ -0,0 +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';

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

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

package/dist/shared/flap/portal-bundle-merkle/core.js

@@ -158,8 +158,13 @@ export async function createTokenWithBundleBuyMerkle(params) {
         profitTokenAmount = totalProfit / divisor;
     }
     // ✅ 优化：并行获取 unsignedBuys 和 buyerNonces
+    // TOKEN_V3_PERMIT / newTokenV7 内盘买入须 swapExactInputV3（与 create-to-dex 一致）
+    const usePortalSwapV3 = useV7Portal ||
+        (params.lpFeeProfile !== undefined && !normalizedTax) ||
+        (!!params.extensionID &&
+            params.extensionID !== '0x' + '00'.repeat(32));
     const [unsignedBuys, buyerNonces] = await Promise.all([
-        populateBuyTransactionsWithQuote(buyers, portalAddr, tokenAddress, adjustedFundsList, inputToken, useNativeToken),
+        populateBuyTransactionsWithQuote(buyers, portalAddr, tokenAddress, adjustedFundsList, inputToken, useNativeToken, usePortalSwapV3, params.extensionData ?? '0x'),
         allocateBuyerNonces(buyers, extractProfit, maxFundsIndex, useNativeToken ? totalProfit : profitTokenAmount, nonceManager)
     ]);
     // ✅ 贿赂交易放在首位（提高 BlockRazor 打包优先级）
@@ -667,17 +672,22 @@ function findMaxIndex(values) {
  * ✅ 支持 quoteToken 的买入交易构建
  * 当 inputToken 为非零地址（如 USDC）时，value 为 0
  */
-async function populateBuyTransactionsWithQuote(buyers, portalAddr, tokenAddress, fundsList, inputToken, useNativeToken) {
+async function populateBuyTransactionsWithQuote(buyers, portalAddr, tokenAddress, fundsList, inputToken, useNativeToken, usePortalSwapV3 = false, extensionData = '0x') {
     const portals = buyers.map(wallet => new ethers.Contract(portalAddr, PORTAL_ABI, wallet));
-    return await Promise.all(portals.map((portal, i) => portal.swapExactInput.populateTransaction({
-        inputToken,
-        outputToken: tokenAddress,
-        inputAmount: fundsList[i],
-        minOutputAmount: 0n,
-        permitData: '0x'
-    }, 
-    // ✅ 如果使用原生代币，value 为购买金额；否则为 0
-    useNativeToken ? { value: fundsList[i] } : {})));
+    return await Promise.all(portals.map((portal, i) => {
+        const swapParams = {
+            inputToken,
+            outputToken: tokenAddress,
+            inputAmount: fundsList[i],
+            minOutputAmount: 0n,
+            permitData: '0x',
+        };
+        const overrides = useNativeToken ? { value: fundsList[i] } : {};
+        if (usePortalSwapV3) {
+            return portal.swapExactInputV3.populateTransaction({ ...swapParams, extensionData: extensionData ?? '0x' }, overrides);
+        }
+        return portal.swapExactInput.populateTransaction(swapParams, overrides);
+    }));
 }
 function buildGasLimitList(length, config) {
     const gasLimit = getGasLimit(config);

package/dist/utils/lp-inspect.js

@@ -3,6 +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';
 // ============================================================================
 // 链配置
 // ============================================================================
@@ -360,7 +361,61 @@ export async function inspectTokenLP(token, opts) {
                 if (opts.debug)
                     console.log('[LP Inspect] Flap V7 failed, using V5');
             }
-            if (st && st.status !== undefined && Number(st.status) !== 4) {
+            if (st && st.status !== undefined) {
+                const status = Number(st.status);
+                // ✅ 已毕业：PCS Infinity CL 外盘（Portal pool 字段为 CLPoolManager）
+                if (status === 4) {
+                    const quoteAddr = st.quoteTokenAddress && st.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS
+                        ? st.quoteTokenAddress
+                        : chainConfig.wrappedNative;
+                    let quoteDecimals = 18;
+                    let quoteSymbol = chainConfig.wrappedNativeSymbol;
+                    if (quoteAddr.toLowerCase() !== chainConfig.wrappedNative.toLowerCase()) {
+                        quoteDecimals = await getTokenDecimals(quoteAddr, provider);
+                        const stableCoin = chainConfig.stableCoins.find(c => c.address.toLowerCase() === quoteAddr.toLowerCase());
+                        quoteSymbol = stableCoin?.symbol || 'TOKEN';
+                    }
+                    const metrics = await getFlapGraduatedDexMetrics({
+                        portal: flap,
+                        tokenAddress: token,
+                        state: st,
+                        rpcUrl: opts.rpcUrl,
+                        wrappedNativeAddress: chainConfig.wrappedNative,
+                    });
+                    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;
+                }
                 result.platform = 'FLAP';
                 let quoteDecimals = 18;
                 let quoteSymbol = chainConfig.wrappedNativeSymbol;

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

@@ -0,0 +1,62 @@
+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";
+/** Flap Portal 毕业到 Infinity CL 时使用的 hooks（BSC） */
+export declare const FLAP_INFINITY_HOOKS_BSC = "0xF1A9aA042454b8553bE3896597ff11a0f011c1c1";
+export type InfinityPoolKey = {
+    currency0: string;
+    currency1: string;
+    hooks: string;
+    poolManager: string;
+    fee: number;
+    parameters: string;
+};
+export declare function sortInfinityCurrencies(a: string, b: string): [string, string];
+export declare function computeInfinityPoolId(key: InfinityPoolKey): string;
+export declare function buildFlapInfinityPoolKey(params: {
+    tokenAddress: string;
+    quoteTokenAddress: string;
+    chain: string;
+    lpFeeProfile?: number;
+}): InfinityPoolKey | null;
+/** 由 slot0 计算 quote per token（与 memeweb V3 spot 公式一致） */
+export declare function infinitySpotPriceQuotePerToken(params: {
+    sqrtPriceX96: bigint;
+    tokenAddress: string;
+    currency0: string;
+    currency1: string;
+    quoteTokenAddress: string;
+    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。
+ */
+export declare function getFlapGraduatedDexMetrics(params: {
+    portal: FlapPortal;
+    tokenAddress: string;
+    state: TokenStateV7;
+    rpcUrl: string;
+    wrappedNativeAddress?: 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

@@ -0,0 +1,224 @@
+import { AbiCoder, Contract, JsonRpcProvider, formatEther, formatUnits, keccak256 } from 'ethers';
+import { FLAP_TOTAL_SUPPLY, ZERO_ADDRESS } from '../shared/flap/constants.js';
+/** PancakeSwap Infinity CL PoolManager（BSC / Base 同址） */
+export const PCS_INFINITY_CL_POOL_MANAGER_BSC = '0xa0FfB9c1CE1Fe56963B0321B32E7A0302114058b';
+/** 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)',
+];
+/** BSC：lpFeeProfile → Infinity PoolKey 的 fee / parameters（与链上 Initialize 一致） */
+const BSC_INFINITY_POOL_KEY_BY_PROFILE = {
+    0: {
+        fee: 8534,
+        parameters: '0x0000000000000000000000000000000000000000000000000000000000fa00d5',
+    },
+};
+export function sortInfinityCurrencies(a, b) {
+    return a.toLowerCase() < b.toLowerCase() ? [a, b] : [b, a];
+}
+export function computeInfinityPoolId(key) {
+    const coder = AbiCoder.defaultAbiCoder();
+    return keccak256(coder.encode(['address', 'address', 'address', 'address', 'uint24', 'bytes32'], [key.currency0, key.currency1, key.hooks, key.poolManager, key.fee, key.parameters]));
+}
+export function buildFlapInfinityPoolKey(params) {
+    const chain = String(params.chain || '').toUpperCase();
+    if (chain !== 'BSC')
+        return null;
+    const meta = BSC_INFINITY_POOL_KEY_BY_PROFILE[Number(params.lpFeeProfile ?? 0)] ??
+        BSC_INFINITY_POOL_KEY_BY_PROFILE[0];
+    const quote = params.quoteTokenAddress &&
+        params.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS
+        ? params.quoteTokenAddress
+        : '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c'; // WBNB
+    const [currency0, currency1] = sortInfinityCurrencies(params.tokenAddress, quote);
+    return {
+        currency0,
+        currency1,
+        hooks: FLAP_INFINITY_HOOKS_BSC,
+        poolManager: PCS_INFINITY_CL_POOL_MANAGER_BSC,
+        fee: meta.fee,
+        parameters: meta.parameters,
+    };
+}
+function formatRatio(n, d, precision = 18) {
+    if (d === 0n)
+        return '0';
+    const scale = 10n ** BigInt(precision);
+    const x = (n * scale) / d;
+    const s = x.toString().padStart(precision + 1, '0');
+    const int = s.slice(0, -precision);
+    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();
+    const tokenIs0 = params.currency0.toLowerCase() === tokenLower;
+    const tokenIs1 = params.currency1.toLowerCase() === tokenLower;
+    const quoteIs0 = params.currency0.toLowerCase() === quoteLower;
+    const quoteIs1 = params.currency1.toLowerCase() === quoteLower;
+    if ((!tokenIs0 && !tokenIs1) || (!quoteIs0 && !quoteIs1))
+        return null;
+    const dec0 = params.tokenDecimals ?? 18;
+    const dec1 = params.quoteDecimals ?? 18;
+    const tokenDec = tokenIs0 ? dec0 : dec1;
+    const quoteDec = quoteIs0 ? dec0 : dec1;
+    const Q192 = 2n ** 192n;
+    const num = params.sqrtPriceX96 * params.sqrtPriceX96;
+    let n;
+    let d;
+    if (tokenIs0) {
+        n = num * 10n ** BigInt(tokenDec);
+        d = Q192 * 10n ** BigInt(quoteDec);
+    }
+    else {
+        n = Q192 * 10n ** BigInt(quoteDec);
+        d = num * 10n ** BigInt(tokenDec);
+    }
+    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' };
+    }
+    // float 估算即可满足面板展示
+    const sqrtP = Number(params.sqrtPriceX96) / Number(Q96);
+    const L = Number(params.liquidity);
+    if (!Number.isFinite(sqrtP) || sqrtP <= 0) {
+        return { reserveToken: '0', reserveQuote: '0' };
+    }
+    const amount1 = (L * sqrtP) / 1e18;
+    const amount0 = L / sqrtP / 1e18;
+    if (params.tokenIsCurrency0) {
+        return { reserveToken: String(amount0), reserveQuote: String(amount1) };
+    }
+    return { reserveToken: String(amount1), reserveQuote: String(amount0) };
+}
+async function quotePortalPrice(portal, tokenAddress, quoteTokenAddress) {
+    try {
+        const buyAmt = 10n ** 16n; // 0.01 native
+        const sellAmt = 10n ** 21n; // 1000 tokens
+        const inputQuote = quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
+            ? ZERO_ADDRESS
+            : quoteTokenAddress;
+        const [tokensOut, quoteOut] = await Promise.all([
+            portal.quoteExactInput({
+                inputToken: inputQuote,
+                outputToken: tokenAddress,
+                inputAmount: buyAmt,
+            }),
+            portal.quoteExactInput({
+                inputToken: tokenAddress,
+                outputToken: inputQuote,
+                inputAmount: sellAmt,
+            }),
+        ]);
+        if (tokensOut <= 0n || quoteOut <= 0n)
+            return null;
+        const buyPrice = Number(formatEther(buyAmt)) / Number(formatEther(tokensOut));
+        const sellPrice = Number(formatEther(quoteOut)) / Number(formatEther(sellAmt));
+        return String((buyPrice + sellPrice) / 2);
+    }
+    catch {
+        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);
+    let poolBNBAmount = '0';
+    let poolTokenAmount = '0';
+    let poolId;
+    let infinityFee;
+    const poolKey = buildFlapInfinityPoolKey({
+        tokenAddress,
+        quoteTokenAddress: quoteToken,
+        chain: 'BSC',
+        lpFeeProfile: params.state.lpFeeProfile,
+    });
+    if (poolKey) {
+        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, liquidity] = await Promise.all([
+                manager.getSlot0(poolId),
+                manager.getLiquidity(poolId),
+            ]);
+            const sqrtPriceX96 = BigInt(slot0[0]);
+            const liq = BigInt(liquidity);
+            if (sqrtPriceX96 > 0n) {
+                const tokenIs0 = poolKey.currency0.toLowerCase() === tokenAddress.toLowerCase();
+                const spot = infinitySpotPriceQuotePerToken({
+                    sqrtPriceX96,
+                    tokenAddress,
+                    currency0: poolKey.currency0,
+                    currency1: poolKey.currency1,
+                    quoteTokenAddress: quoteToken,
+                });
+                if (spot)
+                    price = spot;
+                const reserves = estimateInfinityReserves({
+                    liquidity: liq,
+                    sqrtPriceX96,
+                    tokenIsCurrency0: tokenIs0,
+                });
+                poolBNBAmount = reserves.reserveQuote;
+                poolTokenAmount = reserves.reserveToken;
+            }
+        }
+        catch {
+            // slot0 失败时保留 portal quote 价格
+        }
+    }
+    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,
+        poolBNBAmount,
+        poolTokenAmount,
+        poolId,
+        infinityFee,
+    };
+}
+/** 判断 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;
+}

package/package.json

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