Skip to main content
The subscriptions available using the ethers.js provider.on method are:

subscribe('newBlockHeaders')

subscribe('pendingTransactions')

subscribe('logs')

subscribe('syncing')

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

boolean — keep the subscribe(“syncing”) subscription if true.

Response

boolean — the boolean value indicating if the subscriptions were removed successfully. true if removed successfully, false if not.

clearSubscriptions code example

Use case

A way to use the clearSubscriptions method is to place it in a timer to clear all of the subscriptions after a pre-determined about. The following code is an example using the subscribe(“newBlockHeaders”) method, which will be stopped and removed after one minute using clearSubscriptions:
The code starts by defining an async function called subscribeToNewBlocks that creates a new subscription to new blocks by registering a listener for the block event using the provider.on method. The provider emits this event for every new block, and you can attach additional listeners, such as one for the error event. The code defines two event listener functions handleNewBlock and handleError that log messages to the console when these events occur. The subscribeToNewBlocks function is called from the main function, which is also defined in the code. The main function calls subscribeToNewBlocks to create a new subscription and then schedules the clearSubscriptions function to run once after 60 seconds using the setTimeout function. The clearSubscriptions function uses the provider.removeAllListeners method to cancel any existing subscriptions and log a message to the console if the cancellation was successful.
Last modified on June 25, 2026