5.2 KiB

Raw Blame History

EIP4844 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

Networking

The Capella light client networking specification is extended to exchange EIP4844 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`
`EIP4844_FORK_VERSION` and later	`eip4844.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`
`EIP4844_FORK_VERSION` and later	`eip4844.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`
`EIP4844_FORK_VERSION` and later	`eip4844.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`
`EIP4844_FORK_VERSION` and later	`eip4844.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`
`EIP4844_FORK_VERSION` and later	`eip4844.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`
`EIP4844_FORK_VERSION` and later	`eip4844.LightClientOptimisticUpdate`