@lidofinance/eth-api-providers

Wraps JsonRpcProvider to track requests to RPC.

Installation

yarn add @lidofinance/eth-api-providers

Getting started

You just need to pass a few extra parameters to the used JsonRpcProvider, and you will get a patched class.

import { providerFactory, StaticJsonRpcBatchProvider } from '@lidofinance/eth-providers'
import { trackedJsonRpcProvider } from '@lidofinance/eth-api-providers'
import { registry } from './metrics'
import { METRICS_PREFIX } from '../config'

export const getStaticRpcBatchProvider = providerFactory(
  trackedJsonRpcProvider({
    prefix: METRICS_PREFIX,
    registry,
    Provider: StaticJsonRpcBatchProvider,
  }),
)

Metrics

Every send() call records:

• rpc_service_request / rpc_service_request_methods — counters of attempts and methods.
• rpc_service_response — latency histogram. status='2xx' on resolved sends, status='xxx' when super.send throws.
• rpc_service_response_result — counter with result='success' | 'failure' for explicit outcome tracking.