four-flap-meme-sdk 2.2.18 → 2.2.20

package/dist/utils/mpcExclusive.js

@@ -1,12 +1,13 @@
 import { Contract, JsonRpcProvider } from 'ethers';
-import TokenManager2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
-import { ADDRESSES } from './constants.js';
+import TokenManager2Abi from '../abis/contracts/TokenManager2.json' with { type: 'json' };
+import { ADDRESSES } from '../shared/constants/index.js';
+const TOKEN_MANAGER2_ABI = TokenManager2Abi;
 // 链上识别：template & 0x10000 > 0
 export async function isExclusiveOnChain(params) {
     const { chain, tokenAddress, rpcUrl } = params;
     const tokenManager2Address = ADDRESSES[chain].TokenManagerV2;
     const provider = new JsonRpcProvider(rpcUrl);
-    const tm2 = new Contract(tokenManager2Address, TokenManager2Abi, provider);
+    const tm2 = new Contract(tokenManager2Address, TOKEN_MANAGER2_ABI, provider);
     const info = await tm2._tokenInfos(tokenAddress);
     const template = info.template;
     return (template & 0x10000n) > 0n;

package/dist/utils/private-sale.d.ts

@@ -5,64 +5,7 @@
  * - 贿赂交易：向 BlockRazor Builder EOA 转账 BNB 提高优先级
  * - 利润提取：千分之三（30 bps）
  */
-import type { GeneratedWallet } from './wallet.js';
-/** 私募签名配置 */
-export interface PrivateSaleSignConfig {
-    /** RPC URL */
-    rpcUrl: string;
-    /** 链 ID */
-    chainId?: number;
-    /** Gas Limit（默认 21000） */
-    gasLimit?: number;
-    /** Gas Price（Gwei，默认 0.1） */
-    gasPriceGwei?: number;
-    /** 贿赂金额（BNB，默认 0.000001） */
-    bribeAmount?: number;
-    /** 是否提取利润（默认 true） */
-    extractProfit?: boolean;
-    /** 利润比例基点（默认 30 = 千分之三） */
-    profitBps?: number;
-}
-/** 单个转账参数 */
-export interface PrivateSaleTransferParams {
-    /** 发送者私钥 */
-    senderPrivateKey: string;
-    /** 接收者地址（合约地址） */
-    recipient: string;
-    /** 转账金额（单位：原生代币，如 BNB） */
-    amount: number;
-}
-/** 批量转账参数 */
-export interface BatchPrivateSaleParams {
-    /** 转账列表 */
-    transfers: PrivateSaleTransferParams[];
-    /** 签名配置 */
-    config: PrivateSaleSignConfig;
-}
-/** 私募结果 */
-export interface PrivateSaleResult {
-    /** 签名交易数组（包含贿赂 + 转账 + 利润） */
-    signedTransactions: string[];
-    /** ✅ 利润多跳钱包 */
-    profitHopWallets?: GeneratedWallet[];
-    /** 元数据 */
-    metadata: {
-        /** 总交易数 */
-        totalCount: number;
-        /** 贿赂交易数 */
-        bribeCount: number;
-        /** 转账交易数 */
-        transferCount: number;
-        /** 利润交易数 */
-        profitCount: number;
-        /** 总转账金额（Wei） */
-        totalAmountWei: string;
-        /** 总利润金额（Wei） */
-        totalProfitWei: string;
-        /** 贿赂金额（Wei） */
-        bribeAmountWei: string;
-    };
-}
+import type { BatchPrivateSaleParams, PrivateSaleResult, PrivateSaleSignConfig, PrivateSaleTransferParams } from './types/private-sale.js';
 /**
  * 生成私募转账签名交易（带贿赂和利润提取）
  *
@@ -88,3 +31,4 @@ export declare function batchPrivateSaleMerkle(params: BatchPrivateSaleParams):
  * @returns 签名交易结果
  */
 export declare function privateSaleMerkle(transfer: PrivateSaleTransferParams, config: PrivateSaleSignConfig): Promise<PrivateSaleResult>;
+export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from './types/private-sale.js';

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') {
@@ -92,10 +92,14 @@ async function _stealthTransferInternal(params) {
     }
     else {
         // ============== ERC20 代币多跳路径 ==============
+        const erc20Config = erc20;
+        if (!erc20Config?.address) {
+            throw new Error('erc20.address is required in erc20 mode');
+        }
         const erc20Iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-        const transferGas = erc20?.transferGasLimit ?? GAS_LIMITS.ERC20_TRANSFER;
+        const transferGas = erc20Config.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,14 +112,14 @@ async function _stealthTransferInternal(params) {
         })));
         signed.push(...fundTxs);
         // 代币持有者：可选独立私钥，未提供则用 root
-        const tokenOwner = (erc20?.holderPrivateKey && erc20.holderPrivateKey.length > 0)
-            ? new ethers.Wallet(erc20.holderPrivateKey, provider)
+        const tokenOwner = erc20Config.holderPrivateKey && erc20Config.holderPrivateKey.length > 0
+            ? new ethers.Wallet(erc20Config.holderPrivateKey, provider)
             : root;
         // tokenOwner -> hop0: ERC20 transfer 全量 token
         const callDataRoot = erc20Iface.encodeFunctionData('transfer', [hops[0].address, amountWei]);
         const rootTokenNonce = nonces[0] + hops.length;
         const erc20TxRoot = await tokenOwner.signTransaction({
-            to: erc20.address,
+            to: erc20Config.address,
             data: callDataRoot,
             value: 0n,
             nonce: rootTokenNonce,
@@ -131,7 +135,7 @@ async function _stealthTransferInternal(params) {
             const nextTo = isLast ? finalTo : hops[i + 1].address;
             const callData = erc20Iface.encodeFunctionData('transfer', [nextTo, amountWei]);
             return hop.signTransaction({
-                to: erc20.address,
+                to: erc20Config.address,
                 data: callData,
                 value: 0n,
                 nonce: nonces[i + 1],
@@ -148,9 +152,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 +162,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 +197,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;