Willow RPC
Willow RPC is an Ethereum JSON-RPC endpoint for blocks, transactions, receipts, and logs on the chains listed below. It supports any contract and any event over any block range. Every block is verified against its block hash before any data from it is stored or served.
Account state is served on the same endpoint, on plans that include state
methods. Balances, nonces, code, storage, and eth_getProof are verified
against the state root of a verified block. eth_call and eth_estimateGas
on Ethereum, Unichain, and Robinhood Chain are executed over verified state,
and on Ethereum and Unichain the trace methods run the block again over
verified state. Fees are computed from verified blocks with a published
formula. Sent transactions are forwarded to a provider. See
State methods.
Responses can also be verified independently, without trusting Willow. The
willow_* proof methods return the proofs behind the standard methods, and
@willow-network/rpc, a viem transport and ethers
provider, verifies each response before the app sees it, or reports why it
can’t.
On the chains marked below, any eth_getLogs result can be requested with a
log proof. A log proof
establishes that each returned log is included in its block, and that no log in
the requested range matching the filter was omitted. Proofs can be verified
independently, in a browser or from the command line. The assumptions a
verifier relies on are listed in Verifying proofs.
Chains
Section titled “Chains”| Chain | Chain ID | Log proofs |
|---|---|---|
| Ethereum | 1 | Yes |
| Base | 8453 | Yes |
| Arbitrum One | 42161 | Yes |
| OP Mainnet | 10 | Yes |
| Unichain | 130 | Yes |
| Ink | 57073 | Yes |
| Robinhood Chain | 4663 | Yes |
| BNB Smart Chain | 56 | No |
| World Chain | 480 | No |
| Soneium | 1868 | No |
| Zora | 7777777 | No |
| Base Sepolia | 84532 | No |
| Arbitrum Sepolia | 421614 | No |
| OP Sepolia | 11155420 | No |
| Unichain Sepolia | 1301 | No |
| Ink Sepolia | 763373 | No |
| Robinhood Chain Testnet | 46630 | No |
| Polygon | 137 | No |
| Monad | 143 | No |
| HyperEVM | 999 | No |
| Celo | 42220 | No |
| Linea | 59144 | No |
| Mantle | 5000 | No |
| Plasma | 9745 | No |
| Berachain | 80094 | No |
| opBNB | 204 | No |
| Katana | 747474 | No |
| X Layer | 196 | No |
| Arc | 5042 | No |
| ApeChain | 33139 | No |
| Monad Testnet | 10143 | No |
| Ethereum Sepolia | 11155111 | No |
| Stellar | stellar | No |
Block, transaction, and receipt proofs are available on the first 17 chains in the table. On the next 15, from Polygon to Ethereum Sepolia, Willow’s servers verify each block before serving it, but no proofs are served yet, so their responses can’t be verified independently. HyperEVM’s blocks can’t be proven from public data. Stellar is served with stellar-rpc’s read methods, and its ledgers, transactions, and Soroban events can be verified against SCP, the consensus of Stellar’s validators (see Chains and URLs).
A single API key is valid on every chain. Endpoint URLs are listed in Chains and URLs.
Intended use
Section titled “Intended use”Willow RPC is designed for indexers, analytics platforms, RPC routers, auditors, and AI agents that read large volumes of chain data, and for applications that read account state and submit transactions.
Overview
Section titled “Overview”- Verification. Every block is verified against its block hash before any data from it is stored or served. On Ethereum, the canonical chain is determined with the Helios light client. On the L2s, it is determined from the sequencer’s signature, and on BNB Smart Chain from its validators’. See How Willow verifies data.
- Retention. All data Willow serves is retained. Ethereum is held in full from genesis. On the other chains, blocks older than those held are fetched on the first request from a paying account, verified, and retained. See History.
- Proofs. Log proofs are generated on request and priced per block, at a flat rate per chain. Every log proof is retained, so a block proven once is available to all later requests without being proven again. The proofs of blocks, transactions, receipts, state, calls, traces, and fees are returned immediately. See Proofs.
Get started
Section titled “Get started”Support
Section titled “Support”Contact [email protected], or ask in the Willow Discord.