four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/shared/abis/common.js

@@ -1,254 +1,4 @@
 /**
- * 公共 ABI 定义
- *
- * 将重复的 ABI 提取到这里，统一管理
+ * @deprecated 兼容路径 — 唯一数据源见 `src/abis/common.ts`
  */
-// ============================================================================
-// ERC20 ABI
-// ============================================================================
-/** 完整 ERC20 ABI */
-export const ERC20_ABI = [
-    'function approve(address spender, uint256 amount) external returns (bool)',
-    'function allowance(address owner, address spender) external view returns (uint256)',
-    'function balanceOf(address account) external view returns (uint256)',
-    'function decimals() external view returns (uint8)',
-    'function name() external view returns (string)',
-    'function symbol() external view returns (string)',
-    'function totalSupply() external view returns (uint256)',
-    'function transfer(address to, uint256 amount) external returns (bool)',
-    'function transferFrom(address from, address to, uint256 amount) external returns (bool)',
-];
-/** 精简 ERC20 ABI（余额查询 + decimals） */
-export const ERC20_BALANCE_ABI = [
-    'function balanceOf(address account) external view returns (uint256)',
-    'function decimals() external view returns (uint8)',
-];
-/** ERC20 授权相关 ABI */
-export const ERC20_ALLOWANCE_ABI = [
-    'function allowance(address owner, address spender) external view returns (uint256)',
-    'function approve(address spender, uint256 amount) external returns (bool)',
-    'function decimals() external view returns (uint8)',
-];
-// ============================================================================
-// Multicall3 ABI
-// ============================================================================
-export const MULTICALL3_ABI = [
-    // ✅ 标记为 view，确保 ethers.js v6 使用 call 而不是 sendTransaction
-    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) view returns (tuple(bool success, bytes returnData)[])',
-    'function aggregate(tuple(address target, bytes callData)[] calls) view returns (uint256 blockNumber, bytes[] returnData)',
-    'function getEthBalance(address addr) view returns (uint256 balance)',
-];
-// ============================================================================
-// PancakeSwap / Uniswap V2 Router ABI
-// ============================================================================
-/** V2 Router 完整 ABI */
-export const V2_ROUTER_ABI = [
-    // BNB/ETH → Token (买入)
-    'function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable returns (uint[] memory amounts)',
-    'function swapExactETHForTokensSupportingFeeOnTransferTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable',
-    // Token → BNB/ETH (卖出)
-    'function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
-    'function swapExactTokensForETHSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
-    // Token → Token
-    'function swapExactTokensForTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
-    'function swapExactTokensForTokensSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
-    // 报价
-    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)',
-    'function getAmountsIn(uint amountOut, address[] calldata path) external view returns (uint[] memory amounts)',
-    // Factory
-    'function factory() external view returns (address)',
-];
-/** V2 Router 精简 ABI（只用于报价） */
-export const V2_ROUTER_QUOTE_ABI = [
-    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)',
-];
-// ============================================================================
-// PancakeSwap / Uniswap V3 Router ABI (SwapRouter02)
-// ============================================================================
-/** V3 SwapRouter02 ABI（新版，deadline 在 multicall 中传递） */
-export const V3_ROUTER02_ABI = [
-    // exactInputSingle - 单跳，不含 deadline
-    {
-        "inputs": [{
-                "components": [
-                    { "name": "tokenIn", "type": "address" },
-                    { "name": "tokenOut", "type": "address" },
-                    { "name": "fee", "type": "uint24" },
-                    { "name": "recipient", "type": "address" },
-                    { "name": "amountIn", "type": "uint256" },
-                    { "name": "amountOutMinimum", "type": "uint256" },
-                    { "name": "sqrtPriceLimitX96", "type": "uint160" }
-                ],
-                "name": "params",
-                "type": "tuple"
-            }],
-        "name": "exactInputSingle",
-        "outputs": [{ "name": "amountOut", "type": "uint256" }],
-        "stateMutability": "payable",
-        "type": "function"
-    },
-    // exactInput - 多跳，不含 deadline
-    {
-        "inputs": [{
-                "components": [
-                    { "name": "path", "type": "bytes" },
-                    { "name": "recipient", "type": "address" },
-                    { "name": "amountIn", "type": "uint256" },
-                    { "name": "amountOutMinimum", "type": "uint256" }
-                ],
-                "name": "params",
-                "type": "tuple"
-            }],
-        "name": "exactInput",
-        "outputs": [{ "name": "amountOut", "type": "uint256" }],
-        "stateMutability": "payable",
-        "type": "function"
-    },
-    // multicall - 带 deadline 版本
-    'function multicall(uint256 deadline, bytes[] calldata data) external payable returns (bytes[] memory results)',
-    'function refundETH() external payable',
-    'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
-];
-/** V3 SwapRouter 旧版 ABI（deadline 在 struct 内部） */
-export const V3_ROUTER_LEGACY_ABI = [
-    // exactInputSingle - 包含 deadline
-    {
-        "inputs": [{
-                "components": [
-                    { "name": "tokenIn", "type": "address" },
-                    { "name": "tokenOut", "type": "address" },
-                    { "name": "fee", "type": "uint24" },
-                    { "name": "recipient", "type": "address" },
-                    { "name": "deadline", "type": "uint256" },
-                    { "name": "amountIn", "type": "uint256" },
-                    { "name": "amountOutMinimum", "type": "uint256" },
-                    { "name": "sqrtPriceLimitX96", "type": "uint160" }
-                ],
-                "name": "params",
-                "type": "tuple"
-            }],
-        "name": "exactInputSingle",
-        "outputs": [{ "name": "amountOut", "type": "uint256" }],
-        "stateMutability": "payable",
-        "type": "function"
-    },
-    // multicall - 不带 deadline 版本
-    'function multicall(bytes[] calldata data) external payable returns (bytes[] memory results)',
-    'function refundETH() external payable',
-    'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
-];
-// ============================================================================
-// SwapRouter02 V2 方法 ABI (PotatoSwap/DYORSwap 等)
-// ============================================================================
-/**
- * SwapRouter02 的 V2 方法 ABI
- *
- * 注意：SwapRouter02 的 V2 方法只有 token-to-token 交换
- * 没有 swapExactETHForTokens / swapExactTokensForETH
- * 必须通过 multicall 组合 wrapETH/unwrapWETH9 来处理原生代币
- */
-export const SWAP_ROUTER02_V2_ABI = [
-    // V2 交换方法（只有 token-to-token）
-    'function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] calldata path, address to) external payable returns (uint256 amountOut)',
-    'function swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] calldata path, address to) external payable returns (uint256 amountIn)',
-    // Multicall - 多种重载
-    'function multicall(uint256 deadline, bytes[] calldata data) external payable returns (bytes[] memory results)',
-    'function multicall(bytes32 previousBlockhash, bytes[] calldata data) external payable returns (bytes[] memory results)',
-    'function multicall(bytes[] calldata data) external payable returns (bytes[] memory results)',
-    // 辅助方法 - ETH/WETH 转换
-    'function wrapETH(uint256 value) external payable',
-    'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
-    'function unwrapWETH9(uint256 amountMinimum) external payable',
-    'function refundETH() external payable',
-    // 代币操作
-    'function pull(address token, uint256 value) external payable',
-    'function sweepToken(address token, uint256 amountMinimum, address recipient) external payable',
-    'function sweepToken(address token, uint256 amountMinimum) external payable',
-];
-// ============================================================================
-// V3 Quoter ABI
-// ============================================================================
-/** V3 QuoterV2 ABI */
-export const V3_QUOTER_ABI = [
-    {
-        "inputs": [{
-                "components": [
-                    { "name": "tokenIn", "type": "address" },
-                    { "name": "tokenOut", "type": "address" },
-                    { "name": "amountIn", "type": "uint256" },
-                    { "name": "fee", "type": "uint24" },
-                    { "name": "sqrtPriceLimitX96", "type": "uint160" }
-                ],
-                "name": "params",
-                "type": "tuple"
-            }],
-        "name": "quoteExactInputSingle",
-        "outputs": [
-            { "name": "amountOut", "type": "uint256" },
-            { "name": "sqrtPriceX96After", "type": "uint160" },
-            { "name": "initializedTicksCrossed", "type": "uint32" },
-            { "name": "gasEstimate", "type": "uint256" }
-        ],
-        "stateMutability": "nonpayable",
-        "type": "function"
-    }
-];
-// ============================================================================
-// Uniswap V2 Factory & Pair ABI
-// ============================================================================
-export const V2_FACTORY_ABI = [
-    'function getPair(address tokenA, address tokenB) external view returns (address pair)',
-];
-export const V2_PAIR_ABI = [
-    'function token0() external view returns (address)',
-    'function token1() external view returns (address)',
-    'function getReserves() external view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast)',
-];
-// ============================================================================
-// Uniswap V3 Factory & Pool ABI
-// ============================================================================
-export const V3_FACTORY_ABI = [
-    'function getPool(address tokenA, address tokenB, uint24 fee) external view returns (address pool)',
-];
-export const V3_POOL_ABI = [
-    'function token0() external view returns (address)',
-    'function token1() external view returns (address)',
-    'function fee() external view returns (uint24)',
-    'function slot0() external view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)',
-];
-// ============================================================================
-// Flap Portal ABI
-// ============================================================================
-export const FLAP_PORTAL_ABI = [
-    // 创建代币
-    'function newToken(string name, string symbol, string meta) external payable returns (address)',
-    'function newTokenV2((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData)) external payable returns (address)',
-    'function newTokenV3((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData)) external payable returns (address)',
-    // ✅ V4：支持 dexId / lpFeeProfile（与 portal-bundle-merkle/core.ts 的 newTokenV4.populateTransaction 对齐）
-    'function newTokenV4((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile)) external payable returns (address)',
-    // ✅ V5：Tax Token V2 高级税收分配
-    'function newTokenV5((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile,uint64 taxDuration,uint64 antiFarmerDuration,uint16 mktBps,uint16 deflationBps,uint16 dividendBps,uint16 lpBps,uint256 minimumShareBalance)) external payable returns (address)',
-    // 交易
-    'function swapExactInput((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external payable returns (uint256)',
-    // ✅ V3：支持 extensionData（注意：这里的 V3 指“扩展交易接口版本”，不是“外盘 V3 池子”）
-    'function swapExactInputV3((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData,bytes extensionData)) external payable returns (uint256)',
-    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external view returns (uint256)',
-    // 旧版兼容
-    'function buy(address token, uint256 minReceived) external payable returns (uint256)',
-    'function sell(address token, uint256 sellAmount, uint256 minReceived) external returns (uint256)',
-];
-// ============================================================================
-// Four TokenManager ABI
-// ============================================================================
-export const TM2_ABI = [
-    // 新版方法（Four.meme TokenManager2）
-    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) external payable',
-    'function sellToken(uint256 origin, address token, uint256 amount, uint256 minFunds) external',
-    // 旧版兼容方法
-    'function buy(address token, uint256 minReceived) external payable returns (uint256)',
-    'function sell(address token, uint256 sellAmount, uint256 minReceived) external returns (uint256)',
-    'function trySell(address token, uint256 sellAmount) external view returns (uint256)',
-];
-export const HELPER3_ABI = [
-    'function getTokenInfo(address token) external view returns (tuple(address addr, string name, string symbol, uint8 decimals, uint256 totalSupply, uint256 balance, uint256 price, uint256 marketCap))',
-];
+export * from '../../abis/common.js';

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

@@ -1,6 +1,5 @@
-import TokenManager from './TokenManager.json';
-import TokenManager2 from './TokenManager2.json';
-import TokenManagerHelper3 from './TokenManagerHelper3.json';
-import TaxToken from './TaxToken.json';
-export { TokenManager, TokenManager2, TokenManagerHelper3, TaxToken };
-export * from './common.js';
+/**
+ * ABI 导出（兼容路径：历史代码多从此处 import）。
+ * 唯一数据源见 `src/abis/`。
+ */
+export * from '../../abis/index.js';

package/dist/shared/abis/index.js

@@ -1,7 +1,5 @@
-import TokenManager from './TokenManager.json' with { type: 'json' };
-import TokenManager2 from './TokenManager2.json' with { type: 'json' };
-import TokenManagerHelper3 from './TokenManagerHelper3.json' with { type: 'json' };
-import TaxToken from './TaxToken.json' with { type: 'json' };
-export { TokenManager, TokenManager2, TokenManagerHelper3, TaxToken };
-// ✅ 公共 ABI 导出
-export * from './common.js';
+/**
+ * ABI 导出（兼容路径：历史代码多从此处 import）。
+ * 唯一数据源见 `src/abis/`。
+ */
+export * from '../../abis/index.js';

package/dist/shared/clients/blockrazor.js

@@ -27,6 +27,7 @@
  */
 import { JsonRpcProvider, Transaction, ethers } from 'ethers';
 import { GAS_LIMITS } from '../constants/index.js';
+import { getErrorMessageFromUnknown } from '../foundation/index.js';
 // ============================================================================
 // 常量
 // ============================================================================
@@ -55,9 +56,14 @@ const MIN_GAS_PRICE_GWEI = 0.05;
  * BlockRazor 客户端
  */
 export class BlockRazorClient {
+    provider;
+    chainId;
+    apiKey;
+    builderUrl;
+    // 区块号缓存
+    blockNumberCache = null;
+    static BLOCK_CACHE_TTL_MS = 1000; // 1秒缓存
     constructor(config) {
-        // 区块号缓存
-        this.blockNumberCache = null;
         this.chainId = config.chainId;
         this.apiKey = config.apiKey;
         // 普通 RPC（用于查询）
@@ -114,7 +120,7 @@ export class BlockRazorClient {
     async buildIncentiveTransaction(params) {
         const { wallet, amount, nonce, gasPrice } = params;
         // 获取 nonce（使用 pending 确保包含待处理交易）
-        const txNonce = nonce ?? await this.provider.getTransactionCount(wallet.address, 'pending');
+        const txNonce = nonce ?? (await this.provider.getTransactionCount(wallet.address, 'pending'));
         // 获取 gas price
         let txGasPrice = gasPrice;
         if (!txGasPrice) {
@@ -152,6 +158,7 @@ export class BlockRazorClient {
                 const gasPrice = tx.gasPrice || 0n;
                 const minGasPrice = ethers.parseUnits(String(MIN_GAS_PRICE_GWEI), 'gwei');
                 if (gasPrice < minGasPrice) {
+                    throw new Error(`Transaction gas price (${ethers.formatUnits(gasPrice, 'gwei')} gwei) is below minimum (${MIN_GAS_PRICE_GWEI} gwei)`);
                 }
             }
             catch {
@@ -183,7 +190,7 @@ export class BlockRazorClient {
                 jsonrpc: '2.0',
                 id: '1',
                 method: 'eth_sendBundle',
-                params: [bundleParams]
+                params: [bundleParams],
             };
             const headers = {
                 'Content-Type': 'application/json',
@@ -202,12 +209,23 @@ export class BlockRazorClient {
                 throw new Error(`HTTP ${response.status}: ${text}`);
             }
             const result = await response.json();
+            if (typeof result !== 'object' || result === null) {
+                throw new Error('Invalid JSON-RPC response');
+            }
+            const rpc = result;
             // 检查 JSON-RPC 错误
-            if (result.error) {
-                throw new Error(`RPC Error: ${result.error.message || JSON.stringify(result.error)}`);
+            if (rpc.error != null) {
+                const er = rpc.error;
+                const rpcMsg = typeof er === 'object' &&
+                    er !== null &&
+                    'message' in er &&
+                    typeof er.message === 'string'
+                    ? er.message
+                    : JSON.stringify(er);
+                throw new Error(`RPC Error: ${rpcMsg}`);
             }
             // 提取 bundle hash
-            const bundleHash = result.result;
+            const bundleHash = rpc.result;
             if (typeof bundleHash === 'string') {
                 return bundleHash;
             }
@@ -216,10 +234,10 @@ export class BlockRazorClient {
                     return String(bundleHash.bundleHash);
                 }
             }
-            return JSON.stringify(result.result || result);
+            return JSON.stringify(rpc.result ?? rpc);
         }
         catch (error) {
-            const errorMsg = error.message || String(error);
+            const errorMsg = getErrorMessageFromUnknown(error);
             console.error(`❌ [BlockRazor] Bundle 发送失败: ${errorMsg}`);
             throw new Error(`BlockRazor send bundle failed: ${errorMsg}`);
         }
@@ -257,7 +275,7 @@ export class BlockRazorClient {
                     noMerge: options.noMerge,
                 });
                 // 提取交易哈希
-                const txHashes = options.transactions.map(rawTx => {
+                const txHashes = options.transactions.map((rawTx) => {
                     try {
                         return Transaction.from(rawTx).hash || '';
                     }
@@ -276,13 +294,16 @@ export class BlockRazorClient {
                 lastError = error;
                 if (autoRetry && attempt < maxRetries) {
                     attempt++;
-                    await new Promise(resolve => setTimeout(resolve, 3000)); // 等待一个区块
+                    await new Promise((resolve) => setTimeout(resolve, 3000)); // 等待一个区块
                     continue;
                 }
                 throw error;
             }
         }
-        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（自动添加激励交易）
@@ -348,7 +369,7 @@ export class BlockRazorClient {
                     index,
                     hash,
                     success: false,
-                    error: error.message,
+                    error: getErrorMessageFromUnknown(error),
                 };
             }
         });
@@ -439,7 +460,7 @@ export class BlockRazorClient {
                     return { index: globalIndex, hash: txResponse.hash, error: null };
                 }
                 catch (err) {
-                    const errorMsg = err?.message || String(err);
+                    const errorMsg = getErrorMessageFromUnknown(err);
                     console.warn(`[broadcastParallel] 交易 ${globalIndex} 广播失败:`, errorMsg);
                     return { index: globalIndex, hash: '', error: errorMsg };
                 }
@@ -488,33 +509,29 @@ export class BlockRazorClient {
                 // 广播交易
                 const txResponse = await provider.broadcastTransaction(rawTx);
                 txHashes.push(txResponse.hash);
-                console.log(`[broadcastSequential] 交易 ${i}/${signedTransactions.length} 广播成功: ${txResponse.hash.slice(0, 10)}...`);
                 // 如果需要等待确认
                 if (waitConfirmation) {
                     try {
                         const receipt = await provider.waitForTransaction(txResponse.hash, 1, confirmationTimeout);
-                        if (receipt && receipt.status === 1) {
-                            console.log(`[broadcastSequential] 交易 ${i} 确认成功，区块: ${receipt.blockNumber}`);
-                        }
-                        else if (receipt && receipt.status === 0) {
+                        if (receipt && receipt.status === 0) {
                             console.warn(`[broadcastSequential] 交易 ${i} 执行失败（revert）`);
                             errors.push({ index: i, error: 'Transaction reverted' });
                         }
                     }
                     catch (waitErr) {
-                        console.warn(`[broadcastSequential] 交易 ${i} 等待确认超时:`, waitErr?.message);
+                        console.warn(`[broadcastSequential] 交易 ${i} 等待确认超时:`, getErrorMessageFromUnknown(waitErr));
                         // 超时不算失败，交易可能还在 pending
                     }
                 }
                 else {
                     // 不等待确认，只加一个小延迟确保 RPC 处理完成
                     if (broadcastDelay > 0 && i < signedTransactions.length - 1) {
-                        await new Promise(resolve => setTimeout(resolve, broadcastDelay));
+                        await new Promise((resolve) => setTimeout(resolve, broadcastDelay));
                     }
                 }
             }
             catch (err) {
-                const errorMsg = err?.message || String(err);
+                const errorMsg = getErrorMessageFromUnknown(err);
                 console.warn(`[broadcastSequential] 交易 ${i} 广播失败:`, errorMsg);
                 errors.push({ index: i, error: errorMsg });
                 // 如果是 nonce 问题，后续交易也会失败，提前终止
@@ -566,12 +583,10 @@ export class BlockRazorClient {
             return false;
         })();
         if (hasMultipleFromSameWallet) {
-            console.log(`[broadcastSmart] 检测到同一钱包多笔交易，使用顺序广播`);
             const result = await this.broadcastTransactionsSequential(signedTransactions, options);
             return { ...result, mode: 'sequential' };
         }
         else {
-            console.log(`[broadcastSmart] 所有交易来自不同钱包，使用并行广播`);
             const result = await this.broadcastTransactionsParallel(signedTransactions, { provider: options?.provider });
             return { ...result, mode: 'parallel' };
         }
@@ -587,7 +602,6 @@ export class BlockRazorClient {
         };
     }
 }
-BlockRazorClient.BLOCK_CACHE_TTL_MS = 1000; // 1秒缓存
 /**
  * 创建 BlockRazor 客户端的便捷函数
  */

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

@@ -127,8 +127,8 @@ export declare const BUILDER_CONTROL_EOA = "0x4848489f0b2BEdd788c696e2D79b6b69D7
  */
 export type AuctionFeedCallbacks = {
     onOpen?: () => void;
-    onMessage?: (data: any) => void;
-    onError?: (err: any) => void;
+    onMessage?: (data: unknown) => void;
+    onError?: (err: unknown) => void;
     onClose?: () => void;
 };
 export declare function createAuctionFeedClient(wsUrl: string, callbacks: AuctionFeedCallbacks): {

package/dist/shared/clients/club48.js

@@ -4,6 +4,8 @@ import { ethers } from 'ethers';
  * 48.club Bundle 客户端
  */
 export class Club48Client {
+    endpoint;
+    explorerEndpoint;
     constructor(config) {
         this.endpoint = config?.endpoint || 'https://puissant-bsc.48.club';
         this.explorerEndpoint = config?.explorerEndpoint || 'https://explore.48.club';
@@ -18,7 +20,7 @@ export class Club48Client {
      */
     static sign48SoulPoint(privateKey, txs) {
         // 1. 计算每笔交易的哈希
-        const txHashes = txs.map(tx => ethers.keccak256(tx));
+        const txHashes = txs.map((tx) => ethers.keccak256(tx));
         // 2. 连接所有哈希
         const concatenated = ethers.concat(txHashes);
         // 3. 对连接后的数据进行哈希
@@ -103,7 +105,7 @@ export class Club48Client {
         }
         // 添加 Soul Point 签名（优先：调用方直接提供；否则按 opts 生成）
         if (params.soulPointSignature) {
-            bundleParams["48spSign"] = params.soulPointSignature;
+            bundleParams['48spSign'] = params.soulPointSignature;
         }
         else if (opts && opts.spMode && opts.spMode !== 'none') {
             if (!opts.spPrivateKey) {
@@ -121,17 +123,17 @@ export class Club48Client {
             }
             if (opts.spVMode)
                 sig = Club48Client.normalizeSignatureV(sig, opts.spVMode);
-            bundleParams["48spSign"] = sig;
+            bundleParams['48spSign'] = sig;
         }
         // 添加 backrun 目标（如果提供）
         if (params.backrunTarget) {
             bundleParams.backrunTarget = params.backrunTarget;
         }
         const response = await axios.post(this.endpoint, {
-            jsonrpc: "2.0",
+            jsonrpc: '2.0',
             id: 1,
-            method: "eth_sendBundle",
-            params: [bundleParams]
+            method: 'eth_sendBundle',
+            params: [bundleParams],
         });
         if (response.data.error) {
             throw new Error(`48.club bundle failed: ${response.data.error.message}`);
@@ -146,10 +148,10 @@ export class Club48Client {
      */
     async sendPrivateTransaction(signedTx) {
         const response = await axios.post(this.endpoint, {
-            jsonrpc: "2.0",
+            jsonrpc: '2.0',
             id: 1,
-            method: "eth_sendPrivateRawTransaction",
-            params: [signedTx]
+            method: 'eth_sendPrivateRawTransaction',
+            params: [signedTx],
         });
         if (response.data.error) {
             throw new Error(`48.club tx failed: ${response.data.error.message}`);
@@ -168,7 +170,7 @@ export class Club48Client {
     async sendPrivateTransactionWith48SP(signedTx, spPrivateKey, opts) {
         // 1) 生成 48SP 签名（默认使用 timestamp personal_sign）
         const mode = opts?.spMode ?? 'timestampPersonalSign';
-        let signature = '';
+        let signature;
         if (mode === 'timestampPersonalSign') {
             signature = await Club48Client.sign48SoulPointTimestamp(spPrivateKey, opts?.timestamp);
         }
@@ -179,10 +181,10 @@ export class Club48Client {
             signature = Club48Client.normalizeSignatureV(signature, opts.spVMode);
         // 2) 调用 48.club RPC
         const response = await axios.post(this.endpoint, {
-            jsonrpc: "2.0",
+            jsonrpc: '2.0',
             id: 1,
-            method: "eth_sendPrivateTransactionWith48SP",
-            params: [signedTx, signature]
+            method: 'eth_sendPrivateTransactionWith48SP',
+            params: [signedTx, signature],
         });
         if (response.data.error) {
             throw new Error(`48.club tx failed: ${response.data.error.message}`);
@@ -196,9 +198,9 @@ export class Club48Client {
      */
     async getMinGasPrice() {
         const response = await axios.post(this.endpoint, {
-            jsonrpc: "2.0",
+            jsonrpc: '2.0',
             id: 1,
-            method: "eth_gasPrice"
+            method: 'eth_gasPrice',
         });
         if (response.data.error) {
             throw new Error(`Get gas price failed: ${response.data.error.message}`);
@@ -237,12 +239,15 @@ export class Club48Client {
                     throw new Error(`Bundle failed to execute: ${JSON.stringify(status)}`);
                 }
                 // 等待 3 秒后重试
-                await new Promise(resolve => setTimeout(resolve, 3000));
+                await new Promise((resolve) => setTimeout(resolve, 3000));
             }
             catch (error) {
-                // 如果是 404 或网络错误，继续等待（可能是 explorer 还没索引到）
-                if (error.response?.status === 404 || error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND') {
-                    await new Promise(resolve => setTimeout(resolve, 3000));
+                const status = axios.isAxiosError(error) ? error.response?.status : undefined;
+                const nodeCode = typeof error === 'object' && error !== null && 'code' in error
+                    ? String(error.code ?? '')
+                    : '';
+                if (status === 404 || nodeCode === 'ECONNREFUSED' || nodeCode === 'ENOTFOUND') {
+                    await new Promise((resolve) => setTimeout(resolve, 3000));
                     continue;
                 }
                 // 其他错误，如果有最后状态且为 INCLUDED，返回成功
@@ -268,8 +273,8 @@ export class Club48Client {
             transaction: {
                 from: '0x0000000000000000000000000000000000000000',
                 gasPrice: '0',
-                nonce: 0
-            }
+                nonce: 0,
+            },
         };
     }
 }
@@ -282,11 +287,11 @@ export function createAuctionFeedClient(wsUrl, callbacks) {
     // 仅导出接口占位，避免引入 ws 依赖；用户可在应用层实现
     return {
         connect: () => {
-            callbacks.onOpen && callbacks.onOpen();
+            callbacks.onOpen?.();
         },
         close: () => {
-            callbacks.onClose && callbacks.onClose();
-        }
+            callbacks.onClose?.();
+        },
     };
 }
 /**
@@ -295,7 +300,7 @@ export function createAuctionFeedClient(wsUrl, callbacks) {
 export async function sendBatchPrivateTransactions(signedTxs, spPrivateKey, endpoint = 'https://puissant-bsc.48.club', opts) {
     // 1. 生成 48SP 签名
     const mode = opts?.spMode ?? 'timestampPersonalSign';
-    let signature = '';
+    let signature;
     if (mode === 'timestampPersonalSign') {
         signature = await Club48Client.sign48SoulPointTimestamp(spPrivateKey, opts?.timestamp);
     }
@@ -306,13 +311,13 @@ export async function sendBatchPrivateTransactions(signedTxs, spPrivateKey, endp
         signature = Club48Client.normalizeSignatureV(signature, opts.spVMode);
     // 2. 批量提交
     const response = await axios.post(endpoint, {
-        jsonrpc: "2.0",
+        jsonrpc: '2.0',
         id: 1,
-        method: "eth_sendBatchPrivateTransactionsWith48SP",
+        method: 'eth_sendBatchPrivateTransactionsWith48SP',
         params: [
             signedTxs, // 已签名的交易数组
-            signature // 48SP 签名
-        ]
+            signature, // 48SP 签名
+        ],
     });
     // 注意：批量方法不返回交易哈希，只确认接收
     if (response.data.error) {