four-flap-meme-sdk 4.3.7 → 4.3.9

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/four-client-fallback.test.js

@@ -1,5 +1,6 @@
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { FourClient } from './four.js';
+import { FOUR_BNB_RAISED_TOKEN_FALLBACK } from '../../domains/four/raised-token.js';
 describe('FourClient private API rate-limit fallback', () => {
     afterEach(() => {
         vi.unstubAllGlobals();
@@ -65,4 +66,84 @@ describe('FourClient private API rate-limit fallback', () => {
             networkCode: 'BSC',
         })).resolves.toBe('nonce-2');
     });
+    it('browser hits official four.meme first so the request uses the user IP', async () => {
+        vi.stubGlobal('window', globalThis);
+        const calls = [];
+        vi.stubGlobal('fetch', vi.fn(async (input) => {
+            calls.push(String(input));
+            return new Response(JSON.stringify({ code: 0, data: 'nonce-user-ip' }));
+        }));
+        await expect(new FourClient({ baseUrl: 'https://bscfourapi.emit.tools' }).generateNonce({
+            accountAddress: `0x${'11'.repeat(20)}`,
+            verifyType: 'LOGIN',
+            networkCode: 'BSC',
+        })).resolves.toBe('nonce-user-ip');
+        expect(calls[0]).toContain('four.meme/meme-api');
+    });
+    it('browser createToken sends CORS-allowed Authorization to four.meme', async () => {
+        vi.stubGlobal('window', globalThis);
+        const headers = [];
+        vi.stubGlobal('fetch', vi.fn(async (input, init) => {
+            if (!String(input).includes('four.meme')) {
+                return new Response(JSON.stringify({ code: -1013, msg: 'Too many requests' }), { status: 429 });
+            }
+            headers.push((init?.headers || {}));
+            return new Response(JSON.stringify({ code: 0, data: { createArg: '0x1', signature: '0x2' } }));
+        }));
+        await expect(new FourClient({ baseUrl: 'https://bscfourapi.emit.tools' }).createToken('access-token', createReq())).resolves.toEqual({ createArg: '0x1', signature: '0x2' });
+        expect(headers[0]?.Authorization).toBe('access-token');
+        expect(headers[0]?.['meme-web-access']).toBeUndefined();
+    });
+    it('retries proxy with meme-web-access if official Authorization is treated as not login', async () => {
+        vi.stubGlobal('window', globalThis);
+        const seen = [];
+        vi.stubGlobal('fetch', vi.fn(async (input, init) => {
+            const url = String(input);
+            const hdrs = (init?.headers || {});
+            seen.push({ url, access: hdrs['meme-web-access'], authorization: hdrs.Authorization });
+            if (url.includes('four.meme')) {
+                return new Response(JSON.stringify({ code: -1004, msg: 'User not login' }));
+            }
+            return new Response(JSON.stringify({ code: 0, data: { createArg: '0x9', signature: '0xa' } }));
+        }));
+        await expect(new FourClient({ baseUrl: 'https://bscfourapi.emit.tools' }).createToken('access-token', createReq())).resolves.toEqual({ createArg: '0x9', signature: '0xa' });
+        expect(seen[0]?.url).toContain('four.meme');
+        expect(seen[0]?.authorization).toBe('access-token');
+        expect(seen.some((item) => item.url.includes('bscfourapi') && item.access === 'access-token')).toBe(true);
+    });
+    it('keeps proxy -1013 instead of Failed to fetch when browser CORS-upload to four.meme still fails', async () => {
+        vi.stubGlobal('window', globalThis);
+        const calls = [];
+        vi.stubGlobal('fetch', vi.fn(async (input) => {
+            const url = String(input);
+            calls.push(url);
+            if (url.includes('four.meme')) {
+                throw new TypeError('Failed to fetch');
+            }
+            return new Response(JSON.stringify({ code: -1013, msg: 'Too many requests, banned for 15 minutes, remain 120s' }), { status: 429 });
+        }));
+        await expect(new FourClient({ baseUrl: 'https://bscfourapi.emit.tools' }).createToken('access', createReq())).rejects.toThrow(/-1013|Too many requests/);
+        expect(calls.some((url) => url.includes('four.meme'))).toBe(true);
+    });
 });
+function createReq() {
+    return {
+        name: 't',
+        shortName: 't',
+        desc: '',
+        imgUrl: 'https://example.com/a.png',
+        launchTime: 1,
+        label: 'Meme',
+        preSale: '0',
+        onlyMPC: false,
+        lpTradingFee: 0.0025,
+        symbol: 'BNB',
+        totalSupply: 1_000_000_000,
+        raisedAmount: 18,
+        saleRate: 0.8,
+        reserveRate: 0,
+        funGroup: false,
+        clickFun: false,
+        raisedToken: FOUR_BNB_RAISED_TOKEN_FALLBACK,
+    };
+}

package/dist/core/clients/four.d.ts

@@ -112,6 +112,13 @@ export declare class FourClient {
     private uploadUrls;
     constructor(cfg?: FourConfig);
     private attachApiCode;
+    private isBrowserEnv;
+    private extractAccessToken;
+    /** 浏览器直连官网只用 CORS 放行的 Authorization，避免 meme-web-access 被预检拦成 Failed to fetch。 */
+    private requestHeaders;
+    /** 浏览器直连 four.meme 若仍被 CORS 拦成 Failed to fetch，回退到更早的限流错误。 */
+    private preferRateLimitError;
+    private shouldRetryPrivateApi;
     private postPrivateJson;
     generateNonce(req: GenerateNonceReq): Promise<string>;
     loginDex(body: LoginReq): Promise<string>;
@@ -134,6 +141,7 @@ export declare class FourClient {
      */
     private isCorsOrNetworkError;
     private isInvalidJsonError;
+    private isNotLoginError;
     private getFilenameFromBlob;
     createToken(accessToken: string, req: CreateTokenReq): Promise<CreateTokenResp>;
     getPublicConfig(): Promise<FourPublicConfig>;

package/dist/core/clients/four.js

@@ -112,20 +112,20 @@ const RATE_LIMIT_CODES = new Set([-1038, -1013]);
 /** Cloudflare Worker 代理（独立出口 IP，主线路被封时换这条） */
 const FOUR_MEME_PROXY_API = 'https://bscfourapi.emit.tools';
 /**
- * Four.meme 官方 API。nonce/login 浏览器可直连；create/upload 需 `meme-web-access`，
- * 官方 CORS 不放行该头，浏览器应走自有代理。
+ * Four.meme 官方 API。浏览器走这条才是用户自己的 IP，不会被共用代理连坐封禁。
+ * 官网 CORS 允许 Authorization，不允许 meme-web-access；浏览器直连时改用前者。
  */
 const FOUR_MEME_OFFICIAL_API = 'https://four.meme/meme-api';
 export class FourClient {
     baseUrl;
     uploadUrls;
     constructor(cfg) {
-        // 默认使用 Cloudflare Workers 代理，已配置 CORS，浏览器可直接使用
         this.baseUrl = cfg?.baseUrl || FOUR_MEME_PROXY_API;
-        // 主 URL → 自定义备用 → emit 代理（换 IP）→ 官方直连（Node 无 CORS）
-        this.uploadUrls = [
-            ...new Set([this.baseUrl, ...(cfg?.uploadFallbackUrls || []), FOUR_MEME_PROXY_API, FOUR_MEME_OFFICIAL_API]),
-        ];
+        const urls = [this.baseUrl, ...(cfg?.uploadFallbackUrls || []), FOUR_MEME_PROXY_API, FOUR_MEME_OFFICIAL_API];
+        // 浏览器先打官网（用户 IP）；Node 仍先走调用方传入的代理
+        this.uploadUrls = this.isBrowserEnv()
+            ? [...new Set([FOUR_MEME_OFFICIAL_API, ...urls])]
+            : [...new Set(urls)];
     }
     attachApiCode(err, code) {
         const n = Number(code);
@@ -133,14 +133,61 @@ export class FourClient {
             err.apiCode = n;
         return err;
     }
+    isBrowserEnv() {
+        return typeof window !== 'undefined';
+    }
+    extractAccessToken(headers) {
+        if (!headers)
+            return undefined;
+        for (const [key, value] of Object.entries(headers)) {
+            const k = key.toLowerCase();
+            if (k === 'meme-web-access' || k === 'authorization')
+                return value;
+        }
+        return undefined;
+    }
+    /** 浏览器直连官网只用 CORS 放行的 Authorization，避免 meme-web-access 被预检拦成 Failed to fetch。 */
+    requestHeaders(baseUrl, headers) {
+        const next = { ...(headers || {}) };
+        const token = this.extractAccessToken(next);
+        for (const key of Object.keys(next)) {
+            if (key.toLowerCase() === 'meme-web-access')
+                delete next[key];
+        }
+        if (!token)
+            return next;
+        const raw = token.replace(/^Bearer\s+/i, '');
+        if (this.isBrowserEnv() && baseUrl === FOUR_MEME_OFFICIAL_API) {
+            next.Authorization = raw;
+            return next;
+        }
+        next['meme-web-access'] = raw;
+        delete next.Authorization;
+        return next;
+    }
+    /** 浏览器直连 four.meme 若仍被 CORS 拦成 Failed to fetch，回退到更早的限流错误。 */
+    preferRateLimitError(lastError, rateLimitError, fallback) {
+        if (rateLimitError && (!lastError || this.isCorsOrNetworkError(lastError)))
+            return rateLimitError;
+        return lastError ?? rateLimitError ?? new Error(fallback);
+    }
+    shouldRetryPrivateApi(err, baseUrl, canRetry) {
+        if (!canRetry)
+            return false;
+        return (this.isRateLimitError(err) ||
+            this.isCorsOrNetworkError(err) ||
+            this.isInvalidJsonError(err) ||
+            (this.isNotLoginError(err) && baseUrl === FOUR_MEME_OFFICIAL_API));
+    }
     async postPrivateJson(path, failLabel, init) {
         let lastError = null;
+        let rateLimitError = null;
         for (let i = 0; i < this.uploadUrls.length; i++) {
             const baseUrl = this.uploadUrls[i];
             try {
                 const r = await fetch(`${baseUrl}${path}`, {
                     method: 'POST',
-                    headers: { 'Content-Type': 'application/json', ...(init.headers || {}) },
+                    headers: { 'Content-Type': 'application/json', ...this.requestHeaders(baseUrl, init.headers) },
                     body: init.body,
                 });
                 const j = (await r.json());
@@ -152,14 +199,14 @@ export class FourClient {
             catch (e) {
                 const err = e instanceof Error ? e : new Error(getErrorMessageFromUnknown(e));
                 lastError = err;
-                const canRetry = i < this.uploadUrls.length - 1;
-                if (canRetry && (this.isRateLimitError(err) || this.isCorsOrNetworkError(err) || this.isInvalidJsonError(err))) {
+                if (this.isRateLimitError(err))
+                    rateLimitError = err;
+                if (this.shouldRetryPrivateApi(err, baseUrl, i < this.uploadUrls.length - 1))
                     continue;
-                }
                 break;
             }
         }
-        throw lastError ?? new Error(failLabel);
+        throw this.preferRateLimitError(lastError, rateLimitError, failLabel);
     }
     async generateNonce(req) {
         return this.postPrivateJson('/v1/private/user/nonce/generate', 'generateNonce failed', {
@@ -188,40 +235,30 @@ export class FourClient {
         const finalFilename = filename || this.getFilenameFromBlob(file);
         let lastError = null;
         // ✅ 依次尝试所有上传端点（代理 → 自定义备用 → 官方直连兜底）
+        let rateLimitError = null;
         for (let i = 0; i < this.uploadUrls.length; i++) {
             const baseUrl = this.uploadUrls[i];
-            const isOfficial = baseUrl === FOUR_MEME_OFFICIAL_API;
             try {
                 const imgUrl = await this.doUpload(baseUrl, accessToken, file, finalFilename);
-                // 上传成功，写入持久化缓存（localStorage）
                 setCachedUrl(hash, imgUrl);
                 return imgUrl;
             }
             catch (e) {
                 const err = e instanceof Error ? e : new Error(getErrorMessageFromUnknown(e));
                 lastError = err;
-                const canRetry = i < this.uploadUrls.length - 1;
-                if (this.isRateLimitError(err) && canRetry) {
-                    continue;
-                }
-                if (this.isCorsOrNetworkError(err) && canRetry) {
-                    // CORS/网络错误（常见于浏览器直连官方 API）→ 跳过，继续尝试下一个
-                    console.warn(`[FourClient] 端点 ${baseUrl} 请求失败(${isOfficial ? 'CORS限制' : '网络错误'})，跳过`);
+                if (this.isRateLimitError(err))
+                    rateLimitError = err;
+                if (this.shouldRetryPrivateApi(err, baseUrl, i < this.uploadUrls.length - 1))
                     continue;
-                }
-                // 无法重试，跳出
                 break;
             }
         }
-        // 所有端点都失败
-        const isRateLimit = lastError && this.isRateLimitError(lastError);
-        if (isRateLimit) {
+        const chosen = this.preferRateLimitError(lastError, rateLimitError, 'upload failed: all endpoints exhausted');
+        if (this.isRateLimitError(chosen)) {
             throw new Error(`图片上传失败：Four.meme 限流（每日配额或 15 分钟封禁）。请稍后再试。` +
-                `\n原始错误: ${getErrorMessageFromUnknown(lastError)}`);
+                `\n原始错误: ${getErrorMessageFromUnknown(chosen)}`);
         }
-        if (lastError !== null && lastError !== undefined)
-            throw lastError;
-        throw new Error('upload failed: all endpoints exhausted');
+        throw chosen;
     }
     /**
      * 执行单次上传请求
@@ -231,7 +268,7 @@ export class FourClient {
         form.append('file', file, filename);
         const r = await fetch(`${baseUrl}/v1/private/token/upload`, {
             method: 'POST',
-            headers: { 'meme-web-access': accessToken },
+            headers: this.requestHeaders(baseUrl, { 'meme-web-access': accessToken }),
             body: form,
         });
         const j = await r.json();
@@ -262,6 +299,12 @@ export class FourClient {
     isInvalidJsonError(e) {
         return e instanceof SyntaxError || /unexpected token|not valid json/i.test(getErrorMessageFromUnknown(e));
     }
+    isNotLoginError(e) {
+        const code = Number(e.apiCode);
+        if (code === -1004)
+            return true;
+        return /user not login/i.test(getErrorMessageFromUnknown(e));
+    }
     getFilenameFromBlob(blob) {
         const mimeToExt = {
             'image/jpeg': 'jpg',

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.9",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",