@talak-web3/rpc

RPC client and utilities for blockchain interactions.

Installation

npm install @talak-web3/rpc

yarn add @talak-web3/rpc

pnpm add @talak-web3/rpc

Usage

import { UnifiedRpc } from '@talak-web3/rpc';
import type { TalakWeb3Context } from '@talak-web3/types';

const rpc = new UnifiedRpc(context, [
  { url: 'https://eth-mainnet.g.alchemy.com/v2/demo', priority: 0 },
  { url: 'https://mainnet.infura.io/v3/demo', priority: 1 },
]);

const blockNumber = await rpc.request<string>('eth_blockNumber', []);
const balance = await rpc.request<string>('eth_getBalance', [
  '0x1111111111111111111111111111111111111111',
  'latest'
]);

rpc.stop();

Features

• Multi-provider fallback with health checking
• Automatic retry with configurable attempts
• Response caching for read-only methods
• Request timeout handling
• Health monitoring (runs every 30s, can be stopped with rpc.stop())

API

UnifiedRpc

The main RPC client class that implements IRpc interface.

Constructor

constructor(ctx: TalakWeb3Context, endpoints: RpcEndpoint[])

• ctx: TalakWeb3 context instance
• endpoints: Array of RPC endpoints with optional priority

Methods

• request<T>(method: string, params?: unknown[], options?: RpcOptions): Promise<T> - Make an RPC request
• stop(): void - Stop the health check interval
• checkAllHealth(): Promise<void> - Manually check all endpoint health

License

MIT