@rpc-relay/sdk

Zero-dependency client, EIP-1193 provider, and viem-compatible transport for RPC Relay. It uses the local Pro accelerator by default, so repeated reads benefit from its chain-aware cache and predictive prefetch without application-level cache code.

import { createRpcRelayClient } from '@rpc-relay/sdk';

const relay = createRpcRelayClient();
const block = await relay.request({ method: 'eth_blockNumber', params: [] });
const simulation = await relay.simulateTransaction({ from, to, data, value: '0x0' });

With viem:

import { createPublicClient } from 'viem';
import { mainnet } from 'viem/chains';
import { rpcRelayTransport } from '@rpc-relay/sdk';

const client = createPublicClient({ chain: mainnet, transport: rpcRelayTransport() });

Use a remote edge URL and token explicitly when localhost is not desired:

const relay = createRpcRelayClient({
  url: 'https://rpc-cache-worker.rpc-relay-cache.workers.dev/api/v1/base/rpc',
  token: process.env.RPC_RELAY_TOKEN,
});

Simulation never submits or signs a transaction. Trace availability depends on upstream support. RPC Relay does not promise that padded misses hide all access patterns: the Relay Worker and selected upstream can observe cache misses.