p2p-interface.md

Capella 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 Altair light client networking specification is extended to exchange Capella 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 and later	capella.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 and later	capella.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 and later	capella.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 and later	capella.LightClientUpdate

GetLightClientFinalityUpdate

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

GetLightClientOptimisticUpdate

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