Backend ENVs: Common

Time format

Can be set in format 1h for 1 hour, 1m for 1 minute, 1s or 1 for 1 second, 1ms for 1 millisecond

Note: Before release 5.1.2, all environment variables of time format supported only integers in seconds (without dimensions) as values.

General Management

Variable

Description

Parameters

APPLICATION_MODE

Defines the current application mode. Available values are: all, indexer, api. Implemented in .

Version: v6.8.0+ Default: all Applications: API, Indexer

DATABASE_URL

Defines the Postgres Database endpoint.

Required: ✅ Version: All Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_VARIANT

Tells the application which RPC Client the node is using (i.e. erigon, geth, nethermind, besu, filecoin, or anvil) (See Client Settings for more info)

Required: ✅ Version: All Default: geth Applications: API, Indexer

ETHEREUM_JSONRPC_HTTP_URL

The RPC endpoint used to fetch blocks, transactions, receipts, tokens.

Required: ✅ Version: All Default: localhost:8545 Applications: API, Indexer

ETHEREUM_JSONRPC_FALLBACK_HTTP_URL

Fallback JSON RPC HTTP url. Implemented in

Version: v5.1.4+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_HTTP_URLS

Analogue of ETHEREUM_JSONRPC_HTTP_URL for multiple values. Implemented in

Version: v6.10.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_FALLBACK_HTTP_URLS

Analogue of ETHEREUM_JSONRPC_FALLBACK_HTTP_URL for multiple values. Implemented in

Version: v6.10.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_TRACE_URL

The RPC endpoint specifically for the Erigon/Geth/Nethermind/Besu client used by trace_block and trace_replayTransaction. This can be used to designate a tracing node.

Version: All Default: localhost:8545 Applications: API, Indexer

ETHEREUM_JSONRPC_FALLBACK_TRACE_URL

Fallback JSON RPC trace url. Implemented in

Version: v5.1.4+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_TRACE_URLS

Analogue of ETHEREUM_JSONRPC_TRACE_URL for multiple values. Implemented in

Version: v6.10.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_FALLBACK_TRACE_URLS

Analogue of ETHEREUM_JSONRPC_FALLBACK_TRACE_URL for multiple values. Implemented in

Version: v6.10.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_ETH_CALL_URL

JSON RPC url for eth_call method. Implemented in

Version: v6.0.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_FALLBACK_ETH_CALL_URL

Fallback JSON RPC eth_call url. Implemented in

Version: v6.3.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_ETH_CALL_URLS

Analogue of ETHEREUM_JSONRPC_ETH_CALL_URL for multiple values. Implemented in

Version: v6.10.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_FALLBACK_ETH_CALL_URLS

Analogue of ETHEREUM_JSONRPC_FALLBACK_ETH_CALL_URL for multiple values. Implemented in

Version: v6.10.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_WS_URL

The WebSockets RPC endpoint used to subscribe to the newHeads subscription alerting the indexer to fetch new blocks.

Version: All Default: ws://localhost:8546 Applications: Indexer

ETHEREUM_JSONRPC_FALLBACK_WS_URL

The fallback WebSockets RPC endpoint used to subscribe to the newHeads subscription alerting the indexer to fetch new blocks. Implemented in .

Version: v6.8.0+ Default: (empty) Applications: Indexer

ETHEREUM_JSONRPC_WS_RETRY_INTERVAL

The interval between retries of connecting to WebSocket RPC endpoint after the previous attempt is failed. Implemented in .

Version: v6.8.0+ Default: 1m Applications: Indexer

ETHEREUM_JSONRPC_TRANSPORT

Specifies the transport for Blockscout to connect to the Ethereum Node. Available transports are http and ipc. If ipc is selected, also set IPC_PATH variable.

Version: v3.1.0+ Default: http Applications: API, Indexer

ETHEREUM_JSONRPC_HTTP_INSECURE

If true is set, allows insecure HTTP connections to the archive node. For instance, it allows to bypass expired SSL certificate at the archive node endpoint. Implemented in

Version: v5.0.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_HTTP_TIMEOUT

Timeout for ethereum json rpc http requests in seconds. Implemented in

Version: v5.1.2+ Default: 60 Applications: API, Indexer

ETHEREUM_JSONRPC_USER

User in basic auth for JSON RPC endpoint. Implemented in

Version: v5.1.2+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_PASSWORD

Password in basic auth for JSON RPC endpoint. Implemented in

Version: v5.1.2+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_HTTP_HEADERS

Custom headers for JSON RPC endpoint in form of json object, example: {"x-api-key": "nbvkhadvnbkdfav", "x-id": "ndjkfvndfkjv"}. Implemented in

Version: v5.2.1+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_WAIT_PER_TIMEOUT

Wait time for each recent timeout from node. Implemented in

Version: v5.2.3+ Default: 20s Applications: API, Indexer

ETHEREUM_JSONRPC_HTTP_GZIP_ENABLED

If true, then send gzip encoding header and expect encoding in response. Implemented in .

Version: v6.10.0+ Default: false Applications: API, Indexer

TEST_DATABASE_URL

Defines the endpoint of the Postgres Database that is used during testing. Implemented in .

Version: v6.6.0+ Default: (empty) Applications: API, Indexer

DATABASE_READ_ONLY_API_URL

Defines the Postgres Database read-only replica endpoint. If provided, most of the read queries from API v2 and UI go through this endpoint.

Required: ✅ Version: All Default: (empty) Applications: API

TEST_DATABASE_READ_ONLY_API_URL

Defines the endpoint of the Postgres Database read-only replica used during testing. If provided, most read queries from API v2 and UI go through this endpoint. Implemented in .

Version: v6.6.0+ Default: (empty) Applications: API

REPLICA_MAX_LAG

Defines the max lag for read-only replica. If the actual lag is higher than this, replica is considered unavailable and all requests to it are redirected to main DB. Implemented in

Version: v6.10.0+ Default: 5m Applications: API

SECRET_KEY_BASE

The value used to . Use mix phx.gen.secret to generate a new Secret Key Base string to protect production assets.

Required: ✅ Version: All Default: (empty) Applications: API

DATABASE_QUEUE_TARGET

Management of . Implemented in .

Version: v5.4.0+ Default: 50ms Applications: API, Indexer

NETWORK

Environment variable for the main EVM network such as Ethereum or POA.

Version: All Default: POA Applications: API

SUBNETWORK

Environment variable for the subnetwork such as Core or Sokol Network. This will be displayed as selected in the chains list dropdown.

Version: All Default: POA Sokol Applications: API

IPC_PATH

Path to the IPC file of the running node if IPC transport is chosen.

Version: v2.1.1+ Default: (empty) Applications: API, Indexer

NETWORK_PATH

Used to set a network path other than what is displayed in the root directory. An example would be to add /eth/mainnet/ to the root directory.

Version: All Default: / Applications: API

BLOCKSCOUT_HOST

Host for API endpoint examples.

Version: v2.1.0+ Default: localhost Applications: API

BLOCKSCOUT_PROTOCOL

Url scheme for blockscout.

Version: v2.1.0+ Default: prod env https, dev env http Applications: API

CHECK_ORIGIN

Used to check the origin of requests when the origin header is present. It defaults to false. In case of true, it will check against the host value.

Version: All Default: false Applications: API

PORT

Default port the application runs on is 4000.

Version: All Default: 4000 Applications: API

COIN

Coin is checked via the CoinGecko API to obtain USD prices on graphs and other areas of the UI.

Version: All Default: POA Applications: API, Indexer

COIN_NAME

Displayed name of the coin. Also used for "Add chain to MetaMask" button and for Account functionality as native coin name in the email letters for watch list.

Version: v4.1.2+ Default: (empty) Applications: API

EMISSION_FORMAT

Should be set to POA if you have block emission identical to POA Network. This env var is used only if CHAIN_SPEC_PATH is set.

Version: v2.0.4+ Default: DEFAULT Applications: API, Indexer

CHAIN_SPEC_PATH

Chain specification path (absolute file system path or URL) to import block emission reward ranges and genesis account balances from. Geth- and OpenEthereum-style specs are supported.

Version: v2.0.4+ Default: (empty) Applications: API, Indexer

CHAIN_SPEC_PROCESSING_DELAY

Chain specification path processing delay. . Implemented in .

Version: v7.0.0+ Default: 15s Applications: API, Indexer

PRECOMPILED_CONTRACTS_CONFIG_PATH

Precompiled contracts description path (absolute file system path or URL) to import ABI and source code of the precompiled contracts.

Version: v6.5.0+ Default: (empty) or /app/config/assets/precompiles-arbitrum.json for arbitrum chaintype Applications: API, Indexer

SUPPLY_MODULE

Used by RSK in order to tell the application how to calculate the total supply of the chain. Available value is RSK

Version: All Default: (empty) Applications: API, Indexer

POOL_SIZE

Defines the number of database connections allowed excluding read-only API endpoints requests.

Version: All Default: 50 Applications: API, Indexer

POOL_SIZE_API

Defines the number of database connections allowed for read-only API endpoints requests.

Version: v4.1.0+ Default: 50 Applications: API

ECTO_USE_SSL

Production environment variable to use SSL on Ecto queries.

Version: All Default: TRUE Applications: API, Indexer

HEART_BEAT_TIMEOUT

Production environment variable to restart the application in the event of a crash.

Version: All Default: 30 Applications: API, Indexer

HEART_COMMAND

Production environment variable to restart the application in the event of a crash.

Version: All Default: (empty) Applications: API, Indexer

ELIXIR_VERSION

Elixir version to install on the node before Blockscout deploy. It is used in bash script in Terraform / Ansible deployment script

Version: All Default: (empty) Applications: API, Indexer

DISABLE_WEBAPP

If true endpoints to webapp are hidden. Also, enabling it makes notifications go through db_notify

Needs Recompile: ☑️ Version: v2.0.3+ Default: false Applications: API, Indexer

API_V1_READ_METHODS_DISABLED

If true, read-only endpoints to API v1 are hidden.

Needs Recompile: ☑️ Version: v5.1.5+ Default: false Applications: API

API_V1_WRITE_METHODS_DISABLED

If true, write endpoints to API v1 are hidden.

Needs Recompile: ☑️ Version: v5.1.5+ Default: false Applications: API

DISABLE_API

If true, endpoint is not started. Set this if you want to use an indexer-only setup. Implemented in

Version: v6.6.0+ Default: false Applications: API, Indexer

WEBAPP_URL

Link to web application instance, e.g. protocol://host/path

Version: v2.0.3+ Default: (empty) Applications: API

API_URL

Link to API instance, e.g. protocol://host/path

Version: v2.0.3+ Default: (empty) Applications: API

API_V2_ENABLED

Enable API V2. Implemented in (v5.0.0+), default true since

Version: v5.3.2+ Default: true Applications: API

API_SENSITIVE_ENDPOINTS_KEY

API key to protect some sensitive endpoints. Implemented in

Version: v5.1.5+ Default: (empty) Applications: API

CHECKSUM_ADDRESS_HASHES

If set to true, redirects to checksummed version of address hashes.

Version: v3.1.0+ Default: true Applications: API

CHECKSUM_FUNCTION

Defines checksum address function. 2 available values: rsk, eth

Version: v2.0.1+ Default: eth Applications: API

RESTRICTED_LIST

A comma-separated list of addresses to enable restricted access to them.

Version: v3.3.3+ Default: (empty) Applications: API

RESTRICTED_LIST_KEY

A key to access addresses listed inRESTRICTED_LIST variable. Can be passed via query param to the page's URL: ?key=...

Version: v3.3.3+ Default: (empty) Applications: API

CHAIN_TYPE

Specifies the blockchain architecture and enables chain-specific data models and fetchers.

Runtime configurable (v8.0.0+): neon, stability, blackfort, shibarium, polygon_edge Needs recompilation: ethereum, optimism, arbitrum, celo, polygon_zkevm, rsk, suave, zetachain, filecoin, zilliqa, and other values prior to v8.0.0 Version: v5.3.0+ Default: default Applications: API, Indexer

CHAIN_ID

Chain ID of the network. For instance, 100 in the case of xDai chain.

Version: v3.7.0+ Default: (empty) Applications: API, Indexer

JSON_RPC

JSON RPC endpoint of the chain for the WalletConnect integration. Implemented in

Version: v4.1.0+ Default: (empty) Applications: API, Indexer

HEALTH_MONITOR_CHECK_INTERVAL

Interval between health stats collection. . Implemented in

Version: v8.0.0+ Default: 1m Applications: API, Indexer

HEALTH_MONITOR_BLOCKS_PERIOD

New blocks indexed max delay in /health API endpoint. . Implemented in

Version: v8.0.0+ Default: 5m Applications: API, Indexer

HEALTH_MONITOR_BATCHES_PERIOD

New batches indexed max delay in /health API endpoint. . Implemented in

Version: v8.0.0+ Default: 4h Applications: API, Indexer

NEW_TAGS

Add public tag labels. More info in

Version: v5.0.0+ Default: (empty) Applications: API

CUSTOM_CONTRACT_ADDRESSES_${tag_name}

Specify addresses for some label. More info in

Version: v5.0.0+ Default: (empty) Applications: API

SESSION_COOKIE_DOMAIN

Value of this env will be added to domain of session cookie. Implemented in

Needs Recompile: ☑️ Version: v5.0.0+ Default: (empty) Applications: API

DECODE_NOT_A_CONTRACT_CALLS

Allows decoding of contract calls directed to addresses which are not contracts. Implemented in

Needs Recompile: ☑️ Version: v5.1.0+ Default: false Applications: API

EIP_1559_ELASTICITY_MULTIPLIER

EIP-1559 elasticity multiplier. See also INDEXER_OPTIMISM_L2_HOLOCENE_TIMESTAMP. Implemented in

Version: v5.1.3+ Default: 2 Applications: API

EIP_1559_BASE_FEE_MAX_CHANGE_DENOMINATOR

EIP-1559 base fee max change denominator. See also INDEXER_OPTIMISM_L2_HOLOCENE_TIMESTAMP. Implemented in

Version: v6.2.0+ Default: 8 Applications: API

ADDRESSES_TABS_COUNTERS_TTL

TTL for cached tabs counters (works only for counters which are < 51, if counter >= 51, then ttl == :infinity). Implemented in

Version: v5.3.0+ Default: 10m Applications: API

API_INTERNAL_TRANSACTIONS_INDEXING_FINISHED_THRESHOLD

In the case when the 1st tx in the chain already has internal transactions, If the number of blocks in pending_block_operations is less than the value in this env var, Blockscout will consider that indexing of internal transactions is finished, otherwise, it will consider that indexing is still taking place and the indexing banner will appear at the top. Implemented in .

Version: v5.2.0+ Default: 1000 Applications: API

DATABASE_EVENT_URL

Variable to define the Postgres Database endpoint that will be used by event listener process. Applicable for separate indexer and API setup. More info in related PR. Implemented in .

Version: v6.8.0+ Default: (empty) Applications: API

PUBLIC_METRICS_ENABLED

Variable to enable running queries at /public-metrics endpoint. Implemented in .

Version: v6.8.0+ Default: false Applications: API

PUBLIC_METRICS_UPDATE_PERIOD_HOURS

Public metrics update period in hours at /public-metrics endpoint. Implemented in .

Version: v6.8.0+ Default: 24 Applications: API

SHRINK_INTERNAL_TRANSACTIONS_ENABLED

Variable to enable internal transactions shrinking logic. Implemented in .

Version: v6.8.0+ Default: false Applications: API, Indexer

HACKNEY_DEFAULT_POOL_SIZE

Size of default hackney pool. Implemented in .

Version: master Default: 1000 Applications: API, Indexer

Indexer Management

Variable

Description

Parameters

BLOCK_TRANSFORMER

Transformer for blocks: base or clique.

Version: v1.3.4+ Default: base Applications: Indexer

DISABLE_INDEXER

If true, indexer application doesn't run.

Version: v2.0.3+ Default: false Applications: API, Indexer

INDEXER_HIDE_INDEXING_PROGRESS_ALERT

If true, indexer progress alert will be disabled even if initial catchup indexing is still in place. Implemented in .

Version: v5.1.5+ Default: false Applications: API

INDEXER_PENDING_TRANSACTIONS_SANITIZER_INTERVAL

Interval between pending transactions sanitizing. Implemented in .

Version: v6.10.1 Default: 1h Applications: Indexer

INDEXER_DISABLE_PENDING_TRANSACTIONS_FETCHER

If true, pending transactions fetcher is disabled.

Version: v4.1.2+ Default: false Applications: Indexer

INDEXER_DISABLE_INTERNAL_TRANSACTIONS_FETCHER

If true, internal transactions fetcher is disabled.

Version: v4.1.2+ Default: false Applications: Indexer

INDEXER_DISABLE_BLOCK_REWARD_FETCHER

if true, block rewards fetcher is disabled.

Version: v4.1.3+ Default: false Applications: Indexer

INDEXER_DISABLE_ADDRESS_COIN_BALANCE_FETCHER

If true, coin balances fetcher is disabled.

Version: v4.1.3+ Default: false Applications: Indexer

INDEXER_DISABLE_CATALOGED_TOKEN_UPDATER_FETCHER

If true, cataloged tokens metadata fetcher is disabled.

Version: v4.1.3+ Default: false Applications: Indexer

INDEXER_MEMORY_LIMIT

Memory soft limit for the indexer.

Version: v4.1.3+ Default: 1Gb Applications: Indexer

INDEXER_SYSTEM_MEMORY_PERCENTAGE

Percentage of total memory available to the VM that an application can use if INDEXER_MEMORY_LIMIT is not set. Implemented in .

Version: v6.9.0+ Default: 60 Applications: Indexer

INDEXER_EMPTY_BLOCKS_SANITIZER_BATCH_SIZE

Batch size for empty block sanitizer (re-fetcher). Default value changed from 100 to 10 in the release v6.10.1 ()

Version: v4.1.3+ Default: 10 Applications: Indexer

INDEXER_CATCHUP_BLOCKS_BATCH_SIZE

Batch size for blocks catchup fetcher. Implemented in .

Version: v5.0.0+ Default: 10 Applications: Indexer

INDEXER_CATCHUP_BLOCKS_CONCURRENCY

Concurrency for blocks catchup fetcher. Implemented in .

Version: v5.0.0+ Default: 10 Applications: Indexer

INDEXER_DISABLE_EMPTY_BLOCKS_SANITIZER

Empty blocks sanitizer is disabled if true

Version: v5.1.2+ Default: false Applications: Indexer

DISABLE_REALTIME_INDEXER

If true, realtime fetcher doesn't run.

Version: v4.1.6+ Default: false Applications: Indexer

FIRST_BLOCK

The block number, where import of blocks by catchup fetcher begins from.

Version: v1.3.8+ Default: 0 Applications: API, Indexer

LAST_BLOCK

The block number, where import of blocks by catchup fetcher stops.

Version: v2.0.3+ Default: (empty) Applications: Indexer

TRACE_FIRST_BLOCK

The block number, where indexing of internal transactions begins from.

Version: v4.1.0+ Default: 0 Applications: API, Indexer

TRACE_LAST_BLOCK

The block number, where indexing of internal transactions stops.

Version: v4.1.0+ Default: (empty) Applications: API, Indexer

BLOCK_RANGES

Block ranges to import by catchup fetcher. Example: BLOCK_RANGES="1..3,123..500,30..50,500..latest". Implemented in

Version: v4.1.7+ Default: (empty) Applications: Indexer

FETCH_REWARDS_WAY

Tells the application how to calculate block rewards, by fetching via json_rpc (trace_block) or manual by block params (manual).

Version: v4.1.4+ Default: trace_block Applications: Indexer

IPFS_GATEWAY_URL

IPFS gateway url for fetching token instance metadata from IPFS including token instance icon.

Version: v5.3.0+ Default: https://ipfs.io/ipfs Applications: Indexer

IPFS_GATEWAY_URL_PARAM_KEY

The key of the parameter to add to IPFS gateway url. Implemented in .

Version: v6.5.0+ Default: (empty) Applications: Indexer

IPFS_GATEWAY_URL_PARAM_VALUE

The value of the parameter to add to IPFS gateway url. Implemented in .

Version: v6.5.0+ Default: (empty) Applications: Indexer

IPFS_GATEWAY_URL_PARAM_LOCATION

Whether to add extra params: to query string or to the headers. Available values: query/header. Implemented in .

Version: v6.5.0+ Default: (empty) Applications: Indexer

IPFS_PUBLIC_GATEWAY_URL

IPFS public gateway url which is used by frontend to display IPFS resources such as token instance image.

Version: v6.8.0+ Default: https://ipfs.io/ipfs Applications: API

ETHEREUM_JSONRPC_DEBUG_TRACE_TRANSACTION_TIMEOUT

Timeout for debug_traceTransaction/debug_traceBlockByNumber JSON RPC method requests in case of geth archive node. Supported time formats: . Introduced in

Version: v4.1.3+ Default: 5s Applications: Indexer

ETHEREUM_JSONRPC_DISABLE_ARCHIVE_BALANCES

If true, all the requests with the method eth_getBalance with any block as parameter but latest are ignored. Implemented in

Version: v5.0.0+ Default: false Applications: API, Indexer

ETHEREUM_JSONRPC_PENDING_TRANSACTIONS_TYPE

Defines which method will be used for fetching pending transactions: default - default method for fetching internal transactions for current ETHEREUM_JSONRPC_VARIANT, geth - txpool_content method will be used, parity - parity_pendingTransactions will be used. Implemented in

Version: v5.0.0+ Default: default Applications: Indexer

INDEXER_INTERNAL_TRANSACTIONS_BATCH_SIZE

Batch size for internal transactions fetcher. Implemented in .

Version: v5.0.0+ Default: 10 Applications: Indexer

INDEXER_INTERNAL_TRANSACTIONS_CONCURRENCY

Concurrency for internal transactions fetcher. Implemented in .

Version: v5.0.0+ Default: 4 Applications: Indexer

INDEXER_BLOCK_REWARD_BATCH_SIZE

Batch size for block reward fetcher. Implemented in .

Version: v5.1.2+ Default: 10 Applications: Indexer

INDEXER_BLOCK_REWARD_CONCURRENCY

Concurrency for block reward fetcher. Implemented in .

Version: v5.1.2+ Default: 4 Applications: Indexer

INDEXER_RECEIPTS_BATCH_SIZE

Batch size for transaction receipts fetcher. Implemented in .

Version: v5.0.0+ Default: 250 Applications: Indexer

INDEXER_RECEIPTS_CONCURRENCY

Concurrency for transaction receipts fetcher. Implemented in .

Version: v5.0.0+ Default: 10 Applications: Indexer

INDEXER_COIN_BALANCES_BATCH_SIZE

Batch size for coin balances fetcher. Implemented in .

Version: v5.0.0+ Default: 100 Applications: Indexer

INDEXER_COIN_BALANCES_CONCURRENCY

Concurrency for coin balances fetcher. Implemented in .

Version: v5.0.0+ Default: 4 Applications: Indexer

INDEXER_TOKEN_CONCURRENCY

Concurrency for token fetcher. Implemented in .

Version: v5.2.2+ Default: 10 Applications: Indexer

INDEXER_TOKEN_BALANCES_BATCH_SIZE

Batch size for token balances fetcher. Implemented in .

Version: v5.1.5+ Default: 100 Applications: Indexer

INDEXER_TOKEN_BALANCES_CONCURRENCY

Concurrency for token balances fetcher. Implemented in .

Version: v5.2.2+ Default: 10 Applications: Indexer

INDEXER_TOKEN_BALANCES_MAX_REFETCH_INTERVAL

Maximum interval between attempts to fetch address token balance. . Implemented in .

Version: v6.8.1+ Default: 168h Applications: Indexer

INDEXER_TOKEN_BALANCES_EXPONENTIAL_TIMEOUT_COEFF

Coefficient to calculate exponential timeout. Implemented in .

Version: v6.9.0+ Default: 100 Applications: Indexer

INDEXER_TX_ACTIONS_ENABLE

If true, transaction action indexer is active. Implemented in .

Version: v5.1.0+ Default: false Applications: Indexer

INDEXER_TX_ACTIONS_MAX_TOKEN_CACHE_SIZE

Maximum number of items in an internal cache of tx actions indexing process (to limit memory consumption). Implemented in .

Version: v5.1.0+ Default: 100000 Applications: Indexer

INDEXER_TX_ACTIONS_REINDEX_FIRST_BLOCK

The first block of a block range for historical indexing or reindexing of tx actions. Implemented in .

Version: v5.1.0+ Default: (empty) Applications: Indexer

INDEXER_TX_ACTIONS_REINDEX_LAST_BLOCK

The last block of a block range for historical indexing or reindexing of tx actions. Implemented in .

Version: v5.1.0+ Default: (empty) Applications: Indexer

INDEXER_TX_ACTIONS_REINDEX_PROTOCOLS

Comma-separated names of protocols which should be indexed or reindexed on historical blocks defined by the range. Example: uniswap_v3,zkbob - only these protocols will be indexed or reindexed for the defined block range. If the value is an empty string (or not defined), all supported protocols will be indexed/reindexed. This option is not applicable to realtime and catchup fetchers (it always indexes all supported protocols). Implemented in .

Version: v5.1.0+ Default: (empty) Applications: Indexer

INDEXER_TX_ACTIONS_AAVE_V3_POOL_CONTRACT

Pool contract address for Aave v3 protocol. If not defined, Aave transaction actions are ignored by the indexer. Implemented in .

Version: v5.1.3+ Default: (empty) Applications: Indexer

INDEXER_TX_ACTIONS_UNISWAP_V3_FACTORY_CONTRACT

UniswapV3Factory contract address. Implemented in .

Version: v5.1.4+ Default: 0x1F98431c8aD98523631AE4a59f267346ea31F984 Applications: Indexer

INDEXER_TX_ACTIONS_UNISWAP_V3_NFT_POSITION_MANAGER_CONTRACT

NonfungiblePositionManager contract address for Uniswap v3. Implemented in .

Version: v5.1.4+ Default: 0xC36442b4a4522E871399CD717aBDD847Ab11FE88 Applications: Indexer

INDEXER_CATCHUP_MISSING_RANGES_BATCH_SIZE

Batch size for missing ranges collector. Implemented in .

Version: v5.0.0+ Default: 100000 Applications: Indexer

MIN_MISSING_BLOCK_NUMBER_BATCH_SIZE

Batch size for min missing block number updater. Implemented in .

Version: v5.0.0+ Default: 100000 Applications: API, Indexer

INDEXER_INTERNAL_TRANSACTIONS_TRACER_TYPE

Tracer type for debug_traceTransaction/debug_traceBlockByNumber requests for geth-like nodes. Possible values are: js to use custom Blockscout js tracer, call_tracer to use built-in callTracer geth tracer, opcode to use built-in Struct/opcode logger geth tracer, polygon_edge to work with Polygon edge nodes. Implemented in ,

Version: v5.1.0+ Default: call_tracer Applications: Indexer

INDEXER_TOKEN_INSTANCE_RETRY_MAX_REFETCH_INTERVAL

Maximum interval between attempts to fetch token instance metadata. . Implemented in .

Version: v6.8.0+ Default: 168h Applications: Indexer

INDEXER_TOKEN_INSTANCE_RETRY_EXPONENTIAL_TIMEOUT_BASE

Base to calculate exponential timeout. Implemented in .

Version: v6.8.0+ Default: 2 Applications: Indexer

INDEXER_TOKEN_INSTANCE_RETRY_EXPONENTIAL_TIMEOUT_COEFF

Coefficient to calculate exponential timeout. Implemented in .

Version: v6.8.0+ Default: 100 Applications: Indexer

INDEXER_TOKEN_INSTANCE_RETRY_CONCURRENCY

Concurrency for retry token instance fetcher. Implemented in .

Version: v5.1.4+ Default: 10 Applications: Indexer

INDEXER_TOKEN_INSTANCE_REALTIME_CONCURRENCY

Concurrency for realtime token instance fetcher. Implemented in .

Version: v5.1.4+ Default: 10 Applications: Indexer

INDEXER_TOKEN_INSTANCE_SANITIZE_CONCURRENCY

Concurrency for sanitize token instance fetcher. Implemented in .

Version: v5.1.4+ Default: 10 Applications: Indexer

INDEXER_TOKEN_INSTANCE_REFETCH_CONCURRENCY

Concurrency for the Token instance fetcher, which re-fetches NFT collections marked to refetch. Implemented in .

Version: v5.1.4+ Default: 10 Applications: Indexer

INDEXER_DISABLE_TOKEN_INSTANCE_RETRY_FETCHER

If true, retry token instance fetcher doesn't run.

Version: v5.1.4+ Default: false Applications: Indexer

INDEXER_DISABLE_TOKEN_INSTANCE_REALTIME_FETCHER

If true, realtime token instance fetcher doesn't run.

Version: v5.1.4+ Default: false Applications: Indexer

INDEXER_TOKEN_INSTANCE_REALTIME_RETRY_ENABLED

If true, realtime token instance fetcher will retry once on 404 and 500 error. Implemented in .

Version: v6.6.0+ Default: false Applications: Indexer

INDEXER_TOKEN_INSTANCE_REALTIME_RETRY_TIMEOUT

Timeout for retry set by INDEXER_TOKEN_INSTANCE_REALTIME_RETRY_ENABLED. . Implemented in .

Version: v6.6.0+ Default: 5s Applications: Indexer

INDEXER_DISABLE_TOKEN_INSTANCE_SANITIZE_FETCHER

If true, sanitize token instance fetcher doesn't run

Version: v5.1.4+ Default: false Applications: Indexer

INDEXER_DISABLE_TOKEN_INSTANCE_REFETCH_FETCHER

If true, the Token instance fetcher, which re-fetches NFT collections marked to refetch, doesn't run. Implemented in .

Version: v7.0.0+ Default: false Applications: Indexer

INDEXER_TOKEN_INSTANCE_USE_BASE_URI_RETRY

If true, and request to tokenURI(tokenId) failed with VM execution error, Blockscout will make request to baseURI and try to request metadata from baseURI + tokenId

Version: v6.2.0+ Default: false Applications: Indexer

INDEXER_TOKEN_INSTANCE_CIDR_BLACKLIST

List of IP addresses in CIDR format to block when fetching token instance metadata. Example: "0.0.0.0/32,192.168.0.0/16". Implemented in .

Version: v8.0.0+ Default: (empty) Applications: Indexer

INDEXER_TOKEN_INSTANCE_HOST_FILTERING_ENABLED

If false, the URL from which metadata is fetched will not be resolved to an IP address, and the IP address will not be checked against the blacklist. Implemented in .

Version: v8.0.0+ Default: true Applications: Indexer

INDEXER_TOKEN_INSTANCE_ALLOWED_URI_PROTOCOLS

List of allowed URI protocols (schemes) for requests when fetching token instance metadata. Implemented in .

Version: v8.0.0+ Default: http,https Applications: Indexer

INDEXER_REALTIME_FETCHER_MAX_GAP

Max gap between consecutive latest blocks that will be filled by realtime fetcher. Implemented in

Version: v5.1.5+ Default: 1000 Applications: Indexer

INDEXER_REALTIME_FETCHER_POLLING_PERIOD

Period between polling the latest block in realtime fetcher. . Implemented in

Version: v7.0.0+ Default: (empty) Applications: Indexer

INDEXER_DISABLE_WITHDRAWALS_FETCHER

If true, withdrawals fetcher is disabled. Implemented in .

Version: v5.1.5+ Default: true Applications: Indexer

WITHDRAWALS_FIRST_BLOCK

The block number, where import of withdrawals by catchup fetcher begins from. Should be the block where withdrawals upgrade occurred on the chain. Implemented in .

Version: v5.1.5+ Default: (empty) Applications: Indexer

INDEXER_CATCHUP_BLOCK_INTERVAL

Interval between blocks catchup fetcher tasks. Implemented in .

Version: v5.1.5+ Default: 0s Applications: Indexer

INDEXER_FETCHER_INIT_QUERY_LIMIT

Limit for all fetchers init queries. Implemented in .

Version: v5.2.0+ Default: 100 Applications: Indexer

INDEXER_TOKEN_INSTANCE_RETRY_BATCH_SIZE

Batch size for retry token instance fetcher. Implemented in

Version: v5.2.3+ Default: 10 Applications: Indexer

INDEXER_TOKEN_INSTANCE_REALTIME_BATCH_SIZE

Batch size for realtime token instance fetcher. Implemented in .

Version: v5.2.3+ Default: 1 Applications: Indexer

INDEXER_TOKEN_INSTANCE_SANITIZE_BATCH_SIZE

Batch size for sanitize token instance fetcher. Implemented in .

Version: v5.2.3+ Default: 10 Applications: Indexer

INDEXER_TOKEN_INSTANCE_REFETCH_BATCH_SIZE

Batch size for the Token instance fetcher, which re-fetches NFT collections marked to refetch. Implemented in .

Version: v5.2.3+ Default: 10 Applications: Indexer

INDEXER_TOKEN_BALANCES_FETCHER_INIT_QUERY_LIMIT

Limit for token balance fetcher init queries. Implemented in .

Version: v5.2.3+ Default: 100000 Applications: Indexer

INDEXER_COIN_BALANCES_FETCHER_INIT_QUERY_LIMIT

Limit for coin balance fetcher init queries. Implemented in .

Version: v5.3.0+ Default: 2000 Applications: Indexer

INDEXER_DISABLE_TOKEN_INSTANCE_ERC_1155_SANITIZE_FETCHER

If true, erc-1155-sanitize token instance fetcher doesn't run. Implemented in .

Version: v6.2.0+ Default: false Applications: Indexer

INDEXER_DISABLE_TOKEN_INSTANCE_ERC_721_SANITIZE_FETCHER

If true, erc-721-sanitize token instance fetcher doesn't run. Implemented in .

Version: v6.2.0+ Default: false Applications: Indexer

INDEXER_EMPTY_BLOCKS_SANITIZER_INTERVAL

Interval for empty block sanitizer. Implemented in

Version: v5.3.0+ Default: 5m Applications: Indexer

ETHEREUM_JSONRPC_ARCHIVE_BALANCES_WINDOW

Max block number gap from latest for which balances requests can be processed when ETHEREUM_JSONRPC_DISABLE_ARCHIVE_BALANCES env var is set to true. Implemented in

Version: v5.3.1+ Default: 200 Applications: API, Indexer

DISABLE_CATCHUP_INDEXER

If true, catchup fetcher doesn't run.

Version: v5.3.2+ Default: false Applications: Indexer

TRACE_BLOCK_RANGES

Block ranges for traceable blocks. Example: TRACE_BLOCK_RANGES="1..3,123..500,30..50,500..latest". Implemented in

Version: v5.4.0+ Default: (empty) Applications: API, Indexer

ETHEREUM_JSONRPC_GETH_TRACE_BY_BLOCK

Enable tracing by block for geth variant. Implemented in

Version: v6.1.0+ Default: false Applications: Indexer

INDEXER_GRACEFUL_SHUTDOWN_PERIOD

Time that will be given to the block fetchers when stopping the application before they are killed. Implemented in

Version: v6.5.0+ Default: 5m Applications: Indexer

MISSING_BALANCE_OF_TOKENS_WINDOW_SIZE

Minimal blocks count until the next token balance request will be executed for tokens that doesn't implement balanceOf function. Implemented in

Version: v6.8.0+ Default: 100 Applications: Indexer

ETHEREUM_JSONRPC_GETH_ALLOW_EMPTY_TRACES

Allow transactions to not have internal transactions. Implemented in

Version: v6.8.0+ Default: false Applications: Indexer

INDEXER_DISABLE_REPLACED_TRANSACTION_FETCHER

If true, Indexer.Fetcher.ReplacedTransaction fetcher doesn't run.

Version: v6.8.0+ Default: false Applications: Indexer

INDEXER_INTERNAL_TRANSACTIONS_FETCH_ORDER

Order of fetching internal transactions from node. Possible values: asc, desc. Implemented in

Version: v6.9.0+ Default: asc Applications: Indexer

DB Migrations & Sanitizer Management

Variable

Description

Parameters

MIGRATION_SHRINK_INTERNAL_TRANSACTIONS_BATCH_SIZE

Batch size of the shrink internal transactions migration. Note: before release "v6.8.0", the default value was 1000. Implemented in , changed default value in . Renamed in .

Version: v7.0.0+ Default: 100 Applications: API, Indexer

MIGRATION_SHRINK_INTERNAL_TRANSACTIONS_CONCURRENCY

Concurrency of the shrink internal transactions migration. Implemented in . Renamed in .

Version: v7.0.0+ Default: 10 Applications: API, Indexer

MIGRATION_TOKEN_INSTANCE_OWNER_CONCURRENCY

Concurrency of new fields backfiller implemented in . Renamed in .

Version: v7.0.0+ Default: 5 Applications: API, Indexer

MIGRATION_TOKEN_INSTANCE_OWNER_BATCH_SIZE

Batch size of new fields backfiller implemented in . Renamed in .

Version: v7.0.0+ Default: 50 Applications: API, Indexer

MIGRATION_TOKEN_INSTANCE_OWNER_ENABLED

Enable of backfiller from implemented in . Renamed in .

Version: v7.0.0+ Default: false Applications: API, Indexer

MIGRATION_TRANSACTIONS_TABLE_DENORMALIZATION_BATCH_SIZE

Number of transactions to denormalize (add block timestamp and consensus) in the batch. Renamed in .

Version: v7.0.0+ Default: 500 Applications: API, Indexer

MIGRATION_TRANSACTIONS_TABLE_DENORMALIZATION_CONCURRENCY

Number of parallel denormalization transaction batches processing. Renamed in .

Version: v7.0.0+ Default: 10 Applications: API, Indexer

MIGRATION_TOKEN_TRANSFER_TOKEN_TYPE_BATCH_SIZE

Number of token transfers to denormalize (add token_type) in the batch. Renamed in .

Version: v7.0.0+ Default: 100 Applications: API, Indexer

MIGRATION_TOKEN_TRANSFER_TOKEN_TYPE_CONCURRENCY

Number of parallel denormalization token transfer batches processing. Renamed in .

Version: v7.0.0+ Default: 1 Applications: API, Indexer

MIGRATION_SANITIZE_INCORRECT_NFT_BATCH_SIZE

Number of token transfers to sanitize in the batch. Renamed in .

Version: v7.0.0+ Default: 100 Applications: API, Indexer

MIGRATION_SANITIZE_INCORRECT_NFT_CONCURRENCY

Number of parallel sanitizing token transfer batches processing. Renamed in .

Version: v7.0.0+ Default: 1 Applications: API, Indexer

MIGRATION_SANITIZE_INCORRECT_NFT_TIMEOUT

Timeout between sanitizing token transfer batches processing. Implemented in . Renamed in .

Version: v7.0.0+ Default: 0 Applications: API, Indexer

MIGRATION_SANITIZE_INCORRECT_WETH_BATCH_SIZE

Number of token transfers to sanitize in the batch. Implemented in . Renamed in .

Version: v7.0.0+ Default: 100 Applications: API, Indexer

MIGRATION_SANITIZE_INCORRECT_WETH_CONCURRENCY

Number of parallel sanitizing token transfer batches processing. Implemented in . Renamed in .

Version: v7.0.0+ Default: 1 Applications: API, Indexer

MIGRATION_SANITIZE_INCORRECT_WETH_TIMEOUT

Timeout between sanitizing token transfer batches processing. Implemented in . Renamed in .

Version: v7.0.0+ Default: 0 Applications: API, Indexer

MIGRATION_REINDEX_INTERNAL_TRANSACTIONS_STATUS_BATCH_SIZE

Number of internal transactions to reindex in the batch. Implemented in . Renamed in .

Version: v7.0.0+ Default: 100 Applications: API, Indexer

MIGRATION_REINDEX_INTERNAL_TRANSACTIONS_STATUS_CONCURRENCY

Number of parallel reindexing internal transaction batches processing. Implemented in . Renamed in .

Version: v7.0.0+ Default: 1 Applications: API, Indexer

MIGRATION_REINDEX_INTERNAL_TRANSACTIONS_STATUS_TIMEOUT

Timeout between reindexing internal transaction batches processing. Implemented in . Renamed in .

Version: v7.0.0+ Default: 0 Applications: API, Indexer

MIGRATION_RESTORE_OMITTED_WETH_TOKEN_TRANSFERS_BATCH_SIZE

Number of logs to process in the batch. Implemented in

Version: v6.8.0+ Default: 50 Applications: API, Indexer

MIGRATION_RESTORE_OMITTED_WETH_TOKEN_TRANSFERS_CONCURRENCY

Number of parallel logs batches processing. Implemented in

Version: v6.8.0+ Default: 5 Applications: API, Indexer

MIGRATION_RESTORE_OMITTED_WETH_TOKEN_TRANSFERS_TIMEOUT

Time interval between checks if queue is not empty. The same timeout multiplied by 2 used between checks if queue is not full. Implemented in

Version: v6.8.0+ Default: 250ms Applications: API, Indexer

MIGRATION_SANITIZE_DUPLICATED_LOG_INDEX_LOGS_BATCH_SIZE

Number of logs to process in the batch. Implemented in

Version: v6.9.0+ Default: 500 Applications: API, Indexer

MIGRATION_SANITIZE_DUPLICATED_LOG_INDEX_LOGS_CONCURRENCY

Number of parallel logs batches processing. Implemented in

Version: v6.9.0+ Default: 10 Applications: API, Indexer

MIGRATION_REFETCH_CONTRACT_CODES_BATCH_SIZE

Number of addresses to process in the batch. Implemented in

Version: v6.9.0+ Default: 100 Applications: API, Indexer

MIGRATION_REFETCH_CONTRACT_CODES_CONCURRENCY

Number of parallel addresses batches processing. Implemented in

Version: v6.9.0+ Default: 5 Applications: API, Indexer

MIGRATION_SANITIZE_VERIFIED_ADDRESSES_DISABLED

Controls whether the migration that sanitizes verified addresses is disabled. If set to true, the migration will not run; if set to false, the migration will proceed. Implemented in .

Version: v7.0.0+ Default: false Applications: API, Indexer

MIGRATION_SANITIZE_VERIFIED_ADDRESSES_BATCH_SIZE

Specifies the number of addresses to process in each batch during the sanitize verified addresses migration. Implemented in .

Version: v7.0.0+ Default: 500 Applications: API, Indexer

MIGRATION_SANITIZE_VERIFIED_ADDRESSES_CONCURRENCY

Determines how many concurrent processes will be used during the sanitize verified addresses migration. Implemented in .

Version: v7.0.0+ Default: 1 Applications: API, Indexer

MIGRATION_SANITIZE_VERIFIED_ADDRESSES_TIMEOUT

Defines the timeout before processing each batch in the sanitize verified addresses migration. Follows the . Implemented in .

Version: v7.0.0+ Default: 0s Applications: API, Indexer

MIGRATION_HEAVY_INDEX_OPERATIONS_CHECK_INTERVAL

Interval between status checks of heavy db operation like index creation or dropping. . Implemented in

Version: v7.0.0+ Default: 10m Applications: API, Indexer

MIGRATION_TOKEN_INSTANCE_ERC_1155_SANITIZE_CONCURRENCY

Concurrency for erc-1155-sanitize token instance fetcher. Implemented in . Default value and name changed in

Version: v7.0.0+ Default: 1 Applications: Indexer

MIGRATION_TOKEN_INSTANCE_ERC_721_SANITIZE_CONCURRENCY

Concurrency for erc-721-sanitize token instance fetcher. Implemented in . Name changed in

Version: v7.0.0+ Default: 2 Applications: Indexer

MIGRATION_TOKEN_INSTANCE_ERC_1155_SANITIZE_BATCH_SIZE

Batch size for erc-1155-sanitize token instance fetcher. Implemented in . Default value and name changed in

Version: v7.0.0+ Default: 500 Applications: Indexer

MIGRATION_TOKEN_INSTANCE_ERC_721_SANITIZE_BATCH_SIZE

Batch size for erc-721-sanitize token instance fetcher. Implemented in . Default value and name changed in

Version: v7.0.0+ Default: 50 Applications: Indexer

MIGRATION_TOKEN_INSTANCE_ERC_721_SANITIZE_TOKENS_BATCH_SIZE

Tokens batch size for erc-721-sanitize token instance fetcher. Implemented in . Name changed in

Version: v7.0.0+ Default: 100 Applications: Indexer

MIGRATION_SMART_CONTRACT_LANGUAGE_DISABLED

If set to true, the migration to the language field in the smart_contracts table will not start. If set to false, the migration proceeds as normal. Implemented in .

Version: v8.0.0+ Default: false Applications: Indexer

MIGRATION_SMART_CONTRACT_LANGUAGE_BATCH_SIZE

Defines the number of records to be processed in each batch when migrating the language field in the smart_contracts table. Implemented in .

Version: v8.0.0+ Default: 100 Applications: Indexer

MIGRATION_SMART_CONTRACT_LANGUAGE_CONCURRENCY

Specifies how many concurrent processes can handle the language field migration. Implemented in .

Version: v8.0.0+ Default: 1 Applications: Indexer

MIGRATION_BACKFILL_METADATA_URL_DISABLED

If set to true, the backfiller of metadata_url field in the token_instances table will not start. If set to false, the migration proceeds as normal. Implemented in .

Version: v8.0.0+ Default: false Applications: Indexer

MIGRATION_BACKFILL_METADATA_URL_BATCH_SIZE

Defines the number of records to be processed in each batch when backfilling the metadata_url field in the token_instances table. Implemented in .

Version: v8.0.0+ Default: 100 Applications: Indexer

MIGRATION_BACKFILL_METADATA_URL_CONCURRENCY

Specifies how many concurrent processes can handle the metadata_url field backfilling. Implemented in .

Version: v8.0.0+ Default: 5 Applications: Indexer

MIGRATION_RECOVERY_WETH_TOKEN_TRANSFERS_CONCURRENCY

Specifies how many concurrent processes can handle the recovery WETH token transfers migration. Implemented in .

Version: v8.0.0+ Default: 5 Applications: Indexer

MIGRATION_RECOVERY_WETH_TOKEN_TRANSFERS_BATCH_SIZE

Defines the number of records to be processed in each batch when recovery WETH token transfers. Implemented in .

Version: v8.0.0+ Default: 50 Applications: Indexer

MIGRATION_RECOVERY_WETH_TOKEN_TRANSFERS_TIMEOUT

Defines the timeout between processing each batch (batch_size * concurrency) in the recovery WETH token transfers migration. Follows the . Implemented in .

Version: v8.0.0+ Default: 0s Applications: Indexer

MIGRATION_RECOVERY_WETH_TOKEN_TRANSFERS_BLOCKS_BATCH_SIZE

Specifies the block range size selected for the recovery of WETH token transfer migration. Implemented in .

Version: v8.0.0+ Default: 100000 Applications: Indexer

MIGRATION_RECOVERY_WETH_TOKEN_TRANSFERS_HIGH_VERBOSITY

If set to true, enables high verbosity logging (logs each transaction hash, where missed transfers were restored) during the recovery of WETH token transfer migration. Implemented in .

Version: v8.0.0+ Default: true Applications: Indexer

Market

Variable

Description

Parameters

DISABLE_MARKET

Disables all fetchers and any market data displaying. Setting this to true will disable all market-related functionality. Implemented in .

Version: v8.0.0+ Default: false Applications: API, Indexer

MARKET_NATIVE_COIN_SOURCE

Source for realtime native coin price fetching. Possible values are: coin_gecko, coin_market_cap, crypto_rank, or mobula. Useful when multiple coin IDs are configured and you want to explicitly select the source. Implemented in .

Version: v8.0.0+ Default: coin_gecko Applications: API

MARKET_SECONDARY_COIN_SOURCE

Source for realtime secondary coin fetching. Possible values are: coin_gecko, coin_market_cap, crypto_rank, or mobula. Useful when multiple secondary coin IDs are configured. Implemented in .

Version: v8.0.0+ Default: coin_gecko Applications: API

MARKET_TOKENS_SOURCE

Sets the source for tokens price fetching. Available values are coin_gecko, crypto_rank, mobula. Implemented in .

Version: v8.0.0+ Default: coin_gecko Applications: Indexer

MARKET_NATIVE_COIN_HISTORY_SOURCE

Sets the source for price history fetching. Available values are crypto_compare, coin_gecko, mobula, coin_market_cap and crypto_rank. Implemented in .

Version: v8.0.0+ Default: crypto_compare Applications: Indexer

MARKET_SECONDARY_COIN_HISTORY_SOURCE

Sets the source for secondary coin price history fetching. Available values are crypto_compare, coin_gecko, mobula, coin_market_cap and crypto_rank. Implemented in .

Version: v8.0.0+ Default: crypto_compare Applications: Indexer

MARKET_MARKET_CAP_HISTORY_SOURCE

Sets the source for market cap history fetching. Available values are coin_gecko and coin_market_cap. Implemented in .

Version: v8.0.0+ Default: coin_gecko Applications: Indexer

MARKET_TVL_HISTORY_SOURCE

Sets the source for TVL history fetching. Available value is defillama. Implemented in .

Version: v8.0.0+ Default: defillama Applications: Indexer

MARKET_COINGECKO_PLATFORM_ID

platform id for which token prices are fetched, see full list in endpoint. Examples: "ethereum", "optimistic-ethereum". Implemented in .

Version: v8.0.0+ Default: ethereum Applications: Indexer

MARKET_COINGECKO_BASE_URL

If set, overrides the Coingecko base URL. Implemented in .

Version: v8.0.0+ Default: https://api.coingecko.com/api/v3 Applications: API, Indexer

MARKET_COINGECKO_BASE_PRO_URL

If set, overrides the Coingecko Pro base URL. Implemented in .

Version: v8.0.0+ Default: https://pro-api.coingecko.com/api/v3 Applications: API, Indexer

MARKET_COINGECKO_API_KEY

CoinGecko API key. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_COINGECKO_COIN_ID

Sets CoinGecko coin ID. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_COINGECKO_SECONDARY_COIN_ID

Sets CoinGecko coin ID for secondary coin market chart. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_COINMARKETCAP_BASE_URL

If set, overrides the CoinMarketCap base URL (Free and Pro). Implemented in .

Version: v8.0.0+ Default: https://pro-api.coinmarketcap.com/v2 Applications: API, Indexer

MARKET_COINMARKETCAP_API_KEY

CoinMarketCap API key. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_COINMARKETCAP_COIN_ID

CoinMarketCap coin id. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_COINMARKETCAP_SECONDARY_COIN_ID

CoinMarketCap coin id for secondary coin. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_CRYPTOCOMPARE_BASE_URL

If set, overrides the CryptoCompare base URL. Implemented in .

Version: v8.0.0+ Default: https://min-api.cryptocompare.com Applications: API, Indexer

MARKET_CRYPTOCOMPARE_COIN_SYMBOL

CryptoCompare coin symbol for native coin (e.g., "OP" for Optimism). CryptoCompare uses symbols instead of IDs. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: Indexer

MARKET_CRYPTOCOMPARE_SECONDARY_COIN_SYMBOL

CryptoCompare coin symbol for secondary coin market chart. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: Indexer

MARKET_CRYPTORANK_PLATFORM_ID

Sets Cryptorank platform ID. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: Indexer

MARKET_CRYPTORANK_BASE_URL

If set, overrides the Cryptorank API url. Implemented in .

Version: v8.0.0+ Default: https://api.cryptorank.io/v1/ Applications: API, Indexer

MARKET_CRYPTORANK_API_KEY

Cryptorank API key. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_CRYPTORANK_COIN_ID

Sets Cryptorank coin ID. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_CRYPTORANK_SECONDARY_COIN_ID

Sets Cryptorank coin ID for secondary coin. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_DEFILLAMA_COIN_ID

DefiLlama coin id. Use the name field from the /v2/chains endpoint response (e.g., "OP Mainnet" for Optimism). Implemented in .

Version: v8.0.0+ Default: (empty) Applications: Indexer

MARKET_MOBULA_PLATFORM_ID

Mobula platform ID. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: Indexer

MARKET_MOBULA_BASE_URL

If set, overrides the Mobula API base URL. Implemented in .

Version: v8.0.0+ Default: https://api.mobula.io/api/1 Applications: API, Indexer

MARKET_MOBULA_API_KEY

Mobula API key. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_MOBULA_COIN_ID

Set Mobula coin ID. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_MOBULA_SECONDARY_COIN_ID

Set Mobula coin ID for secondary coin. Implemented in .

Version: v8.0.0+ Default: (empty) Applications: API, Indexer

MARKET_COIN_FETCHER_ENABLED

If false disables fetching of realtime native coin price. Implemented in .

Version: v8.0.0+ Default: true Applications: API

MARKET_COIN_CACHE_PERIOD

Cache period for coin exchange rates. Implemented in .

Version: v8.0.0+ Default: 10m Applications: API

MARKET_TOKENS_FETCHER_ENABLED

If false disables fetching of token prices. Implemented in .

Version: v8.0.0+ Default: true Applications: Indexer

MARKET_TOKENS_INTERVAL

Interval between batch requests of token prices. Can be decreased in order to fetch prices faster if you have pro rate limit. . Implemented in .

Version: v8.0.0+ Default: 10s Applications: Indexer

MARKET_TOKENS_REFETCH_INTERVAL

Interval between refetching token prices, responsible for the relevance of prices. . Implemented in .

Version: v8.0.0+ Default: 1h Applications: Indexer

MARKET_TOKENS_MAX_BATCH_SIZE

Batch size of a single token price request. Implemented in .

Version: v8.0.0+ Default: 500 Applications: Indexer

MARKET_HISTORY_FETCHER_ENABLED

If false disables fetching of marked data history. Implemented in .

Version: v8.0.0+ Default: true Applications: Indexer

MARKET_HISTORY_FETCH_INTERVAL

Interval to update data for the last day in the market history table. Introduced in .

Version: v6.1.0+ Default: 1h Applications: API, Indexer

MARKET_HISTORY_FIRST_FETCH_DAY_COUNT

Initial number of days to fetch for market history. Implemented in .

Version: v8.0.0+ Default: 365 Applications: Indexer

Cache Management

See the section for more information on variable formatting.

Variable

Description

Parameters

CACHE_TXS_COUNT_PERIOD

Time interval to restart the task that calculates the total txs count. Starting from release v6.8.0+, if the value is not set, ttl value gradually increases until the default value with growth of the block numbers.

Version: v4.1.3+ Default: 2h Applications: API, Indexer

CACHE_ADDRESS_COUNT_PERIOD

Interval for restarting the task that calculates the total number of addresses.

Version: v8.0.0+ Default: 30m Applications: API, Indexer

CACHE_ADDRESS_SUM_PERIOD

Time to live of addresses sum (except burn address) cache. . Starting from release v6.8.0+, if the value is not set, ttl value gradually increases until the default value with growth of the block numbers. Introduced in .

Version: v4.1.3+ Default: 1h Applications: API, Indexer

CACHE_TOTAL_GAS_USAGE_PERIOD

Interval to restart the task which calculates the total gas usage. Starting from release v6.8.0+, if the value is not set, ttl value gradually increases until the default value with growth of the block numbers.

Version: v4.1.3+ Default: 2h Applications: API, Indexer

CACHE_PBO_COUNT_PERIOD

Time interval to restart the task which calculates the total pending_block_operations count.

Version: v5.2.0+ Default: 20m Applications: API, Indexer

CACHE_ADDRESS_TRANSACTIONS_GAS_USAGE_COUNTER_PERIOD

Interval to restart the task which calculates gas usage at the address.

Version: v4.1.3+ Default: 30m Applications: API, Indexer

CACHE_TOKEN_HOLDERS_COUNTER_PERIOD

Interval to restart the task which calculates holders count of the token.

Version: v4.1.3+ Default: 1h Applications: API, Indexer

CACHE_TOKEN_TRANSFERS_COUNTER_PERIOD

Interval to restart the task which calculates transfers count of the token.

Version: v4.1.3+ Default: 1h Applications: API, Indexer

TOKEN_METADATA_UPDATE_INTERVAL

Interval to restart the task which updates token metadata.

Version: v2.0.1+ Default: 48h Applications: API, Indexer

CACHE_AVERAGE_BLOCK_PERIOD

Time to initiate first calculation and caching of average block period after start/re-start of the application.

Version: v4.1.3+ Default: 30m Applications: API, Indexer

CACHE_MARKET_HISTORY_PERIOD

Update of market history cache.

Version: v4.1.3+ Default: 6h Applications: API, Indexer

CACHE_ADDRESS_TRANSACTIONS_COUNTER_PERIOD

Time to live of address' transaction counter. . Introduced in .

Version: v3.4.0+ Default: 1h Applications: API, Indexer

CACHE_ADDRESS_TOKENS_USD_SUM_PERIOD

Managing of cache invalidation period for the sum of USD value of tokens per tokens' holder address.

Version: v3.5.0+ Default: 1h Applications: API, Indexer

COIN_BALANCE_ON_DEMAND_FETCHER_THRESHOLD

A threshold to invalidate coin balance cache.

Version: v5.1.2+ Default: 1h Applications: API, Indexer

CONTRACT_CODE_ON_DEMAND_FETCHER_THRESHOLD

An initial threshold (for exponential backoff) to fetch smart-contract bytecode on-demand. Implemented in .

Version: v6.4.0+ Default: 5s Applications: API, Indexer

CACHE_ADDRESS_TOKEN_TRANSFERS_COUNTER_PERIOD

Interval to restart the task, which calculates the number of token transfers at the address. Implemented in .

Version: v4.0.0+ Default: 1h Applications: API, Indexer

CACHE_BLOCK_COUNT_PERIOD

Time to live of blocks with consensus count cache. Starting from release v6.8.0+, if the value is not set, ttl value gradually increases until the default value with growth of the block numbers. Introduced in .

Version: v4.1.3+ Default: 2h Applications: API, Indexer

CACHE_TOTAL_GAS_USAGE_COUNTER_ENABLED

if true, enables cache for total gas usage counter.

Version: v5.1.3+ Default: false Applications: API, Indexer

CACHE_TRANSACTIONS_24H_STATS_PERIOD

Interval to update data for the last 24 hours transactions stats. Introduced in .

Version: v6.3.0+ Default: 1h Applications: API, Indexer

CACHE_FRESH_PENDING_TRANSACTIONS_COUNTER_PERIOD

Interval to update count of pending transactions that appeared less than half an hour ago. Introduced in .

Version: v6.3.0+ Default: 5m Applications: API, Indexer

CACHE_OPTIMISM_LAST_OUTPUT_ROOT_SIZE_COUNTER_PERIOD

Interval to update data for the last output root size counter. Introduced in .

Version: v6.3.0+ Default: 5m Applications: API, Indexer

Gas Price Oracle

Variable

Description

Parameters

GAS_PRICE_ORACLE_NUM_OF_BLOCKS

Gas price oracle: number of blocks to calculate average gas price from

Version: v4.1.4+ Default: 200 Applications: API, Indexer

GAS_PRICE_ORACLE_SAFELOW_PERCENTILE

Gas price oracle: safelow percentile

Version: v4.1.4+ Default: 35 Applications: API, Indexer

GAS_PRICE_ORACLE_AVERAGE_PERCENTILE

Gas price oracle: average percentile

Version: v4.1.4+ Default: 60 Applications: API, Indexer

GAS_PRICE_ORACLE_FAST_PERCENTILE

Gas price oracle: fast percentile

Version: v4.1.4+ Default: 90 Applications: API, Indexer

GAS_PRICE_ORACLE_CACHE_PERIOD

Gas price oracle: period of gas prices update.

Version: v4.1.4+ Default: 30s Applications: API, Indexer

GAS_PRICE_ORACLE_SIMPLE_TRANSACTION_GAS

Gas price oracle: amount of gas for a simple coin transfer. Introduced in .

Version: v6.0.0+ Default: 21000 Applications: API, Indexer

GAS_PRICE_ORACLE_SAFELOW_TIME_COEFFICIENT

Average block time multiplied by this coefficient for safelow gas price when time from pending transactions is not available. Floats may be used. Introduced in .

Version: v6.3.0+ Default: 5 Applications: API, Indexer

GAS_PRICE_ORACLE_AVERAGE_TIME_COEFFICIENT

Average block time multiplied by this coefficient for average gas price when time from pending transactions is not available. Floats may be used. Introduced in .

Version: v6.3.0+ Default: 3 Applications: API, Indexer

GAS_PRICE_ORACLE_FAST_TIME_COEFFICIENT

Average block time multiplied by this coefficient for fast gas price when time from pending transactions is not available. Floats may be used. Introduced in .

Version: v6.3.0+ Default: 1 Applications: API, Indexer

Main Page Dashboard

Variable

Description

Parameters

GAS_PRICE

Gas price in Gwei. If the variable is present, gas price displays on the main page.

Version: v3.3.2+ Default: (empty) Applications: API

TXS_STATS_ENABLED

Disables or enables txs per day stats gathering.

Version: v5.1.3+ Default: true Applications: API

SHOW_PRICE_CHART

Disables or enables price and market cap of coin charts on the main page.

Version: v3.1.2+ Default: false Applications: API

SHOW_PRICE_CHART_LEGEND

Showa price and market cap values under the chart even if price chart is not enabled via SHOW_PRICE_CHART env variable.

Version: v5.1.4+ Default: false Applications: API

SHOW_TXS_CHART

Disables or enables txs count per day chart on the main page.

Version: v3.1.2+ Default: true Applications: API

TXS_HISTORIAN_INIT_LAG

The initial delay in txs count history fetching in order to display txs count per day history chart on the main page. .

Version: v3.1.2+ Default: 0 Applications: API

TXS_STATS_DAYS_TO_COMPILE_AT_INIT

Number of days for fetching of history of txs count per day in order to display it in txs count per day history chart on the main page.

Version: v3.1.2+ Default: 40 Applications: API

Header and Footer

Header

Variable

Description

Parameters

LOGO

Environment variable for the header logo image location. The logo files names for different chains can be found .

Version: all Default: /images/blockscout_logo.svg Applications: API

SHOW_TESTNET_LABEL

Enables testnet label right after logo in the navigation panel. Implemented in

Version: v4.1.6+ Default: (empty) Applications: API

TESTNET_LABEL_TEXT

The text inside the test label. Implemented in

Version: v4.1.6+ Default: Testnet Applications: API

SUPPORTED_CHAINS

An array of supported chains displayed in the chains dropdown. This var was introduced in this PR and looks like an array of JSON objects.

Version: v2.0.0+ Default: [ { title: POA", url: "https://blockscout.com/poa/core" }, { title: "Sokol", url: "https://blockscout.com/poa/sokol", test_net?: true }, { title: "Gnosis Chain", url: "https://gnosis.blockscout.com/" }, { title: "Ethereum Classic", url: "https://etc.blockscout.com", other?: true }, { title: "RSK", url: "https://rootstock.blockscout.com", other?: true } ] Applications: API

APPS_MENU

true/false. If true, the Apps navigation menu item appears.

Version: v3.3.1+ Default: false Applications: API

APPS

An array of embedded/external apps to display in Apps menu item. This var was introduced in this PR and looks like an array of JSON objects. An example of an embedded link is described here

Version: v5.0.0+ Default: (empty) Applications: API

Footer

Variable

Description

Parameters

FOOTER_LOGO

Environment variable for the footer logo image location. The logo files names for different chains can be found .

Version: all Default: /images/blockscout_logo.svg Applications: API

RELEASE_LINK

The link to Blockscout release notes in the footer.

Version: v1.3.5+ Default: https: //github.com/poanetwork/ blockscout/releases/ tag/${BLOCKSCOUT_VERSION} Applications: API

BLOCKSCOUT_VERSION

Added to the footer to signify the current BlockScout version.

Version: v1.3.4+ Default: (empty) Applications: API

FOOTER_CHAT_LINK

Link to Chat menu item in the footer. Implemented in .

Version: v4.1.6+ Default: https://discord.gg/3CtNAqVMRV Applications: API

FOOTER_FORUM_LINK_ENABLED

Enable forum menu item in the footer.

Version: v5.1.3+ Default: false Applications: API

FOOTER_FORUM_LINK

Link in Forum menu item in the footer. Implemented in

Version: v4.1.6+ Default: https://forum.poa.network/c/blockscout Applications: API

FOOTER_TELEGRAM_LINK_ENABLED

Enable Telegram menu item in the footer. Implemented in .

Version: v5.1.4+ Default: false Applications: API

FOOTER_TELEGRAM_LINK

Link in Telegram menu item in the footer. Implemented in .

Version: v5.1.4+ Default: (empty) Applications: API

FOOTER_GITHUB_LINK

Github repository. Implemented in .

Version: v4.1.6+ Default: https://github.com/blockscout/blockscout Applications: API

FOOTER_LINK_TO_OTHER_EXPLORERS

true/false. If true, links to other explorers are added in the footer.

Version: v5.1.3+ Default: (empty) Applications: API

FOOTER_OTHER_EXPLORERS

The list of alternative explorers.

Version: v5.1.3+ Default: (empty) Applications: API

Contract Management

Variable

Description

Parameters

CONTRACT_VERIFICATION_ALLOWED_SOLIDITY_EVM_VERSIONS

Comma-separated list of allowed EVM versions for Solidity contract verification. This var was introduced in , updated in .

Version: v5.2.0+ Default: homestead,tangerineWhistle,spuriousDragon,byzantium,constantinople,petersburg,istanbul,berlin,london,paris,shanghai,default Applications: API

CONTRACT_VERIFICATION_ALLOWED_VYPER_EVM_VERSIONS

Comma-separated list of allowed EVM versions for Vyper contract verification. This var was introduced in .

Version: v5.2.0+ Default: byzantium,constantinople,petersburg,istanbul,berlin,paris,shanghai,default Applications: API

CONTRACT_VERIFICATION_MAX_LIBRARIES

Max amount of libraries to consider in smart-contract verification from flat/multi-part file(s). Implemented in .

Version: v5.0.0+ Default: (empty) Applications: API

CONTRACT_MAX_STRING_LENGTH_WITHOUT_TRIMMING

Hide long contract method data. For more details:

Version: v4.0.0+ Default: 2040 Applications: API

CONTRACT_DISABLE_INTERACTION

If true, contract interactions via "Write contract" or "Write proxy contract" tabs are disabled. Introduced in ."

Version: v5.1.2+ Default: (empty) Applications: API

CONTRACT_PROXY_IMPLEMENTATION_TTL_VIA_AVG_BLOCK_TIME

If false, proxy contract implementation will be re-fetched immediately once someone opens proxy page bypassing average block time calculation. Implemented in .

Version: v6.1.0+ Default: true Applications: API

CONTRACT_AUDIT_REPORTS_AIRTABLE_URL

URL of Airtable to store audit reports from users. Implemented in

Version: v6.1.0+ Default: (empty) Applications: API

CONTRACT_AUDIT_REPORTS_AIRTABLE_API_KEY

Access token for CONTRACT_AUDIT_REPORTS_AIRTABLE_URL. Implemented in

Version: v6.1.0+ Default: (empty) Applications: API

CONTRACT_CERTIFIED_LIST

Comma-separated list of smart-contract address hashes, to which "certified" flag should be applied. Implemented in "

Version: v6.5.0+ Default: (empty) Applications: API

WHITELISTED_WETH_CONTRACTS

Comma-separated list of smart-contract address hashes of WETH-like tokens which deposit and withdrawal events you'd like to index. Implemented in

Version: v6.8.0+ Default: (empty) Applications: API, Indexer

WETH_TOKEN_TRANSFERS_FILTERING_ENABLED

Toggle for WETH token transfers filtering which was introduced in . Implemented in

Version: v6.1.0+ Default: false Applications: API, Indexer

CONTRACT_ENABLE_PARTIAL_REVERIFICATION

Toggle for enabling re-verification from partial to partial match. Implemented in

Version: v7.0.0+ Default: false Applications: API

Bridged Tokens

Variable

Description

Parameters

BRIDGED_TOKENS_ENABLED

Variable to enable bridged tokens functionality. Introduced in

Needs Recompile: ☑️ Version: v6.1.0+ Default: (empty) Applications: API, Indexer

BRIDGED_TOKENS_ETH_OMNI_BRIDGE_MEDIATOR

OMNI bridge mediator for ETH tokens. Introduced in

Version: v6.1.0+ Default: (empty) Applications: API, Indexer

BRIDGED_TOKENS_BSC_OMNI_BRIDGE_MEDIATOR

OMNI bridge mediator for BSC tokens. Introduced in

Version: v6.1.0+ Default: (empty) Applications: API, Indexer

BRIDGED_TOKENS_POA_OMNI_BRIDGE_MEDIATOR

OMNI bridge mediator for POA tokens. Introduced in

Version: v6.1.0+ Default: (empty) Applications: API, Indexer

BRIDGED_TOKENS_AMB_BRIDGE_MEDIATORS

AMB bridge mediator. Introduced in

Version: v6.1.0+ Default: (empty) Applications: API, Indexer

BRIDGED_TOKENS_FOREIGN_JSON_RPC

Ethereum mainnet JSON RPC. Introduced in

Version: v6.1.0+ Default: (empty) Applications: API, Indexer

Miscellaneous UI

Variable

Description

Parameters

SHOW_ADDRESS_MARKETCAP_PERCENTAGE

Configures market cap percentage column on the top accounts page.

Version: v2.1.1+ Default: true Applications: API

SHOW_MAINTENANCE_ALERT

Disables/enables announcement at the top of the explorer.

Version: v3.6.0+ Default: false Applications: API

MAINTENANCE_ALERT_MESSAGE

Message text of the announcement at the top of the explorer.

Version: v3.6.0+ Default: (empty) Applications: API

HIDE_BLOCK_MINER

Hides miner/validator/sequencer on block page and tiles if the value is true. Implemented in

Version: v4.0.0+ Default: (empty) Applications: API

HIDE_SCAM_ADDRESSES

Hides address of EOA/smart-contract/token from search results if the value is true and "scam" badge is assigned to that address. Implemented in

Version: v6.9.0+ Default: (empty) Applications: API

DISPLAY_TOKEN_ICONS

Displays token icons from Trust Wallet assets repository if true. Implemented in

Version: v4.0.0+ Default: (empty) Applications: API

UNCLES_IN_AVERAGE_BLOCK_TIME

Include or exclude non-consensus blocks in avg block time calculation. Exclude if false.

Version: v2.0.1+ Default: false Applications: API

COIN_BALANCE_HISTORY_DAYS

Number of days to consider for coin balance history chart.

Version: v3.1.3+ Default: 10 Applications: API

ADMIN_PANEL_ENABLED

if true admin/* routes are available. Implemented in

Needs Recompile: ☑️ Version: v4.1.2+ Default: (empty) Applications: API

DISABLE_ADD_TO_MM_BUTTON

If true, "Add chain to MM" button doesn't appear. Implemented in "

Version: v5.1.0+ Default: (empty) Applications: API

PERMANENT_DARK_MODE_ENABLED

Version: v5.1.0+ Default: (empty) Applications: API

PERMANENT_LIGHT_MODE_ENABLED

Version: v5.1.0+ Default: (empty) Applications: API

CSV Export

reCAPTCHA v2 and v3 keys for CSV export page. Do not use both v2/v3 keys. Only one version of reCAPTCHA should be used.

Variable

Description

Parameters

RE_CAPTCHA_SECRET_KEY

Version: v4.0.0+ Default: (empty) Applications: API

RE_CAPTCHA_CLIENT_KEY

Version: v4.0.0+ Default: (empty) Applications: API

RE_CAPTCHA_V3_SECRET_KEY

Version: v5.1.4+ Default: (empty) Applications: API

RE_CAPTCHA_V3_CLIENT_KEY

Version: v5.1.4+ Default: (empty) Applications: API

RE_CAPTCHA_DISABLED

Version: v5.1.5+ Default: false Applications: API

RE_CAPTCHA_CHECK_HOSTNAME

Version: v6.9.0+ Default: false Applications: API

CSV_EXPORT_LIMIT

Version: v6.8.0+ Default: 10000 Applications: API

RE_CAPTCHA_SCORE_THRESHOLD

Version: v6.9.1+ Default: 0.5 Applications: API

RE_CAPTCHA_BYPASS_TOKEN

Version: v6.10.2+ Default: (empty) Applications: API

RE_CAPTCHA_TOKEN_INSTANCE_REFETCH_METADATA_SCOPED_BYPASS_TOKEN

Version: v8.0.0+ Default: (empty) Applications: API

API Rate Limits

Variable

Description

Parameters

API_RATE_LIMIT

Version: v4.1.1+ Default: 10 req/sec Applications: API

API_RATE_LIMIT_BY_KEY

Version: v4.1.1+ Default: 10 req/sec Applications: API

API_RATE_LIMIT_WHITELISTED_IPS

Version: v4.1.1+ Default: (empty) Applications: API

API_RATE_LIMIT_STATIC_API_KEY

Version: v4.1.1+ Default: (empty) Applications: API

API_NO_RATE_LIMIT_API_KEY

Version: v6.8.0+ Default: (empty) Applications: API

API_RATE_LIMIT_DISABLED

Version: v5.1.0+ Default: (empty) Applications: API

API_RATE_LIMIT_IS_BLOCKSCOUT_BEHIND_PROXY

Version: v5.1.3+ Default: false Applications: API

API_RATE_LIMIT_BY_WHITELISTED_IP

Version: v5.1.3+ Default: 50 req/sec Applications: API

API_RATE_LIMIT_BY_IP

Version: v5.1.3+ Default: 3000 Applications: API

API_RATE_LIMIT_HAMMER_REDIS_URL

Needs Recompile: ☑️ Version: v5.1.3+ Default: (empty) Applications: API

API_RATE_LIMIT_UI_V2_WITH_TOKEN

Version: v5.1.3+ Default: 5 Applications: API

API_RATE_LIMIT_TIME_INTERVAL

Version: v5.1.3+ Default: 1s Applications: API

API_RATE_LIMIT_BY_IP_TIME_INTERVAL

Version: v5.1.3+ Default: 5m Applications: API

API_RATE_LIMIT_UI_V2_TOKEN_TTL_IN_SECONDS

Version: v5.1.3+ Default: 1800 Applications: API

ETH_JSON_RPC_MAX_BATCH_SIZE

Version: v6.3.0+ Default: 5 Applications: API

General application rate Limits

Variable

Description

Parameters

RATE_LIMITER_REDIS_URL

Version: v8.0.0+ Default: (empty) Applications: API

RATE_LIMITER_ON_DEMAND_TIME_INTERVAL

Version: v8.0.0+ Default: 5s Applications: API

RATE_LIMITER_ON_DEMAND_LIMIT_BY_IP

Version: v8.0.0+ Default: 100 Applications: API

RATE_LIMITER_ON_DEMAND_EXPONENTIAL_TIMEOUT_COEFF

Version: v8.0.0+ Default: 100 Applications: API

RATE_LIMITER_ON_DEMAND_MAX_BAN_INTERVAL

Version: v8.0.0+ Default: 1h Applications: API

RATE_LIMITER_ON_DEMAND_LIMITATION_PERIOD

Version: v8.0.0+ Default: 1h Applications: API

GraphQL API

Variable

Description

Parameters

API_GRAPHQL_ENABLED

Version: v6.4.0+ Default: true Applications: API

API_GRAPHQL_MAX_COMPLEXITY

Needs Recompile: ☑️ Version: v6.4.0+ Default: 100 Applications: API

API_GRAPHQL_TOKEN_LIMIT

Needs Recompile: ☑️ Version: v6.4.0+ Default: 1000 Applications: API

API_GRAPHQL_DEFAULT_TRANSACTION_HASH

Needs Recompile: ☑️ Version: v6.4.0+ Default: 0x69e3923eef50eada197c3336d546936d0c994211492c9f947a24c02827568f9f Applications: API

API_GRAPHQL_RATE_LIMIT

Version: v6.4.0+ Default: 10 req/sec Applications: API

API_GRAPHQL_RATE_LIMIT_BY_KEY

Version: v6.4.0+ Default: 5 req/sec Applications: API

API_GRAPHQL_RATE_LIMIT_STATIC_API_KEY

Version: v6.4.0+ Default: (empty) Applications: API

API_GRAPHQL_RATE_LIMIT_DISABLED

Version: v6.4.0+ Default: (empty) Applications: API

API_GRAPHQL_RATE_LIMIT_BY_IP

Version: v6.4.0+ Default: 500 Applications: API

API_GRAPHQL_RATE_LIMIT_TIME_INTERVAL

Version: v6.4.0+ Default: 1s Applications: API

API_GRAPHQL_RATE_LIMIT_BY_IP_TIME_INTERVAL

Version: v6.4.0+ Default: 5m Applications: API

Variable

Description

Parameters

ACCOUNT_ENABLED

Turn on/off account functionality. If value istrue, account functionality is enabled.

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_DATABASE_URL

Account DB connection string

Version: v5.0.0+ Default: value from DATABASE_URL Applications: API

ACCOUNT_REDIS_URL

Account Redis connection string (for session storing configuration)

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_POOL_SIZE

Account DB pool_size

Version: v5.0.0+ Default: 50 Applications: API

ACCOUNT_AUTH0_DOMAIN

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_AUTH0_CLIENT_ID

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_AUTH0_CLIENT_SECRET

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_PUBLIC_TAGS_AIRTABLE_URL

Airtable URL for public tag requests functionality

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_PUBLIC_TAGS_AIRTABLE_API_KEY

Airtable API key for public tag requests functionality

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_SENDGRID_API_KEY

Sendgrid API key for watchlist notifications functionality

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_SENDGRID_SENDER

Sendgrid sender email for watchlist notifications functionality

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_SENDGRID_TEMPLATE

Sendgrid email template for watchlist notifications functionality

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_CLOAK_KEY

Version: v5.0.0+ Default: (empty) Applications: API

ACCOUNT_VERIFICATION_EMAIL_RESEND_INTERVAL

Version: v5.1.5+ Default: 5m Applications: API

ACCOUNT_PRIVATE_TAGS_LIMIT

Version: v5.3.1+ Default: 2000 Applications: API

ACCOUNT_WATCHLIST_ADDRESSES_LIMIT

Version: v5.3.1+ Default: 15 Applications: API

ACCOUNT_WATCHLIST_NOTIFICATIONS_LIMIT_FOR_30_DAYS

Version: v5.3.3+ Default: 1000 Applications: API

ACCOUNT_OTP_RESEND_INTERVAL

Version: v6.9.0+ Default: 1m Applications: API

ACCOUNT_SIWE_MESSAGE

Version: v6.9.1+ Default: Sign in to Blockscout Account V2 Applications: API

Specific Smart Contracts

Variable

Description

Parameters

METADATA_CONTRACT

Used by POA Network to obtain Validators information to display in the UI.

Version: all Default: (empty) Applications: API, Indexer

VALIDATORS_CONTRACT

Used by POA Network to obtain the list of current validators.

Version: all Default: (empty) Applications: API, Indexer

KEYS_MANAGER_CONTRACT

Used by POA Network to set KeysManager proxy contract in order to obtain payout key by mining key. This needs to identify distributed reward to the validator.

Version: v3.1.2+ Default: (empty) Applications: API, Indexer

REWARDS_CONTRACT

Emission rewards contract address. This env var is used only if EMISSION_FORMAT is set to POA

Version: v2.0.4+ Default: 0xeca443e8e1ab29971a45a9c57a6a9875701698a5 Applications: API, Indexer

TOKEN_BRIDGE_CONTRACT

Token bridge proxy contract. For `TokenBridge` supply module.

Version: v1.3.2+ Default: 0x7301CFA0e1756B71869E93d4e4Dca5c7d0eb0AA6 Applications: API, Indexer

CDN

Variable

Description

Parameters

NFT_MEDIA_HANDLER_AWS_ACCESS_KEY_ID

S3 API Access Key ID

Version: v6.10.0+ Default: (empty) Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_AWS_SECRET_ACCESS_KEY

S3 API Secret Access Key

Version: v6.10.0+ Default: (empty) Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_AWS_BUCKET_HOST

S3 API URL

Version: v6.10.0+ Default: (empty) Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_AWS_BUCKET_NAME

S3 bucket name

Version: v6.10.0+ Default: (empty) Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_AWS_PUBLIC_BUCKET_URL

Public S3 bucket URL

Version: v6.10.0+ Default: (empty) Applications: API

NFT_MEDIA_HANDLER_ENABLED

if true, CDN feature enabled

Version: v6.10.0+ Default: false Applications: Indexer, NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_REMOTE_DISPATCHER_NODE_MODE_ENABLED

if true, nft media handler is supposed to run separately.

Version: v6.10.0+ Default: false Applications: Indexer, NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_IS_WORKER

if true, and NFT_MEDIA_HANDLER_REMOTE_DISPATCHER_NODE_MODE_ENABLED=true will be started only nft_media_handler app

Version: v6.10.0+ Default: false Applications: Indexer, NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_NODES_MAP

String in json map format, where key is erlang node and value is folder in R2/S3 bucket, example: "{\"producer@172.18.0.4\": \"/folder_1\"}". If nft_media_handler runs in one pod with indexer, map should contain self key

Version: v6.10.0+ Default: (empty) Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_WORKER_CONCURRENCY

Concurrency of media handling (resizing/uploading)

Version: v6.10.0+ Default: 10 Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_WORKER_BATCH_SIZE

Number of url processed by one async task

Version: v6.10.0+ Default: 10 Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_WORKER_SPAWN_TASKS_TIMEOUT

Timeout before spawn new task

Version: v6.10.0+ Default: 100ms Applications: NFT_MEDIA_HANDLER

NFT_MEDIA_HANDLER_BACKFILL_ENABLED

If true, unprocessed token instances from DB are processed via nft_media_handler

Version: v6.10.0+ Default: false Applications: Indexer

NFT_MEDIA_HANDLER_BACKFILL_QUEUE_SIZE

Max size of backfill queue

Version: v6.10.0+ Default: 1000 Applications: Indexer

NFT_MEDIA_HANDLER_BACKFILL_ENQUEUE_BUSY_WAITING_TIMEOUT

Timeout before new attempt to append item to backfill queue if it's full

Version: v6.10.0+ Default: 1s Applications: Indexer

NFT_MEDIA_HANDLER_CACHE_UNIQUENESS_MAX_SIZE

Max size of cache, where stored already uploaded token instances media

Version: v6.10.0+ Default: 100_000 Applications: Indexer

Addresses Blacklist management

Variable

Description

Parameters

ADDRESSES_BLACKLIST

A comma-separated list of addresses to enable restricted access to them.

Version: v6.10.0+ Default: (empty) Applications: API

ADDRESSES_BLACKLIST_KEY

A key to access blacklisted addresses (either by ADDRESSES_BLACKLIST or by blacklist provider). Can be passed via query param to the page's URL: ?key=...

Version: v6.10.0+ Default: (empty) Applications: API

ADDRESSES_BLACKLIST_PROVIDER

Blacklist provider type, available options: blockaid

Version: v6.10.0+ Default: blockaid Applications: API

ADDRESSES_BLACKLIST_URL

URL to fetch blacklist from

Version: v6.10.0+ Default: (empty) Applications: API

ADDRESSES_BLACKLIST_UPDATE_INTERVAL

Interval between scheduled updates of blacklist

Version: v6.10.0+ Default: 15m Applications: API

ADDRESSES_BLACKLIST_RETRY_INTERVAL

Time to wait before new attempt of blacklist fetching, after abnormal termination of fetching task

Version: v6.10.0+ Default: 5s Applications: API

Categories

Time format

General Management

Indexer Management

DB Migrations & Sanitizer Management

Market

Cache Management

Gas Price Oracle

Main Page Dashboard

Header and Footer

Header

Footer

Contract Management

Bridged Tokens

Miscellaneous UI

CSV Export

API Rate Limits

General application rate Limits

GraphQL API

Account Related

Specific Smart Contracts

CDN

Addresses Blacklist management