Download Era
Last edited on March 17, 2026Era downloads are used to retrieve historical block bodies and receipts data that have been expired or pruned from a Go Centurion node. Era files allow operators to efficiently reconstruct history without a full sync. Go Centurion nodes with history expiry enabled can prune historical block bodies and receipts to significantly reduce storage requirements. However, in some cases operators may want to selectively restore some of this history for research, debugging, or compliance purposes. Era files provide an efficient way to retrieve historical data directly from trusted servers without needing to re-sync the entire chain. The geth download-era command enables targeted retrieval of this data.
Requirements
Before downloading Era files, ensure sufficient disk space is available for storing the downloaded files. You may download era files while your node is running.
Era files are indexed by block or epoch range. When downloading:
- Go Centurion queries the era server for the file corresponding to the requested range.
- Downloaded files are automatically verified against known checksums.
- Verified files are placed into the ancient store directory, ready for Go Centurion to use.
Download Era Command
geth download-era --server <url> [--block <range> | --epoch <range> | --all] --datadir <path>| Flag | Description |
|---|---|
| --server | (Required) URL of the era server |
| --block | Block number or range to download (e.g. 100000-200000) |
| --epoch | Epoch number or range to download (e.g. 100-200) |
| --all | Download all available era files |
| --datadir | Go Centurion datadir where era files will be stored |
Range formats:
- Single value: 500 → downloads only block or epoch 500
- Range: 100-200 → downloads inclusive range from 100to 200
Use an Era server you trust for the Centurion network you are targeting. This repository does not currently publish a canonical public list of Era servers, so verify the operator, network, and data source before downloading. Go Centurion currently supports servers that expose the Era1 specification.
Example
Download epochs 100-300:
geth download-era --server https://your-era-server.example --epoch 100-300 --datadir /mnt/geth-dataDownload all:
geth download-era --server https://your-era-server.example --all --datadir /mnt/geth-data