eth_newBlockFilter

eth_newBlockFilter registers a server-side filter that tracks new block arrivals on OP Mainnet and returns a hex filter ID. You then poll that ID with eth_getFilterChanges to receive the hashes of blocks that have been produced since your last poll. OP Mainnet is the ETH-gas OP Stack rollup at chain ID 10 (0xa), and because its single sequencer mints a block roughly every 2 seconds, each poll typically returns a small, steady stream of new block hashes. Create the filter against https://optimism.therpc.io/YOUR_API_KEY.

Use cases

• Trigger block-level processing each time a new OP Mainnet block arrives — for example, re-checking whether your pending transactions have been included roughly every 2 seconds.
• Keep cached on-chain reads fresh by invalidating them on every new block hash, so balances, pool reserves, or contract state served to users never lag the head of the chain.

Parameters

此方法不需要任何参数，传入空数组 [] 即可。

Response

Example request

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_newBlockFilter",
7    "params": [],
8    "id": 1
9  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• Polling yields only block hashes, not full blocks — call eth_getBlockByHash for each hash when you need the header or transaction list.
• An idle filter is dropped after a few minutes (commonly ~5) without polling; when eth_getFilterChanges reports filter not found, recreate the filter and resume.
• The OP Mainnet sequencer can reorg the unsafe head before it is posted to and finalized on Ethereum L1, so for value-sensitive actions wait for the safe or finalized tag rather than acting on a freshly seen block hash.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• eth_getFilterChanges
• eth_uninstallFilter
• eth_newFilter
• eth_subscribe

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_newBlockFilter","params":[]}'