Skip to main content
Subscribes to real-time events over WebSocket and returns a subscription ID that is attached to every notification. This method will use 20 Compute Units and each notification delivered on the subscription will use 10 Compute Units regardless of size.

Reference: Here

Parameters

  1. subscription name - string - The type of event you want to subscribe to (i.e., newHeads, logs). This method supports the following subscription types:
  • newHeads - Fires a notification each time a new header is appended to the chain, including chain reorganizations.\
  • logs - Returns logs that are included in new imported blocks and match the given filter criteria.
  1. data - object - (Optional) - Arguments such as an address, multiple addresses, and topics. Note, only logs that are created from these addresses or match the specified topics will return logs.

Returns

result - string - Hex encoded subscription ID. This ID will be attached to all received events and can also be used to cancel the subscription using eth_unsubscribe.