Skip to content

Light client data (advanced)

Nimbus is configured by default to serve data that allows light clients to stay in sync with the Ethereum network. Light client data is imported incrementally and does not affect validator performance. Information about the light client sync protocol can be found in the Ethereum consensus specs.

Note

Nimbus also implements a standalone light client that may be used to sync an execution layer (EL) client.

Configuration

The following configuration options adjust the import and serving of light client data:

Option Description
--light-client-data-serve
  • false: Disable light client data serving
  • true (default): Provide imported light client data to others
--light-client-data-import-mode
  • none: Do not import new light client data
  • only-new (default): Incrementally import new light client data
  • full: Import historic light client data (slow startup)
  • on-demand: Like full, but import on demand instead of on start
--light-client-data-max-periods
  • Controls the maximum number of sync committee periods to retain light client data
  • When unspecified (default), light client data is never pruned

Warning

Setting --light-client-data-import-mode to full or on-demand imports historic light client data which is computationally expensive. While importing historic light client data, validator duties may be missed.