four-flap-meme-sdk 1.5.71 → 1.5.72

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.71",
+  "version": "1.5.72",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",
@@ -36,4 +36,4 @@
   "devDependencies": {
     "typescript": "^5.6.3"
   }
-}
+}

package/dist/flap/portal-bundle-merkle/encryption.d.ts

@@ -1,16 +0,0 @@
-/**
- * ECDH + AES-GCM 加密工具（浏览器兼容）
- * 用于将签名交易用服务器公钥加密
- */
-/**
- * 用服务器公钥加密签名交易（ECDH + AES-GCM）
- *
- * @param signedTransactions 签名后的交易数组
- * @param publicKeyBase64 服务器提供的公钥（Base64 格式）
- * @returns JSON 字符串 {e: 临时公钥, i: IV, d: 密文}
- */
-export declare function encryptWithPublicKey(signedTransactions: string[], publicKeyBase64: string): Promise<string>;
-/**
- * 验证公钥格式（Base64）
- */
-export declare function validatePublicKey(publicKeyBase64: string): boolean;

package/dist/flap/portal-bundle-merkle/encryption.js

@@ -1,146 +0,0 @@
-/**
- * ECDH + AES-GCM 加密工具（浏览器兼容）
- * 用于将签名交易用服务器公钥加密
- */
-/**
- * 获取全局 crypto 对象（最简单直接的方式）
- */
-function getCryptoAPI() {
-    // 尝试所有可能的全局对象，优先浏览器环境
-    const cryptoObj = (typeof window !== 'undefined' && window.crypto) ||
-        (typeof self !== 'undefined' && self.crypto) ||
-        (typeof global !== 'undefined' && global.crypto) ||
-        (typeof globalThis !== 'undefined' && globalThis.crypto);
-    if (!cryptoObj) {
-        const env = typeof window !== 'undefined' ? 'Browser' : 'Node.js';
-        const protocol = typeof location !== 'undefined' ? location.protocol : 'unknown';
-        throw new Error(`❌ Crypto API 不可用。环境: ${env}, 协议: ${protocol}. ` +
-            '请确保在 HTTPS 或 localhost 下运行');
-    }
-    return cryptoObj;
-}
-/**
- * 获取 SubtleCrypto（用于加密操作）
- */
-function getSubtleCrypto() {
-    const crypto = getCryptoAPI();
-    if (!crypto.subtle) {
-        const protocol = typeof location !== 'undefined' ? location.protocol : 'unknown';
-        const hostname = typeof location !== 'undefined' ? location.hostname : 'unknown';
-        throw new Error(`❌ SubtleCrypto API 不可用。协议: ${protocol}, 主机: ${hostname}. ` +
-            '请确保：1) 使用 HTTPS (或 localhost)；2) 浏览器支持 Web Crypto API；' +
-            '3) 不在无痕/隐私浏览模式下');
-    }
-    return crypto.subtle;
-}
-/**
- * Base64 转 ArrayBuffer（优先使用浏览器 API）
- */
-function base64ToArrayBuffer(base64) {
-    // 浏览器环境（优先）
-    if (typeof atob !== 'undefined') {
-        const binaryString = atob(base64);
-        const bytes = new Uint8Array(binaryString.length);
-        for (let i = 0; i < binaryString.length; i++) {
-            bytes[i] = binaryString.charCodeAt(i);
-        }
-        return bytes.buffer;
-    }
-    // Node.js 环境（fallback）
-    if (typeof Buffer !== 'undefined') {
-        return Buffer.from(base64, 'base64').buffer;
-    }
-    throw new Error('❌ Base64 解码不可用');
-}
-/**
- * ArrayBuffer 转 Base64（优先使用浏览器 API）
- */
-function arrayBufferToBase64(buffer) {
-    // 浏览器环境（优先）
-    if (typeof btoa !== 'undefined') {
-        const bytes = new Uint8Array(buffer);
-        let binary = '';
-        for (let i = 0; i < bytes.length; i++) {
-            binary += String.fromCharCode(bytes[i]);
-        }
-        return btoa(binary);
-    }
-    // Node.js 环境（fallback）
-    if (typeof Buffer !== 'undefined') {
-        return Buffer.from(buffer).toString('base64');
-    }
-    throw new Error('❌ Base64 编码不可用');
-}
-/**
- * 生成随机 Hex 字符串
- */
-function randomHex(length) {
-    const crypto = getCryptoAPI();
-    const array = new Uint8Array(length);
-    crypto.getRandomValues(array);
-    return Array.from(array)
-        .map(b => b.toString(16).padStart(2, '0'))
-        .join('');
-}
-/**
- * 用服务器公钥加密签名交易（ECDH + AES-GCM）
- *
- * @param signedTransactions 签名后的交易数组
- * @param publicKeyBase64 服务器提供的公钥（Base64 格式）
- * @returns JSON 字符串 {e: 临时公钥, i: IV, d: 密文}
- */
-export async function encryptWithPublicKey(signedTransactions, publicKeyBase64) {
-    try {
-        // 0. 获取 SubtleCrypto 和 Crypto API
-        const subtle = getSubtleCrypto();
-        const crypto = getCryptoAPI();
-        // 1. 准备数据
-        const payload = {
-            signedTransactions,
-            timestamp: Date.now(),
-            nonce: randomHex(8)
-        };
-        const plaintext = JSON.stringify(payload);
-        // 2. 生成临时 ECDH 密钥对
-        const ephemeralKeyPair = await subtle.generateKey({ name: 'ECDH', namedCurve: 'P-256' }, true, ['deriveKey']);
-        // 3. 导入服务器公钥
-        const publicKeyBuffer = base64ToArrayBuffer(publicKeyBase64);
-        const publicKey = await subtle.importKey('raw', publicKeyBuffer, { name: 'ECDH', namedCurve: 'P-256' }, false, []);
-        // 4. 派生共享密钥（AES-256）
-        const sharedKey = await subtle.deriveKey({ name: 'ECDH', public: publicKey }, ephemeralKeyPair.privateKey, { name: 'AES-GCM', length: 256 }, false, ['encrypt']);
-        // 5. AES-GCM 加密
-        const iv = crypto.getRandomValues(new Uint8Array(12));
-        const encrypted = await subtle.encrypt({ name: 'AES-GCM', iv }, sharedKey, new TextEncoder().encode(plaintext));
-        // 6. 导出临时公钥
-        const ephemeralPublicKeyRaw = await subtle.exportKey('raw', ephemeralKeyPair.publicKey);
-        // 7. 返回加密包（JSON 格式）
-        return JSON.stringify({
-            e: arrayBufferToBase64(ephemeralPublicKeyRaw), // 临时公钥
-            i: arrayBufferToBase64(iv.buffer), // IV
-            d: arrayBufferToBase64(encrypted) // 密文
-        });
-    }
-    catch (error) {
-        throw new Error(`加密失败: ${error?.message || String(error)}`);
-    }
-}
-/**
- * 验证公钥格式（Base64）
- */
-export function validatePublicKey(publicKeyBase64) {
-    try {
-        if (!publicKeyBase64)
-            return false;
-        // Base64 字符集验证
-        if (!/^[A-Za-z0-9+/=]+$/.test(publicKeyBase64))
-            return false;
-        // ECDH P-256 公钥固定长度 65 字节（未压缩）
-        // Base64 编码后约 88 字符
-        if (publicKeyBase64.length < 80 || publicKeyBase64.length > 100)
-            return false;
-        return true;
-    }
-    catch {
-        return false;
-    }
-}