ethers-rpc-pool 1.0.6 → 1.1.0

package/README.md

@@ -67,8 +67,14 @@ import { RPCPoolProvider } from 'ethers-rpc-pool';
 
 const poolProvider = new RPCPoolProvider({
   chainId: 1,
-  urls: ['http://rpc1.invalid', 'http://rpc2.invalid'],
-  perUrl: { inFlight: 1, timeout: 3000, rps: 2, rpsBurst: 5 },
+  rpc: [
+    { url: 'http://rpc1.example' },
+    { url: 'http://rpc2.example' },
+    { url: 'http://rpc3.example' },
+    { url: 'http://rpc4.example' },
+    { url: 'http://rpc5.example' },
+  ],
+  defaultRpcOptions: { inFlight: 1, timeout: 3000, rps: 2, rpsBurst: 5 },
   retry: { attempts: 2 },
 });
 
@@ -86,8 +92,18 @@ const balance = await poolProvider.getBalance('0x...');
 
 ```ts
 interface RPCPoolProviderParams {
-  chainId: number;
-  urls: string[];
+  network: number;
+  rpc: {
+    url: string;
+    timeout?: number;
+    rps?: number;
+    rpsBurst?: number;
+  }[];
+  defaultRpcOptions?: {
+    timeout?: number;
+    rps?: number;
+    rpsBurst?: number;
+  };
   perUrl: {
     inFlight: number;
   };
@@ -102,16 +118,16 @@ interface RPCPoolProviderParams {
 
 ### Options Explained
 
-| Option            | Description                                                                                                                          |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `chainId`         | Target chain ID                                                                                                                      |
-| `urls`            | List of RPC endpoints                                                                                                                |
-| `perUrl.inFlight` | Max concurrent requests per endpoint                                                                                                 |
-| `perUrl.timeout`  | Timeout in ms for each request to this URL, default 10s                                                                              |
-| `perUrl.rps`      | Maximum number of requests per second allowed for a single RPC endpoint. Enforced using a token bucket rate limiter.                 |
-| `perUrl.rpsBurst` | aximum burst capacity for the rate limiter. Allows short spikes above the sustained rate by accumulating tokens during idle periods. |
-| `retry.attempts`  | Maximum number of unique endpoints to try                                                                                            |
-| `hooks.onEvent`   | Optional instrumentation hook                                                                                                        |
+| Option                       | Description                                                                                                                           |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `network`                    | Target chain ID                                                                                                                       |
+| `rpc`                        | List of RPC endpoints                                                                                                                 |
+| `defaultRpcOptions.inFlight` | Max concurrent requests per endpoint                                                                                                  |
+| `defaultRpcOptions.timeout`  | Timeout in ms for each request to this URL, default 10s                                                                               |
+| `defaultRpcOptions.rps`      | Maximum number of requests per second allowed for a single RPC endpoint. Enforced using a token bucket rate limiter.                  |
+| `defaultRpcOptions.rpsBurst` | Maximum burst capacity for the rate limiter. Allows short spikes above the sustained rate by accumulating tokens during idle periods. |
+| `retry.attempts`             | Maximum number of unique endpoints to try                                                                                             |
+| `hooks.onEvent`              | Optional instrumentation hook                                                                                                         |
 
 ---
 
@@ -126,9 +142,7 @@ Requests are routed through an internal `Router`, which selects an available end
 Each endpoint has its own semaphore limiter:
 
 ```ts
-perUrl: {
-  inFlight: number;
-}
+inFlight: number;
 ```
 
 This prevents:

package/dist/index.cjs

@@ -142,20 +142,6 @@ function isTimeoutError(e) {
   const msg = String(e?.message || e);
   return /timeout|timed out|ETIMEDOUT|ESOCKETTIMEDOUT|ECONNABORTED|504 Gateway/i.test(msg);
 }
-function withTimeout(p, ms, meta) {
-  let t;
-  const timeout = new Promise((_, reject) => {
-    t = setTimeout(() => {
-      const err = new Error(
-        `RPC timeout after ${ms}ms` + (meta?.method ? ` method=${meta.method}` : "") + (meta?.providerId ? ` provider=${meta.providerId}` : "") + (meta?.chainId != null ? ` chainId=${meta.chainId}` : "")
-      );
-      err.code = "TIMEOUT";
-      err.timeout = ms;
-      reject(err);
-    }, ms);
-  });
-  return Promise.race([p, timeout]).finally(() => t && clearTimeout(t));
-}
 function shouldFailover(e) {
   const to = isTimeoutError(e);
   const rl = isRateLimitError(e);
@@ -244,29 +230,33 @@ var RpsLimiter = class {
 };
 
 // src/InstrumentedProvider.ts
-var InstrumentedStaticJsonRpcProvider = class extends import_ethers.JsonRpcProvider {
+var InstrumentedJsonRpcProvider = class extends import_ethers.JsonRpcProvider {
   providerId;
   chainId;
-  params;
+  options;
   inFlightLimiter;
   rpsLimiter;
   stats;
   fetchRequest;
   lastCooldownMs = 0;
-  constructor(params) {
-    const { url, providerId, chainId } = params;
-    const network = import_ethers.Network.from(chainId);
-    const fetchRequest = new import_ethers.FetchRequest(url);
-    fetchRequest.timeout = params.timeout || 1e4;
-    super(fetchRequest, chainId, { staticNetwork: network });
+  constructor(url, network, options) {
+    let fetchRequest;
+    if (typeof url == "string") {
+      fetchRequest = new import_ethers.FetchRequest(url);
+    } else {
+      fetchRequest = url;
+    }
+    fetchRequest.timeout = options.timeout || 1e4;
+    const _network = import_ethers.Network.from(network);
+    super(fetchRequest, _network, { staticNetwork: true, ...options });
     this.fetchRequest = fetchRequest;
-    this.providerId = providerId;
-    this.chainId = chainId;
-    this.params = params;
-    const { rps = 10, rpsBurst, inFlight = 1 } = params;
+    this.providerId = options.providerId;
+    this.chainId = _network.chainId;
+    this.options = options;
+    const { rps = 10, rpsBurst, inFlight = 1 } = options;
     this.inFlightLimiter = new Semaphore(inFlight);
     this.rpsLimiter = new RpsLimiter(rps, rpsBurst || rps);
-    this.stats = params.stats;
+    this.stats = options.stats;
   }
   async _send(payload) {
     await this.rpsLimiter.take(1);
@@ -286,7 +276,7 @@ var InstrumentedStaticJsonRpcProvider = class extends import_ethers.JsonRpcProvi
     this.stats.bumpProviderTotal(this.providerId);
     for (const p of payloads) {
       this.stats.bumpPerMethod(p.method);
-      this.params.onEvent?.({
+      this.options.onEvent?.({
         type: "request",
         chainId: this.chainId,
         providerId: this.providerId,
@@ -295,14 +285,10 @@ var InstrumentedStaticJsonRpcProvider = class extends import_ethers.JsonRpcProvi
       });
     }
     try {
-      const base = super._send(payload);
-      const res = await withTimeout(base, this.params.timeout || 1e4, {
-        chainId: this.chainId,
-        providerId: this.providerId
-      });
+      const res = await super._send(payload);
       const endedAt = Date.now();
       for (const p of payloads) {
-        this.params.onEvent?.({
+        this.options.onEvent?.({
           type: "response",
           chainId: this.chainId,
           providerId: this.providerId,
@@ -343,7 +329,7 @@ var InstrumentedStaticJsonRpcProvider = class extends import_ethers.JsonRpcProvi
         this.stats.setCooldown(this.providerId, cooldownMs);
       }
       for (const p of payloads) {
-        this.params.onEvent?.({
+        this.options.onEvent?.({
           type: "error",
           chainId: this.chainId,
           providerId: this.providerId,
@@ -392,22 +378,18 @@ var RPCPoolProvider = class extends import_ethers2.JsonRpcProvider {
   params;
   stats;
   constructor(params) {
-    const network = import_ethers2.Network.from(params.chainId);
+    const network = import_ethers2.Network.from(params.network);
     super("http://localhost", network, { staticNetwork: network });
     this.params = params;
     this.stats = new Stats();
-    const endpoints = this.params.urls.map((url, i) => {
-      const providerId = `rpc#${i + 1}-chainId:${this.params.chainId}-${url}`;
-      const { inFlight = 1, rps = 1, rpsBurst, timeout = 1e4 } = this.params.perUrl;
-      const provider = new InstrumentedStaticJsonRpcProvider({
-        url,
-        chainId: this.params.chainId,
+    const endpoints = this.params.rpc.map((options, i) => {
+      const url = typeof options.url === "string" ? options.url : options.url.url;
+      const providerId = `rpc#${i + 1}-chainId:${this.params.network}-${url}`;
+      const provider = new InstrumentedJsonRpcProvider(options.url, this.params.network, {
         providerId,
         stats: this.stats,
-        inFlight,
-        rps,
-        rpsBurst,
-        timeout,
+        ...this.params.defaultRpcOptions,
+        ...options,
         onEvent: this.params.hooks?.onEvent
       });
       return { providerId, url, provider };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/RpcPoolProvider.ts","../src/Stats.ts","../src/utils.ts","../src/InstrumentedProvider.ts","../src/Semaphore.ts","../src/RpsLimiter.ts","../src/Router.ts"],"sourcesContent":["export { RPCPoolProvider, RPCPoolProviderParams } from './RpcPoolProvider';\nexport type { RpcEvent } from './utils';\nexport type { RpcStatsSnapshot } from './Stats';\n","import { JsonRpcProvider, Network } from 'ethers';\nimport { Stats } from './Stats';\nimport { Endpoint, RpcEvent, shouldFailover } from './utils';\nimport { InstrumentedStaticJsonRpcProvider } from './InstrumentedProvider';\nimport { Router } from './Router';\n\nexport interface RPCPoolProviderParams {\n  chainId: number;\n  urls: string[];\n  perUrl: { inFlight: number; timeout?: number; rps?: number; rpsBurst?: number };\n  retry: { attempts: number };\n  hooks?: {\n    onEvent(e: RpcEvent): void;\n  };\n}\n\n// TODO\n// -- circuit breaker + health checks\n// -- sticky “session”\n\nexport class RPCPoolProvider extends JsonRpcProvider {\n  readonly router: Router;\n  readonly params: RPCPoolProviderParams;\n  readonly stats: Stats;\n\n  constructor(params: RPCPoolProviderParams) {\n    const network = Network.from(params.chainId);\n    super('http://localhost', network, { staticNetwork: network });\n\n    this.params = params;\n\n    this.stats = new Stats();\n\n    const endpoints: Endpoint[] = this.params.urls.map((url, i) => {\n      const providerId = `rpc#${i + 1}-chainId:${this.params.chainId}-${url}`;\n\n      const { inFlight = 1, rps = 1, rpsBurst, timeout = 10_000 } = this.params.perUrl;\n\n      const provider = new InstrumentedStaticJsonRpcProvider({\n        url,\n        chainId: this.params.chainId,\n        providerId,\n        stats: this.stats,\n        inFlight,\n        rps,\n        rpsBurst,\n        timeout,\n        onEvent: this.params.hooks?.onEvent,\n      });\n\n      return { providerId, url, provider };\n    });\n\n    this.router = new Router(endpoints, this.stats);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async send(method: string, params: any): Promise<any> {\n    const tried = new Set<string>();\n    const maxUniqueTries = Math.min(this.params.retry.attempts, this.router.size());\n\n    while (tried.size < maxUniqueTries) {\n      const ep = this.router.pick();\n      if (tried.has(ep.providerId)) continue;\n      tried.add(ep.providerId);\n\n      try {\n        return await ep.provider.send(method, params);\n      } catch (e: any) {\n        if (!shouldFailover(e)) throw e;\n        if (tried.size >= maxUniqueTries) throw e;\n\n        // Add exponential backoff with jitter before retry\n        const baseDelay = Math.min(1000 * Math.pow(2, tried.size - 1), 5000);\n        const jitter = Math.random() * baseDelay;\n        await new Promise((resolve) => setTimeout(resolve, jitter));\n      }\n    }\n\n    throw new Error('No RPC available');\n  }\n\n  getStats(): Stats {\n    return this.stats;\n  }\n}\n","export interface RpcStatsSnapshot {\n  total: number;\n  inFlight: number;\n  perMethodTotal: Record<string, number>;\n  rateLimitedTotal: number;\n  perProviderRateLimited: Record<string, number>;\n  timeoutTotal: number;\n  perProviderTimeout: Record<string, number>;\n  perProviderTotal: Record<string, number>;\n  providerCooldownUntil: Record<string, number>;\n  perProviderInFlight: Record<string, number>;\n  perProviderError: Record<string, number>;\n}\n\nexport class Stats {\n  private _total = 0;\n  private _inFlight = 0;\n\n  private _perMethod: Record<string, number> = {};\n\n  private _rateLimitedTotal = 0;\n  private _timeoutTotal = 0;\n\n  private _perProviderInFlight: Record<string, number> = {};\n  private _perProviderTotal: Record<string, number> = {};\n  private _perProviderTimeout: Record<string, number> = {};\n  private _perProviderRateLimited: Record<string, number> = {};\n  private _perProviderError: Record<string, number> = {};\n\n  private _providerCooldownUntil: Record<string, number> = {};\n\n  private _bump(map: Record<string, number>, key: string) {\n    map[key] = (map[key] || 0) + 1;\n  }\n\n  private _decrease(map: Record<string, number>, key: string) {\n    map[key] = Math.max((map[key] || 0) - 1, 0);\n  }\n\n  private _bumpTotal() {\n    this._total++;\n  }\n\n  private _bumpInFlight() {\n    this._inFlight++;\n  }\n\n  private _bumpRateLimitedTotal() {\n    this._rateLimitedTotal++;\n  }\n\n  private _bumpTimeoutTotal() {\n    this._timeoutTotal++;\n  }\n\n  bumpInFlightPerProvider(id: string) {\n    this._bumpInFlight();\n    this._bump(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlightPerProvider(id: string) {\n    this.decreaseInFlight();\n    this._decrease(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlight() {\n    this._inFlight = Math.max(this._inFlight - 1, 0);\n  }\n\n  bumpPerMethod(method: string) {\n    this._bump(this._perMethod, method);\n  }\n\n  bumpRateLimitedPerProvider(id: string) {\n    this._bumpRateLimitedTotal();\n    this._bump(this._perProviderRateLimited, id);\n  }\n\n  bumpTimeoutPerProvider(id: string) {\n    this._bumpTimeoutTotal();\n    this._bump(this._perProviderTimeout, id);\n  }\n\n  bumpProviderTotal(id: string) {\n    this._bumpTotal();\n    this._perProviderTotal[id] = (this._perProviderTotal[id] || 0) + 1;\n  }\n  bumpServerErrorPerProvider(id: string) {\n    this._bump(this._perProviderError, id);\n  }\n\n  timeoutRatio(id: string) {\n    const t = this._perProviderTimeout[id] || 0;\n    const n = this._perProviderTotal[id] || 0;\n    return n ? t / n : 0;\n  }\n\n  isInCooldown(id: string) {\n    return (this._providerCooldownUntil[id] || 0) > Date.now();\n  }\n\n  setCooldown(id: string, ms: number) {\n    this._providerCooldownUntil[id] = Date.now() + ms;\n  }\n\n  snapshot(): Readonly<RpcStatsSnapshot> {\n    return {\n      total: this._total,\n      inFlight: this._inFlight,\n      perMethodTotal: { ...this._perMethod },\n      rateLimitedTotal: this._rateLimitedTotal,\n      timeoutTotal: this._timeoutTotal,\n      perProviderInFlight: { ...this._perProviderInFlight },\n      perProviderRateLimited: { ...this._perProviderRateLimited },\n      perProviderTimeout: { ...this._perProviderTimeout },\n      perProviderError: { ...this._perProviderError },\n      perProviderTotal: { ...this._perProviderTotal },\n      providerCooldownUntil: { ...this._providerCooldownUntil },\n    };\n  }\n}\n","import { InstrumentedStaticJsonRpcProvider } from './InstrumentedProvider';\n\nexport interface Endpoint {\n  providerId: string;\n  url: string;\n  provider: InstrumentedStaticJsonRpcProvider;\n}\n\nexport type RpcEvent =\n  | {\n      type: 'request';\n      chainId: number;\n      providerId: string;\n      method: string;\n      startedAt: number;\n    }\n  | {\n      type: 'response';\n      chainId: number;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n    }\n  | {\n      type: 'error';\n      chainId: number;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n      isRateLimit: boolean;\n      isTimeout: boolean;\n      status?: number;\n      code?: string;\n      message: string;\n    };\n\nexport function getHttpStatus(e: any): number | undefined {\n  return (\n    e?.status ??\n    e?.response?.status ??\n    e?.response?.statusCode ??\n    e?.error?.status ??\n    e?.error?.response?.status ??\n    e?.body?.statusCode // sometimes present\n  );\n}\n\nexport function isRateLimitError(e: any): boolean {\n  const status = getHttpStatus(e);\n  if (status === 429 || status === 402) return true;\n\n  const msg = String(e?.message || e);\n  if (/error code:\\s*1015/i.test(msg)) return true; // Cloudflare\n  return /rate limit|too many requests|429|quota|throttl/i.test(msg);\n}\n\nexport function isServerError(e: any): boolean {\n  const status = getHttpStatus(e);\n  return status !== undefined && status >= 500;\n}\n\nexport function getRetryAfterMs(e: any): number | null {\n  const ra =\n    e?.response?.headers?.get?.('retry-after') ??\n    e?.response?.headers?.['retry-after'] ??\n    e?.headers?.['retry-after'];\n  const n = Number(ra);\n  return Number.isFinite(n) ? n * 1000 : null;\n}\n\nexport function isTimeoutError(e: any): boolean {\n  // ethers v5\n  if (e?.code === 'TIMEOUT') return true;\n\n  const status = getHttpStatus(e);\n  // some RPCs / proxies return 504 on timeout\n  if (status === 504) return true;\n\n  const msg = String(e?.message || e);\n\n  // node-fetch / undici / axios / nginx / generic\n  return /timeout|timed out|ETIMEDOUT|ESOCKETTIMEDOUT|ECONNABORTED|504 Gateway/i.test(msg);\n}\n\n/**\n * Wraps a promise with a timeout (useful when an RPC hangs without emitting TIMEOUT).\n * Important: this does not cancel the network request, but you get a controlled error\n * and FallbackProvider can switch to another RPC.\n */\nexport function withTimeout<T>(\n  p: Promise<T>,\n  ms: number,\n  meta?: { chainId?: number; providerId?: string; method?: string },\n): Promise<T> {\n  let t: NodeJS.Timeout | undefined;\n\n  const timeout = new Promise<T>((_, reject) => {\n    t = setTimeout(() => {\n      const err: any = new Error(\n        `RPC timeout after ${ms}ms` +\n          (meta?.method ? ` method=${meta.method}` : '') +\n          (meta?.providerId ? ` provider=${meta.providerId}` : '') +\n          (meta?.chainId != null ? ` chainId=${meta.chainId}` : ''),\n      );\n      err.code = 'TIMEOUT';\n      err.timeout = ms;\n      reject(err);\n    }, ms);\n  });\n\n  return Promise.race([p, timeout]).finally(() => t && clearTimeout(t));\n}\n\nexport function shouldFailover(e: any): boolean {\n  const to = isTimeoutError(e);\n  const rl = isRateLimitError(e);\n  const se = isServerError(e);\n\n  // failover on timeouts and rate limits, but not on logical errors (e.g. invalid params)\n  return to || rl || se;\n}\n","import { JsonRpcProvider, Network, JsonRpcPayload, FetchRequest } from 'ethers';\nimport { Semaphore } from './Semaphore';\nimport { Stats } from './Stats';\nimport {\n  getHttpStatus,\n  getRetryAfterMs,\n  isRateLimitError,\n  isServerError,\n  isTimeoutError,\n  RpcEvent,\n  withTimeout,\n} from './utils';\nimport { RpsLimiter } from './RpsLimiter';\n\ninterface ProviderParams {\n  url: string;\n  chainId: number;\n  providerId: string;\n  stats: Stats;\n  inFlight?: number;\n  timeout?: number;\n  rps?: number;\n  rpsBurst?: number;\n  onEvent?: (e: RpcEvent) => void;\n}\n/**\n * Instrumented StaticJsonRpcProvider.\n * Tracks requests, inFlight count, rate limits, and per-method / per-provider metrics.\n */\nexport class InstrumentedStaticJsonRpcProvider extends JsonRpcProvider {\n  readonly providerId: string;\n  readonly chainId: number;\n  readonly params: ProviderParams;\n\n  readonly inFlightLimiter: Semaphore;\n  readonly rpsLimiter: RpsLimiter;\n  readonly stats: Stats;\n  readonly fetchRequest: FetchRequest;\n\n  private lastCooldownMs: number = 0;\n\n  constructor(params: ProviderParams) {\n    const { url, providerId, chainId } = params;\n\n    const network = Network.from(chainId);\n    const fetchRequest = new FetchRequest(url);\n\n    fetchRequest.timeout = params.timeout || 10_000;\n\n    super(fetchRequest, chainId, { staticNetwork: network });\n    this.fetchRequest = fetchRequest;\n    this.providerId = providerId;\n    this.chainId = chainId;\n    this.params = params;\n\n    const { rps = 10, rpsBurst, inFlight = 1 } = params;\n\n    this.inFlightLimiter = new Semaphore(inFlight);\n    this.rpsLimiter = new RpsLimiter(rps, rpsBurst || rps);\n    this.stats = params.stats;\n  }\n\n  override async _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    await this.rpsLimiter.take(1);\n\n    const release = this.inFlightLimiter ? await this.inFlightLimiter.acquire() : undefined;\n\n    try {\n      return await this._sendInstrumented(payload);\n    } finally {\n      release?.();\n    }\n  }\n\n  // ethers v5 calls send(method, params)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private async _sendInstrumented(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    const startedAt = Date.now();\n    const payloads = Array.isArray(payload) ? payload : [payload];\n\n    this.stats.bumpInFlightPerProvider(this.providerId);\n    this.stats.bumpProviderTotal(this.providerId);\n\n    for (const p of payloads) {\n      this.stats.bumpPerMethod(p.method);\n      this.params.onEvent?.({\n        type: 'request',\n        chainId: this.chainId,\n        providerId: this.providerId,\n        method: p.method,\n        startedAt,\n      });\n    }\n\n    try {\n      const base = super._send(payload);\n      const res = await withTimeout(base, this.params.timeout || 10_000, {\n        chainId: this.chainId,\n        providerId: this.providerId,\n      });\n\n      const endedAt = Date.now();\n\n      for (const p of payloads) {\n        this.params.onEvent?.({\n          type: 'response',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n        });\n      }\n\n      this.lastCooldownMs = 0;\n\n      return res;\n    } catch (e: any) {\n      const endedAt = Date.now();\n      const rl = isRateLimitError(e);\n      if (rl) {\n        this.stats.bumpRateLimitedPerProvider(this.providerId);\n        const cooldownMs = 10_000;\n        const raMs = getRetryAfterMs(e) ?? cooldownMs;\n        this.stats.setCooldown(this.providerId, raMs);\n      }\n\n      const isTimeout = isTimeoutError(e);\n      if (isTimeout && !rl) {\n        this.stats.bumpTimeoutPerProvider(this.providerId);\n\n        const n = this.stats.snapshot().perProviderTotal[this.providerId] || 0;\n        const ratio = this.stats.timeoutRatio(this.providerId);\n\n        // thresholds: do not ban on a single timeout, only after enough data\n        if (n >= 50 && ratio >= 0.2) {\n          const cooldownMs = ratio >= 0.5 ? 600_000 : 60_000;\n          const raMs = getRetryAfterMs(e) ?? cooldownMs;\n          this.lastCooldownMs = raMs;\n          this.stats.setCooldown(this.providerId, raMs + Math.floor(Math.random() * 1000));\n        }\n      }\n\n      const isError = isServerError(e);\n      if (isError && !rl && !isTimeout) {\n        this.stats.bumpServerErrorPerProvider(this.providerId);\n        const cooldownMs = (this.lastCooldownMs * 2 || 10_000) + Math.floor(Math.random() * 1000);\n        this.lastCooldownMs = cooldownMs;\n        this.stats.setCooldown(this.providerId, cooldownMs);\n      }\n\n      for (const p of payloads) {\n        this.params.onEvent?.({\n          type: 'error',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n          isRateLimit: rl,\n          isTimeout: isTimeout,\n          status: getHttpStatus(e),\n          code: e?.code,\n          message: String(e?.message || e),\n        });\n      }\n\n      throw e;\n    } finally {\n      this.stats.decreaseInFlightPerProvider(this.providerId);\n    }\n  }\n}\n","export class Semaphore {\n  private inUse = 0;\n  private queue: Array<() => void> = [];\n\n  constructor(private readonly max: number) {\n    if (!Number.isFinite(max) || max <= 0) {\n      throw new Error(`Semaphore max must be a positive number, got: ${max}`);\n    }\n  }\n\n  async acquire(): Promise<() => void> {\n    if (this.inUse < this.max) {\n      this.inUse++;\n      let released = false;\n      return () => {\n        if (released) return;\n        released = true;\n        this.release();\n      };\n    }\n\n    return new Promise<() => void>((resolve) => {\n      this.queue.push(() => {\n        this.inUse++;\n        let released = false;\n        resolve(() => {\n          if (released) return;\n          released = true;\n          this.release();\n        });\n      });\n    });\n  }\n\n  private release() {\n    this.inUse = Math.max(0, this.inUse - 1);\n    const next = this.queue.shift();\n    if (next) next();\n  }\n}\n","export class RpsLimiter {\n  // Current number of tokens in the bucket (can be fractional)\n  private tokens: number;\n\n  // Time of last token refill, in ms\n  private lastRefill = Date.now();\n\n  constructor(\n    // rps: how many tokens we add per second\n    private readonly rps: number,\n    // burst: maximum bucket capacity.\n    // Default: >=1 and approximately equal to rps (to allow a small burst)\n    private readonly burst: number = Math.max(1, Math.ceil(rps)),\n  ) {\n    // At start, the bucket is full: can make burst requests immediately\n    this.tokens = burst;\n  }\n\n  // Refill tokens according to elapsed time\n  private refill(now: number) {\n    // rps<=0 means \"limit is disabled\"\n    if (this.rps <= 0) return;\n\n    const elapsed = now - this.lastRefill; // ms since last refill\n    if (elapsed <= 0) return;\n\n    // How many tokens to add:\n    // elapsed/1000 = seconds, multiply by rps\n    const add = (elapsed / 1000) * this.rps;\n\n    // Add tokens, but don't exceed burst (bucket capacity)\n    this.tokens = Math.min(this.burst, this.tokens + add);\n\n    // Remember that we refilled tokens at time now\n    this.lastRefill = now;\n  }\n\n  // Take count tokens (usually 1 request = 1 token).\n  // If not enough tokens — wait and try again.\n  async take(count = 1): Promise<void> {\n    if (!this.rps || this.rps <= 0) return;\n\n    while (true) {\n      const now = Date.now();\n\n      // Before attempting — refill tokens\n      this.refill(now);\n\n      // If enough tokens — \"pay\" for the request and exit\n      if (this.tokens >= count) {\n        this.tokens -= count;\n        return;\n      }\n\n      // Not enough tokens: calculate how long to wait\n      const need = count - this.tokens;\n\n      // How many ms needed to accumulate need tokens:\n      // need / rps = seconds, *1000 = ms\n      const waitMs = Math.ceil((need / this.rps) * 1000);\n\n      // Wait in chunks (not all waitMs at once), to:\n      // - not sleep too long if time/state changed\n      // - be more resilient to timer drift\n      await new Promise((r) => setTimeout(r, Math.min(waitMs, 50)));\n    }\n  }\n}\n","import { Endpoint } from './utils';\nimport { Stats } from './Stats';\n\nexport class Router {\n  private rr = 0;\n\n  constructor(\n    private readonly endpoints: Endpoint[],\n    private readonly stats: Stats,\n  ) {}\n\n  size(): number {\n    return this.endpoints.length;\n  }\n\n  pick(): Endpoint {\n    const n = this.endpoints.length;\n    for (let k = 0; k < n; k++) {\n      const i = ((this.rr++ % n) + n) % n;\n      const ep = this.endpoints[i];\n\n      if (!this.stats.isInCooldown(ep.providerId)) return ep;\n    }\n    // if all are in cooldown, return the next one in round-robin order\n    return this.endpoints[((this.rr++ % n) + n) % n];\n  }\n}\n"],"mappings":"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","names":["import_ethers"]}
+{"version":3,"sources":["../src/index.ts","../src/RpcPoolProvider.ts","../src/Stats.ts","../src/utils.ts","../src/InstrumentedProvider.ts","../src/Semaphore.ts","../src/RpsLimiter.ts","../src/Router.ts"],"sourcesContent":["export { RPCPoolProvider, RPCPoolProviderParams } from './RpcPoolProvider';\nexport type { RpcEvent } from './utils';\nexport type { RpcStatsSnapshot } from './Stats';\n","import { FetchRequest, JsonRpcProvider, Network, Networkish } from 'ethers';\nimport { Stats } from './Stats';\nimport { Endpoint, RpcEvent, shouldFailover } from './utils';\nimport {\n  InstrumentedJsonRpcProvider,\n  InstrumentedJsonRpcProviderOptions,\n} from './InstrumentedProvider';\nimport { Router } from './Router';\n\ninterface RPCPoolProviderOptions extends Partial<InstrumentedJsonRpcProviderOptions> {\n  url: string | FetchRequest;\n  network?: Networkish;\n}\n\nexport interface RPCPoolProviderParams {\n  network: Networkish;\n  rpc: RPCPoolProviderOptions[];\n  defaultRpcOptions: { inFlight: number; timeout?: number; rps?: number; rpsBurst?: number };\n  retry: { attempts: number };\n  hooks?: {\n    onEvent(e: RpcEvent): void;\n  };\n}\n\n// TODO\n// -- circuit breaker + health checks\n// -- sticky “session”\n\nexport class RPCPoolProvider extends JsonRpcProvider {\n  readonly router: Router;\n  readonly params: RPCPoolProviderParams;\n  readonly stats: Stats;\n\n  constructor(params: RPCPoolProviderParams) {\n    const network = Network.from(params.network);\n    super('http://localhost', network, { staticNetwork: network });\n\n    this.params = params;\n\n    this.stats = new Stats();\n\n    const endpoints: Endpoint[] = this.params.rpc.map((options, i) => {\n      const url = typeof options.url === 'string' ? options.url : options.url.url;\n      const providerId = `rpc#${i + 1}-chainId:${this.params.network}-${url}`;\n\n      const provider = new InstrumentedJsonRpcProvider(options.url, this.params.network, {\n        providerId,\n        stats: this.stats,\n        ...this.params.defaultRpcOptions,\n        ...options,\n        onEvent: this.params.hooks?.onEvent,\n      });\n\n      return { providerId, url, provider };\n    });\n\n    this.router = new Router(endpoints, this.stats);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async send(method: string, params: any): Promise<any> {\n    const tried = new Set<string>();\n    const maxUniqueTries = Math.min(this.params.retry.attempts, this.router.size());\n\n    while (tried.size < maxUniqueTries) {\n      const ep = this.router.pick();\n      if (tried.has(ep.providerId)) continue;\n      tried.add(ep.providerId);\n\n      try {\n        return await ep.provider.send(method, params);\n      } catch (e: any) {\n        if (!shouldFailover(e)) throw e;\n        if (tried.size >= maxUniqueTries) throw e;\n\n        // Add exponential backoff with jitter before retry\n        const baseDelay = Math.min(1000 * Math.pow(2, tried.size - 1), 5000);\n        const jitter = Math.random() * baseDelay;\n        await new Promise((resolve) => setTimeout(resolve, jitter));\n      }\n    }\n\n    throw new Error('No RPC available');\n  }\n\n  getStats(): Stats {\n    return this.stats;\n  }\n}\n","export interface RpcStatsSnapshot {\n  total: number;\n  inFlight: number;\n  perMethodTotal: Record<string, number>;\n  rateLimitedTotal: number;\n  perProviderRateLimited: Record<string, number>;\n  timeoutTotal: number;\n  perProviderTimeout: Record<string, number>;\n  perProviderTotal: Record<string, number>;\n  providerCooldownUntil: Record<string, number>;\n  perProviderInFlight: Record<string, number>;\n  perProviderError: Record<string, number>;\n}\n\nexport class Stats {\n  private _total = 0;\n  private _inFlight = 0;\n\n  private _perMethod: Record<string, number> = {};\n\n  private _rateLimitedTotal = 0;\n  private _timeoutTotal = 0;\n\n  private _perProviderInFlight: Record<string, number> = {};\n  private _perProviderTotal: Record<string, number> = {};\n  private _perProviderTimeout: Record<string, number> = {};\n  private _perProviderRateLimited: Record<string, number> = {};\n  private _perProviderError: Record<string, number> = {};\n\n  private _providerCooldownUntil: Record<string, number> = {};\n\n  private _bump(map: Record<string, number>, key: string) {\n    map[key] = (map[key] || 0) + 1;\n  }\n\n  private _decrease(map: Record<string, number>, key: string) {\n    map[key] = Math.max((map[key] || 0) - 1, 0);\n  }\n\n  private _bumpTotal() {\n    this._total++;\n  }\n\n  private _bumpInFlight() {\n    this._inFlight++;\n  }\n\n  private _bumpRateLimitedTotal() {\n    this._rateLimitedTotal++;\n  }\n\n  private _bumpTimeoutTotal() {\n    this._timeoutTotal++;\n  }\n\n  bumpInFlightPerProvider(id: string) {\n    this._bumpInFlight();\n    this._bump(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlightPerProvider(id: string) {\n    this.decreaseInFlight();\n    this._decrease(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlight() {\n    this._inFlight = Math.max(this._inFlight - 1, 0);\n  }\n\n  bumpPerMethod(method: string) {\n    this._bump(this._perMethod, method);\n  }\n\n  bumpRateLimitedPerProvider(id: string) {\n    this._bumpRateLimitedTotal();\n    this._bump(this._perProviderRateLimited, id);\n  }\n\n  bumpTimeoutPerProvider(id: string) {\n    this._bumpTimeoutTotal();\n    this._bump(this._perProviderTimeout, id);\n  }\n\n  bumpProviderTotal(id: string) {\n    this._bumpTotal();\n    this._perProviderTotal[id] = (this._perProviderTotal[id] || 0) + 1;\n  }\n  bumpServerErrorPerProvider(id: string) {\n    this._bump(this._perProviderError, id);\n  }\n\n  timeoutRatio(id: string) {\n    const t = this._perProviderTimeout[id] || 0;\n    const n = this._perProviderTotal[id] || 0;\n    return n ? t / n : 0;\n  }\n\n  isInCooldown(id: string) {\n    return (this._providerCooldownUntil[id] || 0) > Date.now();\n  }\n\n  setCooldown(id: string, ms: number) {\n    this._providerCooldownUntil[id] = Date.now() + ms;\n  }\n\n  snapshot(): Readonly<RpcStatsSnapshot> {\n    return {\n      total: this._total,\n      inFlight: this._inFlight,\n      perMethodTotal: { ...this._perMethod },\n      rateLimitedTotal: this._rateLimitedTotal,\n      timeoutTotal: this._timeoutTotal,\n      perProviderInFlight: { ...this._perProviderInFlight },\n      perProviderRateLimited: { ...this._perProviderRateLimited },\n      perProviderTimeout: { ...this._perProviderTimeout },\n      perProviderError: { ...this._perProviderError },\n      perProviderTotal: { ...this._perProviderTotal },\n      providerCooldownUntil: { ...this._providerCooldownUntil },\n    };\n  }\n}\n","import { InstrumentedJsonRpcProvider } from './InstrumentedProvider';\n\nexport interface Endpoint {\n  providerId: string;\n  url: string;\n  provider: InstrumentedJsonRpcProvider;\n}\n\nexport type RpcEvent =\n  | {\n      type: 'request';\n      chainId: bigint;\n      providerId: string;\n      method: string;\n      startedAt: number;\n    }\n  | {\n      type: 'response';\n      chainId: bigint;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n    }\n  | {\n      type: 'error';\n      chainId: bigint;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n      isRateLimit: boolean;\n      isTimeout: boolean;\n      status?: number;\n      code?: string;\n      message: string;\n    };\n\nexport function getHttpStatus(e: any): number | undefined {\n  return (\n    e?.status ??\n    e?.response?.status ??\n    e?.response?.statusCode ??\n    e?.error?.status ??\n    e?.error?.response?.status ??\n    e?.body?.statusCode // sometimes present\n  );\n}\n\nexport function isRateLimitError(e: any): boolean {\n  const status = getHttpStatus(e);\n  if (status === 429 || status === 402) return true;\n\n  const msg = String(e?.message || e);\n  if (/error code:\\s*1015/i.test(msg)) return true; // Cloudflare\n  return /rate limit|too many requests|429|quota|throttl/i.test(msg);\n}\n\nexport function isServerError(e: any): boolean {\n  const status = getHttpStatus(e);\n  return status !== undefined && status >= 500;\n}\n\nexport function getRetryAfterMs(e: any): number | null {\n  const ra =\n    e?.response?.headers?.get?.('retry-after') ??\n    e?.response?.headers?.['retry-after'] ??\n    e?.headers?.['retry-after'];\n  const n = Number(ra);\n  return Number.isFinite(n) ? n * 1000 : null;\n}\n\nexport function isTimeoutError(e: any): boolean {\n  // ethers v5\n  if (e?.code === 'TIMEOUT') return true;\n\n  const status = getHttpStatus(e);\n  // some RPCs / proxies return 504 on timeout\n  if (status === 504) return true;\n\n  const msg = String(e?.message || e);\n\n  // node-fetch / undici / axios / nginx / generic\n  return /timeout|timed out|ETIMEDOUT|ESOCKETTIMEDOUT|ECONNABORTED|504 Gateway/i.test(msg);\n}\n\nexport function shouldFailover(e: any): boolean {\n  const to = isTimeoutError(e);\n  const rl = isRateLimitError(e);\n  const se = isServerError(e);\n\n  // failover on timeouts and rate limits, but not on logical errors (e.g. invalid params)\n  return to || rl || se;\n}\n","import {\n  JsonRpcProvider,\n  Network,\n  JsonRpcPayload,\n  FetchRequest,\n  JsonRpcApiProviderOptions,\n  Networkish,\n} from 'ethers';\nimport { Semaphore } from './Semaphore';\nimport { Stats } from './Stats';\nimport {\n  getHttpStatus,\n  getRetryAfterMs,\n  isRateLimitError,\n  isServerError,\n  isTimeoutError,\n  RpcEvent,\n} from './utils';\nimport { RpsLimiter } from './RpsLimiter';\n\nexport interface InstrumentedJsonRpcProviderOptions extends JsonRpcApiProviderOptions {\n  providerId: string;\n  stats: Stats;\n  inFlight?: number;\n  timeout?: number;\n  rps?: number;\n  rpsBurst?: number;\n  onEvent?: (e: RpcEvent) => void;\n}\n/**\n * Instrumented JsonRpcProvider.\n * Tracks requests, inFlight count, rate limits, and per-method / per-provider metrics.\n */\nexport class InstrumentedJsonRpcProvider extends JsonRpcProvider {\n  readonly providerId: string;\n  readonly chainId: bigint;\n  readonly options: InstrumentedJsonRpcProviderOptions;\n\n  readonly inFlightLimiter: Semaphore;\n  readonly rpsLimiter: RpsLimiter;\n  readonly stats: Stats;\n  readonly fetchRequest: FetchRequest;\n\n  private lastCooldownMs: number = 0;\n\n  constructor(\n    url: string | FetchRequest,\n    network: Networkish,\n    options: InstrumentedJsonRpcProviderOptions,\n  ) {\n    let fetchRequest: FetchRequest;\n\n    if (typeof url == 'string') {\n      fetchRequest = new FetchRequest(url);\n    } else {\n      fetchRequest = url;\n    }\n\n    fetchRequest.timeout = options.timeout || 10_000;\n\n    const _network = Network.from(network);\n    super(fetchRequest, _network, { staticNetwork: true, ...options });\n    this.fetchRequest = fetchRequest;\n    this.providerId = options.providerId;\n    this.chainId = _network.chainId;\n    this.options = options;\n\n    const { rps = 10, rpsBurst, inFlight = 1 } = options;\n\n    this.inFlightLimiter = new Semaphore(inFlight);\n    this.rpsLimiter = new RpsLimiter(rps, rpsBurst || rps);\n    this.stats = options.stats;\n  }\n\n  override async _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    await this.rpsLimiter.take(1);\n\n    const release = this.inFlightLimiter ? await this.inFlightLimiter.acquire() : undefined;\n\n    try {\n      return await this._sendInstrumented(payload);\n    } finally {\n      release?.();\n    }\n  }\n\n  // ethers v5 calls send(method, params)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private async _sendInstrumented(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    const startedAt = Date.now();\n    const payloads = Array.isArray(payload) ? payload : [payload];\n\n    this.stats.bumpInFlightPerProvider(this.providerId);\n    this.stats.bumpProviderTotal(this.providerId);\n\n    for (const p of payloads) {\n      this.stats.bumpPerMethod(p.method);\n      this.options.onEvent?.({\n        type: 'request',\n        chainId: this.chainId,\n        providerId: this.providerId,\n        method: p.method,\n        startedAt,\n      });\n    }\n\n    try {\n      const res = await super._send(payload);\n\n      const endedAt = Date.now();\n\n      for (const p of payloads) {\n        this.options.onEvent?.({\n          type: 'response',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n        });\n      }\n\n      this.lastCooldownMs = 0;\n\n      return res;\n    } catch (e: any) {\n      const endedAt = Date.now();\n      const rl = isRateLimitError(e);\n      if (rl) {\n        this.stats.bumpRateLimitedPerProvider(this.providerId);\n        const cooldownMs = 10_000;\n        const raMs = getRetryAfterMs(e) ?? cooldownMs;\n        this.stats.setCooldown(this.providerId, raMs);\n      }\n\n      const isTimeout = isTimeoutError(e);\n      if (isTimeout && !rl) {\n        this.stats.bumpTimeoutPerProvider(this.providerId);\n\n        const n = this.stats.snapshot().perProviderTotal[this.providerId] || 0;\n        const ratio = this.stats.timeoutRatio(this.providerId);\n\n        // thresholds: do not ban on a single timeout, only after enough data\n        if (n >= 50 && ratio >= 0.2) {\n          const cooldownMs = ratio >= 0.5 ? 600_000 : 60_000;\n          const raMs = getRetryAfterMs(e) ?? cooldownMs;\n          this.lastCooldownMs = raMs;\n          this.stats.setCooldown(this.providerId, raMs + Math.floor(Math.random() * 1000));\n        }\n      }\n\n      const isError = isServerError(e);\n      if (isError && !rl && !isTimeout) {\n        this.stats.bumpServerErrorPerProvider(this.providerId);\n        const cooldownMs = (this.lastCooldownMs * 2 || 10_000) + Math.floor(Math.random() * 1000);\n        this.lastCooldownMs = cooldownMs;\n        this.stats.setCooldown(this.providerId, cooldownMs);\n      }\n\n      for (const p of payloads) {\n        this.options.onEvent?.({\n          type: 'error',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n          isRateLimit: rl,\n          isTimeout: isTimeout,\n          status: getHttpStatus(e),\n          code: e?.code,\n          message: String(e?.message || e),\n        });\n      }\n\n      throw e;\n    } finally {\n      this.stats.decreaseInFlightPerProvider(this.providerId);\n    }\n  }\n}\n","export class Semaphore {\n  private inUse = 0;\n  private queue: Array<() => void> = [];\n\n  constructor(private readonly max: number) {\n    if (!Number.isFinite(max) || max <= 0) {\n      throw new Error(`Semaphore max must be a positive number, got: ${max}`);\n    }\n  }\n\n  async acquire(): Promise<() => void> {\n    if (this.inUse < this.max) {\n      this.inUse++;\n      let released = false;\n      return () => {\n        if (released) return;\n        released = true;\n        this.release();\n      };\n    }\n\n    return new Promise<() => void>((resolve) => {\n      this.queue.push(() => {\n        this.inUse++;\n        let released = false;\n        resolve(() => {\n          if (released) return;\n          released = true;\n          this.release();\n        });\n      });\n    });\n  }\n\n  private release() {\n    this.inUse = Math.max(0, this.inUse - 1);\n    const next = this.queue.shift();\n    if (next) next();\n  }\n}\n","export class RpsLimiter {\n  // Current number of tokens in the bucket (can be fractional)\n  private tokens: number;\n\n  // Time of last token refill, in ms\n  private lastRefill = Date.now();\n\n  constructor(\n    // rps: how many tokens we add per second\n    private readonly rps: number,\n    // burst: maximum bucket capacity.\n    // Default: >=1 and approximately equal to rps (to allow a small burst)\n    private readonly burst: number = Math.max(1, Math.ceil(rps)),\n  ) {\n    // At start, the bucket is full: can make burst requests immediately\n    this.tokens = burst;\n  }\n\n  // Refill tokens according to elapsed time\n  private refill(now: number) {\n    // rps<=0 means \"limit is disabled\"\n    if (this.rps <= 0) return;\n\n    const elapsed = now - this.lastRefill; // ms since last refill\n    if (elapsed <= 0) return;\n\n    // How many tokens to add:\n    // elapsed/1000 = seconds, multiply by rps\n    const add = (elapsed / 1000) * this.rps;\n\n    // Add tokens, but don't exceed burst (bucket capacity)\n    this.tokens = Math.min(this.burst, this.tokens + add);\n\n    // Remember that we refilled tokens at time now\n    this.lastRefill = now;\n  }\n\n  // Take count tokens (usually 1 request = 1 token).\n  // If not enough tokens — wait and try again.\n  async take(count = 1): Promise<void> {\n    if (!this.rps || this.rps <= 0) return;\n\n    while (true) {\n      const now = Date.now();\n\n      // Before attempting — refill tokens\n      this.refill(now);\n\n      // If enough tokens — \"pay\" for the request and exit\n      if (this.tokens >= count) {\n        this.tokens -= count;\n        return;\n      }\n\n      // Not enough tokens: calculate how long to wait\n      const need = count - this.tokens;\n\n      // How many ms needed to accumulate need tokens:\n      // need / rps = seconds, *1000 = ms\n      const waitMs = Math.ceil((need / this.rps) * 1000);\n\n      // Wait in chunks (not all waitMs at once), to:\n      // - not sleep too long if time/state changed\n      // - be more resilient to timer drift\n      await new Promise((r) => setTimeout(r, Math.min(waitMs, 50)));\n    }\n  }\n}\n","import { Endpoint } from './utils';\nimport { Stats } from './Stats';\n\nexport class Router {\n  private rr = 0;\n\n  constructor(\n    private readonly endpoints: Endpoint[],\n    private readonly stats: Stats,\n  ) {}\n\n  size(): number {\n    return this.endpoints.length;\n  }\n\n  pick(): Endpoint {\n    const n = this.endpoints.length;\n    for (let k = 0; k < n; k++) {\n      const i = ((this.rr++ % n) + n) % n;\n      const ep = this.endpoints[i];\n\n      if (!this.stats.isInCooldown(ep.providerId)) return ep;\n    }\n    // if all are in cooldown, return the next one in round-robin order\n    return this.endpoints[((this.rr++ % n) + n) % n];\n  }\n}\n"],"mappings":"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","names":["import_ethers"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { JsonRpcProvider, FetchRequest, JsonRpcPayload } from 'ethers';
+import { JsonRpcProvider, JsonRpcApiProviderOptions, FetchRequest, Networkish, JsonRpcPayload } from 'ethers';
 
 interface RpcStatsSnapshot {
     total: number;
@@ -64,9 +64,7 @@ declare class RpsLimiter {
     take(count?: number): Promise<void>;
 }
 
-interface ProviderParams {
-    url: string;
-    chainId: number;
+interface InstrumentedJsonRpcProviderOptions extends JsonRpcApiProviderOptions {
     providerId: string;
     stats: Stats;
     inFlight?: number;
@@ -76,19 +74,19 @@ interface ProviderParams {
     onEvent?: (e: RpcEvent) => void;
 }
 /**
- * Instrumented StaticJsonRpcProvider.
+ * Instrumented JsonRpcProvider.
  * Tracks requests, inFlight count, rate limits, and per-method / per-provider metrics.
  */
-declare class InstrumentedStaticJsonRpcProvider extends JsonRpcProvider {
+declare class InstrumentedJsonRpcProvider extends JsonRpcProvider {
     readonly providerId: string;
-    readonly chainId: number;
-    readonly params: ProviderParams;
+    readonly chainId: bigint;
+    readonly options: InstrumentedJsonRpcProviderOptions;
     readonly inFlightLimiter: Semaphore;
     readonly rpsLimiter: RpsLimiter;
     readonly stats: Stats;
     readonly fetchRequest: FetchRequest;
     private lastCooldownMs;
-    constructor(params: ProviderParams);
+    constructor(url: string | FetchRequest, network: Networkish, options: InstrumentedJsonRpcProviderOptions);
     _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any>;
     private _sendInstrumented;
 }
@@ -96,17 +94,17 @@ declare class InstrumentedStaticJsonRpcProvider extends JsonRpcProvider {
 interface Endpoint {
     providerId: string;
     url: string;
-    provider: InstrumentedStaticJsonRpcProvider;
+    provider: InstrumentedJsonRpcProvider;
 }
 type RpcEvent = {
     type: 'request';
-    chainId: number;
+    chainId: bigint;
     providerId: string;
     method: string;
     startedAt: number;
 } | {
     type: 'response';
-    chainId: number;
+    chainId: bigint;
     providerId: string;
     method: string;
     startedAt: number;
@@ -114,7 +112,7 @@ type RpcEvent = {
     ms: number;
 } | {
     type: 'error';
-    chainId: number;
+    chainId: bigint;
     providerId: string;
     method: string;
     startedAt: number;
@@ -136,10 +134,14 @@ declare class Router {
     pick(): Endpoint;
 }
 
+interface RPCPoolProviderOptions extends Partial<InstrumentedJsonRpcProviderOptions> {
+    url: string | FetchRequest;
+    network?: Networkish;
+}
 interface RPCPoolProviderParams {
-    chainId: number;
-    urls: string[];
-    perUrl: {
+    network: Networkish;
+    rpc: RPCPoolProviderOptions[];
+    defaultRpcOptions: {
         inFlight: number;
         timeout?: number;
         rps?: number;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JsonRpcProvider, FetchRequest, JsonRpcPayload } from 'ethers';
+import { JsonRpcProvider, JsonRpcApiProviderOptions, FetchRequest, Networkish, JsonRpcPayload } from 'ethers';
 
 interface RpcStatsSnapshot {
     total: number;
@@ -64,9 +64,7 @@ declare class RpsLimiter {
     take(count?: number): Promise<void>;
 }
 
-interface ProviderParams {
-    url: string;
-    chainId: number;
+interface InstrumentedJsonRpcProviderOptions extends JsonRpcApiProviderOptions {
     providerId: string;
     stats: Stats;
     inFlight?: number;
@@ -76,19 +74,19 @@ interface ProviderParams {
     onEvent?: (e: RpcEvent) => void;
 }
 /**
- * Instrumented StaticJsonRpcProvider.
+ * Instrumented JsonRpcProvider.
  * Tracks requests, inFlight count, rate limits, and per-method / per-provider metrics.
  */
-declare class InstrumentedStaticJsonRpcProvider extends JsonRpcProvider {
+declare class InstrumentedJsonRpcProvider extends JsonRpcProvider {
     readonly providerId: string;
-    readonly chainId: number;
-    readonly params: ProviderParams;
+    readonly chainId: bigint;
+    readonly options: InstrumentedJsonRpcProviderOptions;
     readonly inFlightLimiter: Semaphore;
     readonly rpsLimiter: RpsLimiter;
     readonly stats: Stats;
     readonly fetchRequest: FetchRequest;
     private lastCooldownMs;
-    constructor(params: ProviderParams);
+    constructor(url: string | FetchRequest, network: Networkish, options: InstrumentedJsonRpcProviderOptions);
     _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any>;
     private _sendInstrumented;
 }
@@ -96,17 +94,17 @@ declare class InstrumentedStaticJsonRpcProvider extends JsonRpcProvider {
 interface Endpoint {
     providerId: string;
     url: string;
-    provider: InstrumentedStaticJsonRpcProvider;
+    provider: InstrumentedJsonRpcProvider;
 }
 type RpcEvent = {
     type: 'request';
-    chainId: number;
+    chainId: bigint;
     providerId: string;
     method: string;
     startedAt: number;
 } | {
     type: 'response';
-    chainId: number;
+    chainId: bigint;
     providerId: string;
     method: string;
     startedAt: number;
@@ -114,7 +112,7 @@ type RpcEvent = {
     ms: number;
 } | {
     type: 'error';
-    chainId: number;
+    chainId: bigint;
     providerId: string;
     method: string;
     startedAt: number;
@@ -136,10 +134,14 @@ declare class Router {
     pick(): Endpoint;
 }
 
+interface RPCPoolProviderOptions extends Partial<InstrumentedJsonRpcProviderOptions> {
+    url: string | FetchRequest;
+    network?: Networkish;
+}
 interface RPCPoolProviderParams {
-    chainId: number;
-    urls: string[];
-    perUrl: {
+    network: Networkish;
+    rpc: RPCPoolProviderOptions[];
+    defaultRpcOptions: {
         inFlight: number;
         timeout?: number;
         rps?: number;

package/dist/index.js

@@ -116,20 +116,6 @@ function isTimeoutError(e) {
   const msg = String(e?.message || e);
   return /timeout|timed out|ETIMEDOUT|ESOCKETTIMEDOUT|ECONNABORTED|504 Gateway/i.test(msg);
 }
-function withTimeout(p, ms, meta) {
-  let t;
-  const timeout = new Promise((_, reject) => {
-    t = setTimeout(() => {
-      const err = new Error(
-        `RPC timeout after ${ms}ms` + (meta?.method ? ` method=${meta.method}` : "") + (meta?.providerId ? ` provider=${meta.providerId}` : "") + (meta?.chainId != null ? ` chainId=${meta.chainId}` : "")
-      );
-      err.code = "TIMEOUT";
-      err.timeout = ms;
-      reject(err);
-    }, ms);
-  });
-  return Promise.race([p, timeout]).finally(() => t && clearTimeout(t));
-}
 function shouldFailover(e) {
   const to = isTimeoutError(e);
   const rl = isRateLimitError(e);
@@ -138,7 +124,11 @@ function shouldFailover(e) {
 }
 
 // src/InstrumentedProvider.ts
-import { JsonRpcProvider, Network, FetchRequest } from "ethers";
+import {
+  JsonRpcProvider,
+  Network,
+  FetchRequest
+} from "ethers";
 
 // src/Semaphore.ts
 var Semaphore = class {
@@ -218,29 +208,33 @@ var RpsLimiter = class {
 };
 
 // src/InstrumentedProvider.ts
-var InstrumentedStaticJsonRpcProvider = class extends JsonRpcProvider {
+var InstrumentedJsonRpcProvider = class extends JsonRpcProvider {
   providerId;
   chainId;
-  params;
+  options;
   inFlightLimiter;
   rpsLimiter;
   stats;
   fetchRequest;
   lastCooldownMs = 0;
-  constructor(params) {
-    const { url, providerId, chainId } = params;
-    const network = Network.from(chainId);
-    const fetchRequest = new FetchRequest(url);
-    fetchRequest.timeout = params.timeout || 1e4;
-    super(fetchRequest, chainId, { staticNetwork: network });
+  constructor(url, network, options) {
+    let fetchRequest;
+    if (typeof url == "string") {
+      fetchRequest = new FetchRequest(url);
+    } else {
+      fetchRequest = url;
+    }
+    fetchRequest.timeout = options.timeout || 1e4;
+    const _network = Network.from(network);
+    super(fetchRequest, _network, { staticNetwork: true, ...options });
     this.fetchRequest = fetchRequest;
-    this.providerId = providerId;
-    this.chainId = chainId;
-    this.params = params;
-    const { rps = 10, rpsBurst, inFlight = 1 } = params;
+    this.providerId = options.providerId;
+    this.chainId = _network.chainId;
+    this.options = options;
+    const { rps = 10, rpsBurst, inFlight = 1 } = options;
     this.inFlightLimiter = new Semaphore(inFlight);
     this.rpsLimiter = new RpsLimiter(rps, rpsBurst || rps);
-    this.stats = params.stats;
+    this.stats = options.stats;
   }
   async _send(payload) {
     await this.rpsLimiter.take(1);
@@ -260,7 +254,7 @@ var InstrumentedStaticJsonRpcProvider = class extends JsonRpcProvider {
     this.stats.bumpProviderTotal(this.providerId);
     for (const p of payloads) {
       this.stats.bumpPerMethod(p.method);
-      this.params.onEvent?.({
+      this.options.onEvent?.({
         type: "request",
         chainId: this.chainId,
         providerId: this.providerId,
@@ -269,14 +263,10 @@ var InstrumentedStaticJsonRpcProvider = class extends JsonRpcProvider {
       });
     }
     try {
-      const base = super._send(payload);
-      const res = await withTimeout(base, this.params.timeout || 1e4, {
-        chainId: this.chainId,
-        providerId: this.providerId
-      });
+      const res = await super._send(payload);
       const endedAt = Date.now();
       for (const p of payloads) {
-        this.params.onEvent?.({
+        this.options.onEvent?.({
           type: "response",
           chainId: this.chainId,
           providerId: this.providerId,
@@ -317,7 +307,7 @@ var InstrumentedStaticJsonRpcProvider = class extends JsonRpcProvider {
         this.stats.setCooldown(this.providerId, cooldownMs);
       }
       for (const p of payloads) {
-        this.params.onEvent?.({
+        this.options.onEvent?.({
           type: "error",
           chainId: this.chainId,
           providerId: this.providerId,
@@ -366,22 +356,18 @@ var RPCPoolProvider = class extends JsonRpcProvider2 {
   params;
   stats;
   constructor(params) {
-    const network = Network2.from(params.chainId);
+    const network = Network2.from(params.network);
     super("http://localhost", network, { staticNetwork: network });
     this.params = params;
     this.stats = new Stats();
-    const endpoints = this.params.urls.map((url, i) => {
-      const providerId = `rpc#${i + 1}-chainId:${this.params.chainId}-${url}`;
-      const { inFlight = 1, rps = 1, rpsBurst, timeout = 1e4 } = this.params.perUrl;
-      const provider = new InstrumentedStaticJsonRpcProvider({
-        url,
-        chainId: this.params.chainId,
+    const endpoints = this.params.rpc.map((options, i) => {
+      const url = typeof options.url === "string" ? options.url : options.url.url;
+      const providerId = `rpc#${i + 1}-chainId:${this.params.network}-${url}`;
+      const provider = new InstrumentedJsonRpcProvider(options.url, this.params.network, {
         providerId,
         stats: this.stats,
-        inFlight,
-        rps,
-        rpsBurst,
-        timeout,
+        ...this.params.defaultRpcOptions,
+        ...options,
         onEvent: this.params.hooks?.onEvent
       });
       return { providerId, url, provider };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/RpcPoolProvider.ts","../src/Stats.ts","../src/utils.ts","../src/InstrumentedProvider.ts","../src/Semaphore.ts","../src/RpsLimiter.ts","../src/Router.ts"],"sourcesContent":["import { JsonRpcProvider, Network } from 'ethers';\nimport { Stats } from './Stats';\nimport { Endpoint, RpcEvent, shouldFailover } from './utils';\nimport { InstrumentedStaticJsonRpcProvider } from './InstrumentedProvider';\nimport { Router } from './Router';\n\nexport interface RPCPoolProviderParams {\n  chainId: number;\n  urls: string[];\n  perUrl: { inFlight: number; timeout?: number; rps?: number; rpsBurst?: number };\n  retry: { attempts: number };\n  hooks?: {\n    onEvent(e: RpcEvent): void;\n  };\n}\n\n// TODO\n// -- circuit breaker + health checks\n// -- sticky “session”\n\nexport class RPCPoolProvider extends JsonRpcProvider {\n  readonly router: Router;\n  readonly params: RPCPoolProviderParams;\n  readonly stats: Stats;\n\n  constructor(params: RPCPoolProviderParams) {\n    const network = Network.from(params.chainId);\n    super('http://localhost', network, { staticNetwork: network });\n\n    this.params = params;\n\n    this.stats = new Stats();\n\n    const endpoints: Endpoint[] = this.params.urls.map((url, i) => {\n      const providerId = `rpc#${i + 1}-chainId:${this.params.chainId}-${url}`;\n\n      const { inFlight = 1, rps = 1, rpsBurst, timeout = 10_000 } = this.params.perUrl;\n\n      const provider = new InstrumentedStaticJsonRpcProvider({\n        url,\n        chainId: this.params.chainId,\n        providerId,\n        stats: this.stats,\n        inFlight,\n        rps,\n        rpsBurst,\n        timeout,\n        onEvent: this.params.hooks?.onEvent,\n      });\n\n      return { providerId, url, provider };\n    });\n\n    this.router = new Router(endpoints, this.stats);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async send(method: string, params: any): Promise<any> {\n    const tried = new Set<string>();\n    const maxUniqueTries = Math.min(this.params.retry.attempts, this.router.size());\n\n    while (tried.size < maxUniqueTries) {\n      const ep = this.router.pick();\n      if (tried.has(ep.providerId)) continue;\n      tried.add(ep.providerId);\n\n      try {\n        return await ep.provider.send(method, params);\n      } catch (e: any) {\n        if (!shouldFailover(e)) throw e;\n        if (tried.size >= maxUniqueTries) throw e;\n\n        // Add exponential backoff with jitter before retry\n        const baseDelay = Math.min(1000 * Math.pow(2, tried.size - 1), 5000);\n        const jitter = Math.random() * baseDelay;\n        await new Promise((resolve) => setTimeout(resolve, jitter));\n      }\n    }\n\n    throw new Error('No RPC available');\n  }\n\n  getStats(): Stats {\n    return this.stats;\n  }\n}\n","export interface RpcStatsSnapshot {\n  total: number;\n  inFlight: number;\n  perMethodTotal: Record<string, number>;\n  rateLimitedTotal: number;\n  perProviderRateLimited: Record<string, number>;\n  timeoutTotal: number;\n  perProviderTimeout: Record<string, number>;\n  perProviderTotal: Record<string, number>;\n  providerCooldownUntil: Record<string, number>;\n  perProviderInFlight: Record<string, number>;\n  perProviderError: Record<string, number>;\n}\n\nexport class Stats {\n  private _total = 0;\n  private _inFlight = 0;\n\n  private _perMethod: Record<string, number> = {};\n\n  private _rateLimitedTotal = 0;\n  private _timeoutTotal = 0;\n\n  private _perProviderInFlight: Record<string, number> = {};\n  private _perProviderTotal: Record<string, number> = {};\n  private _perProviderTimeout: Record<string, number> = {};\n  private _perProviderRateLimited: Record<string, number> = {};\n  private _perProviderError: Record<string, number> = {};\n\n  private _providerCooldownUntil: Record<string, number> = {};\n\n  private _bump(map: Record<string, number>, key: string) {\n    map[key] = (map[key] || 0) + 1;\n  }\n\n  private _decrease(map: Record<string, number>, key: string) {\n    map[key] = Math.max((map[key] || 0) - 1, 0);\n  }\n\n  private _bumpTotal() {\n    this._total++;\n  }\n\n  private _bumpInFlight() {\n    this._inFlight++;\n  }\n\n  private _bumpRateLimitedTotal() {\n    this._rateLimitedTotal++;\n  }\n\n  private _bumpTimeoutTotal() {\n    this._timeoutTotal++;\n  }\n\n  bumpInFlightPerProvider(id: string) {\n    this._bumpInFlight();\n    this._bump(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlightPerProvider(id: string) {\n    this.decreaseInFlight();\n    this._decrease(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlight() {\n    this._inFlight = Math.max(this._inFlight - 1, 0);\n  }\n\n  bumpPerMethod(method: string) {\n    this._bump(this._perMethod, method);\n  }\n\n  bumpRateLimitedPerProvider(id: string) {\n    this._bumpRateLimitedTotal();\n    this._bump(this._perProviderRateLimited, id);\n  }\n\n  bumpTimeoutPerProvider(id: string) {\n    this._bumpTimeoutTotal();\n    this._bump(this._perProviderTimeout, id);\n  }\n\n  bumpProviderTotal(id: string) {\n    this._bumpTotal();\n    this._perProviderTotal[id] = (this._perProviderTotal[id] || 0) + 1;\n  }\n  bumpServerErrorPerProvider(id: string) {\n    this._bump(this._perProviderError, id);\n  }\n\n  timeoutRatio(id: string) {\n    const t = this._perProviderTimeout[id] || 0;\n    const n = this._perProviderTotal[id] || 0;\n    return n ? t / n : 0;\n  }\n\n  isInCooldown(id: string) {\n    return (this._providerCooldownUntil[id] || 0) > Date.now();\n  }\n\n  setCooldown(id: string, ms: number) {\n    this._providerCooldownUntil[id] = Date.now() + ms;\n  }\n\n  snapshot(): Readonly<RpcStatsSnapshot> {\n    return {\n      total: this._total,\n      inFlight: this._inFlight,\n      perMethodTotal: { ...this._perMethod },\n      rateLimitedTotal: this._rateLimitedTotal,\n      timeoutTotal: this._timeoutTotal,\n      perProviderInFlight: { ...this._perProviderInFlight },\n      perProviderRateLimited: { ...this._perProviderRateLimited },\n      perProviderTimeout: { ...this._perProviderTimeout },\n      perProviderError: { ...this._perProviderError },\n      perProviderTotal: { ...this._perProviderTotal },\n      providerCooldownUntil: { ...this._providerCooldownUntil },\n    };\n  }\n}\n","import { InstrumentedStaticJsonRpcProvider } from './InstrumentedProvider';\n\nexport interface Endpoint {\n  providerId: string;\n  url: string;\n  provider: InstrumentedStaticJsonRpcProvider;\n}\n\nexport type RpcEvent =\n  | {\n      type: 'request';\n      chainId: number;\n      providerId: string;\n      method: string;\n      startedAt: number;\n    }\n  | {\n      type: 'response';\n      chainId: number;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n    }\n  | {\n      type: 'error';\n      chainId: number;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n      isRateLimit: boolean;\n      isTimeout: boolean;\n      status?: number;\n      code?: string;\n      message: string;\n    };\n\nexport function getHttpStatus(e: any): number | undefined {\n  return (\n    e?.status ??\n    e?.response?.status ??\n    e?.response?.statusCode ??\n    e?.error?.status ??\n    e?.error?.response?.status ??\n    e?.body?.statusCode // sometimes present\n  );\n}\n\nexport function isRateLimitError(e: any): boolean {\n  const status = getHttpStatus(e);\n  if (status === 429 || status === 402) return true;\n\n  const msg = String(e?.message || e);\n  if (/error code:\\s*1015/i.test(msg)) return true; // Cloudflare\n  return /rate limit|too many requests|429|quota|throttl/i.test(msg);\n}\n\nexport function isServerError(e: any): boolean {\n  const status = getHttpStatus(e);\n  return status !== undefined && status >= 500;\n}\n\nexport function getRetryAfterMs(e: any): number | null {\n  const ra =\n    e?.response?.headers?.get?.('retry-after') ??\n    e?.response?.headers?.['retry-after'] ??\n    e?.headers?.['retry-after'];\n  const n = Number(ra);\n  return Number.isFinite(n) ? n * 1000 : null;\n}\n\nexport function isTimeoutError(e: any): boolean {\n  // ethers v5\n  if (e?.code === 'TIMEOUT') return true;\n\n  const status = getHttpStatus(e);\n  // some RPCs / proxies return 504 on timeout\n  if (status === 504) return true;\n\n  const msg = String(e?.message || e);\n\n  // node-fetch / undici / axios / nginx / generic\n  return /timeout|timed out|ETIMEDOUT|ESOCKETTIMEDOUT|ECONNABORTED|504 Gateway/i.test(msg);\n}\n\n/**\n * Wraps a promise with a timeout (useful when an RPC hangs without emitting TIMEOUT).\n * Important: this does not cancel the network request, but you get a controlled error\n * and FallbackProvider can switch to another RPC.\n */\nexport function withTimeout<T>(\n  p: Promise<T>,\n  ms: number,\n  meta?: { chainId?: number; providerId?: string; method?: string },\n): Promise<T> {\n  let t: NodeJS.Timeout | undefined;\n\n  const timeout = new Promise<T>((_, reject) => {\n    t = setTimeout(() => {\n      const err: any = new Error(\n        `RPC timeout after ${ms}ms` +\n          (meta?.method ? ` method=${meta.method}` : '') +\n          (meta?.providerId ? ` provider=${meta.providerId}` : '') +\n          (meta?.chainId != null ? ` chainId=${meta.chainId}` : ''),\n      );\n      err.code = 'TIMEOUT';\n      err.timeout = ms;\n      reject(err);\n    }, ms);\n  });\n\n  return Promise.race([p, timeout]).finally(() => t && clearTimeout(t));\n}\n\nexport function shouldFailover(e: any): boolean {\n  const to = isTimeoutError(e);\n  const rl = isRateLimitError(e);\n  const se = isServerError(e);\n\n  // failover on timeouts and rate limits, but not on logical errors (e.g. invalid params)\n  return to || rl || se;\n}\n","import { JsonRpcProvider, Network, JsonRpcPayload, FetchRequest } from 'ethers';\nimport { Semaphore } from './Semaphore';\nimport { Stats } from './Stats';\nimport {\n  getHttpStatus,\n  getRetryAfterMs,\n  isRateLimitError,\n  isServerError,\n  isTimeoutError,\n  RpcEvent,\n  withTimeout,\n} from './utils';\nimport { RpsLimiter } from './RpsLimiter';\n\ninterface ProviderParams {\n  url: string;\n  chainId: number;\n  providerId: string;\n  stats: Stats;\n  inFlight?: number;\n  timeout?: number;\n  rps?: number;\n  rpsBurst?: number;\n  onEvent?: (e: RpcEvent) => void;\n}\n/**\n * Instrumented StaticJsonRpcProvider.\n * Tracks requests, inFlight count, rate limits, and per-method / per-provider metrics.\n */\nexport class InstrumentedStaticJsonRpcProvider extends JsonRpcProvider {\n  readonly providerId: string;\n  readonly chainId: number;\n  readonly params: ProviderParams;\n\n  readonly inFlightLimiter: Semaphore;\n  readonly rpsLimiter: RpsLimiter;\n  readonly stats: Stats;\n  readonly fetchRequest: FetchRequest;\n\n  private lastCooldownMs: number = 0;\n\n  constructor(params: ProviderParams) {\n    const { url, providerId, chainId } = params;\n\n    const network = Network.from(chainId);\n    const fetchRequest = new FetchRequest(url);\n\n    fetchRequest.timeout = params.timeout || 10_000;\n\n    super(fetchRequest, chainId, { staticNetwork: network });\n    this.fetchRequest = fetchRequest;\n    this.providerId = providerId;\n    this.chainId = chainId;\n    this.params = params;\n\n    const { rps = 10, rpsBurst, inFlight = 1 } = params;\n\n    this.inFlightLimiter = new Semaphore(inFlight);\n    this.rpsLimiter = new RpsLimiter(rps, rpsBurst || rps);\n    this.stats = params.stats;\n  }\n\n  override async _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    await this.rpsLimiter.take(1);\n\n    const release = this.inFlightLimiter ? await this.inFlightLimiter.acquire() : undefined;\n\n    try {\n      return await this._sendInstrumented(payload);\n    } finally {\n      release?.();\n    }\n  }\n\n  // ethers v5 calls send(method, params)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private async _sendInstrumented(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    const startedAt = Date.now();\n    const payloads = Array.isArray(payload) ? payload : [payload];\n\n    this.stats.bumpInFlightPerProvider(this.providerId);\n    this.stats.bumpProviderTotal(this.providerId);\n\n    for (const p of payloads) {\n      this.stats.bumpPerMethod(p.method);\n      this.params.onEvent?.({\n        type: 'request',\n        chainId: this.chainId,\n        providerId: this.providerId,\n        method: p.method,\n        startedAt,\n      });\n    }\n\n    try {\n      const base = super._send(payload);\n      const res = await withTimeout(base, this.params.timeout || 10_000, {\n        chainId: this.chainId,\n        providerId: this.providerId,\n      });\n\n      const endedAt = Date.now();\n\n      for (const p of payloads) {\n        this.params.onEvent?.({\n          type: 'response',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n        });\n      }\n\n      this.lastCooldownMs = 0;\n\n      return res;\n    } catch (e: any) {\n      const endedAt = Date.now();\n      const rl = isRateLimitError(e);\n      if (rl) {\n        this.stats.bumpRateLimitedPerProvider(this.providerId);\n        const cooldownMs = 10_000;\n        const raMs = getRetryAfterMs(e) ?? cooldownMs;\n        this.stats.setCooldown(this.providerId, raMs);\n      }\n\n      const isTimeout = isTimeoutError(e);\n      if (isTimeout && !rl) {\n        this.stats.bumpTimeoutPerProvider(this.providerId);\n\n        const n = this.stats.snapshot().perProviderTotal[this.providerId] || 0;\n        const ratio = this.stats.timeoutRatio(this.providerId);\n\n        // thresholds: do not ban on a single timeout, only after enough data\n        if (n >= 50 && ratio >= 0.2) {\n          const cooldownMs = ratio >= 0.5 ? 600_000 : 60_000;\n          const raMs = getRetryAfterMs(e) ?? cooldownMs;\n          this.lastCooldownMs = raMs;\n          this.stats.setCooldown(this.providerId, raMs + Math.floor(Math.random() * 1000));\n        }\n      }\n\n      const isError = isServerError(e);\n      if (isError && !rl && !isTimeout) {\n        this.stats.bumpServerErrorPerProvider(this.providerId);\n        const cooldownMs = (this.lastCooldownMs * 2 || 10_000) + Math.floor(Math.random() * 1000);\n        this.lastCooldownMs = cooldownMs;\n        this.stats.setCooldown(this.providerId, cooldownMs);\n      }\n\n      for (const p of payloads) {\n        this.params.onEvent?.({\n          type: 'error',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n          isRateLimit: rl,\n          isTimeout: isTimeout,\n          status: getHttpStatus(e),\n          code: e?.code,\n          message: String(e?.message || e),\n        });\n      }\n\n      throw e;\n    } finally {\n      this.stats.decreaseInFlightPerProvider(this.providerId);\n    }\n  }\n}\n","export class Semaphore {\n  private inUse = 0;\n  private queue: Array<() => void> = [];\n\n  constructor(private readonly max: number) {\n    if (!Number.isFinite(max) || max <= 0) {\n      throw new Error(`Semaphore max must be a positive number, got: ${max}`);\n    }\n  }\n\n  async acquire(): Promise<() => void> {\n    if (this.inUse < this.max) {\n      this.inUse++;\n      let released = false;\n      return () => {\n        if (released) return;\n        released = true;\n        this.release();\n      };\n    }\n\n    return new Promise<() => void>((resolve) => {\n      this.queue.push(() => {\n        this.inUse++;\n        let released = false;\n        resolve(() => {\n          if (released) return;\n          released = true;\n          this.release();\n        });\n      });\n    });\n  }\n\n  private release() {\n    this.inUse = Math.max(0, this.inUse - 1);\n    const next = this.queue.shift();\n    if (next) next();\n  }\n}\n","export class RpsLimiter {\n  // Current number of tokens in the bucket (can be fractional)\n  private tokens: number;\n\n  // Time of last token refill, in ms\n  private lastRefill = Date.now();\n\n  constructor(\n    // rps: how many tokens we add per second\n    private readonly rps: number,\n    // burst: maximum bucket capacity.\n    // Default: >=1 and approximately equal to rps (to allow a small burst)\n    private readonly burst: number = Math.max(1, Math.ceil(rps)),\n  ) {\n    // At start, the bucket is full: can make burst requests immediately\n    this.tokens = burst;\n  }\n\n  // Refill tokens according to elapsed time\n  private refill(now: number) {\n    // rps<=0 means \"limit is disabled\"\n    if (this.rps <= 0) return;\n\n    const elapsed = now - this.lastRefill; // ms since last refill\n    if (elapsed <= 0) return;\n\n    // How many tokens to add:\n    // elapsed/1000 = seconds, multiply by rps\n    const add = (elapsed / 1000) * this.rps;\n\n    // Add tokens, but don't exceed burst (bucket capacity)\n    this.tokens = Math.min(this.burst, this.tokens + add);\n\n    // Remember that we refilled tokens at time now\n    this.lastRefill = now;\n  }\n\n  // Take count tokens (usually 1 request = 1 token).\n  // If not enough tokens — wait and try again.\n  async take(count = 1): Promise<void> {\n    if (!this.rps || this.rps <= 0) return;\n\n    while (true) {\n      const now = Date.now();\n\n      // Before attempting — refill tokens\n      this.refill(now);\n\n      // If enough tokens — \"pay\" for the request and exit\n      if (this.tokens >= count) {\n        this.tokens -= count;\n        return;\n      }\n\n      // Not enough tokens: calculate how long to wait\n      const need = count - this.tokens;\n\n      // How many ms needed to accumulate need tokens:\n      // need / rps = seconds, *1000 = ms\n      const waitMs = Math.ceil((need / this.rps) * 1000);\n\n      // Wait in chunks (not all waitMs at once), to:\n      // - not sleep too long if time/state changed\n      // - be more resilient to timer drift\n      await new Promise((r) => setTimeout(r, Math.min(waitMs, 50)));\n    }\n  }\n}\n","import { Endpoint } from './utils';\nimport { Stats } from './Stats';\n\nexport class Router {\n  private rr = 0;\n\n  constructor(\n    private readonly endpoints: Endpoint[],\n    private readonly stats: Stats,\n  ) {}\n\n  size(): number {\n    return this.endpoints.length;\n  }\n\n  pick(): Endpoint {\n    const n = this.endpoints.length;\n    for (let k = 0; k < n; k++) {\n      const i = ((this.rr++ % n) + n) % n;\n      const ep = this.endpoints[i];\n\n      if (!this.stats.isInCooldown(ep.providerId)) return ep;\n    }\n    // if all are in cooldown, return the next one in round-robin order\n    return this.endpoints[((this.rr++ % n) + n) % n];\n  }\n}\n"],"mappings":"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","names":["JsonRpcProvider","Network","JsonRpcProvider","Network"]}
+{"version":3,"sources":["../src/RpcPoolProvider.ts","../src/Stats.ts","../src/utils.ts","../src/InstrumentedProvider.ts","../src/Semaphore.ts","../src/RpsLimiter.ts","../src/Router.ts"],"sourcesContent":["import { FetchRequest, JsonRpcProvider, Network, Networkish } from 'ethers';\nimport { Stats } from './Stats';\nimport { Endpoint, RpcEvent, shouldFailover } from './utils';\nimport {\n  InstrumentedJsonRpcProvider,\n  InstrumentedJsonRpcProviderOptions,\n} from './InstrumentedProvider';\nimport { Router } from './Router';\n\ninterface RPCPoolProviderOptions extends Partial<InstrumentedJsonRpcProviderOptions> {\n  url: string | FetchRequest;\n  network?: Networkish;\n}\n\nexport interface RPCPoolProviderParams {\n  network: Networkish;\n  rpc: RPCPoolProviderOptions[];\n  defaultRpcOptions: { inFlight: number; timeout?: number; rps?: number; rpsBurst?: number };\n  retry: { attempts: number };\n  hooks?: {\n    onEvent(e: RpcEvent): void;\n  };\n}\n\n// TODO\n// -- circuit breaker + health checks\n// -- sticky “session”\n\nexport class RPCPoolProvider extends JsonRpcProvider {\n  readonly router: Router;\n  readonly params: RPCPoolProviderParams;\n  readonly stats: Stats;\n\n  constructor(params: RPCPoolProviderParams) {\n    const network = Network.from(params.network);\n    super('http://localhost', network, { staticNetwork: network });\n\n    this.params = params;\n\n    this.stats = new Stats();\n\n    const endpoints: Endpoint[] = this.params.rpc.map((options, i) => {\n      const url = typeof options.url === 'string' ? options.url : options.url.url;\n      const providerId = `rpc#${i + 1}-chainId:${this.params.network}-${url}`;\n\n      const provider = new InstrumentedJsonRpcProvider(options.url, this.params.network, {\n        providerId,\n        stats: this.stats,\n        ...this.params.defaultRpcOptions,\n        ...options,\n        onEvent: this.params.hooks?.onEvent,\n      });\n\n      return { providerId, url, provider };\n    });\n\n    this.router = new Router(endpoints, this.stats);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async send(method: string, params: any): Promise<any> {\n    const tried = new Set<string>();\n    const maxUniqueTries = Math.min(this.params.retry.attempts, this.router.size());\n\n    while (tried.size < maxUniqueTries) {\n      const ep = this.router.pick();\n      if (tried.has(ep.providerId)) continue;\n      tried.add(ep.providerId);\n\n      try {\n        return await ep.provider.send(method, params);\n      } catch (e: any) {\n        if (!shouldFailover(e)) throw e;\n        if (tried.size >= maxUniqueTries) throw e;\n\n        // Add exponential backoff with jitter before retry\n        const baseDelay = Math.min(1000 * Math.pow(2, tried.size - 1), 5000);\n        const jitter = Math.random() * baseDelay;\n        await new Promise((resolve) => setTimeout(resolve, jitter));\n      }\n    }\n\n    throw new Error('No RPC available');\n  }\n\n  getStats(): Stats {\n    return this.stats;\n  }\n}\n","export interface RpcStatsSnapshot {\n  total: number;\n  inFlight: number;\n  perMethodTotal: Record<string, number>;\n  rateLimitedTotal: number;\n  perProviderRateLimited: Record<string, number>;\n  timeoutTotal: number;\n  perProviderTimeout: Record<string, number>;\n  perProviderTotal: Record<string, number>;\n  providerCooldownUntil: Record<string, number>;\n  perProviderInFlight: Record<string, number>;\n  perProviderError: Record<string, number>;\n}\n\nexport class Stats {\n  private _total = 0;\n  private _inFlight = 0;\n\n  private _perMethod: Record<string, number> = {};\n\n  private _rateLimitedTotal = 0;\n  private _timeoutTotal = 0;\n\n  private _perProviderInFlight: Record<string, number> = {};\n  private _perProviderTotal: Record<string, number> = {};\n  private _perProviderTimeout: Record<string, number> = {};\n  private _perProviderRateLimited: Record<string, number> = {};\n  private _perProviderError: Record<string, number> = {};\n\n  private _providerCooldownUntil: Record<string, number> = {};\n\n  private _bump(map: Record<string, number>, key: string) {\n    map[key] = (map[key] || 0) + 1;\n  }\n\n  private _decrease(map: Record<string, number>, key: string) {\n    map[key] = Math.max((map[key] || 0) - 1, 0);\n  }\n\n  private _bumpTotal() {\n    this._total++;\n  }\n\n  private _bumpInFlight() {\n    this._inFlight++;\n  }\n\n  private _bumpRateLimitedTotal() {\n    this._rateLimitedTotal++;\n  }\n\n  private _bumpTimeoutTotal() {\n    this._timeoutTotal++;\n  }\n\n  bumpInFlightPerProvider(id: string) {\n    this._bumpInFlight();\n    this._bump(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlightPerProvider(id: string) {\n    this.decreaseInFlight();\n    this._decrease(this._perProviderInFlight, id);\n  }\n\n  decreaseInFlight() {\n    this._inFlight = Math.max(this._inFlight - 1, 0);\n  }\n\n  bumpPerMethod(method: string) {\n    this._bump(this._perMethod, method);\n  }\n\n  bumpRateLimitedPerProvider(id: string) {\n    this._bumpRateLimitedTotal();\n    this._bump(this._perProviderRateLimited, id);\n  }\n\n  bumpTimeoutPerProvider(id: string) {\n    this._bumpTimeoutTotal();\n    this._bump(this._perProviderTimeout, id);\n  }\n\n  bumpProviderTotal(id: string) {\n    this._bumpTotal();\n    this._perProviderTotal[id] = (this._perProviderTotal[id] || 0) + 1;\n  }\n  bumpServerErrorPerProvider(id: string) {\n    this._bump(this._perProviderError, id);\n  }\n\n  timeoutRatio(id: string) {\n    const t = this._perProviderTimeout[id] || 0;\n    const n = this._perProviderTotal[id] || 0;\n    return n ? t / n : 0;\n  }\n\n  isInCooldown(id: string) {\n    return (this._providerCooldownUntil[id] || 0) > Date.now();\n  }\n\n  setCooldown(id: string, ms: number) {\n    this._providerCooldownUntil[id] = Date.now() + ms;\n  }\n\n  snapshot(): Readonly<RpcStatsSnapshot> {\n    return {\n      total: this._total,\n      inFlight: this._inFlight,\n      perMethodTotal: { ...this._perMethod },\n      rateLimitedTotal: this._rateLimitedTotal,\n      timeoutTotal: this._timeoutTotal,\n      perProviderInFlight: { ...this._perProviderInFlight },\n      perProviderRateLimited: { ...this._perProviderRateLimited },\n      perProviderTimeout: { ...this._perProviderTimeout },\n      perProviderError: { ...this._perProviderError },\n      perProviderTotal: { ...this._perProviderTotal },\n      providerCooldownUntil: { ...this._providerCooldownUntil },\n    };\n  }\n}\n","import { InstrumentedJsonRpcProvider } from './InstrumentedProvider';\n\nexport interface Endpoint {\n  providerId: string;\n  url: string;\n  provider: InstrumentedJsonRpcProvider;\n}\n\nexport type RpcEvent =\n  | {\n      type: 'request';\n      chainId: bigint;\n      providerId: string;\n      method: string;\n      startedAt: number;\n    }\n  | {\n      type: 'response';\n      chainId: bigint;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n    }\n  | {\n      type: 'error';\n      chainId: bigint;\n      providerId: string;\n      method: string;\n      startedAt: number;\n      endedAt: number;\n      ms: number;\n      isRateLimit: boolean;\n      isTimeout: boolean;\n      status?: number;\n      code?: string;\n      message: string;\n    };\n\nexport function getHttpStatus(e: any): number | undefined {\n  return (\n    e?.status ??\n    e?.response?.status ??\n    e?.response?.statusCode ??\n    e?.error?.status ??\n    e?.error?.response?.status ??\n    e?.body?.statusCode // sometimes present\n  );\n}\n\nexport function isRateLimitError(e: any): boolean {\n  const status = getHttpStatus(e);\n  if (status === 429 || status === 402) return true;\n\n  const msg = String(e?.message || e);\n  if (/error code:\\s*1015/i.test(msg)) return true; // Cloudflare\n  return /rate limit|too many requests|429|quota|throttl/i.test(msg);\n}\n\nexport function isServerError(e: any): boolean {\n  const status = getHttpStatus(e);\n  return status !== undefined && status >= 500;\n}\n\nexport function getRetryAfterMs(e: any): number | null {\n  const ra =\n    e?.response?.headers?.get?.('retry-after') ??\n    e?.response?.headers?.['retry-after'] ??\n    e?.headers?.['retry-after'];\n  const n = Number(ra);\n  return Number.isFinite(n) ? n * 1000 : null;\n}\n\nexport function isTimeoutError(e: any): boolean {\n  // ethers v5\n  if (e?.code === 'TIMEOUT') return true;\n\n  const status = getHttpStatus(e);\n  // some RPCs / proxies return 504 on timeout\n  if (status === 504) return true;\n\n  const msg = String(e?.message || e);\n\n  // node-fetch / undici / axios / nginx / generic\n  return /timeout|timed out|ETIMEDOUT|ESOCKETTIMEDOUT|ECONNABORTED|504 Gateway/i.test(msg);\n}\n\nexport function shouldFailover(e: any): boolean {\n  const to = isTimeoutError(e);\n  const rl = isRateLimitError(e);\n  const se = isServerError(e);\n\n  // failover on timeouts and rate limits, but not on logical errors (e.g. invalid params)\n  return to || rl || se;\n}\n","import {\n  JsonRpcProvider,\n  Network,\n  JsonRpcPayload,\n  FetchRequest,\n  JsonRpcApiProviderOptions,\n  Networkish,\n} from 'ethers';\nimport { Semaphore } from './Semaphore';\nimport { Stats } from './Stats';\nimport {\n  getHttpStatus,\n  getRetryAfterMs,\n  isRateLimitError,\n  isServerError,\n  isTimeoutError,\n  RpcEvent,\n} from './utils';\nimport { RpsLimiter } from './RpsLimiter';\n\nexport interface InstrumentedJsonRpcProviderOptions extends JsonRpcApiProviderOptions {\n  providerId: string;\n  stats: Stats;\n  inFlight?: number;\n  timeout?: number;\n  rps?: number;\n  rpsBurst?: number;\n  onEvent?: (e: RpcEvent) => void;\n}\n/**\n * Instrumented JsonRpcProvider.\n * Tracks requests, inFlight count, rate limits, and per-method / per-provider metrics.\n */\nexport class InstrumentedJsonRpcProvider extends JsonRpcProvider {\n  readonly providerId: string;\n  readonly chainId: bigint;\n  readonly options: InstrumentedJsonRpcProviderOptions;\n\n  readonly inFlightLimiter: Semaphore;\n  readonly rpsLimiter: RpsLimiter;\n  readonly stats: Stats;\n  readonly fetchRequest: FetchRequest;\n\n  private lastCooldownMs: number = 0;\n\n  constructor(\n    url: string | FetchRequest,\n    network: Networkish,\n    options: InstrumentedJsonRpcProviderOptions,\n  ) {\n    let fetchRequest: FetchRequest;\n\n    if (typeof url == 'string') {\n      fetchRequest = new FetchRequest(url);\n    } else {\n      fetchRequest = url;\n    }\n\n    fetchRequest.timeout = options.timeout || 10_000;\n\n    const _network = Network.from(network);\n    super(fetchRequest, _network, { staticNetwork: true, ...options });\n    this.fetchRequest = fetchRequest;\n    this.providerId = options.providerId;\n    this.chainId = _network.chainId;\n    this.options = options;\n\n    const { rps = 10, rpsBurst, inFlight = 1 } = options;\n\n    this.inFlightLimiter = new Semaphore(inFlight);\n    this.rpsLimiter = new RpsLimiter(rps, rpsBurst || rps);\n    this.stats = options.stats;\n  }\n\n  override async _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    await this.rpsLimiter.take(1);\n\n    const release = this.inFlightLimiter ? await this.inFlightLimiter.acquire() : undefined;\n\n    try {\n      return await this._sendInstrumented(payload);\n    } finally {\n      release?.();\n    }\n  }\n\n  // ethers v5 calls send(method, params)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private async _sendInstrumented(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<any> {\n    const startedAt = Date.now();\n    const payloads = Array.isArray(payload) ? payload : [payload];\n\n    this.stats.bumpInFlightPerProvider(this.providerId);\n    this.stats.bumpProviderTotal(this.providerId);\n\n    for (const p of payloads) {\n      this.stats.bumpPerMethod(p.method);\n      this.options.onEvent?.({\n        type: 'request',\n        chainId: this.chainId,\n        providerId: this.providerId,\n        method: p.method,\n        startedAt,\n      });\n    }\n\n    try {\n      const res = await super._send(payload);\n\n      const endedAt = Date.now();\n\n      for (const p of payloads) {\n        this.options.onEvent?.({\n          type: 'response',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n        });\n      }\n\n      this.lastCooldownMs = 0;\n\n      return res;\n    } catch (e: any) {\n      const endedAt = Date.now();\n      const rl = isRateLimitError(e);\n      if (rl) {\n        this.stats.bumpRateLimitedPerProvider(this.providerId);\n        const cooldownMs = 10_000;\n        const raMs = getRetryAfterMs(e) ?? cooldownMs;\n        this.stats.setCooldown(this.providerId, raMs);\n      }\n\n      const isTimeout = isTimeoutError(e);\n      if (isTimeout && !rl) {\n        this.stats.bumpTimeoutPerProvider(this.providerId);\n\n        const n = this.stats.snapshot().perProviderTotal[this.providerId] || 0;\n        const ratio = this.stats.timeoutRatio(this.providerId);\n\n        // thresholds: do not ban on a single timeout, only after enough data\n        if (n >= 50 && ratio >= 0.2) {\n          const cooldownMs = ratio >= 0.5 ? 600_000 : 60_000;\n          const raMs = getRetryAfterMs(e) ?? cooldownMs;\n          this.lastCooldownMs = raMs;\n          this.stats.setCooldown(this.providerId, raMs + Math.floor(Math.random() * 1000));\n        }\n      }\n\n      const isError = isServerError(e);\n      if (isError && !rl && !isTimeout) {\n        this.stats.bumpServerErrorPerProvider(this.providerId);\n        const cooldownMs = (this.lastCooldownMs * 2 || 10_000) + Math.floor(Math.random() * 1000);\n        this.lastCooldownMs = cooldownMs;\n        this.stats.setCooldown(this.providerId, cooldownMs);\n      }\n\n      for (const p of payloads) {\n        this.options.onEvent?.({\n          type: 'error',\n          chainId: this.chainId,\n          providerId: this.providerId,\n          method: p.method,\n          startedAt,\n          endedAt,\n          ms: endedAt - startedAt,\n          isRateLimit: rl,\n          isTimeout: isTimeout,\n          status: getHttpStatus(e),\n          code: e?.code,\n          message: String(e?.message || e),\n        });\n      }\n\n      throw e;\n    } finally {\n      this.stats.decreaseInFlightPerProvider(this.providerId);\n    }\n  }\n}\n","export class Semaphore {\n  private inUse = 0;\n  private queue: Array<() => void> = [];\n\n  constructor(private readonly max: number) {\n    if (!Number.isFinite(max) || max <= 0) {\n      throw new Error(`Semaphore max must be a positive number, got: ${max}`);\n    }\n  }\n\n  async acquire(): Promise<() => void> {\n    if (this.inUse < this.max) {\n      this.inUse++;\n      let released = false;\n      return () => {\n        if (released) return;\n        released = true;\n        this.release();\n      };\n    }\n\n    return new Promise<() => void>((resolve) => {\n      this.queue.push(() => {\n        this.inUse++;\n        let released = false;\n        resolve(() => {\n          if (released) return;\n          released = true;\n          this.release();\n        });\n      });\n    });\n  }\n\n  private release() {\n    this.inUse = Math.max(0, this.inUse - 1);\n    const next = this.queue.shift();\n    if (next) next();\n  }\n}\n","export class RpsLimiter {\n  // Current number of tokens in the bucket (can be fractional)\n  private tokens: number;\n\n  // Time of last token refill, in ms\n  private lastRefill = Date.now();\n\n  constructor(\n    // rps: how many tokens we add per second\n    private readonly rps: number,\n    // burst: maximum bucket capacity.\n    // Default: >=1 and approximately equal to rps (to allow a small burst)\n    private readonly burst: number = Math.max(1, Math.ceil(rps)),\n  ) {\n    // At start, the bucket is full: can make burst requests immediately\n    this.tokens = burst;\n  }\n\n  // Refill tokens according to elapsed time\n  private refill(now: number) {\n    // rps<=0 means \"limit is disabled\"\n    if (this.rps <= 0) return;\n\n    const elapsed = now - this.lastRefill; // ms since last refill\n    if (elapsed <= 0) return;\n\n    // How many tokens to add:\n    // elapsed/1000 = seconds, multiply by rps\n    const add = (elapsed / 1000) * this.rps;\n\n    // Add tokens, but don't exceed burst (bucket capacity)\n    this.tokens = Math.min(this.burst, this.tokens + add);\n\n    // Remember that we refilled tokens at time now\n    this.lastRefill = now;\n  }\n\n  // Take count tokens (usually 1 request = 1 token).\n  // If not enough tokens — wait and try again.\n  async take(count = 1): Promise<void> {\n    if (!this.rps || this.rps <= 0) return;\n\n    while (true) {\n      const now = Date.now();\n\n      // Before attempting — refill tokens\n      this.refill(now);\n\n      // If enough tokens — \"pay\" for the request and exit\n      if (this.tokens >= count) {\n        this.tokens -= count;\n        return;\n      }\n\n      // Not enough tokens: calculate how long to wait\n      const need = count - this.tokens;\n\n      // How many ms needed to accumulate need tokens:\n      // need / rps = seconds, *1000 = ms\n      const waitMs = Math.ceil((need / this.rps) * 1000);\n\n      // Wait in chunks (not all waitMs at once), to:\n      // - not sleep too long if time/state changed\n      // - be more resilient to timer drift\n      await new Promise((r) => setTimeout(r, Math.min(waitMs, 50)));\n    }\n  }\n}\n","import { Endpoint } from './utils';\nimport { Stats } from './Stats';\n\nexport class Router {\n  private rr = 0;\n\n  constructor(\n    private readonly endpoints: Endpoint[],\n    private readonly stats: Stats,\n  ) {}\n\n  size(): number {\n    return this.endpoints.length;\n  }\n\n  pick(): Endpoint {\n    const n = this.endpoints.length;\n    for (let k = 0; k < n; k++) {\n      const i = ((this.rr++ % n) + n) % n;\n      const ep = this.endpoints[i];\n\n      if (!this.stats.isInCooldown(ep.providerId)) return ep;\n    }\n    // if all are in cooldown, return the next one in round-robin order\n    return this.endpoints[((this.rr++ % n) + n) % n];\n  }\n}\n"],"mappings":"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","names":["JsonRpcProvider","Network","JsonRpcProvider","Network"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethers-rpc-pool",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "EVM RPC multiplexer for ethers.js with load balancing, rate limiting, failover and consistency controls.",
   "license": "MIT",
   "keywords": [
@@ -57,10 +57,8 @@
   },
   "devDependencies": {
     "@types/node": "^25.2.3",
-    "express": "^5.2.1",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
-    "msw": "^2.12.10",
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",