Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
18 changes: 11 additions & 7 deletions setup/env-variables/backend-envs-chain-specific.mdx
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,7 +69,7 @@

</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 |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
Expand All @@ -78,7 +78,7 @@
| `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 |

## Polygon Edge Management
Expand All @@ -105,7 +105,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 108 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#L108

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 +120,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 123 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#L123

Did you really mean 'Blockscout'?

Check warning on line 123 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#L123

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 +136,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 139 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#L139

Did you really mean 'Shibarium'?

| Variable | Description | Parameters |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
Expand All @@ -153,7 +153,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 156 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#L156

Did you really mean 'Rollup'?

| Variable | Description | Parameters |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
Expand All @@ -164,16 +164,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 167 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#L167

Did you really mean 'Ethereum'?

Check warning on line 167 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#L167

Did you really mean 'Mainnet'?

Check warning on line 167 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#L167

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 168 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#L168

Did you really mean 'Rollup'?

Check warning on line 168 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#L168

Did you really mean 'Astar'?

Check warning on line 168 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#L168

Did you really mean 'Ethereum'?

Check warning on line 168 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#L168

Did you really mean 'Mainnet'?

Check warning on line 168 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#L168

Did you really mean 'Ethereum'?

Check warning on line 168 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#L168

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

## Optimism Rollup Management

Check warning on line 176 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#L176

Did you really mean 'Rollup'?

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

Did you really mean 'Blockscout'?

Check warning on line 187 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#L187

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 188 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#L188

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 +201,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 204 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#L204

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 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 '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 212 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#L212

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 213 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#L213

Did you really mean 'interop'?

Check warning on line 213 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#L213

Did you really mean 'Multichain'?

## zkSync Rollup Management

Check warning on line 215 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#L215

Did you really mean 'zkSync'?

Check warning on line 215 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#L215

Did you really mean 'Rollup'?

<Info>
Supported together with setting `CHAIN_TYPE=zksync`
Expand All @@ -221,14 +221,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 224 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#L224

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 226 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#L226

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 231 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#L231

Did you really mean 'Arbitrum'?

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

| 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 240 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#L240

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 241 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#L241

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 245 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#L245

Did you really mean 'Arbitrum'?

Check warning on line 245 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#L245

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

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_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 248 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#L248

Did you really mean 'blockchain'?

Check warning on line 248 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#L248

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 250 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#L250

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

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_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 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 '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 253 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#L253

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 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_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 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 '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 260 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#L260

Did you really mean 'rollups'?

Check warning on line 260 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#L260

Did you really mean 'Ethereum'?

Check warning on line 260 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#L260

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 262 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#L262

Did you really mean 'Arbitrum'?

Check warning on line 262 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#L262

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

<Info>
Supported together with setting `CHAIN_TYPE=celo`

</Info>

| Variable | Description | Parameters |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| 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 |
| `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 278 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#L278

Did you really mean 'Celo'?

Check warning on line 278 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#L278

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 280 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#L280

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 281 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#L281

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 |
| `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 |
| `CELO_LOCKED_GOLD_CONTRACT` | The address of the `LockedGold` core contract. Implemented in [#12893](https://github.com/blockscout/blockscout/pull/12893). | Version: master <br />Default: (empty)<br />Applications: Indexer |
| `CELO_ACCOUNTS_CONTRACT` | The address of the `Accounts` core contract. Implemented in [#12893](https://github.com/blockscout/blockscout/pull/12893). | Version: master <br />Default: (empty)<br />Applications: Indexer |
| `INDEXER_CELO_ACCOUNTS_CONCURRENCY` | Sets the maximum number of concurrent requests for fetching Celo accounts. | Version: master <br />Default: `1`<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 'Celo'?
| `INDEXER_CELO_ACCOUNTS_BATCH_SIZE` | Specifies the number of account addresses processed per batch during fetching. | Version: master <br />Default: `100`<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 291 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#L291

Did you really mean 'Celo'?

Check warning on line 291 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#L291

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

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 297 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#L297

Did you really mean 'Blockscout'?

Check warning on line 297 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#L297

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 301 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#L301

Did you really mean 'Blockscout'?

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

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

</Accordion>

## Filecoin Management

Check warning on line 314 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#L314

Did you really mean 'Filecoin'?

<Info>
Supported together with setting `CHAIN_TYPE=filecoin`
Expand All @@ -316,16 +320,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 323 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#L323

Did you really mean 'Filecoin'?

Check warning on line 323 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#L323

Did you really mean 'mainnet'?

Check warning on line 323 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#L323

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 324 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#L324

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 327 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#L327

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 328 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#L328

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 332 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#L332

Did you really mean 'Blackfort'?

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

| Variable | Description | Parameters |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `BLACKFORT_VALIDATOR_API_URL` | Variable to define the URL of the Blackfort Validator API. Implemented in [#10744](https://github.com/blockscout/blockscout/pull/10744). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: API, Indexer |
| `BLACKFORT_VALIDATOR_API_URL` | Variable to define the URL of the Blackfort Validator API. Implemented in [#10744](https://github.com/blockscout/blockscout/pull/10744). | Version: v6.9.0+ <br />Default: (empty) <br />Applications: API, Indexer |

Check warning on line 341 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#L341

Did you really mean 'Blackfort'?

Check warning on line 341 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#L341

Did you really mean 'Validator'?
Loading