four-flap-meme-sdk 4.3.7 → 4.3.8

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

@@ -1,10 +1,11 @@
 /**
  * XLayer Portal 操作 — 查询器（query）
  */
-import { Interface, Contract, JsonRpcProvider } from 'ethers';
+import { Interface, Contract } from 'ethers';
 import { FLAP_PORTAL, PORTAL_ABI, ERC20_ABI, MULTICALL3, DEFAULT_RPC_URL, XLAYER_CHAIN_ID, } from './constants.js';
 import { mapWithConcurrency } from '../../../utils/concurrency.js';
 import { erc20Iface } from './encoders.js';
+import { createProvider } from '../../../utils/provider-factory.js';
 /**
  * Portal 查询器
  *
@@ -21,8 +22,7 @@ export class PortalQuery {
     constructor(config = {}) {
         const rpcUrl = config.rpcUrl ?? DEFAULT_RPC_URL;
         const chainId = config.chainId ?? XLAYER_CHAIN_ID;
-        // ✅ 禁用 ENS: XLayer 不支持 ENS,显式设置 ensAddress: undefined 避免解析错误
-        this.provider = new JsonRpcProvider(rpcUrl, { chainId, name: 'xlayer', ensAddress: undefined }, {
+        this.provider = createProvider(rpcUrl, chainId, 'xlayer', {
             batchMaxCount: 20,
             batchStallTime: 30,
         });

package/dist/core/clients/blockrazor.js

@@ -25,9 +25,10 @@
  * });
  * ```
  */
-import { JsonRpcProvider, Transaction, ethers } from 'ethers';
+import { Transaction, ethers } from 'ethers';
 import { GAS_LIMITS, CHAINS, BLOCKRAZOR_BUILDER_EOA } from '../constants/index.js';
 import { getErrorMessageFromUnknown } from '../index.js';
+import { createProvider } from '../../utils/provider-factory.js';
 export { BLOCKRAZOR_BUILDER_EOA } from '../constants/index.js';
 // ============================================================================
 // 常量
@@ -63,10 +64,7 @@ export class BlockRazorClient {
         this.apiKey = config.apiKey;
         // 普通 RPC（用于查询）
         const rpcUrl = config.customRpcUrl || 'https://bsc-dataseed.binance.org';
-        this.provider = new JsonRpcProvider(rpcUrl, {
-            chainId: this.chainId,
-            name: 'bsc',
-        });
+        this.provider = createProvider(rpcUrl, this.chainId, 'bsc');
         // Builder RPC URL（用于发送 Bundle）
         // ✅ 正确的端点: https://rpc.blockrazor.builders
         this.builderUrl = config.builderRpcUrl || BLOCKRAZOR_RPC_ENDPOINTS.BSC;

package/dist/core/clients/merkle.js

@@ -20,9 +20,10 @@
  * });
  * ```
  */
-import { JsonRpcProvider, Transaction, formatEther } from 'ethers';
+import { Transaction, formatEther } from 'ethers';
 import { CHAINS } from '../constants/index.js';
 import { getErrorMessageFromUnknown } from '../index.js';
+import { createProvider } from '../../utils/provider-factory.js';
 /**
  * Merkle 客户端
  */
@@ -43,10 +44,7 @@ export class MerkleClient {
             ? CHAINS.BSC.rpcUrls.backup // bsc-dataseed1
             : CHAINS.ETHEREUM.rpcUrls.default;
         const rpcUrl = config.customRpcUrl || defaultRpc;
-        this.provider = new JsonRpcProvider(rpcUrl, {
-            chainId: this.chainId,
-            name: this.chainName,
-        });
+        this.provider = createProvider(rpcUrl, this.chainId, this.chainName);
     }
     /**
      * 获取 Provider

package/dist/core/erc20/allowances.d.ts

@@ -3,7 +3,7 @@
  *
  * 只读查询授权额度、批量查询（Multicall3）、智能路由检查等。
  */
-import { JsonRpcProvider } from 'ethers';
+import { type JsonRpcProvider } from 'ethers';
 import { type SellApprovalChain } from './helpers.js';
 /**
  * 检查代币授权状态 - Four.meme V1（只读，不发送交易）

package/dist/core/erc20/allowances.js

@@ -3,13 +3,14 @@
  *
  * 只读查询授权额度、批量查询（Multicall3）、智能路由检查等。
  */
-import { Contract, JsonRpcProvider } from 'ethers';
+import { Contract } from 'ethers';
+import { createProvider } from '../../utils/provider-factory.js';
 import { ADDRESSES, getMulticall3Address } from '../constants/index.js';
 import { ERC20_ABI, MULTICALL3_ABI } from '../../abis/common.js';
 import { getErrorMessageFromUnknown } from '../foundation.js';
 import { validateContractAddress, resolveSpenderAddress, FOUR_MEME_V1_PROXY, FOUR_MEME_V2_PROXY, } from './helpers.js';
 async function checkAllowanceForSpender(rpcUrl, token, owner, amount, spender, spenderLabel) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createProvider(rpcUrl);
     await validateContractAddress(provider, token, 'Token');
     await validateContractAddress(provider, spender, spenderLabel);
     const erc20 = new Contract(token, ERC20_ABI, provider);
@@ -76,7 +77,7 @@ export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, r
         MORPH: ADDRESSES.MORPH.FlapPortal,
         MONAD: ADDRESSES.MONAD.FlapPortal,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createProvider(rpcUrl);
     // ✅ 并行验证 token 和代理合约地址
     await Promise.all([
         validateContractAddress(provider, token, 'Token'),
@@ -151,7 +152,7 @@ export async function checkAllowance(chain, platform, rpcUrl, tokenAddress, owne
  * @returns 当前授权额度（bigint）
  */
 export async function checkAllowanceRaw(rpcUrl, tokenAddress, ownerAddress, spenderAddress) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createProvider(rpcUrl);
     // ✅ 规范化地址（转为小写，避免 checksum 错误）
     const normalizedToken = tokenAddress.toLowerCase();
     const normalizedOwner = ownerAddress.toLowerCase();
@@ -193,7 +194,7 @@ export async function checkAllowanceBatch(chain, platform, rpcUrl, tokenAddress,
  * @returns 每个地址的授权额度数组
  */
 export async function checkAllowanceBatchRaw(rpcUrl, tokenAddress, ownerAddresses, spenderAddress) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createProvider(rpcUrl);
     // ✅ 规范化地址（转为小写，避免 checksum 错误）
     const normalizedToken = tokenAddress.toLowerCase();
     const normalizedOwners = ownerAddresses.map((addr) => addr.toLowerCase());

package/dist/core/erc20/helpers.d.ts

@@ -5,6 +5,8 @@
  * 此文件不会被 barrel 对外导出。
  */
 import { JsonRpcProvider } from 'ethers';
+/** 只接受 0x + 40 hex。禁止给符号（如 SPCXB）补 0x 再去 getCode/ENS。 */
+export declare function requireEvmAddress(value: string | undefined, label: string): string;
 export declare const MAX_UINT256: bigint;
 export declare const MAX_APPROVAL_THRESHOLD: bigint;
 /**

package/dist/core/erc20/helpers.js

@@ -4,8 +4,16 @@
  * 包含地址校验、最大授权常量、Sell 代理地址解析、spender 智能路由解析等内部辅助。
  * 此文件不会被 barrel 对外导出。
  */
+import { getAddress, isAddress } from 'ethers';
 import { ADDRESSES, ZERO_ADDRESS } from '../constants/index.js';
 import { getErrorMessageFromUnknown } from '../foundation.js';
+/** 只接受 0x + 40 hex。禁止给符号（如 SPCXB）补 0x 再去 getCode/ENS。 */
+export function requireEvmAddress(value, label) {
+    const trimmed = String(value ?? '').trim();
+    if (isAddress(trimmed))
+        return getAddress(trimmed);
+    throw new Error(`${label} 不是有效的 EVM 地址: ${trimmed || '(空)'}`);
+}
 // ============================================================================
 // ✅ Max approval（与 BSC 策略一致：阈值判断，避免频繁重复授权）
 // ============================================================================
@@ -15,11 +23,8 @@ export const MAX_APPROVAL_THRESHOLD = MAX_UINT256 / 2n;
  * 验证合约地址是否有效（是否部署了代码）
  */
 export async function validateContractAddress(provider, address, label) {
+    const normalizedAddress = requireEvmAddress(address, label);
     try {
-        // ✅ 先规范化地址（转为 checksum 格式），避免 ethers v6 的严格校验报错
-        const normalizedAddress = address.toLowerCase().startsWith('0x')
-            ? address.toLowerCase()
-            : `0x${address.toLowerCase()}`;
         const code = await provider.getCode(normalizedAddress);
         if (code === '0x' || code.length <= 2) {
             throw new Error(`❌ ${label} 地址无效或未部署合约: ${address}`);

package/dist/core/erc20/helpers.test.d.ts

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

package/dist/core/erc20/helpers.test.js

@@ -0,0 +1,10 @@
+import { describe, expect, it } from 'vitest';
+import { requireEvmAddress } from './helpers.js';
+describe('requireEvmAddress', () => {
+    it('accepts SPCXB checksum address', () => {
+        expect(requireEvmAddress('0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1', '计价代币')).toBe('0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1');
+    });
+    it('rejects ticker symbols that used to trigger ENS', () => {
+        expect(() => requireEvmAddress('SPCXB', '计价代币')).toThrow('计价代币 不是有效的 EVM 地址: SPCXB');
+    });
+});

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

@@ -10,6 +10,7 @@ import { JsonRpcProvider } from 'ethers';
 import { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS } from '../constants/quote.js';
 import type { QuoteParams, QuoteResult } from './types.js';
 export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
+export declare function buildV2QuotePaths(tokenIn: string, tokenOut: string, hops: readonly string[]): string[][];
 /**
  * V2 报价（直接路径 + 多跳路径）
  * ✅ 优化：并行尝试直接路径和多跳路径
@@ -22,6 +23,7 @@ export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
  * @returns 报价结果
  */
 export declare function quoteV2(provider: JsonRpcProvider, tokenIn: string, tokenOut: string, amountIn: bigint, chain: string, routerOverride?: string): Promise<QuoteResult>;
+export declare function resolveQuotedV2Path(provider: JsonRpcProvider, tokenIn: string, tokenOut: string, amountIn: bigint, chain: string, routerOverride?: string): Promise<string[]>;
 /**
  * V3 报价（多费率尝试 + 多跳路径）
  * ✅ 优化：并行尝试多个费率

package/dist/core/quote/quote-helpers.js

@@ -12,6 +12,78 @@ import { calculateBundleSwapRoundTripProfit } from '../constants/profit.js';
 import { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, getQuoteChainKey } from '../constants/quote.js';
 const V2_ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
 export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS };
+/** BSC 股票币/额外计价，仅内部 hop；不进 QUOTE_CONFIG，避免改公共类型 */
+const BSC_V2_HOP_TOKENS = [
+    '0x6CEd5c6d3F913b48D59Fa07AbBfe9060C409087C', // ANTFUN
+    '0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d', // USD1
+    '0xcE24439F2D9C6a2289F741120FE202248B666666', // U
+    '0x000Ae314E2A2172a039B26378814C252734f556A', // ASTER
+    '0x61a10E8556BEd032eA176330e7F17D6a12a10000', // UUSD
+    '0x924fa68a0FC644485b8df8AbfA0A41C2e7744444', // 币安人生
+    '0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c', // BTCB
+    '0x570A5D26f7765Ecb712C0924E4De545B89fD43dF', // SOL
+    '0x2170Ed0880ac9A755fd29B2688956BD959F933F8', // ETH
+    '0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1', // SPCXB
+    '0xCA750eF65f295BBECd685Abf54e82CAf297BDB61', // SKHYB
+    '0x7138b48df7D98D7e3cc221BfE7192D0a178182D8', // SPYB
+    '0x21cAef8A43163Eea865baeE23b9C2E327696A3bf', // XAUT
+    '0x205812CdBed920aFf76C6580abD681a46D11efc7', // QQQB
+    '0x02Fca66C1D1aFB4E2A7884261eB00F63598a7436', // NVDAB
+    '0x431a3BEE82E2ca41e49895CbECE5bB0F76A89b7A', // AAPLB
+    '0x5b1910eAaD6450E50f816082Aa078C41F10C292f', // TSLAB
+    '0x80106cb3EAD06659A5ad19DF39D9b4733863B9b0', // MSFTB
+    '0x3F53De71c126BdaBAe20f9cD64848d317f6C3238', // GOOGLB
+    '0xA394dCEa3fd3847fD793afBFd163E2e3858B7c65', // HOODB
+    '0x4eF9d3062c7F6ebA4AAE4990c5036598C6eff4ec', // BABAB
+    '0x46cEeFDa28Dd7207059ed19B0acdc026955bb15C', // GMEB
+    '0xD6829Ea836b6FA224d099D40E54B31262f874631', // NFLXB
+    '0xE87afb3076AeB0f9B14E368DE8145ae6a2826A14', // MSTRB
+    '0xF2ec508422174Ee564de98187db9359D318AFB6b', // DJTB
+    '0xE28Cd11C99AF2df76bb8aDA4Cd0ef3904378280F', // SOXSB
+    '0xd97d097a89113fa59b76c572E5b2Eb647E8eefaf', // SOXLB
+    '0x5fd86da9B05abE396fe9d02a4A213A7c00556503', // MRNAB
+    '0x4af1D41cd9dD950dcA43984b43aaA2A8702714Ac', // FLNCB
+    '0x9b8E987e6fEc8Cf1380C4dcA7071e2C7853AEEA1', // FXIon
+    '0x3548Da95a9eFFE481e8604664d75e95821e557F5', // BMNRB
+    '0x91fc7371d6dE682A1e8CFcB4EB7dA693312A03a4', // BILIon
+];
+export function buildV2QuotePaths(tokenIn, tokenOut, hops) {
+    const tokenInLower = tokenIn.toLowerCase();
+    const tokenOutLower = tokenOut.toLowerCase();
+    const paths = [[tokenIn, tokenOut]];
+    for (const hop of hops) {
+        const hopLower = hop.toLowerCase();
+        if (tokenInLower === hopLower || tokenOutLower === hopLower)
+            continue;
+        paths.push([tokenIn, hop, tokenOut]);
+    }
+    return paths;
+}
+function hopTokensForChain(chainUpper) {
+    return chainUpper === 'BSC' ? BSC_V2_HOP_TOKENS : [];
+}
+async function bestAmountsOut(router, amountIn, paths) {
+    const quotePromises = paths.map(async (path) => {
+        try {
+            const amounts = await router.getAmountsOut(amountIn, path);
+            const amountOut = amounts[amounts.length - 1];
+            return { amountOut, path, success: amountOut > 0n };
+        }
+        catch {
+            return { amountOut: 0n, path, success: false };
+        }
+    });
+    const results = await Promise.all(quotePromises);
+    let best;
+    for (const result of results) {
+        if (!result.success)
+            continue;
+        if (!best || result.amountOut > best.amountOut) {
+            best = { amountOut: result.amountOut, path: result.path };
+        }
+    }
+    return best;
+}
 /**
  * V2 报价（直接路径 + 多跳路径）
  * ✅ 优化：并行尝试直接路径和多跳路径
@@ -34,45 +106,29 @@ export async function quoteV2(provider, tokenIn, tokenOut, amountIn, chain, rout
     }
     const routerAddress = routerOverride || config.v2Router;
     const router = new Contract(routerAddress, V2_ROUTER_ABI, provider);
-    const tokenInLower = tokenIn.toLowerCase();
-    const tokenOutLower = tokenOut.toLowerCase();
-    // ✅ 构建所有可能的路径
-    const paths = [];
-    // 直接路径
-    paths.push([tokenIn, tokenOut]);
-    // 多跳路径（通过稳定币）
-    for (const stableCoin of config.stableCoins) {
-        const stableLower = stableCoin.toLowerCase();
-        if (tokenInLower !== stableLower && tokenOutLower !== stableLower) {
-            paths.push([tokenIn, stableCoin, tokenOut]);
-        }
+    const stableBest = await bestAmountsOut(router, amountIn, buildV2QuotePaths(tokenIn, tokenOut, config.stableCoins));
+    if (stableBest) {
+        return { amountOut: stableBest.amountOut, path: stableBest.path };
     }
-    // ✅ 并行尝试所有路径
-    const quotePromises = paths.map(async (path) => {
-        try {
-            const amounts = await router.getAmountsOut(amountIn, path);
-            const amountOut = amounts[amounts.length - 1];
-            return { amountOut, path, success: amountOut > 0n };
-        }
-        catch {
-            return { amountOut: 0n, path, success: false };
-        }
-    });
-    const results = await Promise.all(quotePromises);
-    // 取报价最高的路径：薄直连池（如 ANTFUN/WBNB）会先成功但少报，利润看起来不像万六
-    let best;
-    for (const result of results) {
-        if (!result.success)
-            continue;
-        if (!best || result.amountOut > best.amountOut) {
-            best = { amountOut: result.amountOut, path: result.path };
-        }
+    const extraHops = hopTokensForChain(chainUpper);
+    if (extraHops.length === 0) {
+        return { amountOut: 0n };
     }
-    if (best) {
-        return { amountOut: best.amountOut, path: best.path };
+    const hopOnly = buildV2QuotePaths(tokenIn, tokenOut, extraHops).filter((path) => path.length >= 3);
+    const hopBest = await bestAmountsOut(router, amountIn, hopOnly);
+    if (hopBest) {
+        return { amountOut: hopBest.amountOut, path: hopBest.path };
     }
     return { amountOut: 0n };
 }
+export async function resolveQuotedV2Path(provider, tokenIn, tokenOut, amountIn, chain, routerOverride) {
+    if (amountIn <= 0n)
+        return [tokenIn, tokenOut];
+    const quoted = await quoteV2(provider, tokenIn, tokenOut, amountIn, chain, routerOverride);
+    if (quoted.path && quoted.path.length >= 2)
+        return quoted.path;
+    return [tokenIn, tokenOut];
+}
 // ============================================================================
 // V3 报价
 // ============================================================================

package/dist/core/quote/quote-helpers.test.d.ts

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

package/dist/core/quote/quote-helpers.test.js

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+import { buildV2QuotePaths } from './quote-helpers.js';
+const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
+const SPCXB = '0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1';
+const TOKEN = '0x7Db2F0c15f74aB0Dc0D4f49650dD60C45FFB7777';
+const USDT = '0x55d398326f99059fF775485246999027B3197955';
+describe('buildV2QuotePaths', () => {
+    it('keeps direct path and hops through SPCXB for native stock-token buys', () => {
+        const paths = buildV2QuotePaths(WBNB, TOKEN, [USDT, SPCXB]);
+        expect(paths[0]).toEqual([WBNB, TOKEN]);
+        expect(paths).toContainEqual([WBNB, SPCXB, TOKEN]);
+        expect(paths).toContainEqual([WBNB, USDT, TOKEN]);
+    });
+    it('does not hop through the input token itself', () => {
+        const paths = buildV2QuotePaths(SPCXB, TOKEN, [SPCXB, USDT]);
+        expect(paths).toEqual([
+            [SPCXB, TOKEN],
+            [SPCXB, USDT, TOKEN],
+        ]);
+    });
+});

package/dist/core/sign-context-helpers.js

@@ -1,15 +1,12 @@
-import { ethers, Wallet } from 'ethers';
+import { Wallet } from 'ethers';
 import { BLOCKRAZOR_BUILDER_EOA, CHAINS, getChainName } from './constants/index.js';
 import { getTxType } from './gas/bundle-gas.js';
+import { createProvider } from '../utils/provider-factory.js';
 export function resolveChainName(chainIdNum) {
     return getChainName(chainIdNum);
 }
 export function createSignProvider(rpcUrl, chainIdNum, chainName) {
-    return new ethers.JsonRpcProvider(rpcUrl, {
-        chainId: chainIdNum,
-        name: chainName ?? resolveChainName(chainIdNum),
-        ensAddress: undefined,
-    });
+    return createProvider(rpcUrl, chainIdNum, chainName ?? resolveChainName(chainIdNum));
 }
 export function createSignWallet(fromPrivateKey, provider) {
     return new Wallet(fromPrivateKey, provider);

package/dist/domains/dex/direct-router-v2-buy.js

@@ -7,7 +7,8 @@ import { getGasLimit } from '../../core/gas/bundle-gas.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields, } from '../../utils/bundle-helpers.js';
 import { getProfitRecipient, CHAINS, GAS_LIMITS } from '../../core/constants/index.js';
 import { ERC20_ABI } from '../../abis/common.js';
-import { getTokenToNativeQuote } from '../../core/quote/quote-helpers.js';
+import { getTokenToNativeQuote, resolveQuotedV2Path } from '../../core/quote/quote-helpers.js';
+import { requireEvmAddress } from '../../core/erc20/helpers.js';
 import { CHAIN_IDS, DIRECT_ROUTERS, SWAP_ROUTER02_V2_ABI, V2_ROUTER_ABI, buildBribeTransaction, buildProfitTransactionWithHops, calculateProfitAmount, encodeDYORMulticall, encodeDYORRefundETH, encodeDYORSwapExactTokensForTokens, findMaxFlowIndex, filterEniNativeBuyIndices, getBribeAmount, getCachedProvider, getDeadline, getGasPrice, getWrappedNative, isDYORSwap, isNativeToken, isSwapRouter02, } from './direct-router-helpers.js';
 export async function directV2BatchBuy(params) {
     const { chain, privateKeys, buyAmounts, tokenAddress, routerAddress, quoteToken, quoteTokenDecimals = 18, startNonces, config, } = params;
@@ -15,29 +16,33 @@ export async function directV2BatchBuy(params) {
         throw new Error('privateKeys 和 buyAmounts 长度必须相同');
     }
     const chainId = config.chainId || CHAIN_IDS[chain.toUpperCase()] || CHAINS.BSC.chainId;
-    // ✅ 方案 C：使用缓存的 Provider
+    const tokenOut = requireEvmAddress(tokenAddress, '目标代币');
+    const router = requireEvmAddress(routerAddress, 'Router');
     const provider = getCachedProvider(config.rpcUrl, chainId, chain);
     const useNative = isNativeToken(quoteToken);
     const wrappedNative = getWrappedNative(chain);
+    const inputToken = useNative ? wrappedNative : requireEvmAddress(quoteToken, '计价代币');
     // 创建钱包
     const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
     // ✅ 预先计算所有金额（同步操作，无 RPC）
     const flowAmounts = buyAmounts.map((amount) => ethers.parseUnits(amount, quoteTokenDecimals));
     const totalFlowWei = flowAmounts.reduce((sum, amt) => sum + amt, 0n);
     const baseProfitWei = calculateProfitAmount(totalFlowWei);
+    const probeAmount = flowAmounts.find((amt) => amt > 0n) ?? 0n;
     // ✅ 方案 B：并行获取 nonces、gasPrice、ERC20 报价 以及（非原生代币时）授权额度
-    const quoteTokenContract = !useNative && quoteToken ? new Contract(quoteToken, ERC20_ABI, provider) : null;
-    const [nonces, gasPrice, nativeProfitWei, buyAllowances] = await Promise.all([
+    const quoteTokenContract = !useNative ? new Contract(inputToken, ERC20_ABI, provider) : null;
+    const [nonces, gasPrice, nativeProfitWei, buyAllowances, quotedPath] = await Promise.all([
         startNonces && startNonces.length === wallets.length
             ? Promise.resolve(startNonces)
             : new NonceManager(provider).getNextNoncesForWallets(wallets),
         getGasPrice(provider, config),
-        !useNative && baseProfitWei > 0n && quoteToken
-            ? getTokenToNativeQuote(provider, quoteToken, baseProfitWei, chain, 'v2')
+        !useNative && baseProfitWei > 0n
+            ? getTokenToNativeQuote(provider, inputToken, baseProfitWei, chain, 'v2', undefined, router)
             : Promise.resolve(baseProfitWei),
         quoteTokenContract
-            ? Promise.all(wallets.map((w) => quoteTokenContract.allowance(w.address, routerAddress).catch(() => 0n)))
+            ? Promise.all(wallets.map((w) => quoteTokenContract.allowance(w.address, router).catch(() => 0n)))
             : Promise.resolve(wallets.map(() => ethers.MaxUint256)),
+        resolveQuotedV2Path(provider, inputToken, tokenOut, probeAmount, chain, router),
     ]);
     // 确定最终利润金额（ENI 链额外补偿利润转账的 gas 成本）
     let profitWei = nativeProfitWei > 0n ? nativeProfitWei : 0n;
@@ -80,12 +85,9 @@ export async function directV2BatchBuy(params) {
             if (activeFlowAmounts[i] <= 0n)
                 continue;
             if (activeBuyAllowances[i] < activeFlowAmounts[i]) {
-                const approveData = quoteTokenContract.interface.encodeFunctionData('approve', [
-                    routerAddress,
-                    ethers.MaxUint256,
-                ]);
+                const approveData = quoteTokenContract.interface.encodeFunctionData('approve', [router, ethers.MaxUint256]);
                 const approveTx = await activeWallets[i].signTransaction({
-                    to: quoteToken,
+                    to: inputToken,
                     data: approveData,
                     value: 0n,
                     nonce: activeNonces[i],
@@ -98,12 +100,10 @@ export async function directV2BatchBuy(params) {
             }
         }
     }
-    // 构建路径
-    const inputToken = useNative ? wrappedNative : quoteToken;
-    const path = [inputToken, tokenAddress];
+    const path = quotedPath.length >= 2 ? quotedPath : [inputToken, tokenOut];
     // 判断 Router 类型
-    const useSwapRouter02 = isSwapRouter02(chain, routerAddress);
-    const useDYORSwap = isDYORSwap(chain, routerAddress);
+    const useSwapRouter02 = isSwapRouter02(chain, router);
+    const useDYORSwap = isDYORSwap(chain, router);
     const routerIface = useSwapRouter02
         ? new ethers.Interface(SWAP_ROUTER02_V2_ABI)
         : new ethers.Interface(V2_ROUTER_ABI);
@@ -171,7 +171,7 @@ export async function directV2BatchBuy(params) {
         const { txData, txValue } = buildTxData(wallet, activeFlowAmounts[i]);
         signPromises.push(wallet
             .signTransaction({
-            to: routerAddress,
+            to: router,
             data: txData,
             value: txValue,
             nonce: activeNonces[i] + nonceOffsets[i],

package/dist/domains/dex/direct-router-v2-sell.js

@@ -8,7 +8,8 @@ import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFie
 import { getProfitRecipient, CHAINS, GAS_LIMITS } from '../../core/constants/index.js';
 import { getErrorMessageFromUnknown } from '../../core/index.js';
 import { ERC20_ABI } from '../../abis/common.js';
-import { getTokenToNativeQuote, quoteV2 } from '../../core/quote/quote-helpers.js';
+import { getTokenToNativeQuote, quoteV2, resolveQuotedV2Path } from '../../core/quote/quote-helpers.js';
+import { requireEvmAddress } from '../../core/erc20/helpers.js';
 import { CHAIN_IDS, DIRECT_ROUTERS, SWAP_ROUTER02_V2_ABI, V2_ROUTER_ABI, buildBribeTransaction, buildProfitTransactionWithHops, calculateProfitAmount, encodeDYORMulticall, encodeDYORSwapExactTokensForTokens, encodeDYORUnwrapWETH9, findMaxFlowIndex, getBribeAmount, getCachedProvider, getDeadline, getGasPrice, getWrappedNative, isDYORSwap, isNativeToken, isSwapRouter02, truncateDecimals, } from './direct-router-helpers.js';
 /**
  * V2 批量卖出（直接调用 Router）
@@ -16,13 +17,15 @@ import { CHAIN_IDS, DIRECT_ROUTERS, SWAP_ROUTER02_V2_ABI, V2_ROUTER_ABI, buildBr
 export async function directV2BatchSell(params) {
     const { chain, privateKeys, sellPercentages, sellAmounts, tokenAddress, tokenDecimals: inputDecimals, routerAddress, quoteToken, startNonces, config, } = params;
     const chainId = config.chainId || CHAIN_IDS[chain.toUpperCase()] || CHAINS.BSC.chainId;
-    // ✅ 方案 C：使用缓存的 Provider
+    const tokenIn = requireEvmAddress(tokenAddress, '目标代币');
+    const router = requireEvmAddress(routerAddress, 'Router');
     const provider = getCachedProvider(config.rpcUrl, chainId, chain);
     const useNativeOutput = isNativeToken(quoteToken);
     const wrappedNative = getWrappedNative(chain);
+    const outputToken = useNativeOutput ? wrappedNative : requireEvmAddress(quoteToken, '计价代币');
     // 创建钱包
     const wallets = privateKeys.map((pk) => new Wallet(pk, provider));
-    const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+    const tokenContract = new Contract(tokenIn, ERC20_ABI, provider);
     // ✅ 性能优化：并行获取所有独立的 RPC 数据（包括授权额度）
     const [fetchedDecimals, balances, allowances, nonces, gasPrice] = await Promise.all([
         inputDecimals !== undefined
@@ -32,7 +35,7 @@ export async function directV2BatchSell(params) {
                 .then((d) => Number(d))
                 .catch(() => 18),
         Promise.all(wallets.map((w) => tokenContract.balanceOf(w.address))),
-        Promise.all(wallets.map((w) => tokenContract.allowance(w.address, routerAddress).catch(() => 0n))),
+        Promise.all(wallets.map((w) => tokenContract.allowance(w.address, router).catch(() => 0n))),
         startNonces && startNonces.length === wallets.length
             ? Promise.resolve(startNonces)
             : new NonceManager(provider).getNextNoncesForWallets(wallets),
@@ -69,9 +72,9 @@ export async function directV2BatchSell(params) {
         if (sellAmountsWei[i] <= 0n)
             continue;
         if (allowances[i] < sellAmountsWei[i]) {
-            const approveData = tokenContract.interface.encodeFunctionData('approve', [routerAddress, ethers.MaxUint256]);
+            const approveData = tokenContract.interface.encodeFunctionData('approve', [router, ethers.MaxUint256]);
             const approveTx = await wallets[i].signTransaction({
-                to: tokenAddress,
+                to: tokenIn,
                 data: approveData,
                 value: 0n,
                 nonce: nonces[i],
@@ -89,7 +92,7 @@ export async function directV2BatchSell(params) {
         try {
             if (useNativeOutput) {
                 // 卖出代币 → 得到 BNB：先获取 V2 报价，再计算利润（✅ 使用当前 Router 报价，IROSwap 池需用 IROSwap Router）
-                const estimatedBNBOut = await getTokenToNativeQuote(provider, tokenAddress, totalSellAmount, chain, 'v2', undefined, routerAddress);
+                const estimatedBNBOut = await getTokenToNativeQuote(provider, tokenIn, totalSellAmount, chain, 'v2', undefined, router);
                 if (estimatedBNBOut <= 0n)
                     return 0n;
                 const profit = calculateProfitAmount(estimatedBNBOut);
@@ -100,10 +103,10 @@ export async function directV2BatchSell(params) {
                 // IROSwap 等 DEX 可能只有 token/USDT 池，无 USDT/WBNB，直接 token→WBNB 会失败
                 // 1) 用当前 Router 报价 token→quoteToken（如 VOYA→USDT）
                 // 2) 用默认 PancakeSwap 报价 quoteToken→WBNB（USDT/WBNB 在 Pancake 上存在）
-                const step1 = await quoteV2(provider, tokenAddress, quoteToken, totalSellAmount, chain, routerAddress);
+                const step1 = await quoteV2(provider, tokenIn, outputToken, totalSellAmount, chain, router);
                 if (!step1.amountOut || step1.amountOut <= 0n)
                     return 0n;
-                const estimatedBNBOut = await getTokenToNativeQuote(provider, quoteToken, step1.amountOut, chain, 'v2');
+                const estimatedBNBOut = await getTokenToNativeQuote(provider, outputToken, step1.amountOut, chain, 'v2');
                 if (estimatedBNBOut <= 0n)
                     return 0n;
                 const profit = calculateProfitAmount(estimatedBNBOut);
@@ -116,11 +119,9 @@ export async function directV2BatchSell(params) {
             return 0n;
         }
     })();
-    // 构建路径和 Router
-    const outputToken = useNativeOutput ? wrappedNative : quoteToken;
-    const path = [tokenAddress, outputToken];
-    const useSwapRouter02 = isSwapRouter02(chain, routerAddress);
-    const useDYORSwap = isDYORSwap(chain, routerAddress);
+    const path = await resolveQuotedV2Path(provider, tokenIn, outputToken, totalSellAmount, chain, router);
+    const useSwapRouter02 = isSwapRouter02(chain, router);
+    const useDYORSwap = isDYORSwap(chain, router);
     const routerIface = useSwapRouter02
         ? new ethers.Interface(SWAP_ROUTER02_V2_ABI)
         : new ethers.Interface(V2_ROUTER_ABI);
@@ -186,7 +187,7 @@ export async function directV2BatchSell(params) {
             return;
         signPromises.push(wallet
             .signTransaction({
-            to: routerAddress,
+            to: router,
             data: buildSellTxData(wallet, sellAmountsWei[i]),
             value: 0n,
             nonce: nonces[i] + nonceOffsets[i],

package/dist/domains/flap/portal-bundle-merkle/core-helpers.js

@@ -1,4 +1,5 @@
 import { ethers, Contract, Wallet, Interface, } from 'ethers';
+import { createProvider } from '../../../utils/provider-factory.js';
 import { ADDRESSES, applySlippageBps, } from '../../../core/constants/index.js';
 import { MULTICALL3_ABI, V2_ROUTER_QUOTE_ABI, } from '../../../core/shared-abis/common.js';
 import { getGasLimit, } from '../../../core/gas/bundle-gas.js';
@@ -81,7 +82,7 @@ export function createChainContext(chain, rpcUrl) {
         return { chainId, provider: cached.provider };
     }
     // ✅ 创建新 Provider 并缓存
-    const provider = new ethers.JsonRpcProvider(rpcUrl, { chainId, name: chain });
+    const provider = createProvider(rpcUrl, chainId, chain);
     providerCache.set(cacheKey, { provider, expireAt: now + PROVIDER_CACHE_TTL_MS });
     return { chainId, provider };
 }

package/dist/domains/flap/portal-bundle-merkle/pancake-proxy/helpers.js

@@ -1,4 +1,4 @@
-import { JsonRpcProvider } from 'ethers';
+import { createProvider } from '../../../../utils/provider-factory.js';
 import { getTokenDecimals as fetchTokenDecimals } from '../../../../utils/swap-helpers.js';
 import { ADDRESSES, ZERO_ADDRESS } from '../../../../core/constants/index.js';
 import { CHAIN_ID_MAP } from '../config.js';
@@ -15,7 +15,7 @@ export function getCachedProvider(chain, rpcUrl, chainId) {
         return cached.provider;
     }
     const resolvedChainId = chainId ?? (CHAIN_ID_MAP[chain] || 56);
-    const provider = new JsonRpcProvider(rpcUrl, { chainId: resolvedChainId, name: chain });
+    const provider = createProvider(rpcUrl, resolvedChainId, chain);
     providerCache.set(cacheKey, { provider, expireAt: now + PROVIDER_CACHE_TTL_MS });
     return provider;
 }

package/dist/domains/flap/portal-bundle-merkle/private/helpers.js

@@ -1,5 +1,6 @@
-import { ethers, JsonRpcProvider } from 'ethers';
+import { ethers } from 'ethers';
 import { MerkleClient } from '../../../../core/clients/merkle.js';
+import { createProvider } from '../../../../utils/provider-factory.js';
 import { ZERO_ADDRESS, CHAINS, applySlippageBps } from '../../../../core/constants/index.js';
 import { CHAIN_ID_MAP, getTxType, calculateProfit, } from '../config.js';
 const DEFAULT_GAS_LIMIT = 800000;
@@ -15,7 +16,7 @@ export function createMerkleContext(chain, config) {
         return {
             chainId,
             // ✅ 禁用 ENS: 避免 "network does not support ENS" 错误
-            provider: new JsonRpcProvider(config.customRpcUrl, { chainId, name: chain.toLowerCase(), ensAddress: undefined }),
+            provider: createProvider(config.customRpcUrl, chainId, chain.toLowerCase()),
         };
     }
     const merkle = new MerkleClient({

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

@@ -1,43 +1,28 @@
 /**
- * Provider 工厂函数 - 统一创建 JsonRpcProvider 并禁用 ENS
+ * Provider 工厂 — 真正禁用 ENS
  *
- * 目的:
- * 1. 避免 "network does not support ENS" 错误
- * 2. 统一 Provider 创建逻辑
- * 3. 提升性能 (跳过 ENS 解析)
+ * ethers v6 的 `{ ensAddress: undefined }` 不会去掉 EnsPlugin。
+ * 自定义 Network（例如 name: "BSC"）没有 ENS 时，任何非 0x 地址
+ * （如计价符号 "SPCXB"）都会在 getEnsAddress 抛
+ * "network does not support ENS"。
  */
 import { JsonRpcProvider } from 'ethers';
+export declare class NoEnsJsonRpcProvider extends JsonRpcProvider {
+    resolveName(name: string): Promise<null | string>;
+}
 /**
- * 创建 JsonRpcProvider (自动禁用 ENS)
- *
- * @param rpcUrl RPC URL
- * @param chainId 链 ID (可选)
- * @param chainName 链名称 (可选,用于日志)
- * @param options 额外选项
- * @returns JsonRpcProvider 实例
+ * 创建 JsonRpcProvider（拒绝把符号/乱码当 ENS 解析）
  */
 export declare function createProvider(rpcUrl: string, chainId?: number, chainName?: string, options?: {
     batchMaxCount?: number;
     batchStallTime?: number;
 }): JsonRpcProvider;
 export declare function createCachedProvider(rpcUrl: string, chainId: number, chainName?: string): JsonRpcProvider;
-/**
- * 清除 Provider 缓存
- */
 export declare function clearProviderCache(): void;
 /**
  * ENI 专用 Provider（staticNetwork，适合批量 RPC）
  */
 export declare function createEniProvider(rpcUrl: string, chainId?: number): JsonRpcProvider;
-/**
- * XLayer 专用 Provider 创建函数
- */
 export declare function createXLayerProvider(rpcUrl: string): JsonRpcProvider;
-/**
- * BSC 专用 Provider 创建函数
- */
 export declare function createBscProvider(rpcUrl: string): JsonRpcProvider;
-/**
- * Monad 专用 Provider 创建函数
- */
 export declare function createMonadProvider(rpcUrl: string): JsonRpcProvider;

package/dist/utils/provider-factory.js

@@ -1,59 +1,46 @@
 /**
- * Provider 工厂函数 - 统一创建 JsonRpcProvider 并禁用 ENS
+ * Provider 工厂 — 真正禁用 ENS
  *
- * 目的:
- * 1. 避免 "network does not support ENS" 错误
- * 2. 统一 Provider 创建逻辑
- * 3. 提升性能 (跳过 ENS 解析)
+ * ethers v6 的 `{ ensAddress: undefined }` 不会去掉 EnsPlugin。
+ * 自定义 Network（例如 name: "BSC"）没有 ENS 时，任何非 0x 地址
+ * （如计价符号 "SPCXB"）都会在 getEnsAddress 抛
+ * "network does not support ENS"。
  */
-import { JsonRpcProvider } from 'ethers';
+import { JsonRpcProvider, Network, getAddress, isAddress } from 'ethers';
+export class NoEnsJsonRpcProvider extends JsonRpcProvider {
+    async resolveName(name) {
+        const trimmed = String(name ?? '').trim();
+        if (isAddress(trimmed))
+            return getAddress(trimmed);
+        throw new Error(`无效的合约地址: ${trimmed || '(空)'}（当前链不支持 ENS 域名解析）`);
+    }
+}
 /**
- * 创建 JsonRpcProvider (自动禁用 ENS)
- *
- * @param rpcUrl RPC URL
- * @param chainId 链 ID (可选)
- * @param chainName 链名称 (可选,用于日志)
- * @param options 额外选项
- * @returns JsonRpcProvider 实例
+ * 创建 JsonRpcProvider（拒绝把符号/乱码当 ENS 解析）
  */
 export function createProvider(rpcUrl, chainId, chainName, options) {
-    // 构建网络配置
-    const networkConfig = chainId
-        ? {
-            chainId,
-            name: chainName || `chain-${chainId}`,
-            ensAddress: undefined, // ✅ 禁用 ENS 解析
-        }
-        : undefined;
-    // 构建批处理选项
-    const batchOptions = options
-        ? {
-            batchMaxCount: options.batchMaxCount ?? 20,
-            batchStallTime: options.batchStallTime ?? 30,
-        }
-        : undefined;
-    // 创建 Provider
-    if (networkConfig && batchOptions) {
-        return new JsonRpcProvider(rpcUrl, networkConfig, batchOptions);
-    }
-    else if (networkConfig) {
-        return new JsonRpcProvider(rpcUrl, networkConfig);
+    const network = chainId != null ? new Network(chainName || `chain-${chainId}`, chainId) : undefined;
+    const providerOptions = {
+        ...(network ? { staticNetwork: network } : {}),
+        ...(options
+            ? {
+                batchMaxCount: options.batchMaxCount ?? 20,
+                batchStallTime: options.batchStallTime ?? 30,
+            }
+            : {}),
+    };
+    const hasOptions = Boolean(network) || Boolean(options);
+    if (network && hasOptions) {
+        return new NoEnsJsonRpcProvider(rpcUrl, network, providerOptions);
     }
-    else if (batchOptions) {
-        return new JsonRpcProvider(rpcUrl, undefined, batchOptions);
+    if (network) {
+        return new NoEnsJsonRpcProvider(rpcUrl, network);
     }
-    else {
-        return new JsonRpcProvider(rpcUrl);
+    if (hasOptions) {
+        return new NoEnsJsonRpcProvider(rpcUrl, undefined, providerOptions);
     }
+    return new NoEnsJsonRpcProvider(rpcUrl);
 }
-/**
- * 创建带缓存的 Provider
- *
- * @param rpcUrl RPC URL
- * @param chainId 链 ID
- * @param chainName 链名称
- * @returns JsonRpcProvider 实例
- */
 const providerCache = new Map();
 export function createCachedProvider(rpcUrl, chainId, chainName) {
     const key = `${rpcUrl}:${chainId}`;
@@ -66,9 +53,6 @@ export function createCachedProvider(rpcUrl, chainId, chainName) {
     }
     return providerCache.get(key);
 }
-/**
- * 清除 Provider 缓存
- */
 export function clearProviderCache() {
     providerCache.clear();
 }
@@ -76,33 +60,23 @@ export function clearProviderCache() {
  * ENI 专用 Provider（staticNetwork，适合批量 RPC）
  */
 export function createEniProvider(rpcUrl, chainId = 173) {
-    return new JsonRpcProvider(rpcUrl, chainId, {
-        staticNetwork: true,
+    return createProvider(rpcUrl, chainId, 'eni', {
         batchMaxCount: 20,
         batchStallTime: 30,
     });
 }
-/**
- * XLayer 专用 Provider 创建函数
- */
 export function createXLayerProvider(rpcUrl) {
     return createProvider(rpcUrl, 196, 'xlayer', {
         batchMaxCount: 20,
         batchStallTime: 30,
     });
 }
-/**
- * BSC 专用 Provider 创建函数
- */
 export function createBscProvider(rpcUrl) {
     return createProvider(rpcUrl, 56, 'bsc', {
         batchMaxCount: 20,
         batchStallTime: 30,
     });
 }
-/**
- * Monad 专用 Provider 创建函数
- */
 export function createMonadProvider(rpcUrl) {
     return createProvider(rpcUrl, 143, 'monad', {
         batchMaxCount: 20,

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

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

package/dist/utils/provider-factory.test.js

@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest';
+import { Network } from 'ethers';
+import { NoEnsJsonRpcProvider } from './provider-factory.js';
+describe('NoEnsJsonRpcProvider', () => {
+    const provider = new NoEnsJsonRpcProvider('http://127.0.0.1:1', new Network('BSC', 56), {
+        staticNetwork: true,
+    });
+    it('resolves real EVM addresses', async () => {
+        await expect(provider.resolveName('0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1')).resolves.toBe('0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1');
+    });
+    it('rejects ticker symbols instead of ENS', async () => {
+        await expect(provider.resolveName('SPCXB')).rejects.toThrow(/无效的合约地址: SPCXB/);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "4.3.7",
+  "version": "4.3.8",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",