four-flap-meme-sdk 2.2.19 → 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/pcs-infinity-cl.js

@@ -15,7 +15,6 @@ const V3_PAIR_ABI = [
     'function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16 observationIndex,uint16 observationCardinality,uint16 observationCardinalityNext,uint8 feeProtocol,bool unlocked)',
     'function token0() view returns (address)',
     'function token1() view returns (address)',
-    'function getReserves() view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast)',
 ];
 /** BSC：lpFeeProfile → Infinity PoolKey 的 fee / parameters（与链上 Initialize 一致） */
 const BSC_INFINITY_POOL_KEY_BY_PROFILE = {
@@ -134,15 +133,6 @@ function getCachedRpcProvider(rpcUrl) {
     }
     return p;
 }
-async function getTokenDecimalsSafe(provider, address) {
-    try {
-        const token = new Contract(address, ERC20_ABI, provider);
-        return Number(await token.decimals());
-    }
-    catch {
-        return 18;
-    }
-}
 /**
  * Infinity CL 池子 WBNB：取多档卖出 quote 的最大值（贴近 GMGN「池内 WBNB」）
  * 说明：不是 Vault 总 WBNB(全协议)，也不是 L*sqrtP 虚拟储备(会高估到 ~5.8)。
@@ -218,65 +208,39 @@ async function getGraduatedV3PairMetrics(params) {
         const quoteAddr = params.quoteTokenAddress.toLowerCase() === ZERO_ADDRESS
             ? params.wrappedNativeAddress
             : params.quoteTokenAddress;
-        const [t0, t1] = await Promise.all([
+        const [t0, t1, slot0] = await Promise.all([
             pool.token0(),
             pool.token1(),
+            pool.slot0(),
         ]);
-        let bal0;
-        let bal1;
-        try {
-            [bal0, bal1] = await Promise.all([
-                new Contract(t0, ERC20_ABI, provider).balanceOf(params.poolAddress),
-                new Contract(t1, ERC20_ABI, provider).balanceOf(params.poolAddress),
-            ]);
-        }
-        catch {
-            try {
-                const reserves = await pool.getReserves();
-                bal0 = BigInt(reserves.reserve0 ?? reserves[0]);
-                bal1 = BigInt(reserves.reserve1 ?? reserves[1]);
-            }
-            catch {
-                return null;
-            }
-        }
-        let sqrtPriceX96 = null;
-        try {
-            const slot0 = await pool.slot0();
-            sqrtPriceX96 = BigInt(Array.isArray(slot0) ? slot0[0] : slot0.sqrtPriceX96);
-        }
-        catch {
-            sqrtPriceX96 = null;
-        }
-        const [dec0, dec1] = await Promise.all([
-            getTokenDecimalsSafe(provider, t0),
-            getTokenDecimalsSafe(provider, t1),
+        const [bal0, bal1] = await Promise.all([
+            new Contract(t0, ERC20_ABI, provider).balanceOf(params.poolAddress),
+            new Contract(t1, ERC20_ABI, provider).balanceOf(params.poolAddress),
         ]);
-        const spot = sqrtPriceX96 && sqrtPriceX96 > 0n
-            ? v3SpotPriceQuotePerToken({
-                sqrtPriceX96,
-                tokenAddress: params.tokenAddress,
-                token0: t0,
-                token1: t1,
-                quoteTokenAddress: quoteAddr,
-            })
-            : null;
+        const sqrtPriceX96 = BigInt(Array.isArray(slot0) ? slot0[0] : slot0.sqrtPriceX96);
+        const spot = v3SpotPriceQuotePerToken({
+            sqrtPriceX96,
+            tokenAddress: params.tokenAddress,
+            token0: t0,
+            token1: t1,
+            quoteTokenAddress: quoteAddr,
+        });
         const tokenIs0 = t0.toLowerCase() === tokenLower;
-        const poolTokenAmount = formatUnits(tokenIs0 ? bal0 : bal1, tokenIs0 ? dec0 : dec1);
-        const poolQuoteAmount = formatUnits(tokenIs0 ? bal1 : bal0, tokenIs0 ? dec1 : dec0);
+        const poolTokenAmount = formatEther(tokenIs0 ? bal0 : bal1);
+        const poolBNBAmount = formatEther(tokenIs0 ? bal1 : bal0);
         let price = spot;
         if (!price && parseFloat(poolTokenAmount) > 0) {
-            price = String(parseFloat(poolQuoteAmount) / parseFloat(poolTokenAmount));
+            price = String(parseFloat(poolBNBAmount) / parseFloat(poolTokenAmount));
         }
         if (!price) {
             price = await quotePortalPrice(params.portal, params.tokenAddress, params.quoteTokenAddress, params.wrappedNativeAddress);
         }
-        if (!price && poolTokenAmount === '0' && poolQuoteAmount === '0')
+        if (!price && poolTokenAmount === '0' && poolBNBAmount === '0')
             return null;
         return {
             price: price ?? '0',
             progress: '100',
-            poolBNBAmount: poolQuoteAmount,
+            poolBNBAmount,
             poolTokenAmount,
             dexKind: 'PANCAKE_V3',
         };

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