When a client subscribes to a particular event, the Avalanche node will send updates as soon as they occur. However, in some cases, the client may no longer be interested in receiving updates for a particular event. The eth_unsubscribe method can be used to cancel the following subscriptions:

eth_subscribe('newHeads')

eth_subscribe('newPendingTransactions')

eth_subscribe('logs')

​
Get you 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

  • string — the ID of the subscription that you want to cancel

​
Response

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

​
eth_unsubscribe code examples

Note that subscriptions require a WebSocket connection and WebSocket cat for you to use this method in the console.

Install WebSocket cat with:

npm install -g wscat

$ wscat -c YOUR_CHAINSTACK_WEBSOCKET_ENDPOINT
# Wait for the connection to be established

Connected (press CTRL+C to quit)

> {"jsonrpc":"2.0","id": 1, "method": "eth_unsubscribe", "params": ["0x7529626735859f32962b10b19ee2e3eb"]}

This will remove the subscription matching the ID passed as a parameter.