p2p-interface.md

Electra Light Client -- Networking

Notice: This document is a work-in-progress for researchers and implementers.

Table of contents

• Networking
  • The gossip domain: gossipsub
    • Topics and messages
      • Global topics
        • light_client_finality_update
        • light_client_optimistic_update
  • The Req/Resp domain
    • Messages
      • GetLightClientBootstrap
      • LightClientUpdatesByRange
      • GetLightClientFinalityUpdate
      • GetLightClientOptimisticUpdate

Networking

The Deneb light client networking specification is extended to exchange Electra light client data.

The gossip domain: gossipsub

Topics and messages

Global topics

light_client_finality_update

fork_version	Message SSZ type
GENESIS_FORK_VERSION	n/a
ALTAIR_FORK_VERSION through BELLATRIX_FORK_VERSION	altair.LightClientFinalityUpdate
CAPELLA_FORK_VERSION	capella.LightClientFinalityUpdate
DENEB_FORK_VERSION	deneb.LightClientFinalityUpdate
ELECTRA_FORK_VERSION and later	electra.LightClientFinalityUpdate

light_client_optimistic_update

fork_version	Message SSZ type
GENESIS_FORK_VERSION	n/a
ALTAIR_FORK_VERSION through BELLATRIX_FORK_VERSION	altair.LightClientOptimisticUpdate
CAPELLA_FORK_VERSION	capella.LightClientOptimisticUpdate
DENEB_FORK_VERSION	deneb.LightClientOptimisticUpdate
ELECTRA_FORK_VERSION and later	electra.LightClientOptimisticUpdate

The Req/Resp domain

Messages

GetLightClientBootstrap

fork_version	Response SSZ type
GENESIS_FORK_VERSION	n/a
ALTAIR_FORK_VERSION through BELLATRIX_FORK_VERSION	altair.LightClientBootstrap
CAPELLA_FORK_VERSION	capella.LightClientBootstrap
DENEB_FORK_VERSION	deneb.LightClientBootstrap
ELECTRA_FORK_VERSION and later	electra.LightClientBootstrap

LightClientUpdatesByRange

fork_version	Response chunk SSZ type
GENESIS_FORK_VERSION	n/a
ALTAIR_FORK_VERSION through BELLATRIX_FORK_VERSION	altair.LightClientUpdate
CAPELLA_FORK_VERSION	capella.LightClientUpdate
DENEB_FORK_VERSION	deneb.LightClientUpdate
ELECTRA_FORK_VERSION and later	electra.LightClientUpdate

GetLightClientFinalityUpdate

fork_version	Response SSZ type
GENESIS_FORK_VERSION	n/a
ALTAIR_FORK_VERSION through BELLATRIX_FORK_VERSION	altair.LightClientFinalityUpdate
CAPELLA_FORK_VERSION	capella.LightClientFinalityUpdate
DENEB_FORK_VERSION	deneb.LightClientFinalityUpdate
ELECTRA_FORK_VERSION and later	electra.LightClientFinalityUpdate

GetLightClientOptimisticUpdate

fork_version	Response SSZ type
GENESIS_FORK_VERSION	n/a
ALTAIR_FORK_VERSION through BELLATRIX_FORK_VERSION	altair.LightClientOptimisticUpdate
CAPELLA_FORK_VERSION	capella.LightClientOptimisticUpdate
DENEB_FORK_VERSION	deneb.LightClientOptimisticUpdate
ELECTRA_FORK_VERSION and later	electra.LightClientOptimisticUpdate