Skip to content

new env variable INDEXER_OPTIMISM_SUPERCHAIN_CONFIG_FILE_PATH #115

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

Open
vbaranov wants to merge 2 commits into
base: main
Choose a base branch
from
Open

new env variable INDEXER_OPTIMISM_SUPERCHAIN_CONFIG_FILE_PATH #115

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a6e9d94
INDEXER_SUPERCHAIN_CONFIG_FILE_PATH
vbaranov Apr 16, 2026
1a3f432
Rename to INDEXER_OPTIMISM_SUPERCHAIN_CONFIG_FILE_PATH
vbaranov Apr 16, 2026
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
1 change: 1 addition & 0 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 @@ -74,9 +74,9 @@
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `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 77 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#L77 

Did you really mean 'Holesky'?

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

View check run for this annotation

Mintlify / Mintlify Validation (blockscout-main) - vale-spellcheck

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

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 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'?

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

View check run for this annotation

Mintlify / Mintlify Validation (blockscout-main) - vale-spellcheck

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

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 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'?

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

View check run for this annotation

Mintlify / Mintlify Validation (blockscout-main) - vale-spellcheck

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

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 |
Expand All @@ -97,7 +97,7 @@
| `INDEXER_ROOTSTOCK_DATA_FETCHER_BATCH_SIZE` | The number of requests in one JSON-RPC batch request, used to configure the load or RPS on JSON-RPC node. Implemented in [#8742](https://github.com/blockscout/blockscout/pull/8742). | Version: v5.3.2+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_ROOTSTOCK_DATA_FETCHER_CONCURRENCY` | The number of simultaneous requests to the JSON-RPC node, used to configure the load or RPS on JSON-RPC node. Implemented in [#8742](https://github.com/blockscout/blockscout/pull/8742). | Version: v5.3.2+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_ROOTSTOCK_DATA_FETCHER_DB_BATCH_SIZE` | The number of blocks fetched from the database in one database query. Implemented in [#8742](https://github.com/blockscout/blockscout/pull/8742). | Version: v5.3.2+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_TOKEN_TRANSFER_BLOCK_CONSENSUS_SANITIZER_INTERVAL` | Interval between token transfer block_consensus sanitizing. Implemented in [#14144](https://github.com/blockscout/blockscout/pull/14144). | Version: v10.2.2+ <br />Default: `20m` <br />Applications: Indexer |

Check warning on line 100 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#L100 

Did you really mean 'block_consensus'?

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

View check run for this annotation

Mintlify / Mintlify Validation (blockscout-main) - vale-spellcheck

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

Did you really mean 'block_consensus'?

## Scroll management

Expand Down Expand Up @@ -149,6 +149,7 @@
| Variable | Description | Parameters |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `INDEXER_OPTIMISM_L1_RPC` | The RPC endpoint for L1 used to fetch transaction batches, dispute games, output roots, deposits, or withdrawal events. Implemented in [#6980](https://github.com/blockscout/blockscout/pull/6980). | Version: v6.3.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_OPTIMISM_SUPERCHAIN_CONFIG_FILE_PATH` | Points to a Superchain TOML source (local file path or http(s) URL, including GitHub blob URLs) used to auto-load Optimism network parameters at startup and persist them into constants; empty/blank values are treated as unset. When provided, TOML values take priority and legacy envs are used only as per-field fallback; if neither TOML nor fallback provides a valid value, the stored constant is cleared to avoid stale config. This single variable can replace manual setup of: `INDEXER_OPTIMISM_L2_HOLOCENE_TIMESTAMP`, `INDEXER_OPTIMISM_L2_ISTHMUS_TIMESTAMP`, `INDEXER_OPTIMISM_L2_JOVIAN_TIMESTAMP`, `EIP_1559_BASE_FEE_MAX_CHANGE_DENOMINATOR`, `EIP_1559_ELASTICITY_MULTIPLIER`, `INDEXER_OPTIMISM_L1_SYSTEM_CONFIG_CONTRACT`, `INDEXER_OPTIMISM_L1_PORTAL_CONTRACT`, `INDEXER_OPTIMISM_L1_BATCH_SUBMITTER`, `INDEXER_OPTIMISM_L1_BATCH_INBOX`, `INDEXER_OPTIMISM_L1_START_BLOCK`, and `INDEXER_OPTIMISM_L2_BATCH_GENESIS_BLOCK_NUMBER`. | Version: master <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 152 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#L152 

Did you really mean 'Superchain'?

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

View check run for this annotation

Mintlify / Mintlify Validation (blockscout-main) - vale-spellcheck

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

Did you really mean 'Superchain'?
| `INDEXER_OPTIMISM_L1_SYSTEM_CONFIG_CONTRACT` | The address of `SystemConfig` contract on L1 required for almost all Optimism fetchers. Implemented in [#10199](https://github.com/blockscout/blockscout/pull/10199). | Version: v6.8.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L1_BATCH_BLOCKSCOUT_BLOBS_API_URL` | Defines a URL to Blockscout Blobs API to retrieve L1 blobs from that. Example for Sepolia: `https://eth-sepolia.blockscout.com/api/v2/blobs`. Implemented in [#9571](https://github.com/blockscout/blockscout/pull/9571). | Version: v6.3.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L1_BATCH_CELESTIA_BLOBS_API_URL` | Defines a URL to Celestia blobs indexer to retrieve L1 blobs from that. Example: `http://example.com/api/v1/celestia/blob`. Implemented in [#10199](https://github.com/blockscout/blockscout/pull/10199). | Version: v6.8.0+ <br />Default: (empty) <br />Applications: Indexer |
Expand Down