Skip to content

Configuration params for Arbitrum L1-to-L2 messages fetcher #85

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
vbaranov merged 2 commits into from
Jan 11, 2026
Merged

Configuration params for Arbitrum L1-to-L2 messages fetcher #85

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
236119b
Add Arbitrum missed messages tracking environment variables
akolotov Jan 6, 2026
d7994bf
backticks were added unintentionally
akolotov Jan 6, 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
2 changes: 2 additions & 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 @@ -75,9 +75,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 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'?

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-main) - 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) - 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-main) - vale-spellcheck

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

Did you really mean 'Holesky'?

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 |
Expand Down Expand Up @@ -245,6 +245,8 @@
| `INDEXER_ARBITRUM_MISSED_MESSAGES_RECHECK_INTERVAL` | Interval to re-check on the rollup historical messages directed to and from the rollup, in seconds. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `3600` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_MISSED_MESSAGES_BLOCKS_DEPTH` | Amount of L2 blocks to revisit to identify historical cross-chain messages in the messages catchup task. Implemented in [#10374](https://github.com/blockscout/blockscout/pull/10374). | Version: v6.8.0+ <br />Default: `10000` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_TRACKING_MESSAGES_ON_L1_RECHECK_INTERVAL` | Interval to re-check on L1 new messages directed to the rollup, in seconds. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `20` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_MESSAGES_TRACKING_FAILURE_THRESHOLD` | The time threshold for L1 message tracking tasks. If a task has not run successfully within this threshold, it is marked as failed and enters a cooldown period before retrying. Implemented in [#13792](https://github.com/blockscout/blockscout/pull/13792). | Version: master <br />Default: `10m` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_MISSED_MESSAGE_IDS_RANGE` | Size of each message ID range inspected when discovering L1-to-L2 messages with missing L1 origination information. Implemented in [#13792](https://github.com/blockscout/blockscout/pull/13792). | Version: master <br />Default: `10000` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_BATCHES_TRACKING_ENABLED` | Enables monitoring of transaction batches, block confirmations, and L2-to-L1 messages executions. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_ARBITRUM_BATCHES_TRACKING_RECHECK_INTERVAL` | Interval to re-check on L1 new and historical batches, confirmations, and executions, in seconds. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `20` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_BATCHES_TRACKING_L1_FINALIZATION_CHECK_ENABLED` | Whether L1 transactions related to batches, confirmations, and executions need to be monitored for finalization or not. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `false` <br />Applications: Indexer |
Expand Down