Rpc

---
name: rpc
description: Use when the user needs raw blockchain JSON-RPC access — contract reads (eth_call), native balances, blocks, transactions, logs, gas estimates, or any chain-native RPC method across 40 chains. One endpoint per chain via BlockRun's Tatum-backed gateway, $0.0030 per call, no node, no API key. Prefer blockrun_price / blockrun_dex / the paid tools when they already cover the question.
triggers:
  - "rpc"
  - "json-rpc"
  - "eth_call"
  - "contract read"
  - "raw chain"
  - "node access"
  - "blockchain rpc"
  - "getBalance"
  - "block number"
  - "transaction receipt"
  - "event logs"
  - "tatum"
---

# Multi-chain RPC — every supported chain, one tool

`blockrun_rpc` POSTs a standard JSON-RPC 2.0 body to `/v1/rpc/{network}`. Flat **$0.0030 per call** ($0.002 base + the $0.001 transaction fee). A JSON-RPC **batch array charges per element but pays the flat fee only once** — $0.002 × n + $0.001, so a batch of 3 costs $0.0070 where three separate calls cost $0.0090. Batch whenever you can. Settlement in USDC via x402. Responses are cached briefly server-side for identical read calls (`X-Cache: HIT` is free of upstream latency but still billed).

## When to use which tool

| Question | Tool |
|---|---|
| "What's ETH trading at?" | `blockrun_price` (free) |
| "PEPE/WETH pool liquidity?" | `blockrun_dex` (free) |
| "What's this wallet holding?" | `blockrun_rpc` (labels: no tool since Surf was retired 2026-09-06) |
| "Call `balanceOf(0x...)` on this ERC-20" | **`blockrun_rpc`** |
| "Latest block / tx receipt / event logs / gas price" | **`blockrun_rpc`** |
| "Solana account info / slot / signatures" | **`blockrun_rpc`** |

## Networks

EVM (use `eth_*` methods):

| Key | Chain | | Key | Chain |
|---|---|---|---|---|
| `ethereum` | Ethereum | | `zksync` | zkSync Era |
| `base` | Base | | `berachain` | Berachain |
| `arbitrum` | Arbitrum One | | `unichain` | Unichain |
| `arbitrum-nova` | Arbitrum Nova | | `monad` | Monad |
| `optimism` | Optimism | | `chiliz` | Chiliz |
| `polygon` | Polygon | | `moonbeam` | Moonbeam |
| `bsc` | BNB Smart Chain | | `aurora` | Aurora |
| `avalanche` | Avalanche C-Chain | | `flare` | Flare |
| `fantom` | Fantom | | `oasis` | Oasis Sapphire |
| `cronos` | Cronos | | `kaia` | Kaia (Klaytn) |
| `celo` | Celo | | `sonic` | Sonic |
| `gnosis` | Gnosis | | `xdc` | XDC Network |
| `abstract` | Abstract | | `hyperevm` | HyperEVM |
| `plume` | Plume | | `ronin` | Ronin |
| `rootstock` | Rootstock (RSK) | | | |

Non-EVM (chain-native methods):

| Key | Chain | Method family |
|---|---|---|
| `solana` | Solana | `getSlot`, `getBalance`, `getAccountInfo`, `getSignaturesForAddress` |
| `bitcoin` | Bitcoin | `getblockchaininfo`, `getblockcount`, `getrawtransaction` |
| `litecoin` / `dogecoin` / `bitcoin-cash` / `zcash` | UTXO chains | Bitcoin-style RPC |
| `near` | NEAR | `status`, `query` |
| `sui` | Sui | `sui_getLatestCheckpointSequenceNumber`, `suix_getBalance` |
| `ripple` | XRP Ledger | `account_info`, `ledger` |
| `polkadot` / `kusama` | Substrate | `chain_getHeader`, `state_getStorage` |

Unknown-but-wellformed slugs pass through to the Tatum gateway untouched — newly added chains work without an MCP update. A bad slug returns HTTP 400 with the supported list (no charge).

## Recipes

ERC-20 balance (eth_call):

```
blockrun_rpc({
  network: "base",
  method: "eth_call",
  params: [{
    to: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",   // USDC on Base
    data: "0x70a08231000000000000000000000000<ADDRESS_NO_0x_PADDED_TO_32B>"
  }, "latest"]
})
```

Native balance: `method: "eth_getBalance", params: ["0x...", "latest"]`
Tx receipt: `method: "eth_getTransactionReceipt", params: ["0x<txhash>"]`
Event logs: `method: "eth_getLogs", params: [{ fromBlock, toBlock, address, topics }]` — keep ranges small; huge ranges are rejected upstream (no charge).
Gas: `method: "eth_gasPrice"` / `eth_estimateGas`

Solana token account: `network: "solana", method: "getTokenAccountsByOwner", params: ["<owner>", {"mint": "<mint>"}, {"encoding": "jsonParsed"}]`

Batch (charged per element, flat fee paid once — 3 calls = $0.0070, vs $0.0090 sent separately):

```
blockrun_rpc({ network: "ethereum", body: [
  { jsonrpc: "2.0", id: 1, method: "eth_blockNumber" },
  { jsonrpc: "2.0", id: 2, method: "eth_gasPrice" },
  { jsonrpc: "2.0", id: 3, method: "eth_chainId" }
]})
```

## Failure semantics

- Upstream timeout / 5xx → **no charge**, retry safe.
- Malformed body / bad network → HTTP 400, **no charge**.
- JSON-RPC-level errors (e.g. revert on `eth_call`) come back inside `result.error` — the call **is** charged (the node did the work).