@w3lib/evm-batch-call 0.1.0

package/dist/rpcNodes.js

@@ -0,0 +1,193 @@
+// 内置公共节点表，手动维护；修改后用 `pnpm check:rpc` 检查可用性。
+// 节点按优先级排序，要求能在浏览器里直连：放行跨域、支持 batch 请求、chainId 正确、不要求 API Key。
+/** 各 EVM 链的公共 RPC 节点（按优先级排序） */
+export const DEFAULT_RPC_URLS = {
+    // eth
+    1: [
+        'https://rpc.mevblocker.io',
+        'https://eth.blockrazor.xyz',
+        'https://ethereum-rpc.publicnode.com',
+    ],
+    // base
+    8453: [
+        'https://base-rpc.publicnode.com',
+        'https://mainnet.base.org',
+        'https://base.api.pocket.network',
+    ],
+    // bsc
+    56: [
+        'https://bsc.blockrazor.xyz',
+        'https://bsc-dataseed1.bnbchain.org',
+        'https://bsc-dataseed2.bnbchain.org',
+        'https://bsc-dataseed.bnbchain.org',
+        'https://bsc-dataseed3.bnbchain.org',
+        'https://bsc-dataseed4.bnbchain.org',
+        'https://bsc-rpc.publicnode.com',
+        'https://bsc.publicnode.com',
+    ],
+    // arbitrum
+    42161: [
+        'https://arb1.arbitrum.io/rpc',
+        'https://arbitrum-one-rpc.publicnode.com',
+        'https://arb-one.api.pocket.network',
+    ],
+    // optimism
+    10: [
+        'https://mainnet.optimism.io',
+        'https://op.api.pocket.network',
+    ],
+    // polygon
+    137: [
+        'https://polygon.drpc.org',
+        'https://poly.api.pocket.network',
+    ],
+    // avax
+    43114: [
+        'https://api.avax.network/ext/bc/C/rpc',
+        'https://avax.api.pocket.network',
+    ],
+    // scroll
+    534352: [
+        'https://rpc.scroll.io',
+        'https://scroll-rpc.publicnode.com',
+        'https://scroll.api.pocket.network',
+    ],
+    // linea
+    59144: [
+        'https://rpc.linea.build',
+        'https://linea.api.pocket.network',
+    ],
+    // blast
+    81457: [
+        'https://rpc.blast.io',
+        'https://blast.api.pocket.network',
+    ],
+    // zksync
+    324: [
+        'https://mainnet.era.zksync.io',
+        'https://zksync-era.api.pocket.network',
+    ],
+    // mode
+    34443: [
+        'https://mainnet.mode.network',
+    ],
+    // mantle
+    5000: [
+        'https://rpc.mantle.xyz',
+        'https://mantle.api.pocket.network',
+    ],
+    // xlayer
+    196: [
+        'https://rpc.xlayer.tech',
+        'https://xlayerrpc.okx.com',
+    ],
+    // monad
+    143: [
+        'https://rpc.monad.xyz',
+        'https://rpc2.monad.xyz',
+        'https://rpc3.monad.xyz',
+    ],
+    // core
+    1116: [
+        'https://rpc.coredao.org',
+        'https://rpc.ankr.com/core',
+    ],
+    // plasma
+    9745: [
+        'https://rpc.plasma.to',
+    ],
+    // morph
+    2818: [
+        'https://rpc-quicknode.morphl2.io',
+        'https://rpc.morphl2.io',
+    ],
+    // hyperevm
+    999: [
+        'https://rpc.hyperliquid.xyz/evm',
+        'https://rpc.hypurrscan.io',
+    ],
+    // eni
+    173: [
+        'https://rpc.eniac.network',
+        'https://jp.enirpc.com',
+        'https://rpc1.eniac.network',
+        'https://rpc2.eniac.network',
+        'https://jp.eniacrpc.net',
+    ],
+    // fsc
+    201022: [
+        'https://fsc-dataseed1.fonscan.io',
+        'https://fsc-dataseed2.fonscan.io',
+        'https://fsc-dataseed3.fonscan.io',
+        'https://rpc.hieswap.com',
+    ],
+    // anubis
+    6714: [
+        'https://rpc.anubispace.org',
+    ],
+    // opbnb
+    204: [
+        'https://opbnb-mainnet-rpc.bnbchain.org',
+        'https://opbnb-rpc.publicnode.com',
+        'https://opbnb.api.pocket.network',
+    ],
+    // safe
+    6666665: [
+        'https://safe4.anwang.com/rpc',
+    ],
+    // berachain
+    80094: [
+        'https://rpc.berachain.com',
+        'https://berachain-rpc.publicnode.com',
+        'https://bera.api.pocket.network',
+    ],
+    // fusnchain
+    8379: [
+        'https://rpc.fusn.network',
+    ],
+    // ma
+    20260131: [
+        'https://rpc.ma-chain.xyz',
+    ],
+    // robinhood
+    4663: [
+        'https://rpc.mainnet.chain.robinhood.com',
+        'https://robinhood.api.pocket.network',
+    ],
+    // mychain
+    210400: [
+        'https://rpc.mychain.my',
+    ],
+    // stable
+    988: [
+        'https://rpc.stable.xyz',
+    ],
+    // unichain
+    130: [
+        'https://unichain-rpc.publicnode.com',
+        'https://mainnet.unichain.org',
+    ],
+    // botchain
+    677: [
+        'https://rpc.botchain.ai',
+    ],
+    // winchain
+    86233268: [
+        'https://rpc.winchain.win',
+        'https://rpc2.winchain.win',
+    ],
+    // ink
+    57073: [
+        'https://rpc-gel.inkonchain.com',
+        'https://rpc-qnd.inkonchain.com',
+        'https://ink.api.pocket.network',
+    ],
+};
+/** Tron 主网全节点 HTTP API（均支持跨域与 deployless） */
+export const DEFAULT_TRON_HOSTS = [
+    'https://api.trongrid.io',
+    'https://tron-rpc.publicnode.com',
+    'https://api.tronstack.io',
+    'https://tron-mainnet.token.im',
+];
+//# sourceMappingURL=rpcNodes.js.map

package/dist/rpcNodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcNodes.js","sourceRoot":"","sources":["../src/rpcNodes.ts"],"names":[],"mappings":"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"}

package/dist/source.d.ts

@@ -0,0 +1,23 @@
+import { type Eip1193Provider } from 'ethers';
+import type { EthersLikeProvider } from './aggregate.js';
+import { type FallbackOptions } from './fallback.js';
+import { type TronProviderOptions, type TronWebLike } from './tron.js';
+/**
+ * 可传给 Provider 的底层连接（也可以传数组，按顺序作为主节点 + 备用节点）：
+ * - RPC URL 字符串（Tron 链上是全节点 HTTP 地址）
+ * - ethers v6 Provider（JsonRpcProvider / BrowserProvider / FallbackProvider …）
+ * - 浏览器插件钱包注入的 EIP-1193 对象（window.ethereum、OKX、Rabby …），内部用 BrowserProvider 包装
+ * - Tron：TronProvider，或钱包注入的 tronWeb（TronLink / OKX …）
+ */
+export type ProviderSource = string | EthersLikeProvider | Eip1193Provider | TronWebLike;
+export interface SourceOptions {
+    /** 多节点故障切换参数；单节点时 timeout 也作为 URL 节点的请求超时 */
+    fallback?: FallbackOptions;
+    /** 用 URL 创建的 TronProvider 的参数（apiKey、minInterval 等） */
+    tron?: Omit<TronProviderOptions, 'fullHost' | 'request'>;
+}
+export declare function isTronChain(chainId: number): boolean;
+/** 链的默认节点：EVM 用内置公共节点表，Tron 主网用内置全节点列表 */
+export declare function getDefaultRpcUrls(chainId: number): readonly string[];
+export declare function resolveSource(chainId: number, source: ProviderSource | readonly ProviderSource[] | undefined, options?: SourceOptions): EthersLikeProvider;
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAA;AAE7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAEjE,OAAO,EAA+B,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAEnG;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,kBAAkB,GAAG,eAAe,GAAG,WAAW,CAAA;AAExF,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,uDAAuD;IACvD,IAAI,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,SAAS,CAAC,CAAA;CACzD;AAID,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAKpE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,EAC9D,OAAO,GAAE,aAAkB,GAC1B,kBAAkB,CAapB"}

package/dist/source.js

@@ -0,0 +1,56 @@
+import { BrowserProvider, FetchRequest, JsonRpcProvider } from 'ethers';
+import { FallbackRpc } from './fallback.js';
+import { DEFAULT_RPC_URLS, DEFAULT_TRON_HOSTS } from './rpcNodes.js';
+import { TRON_CHAIN_ID, TronProvider } from './tron.js';
+const TRON_CHAIN_IDS = new Set(Object.values(TRON_CHAIN_ID));
+export function isTronChain(chainId) {
+    return TRON_CHAIN_IDS.has(chainId);
+}
+/** 链的默认节点：EVM 用内置公共节点表，Tron 主网用内置全节点列表 */
+export function getDefaultRpcUrls(chainId) {
+    if (chainId === TRON_CHAIN_ID.mainnet) {
+        return DEFAULT_TRON_HOSTS;
+    }
+    return DEFAULT_RPC_URLS[chainId] ?? [];
+}
+export function resolveSource(chainId, source, options = {}) {
+    const list = source === undefined ? getDefaultRpcUrls(chainId) : Array.isArray(source) ? source : [source];
+    if (!list.length) {
+        throw new Error(source === undefined
+            ? `No default RPC for chain ${chainId}, please pass a provider or RPC URLs`
+            : 'Provider list is empty');
+    }
+    // 多节点时 Tron 节点不在单节点内重试 429，直接切到下一个节点
+    const multiple = list.length > 1;
+    const nodes = list.map((item) => toEthersLike(chainId, item, options, multiple));
+    return multiple ? new FallbackRpc(nodes, options.fallback) : nodes[0];
+}
+function toEthersLike(chainId, source, options, multiple) {
+    if (typeof source === 'string') {
+        if (isTronChain(chainId)) {
+            return new TronProvider({ retries: multiple ? 0 : undefined, ...options.tron, fullHost: source });
+        }
+        // 静态网络（不发 eth_chainId 探测）+ 单次请求超时
+        const request = new FetchRequest(source);
+        const timeout = options.fallback?.timeout ?? 10_000;
+        // timeout <= 0 表示不限制（与 FallbackRpc 一致）；FetchRequest 的 0 是立即超时，所以这里不设
+        if (timeout > 0 && Number.isFinite(timeout)) {
+            request.timeout = timeout;
+        }
+        return Number.isFinite(chainId)
+            ? new JsonRpcProvider(request, chainId, { staticNetwork: true })
+            : new JsonRpcProvider(request);
+    }
+    const value = source;
+    if (typeof value.call === 'function') {
+        return source;
+    }
+    if (value.fullNode && typeof value.fullNode.request === 'function') {
+        return TronProvider.fromTronWeb(source, options.tron);
+    }
+    if (typeof value.request === 'function') {
+        return new BrowserProvider(source);
+    }
+    throw new Error('Unsupported provider: expected an RPC URL, an ethers Provider, an EIP-1193 provider or a tronWeb instance');
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}

package/dist/tron.d.ts

@@ -0,0 +1,62 @@
+import { type TransactionRequest } from 'ethers';
+import type { EthersLikeProvider } from './aggregate.js';
+/** Tron 链 ID（与 TronGrid /jsonrpc 的 eth_chainId 一致） */
+export declare const TRON_CHAIN_ID: {
+    readonly mainnet: 728126428;
+    readonly shasta: 2494104990;
+    readonly nile: 3448148188;
+};
+export declare function isTronAddress(value: unknown): boolean;
+/** T 开头的 base58 地址 → 0x 开头的 20 字节地址（ABI 编码用）；已经是 0x 地址则原样返回 */
+export declare function toEvmAddress(address: string): string;
+/** 0x 地址 / 41 开头的 hex 地址 → T 开头的 base58 地址 */
+export declare function toTronAddress(address: string): string;
+/** 只用到 tronWeb 的这几个字段，兼容 tronweb v5/v6 及钱包注入的实例 */
+export interface TronWebLike {
+    fullNode: {
+        request: (url: string, payload: Record<string, unknown>, method: string) => Promise<any>;
+    };
+    defaultAddress?: {
+        base58?: string | false;
+    };
+}
+export type TronRequest = (path: string, body: Record<string, unknown>) => Promise<any>;
+export interface TronProviderOptions {
+    /** 全节点地址，默认 https://api.trongrid.io */
+    fullHost?: string;
+    /** TronGrid API Key（TRON-PRO-API-KEY） */
+    apiKey?: string;
+    headers?: Record<string, string>;
+    /**
+     * 自定义请求函数，可以接入已有的 tronWeb：
+     * `request: (path, body) => tronWeb.fullNode.request(path, body, 'post')`
+     */
+    request?: TronRequest;
+    /** 同时在途的最大请求数，避免触发 TronGrid 限频。默认 4 */
+    concurrency?: number;
+    /** 相邻两次请求发起的最小间隔（毫秒）。没有 API Key 时建议 200 左右。默认 0 */
+    minInterval?: number;
+    /** 遇到 HTTP 429 时的重试次数（指数退避，从 1s 开始）。默认 3 */
+    retries?: number;
+    /** 不传 from 时使用的调用者地址；传函数则每次调用时取值（钱包切换账号后自动跟随） */
+    defaultFrom?: string | (() => string | null | undefined);
+}
+/**
+ * 基于 Tron 全节点 HTTP API 的 Provider 适配器，实现 ethers Provider 的 `call` / `getBalance`，
+ * 可以直接传给 `new Provider(TRON_CHAIN_ID.mainnet, tronProvider)`。
+ *
+ * 不用 TronGrid 的 /jsonrpc 是因为它不支持合约创建调用（deployless）、不带 revert 数据、不支持 value。
+ * 注意：Tron HTTP API 只能查询最新状态，传历史 blockTag 会直接报错。
+ */
+export declare class TronProvider implements EthersLikeProvider {
+    #private;
+    constructor(options?: TronProviderOptions);
+    /**
+     * 复用浏览器钱包（TronLink / OKX 等）注入的 tronWeb：请求走钱包配置的节点，
+     * 默认以当前连接的钱包地址作为调用者（预执行时 msg.sender 即用户）。
+     */
+    static fromTronWeb(tronWeb: TronWebLike, options?: Omit<TronProviderOptions, 'request' | 'fullHost'>): TronProvider;
+    call(tx: TransactionRequest): Promise<string>;
+    getBalance(address: unknown, blockTag?: unknown): Promise<bigint>;
+}
+//# sourceMappingURL=tron.d.ts.map

package/dist/tron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron.d.ts","sourceRoot":"","sources":["../src/tron.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,kBAAkB,EACxB,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,sDAAsD;AACtD,eAAO,MAAM,aAAa;;;;CAIhB,CAAA;AAIV,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcpD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWrD;AAMD,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE;QAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;IACtG,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAA;CAC7C;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;AAEvF,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;CACzD;AAcD;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,kBAAkB;;gBAUzC,OAAO,GAAE,mBAAwB;IAuB7C;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,UAAU,CAAM,GAAG,YAAY;IAQjH,IAAI,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiD7C,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAmDxE"}

package/dist/tron.js

@@ -0,0 +1,223 @@
+import { decodeBase58, encodeBase58, getBytes, hexlify, makeError, sha256, toBeHex, toUtf8String, } from 'ethers';
+/** Tron 链 ID（与 TronGrid /jsonrpc 的 eth_chainId 一致） */
+export const TRON_CHAIN_ID = {
+    mainnet: 728126428,
+    shasta: 2494104990,
+    nile: 3448148188,
+};
+const TRON_ADDRESS_RE = /^T[1-9A-HJ-NP-Za-km-z]{33}$/;
+export function isTronAddress(value) {
+    return typeof value === 'string' && TRON_ADDRESS_RE.test(value);
+}
+/** T 开头的 base58 地址 → 0x 开头的 20 字节地址（ABI 编码用）；已经是 0x 地址则原样返回 */
+export function toEvmAddress(address) {
+    if (!isTronAddress(address)) {
+        if (/^41[0-9a-fA-F]{40}$/.test(address)) {
+            return `0x${address.slice(2)}`;
+        }
+        return address;
+    }
+    const bytes = getBytes(toBeHex(decodeBase58(address), 25));
+    const payload = bytes.slice(0, 21);
+    const checksum = getBytes(sha256(sha256(payload))).slice(0, 4);
+    if (bytes[0] !== 0x41 || hexlify(checksum) !== hexlify(bytes.slice(21))) {
+        throw new Error(`Invalid Tron address: ${address}`);
+    }
+    return hexlify(payload.slice(1));
+}
+/** 0x 地址 / 41 开头的 hex 地址 → T 开头的 base58 地址 */
+export function toTronAddress(address) {
+    if (isTronAddress(address)) {
+        return address;
+    }
+    const hex = address.replace(/^0x/i, '').replace(/^41(?=[0-9a-fA-F]{40}$)/, '');
+    if (!/^[0-9a-fA-F]{40}$/.test(hex)) {
+        throw new Error(`Invalid address: ${address}`);
+    }
+    const payload = getBytes(`0x41${hex}`);
+    const checksum = getBytes(sha256(sha256(payload))).slice(0, 4);
+    return encodeBase58(new Uint8Array([...payload, ...checksum]));
+}
+function toTronHex(address) {
+    return `41${toEvmAddress(address).slice(2).toLowerCase()}`;
+}
+class HttpError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+}
+// T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb，Tron 的零地址
+const ZERO_OWNER = '410000000000000000000000000000000000000000';
+/**
+ * 基于 Tron 全节点 HTTP API 的 Provider 适配器，实现 ethers Provider 的 `call` / `getBalance`，
+ * 可以直接传给 `new Provider(TRON_CHAIN_ID.mainnet, tronProvider)`。
+ *
+ * 不用 TronGrid 的 /jsonrpc 是因为它不支持合约创建调用（deployless）、不带 revert 数据、不支持 value。
+ * 注意：Tron HTTP API 只能查询最新状态，传历史 blockTag 会直接报错。
+ */
+export class TronProvider {
+    #request;
+    #concurrency;
+    #minInterval;
+    #retries;
+    #defaultFrom;
+    #active = 0;
+    #nextStart = 0;
+    #waiting = [];
+    constructor(options = {}) {
+        this.#concurrency = Math.max(1, options.concurrency ?? 4);
+        this.#minInterval = Math.max(0, options.minInterval ?? 0);
+        this.#retries = Math.max(0, options.retries ?? 3);
+        this.#defaultFrom = options.defaultFrom;
+        if (options.request) {
+            this.#request = options.request;
+        }
+        else {
+            const host = (options.fullHost ?? 'https://api.trongrid.io').replace(/\/+$/, '');
+            const headers = { 'content-type': 'application/json', ...options.headers };
+            if (options.apiKey) {
+                headers['TRON-PRO-API-KEY'] = options.apiKey;
+            }
+            this.#request = async (path, body) => {
+                const res = await fetch(`${host}/${path}`, { method: 'POST', headers, body: JSON.stringify(body) });
+                if (!res.ok) {
+                    throw new HttpError(`Tron request ${path} failed: HTTP ${res.status}`, res.status);
+                }
+                return res.json();
+            };
+        }
+    }
+    /**
+     * 复用浏览器钱包（TronLink / OKX 等）注入的 tronWeb：请求走钱包配置的节点，
+     * 默认以当前连接的钱包地址作为调用者（预执行时 msg.sender 即用户）。
+     */
+    static fromTronWeb(tronWeb, options = {}) {
+        return new TronProvider({
+            ...options,
+            defaultFrom: options.defaultFrom ?? (() => tronWeb.defaultAddress?.base58 || undefined),
+            request: (path, body) => tronWeb.fullNode.request(path, body, 'post'),
+        });
+    }
+    async call(tx) {
+        assertLatest(tx.blockTag);
+        const body = {
+            owner_address: tx.from ? toTronHex(String(tx.from)) : this.#getDefaultFrom(),
+            data: String(tx.data ?? '0x').replace(/^0x/, ''),
+        };
+        if (tx.to) {
+            body.contract_address = toTronHex(String(tx.to));
+        }
+        if (tx.value) {
+            body.call_value = Number(BigInt(tx.value));
+        }
+        const res = await this.#limit(() => this.#request('wallet/triggerconstantcontract', body));
+        const result = res?.result ?? {};
+        const message = typeof result.message === 'string' ? decodeMessage(result.message) : '';
+        if (result.code) {
+            // 地址上没有合约：与 EVM 节点一致返回 0x（multicall 地址无效时会据此退回 deployless）
+            if (result.code === 'CONTRACT_VALIDATE_ERROR' && /not exist/i.test(message)) {
+                return '0x';
+            }
+            // 其余 code（如 call_value 超过余额）是交易本身校验不通过，换节点也一样：
+            // 按执行错误抛出（isExecutionError 能识别），不触发 FallbackRpc 换节点，staticCall 得到 CallFailedError
+            throw makeError(`Tron call failed: ${result.code}${message ? ` ${message}` : ''}`, 'CALL_EXCEPTION', {
+                action: 'call',
+                data: null,
+                reason: message || null,
+                transaction: { to: tx.to ? String(tx.to) : null, from: tx.from ? String(tx.from) : undefined, data: String(tx.data ?? '0x') },
+                invocation: null,
+                revert: null,
+                info: { error: { code: result.code, message: `${result.code}: ${message}` } },
+            });
+        }
+        const output = `0x${res?.constant_result?.[0] ?? ''}`;
+        if (res?.transaction?.ret?.[0]?.ret === 'FAILED') {
+            throw makeError(message || 'execution reverted', 'CALL_EXCEPTION', {
+                action: 'call',
+                data: output,
+                reason: null,
+                transaction: { to: tx.to ? String(tx.to) : null, from: tx.from ? String(tx.from) : undefined, data: String(tx.data ?? '0x') },
+                invocation: null,
+                revert: null,
+            });
+        }
+        return output;
+    }
+    async getBalance(address, blockTag) {
+        assertLatest(blockTag);
+        const res = await this.#limit(() => this.#request('wallet/getaccount', { address: toTronHex(String(address)) }));
+        return BigInt(res?.balance ?? 0);
+    }
+    #getDefaultFrom() {
+        const from = typeof this.#defaultFrom === 'function' ? this.#defaultFrom() : this.#defaultFrom;
+        return from ? toTronHex(from) : ZERO_OWNER;
+    }
+    async #limit(task) {
+        if (this.#active >= this.#concurrency) {
+            // 名额由释放方直接转交（#active 不变），避免被唤醒前被新来的请求抢走而超出并发上限
+            await new Promise((resolve) => this.#waiting.push(resolve));
+        }
+        else {
+            this.#active++;
+        }
+        try {
+            for (let attempt = 0;; attempt++) {
+                await this.#throttle();
+                try {
+                    return await task();
+                }
+                catch (err) {
+                    if (attempt >= this.#retries || !isRateLimited(err)) {
+                        throw err;
+                    }
+                    await sleep(1000 * 2 ** attempt);
+                }
+            }
+        }
+        finally {
+            const next = this.#waiting.shift();
+            if (next) {
+                next();
+            }
+            else {
+                this.#active--;
+            }
+        }
+    }
+    async #throttle() {
+        if (!this.#minInterval) {
+            return;
+        }
+        const now = Date.now();
+        const start = Math.max(now, this.#nextStart);
+        this.#nextStart = start + this.#minInterval;
+        if (start > now) {
+            await sleep(start - now);
+        }
+    }
+}
+function assertLatest(blockTag) {
+    if (blockTag === undefined || blockTag === null || blockTag === 'latest' || blockTag === 'pending') {
+        return;
+    }
+    throw new Error(`Tron does not support calls at block ${String(blockTag)}`);
+}
+function isRateLimited(err) {
+    // fetch 实现抛 HttpError；tronWeb（axios）的错误带 response.status
+    const e = err;
+    return e?.status === 429 || e?.response?.status === 429;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function decodeMessage(hex) {
+    try {
+        return toUtf8String(`0x${hex}`);
+    }
+    catch {
+        return hex;
+    }
+}
+//# sourceMappingURL=tron.js.map

package/dist/tron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron.js","sourceRoot":"","sources":["../src/tron.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@w3lib/evm-batch-call",
+  "version": "0.1.0",
+  "description": "Batched EVM/Tron contract reads via Multicall3 with deployless fallback, native balances, RPC failover, auto-batching and staticCall simulation. ethcall compatible.",
+  "keywords": [
+    "ethers",
+    "ethereum",
+    "evm",
+    "multicall",
+    "multicall3",
+    "batch",
+    "ethcall"
+  ],
+  "license": "MIT",
+  "author": "L",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "contracts",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "ethers": "^6.17.0",
+    "solc": "0.8.30"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/web3-lib/libs.git",
+    "directory": "packages/evm-batch-call"
+  },
+  "homepage": "https://github.com/web3-lib/libs/tree/main/packages/evm-batch-call#readme",
+  "bugs": {
+    "url": "https://github.com/web3-lib/libs/issues"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:live": "LIVE=1 vitest run test/live.test.ts",
+    "build:contracts": "node scripts/build-contracts.mjs",
+    "check:rpc": "node scripts/check-rpc-nodes.mjs"
+  }
+}