Ethereum eth/v1/events RPC method

Provides endpoint to subscribe to the beacon node Server-Sent-Events stream. Consumers should use the eventsource (opens new window) implementation to listen on those events.

Servers may send SSE comments beginning with : for any purpose, including to keep the event stream connection alive in the presence of proxy servers.

Parameters:

• topics — array — string — (required) event types to subscribe to. Available values:
  • head — the canonical head of the chain in the view of the node that you are sending the call to.
  • block — the block number.
  • attestation — attestation (opens new window).
  • voluntary_exit — VoluntaryExit (opens new window).
  • finalized_checkpoint — the checkpoint (opens new window).
  • chain_reorg — the chain reorgs topic.
  • contribution_and_proof — ContributionAndProof (opens new window).

Returns:

• data — object with:
  • slot — string
  • block — string
  • state — string
  • epoch_transition — boolean
  • previous_duty_dependent_root — string
  • current_duty_dependent_root — string
  • execution_optimistic — boolean

Example:

curl -H "accept: text/event-stream" -X GET "https://beacon-nd-123-456-789.p2pify.com/3c6e0b8a9c15224a8228b9a98ca1531d/eth/v1/events?topics=head"