p2p-interface.md

Deneb 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 Capella light client networking specification is extended to exchange Deneb 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 and later	deneb.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 and later	deneb.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 and later	deneb.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 and later	deneb.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 and later	deneb.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 and later	deneb.LightClientOptimisticUpdate