eth_uninstallFilter

eth_uninstallFilter removes a server-side filter by its hex ID on OP Mainnet, the OP Stack rollup that settles to Ethereum L1 and uses ETH for gas. Filters created with eth_newFilter, eth_newBlockFilter, or eth_newPendingTransactionFilter hold state on the node; this method tears that state down and frees the associated resources, and it works for all three filter types. Send the call to https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa). It returns true when the filter existed and was removed, or false if the ID was already gone.

Use cases

• Clean up a log filter after an OP Mainnet monitoring session ends so the node can release the buffered changes it was holding for you.
• Cancel every active filter your indexer or bot created during graceful shutdown, leaving no orphaned filter state behind.

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_uninstallFilter",
7    "params": ["0x1"],
8    "id": 1
9  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• A false return is not an error — the filter may have already expired on its own, so treat false as "nothing left to remove" rather than a failure.
• Filters auto-expire after roughly 5 minutes of inactivity, but relying on that timeout wastes node resources; explicit cleanup after you finish polling is the better practice, especially on managed endpoints shared across many clients.

Supported networks

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

See also

• eth_newFilter
• eth_newBlockFilter
• eth_newPendingTransactionFilter
• eth_getFilterChanges

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_uninstallFilter","params":["0x1"]}'