/eth/v1/beacon/light_client/updates

Get 'LightClientUpdate' instances in a requested sync committee period range.

In the range of sync committee periods [start_period, start_period + count], requesting LightClientUpdate instances prior to the current head sync committee period chosen by fork choice. Either JSON or SSZ-serialized bytes may be returned, depending on the Accept header.

Results as specified in create_light_client_update MUST be provided by servers. They are required to reply with the requested range's earliest known result, at the very least, and to transmit the results in sequential order (by period). There cannot be more results in the response than min(MAX_REQUEST_LIGHT_CLIENT_UPDATES, count).

Example Request and Result for /v1/beacon/light_client/updates

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/beacon/light_client/updates endpoint. Additionally, we present the resulting response containing information about the update instances in a requested sync committee range.

Parameters

Field	Type	Description
start_period*	string	Start point of the range
count*	string	The maximum number of the items returned

The example in this section uses a non-existing project id.

Make sure you replace it with your Ethereum Holesky Beacon endpoint when issuing the API calls.

Don't have a project id? Here's a straightforward guide on how to obtain one!

Get 'LightClientBootstrap' structure for a requested block root.

GET https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/light_client/bootstrap/<block_root>

Query Parameters

Name	Type	Description
start_period*	string	1
count*	string	1

200: OK Expand for a detailed response example

{
  "updates": [
    {
      "version": "capella",
      "data": {
        "attested_header": {
          "slot": "16382",
          "proposer_index": "217914",
          "parent_root": "0xcfab5b19260facbef03d6b387c4d73d888c2c15c72f18ff2b1e528635d55effb",
          "state_root": "0x2aac110b6cf77ef9d43459d0f51bb43b10862bb3914848fd210ff7473d195f00",
          "body_root": "0x8f49087821d8bd134bb9f265d7d43427538bfe20c8e52ea6cb0ed01157765848"
        },
        "next_sync_committee": {
          "pubkeys": [
            "0x8527ec177303b8c2b9a8cc85da63891bf2e27c8ef45becdbe680a0a90932b7167d8bb5aeafea8d1ba901d3f4f27408b2",
            "0xb0b7f5fde130b8a187a4ecd09b19f6be4945cf89ead7528ba83f98d8f0df320c9d45159ce5daa97fe8d8143bdad78f7d",
            ....
          ],
          "aggregate_pubkey": "0xafc18ac51214b5d3823109a894fccfa0756be800dd16ba24c7ad504037fc6f273408d28941b4a70a186f3a42886ba8f4"
        },
        "finalized_header": {
          "slot": "16288",
          "proposer_index": "1007151",
          "parent_root": "0x39190b8d74cc53d4736bf2299ee4475f3fbb687066cb1abe0d48e9a800491140",
          "state_root": "0xfa18dc274113d482c6fe7f9e4cd8f30d253095f49754564a0d8bd50ee936279a",
          "body_root": "0xe9caa6556dcb6feab160f3ab6f9d4fd0659d99f75bf691478247f5edbc4db9ed"
        },
        "sync_aggregate": {
          "sync_committee_bits": "0x3fbcf7ffff57f77fe3f3f7faf9ff63edffbff33ffddffeddf5f6eff77ff6fbbf95f6eff7edfddf7ff9fd5e27d7dd7fbafefeffffff3fffbffff6ffffffffffff",
          "sync_committee_signature": "0x878ed400367915eee5ce9e604265e0f7f609086cd2bedb5c58b34069e9b2001da4e7454c40dbb61c6d0d9d93df53ff0217111241ce26829a5772507de3356e6293ec8415e496958f2fb392180ffa3c5c850403351259db5befa18289d983abdf"
        },
        "next_sync_committee_branch": [
          "0xbda6f260d2f2b9cce06020298221999787efbd484b20d23e2e1f07a52c1e3598",
          "0x49838e48c0bc448aa9f0290a055f3ada3698e578bf0b84aa8db2085915e0518d",
          "0xb2fb35f1e5a8b0e8380ed3445ddfcc784d18d19e895fec74ddf89b247a49bf9d",
          "0x1eb8fb06a1a42c8c708e68c11329430f39e9b688e938f71e3ca2d92a5f403b39",
          "0x28bbfbe6ea836d75b40c5ff57040c05d4a8cb485a4ba00b2aa22065d73383bcd"
        ],
        "finality_branch": [
          "0xfd01000000000000000000000000000000000000000000000000000000000000",
          "0xa118c3c7cae1b00d64a4887fa2df997a80593e7d9f718098510c0e087fa531a1",
          "0xa523be8a820e5624cf0a76ca4cabbeebb18321ec9a1e0586e0156a4b0d89dfeb",
          "0xb2fb35f1e5a8b0e8380ed3445ddfcc784d18d19e895fec74ddf89b247a49bf9d",
          "0x1eb8fb06a1a42c8c708e68c11329430f39e9b688e938f71e3ca2d92a5f403b39",
          "0x28bbfbe6ea836d75b40c5ff57040c05d4a8cb485a4ba00b2aa22065d73383bcd"
        ],
        "signature_slot": "16383"
      }
    }
  ]
}

Curl Request example

curl -X 'GET' \
  'https://eth-holesky-beacon.blastapi.io/<project_id>/eth/v1/beacon/light_client/updates?start_period=1&count=1' \
  -H 'accept: application/json'