Skip to content

Update beacon envs description #75

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 25, 2025
Merged

Update beacon envs description #75

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6207e1f
Update beacon envs description
varasev Nov 20, 2025
3e4bc71
Update env description
varasev Nov 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 15 additions & 15 deletions setup/env-variables/backend-envs-chain-specific.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,21 +71,21 @@

## Ethereum Management

| Variable | Description | Parameters |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `INDEXER_BEACON_RPC_URL` | Beacon Chain RPC endpoint used to fetch blob sidecars. Required if `INDEXER_OPTIMISM_L1_SYSTEM_CONFIG_CONTRACT` or `INDEXER_SCROLL_L1_BATCH_START_BLOCK` is defined. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `http://localhost:5052` <br />Applications: Indexer |
| `INDEXER_DISABLE_BEACON_BLOB_FETCHER` | If `true` the Beacon data blobs fetcher won't be started, new transaction and block fields will still be extracted. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_SLOT_DURATION` | Slot duration in the Beacon Chain in seconds. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). Prior to `v6.2.0`: required if `INDEXER_OPTIMISM_L1_SYSTEM_CONFIG_CONTRACT` is not empty. | Version: v6.2.0+ <br />Default: `12` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_REFERENCE_SLOT` | Any past finalized Beacon Chain slot number. Used as reference for blob inclusion slot calculations. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). Prior to `v6.2.0`: required if `INDEXER_OPTIMISM_L1_SYSTEM_CONFIG_CONTRACT` is not empty. | Version: v6.2.0+ <br />Default: `8000000` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_REFERENCE_TIMESTAMP` | UTC timestamp of the Beacon Chain slot specified in `INDEXER_BEACON_BLOB_FETCHER_REFERENCE_SLOT`. Used as reference for blob inclusion slot calculations. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). Prior to `v6.2.0`: required if `INDEXER_OPTIMISM_L1_SYSTEM_CONFIG_CONTRACT` is not empty. | Version: v6.2.0+ <br />Default: `1702824023` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_START_BLOCK` | Beacon Chain blob fetcher start block. On start-up, indexer will only look for missed blobs beyond this block number. It's recommended to set this block to the first block after the Dencun hardfork. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `19200000` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_END_BLOCK` | Beacon Chain blob fetcher end block. On start-up, indexer will only look for missed blobs before this block number. If set to `0`, then all recent till `latest` will be traversed. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `0` <br />Applications: Indexer |
| `INDEXER_DISABLE_BEACON_DEPOSIT_FETCHER` | If `true`, the Beacon deposit fetcher won't be started. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_FETCHER_INTERVAL` | The interval indicating how often deposit events should be queried. [Time format](/setup/env-variables/backend-envs-chain-specific#time-format). Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `6s` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_FETCHER_BATCH_SIZE` | The batch size specifies how many events are retrieved in a single database query. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `1000` <br />Applications: Indexer |
| `INDEXER_DISABLE_BEACON_DEPOSIT_STATUS_FETCHER` | If `true`, the Beacon deposit status fetcher won't be started. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_STATUS_FETCHER_EPOCH_DURATION` | Epoch duration in the Beacon chain in seconds. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `384` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_STATUS_FETCHER_REFERENCE_TIMESTAMP` | Any past finalized Beacon Chain epoch UTC timestamp. Used as reference for status fetcher scheduling. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `1722024023` <br />Applications: Indexer |
| Variable | Description | Parameters |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `INDEXER_BEACON_RPC_URL` | Beacon Chain RPC endpoint used to fetch blob sidecars. Required if `INDEXER_OPTIMISM_L1_BATCH_BLOCKSCOUT_BLOBS_API_URL` is defined. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `http://localhost:5052` <br />Applications: Indexer |
| `INDEXER_DISABLE_BEACON_BLOB_FETCHER` | If `true` the Beacon data blobs fetcher won't be started, new transaction and block fields will still be extracted. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_SLOT_DURATION` | Slot duration in the Beacon Chain in seconds. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). Required if `INDEXER_OPTIMISM_L1_BATCH_BLOCKSCOUT_BLOBS_API_URL` is not empty and L1 is neither Mainnet, Sepolia, Holesky. | Version: v6.2.0+ <br />Default: `12` <br />Applications: Indexer |

Check warning on line 78 in setup/env-variables/backend-envs-chain-specific.mdx

View check run for this annotation

Mintlify / Mintlify Validation (blockscout) - vale-spellcheck

setup/env-variables/backend-envs-chain-specific.mdx#L78 

Did you really mean 'Holesky'?
| `INDEXER_BEACON_BLOB_FETCHER_REFERENCE_SLOT` | Any past finalized Beacon Chain slot number. Used as reference for blob inclusion slot calculations. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). Required if `INDEXER_OPTIMISM_L1_BATCH_BLOCKSCOUT_BLOBS_API_URL` is not empty and L1 is neither Mainnet, Sepolia, Holesky. | Version: v6.2.0+ <br />Default: `8000000` <br />Applications: Indexer |

Check warning on line 79 in setup/env-variables/backend-envs-chain-specific.mdx

View check run for this annotation

Mintlify / Mintlify Validation (blockscout) - vale-spellcheck

setup/env-variables/backend-envs-chain-specific.mdx#L79 

Did you really mean 'Holesky'?
| `INDEXER_BEACON_BLOB_FETCHER_REFERENCE_TIMESTAMP` | UTC timestamp of the Beacon Chain slot specified in `INDEXER_BEACON_BLOB_FETCHER_REFERENCE_SLOT`. Used as reference for blob inclusion slot calculations. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). Required if `INDEXER_OPTIMISM_L1_BATCH_BLOCKSCOUT_BLOBS_API_URL` is not empty and L1 is neither Mainnet, Sepolia, Holesky. | Version: v6.2.0+ <br />Default: `1702824023` <br />Applications: Indexer |

Check warning on line 80 in setup/env-variables/backend-envs-chain-specific.mdx

View check run for this annotation

Mintlify / Mintlify Validation (blockscout) - vale-spellcheck

setup/env-variables/backend-envs-chain-specific.mdx#L80 

Did you really mean 'Holesky'?
| `INDEXER_BEACON_BLOB_FETCHER_START_BLOCK` | Beacon Chain blob fetcher start block. On start-up, indexer will only look for missed blobs beyond this block number. It's recommended to set this block to the first block after the Dencun hardfork. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `19200000` <br />Applications: Indexer |
| `INDEXER_BEACON_BLOB_FETCHER_END_BLOCK` | Beacon Chain blob fetcher end block. On start-up, indexer will only look for missed blobs before this block number. If set to `0`, then all recent till `latest` will be traversed. Implemented in [#9168](https://github.com/blockscout/blockscout/pull/9168). | Version: v6.2.0+ <br />Default: `0` <br />Applications: Indexer |
| `INDEXER_DISABLE_BEACON_DEPOSIT_FETCHER` | If `true`, the Beacon deposit fetcher won't be started. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_FETCHER_INTERVAL` | The interval indicating how often deposit events should be queried. [Time format](/setup/env-variables/backend-envs-chain-specific#time-format). Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `6s` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_FETCHER_BATCH_SIZE` | The batch size specifies how many events are retrieved in a single database query. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `1000` <br />Applications: Indexer |
| `INDEXER_DISABLE_BEACON_DEPOSIT_STATUS_FETCHER` | If `true`, the Beacon deposit status fetcher won't be started. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_STATUS_FETCHER_EPOCH_DURATION` | Epoch duration in the Beacon chain in seconds. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `384` <br />Applications: Indexer |
| `INDEXER_BEACON_DEPOSIT_STATUS_FETCHER_REFERENCE_TIMESTAMP` | Any past finalized Beacon Chain epoch UTC timestamp. Used as reference for status fetcher scheduling. Implemented in [#12985](https://github.com/blockscout/blockscout/pull/12985). | Version: v9.1.0+ <br />Default: `1722024023` <br />Applications: Indexer |

## Rootstock Management

Expand Down