four-flap-meme-sdk 1.5.73 → 1.5.74

package/dist/flap/portal.d.ts

@@ -95,6 +95,20 @@ export type TokenStateV5 = {
     nativeToQuoteSwapEnabled: boolean;
     extensionID: `0x${string}`;
 };
+/**
+ * TokenStateV7 - 包含毕业相关信息（pool, progress, lpFeeProfile）
+ * 用于 XLayer 等支持 V7 的链
+ */
+export type TokenStateV7 = TokenStateV5 & {
+    taxRate: bigint;
+    pool: string;
+    progress: bigint;
+    lpFeeProfile: number;
+};
+/**
+ * 将 lpFeeProfile 转换为 V3 fee 值
+ */
+export declare function lpFeeProfileToV3Fee(profile: number): number;
 /**
  * Flap Portal 支持的链
  */
@@ -176,6 +190,23 @@ export declare class FlapPortal {
     getTokenV3(token: string): Promise<TokenStateV3>;
     getTokenV4(token: string): Promise<TokenStateV4>;
     getTokenV5(token: string): Promise<TokenStateV5>;
+    /**
+     * 获取代币状态 V7（包含毕业相关信息）
+     * 注意：仅部分链支持 V7（如 XLayer v5.7+），不支持的链会 revert
+     */
+    getTokenV7(token: string): Promise<TokenStateV7>;
+    /**
+     * 计算距离毕业还需多少 OKB/ETH（含手续费）
+     * @param state TokenStateV5 或 TokenStateV7
+     * @returns 毕业相关信息
+     */
+    computeRemainingToGraduation(state: TokenStateV5 | TokenStateV7): {
+        remainingOkb: string;
+        graduationReserve: string;
+        currentReserve: string;
+        isGraduated: boolean;
+        progressPercent: string;
+    };
     computePriceAndProgress(state: TokenStateV5): {
         price: string;
         progress: string;

package/dist/flap/portal.js

@@ -64,6 +64,8 @@ const PORTAL_ABI = [
     'function getTokenV3(address token) external view returns (uint8,uint256,uint256,uint256,uint8,uint256,uint256,address,bool)',
     'function getTokenV4(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,address,bool,bytes32))',
     'function getTokenV5(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32))',
+    // V7: 包含 taxRate, pool, progress, lpFeeProfile
+    'function getTokenV7(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32,uint256,address,uint256,uint8))',
     // 报价方法
     'function previewBuy(address token, uint256 ethAmount) external view returns (uint256)',
     'function previewSell(address token, uint256 tokenAmount) external view returns (uint256)',
@@ -88,6 +90,17 @@ const PORTAL_ABI = [
     'function version() external pure returns (string)',
     'function getLocks(address token) external view returns (uint256[])'
 ];
+/**
+ * 将 lpFeeProfile 转换为 V3 fee 值
+ */
+export function lpFeeProfileToV3Fee(profile) {
+    switch (profile) {
+        case V3LPFeeProfile.LP_FEE_PROFILE_STANDARD: return 2500;
+        case V3LPFeeProfile.LP_FEE_PROFILE_LOW: return 100;
+        case V3LPFeeProfile.LP_FEE_PROFILE_HIGH: return 10000;
+        default: return 2500; // 默认 STANDARD
+    }
+}
 export class FlapPortal {
     constructor(cfg) {
         this.rpcUrl = cfg.rpcUrl;
@@ -144,6 +157,66 @@ export class FlapPortal {
             extensionID: raw[11],
         };
     }
+    /**
+     * 获取代币状态 V7（包含毕业相关信息）
+     * 注意：仅部分链支持 V7（如 XLayer v5.7+），不支持的链会 revert
+     */
+    async getTokenV7(token) {
+        const raw = await this.contract.getTokenV7(token);
+        return {
+            status: raw[0],
+            reserve: raw[1],
+            circulatingSupply: raw[2],
+            price: raw[3],
+            tokenVersion: raw[4],
+            r: raw[5],
+            h: raw[6],
+            k: raw[7],
+            dexSupplyThresh: raw[8],
+            quoteTokenAddress: raw[9],
+            nativeToQuoteSwapEnabled: raw[10],
+            extensionID: raw[11],
+            taxRate: raw[12],
+            pool: raw[13],
+            progress: raw[14],
+            lpFeeProfile: Number(raw[15]),
+        };
+    }
+    /**
+     * 计算距离毕业还需多少 OKB/ETH（含手续费）
+     * @param state TokenStateV5 或 TokenStateV7
+     * @returns 毕业相关信息
+     */
+    computeRemainingToGraduation(state) {
+        const r = Number(formatEther(state.r));
+        const h = Number(formatEther(state.h));
+        const k = Number(formatEther(state.k));
+        const curve = new CDPV2(r, h, k);
+        const currentReserve = formatEther(state.reserve);
+        const dexSupplyThresh = formatEther(state.dexSupplyThresh);
+        const circulatingSupply = formatEther(state.circulatingSupply);
+        // 计算毕业时的储备
+        const graduationReserve = curve.estimateReserve(dexSupplyThresh);
+        const graduationReserveNum = parseFloat(graduationReserve.toString());
+        const currentReserveNum = parseFloat(currentReserve);
+        // 是否已毕业 (status == 4 表示 DEX)
+        const isGraduated = state.status === 4;
+        // 还需多少（净值）
+        const remainingNet = Math.max(0, graduationReserveNum - currentReserveNum);
+        // 含手续费（1% buy fee）
+        const remainingWithFee = remainingNet / (1 - this.buyFeeRate);
+        // 计算进度
+        const progressPercent = isGraduated
+            ? '100.00'
+            : (currentReserveNum / graduationReserveNum * 100).toFixed(2);
+        return {
+            remainingOkb: remainingWithFee.toFixed(6),
+            graduationReserve: graduationReserveNum.toFixed(6),
+            currentReserve: currentReserveNum.toFixed(6),
+            isGraduated,
+            progressPercent,
+        };
+    }
     // 价格/进度
     computePriceAndProgress(state) {
         // 使用合约返回的实时价格，而不是重新计算

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { TM1, type FourChainV1 } from './contracts/tm1.js';
 export { TM2, type FourChainV2 } from './contracts/tm2.js';
 export { Helper3, Helper3Writer } from './contracts/helper3.js';
 export { CDPV2 } from './flap/curve.js';
-export { FlapPortal, FlapPortalWriter, type FlapChain, type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, type NewTokenV4Params, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, DEXId } from './flap/portal.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, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId } from './flap/portal.js';
 export { uploadTokenMeta, type TokenMetaInput } from './flap/ipfs.js';
 export { buildPermitPiggybackAuto } from './flap/permit.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './flap/vanity.js';

package/dist/index.js

@@ -30,7 +30,7 @@ export { TM1 } from './contracts/tm1.js';
 export { TM2 } from './contracts/tm2.js';
 export { Helper3, Helper3Writer } from './contracts/helper3.js';
 export { CDPV2 } from './flap/curve.js';
-export { FlapPortal, FlapPortalWriter, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, DEXId } from './flap/portal.js';
+export { FlapPortal, FlapPortalWriter, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId } from './flap/portal.js';
 export { uploadTokenMeta } from './flap/ipfs.js';
 export { buildPermitPiggybackAuto } from './flap/permit.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './flap/vanity.js';

package/package.json

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