Light client data

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.