@lidofinance/api-rpc-proxy 1.0.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -31,11 +31,19 @@ registerRpcProxyRoutes(app, {
31
31
  allowedRPCMethods: ['eth_call', 'eth_getLogs', 'eth_chainId'],
32
32
  allowedCallAddresses: { 1: ['0x...'] },
33
33
  allowedLogsAddresses: { 1: ['0x...'] },
34
+ // the method list and both address lists are required; each can be 'any' to allow every
35
+ // method / address deliberately (e.g. user-deployed contracts)
34
36
  blockEmptyAddressGetLogs: true,
35
37
  maxBatchCount: 20,
36
38
  maxResponseSize: 1_000_000,
37
39
  },
38
40
  rateLimit: { max: 300, windowSec: 60 },
41
+ // optional: how long (ms) a /health probe result is reused, so repeated GETs do not each call
42
+ // every provider. 5 000 by default, 0 probes on every request.
43
+ healthCacheMs: 5_000,
44
+ // optional: per-provider time limit (ms) for the provider to start answering; a provider that
45
+ // exceeds it counts as failed and the next URL is tried. 10 000 by default, 0 turns it off.
46
+ upstreamTimeoutMs: 10_000,
39
47
  })
40
48
 
41
49
  await app.listen({ port: 3002 })
package/dist/index.cjs CHANGED
@@ -52,6 +52,17 @@ $parcel$export(module.exports, "registerRpcProxyRoutes", () => $91c84f984aa4e6af
52
52
 
53
53
 
54
54
 
55
+ const $de5e38af76816541$var$URL_PATTERN = /\b(?:https?|wss?):\/\/[^\s'"<>]+/gi;
56
+ const $de5e38af76816541$var$toHost = (url)=>{
57
+ try {
58
+ return new URL(url).hostname;
59
+ } catch {
60
+ return "<url>";
61
+ }
62
+ };
63
+ const $de5e38af76816541$export$dac76f5d4966dbe0 = (text)=>text.replace($de5e38af76816541$var$URL_PATTERN, $de5e38af76816541$var$toHost);
64
+
65
+
55
66
  var $50baca306c9e1fc2$exports = {};
56
67
 
57
68
  $parcel$export($50baca306c9e1fc2$exports, "DEFAULT_API_ERROR_MESSAGE", () => $50baca306c9e1fc2$export$c982278a0ddc4dbe);
@@ -87,6 +98,19 @@ class $50baca306c9e1fc2$export$e224c1080d950012 extends $50baca306c9e1fc2$export
87
98
  }
88
99
 
89
100
 
101
+ const $d68ede9964e6b015$export$66d7aef0343e6f4b = 10000;
102
+ const $d68ede9964e6b015$export$6d59a6fe1a73319b = async (timeoutMs, request)=>{
103
+ if (!(timeoutMs > 0)) return request();
104
+ const controller = new AbortController();
105
+ const timer = setTimeout(()=>controller.abort(new Error(`no response within ${timeoutMs} ms`)), timeoutMs);
106
+ try {
107
+ return await request(controller.signal);
108
+ } finally{
109
+ clearTimeout(timer);
110
+ }
111
+ };
112
+
113
+
90
114
 
91
115
 
92
116
 
@@ -94,6 +118,14 @@ class $50baca306c9e1fc2$export$e224c1080d950012 extends $50baca306c9e1fc2$export
94
118
  // root tsconfig (target es5) whenever a sibling package without its own tsconfig
95
119
  // runs `tsc`, and BigInt literal syntax requires an ES2020+ target to parse.
96
120
  const $fc26c06bc08587fb$var$zeroBN = BigInt(0);
121
+ const $fc26c06bc08587fb$var$HEX_BLOCK_NUMBER = /^0x[0-9a-fA-F]+$/;
122
+ // Tags that resolve within a few blocks of head, far below any sane maxGetLogsRange
123
+ const $fc26c06bc08587fb$var$NEAR_HEAD_BLOCK_TAGS = new Set([
124
+ "latest",
125
+ "safe",
126
+ "finalized",
127
+ "pending"
128
+ ]);
97
129
  const $fc26c06bc08587fb$export$564dd6c0fb12e680 = (defaultChain, providers, maxBatchSize)=>{
98
130
  return (req)=>{
99
131
  const rawChainId = Array.isArray(req.query.chainId) ? req.query.chainId[0] : req.query.chainId;
@@ -166,6 +198,8 @@ const $fc26c06bc08587fb$export$5d8ee2232a9cb21a = (allowedAddress, blockEmptyAdd
166
198
  }
167
199
  if (maxBlockRange) {
168
200
  if (fromBlock === "earliest") throw new (0, $50baca306c9e1fc2$export$2adbfa76b71ba748)(`RPC method eth_getLogs fromBlock is invalid`);
201
+ // Anything that is neither a hex number nor a near-head tag would skip the range check
202
+ if (!$fc26c06bc08587fb$var$HEX_BLOCK_NUMBER.test(fromBlock) && !$fc26c06bc08587fb$var$NEAR_HEAD_BLOCK_TAGS.has(fromBlock)) throw new (0, $50baca306c9e1fc2$export$2adbfa76b71ba748)(`RPC method eth_getLogs fromBlock is invalid`);
169
203
  if (fromBlock.startsWith("0x")) {
170
204
  const normalizedFromBlock = BigInt(fromBlock);
171
205
  let normalizedToBlock;
@@ -222,23 +256,30 @@ const $fc26c06bc08587fb$var$createAllowedAddressMap = (allowedAddress)=>Object.e
222
256
  }, {});
223
257
 
224
258
 
225
- const $c36759493dc2a380$export$9bfcc39f106ad871 = ({ providers: providers, fetchRPC: fetchRPC, defaultChain: defaultChain, validation: validation, serverLogger: serverLogger = console, metrics: metrics })=>{
259
+ const $c36759493dc2a380$export$9bfcc39f106ad871 = ({ providers: providers, fetchRPC: fetchRPC, defaultChain: defaultChain, validation: validation, serverLogger: serverLogger = console, metrics: metrics, upstreamTimeoutMs: upstreamTimeoutMs = (0, $d68ede9964e6b015$export$66d7aef0343e6f4b) })=>{
226
260
  const { allowedRPCMethods: allowedRPCMethods, allowedCallAddresses: allowedCallAddresses, allowedLogsAddresses: allowedLogsAddresses, maxResponseSize: maxResponseSize = 1000000, maxBatchCount: maxBatchCount = 20, currentBlockTTLms: currentBlockTTLms = 60000, maxGetLogsRange: maxGetLogsRange = 20000, blockEmptyAddressGetLogs: blockEmptyAddressGetLogs = true } = validation;
261
+ // 'any' is an explicit opt-out: no method / address check
262
+ const rpcMethods = allowedRPCMethods === "any" ? undefined : allowedRPCMethods;
263
+ const callAddresses = allowedCallAddresses === "any" ? undefined : allowedCallAddresses;
264
+ const logsAddresses = allowedLogsAddresses === "any" ? undefined : allowedLogsAddresses;
227
265
  const rpcRequestBlocked = metrics?.rpcRequestBlocked ?? {
228
266
  inc: (_labels)=>{}
229
267
  };
230
268
  const rpcRequestMethods = metrics?.rpcRequestMethods;
231
269
  const validateBaseRequest = (0, $fc26c06bc08587fb$export$564dd6c0fb12e680)(defaultChain, providers, maxBatchCount);
232
- const validateRpcMethod = (0, $fc26c06bc08587fb$export$bd57dbd3bc9a1cc6)(allowedRPCMethods);
233
- const validateEthCall = allowedCallAddresses && (0, $fc26c06bc08587fb$export$e67f820dcb2fefda)("eth_call", allowedRPCMethods) ? (0, $fc26c06bc08587fb$export$b724143801441d66)(allowedCallAddresses) : undefined;
234
- const validateEthGetLogs = (allowedLogsAddresses || blockEmptyAddressGetLogs) && (0, $fc26c06bc08587fb$export$e67f820dcb2fefda)("eth_getLogs", allowedRPCMethods) ? (0, $fc26c06bc08587fb$export$5d8ee2232a9cb21a)(allowedLogsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms) : undefined;
270
+ const validateRpcMethod = (0, $fc26c06bc08587fb$export$bd57dbd3bc9a1cc6)(rpcMethods);
271
+ const validateEthCall = callAddresses && (0, $fc26c06bc08587fb$export$e67f820dcb2fefda)("eth_call", rpcMethods) ? (0, $fc26c06bc08587fb$export$b724143801441d66)(callAddresses) : undefined;
272
+ const validateEthGetLogs = (logsAddresses || blockEmptyAddressGetLogs) && (0, $fc26c06bc08587fb$export$e67f820dcb2fefda)("eth_getLogs", rpcMethods) ? (0, $fc26c06bc08587fb$export$5d8ee2232a9cb21a)(logsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms) : undefined;
235
273
  const validateMaxSteamSize = (0, $fc26c06bc08587fb$export$7c5a2292697deb4b)(maxResponseSize);
236
- const requestRPC = (chainId, body)=>(0, $jf5wi$lidofinancerpc.iterateUrls)(providers[chainId], (url)=>fetchRPC(url, {
237
- body: body
238
- }, {
239
- chainId: chainId
240
- }), (error)=>{
241
- const message = error instanceof Error ? error.message : String(error);
274
+ const requestRPC = (chainId, body)=>(0, $jf5wi$lidofinancerpc.iterateUrls)(providers[chainId], (url)=>(0, $d68ede9964e6b015$export$6d59a6fe1a73319b)(upstreamTimeoutMs, (signal)=>fetchRPC(url, {
275
+ body: body,
276
+ ...signal ? {
277
+ signal: signal
278
+ } : {}
279
+ }, {
280
+ chainId: chainId
281
+ })), (error)=>{
282
+ const message = (0, $de5e38af76816541$export$dac76f5d4966dbe0)(error instanceof Error ? error.message : String(error));
242
283
  serverLogger.warn(`[rpcFactory] provider failed for chain ${chainId}: ${message}`);
243
284
  });
244
285
  return async (request, reply)=>{
@@ -259,15 +300,33 @@ const $c36759493dc2a380$export$9bfcc39f106ad871 = ({ providers: providers, fetch
259
300
  if (req.method === "eth_getLogs" && validateEthGetLogs) await validateEthGetLogs(req, validationContext);
260
301
  }
261
302
  const proxiedRPC = await requestRPC(chainId, request.body);
303
+ // iterateUrls returns the last response when no provider answered ok;
304
+ // never relay a provider's error body to the client as a success.
305
+ if (!proxiedRPC.ok) {
306
+ await proxiedRPC.body?.cancel().catch(()=>undefined);
307
+ reply.status(502).send((0, $50baca306c9e1fc2$export$c982278a0ddc4dbe));
308
+ return;
309
+ }
310
+ // Reject a declared oversized body before streaming starts — once bytes are on the
311
+ // wire the status can no longer change and the stream is only cut short.
312
+ const contentLength = Number(proxiedRPC.headers.get("content-length"));
313
+ if (contentLength > maxResponseSize) {
314
+ await proxiedRPC.body?.cancel().catch(()=>undefined);
315
+ rpcRequestBlocked.inc({
316
+ reason: "response too large"
317
+ });
318
+ throw new (0, $50baca306c9e1fc2$export$e224c1080d950012)(`Stream size exceeds the maximum limit of ${maxResponseSize} bytes`);
319
+ }
262
320
  reply.header("content-type", proxiedRPC.headers.get("content-type") ?? "application/json");
263
321
  if (!proxiedRPC.body) throw new Error("There are problems with RPC provider");
264
322
  await (0, $jf5wi$nodestreampromises.pipeline)((0, $jf5wi$nodestream.Readable).fromWeb(proxiedRPC.body), validateMaxSteamSize(validationContext), reply.raw, {
265
323
  signal: abortController.signal
266
324
  });
267
325
  } catch (error) {
268
- if (error instanceof (0, $50baca306c9e1fc2$export$bb8c263ad32caa8)) reply.status(400).send(error.message ?? (0, $50baca306c9e1fc2$export$c982278a0ddc4dbe));
269
- else if (error instanceof Error) {
270
- serverLogger.error("[rpcFactory] " + (error.message ?? (0, $50baca306c9e1fc2$export$c982278a0ddc4dbe)));
326
+ if (error instanceof (0, $50baca306c9e1fc2$export$bb8c263ad32caa8)) {
327
+ if (!reply.raw.headersSent) reply.status(error instanceof (0, $50baca306c9e1fc2$export$e224c1080d950012) ? 413 : 400).send(error.message ?? (0, $50baca306c9e1fc2$export$c982278a0ddc4dbe));
328
+ } else if (error instanceof Error) {
329
+ serverLogger.error("[rpcFactory] " + (0, $de5e38af76816541$export$dac76f5d4966dbe0)(error.message ?? (0, $50baca306c9e1fc2$export$c982278a0ddc4dbe)));
271
330
  if (!reply.sent) reply.status(500).send((0, $50baca306c9e1fc2$export$c982278a0ddc4dbe));
272
331
  } else reply.status(500).send((0, $50baca306c9e1fc2$export$56a189db5508cdcb));
273
332
  } finally{
@@ -357,6 +416,7 @@ const $ed77a7c0d430b773$export$d4d313c44e137fbd = ({ max: max, windowSec: window
357
416
 
358
417
 
359
418
 
419
+
360
420
  const $197799e10b2d45f5$var$DEFAULT_HEALTH_TIMEOUT_MS = 5000;
361
421
  const $197799e10b2d45f5$export$b1f76e97540655f3 = async (providers, { fetchRPC: fetchRPC, timeoutMs: timeoutMs = $197799e10b2d45f5$var$DEFAULT_HEALTH_TIMEOUT_MS, onResult: onResult, logger: logger = console })=>{
362
422
  const results = await Promise.all(Object.entries(providers).map(async ([chainId, urls])=>{
@@ -376,8 +436,8 @@ const $197799e10b2d45f5$export$b1f76e97540655f3 = async (providers, { fetchRPC:
376
436
  const { result: result } = await response.json();
377
437
  return response.ok && result != null;
378
438
  } catch (error) {
379
- const reason = error instanceof Error ? error.message : String(error);
380
- logger.warn(`[health] probe failed for chain ${chainId} url ${url}: ${reason}`);
439
+ const reason = (0, $de5e38af76816541$export$dac76f5d4966dbe0)(error instanceof Error ? error.message : String(error));
440
+ logger.warn(`[health] probe failed for chain ${chainId} provider ${(0, $de5e38af76816541$export$dac76f5d4966dbe0)(url)}: ${reason}`);
381
441
  return false;
382
442
  }
383
443
  }));
@@ -485,8 +545,9 @@ const $325c7c1d154acf14$export$b3e9bcd4083b83c6 = ({ prefix: prefix, registry: r
485
545
 
486
546
 
487
547
 
548
+ const $91c84f984aa4e6af$var$DEFAULT_HEALTH_CACHE_MS = 5000;
488
549
  const $91c84f984aa4e6af$export$be56850439a72159 = (app, options)=>{
489
- const { providers: providers, defaultChain: defaultChain, fetchRPC: fetchRPC, metrics: metrics, validation: validation, rateLimit: rateLimit, healthTimeoutMs: healthTimeoutMs, serverLogger: serverLogger } = options;
550
+ const { providers: providers, defaultChain: defaultChain, fetchRPC: fetchRPC, metrics: metrics, validation: validation, rateLimit: rateLimit, healthTimeoutMs: healthTimeoutMs, healthCacheMs: healthCacheMs = $91c84f984aa4e6af$var$DEFAULT_HEALTH_CACHE_MS, upstreamTimeoutMs: upstreamTimeoutMs, serverLogger: serverLogger } = options;
490
551
  // Route label uses the matched route template (e.g. "/rpc"), not request.url —
491
552
  // avoid request.url here because unmatched URLs (404s) can blow up label
492
553
  // cardinality, hence the 'unknown' fallback instead. status is the aggregated
@@ -499,8 +560,12 @@ const $91c84f984aa4e6af$export$be56850439a72159 = (app, options)=>{
499
560
  }, reply.elapsedTime / 1000);
500
561
  done();
501
562
  });
502
- app.get("/health", async (_req, reply)=>{
503
- const checks = await (0, $197799e10b2d45f5$export$b1f76e97540655f3)(providers, {
563
+ // A probe in flight is shared by every request that arrives meanwhile, and its result is
564
+ // reused for healthCacheMs after it settles, so /health cannot be used to multiply upstream calls.
565
+ let cachedProbe;
566
+ const probe = ()=>{
567
+ if (cachedProbe && Date.now() < cachedProbe.expiresAt) return cachedProbe.checks;
568
+ const checks = (0, $197799e10b2d45f5$export$b1f76e97540655f3)(providers, {
504
569
  fetchRPC: fetchRPC,
505
570
  timeoutMs: healthTimeoutMs,
506
571
  onResult: ({ chainId: chainId, ok: ok })=>metrics.rpcChainReachable.set({
@@ -508,6 +573,18 @@ const $91c84f984aa4e6af$export$be56850439a72159 = (app, options)=>{
508
573
  }, ok ? 1 : 0),
509
574
  logger: serverLogger
510
575
  });
576
+ if (healthCacheMs > 0) {
577
+ const entry = {
578
+ checks: checks,
579
+ expiresAt: Infinity
580
+ };
581
+ cachedProbe = entry;
582
+ checks.then(()=>entry.expiresAt = Date.now() + healthCacheMs, ()=>entry.expiresAt = 0);
583
+ }
584
+ return checks;
585
+ };
586
+ app.get("/health", async (_req, reply)=>{
587
+ const checks = await probe();
511
588
  const healthy = checks.every((c)=>c.ok);
512
589
  // Structured JSON (status code still carries the pass/fail signal for simple
513
590
  // probes like a Dockerfile's `wget --spider`) so infra/dashboards hitting this
@@ -533,7 +610,8 @@ const $91c84f984aa4e6af$export$be56850439a72159 = (app, options)=>{
533
610
  rpcRequestMethods: metrics.rpcRequestMethods
534
611
  },
535
612
  validation: validation,
536
- serverLogger: serverLogger
613
+ serverLogger: serverLogger,
614
+ upstreamTimeoutMs: upstreamTimeoutMs
537
615
  });
538
616
  const rpcRateLimit = (0, $ed77a7c0d430b773$export$d4d313c44e137fbd)({
539
617
  max: rateLimit.max,
@@ -1 +1 @@
1
- {"mappings":"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","sources":["packages/api/rpc-proxy/src/index.ts","packages/api/rpc-proxy/src/rpcFactory/rpcFactory.ts","packages/api/rpc-proxy/src/rpcFactory/errors.ts","packages/api/rpc-proxy/src/rpcFactory/validation.ts","packages/api/rpc-proxy/src/rpcFactory/types.ts","packages/api/rpc-proxy/src/rateLimit/rateLimit.ts","packages/api/rpc-proxy/src/rateLimit/constants.ts","packages/api/rpc-proxy/src/rateLimit/fixedWindowStore.ts","packages/api/rpc-proxy/src/rateLimit/getClientIp.ts","packages/api/rpc-proxy/src/health.ts","packages/api/rpc-proxy/src/metrics.ts","packages/api/rpc-proxy/src/routes.ts"],"sourcesContent":["export { rpcFactory } from './rpcFactory/rpcFactory'\nexport * from './rpcFactory/types'\nexport * from './rpcFactory/errors'\nexport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './rpcFactory/validation'\n\nexport { createRateLimitHook } from './rateLimit/rateLimit'\nexport type { RateLimitOptions } from './rateLimit/rateLimit'\nexport { FixedWindowStore } from './rateLimit/fixedWindowStore'\nexport { getClientIp, normalizeIp } from './rateLimit/getClientIp'\nexport { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './rateLimit/constants'\n\nexport { probeChains } from './health'\nexport type { ChainProbeResult, ProbeChainsOptions } from './health'\n\nexport { createRpcProxyMetrics } from './metrics'\nexport type { CreateRpcProxyMetricsOptions, RpcProxyMetrics } from './metrics'\n\nexport { registerRpcProxyRoutes } from './routes'\nexport type { RegisterRpcProxyRoutesOptions } from './routes'\n","// RPC proxy factory adapted from the @lidofinance/next-api-wrapper rpcFactory pattern\n// (https://github.com/lidofinance/lido-frontend-template).\n// Changes from the original:\n// - Ported from Next.js API routes to Fastify request handlers\n// - Added per-chain contract-address allowlist (eth_call / eth_getLogs restriction)\n// - Integrated @lidofinance/api-rpc trackedFetchRpcFactory for prom-client metrics\nimport { Readable } from 'node:stream'\nimport { pipeline } from 'node:stream/promises'\nimport { ReadableStream } from 'node:stream/web'\nimport { iterateUrls } from '@lidofinance/rpc'\n\nimport { ClientError, DEFAULT_API_ERROR_MESSAGE, HEALTHY_RPC_SERVICES_ARE_OVER } from './errors'\n\nimport type { RPCFactoryParams } from './types'\nimport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './validation'\nimport type { FetchRpcInitBody } from '@lidofinance/rpc'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\ntype RpcQuery = { chainId?: string }\n\nexport const rpcFactory = ({\n providers,\n fetchRPC,\n defaultChain,\n validation,\n serverLogger = console,\n metrics,\n}: RPCFactoryParams) => {\n const {\n allowedRPCMethods,\n allowedCallAddresses,\n allowedLogsAddresses,\n maxResponseSize = 1_000_000,\n maxBatchCount = 20,\n currentBlockTTLms = 60_000,\n maxGetLogsRange = 20_000,\n blockEmptyAddressGetLogs = true,\n } = validation\n\n const rpcRequestBlocked = metrics?.rpcRequestBlocked ?? {\n inc: (_labels: { reason: string }) => {},\n }\n const rpcRequestMethods = metrics?.rpcRequestMethods\n\n const validateBaseRequest = baseRequestValidationFactory(defaultChain, providers, maxBatchCount)\n const validateRpcMethod = rpcMethodsValidationFactory(allowedRPCMethods)\n\n const validateEthCall =\n allowedCallAddresses && shouldValidateRpcMethod('eth_call', allowedRPCMethods)\n ? ethCallValidationFactory(allowedCallAddresses)\n : undefined\n\n const validateEthGetLogs =\n (allowedLogsAddresses || blockEmptyAddressGetLogs) && shouldValidateRpcMethod('eth_getLogs', allowedRPCMethods)\n ? ethGetLogsValidationFactory(allowedLogsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms)\n : undefined\n\n const validateMaxSteamSize = streamMaxSizeValidationFactory(maxResponseSize)\n\n const requestRPC = (chainId: number, body: FetchRpcInitBody) =>\n iterateUrls(\n providers[chainId],\n (url: string) => fetchRPC(url, { body }, { chainId }),\n (error: unknown) => {\n const message = error instanceof Error ? error.message : String(error)\n serverLogger.warn(`[rpcFactory] provider failed for chain ${chainId}: ${message}`)\n },\n )\n\n return async (request: FastifyRequest<{ Querystring: RpcQuery }>, reply: FastifyReply): Promise<void> => {\n const abortController = new AbortController()\n try {\n const { chainId, requests } = validateBaseRequest(request)\n\n const validationContext = { chainId, rpcRequestBlocked, requestRPC }\n\n for (const req of requests) {\n validateRpcMethod(req, validationContext)\n rpcRequestMethods?.inc({ method: req.method })\n\n if (req.method === 'eth_call' && validateEthCall) {\n validateEthCall(req, validationContext)\n }\n if (req.method === 'eth_getLogs' && validateEthGetLogs) {\n await validateEthGetLogs(req, validationContext)\n }\n }\n\n const proxiedRPC = await requestRPC(chainId, request.body as FetchRpcInitBody)\n\n void reply.header('content-type', proxiedRPC.headers.get('content-type') ?? 'application/json')\n\n if (!proxiedRPC.body) {\n throw new Error('There are problems with RPC provider')\n }\n\n await pipeline(\n Readable.fromWeb(proxiedRPC.body as ReadableStream),\n validateMaxSteamSize(validationContext),\n reply.raw,\n { signal: abortController.signal },\n )\n } catch (error) {\n if (error instanceof ClientError) {\n void reply.status(400).send(error.message ?? DEFAULT_API_ERROR_MESSAGE)\n } else if (error instanceof Error) {\n serverLogger.error('[rpcFactory] ' + (error.message ?? DEFAULT_API_ERROR_MESSAGE))\n if (!reply.sent) {\n void reply.status(500).send(DEFAULT_API_ERROR_MESSAGE)\n }\n } else {\n void reply.status(500).send(HEALTHY_RPC_SERVICES_ARE_OVER)\n }\n } finally {\n abortController.abort()\n }\n }\n}\n","export const DEFAULT_API_ERROR_MESSAGE = 'Something went wrong. Sorry, try again later :('\n\nexport const HEALTHY_RPC_SERVICES_ARE_OVER = 'Healthy RPC services are over!'\n\nexport class ClientError extends Error {}\n\nexport class UnsupportedChainIdError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported chainId')\n }\n}\n\nexport class UnsupportedHTTPMethodError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported HTTP method')\n }\n}\n\nexport class InvalidRequestError extends ClientError {\n constructor(message?: string) {\n super(message || 'Invalid Request')\n }\n}\n\nexport class SizeTooLargeError extends ClientError {\n constructor(message?: string) {\n super(message || 'Response size too large')\n }\n}\n","import { Transform } from 'node:stream'\n\nimport { Cache } from 'memory-cache'\n\nimport { ClientError, InvalidRequestError, SizeTooLargeError, UnsupportedChainIdError } from './errors'\n\nimport type { RpcRequest, ValidationContext } from './types'\n\ntype BaseRequest = {\n query: { chainId?: string | string[] }\n body: unknown\n}\n\n// BigInt(0), not a 0n literal — this file is type-checked under the repo's shared\n// root tsconfig (target es5) whenever a sibling package without its own tsconfig\n// runs `tsc`, and BigInt literal syntax requires an ES2020+ target to parse.\nconst zeroBN = BigInt(0)\n\nexport const baseRequestValidationFactory = (\n defaultChain: number | string,\n providers: Record<string, unknown>,\n maxBatchSize?: number,\n) => {\n return (req: BaseRequest) => {\n const rawChainId = Array.isArray(req.query.chainId) ? req.query.chainId[0] : req.query.chainId\n\n const chainId = Number(rawChainId || defaultChain)\n\n if (providers[chainId] == null) {\n throw new UnsupportedChainIdError()\n }\n\n const requests = Array.isArray(req.body) ? req.body : [req.body]\n\n if (typeof maxBatchSize === 'number' && requests.length > maxBatchSize) {\n throw new InvalidRequestError(`Too many batched requests`)\n }\n return { chainId, requests }\n }\n}\n\nexport const rpcMethodsValidationFactory = (allowedMethods?: string[]) => {\n const methodsMap = new Set(allowedMethods ?? [])\n\n return (request: RpcRequest, context: ValidationContext) => {\n const method = request.method\n if (typeof method !== 'string') {\n throw new InvalidRequestError(`RPC method isn't string`)\n }\n if (allowedMethods && !methodsMap.has(request.method)) {\n context.rpcRequestBlocked.inc({ reason: 'method not allowed' })\n throw new InvalidRequestError(`RPC method ${method} not allowed`)\n }\n }\n}\n\nexport const ethCallValidationFactory = (allowedAddress: Record<number, string[]>) => {\n const allowedCallAddressMap = createAllowedAddressMap(allowedAddress)\n\n return (request: RpcRequest, { chainId, rpcRequestBlocked }: ValidationContext) => {\n const { params } = request\n\n // Explicitly reject any request whose first param is not a well-formed tx object.\n // Using an early-return guard keeps the \"address allowed?\" check unconditionally\n // reachable and prevents future edits to the condition from accidentally creating\n // a path that forwards an unvalidated eth_call.\n const txObject = Array.isArray(params) ? params[0] : undefined\n\n if (\n txObject == null ||\n typeof txObject !== 'object' ||\n !('to' in txObject) ||\n typeof (txObject as Record<string, unknown>).to !== 'string'\n ) {\n throw new InvalidRequestError(`RPC method eth_call is invalid`)\n }\n\n const toAddress = (txObject as { to: string }).to\n\n if (!allowedCallAddressMap[chainId]?.has(toAddress.toLowerCase())) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_call' })\n throw new InvalidRequestError(`Address not allowed for eth_call`)\n }\n }\n}\n\nexport const ethGetLogsValidationFactory = (\n allowedAddress: Record<number, string[]> | undefined,\n blockEmptyAddressGetLogs: boolean | undefined,\n maxBlockRange: number | undefined,\n currentBlockTTL = 60_000,\n) => {\n const allowedAddressMap = createAllowedAddressMap(allowedAddress ?? {})\n const maxBlockRangeBN = maxBlockRange ? BigInt(maxBlockRange) : zeroBN\n const currentBlock = new Cache<number, bigint>()\n\n return async (request: RpcRequest, { chainId, rpcRequestBlocked, requestRPC }: ValidationContext) => {\n try {\n const params = request.params[0] as any\n const fromBlock: string = params.fromBlock\n const toBlock: string = params.toBlock ?? 'latest'\n\n if (blockEmptyAddressGetLogs || allowedAddress) {\n const address: string | string[] = params.address\n\n if (blockEmptyAddressGetLogs && !address)\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n\n const addresses = Array.isArray(address) ? address : [address]\n\n if (blockEmptyAddressGetLogs && addresses.length === 0) {\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n }\n if (\n allowedAddress &&\n addresses.some(\n (eventAddress) =>\n typeof eventAddress !== 'string' || !allowedAddressMap[chainId]?.has(eventAddress.toLowerCase()),\n )\n ) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_getLogs' })\n throw new InvalidRequestError(`Address not allowed for eth_getLogs`)\n }\n }\n\n if (maxBlockRange) {\n if (fromBlock === 'earliest') throw new InvalidRequestError(`RPC method eth_getLogs fromBlock is invalid`)\n\n if (fromBlock.startsWith('0x')) {\n const normalizedFromBlock = BigInt(fromBlock)\n let normalizedToBlock: bigint\n\n if (toBlock.startsWith('0x')) {\n normalizedToBlock = BigInt(toBlock)\n } else {\n const cached = currentBlock.get(chainId)\n if (cached) {\n normalizedToBlock = cached\n } else {\n normalizedToBlock = await requestRPC(chainId, {\n id: 1,\n jsonrpc: '2.0',\n method: 'eth_blockNumber',\n })\n .then((res) => res.json() as Promise<{ result: string }>)\n .then((res) => BigInt(res.result))\n currentBlock.put(chainId, normalizedToBlock, currentBlockTTL)\n }\n }\n\n const range = normalizedToBlock - normalizedFromBlock\n if (range < zeroBN || range > maxBlockRangeBN) {\n rpcRequestBlocked.inc({ reason: 'eth_getLogs range is invalid' })\n throw new InvalidRequestError(`RPC method eth_getLogs range is invalid`)\n }\n }\n }\n } catch (error) {\n if (error instanceof ClientError) throw error\n throw new InvalidRequestError(`RPC method eth_getLogs is invalid`)\n }\n }\n}\n\nexport const streamMaxSizeValidationFactory = (MAX_SIZE: number) => (context: ValidationContext) => {\n let bytesWritten = 0\n return new Transform({\n transform(chunk, _encoding, callback) {\n bytesWritten += chunk.length\n if (bytesWritten > MAX_SIZE) {\n context.rpcRequestBlocked.inc({ reason: 'response too large' })\n return callback(new SizeTooLargeError(`Stream size exceeds the maximum limit of ${MAX_SIZE} bytes`))\n }\n return callback(null, chunk)\n },\n flush(callback) {\n callback()\n },\n })\n}\n\n// utils\n\nexport const shouldValidateRpcMethod = (method: string, allowedRPCMethods?: string[]) =>\n !allowedRPCMethods || allowedRPCMethods.includes(method)\n\nconst createAllowedAddressMap = (allowedAddress: Record<number, string[]>) =>\n Object.entries(allowedAddress).reduce((acc, [chainId, addresses]) => {\n acc[chainId] = new Set(addresses.map((a) => a.toLowerCase()))\n return acc\n }, {} as Record<string, Set<string>>)\n","import type { FetchRpcInit, FetchRpcInitBody } from '@lidofinance/rpc'\n\nexport type RpcProviders = Record<string | number, [string, ...string[]]>\n\nexport type RPCFactoryValidationParams = {\n maxBatchCount?: number\n maxResponseSize?: number\n allowedRPCMethods?: string[]\n allowedCallAddresses?: Record<number, string[]>\n allowedLogsAddresses?: Record<number, string[]>\n blockEmptyAddressGetLogs?: boolean\n maxGetLogsRange?: number\n currentBlockTTLms?: number\n}\n\nexport type FetchRPC = (url: string, init: FetchRpcInit, meta: { chainId: number | string }) => Promise<Response>\n\nexport type RPCFactoryMetrics = {\n rpcRequestBlocked: RpcRequestBlockedCounter\n rpcRequestMethods?: { inc(labels: { method: string }): void }\n}\n\nexport type RPCFactoryParams = {\n providers: RpcProviders\n fetchRPC: FetchRPC\n defaultChain: string | number\n validation: RPCFactoryValidationParams\n serverLogger?: Pick<Console, 'warn' | 'error'>\n metrics?: RPCFactoryMetrics\n}\n\nexport type RpcRequest = {\n method: string\n params: unknown[]\n}\n\nexport type RpcRequestBlockedCounter = {\n inc(labels: { reason: string }): void\n}\n\nexport type ValidationContext = {\n chainId: number\n rpcRequestBlocked: RpcRequestBlockedCounter\n requestRPC: (chainId: number, body: FetchRpcInitBody) => Promise<Response>\n}\n","import { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './constants'\nimport { FixedWindowStore } from './fixedWindowStore'\nimport { getClientIp } from './getClientIp'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\nexport type RateLimitOptions = {\n max: number\n windowSec: number\n customIpHeader?: string\n onBlocked?: (ip: string) => void\n}\n\n// Fixed-window per-IP limiter, adapted as a Fastify preHandler from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit\n// (a Next.js API-route wrapper — this repo has no Next.js, so the counting\n// and IP-extraction ideas are ported by hand rather than installed).\n// One store instance per createRateLimitHook call — call it once per route so\n// separate routes (e.g. /rpc and /api/csp-report) don't share a budget.\nexport const createRateLimitHook = ({ max, windowSec, customIpHeader, onBlocked }: RateLimitOptions) => {\n const store = new FixedWindowStore()\n\n return async (req: FastifyRequest, reply: FastifyReply): Promise<void> => {\n const ip = getClientIp(req, customIpHeader)\n const now = Date.now() / 1000\n const window = Math.floor(now / windowSec)\n const key = `${ip}:${window}`\n\n const count = store.increment(key, windowSec)\n const remaining = max - count\n const reset = (window + 1) * windowSec\n\n void reply.header(RATE_LIMIT_HEADERS.limit, String(max))\n void reply.header(RATE_LIMIT_HEADERS.remaining, String(Math.max(remaining, 0)))\n void reply.header(RATE_LIMIT_HEADERS.reset, String(reset))\n\n if (remaining < 0) {\n const retryAfter = Math.max(Math.ceil(reset - now), 0)\n void reply.header('Retry-After', String(retryAfter))\n onBlocked?.(ip)\n void reply.status(429).send(`${RATE_LIMIT_ERROR_MESSAGE} for ip:${ip}`)\n }\n }\n}\n","export const RATE_LIMIT_HEADERS = {\n limit: 'X-RateLimit-Limit',\n remaining: 'X-RateLimit-Remaining',\n reset: 'X-RateLimit-Reset',\n} as const\n\nexport const RATE_LIMIT_ERROR_MESSAGE = 'Rate limit exceeded'\n","type StoreEntry = { value: number; timeoutId: NodeJS.Timeout }\n\n// Fixed-window counter: each key auto-expires durationSec after it was last\n// touched, so no separate sweep/cron is needed to bound memory. Adapted from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/storage.ts,\n// itself based on nestjs/throttler's setTimeout-per-key approach.\nexport class FixedWindowStore {\n private store = new Map<string, StoreEntry>()\n\n private set(key: string, value: number, durationSec: number) {\n clearTimeout(this.store.get(key)?.timeoutId)\n\n const timeoutId = setTimeout(() => this.store.delete(key), durationSec * 1000)\n // This is a cache-eviction timer, not pending work — it must not keep the\n // process alive on its own (matters for a long-running server, unlike the\n // serverless functions the ported design originally ran in).\n timeoutId.unref()\n\n this.store.set(key, { value, timeoutId })\n }\n\n get(key: string): number | undefined {\n return this.store.get(key)?.value\n }\n\n increment(key: string, durationSec: number): number {\n const next = (this.get(key) ?? 0) + 1\n this.set(key, next, durationSec)\n return next\n }\n}\n","import { isIP } from 'node:net'\nimport type { FastifyRequest } from 'fastify'\n\nexport const normalizeIp = (ip: string): string => ip.trim().replace(/^::ffff:/i, '')\n\nconst firstValidIp = (value: string | string[] | undefined): string | undefined => {\n const raw = Array.isArray(value) ? value[0] : value\n if (!raw) return undefined\n const candidate = normalizeIp(raw.split(',')[0] ?? '')\n return candidate && isIP(candidate) ? candidate : undefined\n}\n\n// req.ip is already the right answer for X-Forwarded-For: Fastify's trustProxy\n// option (see server/index.ts, set to TRUSTED_PROXY_HOPS) walks exactly that\n// many hops back through the header via @fastify/proxy-addr, which is the\n// correct way to find the real client through this app's one nginx hop. X-\n// Forwarded-For is never read directly here — a client can set that header to\n// anything, and only Fastify's hop-counted view of it is trustworthy.\n//\n// customIpHeader is for an edge/CDN in front of nginx (e.g. Cloudflare's\n// cf-connecting-ip) that knows the client's IP authoritatively, independent of\n// hop counting. It's validated with isIP so a spoofed or garbage value falls\n// through to req.ip instead of being trusted blindly — ported from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/utils.ts,\n// adapted from Next's per-request customIpHeader to Fastify + trustProxy.\nexport const getClientIp = (req: FastifyRequest, customIpHeader?: string): string => {\n const customIp = customIpHeader ? firstValidIp(req.headers[customIpHeader.toLowerCase()]) : undefined\n\n return customIp ?? normalizeIp(req.ip || '0.0.0.0')\n}\n","import type { FetchRPC, RpcProviders } from './rpcFactory/types'\n\nexport type ChainProbeResult = { chainId: string; ok: boolean }\n\nexport type ProbeChainsOptions = {\n fetchRPC: FetchRPC\n timeoutMs?: number\n onResult?: (result: ChainProbeResult) => void\n logger?: Pick<Console, 'warn'>\n}\n\nconst DEFAULT_HEALTH_TIMEOUT_MS = 5_000\n\n// Probes every configured URL per chain in parallel — matching the runtime fallback\n// semantics of iterateUrls in rpcFactory. A chain is healthy when at least one URL\n// responds, so a single-provider outage doesn't fail a proxy that has working fallbacks.\nexport const probeChains = async (\n providers: RpcProviders,\n { fetchRPC, timeoutMs = DEFAULT_HEALTH_TIMEOUT_MS, onResult, logger = console }: ProbeChainsOptions,\n): Promise<ChainProbeResult[]> => {\n const results = await Promise.all(\n Object.entries(providers).map(async ([chainId, urls]) => {\n const urlResults = await Promise.all(\n urls.map(async (url) => {\n try {\n const response = await fetchRPC(\n url,\n {\n body: { id: 1, jsonrpc: '2.0', method: 'eth_blockNumber', params: [] },\n signal: AbortSignal.timeout(timeoutMs),\n },\n { chainId },\n )\n const { result } = (await response.json()) as { result?: unknown }\n return response.ok && result != null\n } catch (error) {\n const reason = error instanceof Error ? error.message : String(error)\n logger.warn(`[health] probe failed for chain ${chainId} url ${url}: ${reason}`)\n return false\n }\n }),\n )\n const ok = urlResults.some(Boolean)\n return { chainId, ok }\n }),\n )\n for (const result of results) {\n onResult?.(result)\n }\n return results\n}\n","import { trackedFetchRpcFactory } from '@lidofinance/api-rpc'\nimport { Counter, Gauge, Histogram, Registry, collectDefaultMetrics } from 'prom-client'\n\nimport type { FetchRPC } from './rpcFactory/types'\n\nexport type RpcProxyMetrics = {\n registry: Registry\n fetchRPC: FetchRPC\n rpcRequestBlocked: Counter<'reason'>\n rpcRequestMethods: Counter<'method'>\n rateLimitBlockedCount: Counter<'route'>\n apiResponse: Histogram<'method' | 'route' | 'status'>\n rpcChainReachable: Gauge<'chainId'>\n}\n\nexport type CreateRpcProxyMetricsOptions = {\n // Prefix applied to every metric name registered by this factory, including the\n // request/response counters trackedFetchRpcFactory registers into `registry`.\n prefix: string\n registry?: Registry\n // Set false when the consuming app already calls prom-client's collectDefaultMetrics\n // itself (e.g. to combine it with its own startup metrics) — avoids double-registering.\n collectDefault?: boolean\n}\n\n// Prom-client metrics for a Fastify RPC proxy: blocked/allowed request counts,\n// per-IP rate-limit blocks, HTTP response timings and per-chain reachability —\n// plus a metrics-tracked fetchRPC (via @lidofinance/api-rpc) to pass into rpcFactory.\nexport const createRpcProxyMetrics = ({\n prefix,\n registry = new Registry(),\n collectDefault = true,\n}: CreateRpcProxyMetricsOptions): RpcProxyMetrics => {\n const rpcRequestBlocked = new Counter({\n name: `${prefix}rpc_request_blocked_total`,\n help: 'Number of blocked RPC requests by reason',\n labelNames: ['reason'] as const,\n registers: [registry],\n })\n\n // Client-requested RPC methods, counted at validation time — before a request is\n // blocked or forwarded. Distinct from fetchRPC's own request-methods counter (from\n // @lidofinance/api-rpc), which only counts methods that actually reached a provider.\n const rpcRequestMethods = new Counter({\n name: `${prefix}rpc_request_methods`,\n help: 'RPC methods requested by clients, by method',\n labelNames: ['method'] as const,\n registers: [registry],\n })\n\n const rateLimitBlockedCount = new Counter({\n name: `${prefix}rate_limit_blocked_total`,\n help: 'Number of requests rejected by the in-process per-IP rate limiter, by route',\n labelNames: ['route'] as const,\n registers: [registry],\n })\n\n const apiResponse = new Histogram({\n name: `${prefix}api_response_seconds`,\n help: 'API response time',\n buckets: [0.1, 0.2, 0.3, 0.6, 1, 1.5, 2, 5],\n labelNames: ['method', 'route', 'status'] as const,\n registers: [registry],\n })\n\n const rpcChainReachable = new Gauge({\n name: `${prefix}rpc_chain_reachable`,\n help: '1 if the RPC endpoint for the chain is reachable, 0 otherwise',\n labelNames: ['chainId'] as const,\n registers: [registry],\n })\n\n // Registers its own request/response/methods/result counters into `registry`.\n const fetchRPC = trackedFetchRpcFactory({ prefix, registry })\n\n if (collectDefault) {\n collectDefaultMetrics({ register: registry, prefix })\n }\n\n return {\n registry,\n fetchRPC,\n rpcRequestBlocked,\n rpcRequestMethods,\n rateLimitBlockedCount,\n apiResponse,\n rpcChainReachable,\n }\n}\n","import { getStatusLabel } from '@lidofinance/api-metrics'\n\nimport { probeChains } from './health'\nimport { createRateLimitHook } from './rateLimit/rateLimit'\nimport { rpcFactory } from './rpcFactory/rpcFactory'\n\nimport type { RpcProxyMetrics } from './metrics'\nimport type { RPCFactoryValidationParams, FetchRPC, RpcProviders } from './rpcFactory/types'\nimport type { FastifyInstance } from 'fastify'\n\nexport type RegisterRpcProxyRoutesOptions = {\n providers: RpcProviders\n defaultChain: string | number\n fetchRPC: FetchRPC\n metrics: RpcProxyMetrics\n validation: RPCFactoryValidationParams\n rateLimit: {\n max: number\n windowSec: number\n customIpHeader?: string\n }\n healthTimeoutMs?: number\n serverLogger?: Pick<Console, 'warn' | 'error'>\n}\n\n// Wires /health, /metrics and /rpc onto a Fastify instance. Anything app-specific —\n// CSP reporting, extra routes, the fastify() bootstrap itself — stays with the caller.\nexport const registerRpcProxyRoutes = (app: FastifyInstance, options: RegisterRpcProxyRoutesOptions) => {\n const { providers, defaultChain, fetchRPC, metrics, validation, rateLimit, healthTimeoutMs, serverLogger } = options\n\n // Route label uses the matched route template (e.g. \"/rpc\"), not request.url —\n // avoid request.url here because unmatched URLs (404s) can blow up label\n // cardinality, hence the 'unknown' fallback instead. status is the aggregated\n // 2xx/4xx/… class, not the exact code.\n app.addHook('onResponse', (request, reply, done) => {\n metrics.apiResponse.observe(\n {\n method: request.method,\n route: request.routeOptions.url ?? 'unknown',\n status: getStatusLabel(reply.statusCode),\n },\n reply.elapsedTime / 1000,\n )\n done()\n })\n\n app.get('/health', async (_req, reply) => {\n const checks = await probeChains(providers, {\n fetchRPC,\n timeoutMs: healthTimeoutMs,\n onResult: ({ chainId, ok }) => metrics.rpcChainReachable.set({ chainId }, ok ? 1 : 0),\n logger: serverLogger,\n })\n const healthy = checks.every((c) => c.ok)\n // Structured JSON (status code still carries the pass/fail signal for simple\n // probes like a Dockerfile's `wget --spider`) so infra/dashboards hitting this\n // directly can see which chain is unreachable, not just an aggregate.\n return reply.status(healthy ? 200 : 503).send({\n status: healthy ? 'ok' : 'degraded',\n chains: Object.fromEntries(checks.map((c) => [c.chainId, c.ok ? 'ok' : 'unreachable'])),\n })\n })\n\n app.get('/metrics', async (_req, reply) => {\n const content = await metrics.registry.metrics()\n void reply.status(200).header('Content-Type', metrics.registry.contentType).send(content)\n })\n\n const handleRpc = rpcFactory({\n providers,\n defaultChain,\n fetchRPC,\n metrics: {\n rpcRequestBlocked: metrics.rpcRequestBlocked,\n rpcRequestMethods: metrics.rpcRequestMethods,\n },\n validation,\n serverLogger,\n })\n\n const rpcRateLimit = createRateLimitHook({\n max: rateLimit.max,\n windowSec: rateLimit.windowSec,\n customIpHeader: rateLimit.customIpHeader,\n onBlocked: () => metrics.rateLimitBlockedCount.inc({ route: '/rpc' }),\n })\n\n // Encapsulated in its own plugin context (rather than passed via the route's\n // `preHandler` option) so the rate-limit hook's untyped FastifyRequest doesn't\n // get unified with handleRpc's typed `Querystring: RpcQuery` generic — that\n // unification otherwise collapses to `unknown` and fails to typecheck.\n void app.register((scope) => {\n scope.addHook('preHandler', rpcRateLimit)\n scope.post('/rpc', handleRpc)\n return Promise.resolve()\n })\n}\n"],"names":[],"version":3,"file":"index.cjs.map","sourceRoot":"../../../../"}
1
+ {"mappings":"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","sources":["packages/api/rpc-proxy/src/index.ts","packages/api/rpc-proxy/src/rpcFactory/rpcFactory.ts","packages/api/rpc-proxy/src/redactUrls.ts","packages/api/rpc-proxy/src/rpcFactory/errors.ts","packages/api/rpc-proxy/src/rpcFactory/upstreamTimeout.ts","packages/api/rpc-proxy/src/rpcFactory/validation.ts","packages/api/rpc-proxy/src/rpcFactory/types.ts","packages/api/rpc-proxy/src/rateLimit/rateLimit.ts","packages/api/rpc-proxy/src/rateLimit/constants.ts","packages/api/rpc-proxy/src/rateLimit/fixedWindowStore.ts","packages/api/rpc-proxy/src/rateLimit/getClientIp.ts","packages/api/rpc-proxy/src/health.ts","packages/api/rpc-proxy/src/metrics.ts","packages/api/rpc-proxy/src/routes.ts"],"sourcesContent":["export { rpcFactory } from './rpcFactory/rpcFactory'\nexport * from './rpcFactory/types'\nexport * from './rpcFactory/errors'\nexport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './rpcFactory/validation'\n\nexport { createRateLimitHook } from './rateLimit/rateLimit'\nexport type { RateLimitOptions } from './rateLimit/rateLimit'\nexport { FixedWindowStore } from './rateLimit/fixedWindowStore'\nexport { getClientIp, normalizeIp } from './rateLimit/getClientIp'\nexport { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './rateLimit/constants'\n\nexport { probeChains } from './health'\nexport type { ChainProbeResult, ProbeChainsOptions } from './health'\n\nexport { createRpcProxyMetrics } from './metrics'\nexport type { CreateRpcProxyMetricsOptions, RpcProxyMetrics } from './metrics'\n\nexport { registerRpcProxyRoutes } from './routes'\nexport type { RegisterRpcProxyRoutesOptions } from './routes'\n","// RPC proxy factory adapted from the @lidofinance/next-api-wrapper rpcFactory pattern\n// (https://github.com/lidofinance/lido-frontend-template).\n// Changes from the original:\n// - Ported from Next.js API routes to Fastify request handlers\n// - Added per-chain contract-address allowlist (eth_call / eth_getLogs restriction)\n// - Integrated @lidofinance/api-rpc trackedFetchRpcFactory for prom-client metrics\nimport { Readable } from 'node:stream'\nimport { pipeline } from 'node:stream/promises'\nimport { ReadableStream } from 'node:stream/web'\nimport { iterateUrls } from '@lidofinance/rpc'\n\nimport { redactUrls } from '../redactUrls'\n\nimport { ClientError, DEFAULT_API_ERROR_MESSAGE, HEALTHY_RPC_SERVICES_ARE_OVER, SizeTooLargeError } from './errors'\nimport { DEFAULT_UPSTREAM_TIMEOUT_MS, withUpstreamTimeout } from './upstreamTimeout'\n\nimport type { RPCFactoryParams } from './types'\nimport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './validation'\nimport type { FetchRpcInitBody } from '@lidofinance/rpc'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\ntype RpcQuery = { chainId?: string }\n\nexport const rpcFactory = ({\n providers,\n fetchRPC,\n defaultChain,\n validation,\n serverLogger = console,\n metrics,\n upstreamTimeoutMs = DEFAULT_UPSTREAM_TIMEOUT_MS,\n}: RPCFactoryParams) => {\n const {\n allowedRPCMethods,\n allowedCallAddresses,\n allowedLogsAddresses,\n maxResponseSize = 1_000_000,\n maxBatchCount = 20,\n currentBlockTTLms = 60_000,\n maxGetLogsRange = 20_000,\n blockEmptyAddressGetLogs = true,\n } = validation\n\n // 'any' is an explicit opt-out: no method / address check\n const rpcMethods = allowedRPCMethods === 'any' ? undefined : allowedRPCMethods\n const callAddresses = allowedCallAddresses === 'any' ? undefined : allowedCallAddresses\n const logsAddresses = allowedLogsAddresses === 'any' ? undefined : allowedLogsAddresses\n\n const rpcRequestBlocked = metrics?.rpcRequestBlocked ?? {\n inc: (_labels: { reason: string }) => {},\n }\n const rpcRequestMethods = metrics?.rpcRequestMethods\n\n const validateBaseRequest = baseRequestValidationFactory(defaultChain, providers, maxBatchCount)\n const validateRpcMethod = rpcMethodsValidationFactory(rpcMethods)\n\n const validateEthCall =\n callAddresses && shouldValidateRpcMethod('eth_call', rpcMethods)\n ? ethCallValidationFactory(callAddresses)\n : undefined\n\n const validateEthGetLogs =\n (logsAddresses || blockEmptyAddressGetLogs) && shouldValidateRpcMethod('eth_getLogs', rpcMethods)\n ? ethGetLogsValidationFactory(logsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms)\n : undefined\n\n const validateMaxSteamSize = streamMaxSizeValidationFactory(maxResponseSize)\n\n const requestRPC = (chainId: number, body: FetchRpcInitBody) =>\n iterateUrls(\n providers[chainId],\n (url: string) =>\n withUpstreamTimeout(upstreamTimeoutMs, (signal) =>\n fetchRPC(url, { body, ...(signal ? { signal } : {}) }, { chainId }),\n ),\n (error: unknown) => {\n const message = redactUrls(error instanceof Error ? error.message : String(error))\n serverLogger.warn(`[rpcFactory] provider failed for chain ${chainId}: ${message}`)\n },\n )\n\n return async (request: FastifyRequest<{ Querystring: RpcQuery }>, reply: FastifyReply): Promise<void> => {\n const abortController = new AbortController()\n try {\n const { chainId, requests } = validateBaseRequest(request)\n\n const validationContext = { chainId, rpcRequestBlocked, requestRPC }\n\n for (const req of requests) {\n validateRpcMethod(req, validationContext)\n rpcRequestMethods?.inc({ method: req.method })\n\n if (req.method === 'eth_call' && validateEthCall) {\n validateEthCall(req, validationContext)\n }\n if (req.method === 'eth_getLogs' && validateEthGetLogs) {\n await validateEthGetLogs(req, validationContext)\n }\n }\n\n const proxiedRPC = await requestRPC(chainId, request.body as FetchRpcInitBody)\n\n // iterateUrls returns the last response when no provider answered ok;\n // never relay a provider's error body to the client as a success.\n if (!proxiedRPC.ok) {\n await proxiedRPC.body?.cancel().catch(() => undefined)\n void reply.status(502).send(DEFAULT_API_ERROR_MESSAGE)\n return\n }\n\n // Reject a declared oversized body before streaming starts — once bytes are on the\n // wire the status can no longer change and the stream is only cut short.\n const contentLength = Number(proxiedRPC.headers.get('content-length'))\n if (contentLength > maxResponseSize) {\n await proxiedRPC.body?.cancel().catch(() => undefined)\n rpcRequestBlocked.inc({ reason: 'response too large' })\n throw new SizeTooLargeError(`Stream size exceeds the maximum limit of ${maxResponseSize} bytes`)\n }\n\n void reply.header('content-type', proxiedRPC.headers.get('content-type') ?? 'application/json')\n\n if (!proxiedRPC.body) {\n throw new Error('There are problems with RPC provider')\n }\n\n await pipeline(\n Readable.fromWeb(proxiedRPC.body as ReadableStream),\n validateMaxSteamSize(validationContext),\n reply.raw,\n { signal: abortController.signal },\n )\n } catch (error) {\n if (error instanceof ClientError) {\n if (!reply.raw.headersSent) {\n void reply\n .status(error instanceof SizeTooLargeError ? 413 : 400)\n .send(error.message ?? DEFAULT_API_ERROR_MESSAGE)\n }\n } else if (error instanceof Error) {\n serverLogger.error('[rpcFactory] ' + redactUrls(error.message ?? DEFAULT_API_ERROR_MESSAGE))\n if (!reply.sent) {\n void reply.status(500).send(DEFAULT_API_ERROR_MESSAGE)\n }\n } else {\n void reply.status(500).send(HEALTHY_RPC_SERVICES_ARE_OVER)\n }\n } finally {\n abortController.abort()\n }\n }\n}\n","const URL_PATTERN = /\\b(?:https?|wss?):\\/\\/[^\\s'\"<>]+/gi\n\nconst toHost = (url: string) => {\n try {\n return new URL(url).hostname\n } catch {\n return '<url>'\n }\n}\n\n// Provider URLs usually carry the API key in the path or query, so anything that\n// ends up in a log line is reduced to the provider's hostname.\nexport const redactUrls = (text: string) => text.replace(URL_PATTERN, toHost)\n","export const DEFAULT_API_ERROR_MESSAGE = 'Something went wrong. Sorry, try again later :('\n\nexport const HEALTHY_RPC_SERVICES_ARE_OVER = 'Healthy RPC services are over!'\n\nexport class ClientError extends Error {}\n\nexport class UnsupportedChainIdError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported chainId')\n }\n}\n\nexport class UnsupportedHTTPMethodError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported HTTP method')\n }\n}\n\nexport class InvalidRequestError extends ClientError {\n constructor(message?: string) {\n super(message || 'Invalid Request')\n }\n}\n\nexport class SizeTooLargeError extends ClientError {\n constructor(message?: string) {\n super(message || 'Response size too large')\n }\n}\n","export const DEFAULT_UPSTREAM_TIMEOUT_MS = 10_000\n\n// Runs `request` with a signal that aborts when the provider has not started answering within\n// timeoutMs. The timer stops once the request settles, i.e. when the response headers arrive,\n// so a long response body is never cut short. 0 turns the limit off.\nexport const withUpstreamTimeout = async <T>(\n timeoutMs: number,\n request: (signal?: AbortSignal) => Promise<T>,\n): Promise<T> => {\n if (!(timeoutMs > 0)) return request()\n\n const controller = new AbortController()\n const timer = setTimeout(() => controller.abort(new Error(`no response within ${timeoutMs} ms`)), timeoutMs)\n try {\n return await request(controller.signal)\n } finally {\n clearTimeout(timer)\n }\n}\n","import { Transform } from 'node:stream'\n\nimport { Cache } from 'memory-cache'\n\nimport { ClientError, InvalidRequestError, SizeTooLargeError, UnsupportedChainIdError } from './errors'\n\nimport type { RpcRequest, ValidationContext } from './types'\n\ntype BaseRequest = {\n query: { chainId?: string | string[] }\n body: unknown\n}\n\n// BigInt(0), not a 0n literal — this file is type-checked under the repo's shared\n// root tsconfig (target es5) whenever a sibling package without its own tsconfig\n// runs `tsc`, and BigInt literal syntax requires an ES2020+ target to parse.\nconst zeroBN = BigInt(0)\n\nconst HEX_BLOCK_NUMBER = /^0x[0-9a-fA-F]+$/\n// Tags that resolve within a few blocks of head, far below any sane maxGetLogsRange\nconst NEAR_HEAD_BLOCK_TAGS = new Set(['latest', 'safe', 'finalized', 'pending'])\n\nexport const baseRequestValidationFactory = (\n defaultChain: number | string,\n providers: Record<string, unknown>,\n maxBatchSize?: number,\n) => {\n return (req: BaseRequest) => {\n const rawChainId = Array.isArray(req.query.chainId) ? req.query.chainId[0] : req.query.chainId\n\n const chainId = Number(rawChainId || defaultChain)\n\n if (providers[chainId] == null) {\n throw new UnsupportedChainIdError()\n }\n\n const requests = Array.isArray(req.body) ? req.body : [req.body]\n\n if (typeof maxBatchSize === 'number' && requests.length > maxBatchSize) {\n throw new InvalidRequestError(`Too many batched requests`)\n }\n return { chainId, requests }\n }\n}\n\nexport const rpcMethodsValidationFactory = (allowedMethods?: string[]) => {\n const methodsMap = new Set(allowedMethods ?? [])\n\n return (request: RpcRequest, context: ValidationContext) => {\n const method = request.method\n if (typeof method !== 'string') {\n throw new InvalidRequestError(`RPC method isn't string`)\n }\n if (allowedMethods && !methodsMap.has(request.method)) {\n context.rpcRequestBlocked.inc({ reason: 'method not allowed' })\n throw new InvalidRequestError(`RPC method ${method} not allowed`)\n }\n }\n}\n\nexport const ethCallValidationFactory = (allowedAddress: Record<number, string[]>) => {\n const allowedCallAddressMap = createAllowedAddressMap(allowedAddress)\n\n return (request: RpcRequest, { chainId, rpcRequestBlocked }: ValidationContext) => {\n const { params } = request\n\n // Explicitly reject any request whose first param is not a well-formed tx object.\n // Using an early-return guard keeps the \"address allowed?\" check unconditionally\n // reachable and prevents future edits to the condition from accidentally creating\n // a path that forwards an unvalidated eth_call.\n const txObject = Array.isArray(params) ? params[0] : undefined\n\n if (\n txObject == null ||\n typeof txObject !== 'object' ||\n !('to' in txObject) ||\n typeof (txObject as Record<string, unknown>).to !== 'string'\n ) {\n throw new InvalidRequestError(`RPC method eth_call is invalid`)\n }\n\n const toAddress = (txObject as { to: string }).to\n\n if (!allowedCallAddressMap[chainId]?.has(toAddress.toLowerCase())) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_call' })\n throw new InvalidRequestError(`Address not allowed for eth_call`)\n }\n }\n}\n\nexport const ethGetLogsValidationFactory = (\n allowedAddress: Record<number, string[]> | undefined,\n blockEmptyAddressGetLogs: boolean | undefined,\n maxBlockRange: number | undefined,\n currentBlockTTL = 60_000,\n) => {\n const allowedAddressMap = createAllowedAddressMap(allowedAddress ?? {})\n const maxBlockRangeBN = maxBlockRange ? BigInt(maxBlockRange) : zeroBN\n const currentBlock = new Cache<number, bigint>()\n\n return async (request: RpcRequest, { chainId, rpcRequestBlocked, requestRPC }: ValidationContext) => {\n try {\n const params = request.params[0] as any\n const fromBlock: string = params.fromBlock\n const toBlock: string = params.toBlock ?? 'latest'\n\n if (blockEmptyAddressGetLogs || allowedAddress) {\n const address: string | string[] = params.address\n\n if (blockEmptyAddressGetLogs && !address)\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n\n const addresses = Array.isArray(address) ? address : [address]\n\n if (blockEmptyAddressGetLogs && addresses.length === 0) {\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n }\n if (\n allowedAddress &&\n addresses.some(\n (eventAddress) =>\n typeof eventAddress !== 'string' || !allowedAddressMap[chainId]?.has(eventAddress.toLowerCase()),\n )\n ) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_getLogs' })\n throw new InvalidRequestError(`Address not allowed for eth_getLogs`)\n }\n }\n\n if (maxBlockRange) {\n if (fromBlock === 'earliest') throw new InvalidRequestError(`RPC method eth_getLogs fromBlock is invalid`)\n // Anything that is neither a hex number nor a near-head tag would skip the range check\n if (!HEX_BLOCK_NUMBER.test(fromBlock) && !NEAR_HEAD_BLOCK_TAGS.has(fromBlock)) {\n throw new InvalidRequestError(`RPC method eth_getLogs fromBlock is invalid`)\n }\n\n if (fromBlock.startsWith('0x')) {\n const normalizedFromBlock = BigInt(fromBlock)\n let normalizedToBlock: bigint\n\n if (toBlock.startsWith('0x')) {\n normalizedToBlock = BigInt(toBlock)\n } else {\n const cached = currentBlock.get(chainId)\n if (cached) {\n normalizedToBlock = cached\n } else {\n normalizedToBlock = await requestRPC(chainId, {\n id: 1,\n jsonrpc: '2.0',\n method: 'eth_blockNumber',\n })\n .then((res) => res.json() as Promise<{ result: string }>)\n .then((res) => BigInt(res.result))\n currentBlock.put(chainId, normalizedToBlock, currentBlockTTL)\n }\n }\n\n const range = normalizedToBlock - normalizedFromBlock\n if (range < zeroBN || range > maxBlockRangeBN) {\n rpcRequestBlocked.inc({ reason: 'eth_getLogs range is invalid' })\n throw new InvalidRequestError(`RPC method eth_getLogs range is invalid`)\n }\n }\n }\n } catch (error) {\n if (error instanceof ClientError) throw error\n throw new InvalidRequestError(`RPC method eth_getLogs is invalid`)\n }\n }\n}\n\nexport const streamMaxSizeValidationFactory = (MAX_SIZE: number) => (context: ValidationContext) => {\n let bytesWritten = 0\n return new Transform({\n transform(chunk, _encoding, callback) {\n bytesWritten += chunk.length\n if (bytesWritten > MAX_SIZE) {\n context.rpcRequestBlocked.inc({ reason: 'response too large' })\n return callback(new SizeTooLargeError(`Stream size exceeds the maximum limit of ${MAX_SIZE} bytes`))\n }\n return callback(null, chunk)\n },\n flush(callback) {\n callback()\n },\n })\n}\n\n// utils\n\nexport const shouldValidateRpcMethod = (method: string, allowedRPCMethods?: string[]) =>\n !allowedRPCMethods || allowedRPCMethods.includes(method)\n\nconst createAllowedAddressMap = (allowedAddress: Record<number, string[]>) =>\n Object.entries(allowedAddress).reduce((acc, [chainId, addresses]) => {\n acc[chainId] = new Set(addresses.map((a) => a.toLowerCase()))\n return acc\n }, {} as Record<string, Set<string>>)\n","import type { FetchRpcInit, FetchRpcInitBody } from '@lidofinance/rpc'\n\nexport type RpcProviders = Record<string | number, [string, ...string[]]>\n\nexport type AddressAllowlist = Record<number, string[]> | 'any'\n\nexport type MethodAllowlist = string[] | 'any'\n\nexport type RPCFactoryValidationParams = {\n maxBatchCount?: number\n maxResponseSize?: number\n // Required: the allowed JSON-RPC methods, or 'any' to allow every method deliberately\n allowedRPCMethods: MethodAllowlist\n // Required: the per-chain address lists, or 'any' to allow every address\n // deliberately (e.g. user-deployed contracts)\n allowedCallAddresses: AddressAllowlist\n allowedLogsAddresses: AddressAllowlist\n blockEmptyAddressGetLogs?: boolean\n maxGetLogsRange?: number\n currentBlockTTLms?: number\n}\n\nexport type FetchRPC = (url: string, init: FetchRpcInit, meta: { chainId: number | string }) => Promise<Response>\n\nexport type RPCFactoryMetrics = {\n rpcRequestBlocked: RpcRequestBlockedCounter\n rpcRequestMethods?: { inc(labels: { method: string }): void }\n}\n\nexport type RPCFactoryParams = {\n providers: RpcProviders\n fetchRPC: FetchRPC\n defaultChain: string | number\n validation: RPCFactoryValidationParams\n serverLogger?: Pick<Console, 'warn' | 'error'>\n metrics?: RPCFactoryMetrics\n // Per-provider time limit (ms) for the provider to start answering; the response body is not timed.\n // A provider that exceeds it counts as failed and the next URL is tried. 10 000 by default, 0 turns it off.\n upstreamTimeoutMs?: number\n}\n\nexport type RpcRequest = {\n method: string\n params: unknown[]\n}\n\nexport type RpcRequestBlockedCounter = {\n inc(labels: { reason: string }): void\n}\n\nexport type ValidationContext = {\n chainId: number\n rpcRequestBlocked: RpcRequestBlockedCounter\n requestRPC: (chainId: number, body: FetchRpcInitBody) => Promise<Response>\n}\n","import { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './constants'\nimport { FixedWindowStore } from './fixedWindowStore'\nimport { getClientIp } from './getClientIp'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\nexport type RateLimitOptions = {\n max: number\n windowSec: number\n customIpHeader?: string\n onBlocked?: (ip: string) => void\n}\n\n// Fixed-window per-IP limiter, adapted as a Fastify preHandler from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit\n// (a Next.js API-route wrapper — this repo has no Next.js, so the counting\n// and IP-extraction ideas are ported by hand rather than installed).\n// One store instance per createRateLimitHook call — call it once per route so\n// separate routes (e.g. /rpc and /api/csp-report) don't share a budget.\nexport const createRateLimitHook = ({ max, windowSec, customIpHeader, onBlocked }: RateLimitOptions) => {\n const store = new FixedWindowStore()\n\n return async (req: FastifyRequest, reply: FastifyReply): Promise<void> => {\n const ip = getClientIp(req, customIpHeader)\n const now = Date.now() / 1000\n const window = Math.floor(now / windowSec)\n const key = `${ip}:${window}`\n\n const count = store.increment(key, windowSec)\n const remaining = max - count\n const reset = (window + 1) * windowSec\n\n void reply.header(RATE_LIMIT_HEADERS.limit, String(max))\n void reply.header(RATE_LIMIT_HEADERS.remaining, String(Math.max(remaining, 0)))\n void reply.header(RATE_LIMIT_HEADERS.reset, String(reset))\n\n if (remaining < 0) {\n const retryAfter = Math.max(Math.ceil(reset - now), 0)\n void reply.header('Retry-After', String(retryAfter))\n onBlocked?.(ip)\n void reply.status(429).send(`${RATE_LIMIT_ERROR_MESSAGE} for ip:${ip}`)\n }\n }\n}\n","export const RATE_LIMIT_HEADERS = {\n limit: 'X-RateLimit-Limit',\n remaining: 'X-RateLimit-Remaining',\n reset: 'X-RateLimit-Reset',\n} as const\n\nexport const RATE_LIMIT_ERROR_MESSAGE = 'Rate limit exceeded'\n","type StoreEntry = { value: number; timeoutId: NodeJS.Timeout }\n\n// Fixed-window counter: each key auto-expires durationSec after it was last\n// touched, so no separate sweep/cron is needed to bound memory. Adapted from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/storage.ts,\n// itself based on nestjs/throttler's setTimeout-per-key approach.\nexport class FixedWindowStore {\n private store = new Map<string, StoreEntry>()\n\n private set(key: string, value: number, durationSec: number) {\n clearTimeout(this.store.get(key)?.timeoutId)\n\n const timeoutId = setTimeout(() => this.store.delete(key), durationSec * 1000)\n // This is a cache-eviction timer, not pending work — it must not keep the\n // process alive on its own (matters for a long-running server, unlike the\n // serverless functions the ported design originally ran in).\n timeoutId.unref()\n\n this.store.set(key, { value, timeoutId })\n }\n\n get(key: string): number | undefined {\n return this.store.get(key)?.value\n }\n\n increment(key: string, durationSec: number): number {\n const next = (this.get(key) ?? 0) + 1\n this.set(key, next, durationSec)\n return next\n }\n}\n","import { isIP } from 'node:net'\nimport type { FastifyRequest } from 'fastify'\n\nexport const normalizeIp = (ip: string): string => ip.trim().replace(/^::ffff:/i, '')\n\nconst firstValidIp = (value: string | string[] | undefined): string | undefined => {\n const raw = Array.isArray(value) ? value[0] : value\n if (!raw) return undefined\n const candidate = normalizeIp(raw.split(',')[0] ?? '')\n return candidate && isIP(candidate) ? candidate : undefined\n}\n\n// req.ip is already the right answer for X-Forwarded-For: Fastify's trustProxy\n// option (see server/index.ts, set to TRUSTED_PROXY_HOPS) walks exactly that\n// many hops back through the header via @fastify/proxy-addr, which is the\n// correct way to find the real client through this app's one nginx hop. X-\n// Forwarded-For is never read directly here — a client can set that header to\n// anything, and only Fastify's hop-counted view of it is trustworthy.\n//\n// customIpHeader is for an edge/CDN in front of nginx (e.g. Cloudflare's\n// cf-connecting-ip) that knows the client's IP authoritatively, independent of\n// hop counting. It's validated with isIP so a spoofed or garbage value falls\n// through to req.ip instead of being trusted blindly — ported from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/utils.ts,\n// adapted from Next's per-request customIpHeader to Fastify + trustProxy.\nexport const getClientIp = (req: FastifyRequest, customIpHeader?: string): string => {\n const customIp = customIpHeader ? firstValidIp(req.headers[customIpHeader.toLowerCase()]) : undefined\n\n return customIp ?? normalizeIp(req.ip || '0.0.0.0')\n}\n","import { redactUrls } from './redactUrls'\n\nimport type { FetchRPC, RpcProviders } from './rpcFactory/types'\n\nexport type ChainProbeResult = { chainId: string; ok: boolean }\n\nexport type ProbeChainsOptions = {\n fetchRPC: FetchRPC\n timeoutMs?: number\n onResult?: (result: ChainProbeResult) => void\n logger?: Pick<Console, 'warn'>\n}\n\nconst DEFAULT_HEALTH_TIMEOUT_MS = 5_000\n\n// Probes every configured URL per chain in parallel — matching the runtime fallback\n// semantics of iterateUrls in rpcFactory. A chain is healthy when at least one URL\n// responds, so a single-provider outage doesn't fail a proxy that has working fallbacks.\nexport const probeChains = async (\n providers: RpcProviders,\n { fetchRPC, timeoutMs = DEFAULT_HEALTH_TIMEOUT_MS, onResult, logger = console }: ProbeChainsOptions,\n): Promise<ChainProbeResult[]> => {\n const results = await Promise.all(\n Object.entries(providers).map(async ([chainId, urls]) => {\n const urlResults = await Promise.all(\n urls.map(async (url) => {\n try {\n const response = await fetchRPC(\n url,\n {\n body: { id: 1, jsonrpc: '2.0', method: 'eth_blockNumber', params: [] },\n signal: AbortSignal.timeout(timeoutMs),\n },\n { chainId },\n )\n const { result } = (await response.json()) as { result?: unknown }\n return response.ok && result != null\n } catch (error) {\n const reason = redactUrls(error instanceof Error ? error.message : String(error))\n logger.warn(`[health] probe failed for chain ${chainId} provider ${redactUrls(url)}: ${reason}`)\n return false\n }\n }),\n )\n const ok = urlResults.some(Boolean)\n return { chainId, ok }\n }),\n )\n for (const result of results) {\n onResult?.(result)\n }\n return results\n}\n","import { trackedFetchRpcFactory } from '@lidofinance/api-rpc'\nimport { Counter, Gauge, Histogram, Registry, collectDefaultMetrics } from 'prom-client'\n\nimport type { FetchRPC } from './rpcFactory/types'\n\nexport type RpcProxyMetrics = {\n registry: Registry\n fetchRPC: FetchRPC\n rpcRequestBlocked: Counter<'reason'>\n rpcRequestMethods: Counter<'method'>\n rateLimitBlockedCount: Counter<'route'>\n apiResponse: Histogram<'method' | 'route' | 'status'>\n rpcChainReachable: Gauge<'chainId'>\n}\n\nexport type CreateRpcProxyMetricsOptions = {\n // Prefix applied to every metric name registered by this factory, including the\n // request/response counters trackedFetchRpcFactory registers into `registry`.\n prefix: string\n registry?: Registry\n // Set false when the consuming app already calls prom-client's collectDefaultMetrics\n // itself (e.g. to combine it with its own startup metrics) — avoids double-registering.\n collectDefault?: boolean\n}\n\n// Prom-client metrics for a Fastify RPC proxy: blocked/allowed request counts,\n// per-IP rate-limit blocks, HTTP response timings and per-chain reachability —\n// plus a metrics-tracked fetchRPC (via @lidofinance/api-rpc) to pass into rpcFactory.\nexport const createRpcProxyMetrics = ({\n prefix,\n registry = new Registry(),\n collectDefault = true,\n}: CreateRpcProxyMetricsOptions): RpcProxyMetrics => {\n const rpcRequestBlocked = new Counter({\n name: `${prefix}rpc_request_blocked_total`,\n help: 'Number of blocked RPC requests by reason',\n labelNames: ['reason'] as const,\n registers: [registry],\n })\n\n // Client-requested RPC methods, counted at validation time — before a request is\n // blocked or forwarded. Distinct from fetchRPC's own request-methods counter (from\n // @lidofinance/api-rpc), which only counts methods that actually reached a provider.\n const rpcRequestMethods = new Counter({\n name: `${prefix}rpc_request_methods`,\n help: 'RPC methods requested by clients, by method',\n labelNames: ['method'] as const,\n registers: [registry],\n })\n\n const rateLimitBlockedCount = new Counter({\n name: `${prefix}rate_limit_blocked_total`,\n help: 'Number of requests rejected by the in-process per-IP rate limiter, by route',\n labelNames: ['route'] as const,\n registers: [registry],\n })\n\n const apiResponse = new Histogram({\n name: `${prefix}api_response_seconds`,\n help: 'API response time',\n buckets: [0.1, 0.2, 0.3, 0.6, 1, 1.5, 2, 5],\n labelNames: ['method', 'route', 'status'] as const,\n registers: [registry],\n })\n\n const rpcChainReachable = new Gauge({\n name: `${prefix}rpc_chain_reachable`,\n help: '1 if the RPC endpoint for the chain is reachable, 0 otherwise',\n labelNames: ['chainId'] as const,\n registers: [registry],\n })\n\n // Registers its own request/response/methods/result counters into `registry`.\n const fetchRPC = trackedFetchRpcFactory({ prefix, registry })\n\n if (collectDefault) {\n collectDefaultMetrics({ register: registry, prefix })\n }\n\n return {\n registry,\n fetchRPC,\n rpcRequestBlocked,\n rpcRequestMethods,\n rateLimitBlockedCount,\n apiResponse,\n rpcChainReachable,\n }\n}\n","import { getStatusLabel } from '@lidofinance/api-metrics'\n\nimport { probeChains } from './health'\nimport { createRateLimitHook } from './rateLimit/rateLimit'\nimport { rpcFactory } from './rpcFactory/rpcFactory'\n\nimport type { ChainProbeResult } from './health'\nimport type { RpcProxyMetrics } from './metrics'\nimport type { RPCFactoryValidationParams, FetchRPC, RpcProviders } from './rpcFactory/types'\nimport type { FastifyInstance } from 'fastify'\n\nconst DEFAULT_HEALTH_CACHE_MS = 5_000\n\nexport type RegisterRpcProxyRoutesOptions = {\n providers: RpcProviders\n defaultChain: string | number\n fetchRPC: FetchRPC\n metrics: RpcProxyMetrics\n validation: RPCFactoryValidationParams\n rateLimit: {\n max: number\n windowSec: number\n customIpHeader?: string\n }\n healthTimeoutMs?: number\n // How long (ms) a /health probe result is reused. /health is unauthenticated and outside the rate\n // limiter, so without this every GET costs one upstream call per configured URL.\n // 5 000 by default, 0 probes on every request.\n healthCacheMs?: number\n upstreamTimeoutMs?: number\n serverLogger?: Pick<Console, 'warn' | 'error'>\n}\n\n// Wires /health, /metrics and /rpc onto a Fastify instance. Anything app-specific —\n// CSP reporting, extra routes, the fastify() bootstrap itself — stays with the caller.\nexport const registerRpcProxyRoutes = (app: FastifyInstance, options: RegisterRpcProxyRoutesOptions) => {\n const {\n providers,\n defaultChain,\n fetchRPC,\n metrics,\n validation,\n rateLimit,\n healthTimeoutMs,\n healthCacheMs = DEFAULT_HEALTH_CACHE_MS,\n upstreamTimeoutMs,\n serverLogger,\n } = options\n\n // Route label uses the matched route template (e.g. \"/rpc\"), not request.url —\n // avoid request.url here because unmatched URLs (404s) can blow up label\n // cardinality, hence the 'unknown' fallback instead. status is the aggregated\n // 2xx/4xx/… class, not the exact code.\n app.addHook('onResponse', (request, reply, done) => {\n metrics.apiResponse.observe(\n {\n method: request.method,\n route: request.routeOptions.url ?? 'unknown',\n status: getStatusLabel(reply.statusCode),\n },\n reply.elapsedTime / 1000,\n )\n done()\n })\n\n // A probe in flight is shared by every request that arrives meanwhile, and its result is\n // reused for healthCacheMs after it settles, so /health cannot be used to multiply upstream calls.\n let cachedProbe: { checks: Promise<ChainProbeResult[]>; expiresAt: number } | undefined\n\n const probe = () => {\n if (cachedProbe && Date.now() < cachedProbe.expiresAt) return cachedProbe.checks\n\n const checks = probeChains(providers, {\n fetchRPC,\n timeoutMs: healthTimeoutMs,\n onResult: ({ chainId, ok }) => metrics.rpcChainReachable.set({ chainId }, ok ? 1 : 0),\n logger: serverLogger,\n })\n if (healthCacheMs > 0) {\n const entry = { checks, expiresAt: Infinity }\n cachedProbe = entry\n checks.then(\n () => (entry.expiresAt = Date.now() + healthCacheMs),\n () => (entry.expiresAt = 0),\n )\n }\n return checks\n }\n\n app.get('/health', async (_req, reply) => {\n const checks = await probe()\n const healthy = checks.every((c) => c.ok)\n // Structured JSON (status code still carries the pass/fail signal for simple\n // probes like a Dockerfile's `wget --spider`) so infra/dashboards hitting this\n // directly can see which chain is unreachable, not just an aggregate.\n return reply.status(healthy ? 200 : 503).send({\n status: healthy ? 'ok' : 'degraded',\n chains: Object.fromEntries(checks.map((c) => [c.chainId, c.ok ? 'ok' : 'unreachable'])),\n })\n })\n\n app.get('/metrics', async (_req, reply) => {\n const content = await metrics.registry.metrics()\n void reply.status(200).header('Content-Type', metrics.registry.contentType).send(content)\n })\n\n const handleRpc = rpcFactory({\n providers,\n defaultChain,\n fetchRPC,\n metrics: {\n rpcRequestBlocked: metrics.rpcRequestBlocked,\n rpcRequestMethods: metrics.rpcRequestMethods,\n },\n validation,\n serverLogger,\n upstreamTimeoutMs,\n })\n\n const rpcRateLimit = createRateLimitHook({\n max: rateLimit.max,\n windowSec: rateLimit.windowSec,\n customIpHeader: rateLimit.customIpHeader,\n onBlocked: () => metrics.rateLimitBlockedCount.inc({ route: '/rpc' }),\n })\n\n // Encapsulated in its own plugin context (rather than passed via the route's\n // `preHandler` option) so the rate-limit hook's untyped FastifyRequest doesn't\n // get unified with handleRpc's typed `Querystring: RpcQuery` generic — that\n // unification otherwise collapses to `unknown` and fails to typecheck.\n void app.register((scope) => {\n scope.addHook('preHandler', rpcRateLimit)\n scope.post('/rpc', handleRpc)\n return Promise.resolve()\n })\n}\n"],"names":[],"version":3,"file":"index.cjs.map","sourceRoot":"../../../../"}
package/dist/index.d.ts CHANGED
@@ -19,12 +19,14 @@ export class SizeTooLargeError extends ClientError {
19
19
  constructor(message?: string);
20
20
  }
21
21
  export type RpcProviders = Record<string | number, [string, ...string[]]>;
22
+ export type AddressAllowlist = Record<number, string[]> | 'any';
23
+ export type MethodAllowlist = string[] | 'any';
22
24
  export type RPCFactoryValidationParams = {
23
25
  maxBatchCount?: number;
24
26
  maxResponseSize?: number;
25
- allowedRPCMethods?: string[];
26
- allowedCallAddresses?: Record<number, string[]>;
27
- allowedLogsAddresses?: Record<number, string[]>;
27
+ allowedRPCMethods: MethodAllowlist;
28
+ allowedCallAddresses: AddressAllowlist;
29
+ allowedLogsAddresses: AddressAllowlist;
28
30
  blockEmptyAddressGetLogs?: boolean;
29
31
  maxGetLogsRange?: number;
30
32
  currentBlockTTLms?: number;
@@ -47,6 +49,7 @@ export type RPCFactoryParams = {
47
49
  validation: RPCFactoryValidationParams;
48
50
  serverLogger?: Pick<Console, 'warn' | 'error'>;
49
51
  metrics?: RPCFactoryMetrics;
52
+ upstreamTimeoutMs?: number;
50
53
  };
51
54
  export type RpcRequest = {
52
55
  method: string;
@@ -80,7 +83,7 @@ export const shouldValidateRpcMethod: (method: string, allowedRPCMethods?: strin
80
83
  type RpcQuery = {
81
84
  chainId?: string;
82
85
  };
83
- export const rpcFactory: ({ providers, fetchRPC, defaultChain, validation, serverLogger, metrics, }: RPCFactoryParams) => (request: FastifyRequest<{
86
+ export const rpcFactory: ({ providers, fetchRPC, defaultChain, validation, serverLogger, metrics, upstreamTimeoutMs, }: RPCFactoryParams) => (request: FastifyRequest<{
84
87
  Querystring: RpcQuery;
85
88
  }>, reply: FastifyReply) => Promise<void>;
86
89
  export const RATE_LIMIT_HEADERS: {
@@ -140,6 +143,8 @@ export type RegisterRpcProxyRoutesOptions = {
140
143
  customIpHeader?: string;
141
144
  };
142
145
  healthTimeoutMs?: number;
146
+ healthCacheMs?: number;
147
+ upstreamTimeoutMs?: number;
143
148
  serverLogger?: Pick<Console, 'warn' | 'error'>;
144
149
  };
145
150
  export const registerRpcProxyRoutes: (app: FastifyInstance, options: RegisterRpcProxyRoutesOptions) => void;
@@ -1 +1 @@
1
- {"mappings":"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","sources":["packages/api/rpc-proxy/src/src/rpcFactory/errors.ts","packages/api/rpc-proxy/src/src/rpcFactory/types.ts","packages/api/rpc-proxy/src/src/rpcFactory/validation.ts","packages/api/rpc-proxy/src/src/rpcFactory/rpcFactory.ts","packages/api/rpc-proxy/src/src/rateLimit/constants.ts","packages/api/rpc-proxy/src/src/rateLimit/fixedWindowStore.ts","packages/api/rpc-proxy/src/src/rateLimit/getClientIp.ts","packages/api/rpc-proxy/src/src/rateLimit/rateLimit.ts","packages/api/rpc-proxy/src/src/health.ts","packages/api/rpc-proxy/src/src/metrics.ts","packages/api/rpc-proxy/src/src/routes.ts","packages/api/rpc-proxy/src/src/index.ts","packages/api/rpc-proxy/src/index.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null,"export { rpcFactory } from './rpcFactory/rpcFactory'\nexport * from './rpcFactory/types'\nexport * from './rpcFactory/errors'\nexport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './rpcFactory/validation'\n\nexport { createRateLimitHook } from './rateLimit/rateLimit'\nexport type { RateLimitOptions } from './rateLimit/rateLimit'\nexport { FixedWindowStore } from './rateLimit/fixedWindowStore'\nexport { getClientIp, normalizeIp } from './rateLimit/getClientIp'\nexport { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './rateLimit/constants'\n\nexport { probeChains } from './health'\nexport type { ChainProbeResult, ProbeChainsOptions } from './health'\n\nexport { createRpcProxyMetrics } from './metrics'\nexport type { CreateRpcProxyMetricsOptions, RpcProxyMetrics } from './metrics'\n\nexport { registerRpcProxyRoutes } from './routes'\nexport type { RegisterRpcProxyRoutesOptions } from './routes'\n"],"names":[],"version":3,"file":"index.d.ts.map","sourceRoot":"../../../../"}
1
+ {"mappings":"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","sources":["packages/api/rpc-proxy/src/src/redactUrls.ts","packages/api/rpc-proxy/src/src/rpcFactory/errors.ts","packages/api/rpc-proxy/src/src/rpcFactory/upstreamTimeout.ts","packages/api/rpc-proxy/src/src/rpcFactory/types.ts","packages/api/rpc-proxy/src/src/rpcFactory/validation.ts","packages/api/rpc-proxy/src/src/rpcFactory/rpcFactory.ts","packages/api/rpc-proxy/src/src/rateLimit/constants.ts","packages/api/rpc-proxy/src/src/rateLimit/fixedWindowStore.ts","packages/api/rpc-proxy/src/src/rateLimit/getClientIp.ts","packages/api/rpc-proxy/src/src/rateLimit/rateLimit.ts","packages/api/rpc-proxy/src/src/health.ts","packages/api/rpc-proxy/src/src/metrics.ts","packages/api/rpc-proxy/src/src/routes.ts","packages/api/rpc-proxy/src/src/index.ts","packages/api/rpc-proxy/src/index.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,"export { rpcFactory } from './rpcFactory/rpcFactory'\nexport * from './rpcFactory/types'\nexport * from './rpcFactory/errors'\nexport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './rpcFactory/validation'\n\nexport { createRateLimitHook } from './rateLimit/rateLimit'\nexport type { RateLimitOptions } from './rateLimit/rateLimit'\nexport { FixedWindowStore } from './rateLimit/fixedWindowStore'\nexport { getClientIp, normalizeIp } from './rateLimit/getClientIp'\nexport { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './rateLimit/constants'\n\nexport { probeChains } from './health'\nexport type { ChainProbeResult, ProbeChainsOptions } from './health'\n\nexport { createRpcProxyMetrics } from './metrics'\nexport type { CreateRpcProxyMetricsOptions, RpcProxyMetrics } from './metrics'\n\nexport { registerRpcProxyRoutes } from './routes'\nexport type { RegisterRpcProxyRoutesOptions } from './routes'\n"],"names":[],"version":3,"file":"index.d.ts.map","sourceRoot":"../../../../"}
package/dist/index.mjs CHANGED
@@ -19,6 +19,17 @@ function $parcel$export(e, n, v, s) {
19
19
 
20
20
 
21
21
 
22
+ const $bd97b350d73505d4$var$URL_PATTERN = /\b(?:https?|wss?):\/\/[^\s'"<>]+/gi;
23
+ const $bd97b350d73505d4$var$toHost = (url)=>{
24
+ try {
25
+ return new URL(url).hostname;
26
+ } catch {
27
+ return "<url>";
28
+ }
29
+ };
30
+ const $bd97b350d73505d4$export$dac76f5d4966dbe0 = (text)=>text.replace($bd97b350d73505d4$var$URL_PATTERN, $bd97b350d73505d4$var$toHost);
31
+
32
+
22
33
  var $08353fa2638bb85a$exports = {};
23
34
 
24
35
  $parcel$export($08353fa2638bb85a$exports, "DEFAULT_API_ERROR_MESSAGE", () => $08353fa2638bb85a$export$c982278a0ddc4dbe);
@@ -54,6 +65,19 @@ class $08353fa2638bb85a$export$e224c1080d950012 extends $08353fa2638bb85a$export
54
65
  }
55
66
 
56
67
 
68
+ const $30c5c70af1bc69c8$export$66d7aef0343e6f4b = 10000;
69
+ const $30c5c70af1bc69c8$export$6d59a6fe1a73319b = async (timeoutMs, request)=>{
70
+ if (!(timeoutMs > 0)) return request();
71
+ const controller = new AbortController();
72
+ const timer = setTimeout(()=>controller.abort(new Error(`no response within ${timeoutMs} ms`)), timeoutMs);
73
+ try {
74
+ return await request(controller.signal);
75
+ } finally{
76
+ clearTimeout(timer);
77
+ }
78
+ };
79
+
80
+
57
81
 
58
82
 
59
83
 
@@ -61,6 +85,14 @@ class $08353fa2638bb85a$export$e224c1080d950012 extends $08353fa2638bb85a$export
61
85
  // root tsconfig (target es5) whenever a sibling package without its own tsconfig
62
86
  // runs `tsc`, and BigInt literal syntax requires an ES2020+ target to parse.
63
87
  const $bcbfd32d0ee8ddd2$var$zeroBN = BigInt(0);
88
+ const $bcbfd32d0ee8ddd2$var$HEX_BLOCK_NUMBER = /^0x[0-9a-fA-F]+$/;
89
+ // Tags that resolve within a few blocks of head, far below any sane maxGetLogsRange
90
+ const $bcbfd32d0ee8ddd2$var$NEAR_HEAD_BLOCK_TAGS = new Set([
91
+ "latest",
92
+ "safe",
93
+ "finalized",
94
+ "pending"
95
+ ]);
64
96
  const $bcbfd32d0ee8ddd2$export$564dd6c0fb12e680 = (defaultChain, providers, maxBatchSize)=>{
65
97
  return (req)=>{
66
98
  const rawChainId = Array.isArray(req.query.chainId) ? req.query.chainId[0] : req.query.chainId;
@@ -133,6 +165,8 @@ const $bcbfd32d0ee8ddd2$export$5d8ee2232a9cb21a = (allowedAddress, blockEmptyAdd
133
165
  }
134
166
  if (maxBlockRange) {
135
167
  if (fromBlock === "earliest") throw new (0, $08353fa2638bb85a$export$2adbfa76b71ba748)(`RPC method eth_getLogs fromBlock is invalid`);
168
+ // Anything that is neither a hex number nor a near-head tag would skip the range check
169
+ if (!$bcbfd32d0ee8ddd2$var$HEX_BLOCK_NUMBER.test(fromBlock) && !$bcbfd32d0ee8ddd2$var$NEAR_HEAD_BLOCK_TAGS.has(fromBlock)) throw new (0, $08353fa2638bb85a$export$2adbfa76b71ba748)(`RPC method eth_getLogs fromBlock is invalid`);
136
170
  if (fromBlock.startsWith("0x")) {
137
171
  const normalizedFromBlock = BigInt(fromBlock);
138
172
  let normalizedToBlock;
@@ -189,23 +223,30 @@ const $bcbfd32d0ee8ddd2$var$createAllowedAddressMap = (allowedAddress)=>Object.e
189
223
  }, {});
190
224
 
191
225
 
192
- const $029947965efbd6c7$export$9bfcc39f106ad871 = ({ providers: providers, fetchRPC: fetchRPC, defaultChain: defaultChain, validation: validation, serverLogger: serverLogger = console, metrics: metrics })=>{
226
+ const $029947965efbd6c7$export$9bfcc39f106ad871 = ({ providers: providers, fetchRPC: fetchRPC, defaultChain: defaultChain, validation: validation, serverLogger: serverLogger = console, metrics: metrics, upstreamTimeoutMs: upstreamTimeoutMs = (0, $30c5c70af1bc69c8$export$66d7aef0343e6f4b) })=>{
193
227
  const { allowedRPCMethods: allowedRPCMethods, allowedCallAddresses: allowedCallAddresses, allowedLogsAddresses: allowedLogsAddresses, maxResponseSize: maxResponseSize = 1000000, maxBatchCount: maxBatchCount = 20, currentBlockTTLms: currentBlockTTLms = 60000, maxGetLogsRange: maxGetLogsRange = 20000, blockEmptyAddressGetLogs: blockEmptyAddressGetLogs = true } = validation;
228
+ // 'any' is an explicit opt-out: no method / address check
229
+ const rpcMethods = allowedRPCMethods === "any" ? undefined : allowedRPCMethods;
230
+ const callAddresses = allowedCallAddresses === "any" ? undefined : allowedCallAddresses;
231
+ const logsAddresses = allowedLogsAddresses === "any" ? undefined : allowedLogsAddresses;
194
232
  const rpcRequestBlocked = metrics?.rpcRequestBlocked ?? {
195
233
  inc: (_labels)=>{}
196
234
  };
197
235
  const rpcRequestMethods = metrics?.rpcRequestMethods;
198
236
  const validateBaseRequest = (0, $bcbfd32d0ee8ddd2$export$564dd6c0fb12e680)(defaultChain, providers, maxBatchCount);
199
- const validateRpcMethod = (0, $bcbfd32d0ee8ddd2$export$bd57dbd3bc9a1cc6)(allowedRPCMethods);
200
- const validateEthCall = allowedCallAddresses && (0, $bcbfd32d0ee8ddd2$export$e67f820dcb2fefda)("eth_call", allowedRPCMethods) ? (0, $bcbfd32d0ee8ddd2$export$b724143801441d66)(allowedCallAddresses) : undefined;
201
- const validateEthGetLogs = (allowedLogsAddresses || blockEmptyAddressGetLogs) && (0, $bcbfd32d0ee8ddd2$export$e67f820dcb2fefda)("eth_getLogs", allowedRPCMethods) ? (0, $bcbfd32d0ee8ddd2$export$5d8ee2232a9cb21a)(allowedLogsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms) : undefined;
237
+ const validateRpcMethod = (0, $bcbfd32d0ee8ddd2$export$bd57dbd3bc9a1cc6)(rpcMethods);
238
+ const validateEthCall = callAddresses && (0, $bcbfd32d0ee8ddd2$export$e67f820dcb2fefda)("eth_call", rpcMethods) ? (0, $bcbfd32d0ee8ddd2$export$b724143801441d66)(callAddresses) : undefined;
239
+ const validateEthGetLogs = (logsAddresses || blockEmptyAddressGetLogs) && (0, $bcbfd32d0ee8ddd2$export$e67f820dcb2fefda)("eth_getLogs", rpcMethods) ? (0, $bcbfd32d0ee8ddd2$export$5d8ee2232a9cb21a)(logsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms) : undefined;
202
240
  const validateMaxSteamSize = (0, $bcbfd32d0ee8ddd2$export$7c5a2292697deb4b)(maxResponseSize);
203
- const requestRPC = (chainId, body)=>(0, $3fL8Y$iterateUrls)(providers[chainId], (url)=>fetchRPC(url, {
204
- body: body
205
- }, {
206
- chainId: chainId
207
- }), (error)=>{
208
- const message = error instanceof Error ? error.message : String(error);
241
+ const requestRPC = (chainId, body)=>(0, $3fL8Y$iterateUrls)(providers[chainId], (url)=>(0, $30c5c70af1bc69c8$export$6d59a6fe1a73319b)(upstreamTimeoutMs, (signal)=>fetchRPC(url, {
242
+ body: body,
243
+ ...signal ? {
244
+ signal: signal
245
+ } : {}
246
+ }, {
247
+ chainId: chainId
248
+ })), (error)=>{
249
+ const message = (0, $bd97b350d73505d4$export$dac76f5d4966dbe0)(error instanceof Error ? error.message : String(error));
209
250
  serverLogger.warn(`[rpcFactory] provider failed for chain ${chainId}: ${message}`);
210
251
  });
211
252
  return async (request, reply)=>{
@@ -226,15 +267,33 @@ const $029947965efbd6c7$export$9bfcc39f106ad871 = ({ providers: providers, fetch
226
267
  if (req.method === "eth_getLogs" && validateEthGetLogs) await validateEthGetLogs(req, validationContext);
227
268
  }
228
269
  const proxiedRPC = await requestRPC(chainId, request.body);
270
+ // iterateUrls returns the last response when no provider answered ok;
271
+ // never relay a provider's error body to the client as a success.
272
+ if (!proxiedRPC.ok) {
273
+ await proxiedRPC.body?.cancel().catch(()=>undefined);
274
+ reply.status(502).send((0, $08353fa2638bb85a$export$c982278a0ddc4dbe));
275
+ return;
276
+ }
277
+ // Reject a declared oversized body before streaming starts — once bytes are on the
278
+ // wire the status can no longer change and the stream is only cut short.
279
+ const contentLength = Number(proxiedRPC.headers.get("content-length"));
280
+ if (contentLength > maxResponseSize) {
281
+ await proxiedRPC.body?.cancel().catch(()=>undefined);
282
+ rpcRequestBlocked.inc({
283
+ reason: "response too large"
284
+ });
285
+ throw new (0, $08353fa2638bb85a$export$e224c1080d950012)(`Stream size exceeds the maximum limit of ${maxResponseSize} bytes`);
286
+ }
229
287
  reply.header("content-type", proxiedRPC.headers.get("content-type") ?? "application/json");
230
288
  if (!proxiedRPC.body) throw new Error("There are problems with RPC provider");
231
289
  await (0, $3fL8Y$pipeline)((0, $3fL8Y$Readable).fromWeb(proxiedRPC.body), validateMaxSteamSize(validationContext), reply.raw, {
232
290
  signal: abortController.signal
233
291
  });
234
292
  } catch (error) {
235
- if (error instanceof (0, $08353fa2638bb85a$export$bb8c263ad32caa8)) reply.status(400).send(error.message ?? (0, $08353fa2638bb85a$export$c982278a0ddc4dbe));
236
- else if (error instanceof Error) {
237
- serverLogger.error("[rpcFactory] " + (error.message ?? (0, $08353fa2638bb85a$export$c982278a0ddc4dbe)));
293
+ if (error instanceof (0, $08353fa2638bb85a$export$bb8c263ad32caa8)) {
294
+ if (!reply.raw.headersSent) reply.status(error instanceof (0, $08353fa2638bb85a$export$e224c1080d950012) ? 413 : 400).send(error.message ?? (0, $08353fa2638bb85a$export$c982278a0ddc4dbe));
295
+ } else if (error instanceof Error) {
296
+ serverLogger.error("[rpcFactory] " + (0, $bd97b350d73505d4$export$dac76f5d4966dbe0)(error.message ?? (0, $08353fa2638bb85a$export$c982278a0ddc4dbe)));
238
297
  if (!reply.sent) reply.status(500).send((0, $08353fa2638bb85a$export$c982278a0ddc4dbe));
239
298
  } else reply.status(500).send((0, $08353fa2638bb85a$export$56a189db5508cdcb));
240
299
  } finally{
@@ -324,6 +383,7 @@ const $1c9c619b47f976c3$export$d4d313c44e137fbd = ({ max: max, windowSec: window
324
383
 
325
384
 
326
385
 
386
+
327
387
  const $a1556d9841a42cbe$var$DEFAULT_HEALTH_TIMEOUT_MS = 5000;
328
388
  const $a1556d9841a42cbe$export$b1f76e97540655f3 = async (providers, { fetchRPC: fetchRPC, timeoutMs: timeoutMs = $a1556d9841a42cbe$var$DEFAULT_HEALTH_TIMEOUT_MS, onResult: onResult, logger: logger = console })=>{
329
389
  const results = await Promise.all(Object.entries(providers).map(async ([chainId, urls])=>{
@@ -343,8 +403,8 @@ const $a1556d9841a42cbe$export$b1f76e97540655f3 = async (providers, { fetchRPC:
343
403
  const { result: result } = await response.json();
344
404
  return response.ok && result != null;
345
405
  } catch (error) {
346
- const reason = error instanceof Error ? error.message : String(error);
347
- logger.warn(`[health] probe failed for chain ${chainId} url ${url}: ${reason}`);
406
+ const reason = (0, $bd97b350d73505d4$export$dac76f5d4966dbe0)(error instanceof Error ? error.message : String(error));
407
+ logger.warn(`[health] probe failed for chain ${chainId} provider ${(0, $bd97b350d73505d4$export$dac76f5d4966dbe0)(url)}: ${reason}`);
348
408
  return false;
349
409
  }
350
410
  }));
@@ -452,8 +512,9 @@ const $90dc0e357be657cf$export$b3e9bcd4083b83c6 = ({ prefix: prefix, registry: r
452
512
 
453
513
 
454
514
 
515
+ const $9178f3db36360a24$var$DEFAULT_HEALTH_CACHE_MS = 5000;
455
516
  const $9178f3db36360a24$export$be56850439a72159 = (app, options)=>{
456
- const { providers: providers, defaultChain: defaultChain, fetchRPC: fetchRPC, metrics: metrics, validation: validation, rateLimit: rateLimit, healthTimeoutMs: healthTimeoutMs, serverLogger: serverLogger } = options;
517
+ const { providers: providers, defaultChain: defaultChain, fetchRPC: fetchRPC, metrics: metrics, validation: validation, rateLimit: rateLimit, healthTimeoutMs: healthTimeoutMs, healthCacheMs: healthCacheMs = $9178f3db36360a24$var$DEFAULT_HEALTH_CACHE_MS, upstreamTimeoutMs: upstreamTimeoutMs, serverLogger: serverLogger } = options;
457
518
  // Route label uses the matched route template (e.g. "/rpc"), not request.url —
458
519
  // avoid request.url here because unmatched URLs (404s) can blow up label
459
520
  // cardinality, hence the 'unknown' fallback instead. status is the aggregated
@@ -466,8 +527,12 @@ const $9178f3db36360a24$export$be56850439a72159 = (app, options)=>{
466
527
  }, reply.elapsedTime / 1000);
467
528
  done();
468
529
  });
469
- app.get("/health", async (_req, reply)=>{
470
- const checks = await (0, $a1556d9841a42cbe$export$b1f76e97540655f3)(providers, {
530
+ // A probe in flight is shared by every request that arrives meanwhile, and its result is
531
+ // reused for healthCacheMs after it settles, so /health cannot be used to multiply upstream calls.
532
+ let cachedProbe;
533
+ const probe = ()=>{
534
+ if (cachedProbe && Date.now() < cachedProbe.expiresAt) return cachedProbe.checks;
535
+ const checks = (0, $a1556d9841a42cbe$export$b1f76e97540655f3)(providers, {
471
536
  fetchRPC: fetchRPC,
472
537
  timeoutMs: healthTimeoutMs,
473
538
  onResult: ({ chainId: chainId, ok: ok })=>metrics.rpcChainReachable.set({
@@ -475,6 +540,18 @@ const $9178f3db36360a24$export$be56850439a72159 = (app, options)=>{
475
540
  }, ok ? 1 : 0),
476
541
  logger: serverLogger
477
542
  });
543
+ if (healthCacheMs > 0) {
544
+ const entry = {
545
+ checks: checks,
546
+ expiresAt: Infinity
547
+ };
548
+ cachedProbe = entry;
549
+ checks.then(()=>entry.expiresAt = Date.now() + healthCacheMs, ()=>entry.expiresAt = 0);
550
+ }
551
+ return checks;
552
+ };
553
+ app.get("/health", async (_req, reply)=>{
554
+ const checks = await probe();
478
555
  const healthy = checks.every((c)=>c.ok);
479
556
  // Structured JSON (status code still carries the pass/fail signal for simple
480
557
  // probes like a Dockerfile's `wget --spider`) so infra/dashboards hitting this
@@ -500,7 +577,8 @@ const $9178f3db36360a24$export$be56850439a72159 = (app, options)=>{
500
577
  rpcRequestMethods: metrics.rpcRequestMethods
501
578
  },
502
579
  validation: validation,
503
- serverLogger: serverLogger
580
+ serverLogger: serverLogger,
581
+ upstreamTimeoutMs: upstreamTimeoutMs
504
582
  });
505
583
  const rpcRateLimit = (0, $1c9c619b47f976c3$export$d4d313c44e137fbd)({
506
584
  max: rateLimit.max,
@@ -1 +1 @@
1
- {"mappings":"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","sources":["packages/api/rpc-proxy/src/index.ts","packages/api/rpc-proxy/src/rpcFactory/rpcFactory.ts","packages/api/rpc-proxy/src/rpcFactory/errors.ts","packages/api/rpc-proxy/src/rpcFactory/validation.ts","packages/api/rpc-proxy/src/rpcFactory/types.ts","packages/api/rpc-proxy/src/rateLimit/rateLimit.ts","packages/api/rpc-proxy/src/rateLimit/constants.ts","packages/api/rpc-proxy/src/rateLimit/fixedWindowStore.ts","packages/api/rpc-proxy/src/rateLimit/getClientIp.ts","packages/api/rpc-proxy/src/health.ts","packages/api/rpc-proxy/src/metrics.ts","packages/api/rpc-proxy/src/routes.ts"],"sourcesContent":["export { rpcFactory } from './rpcFactory/rpcFactory'\nexport * from './rpcFactory/types'\nexport * from './rpcFactory/errors'\nexport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './rpcFactory/validation'\n\nexport { createRateLimitHook } from './rateLimit/rateLimit'\nexport type { RateLimitOptions } from './rateLimit/rateLimit'\nexport { FixedWindowStore } from './rateLimit/fixedWindowStore'\nexport { getClientIp, normalizeIp } from './rateLimit/getClientIp'\nexport { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './rateLimit/constants'\n\nexport { probeChains } from './health'\nexport type { ChainProbeResult, ProbeChainsOptions } from './health'\n\nexport { createRpcProxyMetrics } from './metrics'\nexport type { CreateRpcProxyMetricsOptions, RpcProxyMetrics } from './metrics'\n\nexport { registerRpcProxyRoutes } from './routes'\nexport type { RegisterRpcProxyRoutesOptions } from './routes'\n","// RPC proxy factory adapted from the @lidofinance/next-api-wrapper rpcFactory pattern\n// (https://github.com/lidofinance/lido-frontend-template).\n// Changes from the original:\n// - Ported from Next.js API routes to Fastify request handlers\n// - Added per-chain contract-address allowlist (eth_call / eth_getLogs restriction)\n// - Integrated @lidofinance/api-rpc trackedFetchRpcFactory for prom-client metrics\nimport { Readable } from 'node:stream'\nimport { pipeline } from 'node:stream/promises'\nimport { ReadableStream } from 'node:stream/web'\nimport { iterateUrls } from '@lidofinance/rpc'\n\nimport { ClientError, DEFAULT_API_ERROR_MESSAGE, HEALTHY_RPC_SERVICES_ARE_OVER } from './errors'\n\nimport type { RPCFactoryParams } from './types'\nimport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './validation'\nimport type { FetchRpcInitBody } from '@lidofinance/rpc'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\ntype RpcQuery = { chainId?: string }\n\nexport const rpcFactory = ({\n providers,\n fetchRPC,\n defaultChain,\n validation,\n serverLogger = console,\n metrics,\n}: RPCFactoryParams) => {\n const {\n allowedRPCMethods,\n allowedCallAddresses,\n allowedLogsAddresses,\n maxResponseSize = 1_000_000,\n maxBatchCount = 20,\n currentBlockTTLms = 60_000,\n maxGetLogsRange = 20_000,\n blockEmptyAddressGetLogs = true,\n } = validation\n\n const rpcRequestBlocked = metrics?.rpcRequestBlocked ?? {\n inc: (_labels: { reason: string }) => {},\n }\n const rpcRequestMethods = metrics?.rpcRequestMethods\n\n const validateBaseRequest = baseRequestValidationFactory(defaultChain, providers, maxBatchCount)\n const validateRpcMethod = rpcMethodsValidationFactory(allowedRPCMethods)\n\n const validateEthCall =\n allowedCallAddresses && shouldValidateRpcMethod('eth_call', allowedRPCMethods)\n ? ethCallValidationFactory(allowedCallAddresses)\n : undefined\n\n const validateEthGetLogs =\n (allowedLogsAddresses || blockEmptyAddressGetLogs) && shouldValidateRpcMethod('eth_getLogs', allowedRPCMethods)\n ? ethGetLogsValidationFactory(allowedLogsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms)\n : undefined\n\n const validateMaxSteamSize = streamMaxSizeValidationFactory(maxResponseSize)\n\n const requestRPC = (chainId: number, body: FetchRpcInitBody) =>\n iterateUrls(\n providers[chainId],\n (url: string) => fetchRPC(url, { body }, { chainId }),\n (error: unknown) => {\n const message = error instanceof Error ? error.message : String(error)\n serverLogger.warn(`[rpcFactory] provider failed for chain ${chainId}: ${message}`)\n },\n )\n\n return async (request: FastifyRequest<{ Querystring: RpcQuery }>, reply: FastifyReply): Promise<void> => {\n const abortController = new AbortController()\n try {\n const { chainId, requests } = validateBaseRequest(request)\n\n const validationContext = { chainId, rpcRequestBlocked, requestRPC }\n\n for (const req of requests) {\n validateRpcMethod(req, validationContext)\n rpcRequestMethods?.inc({ method: req.method })\n\n if (req.method === 'eth_call' && validateEthCall) {\n validateEthCall(req, validationContext)\n }\n if (req.method === 'eth_getLogs' && validateEthGetLogs) {\n await validateEthGetLogs(req, validationContext)\n }\n }\n\n const proxiedRPC = await requestRPC(chainId, request.body as FetchRpcInitBody)\n\n void reply.header('content-type', proxiedRPC.headers.get('content-type') ?? 'application/json')\n\n if (!proxiedRPC.body) {\n throw new Error('There are problems with RPC provider')\n }\n\n await pipeline(\n Readable.fromWeb(proxiedRPC.body as ReadableStream),\n validateMaxSteamSize(validationContext),\n reply.raw,\n { signal: abortController.signal },\n )\n } catch (error) {\n if (error instanceof ClientError) {\n void reply.status(400).send(error.message ?? DEFAULT_API_ERROR_MESSAGE)\n } else if (error instanceof Error) {\n serverLogger.error('[rpcFactory] ' + (error.message ?? DEFAULT_API_ERROR_MESSAGE))\n if (!reply.sent) {\n void reply.status(500).send(DEFAULT_API_ERROR_MESSAGE)\n }\n } else {\n void reply.status(500).send(HEALTHY_RPC_SERVICES_ARE_OVER)\n }\n } finally {\n abortController.abort()\n }\n }\n}\n","export const DEFAULT_API_ERROR_MESSAGE = 'Something went wrong. Sorry, try again later :('\n\nexport const HEALTHY_RPC_SERVICES_ARE_OVER = 'Healthy RPC services are over!'\n\nexport class ClientError extends Error {}\n\nexport class UnsupportedChainIdError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported chainId')\n }\n}\n\nexport class UnsupportedHTTPMethodError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported HTTP method')\n }\n}\n\nexport class InvalidRequestError extends ClientError {\n constructor(message?: string) {\n super(message || 'Invalid Request')\n }\n}\n\nexport class SizeTooLargeError extends ClientError {\n constructor(message?: string) {\n super(message || 'Response size too large')\n }\n}\n","import { Transform } from 'node:stream'\n\nimport { Cache } from 'memory-cache'\n\nimport { ClientError, InvalidRequestError, SizeTooLargeError, UnsupportedChainIdError } from './errors'\n\nimport type { RpcRequest, ValidationContext } from './types'\n\ntype BaseRequest = {\n query: { chainId?: string | string[] }\n body: unknown\n}\n\n// BigInt(0), not a 0n literal — this file is type-checked under the repo's shared\n// root tsconfig (target es5) whenever a sibling package without its own tsconfig\n// runs `tsc`, and BigInt literal syntax requires an ES2020+ target to parse.\nconst zeroBN = BigInt(0)\n\nexport const baseRequestValidationFactory = (\n defaultChain: number | string,\n providers: Record<string, unknown>,\n maxBatchSize?: number,\n) => {\n return (req: BaseRequest) => {\n const rawChainId = Array.isArray(req.query.chainId) ? req.query.chainId[0] : req.query.chainId\n\n const chainId = Number(rawChainId || defaultChain)\n\n if (providers[chainId] == null) {\n throw new UnsupportedChainIdError()\n }\n\n const requests = Array.isArray(req.body) ? req.body : [req.body]\n\n if (typeof maxBatchSize === 'number' && requests.length > maxBatchSize) {\n throw new InvalidRequestError(`Too many batched requests`)\n }\n return { chainId, requests }\n }\n}\n\nexport const rpcMethodsValidationFactory = (allowedMethods?: string[]) => {\n const methodsMap = new Set(allowedMethods ?? [])\n\n return (request: RpcRequest, context: ValidationContext) => {\n const method = request.method\n if (typeof method !== 'string') {\n throw new InvalidRequestError(`RPC method isn't string`)\n }\n if (allowedMethods && !methodsMap.has(request.method)) {\n context.rpcRequestBlocked.inc({ reason: 'method not allowed' })\n throw new InvalidRequestError(`RPC method ${method} not allowed`)\n }\n }\n}\n\nexport const ethCallValidationFactory = (allowedAddress: Record<number, string[]>) => {\n const allowedCallAddressMap = createAllowedAddressMap(allowedAddress)\n\n return (request: RpcRequest, { chainId, rpcRequestBlocked }: ValidationContext) => {\n const { params } = request\n\n // Explicitly reject any request whose first param is not a well-formed tx object.\n // Using an early-return guard keeps the \"address allowed?\" check unconditionally\n // reachable and prevents future edits to the condition from accidentally creating\n // a path that forwards an unvalidated eth_call.\n const txObject = Array.isArray(params) ? params[0] : undefined\n\n if (\n txObject == null ||\n typeof txObject !== 'object' ||\n !('to' in txObject) ||\n typeof (txObject as Record<string, unknown>).to !== 'string'\n ) {\n throw new InvalidRequestError(`RPC method eth_call is invalid`)\n }\n\n const toAddress = (txObject as { to: string }).to\n\n if (!allowedCallAddressMap[chainId]?.has(toAddress.toLowerCase())) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_call' })\n throw new InvalidRequestError(`Address not allowed for eth_call`)\n }\n }\n}\n\nexport const ethGetLogsValidationFactory = (\n allowedAddress: Record<number, string[]> | undefined,\n blockEmptyAddressGetLogs: boolean | undefined,\n maxBlockRange: number | undefined,\n currentBlockTTL = 60_000,\n) => {\n const allowedAddressMap = createAllowedAddressMap(allowedAddress ?? {})\n const maxBlockRangeBN = maxBlockRange ? BigInt(maxBlockRange) : zeroBN\n const currentBlock = new Cache<number, bigint>()\n\n return async (request: RpcRequest, { chainId, rpcRequestBlocked, requestRPC }: ValidationContext) => {\n try {\n const params = request.params[0] as any\n const fromBlock: string = params.fromBlock\n const toBlock: string = params.toBlock ?? 'latest'\n\n if (blockEmptyAddressGetLogs || allowedAddress) {\n const address: string | string[] = params.address\n\n if (blockEmptyAddressGetLogs && !address)\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n\n const addresses = Array.isArray(address) ? address : [address]\n\n if (blockEmptyAddressGetLogs && addresses.length === 0) {\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n }\n if (\n allowedAddress &&\n addresses.some(\n (eventAddress) =>\n typeof eventAddress !== 'string' || !allowedAddressMap[chainId]?.has(eventAddress.toLowerCase()),\n )\n ) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_getLogs' })\n throw new InvalidRequestError(`Address not allowed for eth_getLogs`)\n }\n }\n\n if (maxBlockRange) {\n if (fromBlock === 'earliest') throw new InvalidRequestError(`RPC method eth_getLogs fromBlock is invalid`)\n\n if (fromBlock.startsWith('0x')) {\n const normalizedFromBlock = BigInt(fromBlock)\n let normalizedToBlock: bigint\n\n if (toBlock.startsWith('0x')) {\n normalizedToBlock = BigInt(toBlock)\n } else {\n const cached = currentBlock.get(chainId)\n if (cached) {\n normalizedToBlock = cached\n } else {\n normalizedToBlock = await requestRPC(chainId, {\n id: 1,\n jsonrpc: '2.0',\n method: 'eth_blockNumber',\n })\n .then((res) => res.json() as Promise<{ result: string }>)\n .then((res) => BigInt(res.result))\n currentBlock.put(chainId, normalizedToBlock, currentBlockTTL)\n }\n }\n\n const range = normalizedToBlock - normalizedFromBlock\n if (range < zeroBN || range > maxBlockRangeBN) {\n rpcRequestBlocked.inc({ reason: 'eth_getLogs range is invalid' })\n throw new InvalidRequestError(`RPC method eth_getLogs range is invalid`)\n }\n }\n }\n } catch (error) {\n if (error instanceof ClientError) throw error\n throw new InvalidRequestError(`RPC method eth_getLogs is invalid`)\n }\n }\n}\n\nexport const streamMaxSizeValidationFactory = (MAX_SIZE: number) => (context: ValidationContext) => {\n let bytesWritten = 0\n return new Transform({\n transform(chunk, _encoding, callback) {\n bytesWritten += chunk.length\n if (bytesWritten > MAX_SIZE) {\n context.rpcRequestBlocked.inc({ reason: 'response too large' })\n return callback(new SizeTooLargeError(`Stream size exceeds the maximum limit of ${MAX_SIZE} bytes`))\n }\n return callback(null, chunk)\n },\n flush(callback) {\n callback()\n },\n })\n}\n\n// utils\n\nexport const shouldValidateRpcMethod = (method: string, allowedRPCMethods?: string[]) =>\n !allowedRPCMethods || allowedRPCMethods.includes(method)\n\nconst createAllowedAddressMap = (allowedAddress: Record<number, string[]>) =>\n Object.entries(allowedAddress).reduce((acc, [chainId, addresses]) => {\n acc[chainId] = new Set(addresses.map((a) => a.toLowerCase()))\n return acc\n }, {} as Record<string, Set<string>>)\n","import type { FetchRpcInit, FetchRpcInitBody } from '@lidofinance/rpc'\n\nexport type RpcProviders = Record<string | number, [string, ...string[]]>\n\nexport type RPCFactoryValidationParams = {\n maxBatchCount?: number\n maxResponseSize?: number\n allowedRPCMethods?: string[]\n allowedCallAddresses?: Record<number, string[]>\n allowedLogsAddresses?: Record<number, string[]>\n blockEmptyAddressGetLogs?: boolean\n maxGetLogsRange?: number\n currentBlockTTLms?: number\n}\n\nexport type FetchRPC = (url: string, init: FetchRpcInit, meta: { chainId: number | string }) => Promise<Response>\n\nexport type RPCFactoryMetrics = {\n rpcRequestBlocked: RpcRequestBlockedCounter\n rpcRequestMethods?: { inc(labels: { method: string }): void }\n}\n\nexport type RPCFactoryParams = {\n providers: RpcProviders\n fetchRPC: FetchRPC\n defaultChain: string | number\n validation: RPCFactoryValidationParams\n serverLogger?: Pick<Console, 'warn' | 'error'>\n metrics?: RPCFactoryMetrics\n}\n\nexport type RpcRequest = {\n method: string\n params: unknown[]\n}\n\nexport type RpcRequestBlockedCounter = {\n inc(labels: { reason: string }): void\n}\n\nexport type ValidationContext = {\n chainId: number\n rpcRequestBlocked: RpcRequestBlockedCounter\n requestRPC: (chainId: number, body: FetchRpcInitBody) => Promise<Response>\n}\n","import { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './constants'\nimport { FixedWindowStore } from './fixedWindowStore'\nimport { getClientIp } from './getClientIp'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\nexport type RateLimitOptions = {\n max: number\n windowSec: number\n customIpHeader?: string\n onBlocked?: (ip: string) => void\n}\n\n// Fixed-window per-IP limiter, adapted as a Fastify preHandler from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit\n// (a Next.js API-route wrapper — this repo has no Next.js, so the counting\n// and IP-extraction ideas are ported by hand rather than installed).\n// One store instance per createRateLimitHook call — call it once per route so\n// separate routes (e.g. /rpc and /api/csp-report) don't share a budget.\nexport const createRateLimitHook = ({ max, windowSec, customIpHeader, onBlocked }: RateLimitOptions) => {\n const store = new FixedWindowStore()\n\n return async (req: FastifyRequest, reply: FastifyReply): Promise<void> => {\n const ip = getClientIp(req, customIpHeader)\n const now = Date.now() / 1000\n const window = Math.floor(now / windowSec)\n const key = `${ip}:${window}`\n\n const count = store.increment(key, windowSec)\n const remaining = max - count\n const reset = (window + 1) * windowSec\n\n void reply.header(RATE_LIMIT_HEADERS.limit, String(max))\n void reply.header(RATE_LIMIT_HEADERS.remaining, String(Math.max(remaining, 0)))\n void reply.header(RATE_LIMIT_HEADERS.reset, String(reset))\n\n if (remaining < 0) {\n const retryAfter = Math.max(Math.ceil(reset - now), 0)\n void reply.header('Retry-After', String(retryAfter))\n onBlocked?.(ip)\n void reply.status(429).send(`${RATE_LIMIT_ERROR_MESSAGE} for ip:${ip}`)\n }\n }\n}\n","export const RATE_LIMIT_HEADERS = {\n limit: 'X-RateLimit-Limit',\n remaining: 'X-RateLimit-Remaining',\n reset: 'X-RateLimit-Reset',\n} as const\n\nexport const RATE_LIMIT_ERROR_MESSAGE = 'Rate limit exceeded'\n","type StoreEntry = { value: number; timeoutId: NodeJS.Timeout }\n\n// Fixed-window counter: each key auto-expires durationSec after it was last\n// touched, so no separate sweep/cron is needed to bound memory. Adapted from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/storage.ts,\n// itself based on nestjs/throttler's setTimeout-per-key approach.\nexport class FixedWindowStore {\n private store = new Map<string, StoreEntry>()\n\n private set(key: string, value: number, durationSec: number) {\n clearTimeout(this.store.get(key)?.timeoutId)\n\n const timeoutId = setTimeout(() => this.store.delete(key), durationSec * 1000)\n // This is a cache-eviction timer, not pending work — it must not keep the\n // process alive on its own (matters for a long-running server, unlike the\n // serverless functions the ported design originally ran in).\n timeoutId.unref()\n\n this.store.set(key, { value, timeoutId })\n }\n\n get(key: string): number | undefined {\n return this.store.get(key)?.value\n }\n\n increment(key: string, durationSec: number): number {\n const next = (this.get(key) ?? 0) + 1\n this.set(key, next, durationSec)\n return next\n }\n}\n","import { isIP } from 'node:net'\nimport type { FastifyRequest } from 'fastify'\n\nexport const normalizeIp = (ip: string): string => ip.trim().replace(/^::ffff:/i, '')\n\nconst firstValidIp = (value: string | string[] | undefined): string | undefined => {\n const raw = Array.isArray(value) ? value[0] : value\n if (!raw) return undefined\n const candidate = normalizeIp(raw.split(',')[0] ?? '')\n return candidate && isIP(candidate) ? candidate : undefined\n}\n\n// req.ip is already the right answer for X-Forwarded-For: Fastify's trustProxy\n// option (see server/index.ts, set to TRUSTED_PROXY_HOPS) walks exactly that\n// many hops back through the header via @fastify/proxy-addr, which is the\n// correct way to find the real client through this app's one nginx hop. X-\n// Forwarded-For is never read directly here — a client can set that header to\n// anything, and only Fastify's hop-counted view of it is trustworthy.\n//\n// customIpHeader is for an edge/CDN in front of nginx (e.g. Cloudflare's\n// cf-connecting-ip) that knows the client's IP authoritatively, independent of\n// hop counting. It's validated with isIP so a spoofed or garbage value falls\n// through to req.ip instead of being trusted blindly — ported from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/utils.ts,\n// adapted from Next's per-request customIpHeader to Fastify + trustProxy.\nexport const getClientIp = (req: FastifyRequest, customIpHeader?: string): string => {\n const customIp = customIpHeader ? firstValidIp(req.headers[customIpHeader.toLowerCase()]) : undefined\n\n return customIp ?? normalizeIp(req.ip || '0.0.0.0')\n}\n","import type { FetchRPC, RpcProviders } from './rpcFactory/types'\n\nexport type ChainProbeResult = { chainId: string; ok: boolean }\n\nexport type ProbeChainsOptions = {\n fetchRPC: FetchRPC\n timeoutMs?: number\n onResult?: (result: ChainProbeResult) => void\n logger?: Pick<Console, 'warn'>\n}\n\nconst DEFAULT_HEALTH_TIMEOUT_MS = 5_000\n\n// Probes every configured URL per chain in parallel — matching the runtime fallback\n// semantics of iterateUrls in rpcFactory. A chain is healthy when at least one URL\n// responds, so a single-provider outage doesn't fail a proxy that has working fallbacks.\nexport const probeChains = async (\n providers: RpcProviders,\n { fetchRPC, timeoutMs = DEFAULT_HEALTH_TIMEOUT_MS, onResult, logger = console }: ProbeChainsOptions,\n): Promise<ChainProbeResult[]> => {\n const results = await Promise.all(\n Object.entries(providers).map(async ([chainId, urls]) => {\n const urlResults = await Promise.all(\n urls.map(async (url) => {\n try {\n const response = await fetchRPC(\n url,\n {\n body: { id: 1, jsonrpc: '2.0', method: 'eth_blockNumber', params: [] },\n signal: AbortSignal.timeout(timeoutMs),\n },\n { chainId },\n )\n const { result } = (await response.json()) as { result?: unknown }\n return response.ok && result != null\n } catch (error) {\n const reason = error instanceof Error ? error.message : String(error)\n logger.warn(`[health] probe failed for chain ${chainId} url ${url}: ${reason}`)\n return false\n }\n }),\n )\n const ok = urlResults.some(Boolean)\n return { chainId, ok }\n }),\n )\n for (const result of results) {\n onResult?.(result)\n }\n return results\n}\n","import { trackedFetchRpcFactory } from '@lidofinance/api-rpc'\nimport { Counter, Gauge, Histogram, Registry, collectDefaultMetrics } from 'prom-client'\n\nimport type { FetchRPC } from './rpcFactory/types'\n\nexport type RpcProxyMetrics = {\n registry: Registry\n fetchRPC: FetchRPC\n rpcRequestBlocked: Counter<'reason'>\n rpcRequestMethods: Counter<'method'>\n rateLimitBlockedCount: Counter<'route'>\n apiResponse: Histogram<'method' | 'route' | 'status'>\n rpcChainReachable: Gauge<'chainId'>\n}\n\nexport type CreateRpcProxyMetricsOptions = {\n // Prefix applied to every metric name registered by this factory, including the\n // request/response counters trackedFetchRpcFactory registers into `registry`.\n prefix: string\n registry?: Registry\n // Set false when the consuming app already calls prom-client's collectDefaultMetrics\n // itself (e.g. to combine it with its own startup metrics) — avoids double-registering.\n collectDefault?: boolean\n}\n\n// Prom-client metrics for a Fastify RPC proxy: blocked/allowed request counts,\n// per-IP rate-limit blocks, HTTP response timings and per-chain reachability —\n// plus a metrics-tracked fetchRPC (via @lidofinance/api-rpc) to pass into rpcFactory.\nexport const createRpcProxyMetrics = ({\n prefix,\n registry = new Registry(),\n collectDefault = true,\n}: CreateRpcProxyMetricsOptions): RpcProxyMetrics => {\n const rpcRequestBlocked = new Counter({\n name: `${prefix}rpc_request_blocked_total`,\n help: 'Number of blocked RPC requests by reason',\n labelNames: ['reason'] as const,\n registers: [registry],\n })\n\n // Client-requested RPC methods, counted at validation time — before a request is\n // blocked or forwarded. Distinct from fetchRPC's own request-methods counter (from\n // @lidofinance/api-rpc), which only counts methods that actually reached a provider.\n const rpcRequestMethods = new Counter({\n name: `${prefix}rpc_request_methods`,\n help: 'RPC methods requested by clients, by method',\n labelNames: ['method'] as const,\n registers: [registry],\n })\n\n const rateLimitBlockedCount = new Counter({\n name: `${prefix}rate_limit_blocked_total`,\n help: 'Number of requests rejected by the in-process per-IP rate limiter, by route',\n labelNames: ['route'] as const,\n registers: [registry],\n })\n\n const apiResponse = new Histogram({\n name: `${prefix}api_response_seconds`,\n help: 'API response time',\n buckets: [0.1, 0.2, 0.3, 0.6, 1, 1.5, 2, 5],\n labelNames: ['method', 'route', 'status'] as const,\n registers: [registry],\n })\n\n const rpcChainReachable = new Gauge({\n name: `${prefix}rpc_chain_reachable`,\n help: '1 if the RPC endpoint for the chain is reachable, 0 otherwise',\n labelNames: ['chainId'] as const,\n registers: [registry],\n })\n\n // Registers its own request/response/methods/result counters into `registry`.\n const fetchRPC = trackedFetchRpcFactory({ prefix, registry })\n\n if (collectDefault) {\n collectDefaultMetrics({ register: registry, prefix })\n }\n\n return {\n registry,\n fetchRPC,\n rpcRequestBlocked,\n rpcRequestMethods,\n rateLimitBlockedCount,\n apiResponse,\n rpcChainReachable,\n }\n}\n","import { getStatusLabel } from '@lidofinance/api-metrics'\n\nimport { probeChains } from './health'\nimport { createRateLimitHook } from './rateLimit/rateLimit'\nimport { rpcFactory } from './rpcFactory/rpcFactory'\n\nimport type { RpcProxyMetrics } from './metrics'\nimport type { RPCFactoryValidationParams, FetchRPC, RpcProviders } from './rpcFactory/types'\nimport type { FastifyInstance } from 'fastify'\n\nexport type RegisterRpcProxyRoutesOptions = {\n providers: RpcProviders\n defaultChain: string | number\n fetchRPC: FetchRPC\n metrics: RpcProxyMetrics\n validation: RPCFactoryValidationParams\n rateLimit: {\n max: number\n windowSec: number\n customIpHeader?: string\n }\n healthTimeoutMs?: number\n serverLogger?: Pick<Console, 'warn' | 'error'>\n}\n\n// Wires /health, /metrics and /rpc onto a Fastify instance. Anything app-specific —\n// CSP reporting, extra routes, the fastify() bootstrap itself — stays with the caller.\nexport const registerRpcProxyRoutes = (app: FastifyInstance, options: RegisterRpcProxyRoutesOptions) => {\n const { providers, defaultChain, fetchRPC, metrics, validation, rateLimit, healthTimeoutMs, serverLogger } = options\n\n // Route label uses the matched route template (e.g. \"/rpc\"), not request.url —\n // avoid request.url here because unmatched URLs (404s) can blow up label\n // cardinality, hence the 'unknown' fallback instead. status is the aggregated\n // 2xx/4xx/… class, not the exact code.\n app.addHook('onResponse', (request, reply, done) => {\n metrics.apiResponse.observe(\n {\n method: request.method,\n route: request.routeOptions.url ?? 'unknown',\n status: getStatusLabel(reply.statusCode),\n },\n reply.elapsedTime / 1000,\n )\n done()\n })\n\n app.get('/health', async (_req, reply) => {\n const checks = await probeChains(providers, {\n fetchRPC,\n timeoutMs: healthTimeoutMs,\n onResult: ({ chainId, ok }) => metrics.rpcChainReachable.set({ chainId }, ok ? 1 : 0),\n logger: serverLogger,\n })\n const healthy = checks.every((c) => c.ok)\n // Structured JSON (status code still carries the pass/fail signal for simple\n // probes like a Dockerfile's `wget --spider`) so infra/dashboards hitting this\n // directly can see which chain is unreachable, not just an aggregate.\n return reply.status(healthy ? 200 : 503).send({\n status: healthy ? 'ok' : 'degraded',\n chains: Object.fromEntries(checks.map((c) => [c.chainId, c.ok ? 'ok' : 'unreachable'])),\n })\n })\n\n app.get('/metrics', async (_req, reply) => {\n const content = await metrics.registry.metrics()\n void reply.status(200).header('Content-Type', metrics.registry.contentType).send(content)\n })\n\n const handleRpc = rpcFactory({\n providers,\n defaultChain,\n fetchRPC,\n metrics: {\n rpcRequestBlocked: metrics.rpcRequestBlocked,\n rpcRequestMethods: metrics.rpcRequestMethods,\n },\n validation,\n serverLogger,\n })\n\n const rpcRateLimit = createRateLimitHook({\n max: rateLimit.max,\n windowSec: rateLimit.windowSec,\n customIpHeader: rateLimit.customIpHeader,\n onBlocked: () => metrics.rateLimitBlockedCount.inc({ route: '/rpc' }),\n })\n\n // Encapsulated in its own plugin context (rather than passed via the route's\n // `preHandler` option) so the rate-limit hook's untyped FastifyRequest doesn't\n // get unified with handleRpc's typed `Querystring: RpcQuery` generic — that\n // unification otherwise collapses to `unknown` and fails to typecheck.\n void app.register((scope) => {\n scope.addHook('preHandler', rpcRateLimit)\n scope.post('/rpc', handleRpc)\n return Promise.resolve()\n })\n}\n"],"names":[],"version":3,"file":"index.mjs.map","sourceRoot":"../../../../"}
1
+ {"mappings":"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","sources":["packages/api/rpc-proxy/src/index.ts","packages/api/rpc-proxy/src/rpcFactory/rpcFactory.ts","packages/api/rpc-proxy/src/redactUrls.ts","packages/api/rpc-proxy/src/rpcFactory/errors.ts","packages/api/rpc-proxy/src/rpcFactory/upstreamTimeout.ts","packages/api/rpc-proxy/src/rpcFactory/validation.ts","packages/api/rpc-proxy/src/rpcFactory/types.ts","packages/api/rpc-proxy/src/rateLimit/rateLimit.ts","packages/api/rpc-proxy/src/rateLimit/constants.ts","packages/api/rpc-proxy/src/rateLimit/fixedWindowStore.ts","packages/api/rpc-proxy/src/rateLimit/getClientIp.ts","packages/api/rpc-proxy/src/health.ts","packages/api/rpc-proxy/src/metrics.ts","packages/api/rpc-proxy/src/routes.ts"],"sourcesContent":["export { rpcFactory } from './rpcFactory/rpcFactory'\nexport * from './rpcFactory/types'\nexport * from './rpcFactory/errors'\nexport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './rpcFactory/validation'\n\nexport { createRateLimitHook } from './rateLimit/rateLimit'\nexport type { RateLimitOptions } from './rateLimit/rateLimit'\nexport { FixedWindowStore } from './rateLimit/fixedWindowStore'\nexport { getClientIp, normalizeIp } from './rateLimit/getClientIp'\nexport { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './rateLimit/constants'\n\nexport { probeChains } from './health'\nexport type { ChainProbeResult, ProbeChainsOptions } from './health'\n\nexport { createRpcProxyMetrics } from './metrics'\nexport type { CreateRpcProxyMetricsOptions, RpcProxyMetrics } from './metrics'\n\nexport { registerRpcProxyRoutes } from './routes'\nexport type { RegisterRpcProxyRoutesOptions } from './routes'\n","// RPC proxy factory adapted from the @lidofinance/next-api-wrapper rpcFactory pattern\n// (https://github.com/lidofinance/lido-frontend-template).\n// Changes from the original:\n// - Ported from Next.js API routes to Fastify request handlers\n// - Added per-chain contract-address allowlist (eth_call / eth_getLogs restriction)\n// - Integrated @lidofinance/api-rpc trackedFetchRpcFactory for prom-client metrics\nimport { Readable } from 'node:stream'\nimport { pipeline } from 'node:stream/promises'\nimport { ReadableStream } from 'node:stream/web'\nimport { iterateUrls } from '@lidofinance/rpc'\n\nimport { redactUrls } from '../redactUrls'\n\nimport { ClientError, DEFAULT_API_ERROR_MESSAGE, HEALTHY_RPC_SERVICES_ARE_OVER, SizeTooLargeError } from './errors'\nimport { DEFAULT_UPSTREAM_TIMEOUT_MS, withUpstreamTimeout } from './upstreamTimeout'\n\nimport type { RPCFactoryParams } from './types'\nimport {\n baseRequestValidationFactory,\n ethCallValidationFactory,\n ethGetLogsValidationFactory,\n rpcMethodsValidationFactory,\n shouldValidateRpcMethod,\n streamMaxSizeValidationFactory,\n} from './validation'\nimport type { FetchRpcInitBody } from '@lidofinance/rpc'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\ntype RpcQuery = { chainId?: string }\n\nexport const rpcFactory = ({\n providers,\n fetchRPC,\n defaultChain,\n validation,\n serverLogger = console,\n metrics,\n upstreamTimeoutMs = DEFAULT_UPSTREAM_TIMEOUT_MS,\n}: RPCFactoryParams) => {\n const {\n allowedRPCMethods,\n allowedCallAddresses,\n allowedLogsAddresses,\n maxResponseSize = 1_000_000,\n maxBatchCount = 20,\n currentBlockTTLms = 60_000,\n maxGetLogsRange = 20_000,\n blockEmptyAddressGetLogs = true,\n } = validation\n\n // 'any' is an explicit opt-out: no method / address check\n const rpcMethods = allowedRPCMethods === 'any' ? undefined : allowedRPCMethods\n const callAddresses = allowedCallAddresses === 'any' ? undefined : allowedCallAddresses\n const logsAddresses = allowedLogsAddresses === 'any' ? undefined : allowedLogsAddresses\n\n const rpcRequestBlocked = metrics?.rpcRequestBlocked ?? {\n inc: (_labels: { reason: string }) => {},\n }\n const rpcRequestMethods = metrics?.rpcRequestMethods\n\n const validateBaseRequest = baseRequestValidationFactory(defaultChain, providers, maxBatchCount)\n const validateRpcMethod = rpcMethodsValidationFactory(rpcMethods)\n\n const validateEthCall =\n callAddresses && shouldValidateRpcMethod('eth_call', rpcMethods)\n ? ethCallValidationFactory(callAddresses)\n : undefined\n\n const validateEthGetLogs =\n (logsAddresses || blockEmptyAddressGetLogs) && shouldValidateRpcMethod('eth_getLogs', rpcMethods)\n ? ethGetLogsValidationFactory(logsAddresses, blockEmptyAddressGetLogs, maxGetLogsRange, currentBlockTTLms)\n : undefined\n\n const validateMaxSteamSize = streamMaxSizeValidationFactory(maxResponseSize)\n\n const requestRPC = (chainId: number, body: FetchRpcInitBody) =>\n iterateUrls(\n providers[chainId],\n (url: string) =>\n withUpstreamTimeout(upstreamTimeoutMs, (signal) =>\n fetchRPC(url, { body, ...(signal ? { signal } : {}) }, { chainId }),\n ),\n (error: unknown) => {\n const message = redactUrls(error instanceof Error ? error.message : String(error))\n serverLogger.warn(`[rpcFactory] provider failed for chain ${chainId}: ${message}`)\n },\n )\n\n return async (request: FastifyRequest<{ Querystring: RpcQuery }>, reply: FastifyReply): Promise<void> => {\n const abortController = new AbortController()\n try {\n const { chainId, requests } = validateBaseRequest(request)\n\n const validationContext = { chainId, rpcRequestBlocked, requestRPC }\n\n for (const req of requests) {\n validateRpcMethod(req, validationContext)\n rpcRequestMethods?.inc({ method: req.method })\n\n if (req.method === 'eth_call' && validateEthCall) {\n validateEthCall(req, validationContext)\n }\n if (req.method === 'eth_getLogs' && validateEthGetLogs) {\n await validateEthGetLogs(req, validationContext)\n }\n }\n\n const proxiedRPC = await requestRPC(chainId, request.body as FetchRpcInitBody)\n\n // iterateUrls returns the last response when no provider answered ok;\n // never relay a provider's error body to the client as a success.\n if (!proxiedRPC.ok) {\n await proxiedRPC.body?.cancel().catch(() => undefined)\n void reply.status(502).send(DEFAULT_API_ERROR_MESSAGE)\n return\n }\n\n // Reject a declared oversized body before streaming starts — once bytes are on the\n // wire the status can no longer change and the stream is only cut short.\n const contentLength = Number(proxiedRPC.headers.get('content-length'))\n if (contentLength > maxResponseSize) {\n await proxiedRPC.body?.cancel().catch(() => undefined)\n rpcRequestBlocked.inc({ reason: 'response too large' })\n throw new SizeTooLargeError(`Stream size exceeds the maximum limit of ${maxResponseSize} bytes`)\n }\n\n void reply.header('content-type', proxiedRPC.headers.get('content-type') ?? 'application/json')\n\n if (!proxiedRPC.body) {\n throw new Error('There are problems with RPC provider')\n }\n\n await pipeline(\n Readable.fromWeb(proxiedRPC.body as ReadableStream),\n validateMaxSteamSize(validationContext),\n reply.raw,\n { signal: abortController.signal },\n )\n } catch (error) {\n if (error instanceof ClientError) {\n if (!reply.raw.headersSent) {\n void reply\n .status(error instanceof SizeTooLargeError ? 413 : 400)\n .send(error.message ?? DEFAULT_API_ERROR_MESSAGE)\n }\n } else if (error instanceof Error) {\n serverLogger.error('[rpcFactory] ' + redactUrls(error.message ?? DEFAULT_API_ERROR_MESSAGE))\n if (!reply.sent) {\n void reply.status(500).send(DEFAULT_API_ERROR_MESSAGE)\n }\n } else {\n void reply.status(500).send(HEALTHY_RPC_SERVICES_ARE_OVER)\n }\n } finally {\n abortController.abort()\n }\n }\n}\n","const URL_PATTERN = /\\b(?:https?|wss?):\\/\\/[^\\s'\"<>]+/gi\n\nconst toHost = (url: string) => {\n try {\n return new URL(url).hostname\n } catch {\n return '<url>'\n }\n}\n\n// Provider URLs usually carry the API key in the path or query, so anything that\n// ends up in a log line is reduced to the provider's hostname.\nexport const redactUrls = (text: string) => text.replace(URL_PATTERN, toHost)\n","export const DEFAULT_API_ERROR_MESSAGE = 'Something went wrong. Sorry, try again later :('\n\nexport const HEALTHY_RPC_SERVICES_ARE_OVER = 'Healthy RPC services are over!'\n\nexport class ClientError extends Error {}\n\nexport class UnsupportedChainIdError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported chainId')\n }\n}\n\nexport class UnsupportedHTTPMethodError extends ClientError {\n constructor(message?: string) {\n super(message || 'Unsupported HTTP method')\n }\n}\n\nexport class InvalidRequestError extends ClientError {\n constructor(message?: string) {\n super(message || 'Invalid Request')\n }\n}\n\nexport class SizeTooLargeError extends ClientError {\n constructor(message?: string) {\n super(message || 'Response size too large')\n }\n}\n","export const DEFAULT_UPSTREAM_TIMEOUT_MS = 10_000\n\n// Runs `request` with a signal that aborts when the provider has not started answering within\n// timeoutMs. The timer stops once the request settles, i.e. when the response headers arrive,\n// so a long response body is never cut short. 0 turns the limit off.\nexport const withUpstreamTimeout = async <T>(\n timeoutMs: number,\n request: (signal?: AbortSignal) => Promise<T>,\n): Promise<T> => {\n if (!(timeoutMs > 0)) return request()\n\n const controller = new AbortController()\n const timer = setTimeout(() => controller.abort(new Error(`no response within ${timeoutMs} ms`)), timeoutMs)\n try {\n return await request(controller.signal)\n } finally {\n clearTimeout(timer)\n }\n}\n","import { Transform } from 'node:stream'\n\nimport { Cache } from 'memory-cache'\n\nimport { ClientError, InvalidRequestError, SizeTooLargeError, UnsupportedChainIdError } from './errors'\n\nimport type { RpcRequest, ValidationContext } from './types'\n\ntype BaseRequest = {\n query: { chainId?: string | string[] }\n body: unknown\n}\n\n// BigInt(0), not a 0n literal — this file is type-checked under the repo's shared\n// root tsconfig (target es5) whenever a sibling package without its own tsconfig\n// runs `tsc`, and BigInt literal syntax requires an ES2020+ target to parse.\nconst zeroBN = BigInt(0)\n\nconst HEX_BLOCK_NUMBER = /^0x[0-9a-fA-F]+$/\n// Tags that resolve within a few blocks of head, far below any sane maxGetLogsRange\nconst NEAR_HEAD_BLOCK_TAGS = new Set(['latest', 'safe', 'finalized', 'pending'])\n\nexport const baseRequestValidationFactory = (\n defaultChain: number | string,\n providers: Record<string, unknown>,\n maxBatchSize?: number,\n) => {\n return (req: BaseRequest) => {\n const rawChainId = Array.isArray(req.query.chainId) ? req.query.chainId[0] : req.query.chainId\n\n const chainId = Number(rawChainId || defaultChain)\n\n if (providers[chainId] == null) {\n throw new UnsupportedChainIdError()\n }\n\n const requests = Array.isArray(req.body) ? req.body : [req.body]\n\n if (typeof maxBatchSize === 'number' && requests.length > maxBatchSize) {\n throw new InvalidRequestError(`Too many batched requests`)\n }\n return { chainId, requests }\n }\n}\n\nexport const rpcMethodsValidationFactory = (allowedMethods?: string[]) => {\n const methodsMap = new Set(allowedMethods ?? [])\n\n return (request: RpcRequest, context: ValidationContext) => {\n const method = request.method\n if (typeof method !== 'string') {\n throw new InvalidRequestError(`RPC method isn't string`)\n }\n if (allowedMethods && !methodsMap.has(request.method)) {\n context.rpcRequestBlocked.inc({ reason: 'method not allowed' })\n throw new InvalidRequestError(`RPC method ${method} not allowed`)\n }\n }\n}\n\nexport const ethCallValidationFactory = (allowedAddress: Record<number, string[]>) => {\n const allowedCallAddressMap = createAllowedAddressMap(allowedAddress)\n\n return (request: RpcRequest, { chainId, rpcRequestBlocked }: ValidationContext) => {\n const { params } = request\n\n // Explicitly reject any request whose first param is not a well-formed tx object.\n // Using an early-return guard keeps the \"address allowed?\" check unconditionally\n // reachable and prevents future edits to the condition from accidentally creating\n // a path that forwards an unvalidated eth_call.\n const txObject = Array.isArray(params) ? params[0] : undefined\n\n if (\n txObject == null ||\n typeof txObject !== 'object' ||\n !('to' in txObject) ||\n typeof (txObject as Record<string, unknown>).to !== 'string'\n ) {\n throw new InvalidRequestError(`RPC method eth_call is invalid`)\n }\n\n const toAddress = (txObject as { to: string }).to\n\n if (!allowedCallAddressMap[chainId]?.has(toAddress.toLowerCase())) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_call' })\n throw new InvalidRequestError(`Address not allowed for eth_call`)\n }\n }\n}\n\nexport const ethGetLogsValidationFactory = (\n allowedAddress: Record<number, string[]> | undefined,\n blockEmptyAddressGetLogs: boolean | undefined,\n maxBlockRange: number | undefined,\n currentBlockTTL = 60_000,\n) => {\n const allowedAddressMap = createAllowedAddressMap(allowedAddress ?? {})\n const maxBlockRangeBN = maxBlockRange ? BigInt(maxBlockRange) : zeroBN\n const currentBlock = new Cache<number, bigint>()\n\n return async (request: RpcRequest, { chainId, rpcRequestBlocked, requestRPC }: ValidationContext) => {\n try {\n const params = request.params[0] as any\n const fromBlock: string = params.fromBlock\n const toBlock: string = params.toBlock ?? 'latest'\n\n if (blockEmptyAddressGetLogs || allowedAddress) {\n const address: string | string[] = params.address\n\n if (blockEmptyAddressGetLogs && !address)\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n\n const addresses = Array.isArray(address) ? address : [address]\n\n if (blockEmptyAddressGetLogs && addresses.length === 0) {\n throw new InvalidRequestError(`RPC method eth_getLogs address is invalid`)\n }\n if (\n allowedAddress &&\n addresses.some(\n (eventAddress) =>\n typeof eventAddress !== 'string' || !allowedAddressMap[chainId]?.has(eventAddress.toLowerCase()),\n )\n ) {\n rpcRequestBlocked.inc({ reason: 'address not allowed for eth_getLogs' })\n throw new InvalidRequestError(`Address not allowed for eth_getLogs`)\n }\n }\n\n if (maxBlockRange) {\n if (fromBlock === 'earliest') throw new InvalidRequestError(`RPC method eth_getLogs fromBlock is invalid`)\n // Anything that is neither a hex number nor a near-head tag would skip the range check\n if (!HEX_BLOCK_NUMBER.test(fromBlock) && !NEAR_HEAD_BLOCK_TAGS.has(fromBlock)) {\n throw new InvalidRequestError(`RPC method eth_getLogs fromBlock is invalid`)\n }\n\n if (fromBlock.startsWith('0x')) {\n const normalizedFromBlock = BigInt(fromBlock)\n let normalizedToBlock: bigint\n\n if (toBlock.startsWith('0x')) {\n normalizedToBlock = BigInt(toBlock)\n } else {\n const cached = currentBlock.get(chainId)\n if (cached) {\n normalizedToBlock = cached\n } else {\n normalizedToBlock = await requestRPC(chainId, {\n id: 1,\n jsonrpc: '2.0',\n method: 'eth_blockNumber',\n })\n .then((res) => res.json() as Promise<{ result: string }>)\n .then((res) => BigInt(res.result))\n currentBlock.put(chainId, normalizedToBlock, currentBlockTTL)\n }\n }\n\n const range = normalizedToBlock - normalizedFromBlock\n if (range < zeroBN || range > maxBlockRangeBN) {\n rpcRequestBlocked.inc({ reason: 'eth_getLogs range is invalid' })\n throw new InvalidRequestError(`RPC method eth_getLogs range is invalid`)\n }\n }\n }\n } catch (error) {\n if (error instanceof ClientError) throw error\n throw new InvalidRequestError(`RPC method eth_getLogs is invalid`)\n }\n }\n}\n\nexport const streamMaxSizeValidationFactory = (MAX_SIZE: number) => (context: ValidationContext) => {\n let bytesWritten = 0\n return new Transform({\n transform(chunk, _encoding, callback) {\n bytesWritten += chunk.length\n if (bytesWritten > MAX_SIZE) {\n context.rpcRequestBlocked.inc({ reason: 'response too large' })\n return callback(new SizeTooLargeError(`Stream size exceeds the maximum limit of ${MAX_SIZE} bytes`))\n }\n return callback(null, chunk)\n },\n flush(callback) {\n callback()\n },\n })\n}\n\n// utils\n\nexport const shouldValidateRpcMethod = (method: string, allowedRPCMethods?: string[]) =>\n !allowedRPCMethods || allowedRPCMethods.includes(method)\n\nconst createAllowedAddressMap = (allowedAddress: Record<number, string[]>) =>\n Object.entries(allowedAddress).reduce((acc, [chainId, addresses]) => {\n acc[chainId] = new Set(addresses.map((a) => a.toLowerCase()))\n return acc\n }, {} as Record<string, Set<string>>)\n","import type { FetchRpcInit, FetchRpcInitBody } from '@lidofinance/rpc'\n\nexport type RpcProviders = Record<string | number, [string, ...string[]]>\n\nexport type AddressAllowlist = Record<number, string[]> | 'any'\n\nexport type MethodAllowlist = string[] | 'any'\n\nexport type RPCFactoryValidationParams = {\n maxBatchCount?: number\n maxResponseSize?: number\n // Required: the allowed JSON-RPC methods, or 'any' to allow every method deliberately\n allowedRPCMethods: MethodAllowlist\n // Required: the per-chain address lists, or 'any' to allow every address\n // deliberately (e.g. user-deployed contracts)\n allowedCallAddresses: AddressAllowlist\n allowedLogsAddresses: AddressAllowlist\n blockEmptyAddressGetLogs?: boolean\n maxGetLogsRange?: number\n currentBlockTTLms?: number\n}\n\nexport type FetchRPC = (url: string, init: FetchRpcInit, meta: { chainId: number | string }) => Promise<Response>\n\nexport type RPCFactoryMetrics = {\n rpcRequestBlocked: RpcRequestBlockedCounter\n rpcRequestMethods?: { inc(labels: { method: string }): void }\n}\n\nexport type RPCFactoryParams = {\n providers: RpcProviders\n fetchRPC: FetchRPC\n defaultChain: string | number\n validation: RPCFactoryValidationParams\n serverLogger?: Pick<Console, 'warn' | 'error'>\n metrics?: RPCFactoryMetrics\n // Per-provider time limit (ms) for the provider to start answering; the response body is not timed.\n // A provider that exceeds it counts as failed and the next URL is tried. 10 000 by default, 0 turns it off.\n upstreamTimeoutMs?: number\n}\n\nexport type RpcRequest = {\n method: string\n params: unknown[]\n}\n\nexport type RpcRequestBlockedCounter = {\n inc(labels: { reason: string }): void\n}\n\nexport type ValidationContext = {\n chainId: number\n rpcRequestBlocked: RpcRequestBlockedCounter\n requestRPC: (chainId: number, body: FetchRpcInitBody) => Promise<Response>\n}\n","import { RATE_LIMIT_ERROR_MESSAGE, RATE_LIMIT_HEADERS } from './constants'\nimport { FixedWindowStore } from './fixedWindowStore'\nimport { getClientIp } from './getClientIp'\nimport type { FastifyReply, FastifyRequest } from 'fastify'\n\nexport type RateLimitOptions = {\n max: number\n windowSec: number\n customIpHeader?: string\n onBlocked?: (ip: string) => void\n}\n\n// Fixed-window per-IP limiter, adapted as a Fastify preHandler from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit\n// (a Next.js API-route wrapper — this repo has no Next.js, so the counting\n// and IP-extraction ideas are ported by hand rather than installed).\n// One store instance per createRateLimitHook call — call it once per route so\n// separate routes (e.g. /rpc and /api/csp-report) don't share a budget.\nexport const createRateLimitHook = ({ max, windowSec, customIpHeader, onBlocked }: RateLimitOptions) => {\n const store = new FixedWindowStore()\n\n return async (req: FastifyRequest, reply: FastifyReply): Promise<void> => {\n const ip = getClientIp(req, customIpHeader)\n const now = Date.now() / 1000\n const window = Math.floor(now / windowSec)\n const key = `${ip}:${window}`\n\n const count = store.increment(key, windowSec)\n const remaining = max - count\n const reset = (window + 1) * windowSec\n\n void reply.header(RATE_LIMIT_HEADERS.limit, String(max))\n void reply.header(RATE_LIMIT_HEADERS.remaining, String(Math.max(remaining, 0)))\n void reply.header(RATE_LIMIT_HEADERS.reset, String(reset))\n\n if (remaining < 0) {\n const retryAfter = Math.max(Math.ceil(reset - now), 0)\n void reply.header('Retry-After', String(retryAfter))\n onBlocked?.(ip)\n void reply.status(429).send(`${RATE_LIMIT_ERROR_MESSAGE} for ip:${ip}`)\n }\n }\n}\n","export const RATE_LIMIT_HEADERS = {\n limit: 'X-RateLimit-Limit',\n remaining: 'X-RateLimit-Remaining',\n reset: 'X-RateLimit-Reset',\n} as const\n\nexport const RATE_LIMIT_ERROR_MESSAGE = 'Rate limit exceeded'\n","type StoreEntry = { value: number; timeoutId: NodeJS.Timeout }\n\n// Fixed-window counter: each key auto-expires durationSec after it was last\n// touched, so no separate sweep/cron is needed to bound memory. Adapted from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/storage.ts,\n// itself based on nestjs/throttler's setTimeout-per-key approach.\nexport class FixedWindowStore {\n private store = new Map<string, StoreEntry>()\n\n private set(key: string, value: number, durationSec: number) {\n clearTimeout(this.store.get(key)?.timeoutId)\n\n const timeoutId = setTimeout(() => this.store.delete(key), durationSec * 1000)\n // This is a cache-eviction timer, not pending work — it must not keep the\n // process alive on its own (matters for a long-running server, unlike the\n // serverless functions the ported design originally ran in).\n timeoutId.unref()\n\n this.store.set(key, { value, timeoutId })\n }\n\n get(key: string): number | undefined {\n return this.store.get(key)?.value\n }\n\n increment(key: string, durationSec: number): number {\n const next = (this.get(key) ?? 0) + 1\n this.set(key, next, durationSec)\n return next\n }\n}\n","import { isIP } from 'node:net'\nimport type { FastifyRequest } from 'fastify'\n\nexport const normalizeIp = (ip: string): string => ip.trim().replace(/^::ffff:/i, '')\n\nconst firstValidIp = (value: string | string[] | undefined): string | undefined => {\n const raw = Array.isArray(value) ? value[0] : value\n if (!raw) return undefined\n const candidate = normalizeIp(raw.split(',')[0] ?? '')\n return candidate && isIP(candidate) ? candidate : undefined\n}\n\n// req.ip is already the right answer for X-Forwarded-For: Fastify's trustProxy\n// option (see server/index.ts, set to TRUSTED_PROXY_HOPS) walks exactly that\n// many hops back through the header via @fastify/proxy-addr, which is the\n// correct way to find the real client through this app's one nginx hop. X-\n// Forwarded-For is never read directly here — a client can set that header to\n// anything, and only Fastify's hop-counted view of it is trustworthy.\n//\n// customIpHeader is for an edge/CDN in front of nginx (e.g. Cloudflare's\n// cf-connecting-ip) that knows the client's IP authoritatively, independent of\n// hop counting. It's validated with isIP so a spoofed or garbage value falls\n// through to req.ip instead of being trusted blindly — ported from\n// https://github.com/lidofinance/warehouse/blob/main/packages/next/ip-rate-limit/src/utils.ts,\n// adapted from Next's per-request customIpHeader to Fastify + trustProxy.\nexport const getClientIp = (req: FastifyRequest, customIpHeader?: string): string => {\n const customIp = customIpHeader ? firstValidIp(req.headers[customIpHeader.toLowerCase()]) : undefined\n\n return customIp ?? normalizeIp(req.ip || '0.0.0.0')\n}\n","import { redactUrls } from './redactUrls'\n\nimport type { FetchRPC, RpcProviders } from './rpcFactory/types'\n\nexport type ChainProbeResult = { chainId: string; ok: boolean }\n\nexport type ProbeChainsOptions = {\n fetchRPC: FetchRPC\n timeoutMs?: number\n onResult?: (result: ChainProbeResult) => void\n logger?: Pick<Console, 'warn'>\n}\n\nconst DEFAULT_HEALTH_TIMEOUT_MS = 5_000\n\n// Probes every configured URL per chain in parallel — matching the runtime fallback\n// semantics of iterateUrls in rpcFactory. A chain is healthy when at least one URL\n// responds, so a single-provider outage doesn't fail a proxy that has working fallbacks.\nexport const probeChains = async (\n providers: RpcProviders,\n { fetchRPC, timeoutMs = DEFAULT_HEALTH_TIMEOUT_MS, onResult, logger = console }: ProbeChainsOptions,\n): Promise<ChainProbeResult[]> => {\n const results = await Promise.all(\n Object.entries(providers).map(async ([chainId, urls]) => {\n const urlResults = await Promise.all(\n urls.map(async (url) => {\n try {\n const response = await fetchRPC(\n url,\n {\n body: { id: 1, jsonrpc: '2.0', method: 'eth_blockNumber', params: [] },\n signal: AbortSignal.timeout(timeoutMs),\n },\n { chainId },\n )\n const { result } = (await response.json()) as { result?: unknown }\n return response.ok && result != null\n } catch (error) {\n const reason = redactUrls(error instanceof Error ? error.message : String(error))\n logger.warn(`[health] probe failed for chain ${chainId} provider ${redactUrls(url)}: ${reason}`)\n return false\n }\n }),\n )\n const ok = urlResults.some(Boolean)\n return { chainId, ok }\n }),\n )\n for (const result of results) {\n onResult?.(result)\n }\n return results\n}\n","import { trackedFetchRpcFactory } from '@lidofinance/api-rpc'\nimport { Counter, Gauge, Histogram, Registry, collectDefaultMetrics } from 'prom-client'\n\nimport type { FetchRPC } from './rpcFactory/types'\n\nexport type RpcProxyMetrics = {\n registry: Registry\n fetchRPC: FetchRPC\n rpcRequestBlocked: Counter<'reason'>\n rpcRequestMethods: Counter<'method'>\n rateLimitBlockedCount: Counter<'route'>\n apiResponse: Histogram<'method' | 'route' | 'status'>\n rpcChainReachable: Gauge<'chainId'>\n}\n\nexport type CreateRpcProxyMetricsOptions = {\n // Prefix applied to every metric name registered by this factory, including the\n // request/response counters trackedFetchRpcFactory registers into `registry`.\n prefix: string\n registry?: Registry\n // Set false when the consuming app already calls prom-client's collectDefaultMetrics\n // itself (e.g. to combine it with its own startup metrics) — avoids double-registering.\n collectDefault?: boolean\n}\n\n// Prom-client metrics for a Fastify RPC proxy: blocked/allowed request counts,\n// per-IP rate-limit blocks, HTTP response timings and per-chain reachability —\n// plus a metrics-tracked fetchRPC (via @lidofinance/api-rpc) to pass into rpcFactory.\nexport const createRpcProxyMetrics = ({\n prefix,\n registry = new Registry(),\n collectDefault = true,\n}: CreateRpcProxyMetricsOptions): RpcProxyMetrics => {\n const rpcRequestBlocked = new Counter({\n name: `${prefix}rpc_request_blocked_total`,\n help: 'Number of blocked RPC requests by reason',\n labelNames: ['reason'] as const,\n registers: [registry],\n })\n\n // Client-requested RPC methods, counted at validation time — before a request is\n // blocked or forwarded. Distinct from fetchRPC's own request-methods counter (from\n // @lidofinance/api-rpc), which only counts methods that actually reached a provider.\n const rpcRequestMethods = new Counter({\n name: `${prefix}rpc_request_methods`,\n help: 'RPC methods requested by clients, by method',\n labelNames: ['method'] as const,\n registers: [registry],\n })\n\n const rateLimitBlockedCount = new Counter({\n name: `${prefix}rate_limit_blocked_total`,\n help: 'Number of requests rejected by the in-process per-IP rate limiter, by route',\n labelNames: ['route'] as const,\n registers: [registry],\n })\n\n const apiResponse = new Histogram({\n name: `${prefix}api_response_seconds`,\n help: 'API response time',\n buckets: [0.1, 0.2, 0.3, 0.6, 1, 1.5, 2, 5],\n labelNames: ['method', 'route', 'status'] as const,\n registers: [registry],\n })\n\n const rpcChainReachable = new Gauge({\n name: `${prefix}rpc_chain_reachable`,\n help: '1 if the RPC endpoint for the chain is reachable, 0 otherwise',\n labelNames: ['chainId'] as const,\n registers: [registry],\n })\n\n // Registers its own request/response/methods/result counters into `registry`.\n const fetchRPC = trackedFetchRpcFactory({ prefix, registry })\n\n if (collectDefault) {\n collectDefaultMetrics({ register: registry, prefix })\n }\n\n return {\n registry,\n fetchRPC,\n rpcRequestBlocked,\n rpcRequestMethods,\n rateLimitBlockedCount,\n apiResponse,\n rpcChainReachable,\n }\n}\n","import { getStatusLabel } from '@lidofinance/api-metrics'\n\nimport { probeChains } from './health'\nimport { createRateLimitHook } from './rateLimit/rateLimit'\nimport { rpcFactory } from './rpcFactory/rpcFactory'\n\nimport type { ChainProbeResult } from './health'\nimport type { RpcProxyMetrics } from './metrics'\nimport type { RPCFactoryValidationParams, FetchRPC, RpcProviders } from './rpcFactory/types'\nimport type { FastifyInstance } from 'fastify'\n\nconst DEFAULT_HEALTH_CACHE_MS = 5_000\n\nexport type RegisterRpcProxyRoutesOptions = {\n providers: RpcProviders\n defaultChain: string | number\n fetchRPC: FetchRPC\n metrics: RpcProxyMetrics\n validation: RPCFactoryValidationParams\n rateLimit: {\n max: number\n windowSec: number\n customIpHeader?: string\n }\n healthTimeoutMs?: number\n // How long (ms) a /health probe result is reused. /health is unauthenticated and outside the rate\n // limiter, so without this every GET costs one upstream call per configured URL.\n // 5 000 by default, 0 probes on every request.\n healthCacheMs?: number\n upstreamTimeoutMs?: number\n serverLogger?: Pick<Console, 'warn' | 'error'>\n}\n\n// Wires /health, /metrics and /rpc onto a Fastify instance. Anything app-specific —\n// CSP reporting, extra routes, the fastify() bootstrap itself — stays with the caller.\nexport const registerRpcProxyRoutes = (app: FastifyInstance, options: RegisterRpcProxyRoutesOptions) => {\n const {\n providers,\n defaultChain,\n fetchRPC,\n metrics,\n validation,\n rateLimit,\n healthTimeoutMs,\n healthCacheMs = DEFAULT_HEALTH_CACHE_MS,\n upstreamTimeoutMs,\n serverLogger,\n } = options\n\n // Route label uses the matched route template (e.g. \"/rpc\"), not request.url —\n // avoid request.url here because unmatched URLs (404s) can blow up label\n // cardinality, hence the 'unknown' fallback instead. status is the aggregated\n // 2xx/4xx/… class, not the exact code.\n app.addHook('onResponse', (request, reply, done) => {\n metrics.apiResponse.observe(\n {\n method: request.method,\n route: request.routeOptions.url ?? 'unknown',\n status: getStatusLabel(reply.statusCode),\n },\n reply.elapsedTime / 1000,\n )\n done()\n })\n\n // A probe in flight is shared by every request that arrives meanwhile, and its result is\n // reused for healthCacheMs after it settles, so /health cannot be used to multiply upstream calls.\n let cachedProbe: { checks: Promise<ChainProbeResult[]>; expiresAt: number } | undefined\n\n const probe = () => {\n if (cachedProbe && Date.now() < cachedProbe.expiresAt) return cachedProbe.checks\n\n const checks = probeChains(providers, {\n fetchRPC,\n timeoutMs: healthTimeoutMs,\n onResult: ({ chainId, ok }) => metrics.rpcChainReachable.set({ chainId }, ok ? 1 : 0),\n logger: serverLogger,\n })\n if (healthCacheMs > 0) {\n const entry = { checks, expiresAt: Infinity }\n cachedProbe = entry\n checks.then(\n () => (entry.expiresAt = Date.now() + healthCacheMs),\n () => (entry.expiresAt = 0),\n )\n }\n return checks\n }\n\n app.get('/health', async (_req, reply) => {\n const checks = await probe()\n const healthy = checks.every((c) => c.ok)\n // Structured JSON (status code still carries the pass/fail signal for simple\n // probes like a Dockerfile's `wget --spider`) so infra/dashboards hitting this\n // directly can see which chain is unreachable, not just an aggregate.\n return reply.status(healthy ? 200 : 503).send({\n status: healthy ? 'ok' : 'degraded',\n chains: Object.fromEntries(checks.map((c) => [c.chainId, c.ok ? 'ok' : 'unreachable'])),\n })\n })\n\n app.get('/metrics', async (_req, reply) => {\n const content = await metrics.registry.metrics()\n void reply.status(200).header('Content-Type', metrics.registry.contentType).send(content)\n })\n\n const handleRpc = rpcFactory({\n providers,\n defaultChain,\n fetchRPC,\n metrics: {\n rpcRequestBlocked: metrics.rpcRequestBlocked,\n rpcRequestMethods: metrics.rpcRequestMethods,\n },\n validation,\n serverLogger,\n upstreamTimeoutMs,\n })\n\n const rpcRateLimit = createRateLimitHook({\n max: rateLimit.max,\n windowSec: rateLimit.windowSec,\n customIpHeader: rateLimit.customIpHeader,\n onBlocked: () => metrics.rateLimitBlockedCount.inc({ route: '/rpc' }),\n })\n\n // Encapsulated in its own plugin context (rather than passed via the route's\n // `preHandler` option) so the rate-limit hook's untyped FastifyRequest doesn't\n // get unified with handleRpc's typed `Querystring: RpcQuery` generic — that\n // unification otherwise collapses to `unknown` and fails to typecheck.\n void app.register((scope) => {\n scope.addHook('preHandler', rpcRateLimit)\n scope.post('/rpc', handleRpc)\n return Promise.resolve()\n })\n}\n"],"names":[],"version":3,"file":"index.mjs.map","sourceRoot":"../../../../"}
package/package.json CHANGED
@@ -7,7 +7,7 @@
7
7
  "url": "https://github.com/lidofinance/warehouse/issues"
8
8
  },
9
9
  "license": "MIT",
10
- "version": "1.0.0",
10
+ "version": "2.0.0",
11
11
  "files": [
12
12
  "dist"
13
13
  ],
@@ -49,7 +49,7 @@
49
49
  "@lidofinance/rpc": "*",
50
50
  "@types/memory-cache": "^0.2.6",
51
51
  "@types/node": "^20.0.0",
52
- "fastify": "^5.10.0",
52
+ "fastify": "^5.12.6",
53
53
  "prom-client": "^14.1.0",
54
54
  "vite": "^8.3.2",
55
55
  "vitest": "^5.0.3"
package/README.mdx DELETED
@@ -1,4 +0,0 @@
1
- import { MarkdownWrapper } from '../../../.storybook/components/markdownWrapper.tsx'
2
- import ReadmeContent from './README.md?raw'
3
-
4
- <MarkdownWrapper>{ReadmeContent}</MarkdownWrapper>