Skip to content

Add beacon deposit envs #50

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
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add beacon deposit envs #50

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
24 changes: 15 additions & 9 deletions setup/env-variables/backend-envs-chain-specific.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: "Backend ENVs: Chain Specific"

Check warning on line 2 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#L2 

Did you really mean 'ENVs'?
description: ENVS for specific chains and rollups

Check warning on line 3 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#L3 

Did you really mean 'rollups'?
---

## Chain Specific ENVs

Check warning on line 6 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#L6 

Did you really mean 'ENVs'?

The following ENVs are specific to different types of chains and rollups. To use these specific variables you will also need to set the `CHAIN_TYPE` variable to the appropriate value.

Check warning on line 8 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#L8 

Did you really mean 'ENVs'?

Check warning on line 8 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#L8 

Did you really mean 'rollups'?

| Variable | Description | Parameters |
| ----------- | ----------------------------------------------------------------------- | -------------------------------------------------------------- |
Expand Down Expand Up @@ -56,7 +56,7 @@
```

<Info>
You can browse all available image variants in the [Blockscout GitHub Packages repository](https://github.com/orgs/blockscout/packages). Each image variant includes specific tags and documentation for deployment options.

Check warning on line 59 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#L59 

Did you really mean 'Blockscout'?

</Info>

Expand All @@ -69,17 +69,23 @@

</Warning>

## Ethereum Management

Check warning on line 72 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#L72 

Did you really mean 'Ethereum'?

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

Check warning on line 81 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#L81 

Did you really mean 'Dencun'?

Check warning on line 81 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#L81 

Did you really mean 'hardfork'?
| `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: master <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: master <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: master <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: master <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: master <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: master <br />Default: `1722024023` <br />Applications: Indexer |

## Polygon Edge Management

Expand All @@ -105,7 +111,7 @@

| Variable | Description | Parameters |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| `ROOTSTOCK_REMASC_ADDRESS` | The address hash of remasc address on Rootstock chain. Implemented in [#8542](https://github.com/blockscout/blockscout/pull/8542). | Version: v5.3.0+ <br />Default: (empty) <br />Applications: API |

Check warning on line 114 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#L114 

Did you really mean 'remasc'?
| `ROOTSTOCK_BRIDGE_ADDRESS` | The address hash of bridge address on Rootstock chain. Implemented in [#8542](https://github.com/blockscout/blockscout/pull/8542). | Version: v5.3.0+ <br />Default: (empty) <br />Applications: API |
| `INDEXER_DISABLE_ROOTSTOCK_DATA_FETCHER` | If `true` the fetcher of Rootstock specific fields for blocks that are already in the database won't be started, fields from new blocks will be extracted. Implemented in [#8742](https://github.com/blockscout/blockscout/pull/8742). | Version: v5.3.2+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_ROOTSTOCK_DATA_FETCHER_INTERVAL` | The interval between fetching the next `INDEXER_ROOTSTOCK_DATA_FETCHER_DB_BATCH_SIZE` blocks from the database and the node, used to configure the load on the database and JSON-RPC node. Implemented in [#8742](https://github.com/blockscout/blockscout/pull/8742). | Version: v5.3.2+ <br />Default: (empty) <br />Applications: Indexer |
Expand All @@ -120,7 +126,7 @@
| `INDEXER_SCROLL_L1_RPC` | The RPC endpoint for L1 used to fetch Deposit and Withdrawal messages. Implemented in [#10484](https://github.com/blockscout/blockscout/pull/10484). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_SCROLL_L1_CHAIN_CONTRACT` | The address of ScrollChain contract on L1. Used to fetch batch and bundle events. Implemented in [#10819](https://github.com/blockscout/blockscout/pull/10819). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_SCROLL_L1_BATCH_START_BLOCK` | The number of a start block on L1 to index L1 batches and bundles. If the table of batches is not empty, the process will continue indexing from the last indexed batch. Implemented in [#10819](https://github.com/blockscout/blockscout/pull/10819). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_SCROLL_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 [#12294](https://github.com/blockscout/blockscout/pull/12294). | Version: v8.1.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 129 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#L129 

Did you really mean 'Blockscout'?

Check warning on line 129 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#L129 

Did you really mean 'Sepolia'?
| `INDEXER_SCROLL_L1_MESSENGER_CONTRACT` | The address of L1 Scroll Messenger contract on L1 used to fetch Deposit and Withdrawal messages. Implemented in [#10484](https://github.com/blockscout/blockscout/pull/10484). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_SCROLL_L1_MESSENGER_START_BLOCK` | The number of a start block on L1 to index L1 bridge messages. If the table of bridge operations is not empty, the process will continue indexing from the last indexed L1 message. Implemented in [#10484](https://github.com/blockscout/blockscout/pull/10484). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_SCROLL_L2_MESSENGER_CONTRACT` | The address of L2 Scroll Messenger contract on L2 used to fetch Deposit and Withdrawal messages. Implemented in [#10484](https://github.com/blockscout/blockscout/pull/10484). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |
Expand All @@ -136,7 +142,7 @@
| `SCROLL_L1_BASE_FEE_INIT` | Initial value for `l1_base_fee` parameter. Implemented in [#10484](https://github.com/blockscout/blockscout/pull/10484). | Version: v6.9.0+ <br />Default: `0` <br />Applications: API |
| `SCROLL_L1_BLOB_BASE_FEE_INIT` | Initial value for `l1_blob_base_fee` parameter. Implemented in [#10484](https://github.com/blockscout/blockscout/pull/10484). | Version: v6.9.0+ <br />Default: `0` <br />Applications: API |

## Shibarium Management

Check warning on line 145 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#L145 

Did you really mean 'Shibarium'?

| Variable | Description | Parameters |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
Expand All @@ -153,7 +159,7 @@
| `INDEXER_SHIBARIUM_L2_WETH_CONTRACT` | The address of WETH contract on L2 used to fetch ETH deposits and withdrawals. Required for L2 events indexing. Implemented in [#8929](https://github.com/blockscout/blockscout/pull/8929). | Version: v6.1.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_SHIBARIUM_L2_BONE_WITHDRAW_CONTRACT` | The address of a contract which emits `Withdraw` event on L2. Used to fetch BONE token withdrawals. Required for L2 events indexing. Implemented in [#8929](https://github.com/blockscout/blockscout/pull/8929). | Version: v6.1.0+ <br />Default: (empty) <br />Applications: Indexer |

## Polygon zkEVM Rollup Management

Check warning on line 162 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#L162 

Did you really mean 'Rollup'?

| Variable | Description | Parameters |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
Expand All @@ -164,16 +170,16 @@
| `INDEXER_POLYGON_ZKEVM_L1_RPC` | The RPC endpoint for L1 used to fetch Deposit or Withdrawal bridge events. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_START_BLOCK` | The number of a start block on L1 to index L1 bridge events. If the table of bridge operations is not empty, the process will continue indexing from the last indexed L1 event. If empty or not defined, the L1 events are not handled. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_CONTRACT` | The address of PolygonZkEVMBridgeV2 contract on L1 used to fetch L1 bridge events. Required for L1 bridge events indexing. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_NETWORK_ID` | L1 Network ID in terms of Polygon zkEVM bridge (0 = Ethereum Mainnet, 1 = Polygon zkEVM, 2 = Astar zkEVM, etc.). Required if `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_START_BLOCK` or `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_START_BLOCK` is defined. Implemented in [#9637](https://github.com/blockscout/blockscout/pull/9637). | Version: v6.4.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 173 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#L173 

Did you really mean 'Ethereum'?

Check warning on line 173 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#L173 

Did you really mean 'Mainnet'?

Check warning on line 173 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#L173 

Did you really mean 'Astar'?
| `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_ROLLUP_INDEX` | L1 Rollup index in terms of Polygon zkEVM bridge (0 = Polygon zkEVM, 1 = Astar zkEVM, etc.). Not defined if L1 is Ethereum Mainnet. Required if L1 is not Ethereum Mainnet and `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_START_BLOCK` or `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_START_BLOCK` is defined. Implemented in [#9637](https://github.com/blockscout/blockscout/pull/9637). | Version: v6.4.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 174 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#L174 

Did you really mean 'Rollup'?

Check warning on line 174 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#L174 

Did you really mean 'Astar'?

Check warning on line 174 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#L174 

Did you really mean 'Ethereum'?

Check warning on line 174 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#L174 

Did you really mean 'Mainnet'?

Check warning on line 174 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#L174 

Did you really mean 'Ethereum'?

Check warning on line 174 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#L174 

Did you really mean 'Mainnet'?
| `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_NATIVE_SYMBOL` | The symbol of the native coin on L1 to display it in the table of the bridge Deposits and Withdrawals on UI. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: `ETH` <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_NATIVE_DECIMALS` | The number of decimals to correctly display an amount of native coins for some Deposit or Withdrawal bridge operations on UI. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: `18` <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_START_BLOCK` | The number of a start block on L2 to index L2 bridge events. If the table of bridge operations is not empty, the process will continue indexing from the last indexed L2 event. If empty or not defined, the L2 events are not handled. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_CONTRACT` | The address of PolygonZkEVMBridgeV2 contract on L2 used to fetch L2 bridge events. Required for L2 bridge events indexing. Implemented in [#9098](https://github.com/blockscout/blockscout/pull/9098). | Version: v6.2.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_NETWORK_ID` | L2 Network ID in terms of Polygon zkEVM bridge (1 = Polygon zkEVM, 2 = Astar zkEVM, etc.). Required if `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_START_BLOCK` or `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_START_BLOCK` is defined. Implemented in [#9637](https://github.com/blockscout/blockscout/pull/9637). | Version: v6.4.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 179 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#L179 

Did you really mean 'Astar'?
| `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_ROLLUP_INDEX` | L2 Rollup index in terms of Polygon zkEVM bridge (0 = Polygon zkEVM, 1 = Astar zkEVM, etc.). Required if `INDEXER_POLYGON_ZKEVM_L1_BRIDGE_START_BLOCK` or `INDEXER_POLYGON_ZKEVM_L2_BRIDGE_START_BLOCK` is defined. Implemented in [#9637](https://github.com/blockscout/blockscout/pull/9637). | Version: v6.4.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 180 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#L180 

Did you really mean 'Rollup'?

Check warning on line 180 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#L180 

Did you really mean 'Astar'?

## Optimism Rollup Management

Check warning on line 182 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#L182 

Did you really mean 'Rollup'?

<Info>
Supported together with ENV setting `CHAIN_TYPE=optimism`
Expand All @@ -184,8 +190,8 @@
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `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_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 |

Check warning on line 193 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#L193 

Did you really mean 'Blockscout'?

Check warning on line 193 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#L193 

Did you really mean 'Sepolia'?
| `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 |

Check warning on line 194 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#L194 

Did you really mean 'Celestia'?
| `INDEXER_OPTIMISM_L1_BATCH_BLOCKS_CHUNK_SIZE` | Blocks chunk size to send batch RPC requests. Implemented in [#6980](https://github.com/blockscout/blockscout/pull/6980). | Version: v6.3.0+ <br />Default: `4` <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L2_BATCH_GENESIS_BLOCK_NUMBER` | L2 genesis block number. This is the first block of Optimism BedRock upgrade. Equals to 0 if the new chain starts being already upgraded. The block number can be found at [superchain registry](https://github.com/ethereum-optimism/superchain-registry/tree/main/superchain/configs). [Example](https://github.com/ethereum-optimism/superchain-registry/blob/main/superchain/configs/mainnet/op.yaml). Implemented in [#9260](https://github.com/blockscout/blockscout/pull/9260). | Version: v6.3.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L1_OUTPUT_ORACLE_CONTRACT` | The address of `L2OutputOracle` contract on L1 used to fetch output roots. Required for output roots indexing. Implemented in [#6980](https://github.com/blockscout/blockscout/pull/6980). | Version: v6.3.0+ <br />Default: (empty) <br />Applications: Indexer |
Expand All @@ -201,18 +207,18 @@
| `INDEXER_OPTIMISM_L1_BATCH_SUBMITTER` | Optional. The batch submitter address to index transaction batches on L1. Used as a fallback address (when it cannot be read from the `SystemConfig` contract). Implemented in [#11073](https://github.com/blockscout/blockscout/pull/11073). | Version: v6.10.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L2_HOLOCENE_TIMESTAMP` | Holocene upgrade L2 block timestamp. If not defined, EIP-1559's denominator and multiplier are taken from `EIP_1559_BASE_FEE_MAX_CHANGE_DENOMINATOR` and `EIP_1559_ELASTICITY_MULTIPLIER` envs correspondingly. Implemented in [#11355](https://github.com/blockscout/blockscout/pull/11355). | Version: v6.10.1+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L2_HOLOCENE_BLOCKS_CHUNK_SIZE` | Max number of blocks in `eth_getBlockByNumber` batch request. Implemented in [#11355](https://github.com/blockscout/blockscout/pull/11355). | Version: v6.10.1+ <br />Default: `25` <br />Applications: Indexer |
| `INDEXER_OPTIMISM_L2_INTEROP_START_BLOCK` | Defines a start block number for indexing interop messages (usually `0`). If not defined, the indexing is turned off. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 210 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#L210 

Did you really mean 'interop'?
| `INDEXER_OPTIMISM_L2_INTEROP_BLOCKS_CHUNK_SIZE` | Adjusts blocks chunk size when indexing failed relay transactions. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: `4` <br />Applications: Indexer |
| `INDEXER_OPTIMISM_INTEROP_PRIVATE_KEY` | 32-byte private key in form of `0x...` string. Required and used to `secp256k1` sign data being sent to `/api/v2/import/optimism/interop/` remote API endpoint. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: (empty) <br />Applications: API, Indexer |
| `INDEXER_OPTIMISM_INTEROP_CONNECT_TIMEOUT` | Timeout in seconds for establishing HTTP connection to `/api/v2/import/optimism/interop/` and `/api/v2/optimism/interop/public-key` remote API endpoints. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: `8` <br />Applications: API, Indexer |
| `INDEXER_OPTIMISM_INTEROP_RECV_TIMEOUT` | Timeout in seconds for receiving HTTP response from `/api/v2/import/optimism/interop/` or `/api/v2/optimism/interop/public-key` API endpoint. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: `10` <br />Applications: API, Indexer |
| `INDEXER_OPTIMISM_INTEROP_EXPORT_EXPIRATION_DAYS` | Limits the number of incomplete messages being sent through API to remote instances. The source or relay transactions older than this number of days (starting from the latest block) won't be considered by the handler of incomplete messages. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: `10` <br />Applications: Indexer |
| `INDEXER_OPTIMISM_CHAINSCOUT_API_URL` | URL to Chainscout API to get instance info by chain ID. Must be omitted for local development. For production must be `https://chains.blockscout.com/api/chains/`. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: (empty) <br />Applications: API, Indexer |

Check warning on line 216 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#L216 

Did you really mean 'Chainscout'?
| `INDEXER_OPTIMISM_CHAINSCOUT_FALLBACK_MAP` | Defines `chain_id -> instance_url` map, for example: `{"10": "https://optimism.blockscout.com/", "8453": "https://base.blockscout.com/"}`. Supports extended format like `{"123": {"api": "https://test.blockscout.com:4000/", "ui": "https://test.blockscout.com:3000/"}}` (when backend and frontend have different URLs). Quotes usually are escaped when defining in config file, e.g.: `INDEXER_OPTIMISM_CHAINSCOUT_FALLBACK_MAP="{\"420120000\":\"http://host.docker.internal:4100/\"}"`. Implemented in [#11903](https://github.com/blockscout/blockscout/pull/11903). | Version: v8.0.0+ <br />Default: (empty) <br />Applications: API, Indexer |
| `INDEXER_OPTIMISM_MULTICHAIN_BATCH_SIZE` | Max number of items sent to the Multichain service in one batch. Implemented in [#12387](https://github.com/blockscout/blockscout/pull/12387). | Version: v9.0.0\+ <br />Default: `100` <br />Applications: Indexer |

Check warning on line 218 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#L218 

Did you really mean 'Multichain'?
| `INDEXER_DISABLE_OPTIMISM_INTEROP_MULTICHAIN_EXPORT` | Disables exporting of interop messages to Multichain service. Implemented in [#13051](https://github.com/blockscout/blockscout/pull/13051). | Version: master <br />Default: `true` <br />Applications: Indexer |

Check warning on line 219 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#L219 

Did you really mean 'interop'?

Check warning on line 219 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#L219 

Did you really mean 'Multichain'?

## zkSync Rollup Management

Check warning on line 221 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#L221 

Did you really mean 'zkSync'?

Check warning on line 221 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#L221 

Did you really mean 'Rollup'?

<Info>
Supported together with setting `CHAIN_TYPE=zksync`
Expand All @@ -221,14 +227,14 @@

| Variable | Description | Parameters |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| `INDEXER_ZKSYNC_BATCHES_ENABLED` | Enables zkSync batches fetcher. Implemented in [#9080](https://github.com/blockscout/blockscout/pull/9080). | Version: v6.3.0+ <br />Default: `false` <br />Applications: Indexer |

Check warning on line 230 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#L230 

Did you really mean 'zkSync'?
| `INDEXER_ZKSYNC_BATCHES_CHUNK_SIZE` | The number of RPC calls in one request when reading data from RPC. Implemented in [#9080](https://github.com/blockscout/blockscout/pull/9080). | Version: v6.3.0+ <br />Default: `50` <br />Applications: Indexer |
| `INDEXER_ZKSYNC_NEW_BATCHES_MAX_RANGE` | Maximum amount of batches requested if Blockscout does not have all batches synced. Implemented in [#9080](https://github.com/blockscout/blockscout/pull/9080). | Version: v6.3.0+ <br />Default: `50` <br />Applications: Indexer |

Check warning on line 232 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#L232 

Did you really mean 'Blockscout'?
| `INDEXER_ZKSYNC_NEW_BATCHES_RECHECK_INTERVAL` | The latest batch rechecking interval, seconds. Implemented in [#9080](https://github.com/blockscout/blockscout/pull/9080). | Version: v6.3.0+ <br />Default: `60` <br />Applications: Indexer |
| `INDEXER_ZKSYNC_L1_RPC` | The RPC endpoint for L1 used to fetch status of batches. Implemented in [#9080](https://github.com/blockscout/blockscout/pull/9080). | Version: v6.3.0+ <br />Default: (empty) <br />Applications: Indexer |
| `INDEXER_ZKSYNC_BATCHES_STATUS_RECHECK_INTERVAL` | The batches status rechecking interval, seconds. Implemented in [#9080](https://github.com/blockscout/blockscout/pull/9080). | Version: v6.3.0+ <br />Default: `50` <br />Applications: Indexer |

## Arbitrum Management

Check warning on line 237 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#L237 

Did you really mean 'Arbitrum'?

<Info>
Supported together with setting `CHAIN_TYPE=arbitrum`
Expand All @@ -237,35 +243,35 @@

| Variable | Description | Parameters |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `INDEXER_ARBITRUM_ARBSYS_CONTRACT` | The address of ArbSys contract on the rollup. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `0x0000000000000000000000000000000000000064` <br />Applications: Indexer |

Check warning on line 246 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#L246 

Did you really mean 'rollup'?
| `INDEXER_ARBITRUM_NODE_INTERFACE_CONTRACT` | The address of NodeInterface contract on the rollup. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.8.0+ <br />Default: `0x00000000000000000000000000000000000000C8` <br />Applications: Indexer |

Check warning on line 247 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#L247 

Did you really mean 'rollup'?
| `INDEXER_ARBITRUM_L1_RPC` | The RPC endpoint for L1 used to fetch transaction batches, block confirmations, and cross-chain messages. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: empty <br />Applications: Indexer |
| `INDEXER_ARBITRUM_L1_RPC_CHUNK_SIZE` | The number of RPC calls in one request when reading data from RPC. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `20` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_L1_RPC_HISTORICAL_BLOCKS_RANGE` | The block range size for the eth\_getLogs request. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `1000` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_L1_ROLLUP_CONTRACT` | The Arbitrum Rollup contract address on L1. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: empty <br />Applications: Indexer |

Check warning on line 251 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#L251 

Did you really mean 'Arbitrum'?

Check warning on line 251 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#L251 

Did you really mean 'Rollup'?
| `INDEXER_ARBITRUM_L1_ROLLUP_INIT_BLOCK` | The block number where the Arbitrum rollup contract has been deployed. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `1` <br />Applications: Indexer |

Check warning on line 252 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#L252 

Did you really mean 'Arbitrum'?

Check warning on line 252 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#L252 

Did you really mean 'rollup'?
| `INDEXER_ARBITRUM_L1_COMMON_START_BLOCK` | The block number at which synchronization will commence. It will proceed in both directions: discovering new batches up to the chain head, and historical batches until `INDEXER_ARBITRUM_L1_ROLLUP_INIT_BLOCK`. If omitted, the synchronization starts from the latest block. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `latest block` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_L1_FINALIZATION_THRESHOLD` | The number of blocks below the blockchain head that are considered not yet finalized in environments where the settlement layer is another rollup, or when the L1 node does not support safe block retrieval. Implemented in [#10482](https://github.com/blockscout/blockscout/pull/10482). | Version: v6.8.0+ <br />Default: `1000` <br />Applications: Indexer |

Check warning on line 254 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#L254 

Did you really mean 'blockchain'?

Check warning on line 254 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#L254 

Did you really mean 'rollup'?
| `INDEXER_ARBITRUM_ROLLUP_CHUNK_SIZE` | The number of RPC calls in one request when reading data from RPC. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `20` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_BRIDGE_MESSAGES_TRACKING_ENABLED` | Enables monitoring on L1 of cross-chain messages directed to L2 and catchup on L2 of historical cross-chain messages. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 256 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#L256 

Did you really mean 'catchup'?
| `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 |

Check warning on line 257 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#L257 

Did you really mean 'rollup'?

Check warning on line 257 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#L257 

Did you really mean 'rollup'?
| `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 |

Check warning on line 258 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#L258 

Did you really mean 'catchup'?
| `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 |

Check warning on line 259 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#L259 

Did you really mean 'rollup'?
| `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 |
| `INDEXER_ARBITRUM_BATCHES_TRACKING_MESSAGES_TO_BLOCKS_SHIFT` | Difference between the message count and actual rollup block numbers in the SequencerBatchDelivered event on L1. Applicable for ArbitrumOne only. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `0` <br />Applications: Indexer |

Check warning on line 263 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#L263 

Did you really mean 'rollup'?
| `INDEXER_ARBITRUM_BATCHES_TRACKING_FAILURE_THRESHOLD` | The time threshold for transaction batch monitoring 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 [#12192](https://github.com/blockscout/blockscout/pull/12192). | Version: v8.0.0+ <br />Default: `10m` <br />Applications: Indexer |

Check warning on line 264 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#L264 

Did you really mean 'cooldown'?
| `INDEXER_ARBITRUM_MISSING_BATCHES_RANGE` | Size of each batch range which will be inspected for the missing batches. Since it is not expected that batches are missed often, it is OK to have this value relatively large. Implemented in [#10466](https://github.com/blockscout/blockscout/pull/10446). | Version: v6.8.0+ <br />Default: `10000` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_CONFIRMATIONS_TRACKING_FINALIZED` | Whether to choose `safe` (true) or `latest` (false) block to discover new confirmations. This setting is required to reduce latency between the actual confirmation transaction and its discovery. Recommended to have true on rollups which use Ethereum Mainnet as L1. Determines how fast new confirmations will be discovered. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `true` <br />Applications: Indexer |

Check warning on line 266 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#L266 

Did you really mean 'rollups'?

Check warning on line 266 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#L266 

Did you really mean 'Ethereum'?

Check warning on line 266 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#L266 

Did you really mean 'Mainnet'?
| `INDEXER_ARBITRUM_NEW_BATCHES_LIMIT` | The number of batches to be handled and imported at once. This is applicable for cases when dozens of batches are found in one discovery iteration, and it is necessary to import them in chunks to avoid the entire process being aborted if any errors occur. Implemented in [#9312](https://github.com/blockscout/blockscout/pull/9312). | Version: v6.7.0+ <br />Default: `10` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_DATA_BACKFILL_ENABLED` | Enables a process to backfill the blocks and transaction with Arbitrum specific data. This should only be enabled for Arbitrum chains where blocks were indexed before upgrading to a version that includes Arbitrum-specific data indexing features. Implemented in [#11163](https://github.com/blockscout/blockscout/pull/11163). | Version: v7.0.0+ <br />Default: `false` <br />Applications: Indexer |

Check warning on line 268 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#L268 

Did you really mean 'Arbitrum'?

Check warning on line 268 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#L268 

Did you really mean 'Arbitrum'?
| `INDEXER_ARBITRUM_DATA_BACKFILL_UNINDEXED_BLOCKS_RECHECK_INTERVAL` | The number of L2 blocks to look back in one iteration of the backfill process. Implemented in [#11163](https://github.com/blockscout/blockscout/pull/11163). | Version: v7.0.0+ <br />Default: `120s` <br />Applications: Indexer |
| `INDEXER_ARBITRUM_DATA_BACKFILL_BLOCKS_DEPTH` | Interval to retry the backfill task for unindexed blocks. Implemented in [#11163](https://github.com/blockscout/blockscout/pull/11163). | Version: v7.0.0+ <br />Default: `500` <br />Applications: Indexer |

Check warning on line 270 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#L270 

Did you really mean 'unindexed'?
| `MIGRATION_ARBITRUM_DA_RECORDS_NORMALIZATION_BATCH_SIZE` | Specifies the number of address records processed per batch during normalization of batch-to-blob associations by moving them from arbitrum\_da\_multi\_purpose to a dedicated arbitrum\_batches\_to\_da\_blobs table. Implemented in [#11798](https://github.com/blockscout/blockscout/pull/11798). | Version: v7.0.0+ <br />Default: `500` <br />Applications: Indexer |
| `MIGRATION_ARBITRUM_DA_RECORDS_NORMALIZATION_CONCURRENCY` | Specifies the number of concurrent processes used during normalization of batch-to-blob associations by moving them from arbitrum\_da\_multi\_purpose to a dedicated arbitrum\_batches\_to\_da\_blobs table. Implemented in [#11798](https://github.com/blockscout/blockscout/pull/11798). | Version: v7.0.0+ <br />Default: `1` <br />Applications: Indexer |

## Celo Management

Check warning on line 274 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#L274 

Did you really mean 'Celo'?

<Info>
Supported together with setting `CHAIN_TYPE=celo`
Expand All @@ -275,26 +281,26 @@
| Variable | Description | Parameters |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `CELO_CORE_CONTRACTS` | JSON dictionary containing the addresses and metadata of core CELO network contracts. Read detailed description down below. Implemented in [#9713](https://github.com/blockscout/blockscout/pull/9713). | Version: v6.8.0+ <br />Default: (empty) <br />Applications: API, Indexer |
| `CELO_L2_MIGRATION_BLOCK` | Specifies the block number at which Celo transitioned from L1 to L2, disabling legacy L1 mechanisms (e.g., L1 epochs, old precompiles) once the migration block is indexed. Implemented in [#11949](https://github.com/blockscout/blockscout/pull/11949). | Version: v8.0.0+ <br />Applications: API, Indexer |

Check warning on line 284 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#L284 

Did you really mean 'Celo'?

Check warning on line 284 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#L284 

Did you really mean 'precompiles'?
| `INDEXER_DISABLE_CELO_EPOCH_FETCHER` | If set to `true`, the epoch rewards fetcher will not be started. However, epoch blocks pending to fetch will still be imported into the database. Implemented in [#9944](https://github.com/blockscout/blockscout/pull/9944). | Version: v6.8.0+ <br />Default: `false` <br />Applications: Indexer |
| `INDEXER_DISABLE_CELO_VALIDATOR_GROUP_VOTES_FETCHER` | If set to `true`, the validator group votes fetcher will not be started. Implemented in [#10673](https://github.com/blockscout/blockscout/pull/10673). | Version: v6.9.0+ <br />Default: `false` <br />Applications: Indexer |

Check warning on line 286 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#L286 

Did you really mean 'validator'?
| `INDEXER_CELO_VALIDATOR_GROUP_VOTES_BATCH_SIZE` | Specifies the block range size for the `eth_getLogs` request, determining the number of blocks included between `toBlock` and `fromBlock`. Implemented in [#9944](https://github.com/blockscout/blockscout/pull/9944). | Version: v6.8.0+ <br />Default: `200000` <br />Applications: Indexer |

Check warning on line 287 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#L287 

Did you really mean 'eth_getLogs'?
| `CELO_UNRELEASED_TREASURY_CONTRACT` | The address of the `CeloUnreleasedTreasury` core contract. Implemented in [#12373](https://github.com/blockscout/blockscout/pull/12373). | Version: master+ <br />Default: (empty) <br />Applications: Indexer |
| `CELO_VALIDATORS_CONTRACT` | The address of the `Validators` core contract. Implemented in [#12373](https://github.com/blockscout/blockscout/pull/12373). | Version: master+ <br />Default: (empty) <br />Applications: Indexer |
| `CELO_EPOCH_MANAGER_CONTRACT` | The address of the `EpochManager` core contract. Implemented in [#12373](https://github.com/blockscout/blockscout/pull/12373). | Version: master+ <br />Default: (empty) <br />Applications: Indexer |

<Accordion title="Details on `CELO_CORE_CONTRACTS`">
The CELO network includes several core contracts that are central to its operation. These core contracts manage various aspects of the Celo network, including its stablecoins, governance, identity, and more.

Check warning on line 293 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#L293 

Did you really mean 'Celo'?

Check warning on line 293 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#L293 

Did you really mean 'stablecoins'?

All these contracts can be obtained by querying the `Registry` contract, which is deployed at the genesis block with the address `0x000000000000000000000000000000000000ce10`. This contract serves as a repository for the addresses of all core contracts on the Celo network.

Check warning on line 295 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#L295 

Did you really mean 'Celo'?

Fortunately, core contracts are not updated frequently, so we store information about core contracts statically under the `CELO_CORE_CONTRACTS` variable, which is a JSON object of a specified structure.

In case the contracts are updated, maintaining the Blockscout instance will require updating the `CELO_CORE_CONTRACTS` variable and manually setting blocks for refetch (all blocks produced after the core contracts' update).

Check warning on line 299 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#L299 

Did you really mean 'Blockscout'?

Check warning on line 299 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#L299 

Did you really mean 'refetch'?

The structure of the JSON value for the `CELO_CORE_CONTRACTS` variable is detailed in this [gist](https://gist.github.com/fedor-ivn/c77030d09bd05349710450e0fcf00a1f).

The JSON structure may change. To assemble the `CELO_CORE_CONTRACTS` environment variable, run `mix fetch_celo_core_contracts` in the root of the Blockscout repository. This task will index the chain from block `0` to the latest block number, providing the most up-to-date values.

Check warning on line 303 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#L303 

Did you really mean 'Blockscout'?

The JSON structure in the gist contains two main sections: `addresses` and `events`.

Expand All @@ -307,7 +313,7 @@

</Accordion>

## Filecoin Management

Check warning on line 316 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#L316 

Did you really mean 'Filecoin'?

<Info>
Supported together with setting `CHAIN_TYPE=filecoin`
Expand All @@ -316,16 +322,16 @@

| Variable | Description | Parameters |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| `FILECOIN_NETWORK_PREFIX` | Specifies the expected network prefix for Filecoin addresses. For more details, refer to the [Filecoin Spec](https://spec.filecoin.io/appendix/address/#section-appendix.address.network-prefix). Available values: `f` (for the mainnet), `t` (for testnets). Implemented in [#10468](https://github.com/blockscout/blockscout/pull/10468). | Version: v6.9.0+ <br />Default: `f` <br />Applications: API, Indexer |

Check warning on line 325 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#L325 

Did you really mean 'Filecoin'?

Check warning on line 325 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#L325 

Did you really mean 'mainnet'?

Check warning on line 325 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#L325 

Did you really mean 'testnets'?
| `BERYX_API_TOKEN` | [Beryx API](https://docs.zondax.ch/beryx-api) token, used for retrieving Filecoin native addressing information. Implemented in [#10468](https://github.com/blockscout/blockscout/pull/10468). | Required: ✅ Version: v6.9.0+ <br />Default: (empty) <br />Applications: Indexer |

Check warning on line 326 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#L326 

Did you really mean 'Filecoin'?
| `BERYX_API_BASE_URL` | [Beryx API](https://docs.zondax.ch/beryx-api) base URL. Implemented in [#10468](https://github.com/blockscout/blockscout/pull/10468). | Version: v6.9.0+ <br />Default: `https://api.zondax.ch/fil/data/v3/mainnet` <br />Applications: Indexer |
| `FILFOX_API_BASE_URL` | [Filfox API](https://filfox.info/api/v1/docs/static/index.html) base URL. Implemented in [#11412](https://github.com/blockscout/blockscout/pull/11412). | Version: v7.0.0+ <br />Default: `https://filfox.info/api/v1` <br />Applications: Indexer |
| `INDEXER_DISABLE_FILECOIN_ADDRESS_INFO_FETCHER` | When set to `true`, Filecoin native addressing information will not be fetched, but addresses pending fetch will still be recorded in the database. Implemented in [#10468](https://github.com/blockscout/blockscout/pull/10468). | Version: v6.9.0+ <br />Default: `false` <br />Applications: Indexer |

Check warning on line 329 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#L329 

Did you really mean 'Filecoin'?
| `INDEXER_FILECOIN_ADDRESS_INFO_CONCURRENCY` | Sets the maximum number of concurrent requests made to fetch Filecoin native addressing information. Implemented in [#10468](https://github.com/blockscout/blockscout/pull/10468). | Version: v6.9.0+ <br />Default: `1` <br />Applications: Indexer |

Check warning on line 330 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#L330 

Did you really mean 'Filecoin'?
| `MIGRATION_FILECOIN_PENDING_ADDRESS_OPERATIONS_BATCH_SIZE` | Specifies the number of address records processed per batch during the backfill of pending address fetch operations. Implemented in [#11798](https://github.com/blockscout/blockscout/pull/11798). | Version: v7.0.0+ <br />Default: `100` <br />Applications: Indexer |
| `MIGRATION_FILECOIN_PENDING_ADDRESS_OPERATIONS_CONCURRENCY` | Specifies the number of concurrent processes used during the backfill of pending address fetch operations. Implemented in [#11798](https://github.com/blockscout/blockscout/pull/11798). | Version: v7.0.0+ <br />Default: `1` <br />Applications: Indexer |

## Blackfort Management

Check warning on line 334 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#L334 

Did you really mean 'Blackfort'?

<Info>
Supported together with setting `CHAIN_TYPE=blackfort`
Expand All @@ -334,3 +340,3 @@

| Variable | Description | Parameters |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
Expand Down