rpc

# 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).