four-flap-meme-sdk 2.2.8 → 2.2.11

package/dist/utils/private-sale.js

@@ -6,8 +6,11 @@
  * - 利润提取：千分之三（30 bps）
  */
 import { ethers, Wallet, JsonRpcProvider } from 'ethers';
-import { getProfitRecipient, getProfitRateBps, BLOCKRAZOR_BUILDER_EOA } from '../shared/constants/index.js';
+import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from './constants.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT } from './bundle-helpers.js';
+// ============================================================================
+// 核心功能
+// ============================================================================
 /**
  * 生成私募转账签名交易（带贿赂和利润提取）
  *
@@ -35,7 +38,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 ?? getProfitRateBps('normal');
+    const profitBps = config.profitBps ?? PROFIT_CONFIG.RATE_BPS;
     // 创建 Provider
     const provider = new JsonRpcProvider(config.rpcUrl);
     const nonceManager = new NonceManager(provider);
@@ -65,8 +68,16 @@ 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();
@@ -121,12 +132,12 @@ export async function batchPrivateSaleMerkle(params) {
             provider,
             payerWallet: firstWallet,
             profitAmount: profitWei,
-            profitRecipient: getProfitRecipient(),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
             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,10 +25,6 @@ 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,16 +72,6 @@ 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,9 +7,51 @@
  * - ERC20 → 原生代币转换报价
  */
 import { JsonRpcProvider } from 'ethers';
-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 };
+/** 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;
+}
 /**
  * V2 报价（直接路径 + 多跳路径）
  * ✅ 优化：并行尝试直接路径和多跳路径
@@ -75,4 +117,3 @@ 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,11 +6,56 @@
  * - V3 Quoter 报价（多费率尝试 + 多跳路径）
  * - ERC20 → 原生代币转换报价
  */
-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';
+import { ethers, Contract } from 'ethers';
+import { V2_ROUTER_QUOTE_ABI, V3_QUOTER_ABI } from '../shared/abis/common.js';
+// ============================================================================
+// 常量配置
+// ============================================================================
+// ✅ V2_ROUTER_ABI 和 V3_QUOTER_ABI 从公共模块导入
 const V2_ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
-export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
+/** 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 报价
+// ============================================================================
 /**
  * V2 报价（直接路径 + 多跳路径）
  * ✅ 优化：并行尝试直接路径和多跳路径
@@ -29,6 +74,7 @@ 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;
@@ -47,13 +93,16 @@ 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 {
+        catch (e) {
+            console.log(`[quoteV2] 路径失败 ${path.map(p => p.slice(0, 10) + '...').join(' → ')}: ${e.message?.slice(0, 50)}`);
             return { amountOut: 0n, path, success: false };
         }
     });
@@ -61,9 +110,11 @@ 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 };
 }
 // ============================================================================
@@ -88,18 +139,19 @@ 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, ...QUOTE_V3_FEE_TIERS.filter((f) => f !== preferredFee)]
-        : [...QUOTE_V3_FEE_TIERS];
+    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}`);
     // ✅ 策略 1：并行尝试所有费率的直接路径
     const directQuotePromises = feesToTry.map(async (fee) => {
         try {
@@ -108,7 +160,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 };
@@ -121,23 +173,24 @@ 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 };
@@ -147,17 +200,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 };
@@ -170,9 +223,11 @@ 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 };
 }
 // ============================================================================
@@ -212,6 +267,7 @@ 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();
@@ -228,7 +284,7 @@ export async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount,
         chain,
         version,
         fee,
-        routerOverride,
+        routerOverride
     });
     return result.amountOut;
 }
@@ -249,6 +305,7 @@ 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();
@@ -264,7 +321,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,5 +1,31 @@
-import type { StealthTransferResult, StealthTransferSimpleParams } from './types/stealth-transfer.js';
-export type { StealthTransferResult, StealthTransferSimpleParams } from './types/stealth-transfer.js';
+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;
+};
 /**
  * 隐秘转账（简化版）
  * - 原生模式：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,7 +148,9 @@ 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 };
 }
 /**
@@ -158,30 +160,21 @@ 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;
+    let decimals = 18;
     try {
         const erc20 = new ethers.Contract(tokenAddress, ['function decimals() view returns (uint8)'], provider);
         decimals = Number(await erc20.decimals());
@@ -193,20 +186,11 @@ 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,12 +2,11 @@
  * 换手交易通用工具函数
  */
 import { Wallet, JsonRpcProvider } from 'ethers';
-import type { MerkleClient } from '../shared/clients/merkle.js';
 /**
  * 检查并执行代币授权（如果需要）
  * ✅ 与 pancake-proxy.ts 的授权逻辑一致
  */
-export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: MerkleClient, wallet: Wallet, tokenAddress: string, spenderAddress: string, config: {
+export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: any, wallet: Wallet, tokenAddress: string, spenderAddress: string, config: {
     gasLimit?: number;
     gasLimitMultiplier?: number;
     minGasPriceGwei?: number;
@@ -39,3 +38,17 @@ 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,8 +3,7 @@
  */
 import { ethers, Contract } from 'ethers';
 import { batchCheckAllowances } from './erc20.js';
-import { ERC20_ABI } from '../abis/common.js';
-import { NonceManager, getOptimizedGasPrice } from './bundle-helpers.js';
+import { ERC20_ABI } from '../shared/abis/common.js';
 const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;
 /**
  * 获取 Gas Limit（授权专用）
@@ -36,6 +35,7 @@ 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,3 +150,8 @@ export async function validateBNBBalance(provider, walletAddress, requiredBNB, p
             `实际 ${ethers.formatEther(balance)} BNB`);
     }
 }
+/**
+ * 格式化换手结果日志
+ */
+export function logSwapResult(params) {
+}

package/dist/utils/wallet.d.ts

@@ -1,5 +1,28 @@
-import type { GeneratedWallet, MultiTokenBalancesResult, MulticallResult, PrivateKeyValidation } from './types/wallet.js';
-export type { GeneratedWallet, PrivateKeyValidation, MulticallResult, MultiTokenBalancesResult, } from './types/wallet.js';
+export type GeneratedWallet = {
+    address: string;
+    privateKey: string;
+};
+export type PrivateKeyValidation = {
+    privateKey: string;
+    valid: boolean;
+    address?: string;
+    normalized?: string;
+    error?: string;
+};
+export type MulticallResult = {
+    address: string;
+    balance: bigint;
+    success: boolean;
+};
+export type MultiTokenBalancesResult = {
+    address: string;
+    native: string;
+    tokens: Array<{
+        token: string;
+        balance: string;
+    }>;
+    success: boolean;
+};
 /**
  * 批量生成钱包（并行优化）
  */