four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/shared/clients/four.js

@@ -1,3 +1,4 @@
+import { getErrorMessageFromUnknown } from '../foundation/index.js';
 // ============================================================================
 // 图片上传缓存（按内容哈希去重，同一张图片只上传一次）
 // ✅ 使用 localStorage 持久化，刷新页面 / 重启浏览器后缓存仍然有效
@@ -38,7 +39,9 @@ function saveCache() {
             return;
         const cache = loadCache();
         const obj = {};
-        cache.forEach((v, k) => { obj[k] = v; });
+        cache.forEach((v, k) => {
+            obj[k] = v;
+        });
         localStorage.setItem(UPLOAD_CACHE_KEY, JSON.stringify(obj));
     }
     catch {
@@ -72,7 +75,7 @@ async function hashBlob(blob) {
     const buffer = await blob.arrayBuffer();
     const hashBuffer = await crypto.subtle.digest('SHA-256', buffer);
     const hashArray = Array.from(new Uint8Array(hashBuffer));
-    return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+    return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
 }
 /** IP 限流错误码 */
 const RATE_LIMIT_CODE = -1038;
@@ -84,6 +87,8 @@ const RATE_LIMIT_CODE = -1038;
  */
 const FOUR_MEME_OFFICIAL_API = 'https://four.meme/meme-api';
 export class FourClient {
+    baseUrl;
+    uploadUrls;
     constructor(cfg) {
         // 默认使用 Cloudflare Workers 代理，已配置 CORS，浏览器可直接使用
         this.baseUrl = cfg?.baseUrl || 'https://bscfourapi.emit.tools';
@@ -147,13 +152,10 @@ export class FourClient {
                 const imgUrl = await this.doUpload(baseUrl, accessToken, file, finalFilename);
                 // 上传成功，写入持久化缓存（localStorage）
                 setCachedUrl(hash, imgUrl);
-                if (i > 0) {
-                    console.warn(`[FourClient] 使用${isOfficial ? '官方直连' : '备用'}端点上传成功: ${baseUrl}`);
-                }
                 return imgUrl;
             }
             catch (e) {
-                lastError = e instanceof Error ? e : new Error(String(e));
+                lastError = e;
                 const canRetry = i < this.uploadUrls.length - 1;
                 if (this.isRateLimitError(e) && canRetry) {
                     // IP 限流 → 切下一个端点
@@ -176,9 +178,11 @@ export class FourClient {
         if (isRateLimit) {
             throw new Error(`图片上传失败：所有端点均触发 IP 限流(每IP每天100次)。` +
                 `请等待次日重置，或在 FourConfig.uploadFallbackUrls 中添加不同 IP 的备用代理。` +
-                `\n原始错误: ${lastError.message}`);
+                `\n原始错误: ${getErrorMessageFromUnknown(lastError)}`);
         }
-        throw lastError || new Error('upload failed: all endpoints exhausted');
+        if (lastError !== null && lastError !== undefined)
+            throw lastError;
+        throw new Error('upload failed: all endpoints exhausted');
     }
     /**
      * 执行单次上传请求
@@ -193,8 +197,9 @@ export class FourClient {
         });
         const j = await r.json();
         if (j.code !== '0' && j.code !== 0) {
-            const apiCode = typeof j.code === 'string' ? parseInt(j.code, 10) : j.code;
-            throw Object.assign(new Error(`upload failed: ${JSON.stringify(j)}`), { apiCode });
+            const uploadErr = new Error(`upload failed: ${JSON.stringify(j)}`);
+            uploadErr.apiCode = typeof j.code === 'string' ? parseInt(j.code, 10) : Number(j.code);
+            throw uploadErr;
         }
         return j.data; // imgUrl
     }
@@ -202,12 +207,13 @@ export class FourClient {
      * 判断是否为 IP 限流错误（code: -1038）
      */
     isRateLimitError(e) {
-        const err = e;
-        if (err.apiCode === RATE_LIMIT_CODE)
-            return true;
-        if (typeof err.message === 'string' && err.message.includes('-1038'))
+        if (e !== null &&
+            typeof e === 'object' &&
+            'apiCode' in e &&
+            e.apiCode === RATE_LIMIT_CODE) {
             return true;
-        return false;
+        }
+        return getErrorMessageFromUnknown(e).includes('-1038');
     }
     /**
      * 判断是否为 CORS 或网络错误
@@ -215,9 +221,8 @@ export class FourClient {
      */
     isCorsOrNetworkError(e) {
         if (e instanceof TypeError)
-            return true;
-        const m = e;
-        const msg = m.message?.toLowerCase?.() ?? '';
+            return true; // fetch CORS / network failure
+        const msg = getErrorMessageFromUnknown(e).toLowerCase();
         return msg.includes('failed to fetch') || msg.includes('network') || msg.includes('cors');
     }
     getFilenameFromBlob(blob) {

package/dist/shared/clients/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTTP / Bundle 客户端统一出口（不替代根包的扁平别名，仅供子路径导入）
+ */
+export { FourClient, buildLoginMessage, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenResp, type FourTokenTaxInfo, } from './four.js';
+export { Club48Client, sendBatchPrivateTransactions, sendBackrunBundle, type BundleParams, type BundleStatus, type Club48Config, } from './club48.js';
+export { MerkleClient, createMerkleClient, type MerkleConfig, type BundleParams as MerkleBundleParams, type SendBundleOptions, type BundleResult, type TransactionResult, } from './merkle.js';
+export { BlockRazorClient, createBlockRazorClient, BLOCKRAZOR_BUILDER_EOA, type BlockRazorConfig, type BlockRazorBundleParams, type SendBundleOptions as BlockRazorSendBundleOptions, type BundleResult as BlockRazorBundleResult, type TransactionResult as BlockRazorTransactionResult, type IncentiveTransactionParams, } from './blockrazor.js';
+export { EmitServiceClient, submitToEmitServiceBlockRazor, type EmitServiceClientConfig, type EmitServiceSubmitRequest, type EmitServiceSubmitResponse, type EmitServiceSubmitResponseData, type EmitServiceRouteConfigResponse, } from './emitservice.js';

package/dist/shared/clients/index.js

@@ -0,0 +1,8 @@
+/**
+ * HTTP / Bundle 客户端统一出口（不替代根包的扁平别名，仅供子路径导入）
+ */
+export { FourClient, buildLoginMessage, } from './four.js';
+export { Club48Client, sendBatchPrivateTransactions, sendBackrunBundle, } from './club48.js';
+export { MerkleClient, createMerkleClient, } from './merkle.js';
+export { BlockRazorClient, createBlockRazorClient, BLOCKRAZOR_BUILDER_EOA, } from './blockrazor.js';
+export { EmitServiceClient, submitToEmitServiceBlockRazor, } from './emitservice.js';

package/dist/shared/clients/merkle.js

@@ -22,14 +22,19 @@
  */
 import { JsonRpcProvider, Transaction } from 'ethers';
 import { CHAINS } from '../constants/index.js';
+import { getErrorMessageFromUnknown } from '../foundation/index.js';
 /**
  * Merkle 客户端
  */
 export class MerkleClient {
+    provider;
+    chainId;
+    chainName;
+    // ✅ 区块号缓存（减少 RPC 调用）
+    // 注意：TTL 设为 1 秒，确保区块号尽可能新鲜，减少 "Missed inclusion" 风险
+    blockNumberCache = null;
+    static BLOCK_CACHE_TTL_MS = 1000; // 1秒缓存（BSC 约 3 秒出块，ETH 约 12 秒）
     constructor(config) {
-        // ✅ 区块号缓存（减少 RPC 调用）
-        // 注意：TTL 设为 1 秒，确保区块号尽可能新鲜，减少 "Missed inclusion" 风险
-        this.blockNumberCache = null;
         this.chainId = config.chainId;
         this.chainName = config.chainId === CHAINS.BSC.chainId ? 'bsc' : 'ethereum';
         // ✅ 修复：移除弃用的 mempool.merkle.io RPC，使用公共 RPC 作为默认值
@@ -78,23 +83,18 @@ export class MerkleClient {
      * 获取网络状态（用于 Bundle 参数优化）
      */
     async getNetworkStatus() {
-        const [currentBlock, feeData] = await Promise.all([
-            this.getBlockNumber(),
-            this.getFeeData()
-        ]);
+        const [currentBlock, feeData] = await Promise.all([this.getBlockNumber(), this.getFeeData()]);
         // 动态获取 gas price，并计算建议的最小值
         const baseGasPrice = feeData.gasPrice || feeData.maxFeePerGas || 3000000000n;
         // 建议至少提高 80% 以确保交易被打包
         const suggestedMinGasPrice = (baseGasPrice * 180n) / 100n;
         // BSC 平均 3 秒，Ethereum 平均 12 秒
-        const avgBlockTime = this.chainId === CHAINS.BSC.chainId
-            ? CHAINS.BSC.blockTime / 1000
-            : CHAINS.ETHEREUM.blockTime / 1000;
+        const avgBlockTime = this.chainId === CHAINS.BSC.chainId ? CHAINS.BSC.blockTime / 1000 : CHAINS.ETHEREUM.blockTime / 1000;
         return {
             currentBlock,
             gasPrice: baseGasPrice,
             suggestedMinGasPrice,
-            avgBlockTime
+            avgBlockTime,
         };
     }
     /**
@@ -139,11 +139,7 @@ export class MerkleClient {
             throw new Error('Invalid bundle result format');
         }
         catch (error) {
-            // 增强错误信息
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            const enhanced = new Error(`Send bundle failed: ${errorMsg}`);
-            Object.assign(enhanced, { cause: error });
-            throw enhanced;
+            throw new Error(`Send bundle failed: ${getErrorMessageFromUnknown(error)}`);
         }
     }
     /**
@@ -174,7 +170,7 @@ export class MerkleClient {
                     if (targetBlock <= currentBlock) {
                         if (autoRetry && attempt < maxRetries) {
                             attempt++;
-                            await new Promise(resolve => setTimeout(resolve, 300)); // 短暂延迟
+                            await new Promise((resolve) => setTimeout(resolve, 300)); // 短暂延迟
                             continue;
                         }
                         throw new Error(`Target block ${targetBlock} has already passed (current block: ${currentBlock})`);
@@ -196,7 +192,7 @@ export class MerkleClient {
                     maxTimestamp: options.maxTimestamp,
                 });
                 // ✅ 优化：并行提取交易哈希（map 比 for 循环更高效）
-                const txHashes = options.transactions.map(rawTx => {
+                const txHashes = options.transactions.map((rawTx) => {
                     try {
                         return Transaction.from(rawTx).hash || '';
                     }
@@ -212,15 +208,13 @@ export class MerkleClient {
                 };
             }
             catch (error) {
-                lastError = error instanceof Error ? error : new Error(String(error));
+                lastError = error;
                 // 如果启用了重试且还有重试次数
                 if (autoRetry && attempt < maxRetries) {
                     attempt++;
                     // 等待一个区块时间再重试
-                    const blockTime = this.chainId === CHAINS.BSC.chainId
-                        ? CHAINS.BSC.blockTime
-                        : CHAINS.ETHEREUM.blockTime;
-                    await new Promise(resolve => setTimeout(resolve, blockTime));
+                    const blockTime = this.chainId === CHAINS.BSC.chainId ? CHAINS.BSC.blockTime : CHAINS.ETHEREUM.blockTime;
+                    await new Promise((resolve) => setTimeout(resolve, blockTime));
                     continue;
                 }
                 // 没有重试或已达最大重试次数
@@ -228,7 +222,10 @@ export class MerkleClient {
             }
         }
         // 如果执行到这里，说明所有重试都失败了
-        throw lastError || new Error('Bundle submission failed after all retries');
+        if (lastError !== null && lastError !== undefined) {
+            throw lastError;
+        }
+        throw new Error('Bundle submission failed after all retries');
     }
     /**
      * 等待 Bundle 中的交易确认
@@ -280,7 +277,7 @@ export class MerkleClient {
                     index,
                     hash,
                     success: false,
-                    error: error instanceof Error ? error.message : String(error),
+                    error: getErrorMessageFromUnknown(error),
                 };
             }
         });
@@ -368,27 +365,26 @@ export class MerkleClient {
                 }
             }
             catch {
-                // 继续重试
+                // RPC 瞬时失败：继续下一轮轮询
             }
             // 等待下一次检查
-            await new Promise(resolve => setTimeout(resolve, intervalMs));
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
             attempts++;
         }
-        // 达到最大尝试次数
         return false;
     }
     /**
      * 获取当前 Provider 的统计信息（用于调试）
      */
     getProviderInfo() {
+        const rpcConnection = this.provider._getConnection?.();
         return {
             chainId: this.chainId,
             chainName: this.chainName,
-            rpcUrl: this.provider._getConnection?.().url || 'unknown',
+            rpcUrl: rpcConnection?.url ?? 'unknown',
         };
     }
 }
-MerkleClient.BLOCK_CACHE_TTL_MS = 1000; // 1秒缓存（BSC 约 3 秒出块，ETH 约 12 秒）
 /**
  * 创建 Merkle 客户端的便捷函数
  */

package/dist/shared/constants/addresses.d.ts

@@ -127,7 +127,7 @@ export declare const ENI_SPENDERS: {
  */
 export declare function getEniSpenders(mode?: boolean | 'all'): string[];
 export type ChainAddresses = keyof typeof ADDRESSES;
-export type AddressKey<C extends ChainAddresses> = keyof typeof ADDRESSES[C];
+export type AddressKey<C extends ChainAddresses> = keyof (typeof ADDRESSES)[C];
 /**
  * 获取指定链的合约地址
  */

package/dist/shared/constants/addresses.js

@@ -192,12 +192,21 @@ export const ENI_SPENDERS = {
  */
 export function getEniSpenders(mode = false) {
     if (mode === 'all' && ENI_SPENDERS.BATCH_ROUTER) {
-        return [ENI_SPENDERS.DIRECT.DAOAAS_PORTAL, ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER, ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER, ENI_SPENDERS.BATCH_ROUTER];
+        return [
+            ENI_SPENDERS.DIRECT.DAOAAS_PORTAL,
+            ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER,
+            ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER,
+            ENI_SPENDERS.BATCH_ROUTER,
+        ];
     }
     if (mode === true && ENI_SPENDERS.BATCH_ROUTER) {
         return [ENI_SPENDERS.BATCH_ROUTER];
     }
-    return [ENI_SPENDERS.DIRECT.DAOAAS_PORTAL, ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER, ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER];
+    return [
+        ENI_SPENDERS.DIRECT.DAOAAS_PORTAL,
+        ENI_SPENDERS.DIRECT.DSWAP_V2_ROUTER,
+        ENI_SPENDERS.DIRECT.IROSWAP_V2_ROUTER,
+    ];
 }
 // ============================================================================
 // 工具函数

package/dist/shared/constants/chains.d.ts

@@ -107,7 +107,7 @@ export declare const CHAINS: {
 };
 export declare const CHAIN_ID_MAP: Record<string, number>;
 export type ChainKey = keyof typeof CHAINS;
-export type ChainConfig = typeof CHAINS[ChainKey];
+export type ChainConfig = (typeof CHAINS)[ChainKey];
 /**
  * 根据 chainId 获取链配置
  */

package/dist/shared/constants/chains.js

@@ -132,7 +132,7 @@ export const CHAIN_ID_MAP = {
  * 根据 chainId 获取链配置
  */
 export function getChainById(chainId) {
-    return Object.values(CHAINS).find(c => c.chainId === chainId);
+    return Object.values(CHAINS).find((c) => c.chainId === chainId);
 }
 /**
  * 根据 chainId 获取链名称

package/dist/shared/constants/gas.d.ts

@@ -63,7 +63,7 @@ export declare const V3_FEE_TIERS: {
     readonly HIGH: 10000;
 };
 export type GasLimitKey = keyof typeof GAS_LIMITS;
-export type V3FeeTier = typeof V3_FEE_TIERS[keyof typeof V3_FEE_TIERS];
+export type V3FeeTier = (typeof V3_FEE_TIERS)[keyof typeof V3_FEE_TIERS];
 /**
  * 根据链和交易类型计算 gas limit
  */

package/dist/shared/constants/gas.js

@@ -90,9 +90,7 @@ export function calculateGasLimit(chainId, isNative, hasHops = false, hopCount =
     }
     // 有多跳时，基础 gas + 每跳额外 gas
     if (hasHops && hopCount > 0) {
-        const hopGas = isNative
-            ? GAS_LIMITS.NATIVE_TRANSFER
-            : GAS_LIMITS.ERC20_TRANSFER;
+        const hopGas = isNative ? GAS_LIMITS.NATIVE_TRANSFER : GAS_LIMITS.ERC20_TRANSFER;
         return GAS_LIMITS.TRADE + hopGas * BigInt(hopCount);
     }
     // 普通转账
@@ -108,9 +106,7 @@ export function calculateGasLimit(chainId, isNative, hasHops = false, hopCount =
  */
 export function getTransferGasLimit(chainId, isNative) {
     if (isNative) {
-        return chainId === CHAINS.XLAYER.chainId
-            ? GAS_LIMITS.XLAYER_NATIVE_TRANSFER
-            : GAS_LIMITS.NATIVE_TRANSFER;
+        return chainId === CHAINS.XLAYER.chainId ? GAS_LIMITS.XLAYER_NATIVE_TRANSFER : GAS_LIMITS.NATIVE_TRANSFER;
     }
     return GAS_LIMITS.ERC20_TRANSFER;
 }

package/dist/shared/constants/index.d.ts

@@ -10,5 +10,6 @@
  */
 export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, type ChainKey, type ChainConfig, } from './chains.js';
 export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, type GasLimitKey, type V3FeeTier, } from './gas.js';
+export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, type QuoteConfigChain } from './quote.js';
 export { ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, ENI_SPENDERS, getEniSpenders, type ChainAddresses, type AddressKey, } from './addresses.js';
 export { PROFIT_CONFIG, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, type ProfitRateKey, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, } from './profit.js';

package/dist/shared/constants/index.js

@@ -16,6 +16,7 @@ export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isK
 // Gas 常量
 // ============================================================================
 export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, } from './gas.js';
+export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS } from './quote.js';
 // ============================================================================
 // 合约地址
 // ============================================================================

package/dist/shared/constants/quote.d.ts

@@ -0,0 +1,30 @@
+/** DEX 报价链配置（V2 Router / V3 Quoter / 包装原生币 / 稳定币） */
+export declare const QUOTE_CONFIG: {
+    readonly BSC: {
+        readonly v2Router: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+        readonly v3Quoter: "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997";
+        readonly wrappedNative: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+        readonly stableCoins: readonly ["0x55d398326f99059fF775485246999027B3197955", "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d", "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56"];
+    };
+    readonly MONAD: {
+        readonly v2Router: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+        readonly v3Quoter: "";
+        readonly wrappedNative: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+        readonly stableCoins: readonly [];
+    };
+    readonly XLAYER: {
+        readonly v2Router: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+        readonly v3Quoter: "0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e";
+        readonly wrappedNative: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+        readonly stableCoins: readonly ["0x1E4a5963aBFD975d8c9021ce480b42188849D41d", "0x74b7f16337b8972027f6196a17a631ac6de26d22", "0x779ded0c9e1022225f8e0630b35a9b54be713736"];
+    };
+    readonly ENI: {
+        readonly v2Router: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
+        readonly v3Quoter: "";
+        readonly wrappedNative: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";
+        readonly stableCoins: readonly ["0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a", "0xaFF944b96c1BAEA587159ec446280E468B32ee15"];
+    };
+};
+/** V3 报价尝试费率列表（与 `gas.V3_FEE_TIERS` 命名对象区分） */
+export declare const QUOTE_V3_FEE_TIERS: readonly [100, 500, 2500, 10000];
+export type QuoteConfigChain = keyof typeof QUOTE_CONFIG;

package/dist/shared/constants/quote.js

@@ -0,0 +1,37 @@
+/** DEX 报价链配置（V2 Router / V3 Quoter / 包装原生币 / 稳定币） */
+export const QUOTE_CONFIG = {
+    BSC: {
+        v2Router: '0x10ED43C718714eb63d5aA57B78B54704E256024E',
+        v3Quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997',
+        wrappedNative: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+        stableCoins: [
+            '0x55d398326f99059fF775485246999027B3197955',
+            '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+            '0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56',
+        ],
+    },
+    MONAD: {
+        v2Router: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9',
+        v3Quoter: '',
+        wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a',
+        stableCoins: [],
+    },
+    XLAYER: {
+        v2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e',
+        v3Quoter: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e',
+        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b',
+        stableCoins: [
+            '0x1E4a5963aBFD975d8c9021ce480b42188849D41d',
+            '0x74b7f16337b8972027f6196a17a631ac6de26d22',
+            '0x779ded0c9e1022225f8e0630b35a9b54be713736',
+        ],
+    },
+    ENI: {
+        v2Router: '0x97ed8be49d9a8b86247090aa41e908e76b8fcf22',
+        v3Quoter: '',
+        wrappedNative: '0x6d1e851446f4d004ae2a72f9afed85e8829a205e',
+        stableCoins: ['0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a', '0xaFF944b96c1BAEA587159ec446280E468B32ee15'],
+    },
+};
+/** V3 报价尝试费率列表（与 `gas.V3_FEE_TIERS` 命名对象区分） */
+export const QUOTE_V3_FEE_TIERS = [100, 500, 2500, 10000];

package/dist/shared/flap/__tests__/curve.test.js

@@ -28,7 +28,7 @@ describe('CDPV2', () => {
             const curve = CDPV2.getCurve(0.1);
             const supply = curve.estimateSupply('1000000');
             expect(supply.toUnsafeFloat()).toBeGreaterThan(0);
-            expect(supply.toUnsafeFloat()).toBeLessThan(1000000000);
+            expect(supply.toUnsafeFloat()).toBeLessThan(1_000_000_000);
         });
     });
     describe('estimateReserve', () => {
@@ -51,7 +51,7 @@ describe('CDPV2', () => {
             const supply = curve.estimateSupply(initialReserve);
             const reserveBack = curve.estimateReserve(supply.toString());
             // Allow small rounding differences
-            const diff = Math.abs(reserveBack.toUnsafeFloat() - 1000000);
+            const diff = Math.abs(reserveBack.toUnsafeFloat() - 1_000_000);
             expect(diff).toBeLessThan(1);
         });
     });
@@ -74,7 +74,7 @@ describe('CDPV2', () => {
             const supply = '500000000';
             const p = curve.price(supply);
             const f = curve.fdv(supply);
-            expect(f.toUnsafeFloat()).toBeCloseTo(p.toUnsafeFloat() * 1000000000, -3);
+            expect(f.toUnsafeFloat()).toBeCloseTo(p.toUnsafeFloat() * 1_000_000_000, -3);
         });
     });
     describe('defaultDexSupplyThreshold', () => {

package/dist/shared/flap/abi.js

@@ -9,5 +9,5 @@ export const PORTAL_EVENTS_ABI = [
     'event FlapTokenTaxSet(address token, uint256 tax)',
     'event FlapTokenCirculatingSupplyChanged(address token, uint256 newSupply)',
     'event LaunchedToDEX(address token, address pool, uint256 amount, uint256 eth)',
-    'event TokenExtensionEnabled(address token, bytes32 extensionID, address extensionAddress, uint8 version)'
+    'event TokenExtensionEnabled(address token, bytes32 extensionID, address extensionAddress, uint8 version)',
 ];

package/dist/shared/flap/constants.d.ts

@@ -125,4 +125,4 @@ export declare const FLAP_TOTAL_SUPPLY: bigint;
  * 零地址（用于表示原生代币）
  * ✅ 从公共模块重新导出
  */
-export { ZERO_ADDRESS } from '../../utils/constants.js';
+export { ZERO_ADDRESS } from '../constants/index.js';

package/dist/shared/flap/constants.js

@@ -135,9 +135,9 @@ export const FLAP_DEX_THRESHOLDS = {
 /**
  * 代币总供应量（固定为 10 亿）
  */
-export const FLAP_TOTAL_SUPPLY = BigInt(1000000000) * BigInt(10 ** 18);
+export const FLAP_TOTAL_SUPPLY = BigInt(1_000_000_000) * BigInt(10 ** 18);
 /**
  * 零地址（用于表示原生代币）
  * ✅ 从公共模块重新导出
  */
-export { ZERO_ADDRESS } from '../../utils/constants.js';
+export { ZERO_ADDRESS } from '../constants/index.js';

package/dist/shared/flap/curve.js

@@ -10,6 +10,9 @@ import { FixedNumber } from 'ethers';
  */
 const BILLION = FixedNumber.fromString('1000000000');
 export class CDPV2 {
+    r;
+    h;
+    k;
     static defaultDexSupplyThreshold() {
         return FixedNumber.fromString('800000000');
     }

package/dist/shared/flap/errors.d.ts

@@ -1,6 +1,3 @@
-/**
- * Flap Protocol 错误代码
- */
 export type FlapErrorCode = 'TOKEN_ALREADY_EXISTS' | 'TOKEN_NOT_FOUND' | 'TOKEN_NOT_TRADABLE' | 'ALREADY_ON_DEX' | 'INSUFFICIENT_BALANCE' | 'SLIPPAGE_EXCEEDED' | 'INVALID_TOKEN' | 'INVALID_QUOTE_TOKEN' | 'INVALID_AMOUNT' | 'TAX_RATE_TOO_HIGH' | 'PERMIT_EXPIRED' | 'PERMIT_INVALID' | 'UNKNOWN_ERROR';
 /**
  * 解析 Flap Protocol 错误信息
@@ -12,7 +9,7 @@ export type FlapErrorCode = 'TOKEN_ALREADY_EXISTS' | 'TOKEN_NOT_FOUND' | 'TOKEN_
  * ```typescript
  * try {
  *   await portal.swapExactInput(...);
- * } catch (err: any) {
+ * } catch (err) {
  *   const errorCode = parseFlapError(err);
  *   if (errorCode === 'SLIPPAGE_EXCEEDED') {
  *     console.log('滑点过大，请调整参数');

package/dist/shared/flap/errors.js

@@ -1,3 +1,7 @@
+/**
+ * Flap Protocol 错误代码
+ */
+import { getErrorMessageFromUnknown } from '../foundation/normalize-unknown.js';
 /**
  * 解析 Flap Protocol 错误信息
  *
@@ -8,7 +12,7 @@
  * ```typescript
  * try {
  *   await portal.swapExactInput(...);
- * } catch (err: any) {
+ * } catch (err) {
  *   const errorCode = parseFlapError(err);
  *   if (errorCode === 'SLIPPAGE_EXCEEDED') {
  *     console.log('滑点过大，请调整参数');
@@ -17,8 +21,7 @@
  * ```
  */
 export function parseFlapError(error) {
-    const withMessage = error;
-    const msg = withMessage.message || withMessage.data?.message || String(error);
+    const msg = getFlapErrorText(error);
     const msgLower = msg.toLowerCase();
     // Token 状态相关错误
     if (msgLower.includes('token already exists') || msgLower.includes('already created')) {
@@ -61,6 +64,21 @@ export function parseFlapError(error) {
     // 无法识别的错误
     return null;
 }
+function getFlapErrorText(error) {
+    if (error !== null && typeof error === 'object') {
+        const record = error;
+        const topLevel = record.message;
+        if (typeof topLevel === 'string' && topLevel)
+            return topLevel;
+        const data = record.data;
+        if (data !== null && typeof data === 'object') {
+            const nestedMessage = data.message;
+            if (typeof nestedMessage === 'string' && nestedMessage)
+                return nestedMessage;
+        }
+    }
+    return getErrorMessageFromUnknown(error);
+}
 /**
  * 获取错误的友好提示信息（中文）
  *

package/dist/shared/flap/index.d.ts

@@ -11,11 +11,11 @@ type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type
 export { CDPV2 } from './curve.js';
 export { buildPermitPiggybackAuto } from './permit.js';
 export { uploadTokenMeta, type TokenMetaInput } from './ipfs.js';
-export { PinataClient, type PinataConfig, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp } from './pinata.js';
+export { PinataClient, type PinataConfig, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp, } from './pinata.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './vanity.js';
 export { getFlapMetaByAddress, getFlapMetasByAddresses } from './meta.js';
 export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn, type FlapErrorCode } from './errors.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES } from './constants.js';
+export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES, } from './constants.js';
 export * from './abi.js';
 export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, type FlapBundleConfig, type FlapChainForBundle, type FlapCreateWithBundleBuyParams, type FlapCreateWithBundleBuyResult, type FlapBatchBuyParams, type FlapBatchBuyResult, type FlapBatchSellParams, type FlapBatchSellResult, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, type FlapPrivateBuyParams, type FlapPrivateSellParams, type FlapBatchPrivateBuyParams, type FlapBatchPrivateSellParams, type FlapBatchPrivateSellResult, } from './portal-bundle.js';
 export * from './portal-bundle-merkle/index.js';

package/dist/shared/flap/index.js

@@ -11,11 +11,11 @@ export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, Tok
 export { CDPV2 } from './curve.js';
 export { buildPermitPiggybackAuto } from './permit.js';
 export { uploadTokenMeta } from './ipfs.js';
-export { PinataClient, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob } from './pinata.js';
+export { PinataClient, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, } from './pinata.js';
 export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './vanity.js';
 export { getFlapMetaByAddress, getFlapMetasByAddresses } from './meta.js';
 export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn } from './errors.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES } from './constants.js';
+export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES, } from './constants.js';
 export * from './abi.js';
 // Bundle 功能
 export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, } from './portal-bundle.js';