four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/chains/xlayer/eoa/eoa-wash-volume.js

@@ -11,8 +11,9 @@
  * 支持池子类型：V2, V3
  */
 import { ethers, Wallet, Contract } from 'ethers';
-import { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell } from '../../../dex/direct-router.js';
-import { PROFIT_CONFIG } from '../../../utils/constants.js';
+import { createXLayerProvider } from '../../../utils/provider-factory.js';
+import { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, } from '../../../domains/dex/direct-router.js';
+import { getProfitRecipient } from '../../../core/constants/index.js';
 // ============================================================================
 // 辅助函数
 // ============================================================================
@@ -54,8 +55,8 @@ export async function signEoaWashBuyTransactions(params) {
         throw new Error('[signEoaWashBuyTransactions] 私钥数量与买入金额数量不一致');
     }
     // 创建钱包
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl);
-    const wallets = privateKeys.map(pk => new Wallet(pk, provider));
+    const provider = createXLayerProvider(config.rpcUrl);
+    const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
     let result;
     if (poolType === 'V2') {
         result = await directV2BatchBuy({
@@ -69,7 +70,7 @@ export async function signEoaWashBuyTransactions(params) {
             config: {
                 ...config,
                 skipProfit: true, // 买入时不刮取利润（卖出时刮取）
-            }
+            },
         });
     }
     else {
@@ -86,10 +87,9 @@ export async function signEoaWashBuyTransactions(params) {
             config: {
                 ...config,
                 skipProfit: true, // 买入时不刮取利润（卖出时刮取）
-            }
+            },
         });
     }
-    console.log(`[signEoaWashBuyTransactions] 签名 ${result.signedTransactions.length} 笔买入交易`);
     return {
         signedTransactions: result.signedTransactions,
         wallets,
@@ -107,35 +107,32 @@ export async function signEoaWashBuyTransactions(params) {
  */
 export async function signEoaWashSellTransactions(params, wallets, tokenDecimals) {
     const { tokenAddress, poolType, routerAddress, quoteToken, config } = params;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl);
+    const provider = createXLayerProvider(config.rpcUrl);
     // 获取代币精度
-    const decimals = tokenDecimals ?? await getTokenDecimals(provider, tokenAddress);
-    console.log(`[signEoaWashSellTransactions] 代币精度: ${decimals}`);
+    const decimals = tokenDecimals ?? (await getTokenDecimals(provider, tokenAddress));
     // 查询所有钱包的代币余额
-    const balancesWei = await Promise.all(wallets.map(w => getTokenBalance(provider, tokenAddress, w.address)));
+    const balancesWei = await Promise.all(wallets.map((w) => getTokenBalance(provider, tokenAddress, w.address)));
     // 转换为格式化金额
-    const sellAmounts = balancesWei.map(balance => {
+    const sellAmounts = balancesWei.map((balance) => {
         if (balance <= 0n)
             return '0';
         return ethers.formatUnits(balance, decimals);
     });
-    console.log(`[signEoaWashSellTransactions] 钱包余额:`, sellAmounts);
     // 过滤出有余额的钱包
     const validIndices = sellAmounts
         .map((amt, i) => ({ amt, i }))
         .filter(({ amt }) => parseFloat(amt) > 0)
         .map(({ i }) => i);
     if (validIndices.length === 0) {
-        console.warn('[signEoaWashSellTransactions] 所有钱包余额为 0，无法卖出');
         return {
             signedTransactions: [],
             profitHopWallets: [],
             profitAmount: '0',
-            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            profitRecipient: getProfitRecipient(),
         };
     }
-    const validPrivateKeys = validIndices.map(i => wallets[i].privateKey);
-    const validSellAmounts = validIndices.map(i => sellAmounts[i]);
+    const validPrivateKeys = validIndices.map((i) => wallets[i].privateKey);
+    const validSellAmounts = validIndices.map((i) => sellAmounts[i]);
     let result;
     if (poolType === 'V2') {
         result = await directV2BatchSell({
@@ -148,7 +145,7 @@ export async function signEoaWashSellTransactions(params, wallets, tokenDecimals
             config: {
                 ...config,
                 // ✅ 卖出时正常刮取利润（XLayer 不使用多跳，直接转账）
-            }
+            },
         });
     }
     else {
@@ -164,15 +161,14 @@ export async function signEoaWashSellTransactions(params, wallets, tokenDecimals
             config: {
                 ...config,
                 // ✅ 卖出时正常刮取利润（XLayer 不使用多跳，直接转账）
-            }
+            },
         });
     }
-    console.log(`[signEoaWashSellTransactions] 签名 ${result.signedTransactions.length} 笔卖出交易（含利润）`);
     return {
         signedTransactions: result.signedTransactions,
         profitHopWallets: result.profitHopWallets ?? [],
         profitAmount: result.metadata?.profitAmount ?? '0',
-        profitRecipient: result.metadata?.profitRecipient ?? PROFIT_CONFIG.RECIPIENT,
+        profitRecipient: result.metadata?.profitRecipient ?? getProfitRecipient(),
     };
 }
 /**
@@ -190,13 +186,12 @@ export async function signEoaWashVolumeTransactions(params) {
     // 第一步：签名买入交易
     const buyResult = await signEoaWashBuyTransactions(params);
     // 注意：这里的卖出签名是基于预估的，实际使用时应该在买入确认后重新签名
-    console.log(`[signEoaWashVolumeTransactions] ⚠️ 注意：卖出签名应在买入确认后根据实际余额重新生成`);
     // 暂时返回空的卖出签名（实际使用时应该在买入确认后调用 signEoaWashSellTransactions）
     return {
         buySignedTransactions: buyResult.signedTransactions,
         sellSignedTransactions: [], // 需要在买入确认后重新签名
         profitHopWallets: [],
         profitAmount: '0',
-        profitRecipient: PROFIT_CONFIG.RECIPIENT,
+        profitRecipient: getProfitRecipient(),
     };
 }

package/dist/chains/xlayer/eoa/index.d.ts

@@ -11,14 +11,18 @@
  */
 export * from './constants.js';
 export * from './types.js';
+import { createPortalQuery } from './portal-ops.js';
+import { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle } from './eoa-bundle-swap.js';
+import { signEoaWashVolumeTransactions } from './eoa-wash-volume.js';
 export { encodeBuyCall, encodeBuyCallV3, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, createPortalQuery, applySlippage, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, type PortalQueryConfig, } from './portal-ops.js';
 export { signEoaWashBuyTransactions, signEoaWashSellTransactions, signEoaWashVolumeTransactions, type EoaWashPoolType, type EoaWashVolumeParams, type EoaWashVolumeResult, } from './eoa-wash-volume.js';
-export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, type XLayerEoaSwapConfig, type XLayerQuickBatchSwapParams, type XLayerQuickBatchSwapResult, type XLayerCrossSwapParams, type XLayerCrossSwapResult, type XLayerPureCrossSwapParams, type XLayerPureCrossSwapResult, type UserType as XLayerUserType, type RouteParams as XLayerRouteParams, type V2RouteParams as XLayerV2RouteParams, type V3SingleRouteParams as XLayerV3SingleRouteParams, } from './eoa-bundle-swap.js';
+export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, type XLayerPureCrossSwapParams, type XLayerPureCrossSwapResult, } from './eoa-bundle-swap.js';
+export type { XLayerEoaSwapConfig, XLayerQuickBatchSwapParams, XLayerQuickBatchSwapResult, XLayerCrossSwapParams, XLayerCrossSwapResult, UserType as XLayerUserType, RouteParams as XLayerRouteParams, V2RouteParams as XLayerV2RouteParams, V3SingleRouteParams as XLayerV3SingleRouteParams, V3MultiRouteParams as XLayerV3MultiRouteParams, } from './eoa-bundle-swap-helpers.js';
 export declare const xlayer: {
-    createPortalQuery: (config?: import("./portal-ops.js").PortalQueryConfig | undefined) => Promise<import("./portal-ops.js").PortalQuery>;
-    xlayerQuickBatchSwapMerkle: (params: import("./eoa-bundle-swap.js").XLayerQuickBatchSwapParams) => Promise<import("./eoa-bundle-swap.js").XLayerQuickBatchSwapResult>;
-    xlayerCrossSwapMerkle: (params: import("./eoa-bundle-swap.js").XLayerCrossSwapParams) => Promise<import("./eoa-bundle-swap.js").XLayerCrossSwapResult>;
-    xlayerPureCrossSwapMerkle: (params: import("./eoa-bundle-swap.js").XLayerPureCrossSwapParams) => Promise<import("./eoa-bundle-swap.js").XLayerPureCrossSwapResult>;
-    signEoaWashVolumeTransactions: (params: import("./eoa-wash-volume.js").EoaWashVolumeParams) => Promise<import("./eoa-wash-volume.js").EoaWashVolumeResult>;
+    createPortalQuery: typeof createPortalQuery;
+    xlayerQuickBatchSwapMerkle: typeof xlayerQuickBatchSwapMerkle;
+    xlayerCrossSwapMerkle: typeof xlayerCrossSwapMerkle;
+    xlayerPureCrossSwapMerkle: typeof xlayerPureCrossSwapMerkle;
+    signEoaWashVolumeTransactions: typeof signEoaWashVolumeTransactions;
 };
 export default xlayer;

package/dist/chains/xlayer/eoa/index.js

@@ -17,6 +17,9 @@ export * from './constants.js';
 // 类型
 // ============================================================================
 export * from './types.js';
+import { createPortalQuery } from './portal-ops.js';
+import { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle } from './eoa-bundle-swap.js';
+import { signEoaWashVolumeTransactions } from './eoa-wash-volume.js';
 // ============================================================================
 // Portal 操作
 // ============================================================================
@@ -33,28 +36,10 @@ export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapM
 // 便捷重导出
 // ============================================================================
 export const xlayer = {
-    // Portal 查询
-    createPortalQuery: async (...args) => {
-        const { createPortalQuery } = await import('./portal-ops.js');
-        return createPortalQuery(...args);
-    },
-    // EOA 换手
-    xlayerQuickBatchSwapMerkle: async (...args) => {
-        const { xlayerQuickBatchSwapMerkle } = await import('./eoa-bundle-swap.js');
-        return xlayerQuickBatchSwapMerkle(...args);
-    },
-    xlayerCrossSwapMerkle: async (...args) => {
-        const { xlayerCrossSwapMerkle } = await import('./eoa-bundle-swap.js');
-        return xlayerCrossSwapMerkle(...args);
-    },
-    xlayerPureCrossSwapMerkle: async (...args) => {
-        const { xlayerPureCrossSwapMerkle } = await import('./eoa-bundle-swap.js');
-        return xlayerPureCrossSwapMerkle(...args);
-    },
-    // EOA 刷量
-    signEoaWashVolumeTransactions: async (...args) => {
-        const { signEoaWashVolumeTransactions } = await import('./eoa-wash-volume.js');
-        return signEoaWashVolumeTransactions(...args);
-    },
+    createPortalQuery,
+    xlayerQuickBatchSwapMerkle,
+    xlayerCrossSwapMerkle,
+    xlayerPureCrossSwapMerkle,
+    signEoaWashVolumeTransactions,
 };
 export default xlayer;

package/dist/chains/xlayer/eoa/portal-ops.js

@@ -165,6 +165,9 @@ export function encodeCreateCallV5(params) {
  * - 代币状态
  */
 export class PortalQuery {
+    provider;
+    portal;
+    portalAddress;
     constructor(config = {}) {
         const rpcUrl = config.rpcUrl ?? DEFAULT_RPC_URL;
         const chainId = config.chainId ?? XLAYER_CHAIN_ID;
@@ -446,8 +449,10 @@ export function applySlippage(expectedOutput, slippageBps) {
  */
 export function lpFeeProfileToV3Fee(profile) {
     switch (profile) {
-        case 1: return 100; // 0.01%
-        case 2: return 10000; // 1%
+        case 1:
+            return 100; // 0.01%
+        case 2:
+            return 10000; // 1%
         case 0:
         default:
             return 2500; // 0.25%

package/dist/chains/xlayer/eoa/router-manager.js

@@ -2,7 +2,8 @@
  * XLayer Router 管理器
  * 统一管理 V2/V3 Router 地址和授权目标选择逻辑
  */
-import { POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL, } from './constants.js';
+import { POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL } from './constants.js';
+import { ADDRESSES } from '../../../core/constants/index.js';
 /**
  * ✅ 获取 Router 地址
  * @param params.routerVersion - Router 版本（V2 或 V3）
@@ -16,7 +17,7 @@ export function getRouterAddress(params) {
         return params.routerAddress;
     // 2. 根据 dexKey 选择
     if (params.dexKey === 'DYORSWAP') {
-        return '0xfb001fbbace32f09cb6d3c449b935183de53ee96';
+        return ADDRESSES.XLAYER.DyorSwapRouter;
     }
     // 3. 根据 routerVersion 选择
     const version = params.routerVersion ?? 'V2';
@@ -49,9 +50,9 @@ export function getApprovalTargetAddress(target) {
  * @returns 目标信息数组
  */
 export function getAllApprovalTargets(targets) {
-    return targets.map(target => ({
+    return targets.map((target) => ({
         target,
-        address: getApprovalTargetAddress(target)
+        address: getApprovalTargetAddress(target),
     }));
 }
 /**

package/dist/chains/xlayer/eoa/types.d.ts

@@ -100,12 +100,12 @@ export interface XLayerConfig {
     extractProfit?: boolean;
     /**
      * 利润比例（基点 bps，1 bps = 0.01%）
-     * - 默认使用公共常量 PROFIT_CONFIG.RATE_BPS（当前为 30 bps）
+     * - 默认使用 `getProfitRateBps('normal')`
      */
     profitBps?: number;
     /**
      * 利润接收地址
-     * - 默认使用公共常量 PROFIT_CONFIG.RECIPIENT
+     * - 默认使用 `getProfitRecipient()`
      */
     profitRecipient?: string;
     /**

package/dist/chains/xlayer/eoa/types.js

@@ -15,9 +15,7 @@
  * - 对“可能不生成 op”的分支（例如 withdraw 返回 null），使用 peek + commit，避免提前消耗 nonce。
  */
 export class AANonceMap {
-    constructor() {
-        this.nextBySenderLower = new Map();
-    }
+    nextBySenderLower = new Map();
     init(sender, startNonce) {
         const k = sender.toLowerCase();
         const cur = this.nextBySenderLower.get(k);

package/dist/chains/xlayer/index.d.ts

@@ -10,5 +10,6 @@ export * as eoa from './eoa/index.js';
 export * as eip7702 from './eip7702/index.js';
 export { PortalQuery, createPortalQuery, xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, signEoaWashBuyTransactions, signEoaWashSellTransactions, signEoaWashVolumeTransactions, } from './eoa/index.js';
 export type { BundleSwapParams, BundleSwapSignParams, BundleSwapResult, BundleSwapSignResult, BundleBatchSwapParams, BundleBatchSwapSignParams, BundleBatchSwapResult, BundleBatchSwapSignResult, BuyFirstParams, BuyFirstResult, BuyParams, SellParams, } from './eoa/types.js';
-export { bundleBuy as xlayerEip7702BundleBuy, bundleSell as xlayerEip7702BundleSell, bundleSwap as xlayerEip7702BundleSwap, bundleApprove as xlayerEip7702BundleApprove, bundleCreateBuy as xlayerEip7702BundleCreate, washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, } from './eip7702/index.js';
-export { default as xlayer } from './eoa/index.js';
+export * from './eip7702/flat-aliases.js';
+export { default as xlayer, default as XLayer } from './eoa/index.js';
+export { lpFeeProfileToV3Fee } from './eoa/portal-ops.js';

package/dist/chains/xlayer/index.js

@@ -22,12 +22,9 @@ xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle,
 // EOA 刷量
 signEoaWashBuyTransactions, signEoaWashSellTransactions, signEoaWashVolumeTransactions, } from './eoa/index.js';
 // ============================================================================
-// 快捷导出 - EIP-7702 模式（使用实际名称）
+// 快捷导出 - EIP-7702 模式（与包根 `xlayerEip7702*` 别名一致，见 flat-aliases）
 // ============================================================================
-export { 
-// Bundle 操作
-bundleBuy as xlayerEip7702BundleBuy, bundleSell as xlayerEip7702BundleSell, bundleSwap as xlayerEip7702BundleSwap, bundleApprove as xlayerEip7702BundleApprove, bundleCreateBuy as xlayerEip7702BundleCreate, 
-// 刷量
-washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, } from './eip7702/index.js';
+export * from './eip7702/flat-aliases.js';
 // 导出旧模块的默认对象（向后兼容）
-export { default as xlayer } from './eoa/index.js';
+export { default as xlayer, default as XLayer } from './eoa/index.js';
+export { lpFeeProfileToV3Fee } from './eoa/portal-ops.js';

package/dist/core/amount/split-by-weight.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 将 bigint 金额按随机权重拆分为多份，末份取 remainder，保证总和精确。
+ * 权重范围 500_000–1_500_000（与 dex-helpers 一致），全程 bigint 运算。
+ */
+export declare function splitAmountByWeight(totalAmount: bigint, count: number): bigint[];

package/dist/core/amount/split-by-weight.js

@@ -0,0 +1,35 @@
+function shuffle(arr) {
+    const a = arr.slice();
+    for (let i = a.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [a[i], a[j]] = [a[j], a[i]];
+    }
+    return a;
+}
+/**
+ * 将 bigint 金额按随机权重拆分为多份，末份取 remainder，保证总和精确。
+ * 权重范围 500_000–1_500_000（与 dex-helpers 一致），全程 bigint 运算。
+ */
+export function splitAmountByWeight(totalAmount, count) {
+    if (count <= 0)
+        throw new Error('拆分份数必须大于 0');
+    if (count === 1)
+        return [totalAmount];
+    if (totalAmount <= 0n)
+        return new Array(count).fill(0n);
+    const weights = [];
+    for (let i = 0; i < count; i++) {
+        const w = BigInt(500_000 + Math.floor(Math.random() * 1_000_000));
+        weights.push(w);
+    }
+    const totalWeight = weights.reduce((a, b) => a + b, 0n);
+    const amounts = [];
+    let allocated = 0n;
+    for (let i = 0; i < count - 1; i++) {
+        const amt = (totalAmount * weights[i]) / totalWeight;
+        amounts.push(amt);
+        allocated += amt;
+    }
+    amounts.push(totalAmount - allocated);
+    return shuffle(amounts);
+}

package/dist/{shared → core}/clients/blockrazor.d.ts

@@ -26,20 +26,16 @@
  * ```
  */
 import { JsonRpcProvider, Wallet, TransactionLike, ethers } from 'ethers';
-/**
- * BlockRazor Builder EOA 地址
- * 向此地址转账 BNB 可提高 Bundle 优先级
- * 来源: https://blockrazor.gitbook.io/blockrazor/bsc/block-builder/send-bundle
- */
-export declare const BLOCKRAZOR_BUILDER_EOA = "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
+import { CHAINS } from '../constants/index.js';
+export { BLOCKRAZOR_BUILDER_EOA } from '../constants/index.js';
 /**
  * BlockRazor 客户端配置
  */
 export interface BlockRazorConfig {
     /** API Key（可选，根据 Tier 等级需要） */
     apiKey?: string;
-    /** 链 ID: 56=BSC */
-    chainId: 56;
+    /** 链 ID: BSC */
+    chainId: typeof CHAINS.BSC.chainId;
     /** 自定义 RPC URL（可选） */
     customRpcUrl?: string;
     /** 自定义 Builder RPC URL（可选，用于发送 Bundle） */

package/dist/{shared → core}/clients/blockrazor.js

@@ -26,16 +26,12 @@
  * ```
  */
 import { JsonRpcProvider, Transaction, ethers } from 'ethers';
-import { GAS_LIMITS } from '../constants/index.js';
+import { GAS_LIMITS, CHAINS, BLOCKRAZOR_BUILDER_EOA } from '../constants/index.js';
+import { getErrorMessageFromUnknown } from '../index.js';
+export { BLOCKRAZOR_BUILDER_EOA } from '../constants/index.js';
 // ============================================================================
 // 常量
 // ============================================================================
-/**
- * BlockRazor Builder EOA 地址
- * 向此地址转账 BNB 可提高 Bundle 优先级
- * 来源: https://blockrazor.gitbook.io/blockrazor/bsc/block-builder/send-bundle
- */
-export const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
 /**
  * BlockRazor BSC RPC 端点
  * 来源: 测试文件 008_blockrazor_smoke_test.ts
@@ -55,9 +51,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 +115,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 +153,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 +185,7 @@ export class BlockRazorClient {
                 jsonrpc: '2.0',
                 id: '1',
                 method: 'eth_sendBundle',
-                params: [bundleParams]
+                params: [bundleParams],
             };
             const headers = {
                 'Content-Type': 'application/json',
@@ -202,12 +204,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 +229,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 +270,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 +289,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（自动添加激励交易）
@@ -330,8 +346,7 @@ export class BlockRazorClient {
                 let gasCost;
                 if (receipt.gasUsed && receipt.gasPrice) {
                     const costWei = receipt.gasUsed * receipt.gasPrice;
-                    const costBnb = Number(costWei) / 1e18;
-                    gasCost = costBnb.toFixed(8);
+                    gasCost = ethers.formatEther(costWei);
                 }
                 return {
                     index,
@@ -348,7 +363,7 @@ export class BlockRazorClient {
                     index,
                     hash,
                     success: false,
-                    error: error.message,
+                    error: getErrorMessageFromUnknown(error),
                 };
             }
         });
@@ -439,7 +454,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 +503,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 +577,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,10 +596,9 @@ export class BlockRazorClient {
         };
     }
 }
-BlockRazorClient.BLOCK_CACHE_TTL_MS = 1000; // 1秒缓存
 /**
  * 创建 BlockRazor 客户端的便捷函数
  */
 export function createBlockRazorClient(apiKey) {
-    return new BlockRazorClient({ apiKey, chainId: 56 });
+    return new BlockRazorClient({ apiKey, chainId: CHAINS.BSC.chainId });
 }

package/dist/{shared → core}/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): {