forks/go-ethereum
1
0
Fork 1
mirror of https://github.com/ethereum/go-ethereum.git synced 2026-07-25 14:16:44 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Update blsync documentation with dynamic fetching. (Fixes Issue #31980 )

Browse source
This commit is contained in:
shantichanal 2025-06-16 15:42:06 +02:00
parent e92bca1c49
commit 9087111e75
1 changed files with 21 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
docs/fundamentals/blsync.md
View file

@ -9,7 +9,26 @@ description: Running geth with integrated beacon light client
## Usage
### Integrated mode
### Using Dynamic Checkpoint Fetch
This will automatically fetch the latest finalized checkpoint and launch Geth in snap sync mode with light client support (blsync).
Replace `<domain>` with your select beacon api provider from the provided list of [lightsync endpoints](https://s1na.github.io/light-sync-endpoints/). Replace `<checkpoint>` with a url from the list of maintained [checkpoint sync endpoints](https://eth-clients.github.io/checkpoint-sync-endpoints/). The following command can be used to run geth client with blsync directly.
```terminal
export BEACON=<beacon> && \
export CHECKPOINT=<checkpoint> && \
geth --beacon.api=$BEACON --beacon.checkpoint=$(curl -s $CHECKPOINT/checkpointz/v1/status | jq -r '.data.finality.finalized.root')
```
#### Example
```terminal
export BEACON=https://lodestar-sepolia.chainsafe.io && \
export CHECKPOINT=https://sepolia.beaconstate.info && \
geth --sepolia --beacon.api=$BEACON --beacon.checkpoint=$(curl -s $CHECKPOINT/checkpointz/v1/status | jq -r '.data.finality.finalized.root')
```
### Running with Manual Checkpoint Fetch
To run blsync as part of Geth, you need to specify a public HTTP endpoint and a checkpoint:
@ -29,6 +48,7 @@ A checkpoint is the block root of the first proposed slot of a finalized beacon
- Copy the block root field.
![Copy the block root](/images/docs/blsync3.png)
## Testing a Beacon API Endpoint
To verify that your Beacon API is reachable and returning valid data, you can use a simple `curl` command to request the light client bootstrap header for a given block root.