four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/utils/private-sale.js

@@ -6,11 +6,8 @@
  * - 利润提取：千分之三（30 bps）
  */
 import { ethers, Wallet, JsonRpcProvider } from 'ethers';
-import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from './constants.js';
+import { getProfitRecipient, getProfitRateBps, BLOCKRAZOR_BUILDER_EOA } from '../shared/constants/index.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT } from './bundle-helpers.js';
-// ============================================================================
-// 核心功能
-// ============================================================================
 /**
  * 生成私募转账签名交易（带贿赂和利润提取）
  *
@@ -38,7 +35,7 @@ export async function batchPrivateSaleMerkle(params) {
     const gasPrice = ethers.parseUnits(String(config.gasPriceGwei || 0.1), 'gwei');
     const bribeAmount = ethers.parseEther(String(config.bribeAmount || 0.000001));
     const extractProfit = config.extractProfit !== false;
-    const profitBps = config.profitBps ?? PROFIT_CONFIG.RATE_BPS;
+    const profitBps = config.profitBps ?? getProfitRateBps('normal');
     // 创建 Provider
     const provider = new JsonRpcProvider(config.rpcUrl);
     const nonceManager = new NonceManager(provider);
@@ -68,16 +65,8 @@ export async function batchPrivateSaleMerkle(params) {
     uniqueWallets.forEach((wallet, i) => {
         nonceMap.set(wallet.address.toLowerCase(), noncesArray[i]);
     });
-    // ✅ 预计算每个钱包的 nonce 分配
     // 第一个钱包：baseNonce(贿赂) → baseNonce+1...+N(转账) → 最后(利润)
     const firstWalletBaseNonce = nonceMap.get(firstWalletKey);
-    // 统计第一个钱包的转账数量
-    let firstWalletTransferCount = 0;
-    for (let i = 0; i < transfers.length; i++) {
-        if (transferWallets[i].address.toLowerCase() === firstWalletKey) {
-            firstWalletTransferCount++;
-        }
-    }
     // ✅ 为每个转账预分配 nonce
     const transferNonces = [];
     const currentNonces = new Map();
@@ -132,12 +121,12 @@ export async function batchPrivateSaleMerkle(params) {
             provider,
             payerWallet: firstWallet,
             profitAmount: profitWei,
-            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            profitRecipient: getProfitRecipient(),
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
             chainId,
             txType: 0,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包

package/dist/utils/provider-factory.d.ts

@@ -25,6 +25,10 @@ export declare function createCachedProvider(rpcUrl: string, chainId: number, ch
  * 清除 Provider 缓存
  */
 export declare function clearProviderCache(): void;
+/**
+ * ENI 专用 Provider（staticNetwork，适合批量 RPC）
+ */
+export declare function createEniProvider(rpcUrl: string, chainId?: number): JsonRpcProvider;
 /**
  * XLayer 专用 Provider 创建函数
  */

package/dist/utils/provider-factory.js

@@ -72,6 +72,16 @@ export function createCachedProvider(rpcUrl, chainId, chainName) {
 export function clearProviderCache() {
     providerCache.clear();
 }
+/**
+ * ENI 专用 Provider（staticNetwork，适合批量 RPC）
+ */
+export function createEniProvider(rpcUrl, chainId = 173) {
+    return new JsonRpcProvider(rpcUrl, chainId, {
+        staticNetwork: true,
+        batchMaxCount: 20,
+        batchStallTime: 30,
+    });
+}
 /**
  * XLayer 专用 Provider 创建函数
  */

package/dist/utils/quote-helpers.d.ts

@@ -7,51 +7,9 @@
  * - ERC20 → 原生代币转换报价
  */
 import { JsonRpcProvider } from 'ethers';
-/** V3 常用费率档位 */
-export declare const V3_FEE_TIERS: number[];
-/** 各链的报价配置 */
-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"];
-    };
-};
-export type SupportedChain = keyof typeof QUOTE_CONFIG;
-export interface QuoteParams {
-    provider: JsonRpcProvider;
-    tokenIn: string;
-    tokenOut: string;
-    amountIn: bigint;
-    chain: string;
-    version?: 'v2' | 'v3';
-    fee?: number;
-    routerOverride?: string;
-}
-export interface QuoteResult {
-    amountOut: bigint;
-    path?: string[];
-    fee?: number;
-}
+import { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS } from '../shared/constants/quote.js';
+import type { QuoteParams, QuoteResult } from './types/quote-helpers.js';
+export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
 /**
  * V2 报价（直接路径 + 多跳路径）
  * ✅ 优化：并行尝试直接路径和多跳路径
@@ -117,3 +75,4 @@ export declare function getWrappedNativeAddress(chain: string): string;
  * 获取链的稳定币列表
  */
 export declare function getStableCoins(chain: string): string[];
+export type { SupportedChain, QuoteParams, QuoteResult } from './types/quote-helpers.js';

package/dist/utils/quote-helpers.js

@@ -6,56 +6,11 @@
  * - V3 Quoter 报价（多费率尝试 + 多跳路径）
  * - ERC20 → 原生代币转换报价
  */
-import { ethers, Contract } from 'ethers';
-import { V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../shared/abis/common.js';
-// ============================================================================
-// 常量配置
-// ============================================================================
-// ✅ V2_ROUTER_ABI 和 V3_QUOTER_ABI 从公共模块导入
+import { Contract } from 'ethers';
+import { V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../abis/common.js';
+import { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS } from '../shared/constants/quote.js';
 const V2_ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
-/** V3 常用费率档位 */
-export const V3_FEE_TIERS = [100, 500, 2500, 10000]; // 0.01%, 0.05%, 0.25%, 1%
-/** 各链的报价配置 */
-export const QUOTE_CONFIG = {
-    BSC: {
-        v2Router: '0x10ED43C718714eb63d5aA57B78B54704E256024E', // PancakeSwap V2 Router
-        v3Quoter: '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997', // PancakeSwap V3 Quoter
-        wrappedNative: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c', // WBNB
-        stableCoins: [
-            '0x55d398326f99059fF775485246999027B3197955', // USDT
-            '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', // USDC
-            '0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56', // BUSD
-        ],
-    },
-    MONAD: {
-        v2Router: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9', // PancakeSwap V2
-        v3Quoter: '', // TODO: 添加 Monad V3 Quoter
-        wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a', // WMON
-        stableCoins: [],
-    },
-    XLAYER: {
-        v2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e', // PotatoSwap V2
-        v3Quoter: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e', // ✅ PotatoSwap V3 QuoterV2
-        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b', // WOKB
-        stableCoins: [
-            '0x1E4a5963aBFD975d8c9021ce480b42188849D41d', // USDT
-            '0x74b7f16337b8972027f6196a17a631ac6de26d22', // USDC
-            '0x779ded0c9e1022225f8e0630b35a9b54be713736', // USD₮0
-        ],
-    },
-    ENI: {
-        v2Router: '0x97ed8be49d9a8b86247090aa41e908e76b8fcf22', // DSWAP V2 Router
-        v3Quoter: '',
-        wrappedNative: '0x6d1e851446f4d004ae2a72f9afed85e8829a205e', // WEGAS
-        stableCoins: [
-            '0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a', // USDT (18 decimals)
-            '0xaFF944b96c1BAEA587159ec446280E468B32ee15', // USDC (18 decimals)
-        ],
-    },
-};
-// ============================================================================
-// V2 报价
-// ============================================================================
+export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
 /**
  * V2 报价（直接路径 + 多跳路径）
  * ✅ 优化：并行尝试直接路径和多跳路径
@@ -74,7 +29,6 @@ export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, rout
     const chainUpper = chain.toUpperCase();
     const config = QUOTE_CONFIG[chainUpper];
     if (!config) {
-        console.warn(`[quoteV2] 不支持的链: ${chain}`);
         return { amountOut: 0n };
     }
     const routerAddress = routerOverride || config.v2Router;
@@ -93,16 +47,13 @@ export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, rout
         }
     }
     // ✅ 并行尝试所有路径
-    console.log(`[quoteV2] 输入: ${amountIn} wei, tokenIn=${tokenIn}, tokenOut=${tokenOut}`);
     const quotePromises = paths.map(async (path) => {
         try {
             const amounts = await router.getAmountsOut(amountIn, path);
             const amountOut = amounts[amounts.length - 1];
-            console.log(`[quoteV2] 路径 ${path.map(p => p.slice(0, 10) + '...').join(' → ')}: ${amountOut} wei`);
             return { amountOut, path, success: amountOut > 0n };
         }
-        catch (e) {
-            console.log(`[quoteV2] 路径失败 ${path.map(p => p.slice(0, 10) + '...').join(' → ')}: ${e.message?.slice(0, 50)}`);
+        catch {
             return { amountOut: 0n, path, success: false };
         }
     });
@@ -110,11 +61,9 @@ export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, rout
     // 找到第一个成功的结果（优先直接路径）
     for (const result of results) {
         if (result.success) {
-            console.log(`[quoteV2] 路径成功 (${result.path.length === 2 ? '直接' : '多跳'}): ${ethers.formatEther(result.amountOut)}`);
             return { amountOut: result.amountOut, path: result.path };
         }
     }
-    console.warn(`[quoteV2] 所有路径均失败`);
     return { amountOut: 0n };
 }
 // ============================================================================
@@ -139,19 +88,18 @@ export async function quoteV3(provider, tokenIn, tokenOut, amountIn, chain, pref
     const chainUpper = chain.toUpperCase();
     const config = QUOTE_CONFIG[chainUpper];
     if (!config) {
-        console.warn(`[quoteV3] 不支持的链: ${chain}`);
         return { amountOut: 0n };
     }
     if (!config.v3Quoter) {
-        console.warn(`[quoteV3] 该链不支持 V3 Quoter: ${chain}`);
         return { amountOut: 0n };
     }
     const quoter = new Contract(config.v3Quoter, V3_QUOTER_ABI, provider);
     const tokenInLower = tokenIn.toLowerCase();
     const tokenOutLower = tokenOut.toLowerCase();
     // 如果指定了费率，优先尝试；否则尝试所有费率
-    const feesToTry = preferredFee ? [preferredFee, ...V3_FEE_TIERS.filter(f => f !== preferredFee)] : V3_FEE_TIERS;
-    console.log(`[quoteV3] 开始报价: tokenIn=${tokenIn.slice(0, 10)}..., tokenOut=${tokenOut.slice(0, 10)}..., feesToTry=${feesToTry}`);
+    const feesToTry = preferredFee
+        ? [preferredFee, ...QUOTE_V3_FEE_TIERS.filter((f) => f !== preferredFee)]
+        : [...QUOTE_V3_FEE_TIERS];
     // ✅ 策略 1：并行尝试所有费率的直接路径
     const directQuotePromises = feesToTry.map(async (fee) => {
         try {
@@ -160,7 +108,7 @@ export async function quoteV3(provider, tokenIn, tokenOut, amountIn, chain, pref
                 tokenOut,
                 amountIn,
                 fee,
-                sqrtPriceLimitX96: 0n
+                sqrtPriceLimitX96: 0n,
             });
             const amountOut = Array.isArray(result) ? result[0] : result;
             return { amountOut: amountOut || 0n, fee, success: amountOut && amountOut > 0n };
@@ -173,24 +121,23 @@ export async function quoteV3(provider, tokenIn, tokenOut, amountIn, chain, pref
     // 按费率优先级返回第一个成功的结果
     for (const result of directResults) {
         if (result.success) {
-            console.log(`[quoteV3] 直接路径成功 (fee=${result.fee}): ${ethers.formatEther(result.amountOut)}`);
             return { amountOut: result.amountOut, fee: result.fee };
         }
     }
     // ✅ 策略 2：并行尝试多跳路径（通过稳定币）
-    const validStableCoins = config.stableCoins.filter(sc => {
+    const validStableCoins = config.stableCoins.filter((sc) => {
         const stableLower = sc.toLowerCase();
         return tokenInLower !== stableLower && tokenOutLower !== stableLower;
     });
     // 并行尝试所有稳定币的第一跳
-    const firstHopPromises = validStableCoins.flatMap(stableCoin => feesToTry.map(async (fee1) => {
+    const firstHopPromises = validStableCoins.flatMap((stableCoin) => feesToTry.map(async (fee1) => {
         try {
             const midResult = await quoter.quoteExactInputSingle.staticCall({
                 tokenIn,
                 tokenOut: stableCoin,
                 amountIn,
                 fee: fee1,
-                sqrtPriceLimitX96: 0n
+                sqrtPriceLimitX96: 0n,
             });
             const midAmount = Array.isArray(midResult) ? midResult[0] : midResult;
             return { midAmount: midAmount || 0n, stableCoin, fee1, success: midAmount && midAmount > 0n };
@@ -200,17 +147,17 @@ export async function quoteV3(provider, tokenIn, tokenOut, amountIn, chain, pref
         }
     }));
     const firstHopResults = await Promise.all(firstHopPromises);
-    const successfulFirstHops = firstHopResults.filter(r => r.success);
+    const successfulFirstHops = firstHopResults.filter((r) => r.success);
     // 对成功的第一跳，并行尝试第二跳
     const stableFees = [100, 500, 2500];
-    const secondHopPromises = successfulFirstHops.flatMap(hop => stableFees.map(async (fee2) => {
+    const secondHopPromises = successfulFirstHops.flatMap((hop) => stableFees.map(async (fee2) => {
         try {
             const finalResult = await quoter.quoteExactInputSingle.staticCall({
                 tokenIn: hop.stableCoin,
                 tokenOut,
                 amountIn: hop.midAmount,
                 fee: fee2,
-                sqrtPriceLimitX96: 0n
+                sqrtPriceLimitX96: 0n,
             });
             const amountOut = Array.isArray(finalResult) ? finalResult[0] : finalResult;
             return { amountOut: amountOut || 0n, fee1: hop.fee1, fee2, success: amountOut && amountOut > 0n };
@@ -223,11 +170,9 @@ export async function quoteV3(provider, tokenIn, tokenOut, amountIn, chain, pref
     // 返回第一个成功的多跳结果
     for (const result of secondHopResults) {
         if (result.success) {
-            console.log(`[quoteV3] 多跳路径成功 (${result.fee1}→${result.fee2}): ${ethers.formatEther(result.amountOut)}`);
             return { amountOut: result.amountOut, fee: result.fee1 };
         }
     }
-    console.warn(`[quoteV3] 所有路径均失败`);
     return { amountOut: 0n };
 }
 // ============================================================================
@@ -267,7 +212,6 @@ export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount,
     const chainUpper = chain.toUpperCase();
     const config = QUOTE_CONFIG[chainUpper];
     if (!config) {
-        console.warn(`[getTokenToNativeQuote] 不支持的链: ${chain}`);
         return 0n;
     }
     const tokenLower = tokenAddress.toLowerCase();
@@ -284,7 +228,7 @@ export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount,
         chain,
         version,
         fee,
-        routerOverride
+        routerOverride,
     });
     return result.amountOut;
 }
@@ -305,7 +249,6 @@ export async function getNativeToTokenQuote(provider, tokenAddress, nativeAmount
     const chainUpper = chain.toUpperCase();
     const config = QUOTE_CONFIG[chainUpper];
     if (!config) {
-        console.warn(`[getNativeToTokenQuote] 不支持的链: ${chain}`);
         return 0n;
     }
     const tokenLower = tokenAddress.toLowerCase();
@@ -321,7 +264,7 @@ export async function getNativeToTokenQuote(provider, tokenAddress, nativeAmount
         amountIn: nativeAmount,
         chain,
         version,
-        fee
+        fee,
     });
     return result.amountOut;
 }

package/dist/utils/stealth-transfer.d.ts

@@ -1,31 +1,5 @@
-import type { SoulPointSignatureMode, VNormalizationMode } from '../shared/clients/club48.js';
-export type StealthTransferResult = {
-    bundleUuid: string;
-    txs: string[];
-    hopAddresses: string[];
-};
-/**
- * 简化版隐秘转账参数
- * - 仅需人类可读金额与（可选）代币地址，其余自动处理
- * - 未提供 tokenAddress → 原生币模式；提供 tokenAddress → 自动读取 decimals 转换为 wei 的代币模式
- */
-export type StealthTransferSimpleParams = {
-    rpcUrl: string;
-    chainId: number;
-    rootPrivateKey: string;
-    finalTo: string;
-    hopCount: number;
-    amount: string;
-    tokenAddress?: string;
-    tokenHolderPrivateKey?: string;
-    bundleEndpoint?: string;
-    gasPriceGwei?: string;
-    gasLimit?: bigint;
-    blockOffset?: number;
-    spMode?: SoulPointSignatureMode;
-    spPrivateKey?: string;
-    spVMode?: VNormalizationMode;
-};
+import type { StealthTransferResult, StealthTransferSimpleParams } from './types/stealth-transfer.js';
+export type { StealthTransferResult, StealthTransferSimpleParams } from './types/stealth-transfer.js';
 /**
  * 隐秘转账（简化版）
  * - 原生模式：amount 按 parseEther 转 wei

package/dist/utils/stealth-transfer.js

@@ -54,8 +54,8 @@ async function _stealthTransferInternal(params) {
         throw new Error(`insufficient balance: need ${needed.toString()}, have ${rootBal.toString()}`);
     }
     // ✅ 并行预取所有 nonce
-    const allAddresses = [rootAddr, ...hops.map(w => w.address)];
-    const nonces = await Promise.all(allAddresses.map(addr => provider.getTransactionCount(addr, 'pending')));
+    const allAddresses = [rootAddr, ...hops.map((w) => w.address)];
+    const nonces = await Promise.all(allAddresses.map((addr) => provider.getTransactionCount(addr, 'pending')));
     const signed = [];
     const hopAddresses = [];
     if (mode !== 'erc20') {
@@ -95,7 +95,7 @@ async function _stealthTransferInternal(params) {
         const erc20Iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
         const transferGas = erc20?.transferGasLimit ?? GAS_LIMITS.ERC20_TRANSFER;
         // 填充 hopAddresses
-        hops.forEach(hop => hopAddresses.push(hop.address));
+        hops.forEach((hop) => hopAddresses.push(hop.address));
         // ✅ 并行签名所有 gas 注资交易（root -> hop[i]）
         const fundTxs = await Promise.all(hops.map((hop, i) => root.signTransaction({
             to: hop.address,
@@ -108,7 +108,7 @@ async function _stealthTransferInternal(params) {
         })));
         signed.push(...fundTxs);
         // 代币持有者：可选独立私钥，未提供则用 root
-        const tokenOwner = (erc20?.holderPrivateKey && erc20.holderPrivateKey.length > 0)
+        const tokenOwner = erc20?.holderPrivateKey && erc20.holderPrivateKey.length > 0
             ? new ethers.Wallet(erc20.holderPrivateKey, provider)
             : root;
         // tokenOwner -> hop0: ERC20 transfer 全量 token
@@ -148,9 +148,7 @@ async function _stealthTransferInternal(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signed,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-    }, spPrivateKey
-        ? { spMode: spMode ?? 'timestampPersonalSign', spPrivateKey, spVMode }
-        : undefined);
+    }, spPrivateKey ? { spMode: spMode ?? 'timestampPersonalSign', spPrivateKey, spVMode } : undefined);
     return { bundleUuid, txs: signed, hopAddresses };
 }
 /**
@@ -160,21 +158,30 @@ async function _stealthTransferInternal(params) {
  * - 自动生成 hopCount 个中转地址，并通过 48.club Bundle 原子提交
  */
 export async function stealthTransfer(params) {
-    const { rpcUrl, chainId, rootPrivateKey, finalTo, hopCount, amount, tokenAddress, tokenHolderPrivateKey, bundleEndpoint, gasPriceGwei, gasLimit, blockOffset, spMode, spPrivateKey, spVMode } = params;
+    const { rpcUrl, chainId, rootPrivateKey, finalTo, hopCount, amount, tokenAddress, tokenHolderPrivateKey, bundleEndpoint, gasPriceGwei, gasLimit, blockOffset, spMode, spPrivateKey, spVMode, } = params;
     if (!tokenAddress) {
         // 原生：直接 parseEther
         const amountWei = ethers.parseEther(amount);
         return await _stealthTransferInternal({
-            rpcUrl, chainId, rootPrivateKey, finalTo, hopCount,
+            rpcUrl,
+            chainId,
+            rootPrivateKey,
+            finalTo,
+            hopCount,
             amountWei,
             mode: 'native',
-            bundleEndpoint, gasPriceGwei, gasLimit, blockOffset,
-            spMode, spPrivateKey, spVMode
+            bundleEndpoint,
+            gasPriceGwei,
+            gasLimit,
+            blockOffset,
+            spMode,
+            spPrivateKey,
+            spVMode,
         });
     }
     // ERC20：自动读取 decimals（读取失败则回退 18）
     const provider = new JsonRpcProvider(rpcUrl, chainId);
-    let decimals = 18;
+    let decimals;
     try {
         const erc20 = new ethers.Contract(tokenAddress, ['function decimals() view returns (uint8)'], provider);
         decimals = Number(await erc20.decimals());
@@ -186,11 +193,20 @@ export async function stealthTransfer(params) {
     }
     const amountWei = ethers.parseUnits(amount, decimals);
     return await _stealthTransferInternal({
-        rpcUrl, chainId, rootPrivateKey, finalTo, hopCount,
+        rpcUrl,
+        chainId,
+        rootPrivateKey,
+        finalTo,
+        hopCount,
         amountWei,
         mode: 'erc20',
         erc20: { address: tokenAddress, holderPrivateKey: tokenHolderPrivateKey },
-        bundleEndpoint, gasPriceGwei, gasLimit, blockOffset,
-        spMode, spPrivateKey, spVMode
+        bundleEndpoint,
+        gasPriceGwei,
+        gasLimit,
+        blockOffset,
+        spMode,
+        spPrivateKey,
+        spVMode,
     });
 }

package/dist/utils/swap-helpers.d.ts

@@ -2,11 +2,12 @@
  * 换手交易通用工具函数
  */
 import { Wallet, JsonRpcProvider } from 'ethers';
+import type { MerkleClient } from '../shared/clients/merkle.js';
 /**
  * 检查并执行代币授权（如果需要）
  * ✅ 与 pancake-proxy.ts 的授权逻辑一致
  */
-export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: any, wallet: Wallet, tokenAddress: string, spenderAddress: string, config: {
+export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: MerkleClient, wallet: Wallet, tokenAddress: string, spenderAddress: string, config: {
     gasLimit?: number;
     gasLimitMultiplier?: number;
     minGasPriceGwei?: number;
@@ -38,17 +39,3 @@ export declare function calculateSwapLoss(sellAmount: bigint, buyAmount: bigint)
  * 验证钱包BNB余额
  */
 export declare function validateBNBBalance(provider: JsonRpcProvider, walletAddress: string, requiredBNB: bigint, purpose: string): Promise<void>;
-/**
- * 格式化换手结果日志
- */
-export declare function logSwapResult(params: {
-    sellerAddress: string;
-    buyerAddress: string;
-    tokenAddress: string;
-    sellAmount: bigint;
-    buyAmount: bigint;
-    decimals: number;
-    sellerGotBNB: bigint;
-    buyerSpentBNB: bigint;
-    swapType: string;
-}): void;

package/dist/utils/swap-helpers.js

@@ -3,7 +3,8 @@
  */
 import { ethers, Contract } from 'ethers';
 import { batchCheckAllowances } from './erc20.js';
-import { ERC20_ABI } from '../shared/abis/common.js';
+import { ERC20_ABI } from '../abis/common.js';
+import { NonceManager, getOptimizedGasPrice } from './bundle-helpers.js';
 const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;
 /**
  * 获取 Gas Limit（授权专用）
@@ -35,7 +36,6 @@ export async function ensureTokenApproval(provider, merkle, wallet, tokenAddress
         return;
     }
     // ✅ 使用 NonceManager（与 pancake-proxy.ts 一致）
-    const { NonceManager, getOptimizedGasPrice } = await import('./bundle-helpers.js');
     const nonceManager = new NonceManager(provider);
     // 构建授权交易
     const tokenContract = new Contract(tokenAddress, ERC20_ABI, wallet);
@@ -65,7 +65,7 @@ export async function ensureTokenApproval(provider, merkle, wallet, tokenAddress
         gasLimit: approveGasLimit,
         gasPrice,
         chainId,
-        type: config.txType ?? 0
+        type: config.txType ?? 0,
     });
     // 清理临时 nonce 缓存
     nonceManager.clearTemp();
@@ -75,7 +75,7 @@ export async function ensureTokenApproval(provider, merkle, wallet, tokenAddress
         transactions: [signedTx],
         blockOffset,
         minTimestamp: 0,
-        maxTimestamp: 0
+        maxTimestamp: 0,
     });
     // 等待确认
     const results = await merkle.waitForBundleConfirmation(bundleResult.txHashes, 1, config.waitTimeoutMs ?? 120000);
@@ -112,7 +112,7 @@ export async function calculateSellAmount(provider, tokenAddress, walletAddress,
         const decimals = await getTokenDecimals(provider, tokenAddress);
         return {
             amount: ethers.parseUnits(sellAmount, decimals),
-            decimals
+            decimals,
         };
     }
     // 百分比：需要 decimals 和 balance
@@ -123,7 +123,7 @@ export async function calculateSellAmount(provider, tokenAddress, walletAddress,
         // ✅ 并行获取 decimals 和 balance
         const [decimals, balance] = await Promise.all([
             getTokenDecimals(provider, tokenAddress),
-            getTokenBalance(provider, tokenAddress, walletAddress)
+            getTokenBalance(provider, tokenAddress, walletAddress),
         ]);
         const amount = (balance * BigInt(Math.floor(sellPercentage * 100))) / 10000n;
         return { amount, decimals };
@@ -150,8 +150,3 @@ export async function validateBNBBalance(provider, walletAddress, requiredBNB, p
             `实际 ${ethers.formatEther(balance)} BNB`);
     }
 }
-/**
- * 格式化换手结果日志
- */
-export function logSwapResult(params) {
-}

package/dist/utils/types/airdrop-sweep.d.ts

@@ -0,0 +1 @@
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from '../../shared/foundation/types/airdrop-sweep.js';

package/dist/utils/types/airdrop-sweep.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/contract-factory.d.ts

@@ -0,0 +1 @@
+export type ChainName = 'BSC' | 'BASE' | 'ARBITRUM_ONE';

package/dist/utils/types/contract-factory.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/erc20.d.ts

@@ -0,0 +1 @@
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from '../../shared/foundation/types/erc20.js';

package/dist/utils/types/erc20.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/errors.d.ts

@@ -0,0 +1 @@
+export type FourErrorCode = 'GW' | 'ZA' | 'TO' | 'Slippage' | 'More BNB' | 'FR' | 'SO';

package/dist/utils/types/errors.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/holders-maker.d.ts

@@ -0,0 +1 @@
+export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from '../../shared/foundation/types/holders-maker.js';

package/dist/utils/types/holders-maker.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/hop-chains.d.ts

@@ -0,0 +1,8 @@
+import type { Wallet } from 'ethers';
+import type { GeneratedWallet } from './wallet.js';
+/** 分发多跳路径信息 */
+export type DisperseHopPath = {
+    targetAddress: string;
+    hopWallets: Wallet[];
+    hopWalletsInfo: GeneratedWallet[];
+};

package/dist/utils/types/hop-chains.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/index.d.ts

@@ -0,0 +1,13 @@
+/** utils 层类型 facade（唯一源见 `shared/foundation/types/` 或同目录模块专用类型） */
+export type * from './holders-maker.js';
+export type * from './lp-inspect.js';
+export type * from './airdrop-sweep.js';
+export type * from './private-sale.js';
+export type * from './quote-helpers.js';
+export type * from './erc20.js';
+export type * from './wallet.js';
+export type * from './stealth-transfer.js';
+export type * from './errors.js';
+export type * from './mpc-exclusive.js';
+export type * from './contract-factory.js';
+export type * from './hop-chains.js';

package/dist/utils/types/index.js

@@ -0,0 +1 @@
+export {};