Gauss Docs
  • 🌐Getting Started
    • Welcome to Gauss
    • Whitepaper
      • Blockchain Providers Need to Do Better
        • Solving a Lack of Token Adoption
          • An Evolving Space With Untapped Potential
        • Security & Reliability
          • Curation & Vetting
            • Important Note For Brands
        • Token Creation
      • WHY BUILD WITH GAUSS?
      • Use Cases
        • Use Cases (Chart)
      • Roadmap
      • Technical Background and Blockchain Development
        • Why Another Blockchain?
        • Gauss 1.0: Built With Efficiency and a Strong Infrastructure to Launch Rapidly
        • Gauss 2.0: Added Functionality For a Better User Experiance
          • Noble Swap 2.0
          • NFTs in Gauss 2.0
          • Token Development Kit (TDK)
          • Gaming DAO
          • Omnipool
      • Token Economics
        • Gang Token Economics: Designed to Ensure Trust and Transparency
        • Token Locking Schedule
        • Reflections: Rewarding the Gauss Community
        • Charitable Allocations: Grants, Scholarships, & Financial Assistance
      • The Gauss Team
      • Important Definitions
      • DISCLAIMER
        • PURCHASER WARNING
        • PROMINENT STATEMENTS
        • FUTURE STATEMENTS
        • VALUE RISKS
        • NOT A SECURITY
    • How To Connect
      • Create Metamask Wallet
    • Links
  • ⚡Launching with Gauss
    • Benefits of Building with Gauss
      • Fostering an Environment for Success
      • Gauss Growth Grant Program
      • Gauss Liquidity Program
      • Ecosystem Integrity Fund
      • Client Referral Program
    • A Guide to Curation
      • Core Principles and Curation Guidelines
      • Curation Stages and Processing Fees
    • Building on Gauss
  • 🖥️Gauss Ecosystem
    • Gauss Chain
      • Polygon-Edge Overview
      • Architecture
      • Consensus
      • Client Modules
        • Blockchain
        • Minimal
        • Networking
        • State
        • TxPool
        • JSON RPC
        • Consensus
        • Storage
        • Types
        • Syncer
        • Sealer
        • Other Modules
      • Polygon-Edge Performance Reports
      • For Developers
        • Operate a Node
          • Local Install
          • Genesis Contract
          • Server Config
          • CLI Commands
          • Key Management
        • Run a Validator
          • Validator FAQ
        • Smart Contract Deployment Permissioning
        • Deploying Contracts
          • Remix
          • Truffle
          • Hardhat
          • Replit
    • Gauss Explorer
      • Features
      • Navigating the Explorer
        • Menus
        • Blocks
        • Transactions
      • Verifying a Smart Contract
        • Hardhat Plugin
        • Sourcify Plugin
        • OpenZeppelin Plugin
      • Interacting With Smart Contracts
      • Exporting Transactions
      • FAQ
      • For Developers
        • Gauss Explorer Dependencies
        • Deployment Guide
          • Smart Contract Verification
          • Cleaning an instance from the previous deployment
          • ENV Variables
          • Testing
        • APIs
          • Requests & Limits
          • GraphQL
          • ETH RPC
    • Noble Swap
      • Liquidity Boost Program
    • Tokens
    • Gauss NFTs
      • Ferro Cards
      • F.E.R.R.E.T. NFTs
    • Contests & Giveaways
    • Gauss Faucet
      • For Developers
    • Address List
  • 💡Additional Resources
    • Partnerships & Affiliates
    • Discord Channel
    • Contact Us
    • Learning Materials
      • Web3 Glossary
    • Media Kit
Powered by GitBook
On this page
  1. Gauss Ecosystem
  2. Gauss Explorer
  3. For Developers
  4. Deployment Guide

ENV Variables

PreviousCleaning an instance from the previous deploymentNextTesting

Last updated 2 years ago

ENV Variables

Set ENV Variables with CLI

Use the export command to set variables. For example:$ export ETHEREUM_JSONRPC_VARIANT=nethermind$ export COIN=POA$ export NETWORK=POA

Example ENV Variables Set

The following variables are set for the . Note that some variables are not included as they contain private information which should not be exposed.

Available ENV Variables

This table is horizontally scrollable, version information is located in the last column. ENVs are listed by category:

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

  • ​​

General

Variable

Required

Description

Default

Version

Need recompile

DATABASE_URL

✅

Variable to define the Postgres Database endpoint.

(empty)

all

​

ETHEREUM_JSONRPC_VARIANT

✅

Tells the application which RPC Client the node is using (i.e. erigon, geth, nethermind, besu, or ganache)

ganache

all

​

ETHEREUM_JSONRPC_HTTP_URL

✅

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

localhost:8545

all

​

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.

localhost:8545

all

​

ETHEREUM_JSONRPC_WS_URL

​

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

ws://localhost:8546

all

​

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.

http

v3.1.0+

​

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 (#6573)[https://github.com/blockscout/blockscout/pull/6573]

(empty)

v5.0.0+

​

NETWORK

​

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

POA

all

​

SUBNETWORK

​

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

POA Sokol

all

​

IPC_PATH

​

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

(empty)

v2.1.1+

​

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.

/

all

​

API_PATH

​

PATH in API endpoint URL at API docs page.

/

v3.1.0+

​

SOCKET_ROOT

​

Custom websocket path.

(empty)

v3.0.0+

​

BLOCKSCOUT_HOST

​

Host for API endpoint examples.

localhost

v2.1.0+

​

BLOCKSCOUT_PROTOCOL

​

Url scheme for blockscout.

in prod env https is used, in dev env http is used

v2.1.0+

​

SECRET_KEY_BASE

​

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

(empty)

all

​

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.

false

all

​

PORT

​

Default port the application runs on is 4000.

4000

all

​

COIN

​

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

POA

all

​

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.

(empty)

v4.1.2+

​

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.

DEFAULT

v2.0.4+

​

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.

(empty)

v2.0.4+

​

SUPPLY_MODULE

​

This environment variable is used by the xDai Chain/RSK in order to tell the application how to calculate the total supply of the chain. Available values are TokenBridge, RSK

(empty)

all

​

POOL_SIZE

​

Variable to define the number of database connections allowed excluding read-only API endpoints requests.

50

all

​

POOL_SIZE_API

​

Variable to define the number of database connections allowed for read-only API endpoints requests.

50

v4.1.0+

​

ECTO_USE_SSL

​

Production environment variable to use SSL on Ecto queries.

true

all

​

HEART_BEAT_TIMEOUT

​

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

30

all

​

HEART_COMMAND

​

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

(empty)

all

​

ELIXIR_VERSION

​

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

(empty)

all

​

GRAPHIQL_TRANSACTION

​

Default transaction hash in a sample query to GraphiQL.

(empty)

v1.2.0+

✅

DISABLE_WEBAPP

​

If true, endpoints to webapp are hidden (compile-time). Also, enabling it makes notifications go through db_notify

false

v2.0.3+

✅

DISABLE_READ_API

​

If true, read-only endpoints to API are hidden (compile-time).

false

v2.0.3+

✅

DISABLE_WRITE_API

​

If true, write endpoints to API are hidden (compile-time).

false

v2.0.3+

✅

WEBAPP_URL

​

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

(empty)

v2.0.3+

​

API_URL

​

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

(empty)

v2.0.3+

​

WOBSERVER_ENABLED

​

If true enables wobserver interface.

(empty)

v3.3.2+

✅

CHECKSUM_ADDRESS_HASHES

​

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

true

v3.1.0+

​

CHECKSUM_FUNCTION

​

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

eth

v2.0.1+

​

RESTRICTED_LIST

​

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

(empty)

v3.3.3+

​

RESTRICTED_LIST_KEY

​

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

(empty)

v3.3.3+

​

CUSTOM_CONTRACT_ADDRESSES_TEST_TOKEN

​

List of test tokens addresses: test label will be applied and those tokens will be excluded from omni bridge market cap calculation.

(empty)

v3.6.0+

​

CHAIN_ID

​

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

(empty)

v3.7.0+

​

JSON_RPC

​

(empty)

v4.1.0+

​

HEALTHY_BLOCKS_PERIOD

​

5 mins

v2.0.2+

​

NEW_TAGS

​

(empty)

v5.0.0+

​

CUSTOM_CONTRACT_ADDRESSES_${tag_name}

​

(empty)

v5.0.0+

​

API_V2_ENABLED

​

(empty)

v5.0.0+

​

TOKEN_ID_MIGRATION_FIRST_BLOCK

​

0

v5.0.0+

​

TOKEN_ID_MIGRATION_CONCURRENCY

​

1

v5.0.0+

​

TOKEN_ID_MIGRATION_BATCH_SIZE

​

500

v5.0.0+

​

SESSION_COOKIE_DOMAIN

​

(empty)

v5.0.0+

​

Indexer management

Variable

Required

Description

Default

Version

BLOCK_TRANSFORMER

​

Transformer for blocks: base or clique.

base

v1.3.4+

DISABLE_INDEXER

​

If true, indexer application doesn't run.

false

v2.0.3+

INDEXER_DISABLE_PENDING_TRANSACTIONS_FETCHER

​

If true, pending transactions fetcher is disabled.

false

v4.1.2+

INDEXER_DISABLE_INTERNAL_TRANSACTIONS_FETCHER

​

If true, internal transactions fetcher is disabled.

false

v4.1.2+

INDEXER_DISABLE_BLOCK_REWARD_FETCHER

​

if true, block rewards fetcher is disabled.

false

v4.1.3+

INDEXER_DISABLE_ADDRESS_COIN_BALANCE_FETCHER

​

If true, coin balances fetcher is disabled.

false

v4.1.3+

INDEXER_DISABLE_CATALOGED_TOKEN_UPDATER_FETCHER

​

If true, cataloged tokens metadata fetcher is disabled.

false

v4.1.3+

INDEXER_MEMORY_LIMIT

​

Memory soft limit for the indexer.

1Gb

v4.1.3+

INDEXER_EMPTY_BLOCKS_SANITIZER_BATCH_SIZE

​

Batch size for empty block sanitizer (re-fetcher).

100

v4.1.3+

INDEXER_CATCHUP_BLOCKS_BATCH_SIZE

​

10

v5.0.0+

INDEXER_CATCHUP_BLOCKS_CONCURRENCY

​

10

v5.0.0+

INDEXER_DISABLE_EMPTY_BLOCK_SANITIZER

​

Empty blocks sanitizer is disabled if true

false

v4.1.3+

DISABLE_REALTIME_INDEXER

​

If true, realtime fetcher doesn't run

false

v4.1.6+

DISABLE_KNOWN_TOKENS

​

Disables or enables token symbol for known contract.

false

v3.4.0+

FIRST_BLOCK

​

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

0

v1.3.8+

LAST_BLOCK

​

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

(empty)

v2.0.3+

TRACE_FIRST_BLOCK

​

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

0

v4.1.0+

TRACE_LAST_BLOCK

​

The block number, where indexing of internal transactions stops.

(empty)

v4.1.0+

BLOCK_RANGES

​

​

v4.1.7+

FETCH_REWARDS_WAY

​

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

trace_block

v4.1.4+

ETHEREUM_JSONRPC_DEBUG_TRACE_TRANSACTION_TIMEOUT

​

5s

v4.1.3+

ETHEREUM_JSONRPC_DISABLE_ARCHIVE_BALANCES

​

false

v5.0.0+

ETHEREUM_JSONRPC_PENDING_TRANSACTIONS_TYPE

​

default

v5.0.0+

DISABLE_TOKEN_INSTANCE_FETCHER

​

If true, token instance fetcher doesn't run

false

v5.0.0+

INDEXER_INTERNAL_TRANSACTIONS_BATCH_SIZE

​

10

v5.0.0+

INDEXER_INTERNAL_TRANSACTIONS_CONCURRENCY

​

4

v5.0.0+

INDEXER_RECEIPTS_BATCH_SIZE

​

250

v5.0.0+

INDEXER_RECEIPTS_CONCURRENCY

​

10

v5.0.0+

INDEXER_COIN_BALANCES_BATCH_SIZE

​

500

v5.0.0+

INDEXER_COIN_BALANCES_CONCURRENCY

​

4

v5.0.0+

INDEXER_CATCHUP_MISSING_RANGES_BATCH_SIZE

​

100000

v5.0.0+

MIN_MISSING_BLOCK_NUMBER_BATCH_SIZE

​

100000

v5.0.0+

INDEXER_INTERNAL_TRANSACTIONS_TRACER_TYPE

​

call_tracer

master

Exchange rates management

Variable

Required

Description

Default

Version

DISABLE_EXCHANGE_RATES

​

Disables or enables fetching of coin price from Coingecko API.

false

v3.1.2+

EXCHANGE_RATES_SOURCE

​

This environment variable is used to calculate the exchange rates. Available value is token_bridge. Available values are also coin_gecko and coin_market_cap.

(empty)

v4.1.4+

EXCHANGE_RATES_COINGECKO_COIN_ID

​

Explicitly set CoinGecko coin ID.

(empty)

v4.1.4+

EXCHANGE_RATES_COINGECKO_API_KEY

​

CoinGecko API key.

(empty)

v4.1.4+

EXCHANGE_RATES_COINMARKETCAP_API_KEY

​

CoinMarketCap API key.

(empty)

v4.1.4+

EXCHANGE_RATES_FETCH_BTC_VALUE

​

(empty)

v4.1.5+

Cache management

Variable

Required

Description

Default

Version

CACHE_TXS_COUNT_PERIOD

​

Interval in seconds to restart the task, which calculates the total txs count.

2 hours

v4.1.3+

CACHE_ADDRESS_COUNT_PERIOD

​

2 hours

v4.1.3+

CACHE_ADDRESS_SUM_PERIOD

​

1 hour

v4.1.3+

CACHE_TOTAL_GAS_USAGE_PERIOD

​

Interval in seconds to restart the task, which calculates the total gas usage.

2 hours

v4.1.3+

CACHE_ADDRESS_TRANSACTIONS_GAS_USAGE_COUNTER_PERIOD

​

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

30 minutes

v4.1.3+

CACHE_TOKEN_HOLDERS_COUNTER_PERIOD

​

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

1 hour

v4.1.3+

CACHE_TOKEN_TRANSFERS_COUNTER_PERIOD

​

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

1 hour

v4.1.3+

CACHE_ADDRESS_WITH_BALANCES_UPDATE_INTERVAL

​

Interval in seconds to restart the task, which calculates addresses with balances.

30 minutes

v4.1.3+

TOKEN_METADATA_UPDATE_INTERVAL

​

Interval in seconds to restart the task which updates token metadata.

60 * 60 * 24 * 2

v2.0.1+

CACHE_AVERAGE_BLOCK_PERIOD

​

Update of average block period cache, in seconds.

30 minutes

v4.1.3+

CACHE_MARKET_HISTORY_PERIOD

​

Update of market history cache, in seconds.

6 hours

v4.1.3+

CACHE_ADDRESS_TRANSACTIONS_COUNTER_PERIOD

​

1 hour

v3.4.0+

CACHE_TOKEN_EXCHANGE_RATE_PERIOD

​

Managing cache invalidation for token's exchange rate.

1 hour

v3.5.0+

CACHE_ADDRESS_TOKENS_USD_SUM_PERIOD

​

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

(empty)

v3.5.0+

CACHE_EXCHANGE_RATES_PERIOD

​

10 minutes

v4.1.5+

TOKEN_BALANCE_ON_DEMAND_FETCHER_THRESHOLD_MINUTES

​

60 minutes

v3.7.1+

COIN_BALANCE_ON_DEMAND_FETCHER_THRESHOLD_MINUTES

​

60 minutes

v4.1.2+

CACHE_ADDRESS_TOKEN_TRANSFERS_COUNTER_PERIOD

​

(empty)

v4.0.0+

CACHE_BLOCK_COUNT_PERIOD

​

2 hours

v4.1.3+

Gas price oracle management

Variable

Required

Description

Default

Version

GAS_PRICE_ORACLE_NUM_OF_BLOCKS

​

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

200

v4.1.4+

GAS_PRICE_ORACLE_SAFELOW_PERCENTILE

​

Gas price oracle: safelow percentile

35

v4.1.4+

GAS_PRICE_ORACLE_AVERAGE_PERCENTILE

​

Gas price oracle: average percentile

60

v4.1.4+

GAS_PRICE_ORACLE_FAST_PERCENTILE

​

Gas price oracle: fast percentile

90

v4.1.4+

GAS_PRICE_ORACLE_CACHE_PERIOD

​

Gas price oracle: period of gas prices update

30 sec

v4.1.4+

Main page dashboard management

Variable

Required

Description

Default

Version

GAS_PRICE

​

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

(empty)

v3.3.2+

ENABLE_TXS_STATS

​

Disables or enables txs per day stats gathering.

true

v3.1.2+

SHOW_PRICE_CHART

​

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

false

v3.1.2+

SHOW_TXS_CHART

​

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

true

v3.1.2+

HISTORY_FETCH_INTERVAL

​

Interval in minutes how often to request count of txs per current day in order to display txs count per day chart on the main page.

60

v3.1.2+

TXS_HISTORIAN_INIT_LAG

​

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

0

v3.1.2+

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.

365

v3.1.2+

Header management

Variable

Required

Description

Default

Version

LOGO

​

/images/blockscout_logo.svg

all

SHOW_TESTNET_LABEL

​

(empty)

v4.1.6+

TESTNET_LABEL_TEXT

​

Testnet

v4.1.6+

SUPPORTED_CHAINS

​

[ { title: "POA", url: "https://blockscout.com/poa/core" }, { title: "Sokol", url: "https://blockscout.com/poa/sokol", test_net?: true }, { title: "Gnosis Chain", url: "https://blockscout.com/xdai/mainnet" }, { title: "Ethereum Classic", url: "https://blockscout.com/etc/mainnet", other?: true }, { title: "RSK", url: "https://blockscout.com/rsk/mainnet", other?: true } ]

v2.0.0+

APPS_MENU

​

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

false

v3.3.1+

APPS

​

(empty)

v5.0.0+

Footer management

Variable

Required

Description

Default

Version

LOGO_FOOTER

​

/images/blockscout_logo.svg

​

RELEASE_LINK

​

The link to Blockscout release notes in the footer.

https: //github.com/poanetwork/ blockscout/releases/ tag/${BLOCKSCOUT_VERSION}

v1.3.5+

BLOCKSCOUT_VERSION

​

Added to the footer to signify the current BlockScout version.

(empty)

v1.3.4+

FOOTER_CHAT_LINK

​

https://discord.gg/3CtNAqVMRV

v4.1.6+

FOOTER_ENABLE_FORUM_LINK

​

false

v5.0.0+

FOOTER_FORUM_LINK

​

https://forum.poa.network/c/blockscout

v4.1.6+

FOOTER_GITHUB_LINK

​

https://github.com/blockscout/blockscout

v4.1.6+

LINK_TO_OTHER_EXPLORERS

​

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

(empty)

v1.3.0+

OTHER_EXPLORERS

​

(empty)

v3.4.0+

Misc UI management

Variable

Required

Description

Default

Version

SHOW_ADDRESS_MARKETCAP_PERCENTAGE

​

Configures market cap percentage column on the top accounts page.

true

v2.1.1+

SHOW_MAINTENANCE_ALERT

​

Disables/enables announcement at the top of the explorer.

false

v3.6.0+

MAINTENANCE_ALERT_MESSAGE

​

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

(empty)

v3.6.0+

MAX_SIZE_UNLESS_HIDE_ARRAY

​

50

v3.7.1+

MAX_STRING_LENGTH_WITHOUT_TRIMMING

​

2040

v4.0.0+

HIDE_BLOCK_MINER

​

(empty)

v4.0.0+

DISPLAY_TOKEN_ICONS

​

(empty)

v4.0.0+

ALLOWED_EVM_VERSIONS

​

"homestead, tangerineWhistle, spuriousDragon, byzantium, constantinople, petersburg,istanbul"

v2.0.0+

UNCLES_IN_AVERAGE_BLOCK_TIME

​

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

false

v2.0.1+

COIN_BALANCE_HISTORY_DAYS

​

Number of days to consider at coin balance history chart.

10

v3.1.3+

ADMIN_PANEL_ENABLED

​

(empty)

v4.1.2+

CONTRACT_VERIFICATION_MAX_LIBRARIES

​

(empty)

v5.0.0+

PERMANENT_DARK_MODE_ENABLED

​

(empty)

master

CSV export

Variable

Required

Description

Default

Version

RE_CAPTCHA_SECRET_KEY

​

(empty)

v4.0.0+

RE_CAPTCHA_CLIENT_KEY

​

(empty)

v4.0.0+

API rate limit management

Variable

Required

Description

Default

Version

API_RATE_LIMIT

​

50

v4.1.1+

API_RATE_LIMIT_BY_KEY

​

50

v4.1.1+

API_RATE_LIMIT_BY_IP

​

50

v4.1.1+

API_RATE_LIMIT_WHITELISTED_IPS

​

(empty)

v4.1.1+

API_RATE_LIMIT_STATIC_API_KEY

​

(empty)

v4.1.1+

Specific smart-contracts

Variable

Required

Description

Default

Version

METADATA_CONTRACT

​

This environment variable is specifically used by POA Network to obtain Validators information to display in the UI.

(empty)

all

VALIDATORS_CONTRACT

​

This environment variable is specifically used by POA Network to obtain the list of current validators.

(empty)

all

KEYS_MANAGER_CONTRACT

​

This environment variable is specifically 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.

(empty)

v3.1.2+

REWARDS_CONTRACT

​

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

0xeca443e8e1ab29971a45a9c57a6a9875701698a5

v2.0.4+

TOKEN_BRIDGE_CONTRACT

​

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

0x7301CFA0e1756B71869E93d4e4Dca5c7d0eb0AA6

v1.3.2+

Account-related ENV variables

Variable

Required

Description

Default

Version

ACCOUNT_ENABLED

​

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

(empty)

5.0.0

ACCOUNT_DATABASE_URL

​

Account DB connection string

value from DATABASE_URL

5.0.0

ACCOUNT_REDIS_URL

​

Account Redis connection string (for session storing configuration)

(empty)

5.0.0

ACCOUNT_POOL_SIZE

​

Account DB pool_size

50

5.0.0

ACCOUNT_AUTH0_DOMAIN

​

(empty)

5.0.0

ACCOUNT_AUTH0_CLIENT_ID

​

(empty)

5.0.0

ACCOUNT_AUTH0_CLIENT_SECRET

​

(empty)

5.0.0

ACCOUNT_AUTH0_LOGOUT_URL

​

(empty)

5.0.0

ACCOUNT_AUTH0_LOGOUT_RETURN_URL

​

(empty)

5.0.0

ACCOUNT_PUBLIC_TAGS_AIRTABLE_URL

​

Airtable URL for public tag requests functionality

(empty)

5.0.0

ACCOUNT_PUBLIC_TAGS_AIRTABLE_API_KEY

​

Airtable API key for public tag requests functionality

(empty)

5.0.0

ACCOUNT_SENDGRID_API_KEY

​

Sendgrid API key for watchlist notifications functionality

(empty)

5.0.0

ACCOUNT_SENDGRID_SENDER

​

Sendgrid sender email for watchlist notifications functionality

(empty)

5.0.0

ACCOUNT_SENDGRID_TEMPLATE

​

Sendgrid email template for watchlist notifications functionality

(empty)

5.0.0

ACCOUNT_CLOAK_KEY

​

(empty)

5.0.0

Integrations

Smart-contract verifier

Variable

Required

Description

Default

Version

ENABLE_RUST_VERIFICATION_SERVICE

​

(empty)

v4.1.8+

RUST_VERIFICATION_SERVICE_URL

​

(empty)

v4.1.8+

Sol2Uml

Variable

Required

Description

Default

Version

VISUALIZE_SOL2UML_ENABLED

​

(empty)

v5.0.0+

VISUALIZE_SOL2UML_SERVICE_URL

​

(empty)

v5.0.0+

Sourcify

Variable

Required

Description

Default

Version

ENABLE_SOURCIFY_INTEGRATION

​

Enables or disables verification of contracts through Sourcify.

false

v3.7.0+

SOURCIFY_SERVER_URL

​

URL to Sourcify backend.

v3.7.0+

SOURCIFY_REPO_URL

​

URL to Sourcify repository with fully verified contracts.

v3.7.0+

Tenderly

Variable

Required

Description

Default

Version

SHOW_TENDERLY_LINK

​

(empty)

v4.0.0+

TENDERLY_CHAIN_PATH

​

(empty)

v4.0.0+

Datadog

Variable

Required

Description

Default

Version

DATADOG_HOST

​

(empty)

all

DATADOG_PORT

​

(empty}

all

Spandex

Variable

Required

Description

Default

Version

SPANDEX_BATCH_SIZE

​

(empty)

all

SPANDEX_SYNC_THRESHOLD

​

(empty)

all

Analytics

Variable

Required

Description

Default

Version

MIXPANEL_TOKEN

​

(empty)

v5.0.0+

MIXPANEL_URL

​

(empty)

v5.0.0+

AMPLITUDE_API_KEY

​

(empty)

v5.0.0+

AMPLITUDE_URL

​

(empty)

v5.0.0+

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

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

Add public tag labels. More info in ​

Specify addresses for some label. More info in ​

Enable API V2. Implemented in ​

Bottom block for token id migration. Implemented in ​

Number of workers performing the token id migration. Implemented in ​

Interval of token transfer block numbers processed by a token id migration worker at a time. Implemented in ​

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

Batch size for blocks catchup fetcher. Implemented in .

Concurrency for blocks catchup fetcher. Implemented in .

Block ranges to import by catchup fetcher. Implemented in ​

Timeout for debug_traceTransaction JSON RPC method request in case of geth archive node. Supported time formats: . Introduced in ​

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

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 ​

Batch size for internal transactions fetcher. Implemented in .

Concurrency for internal transactions fetcher. Implemented in .

Batch size for transaction receipts fetcher. Implemented in .

Concurrency for transaction receipts fetcher. Implemented in .

Batch size for coin balances fetcher. Implemented in .

Concurrency for coin balances fetcher. Implemented in .

Batch size for missing ranges collector. Implemented in .

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

Tracer type for debug_traceTransaction request for geth-like nodes. Possible values are: js to use custom Blockscout js tracer, call_tracer to use built-in callTracer geth tracer. Implemented in ​

if true explorer application will fetch btc_value for token exchange rates. Implemented in ​

time to live of cache in seconds. This var was introduced in ​

time to live of addresses sum (except burn address) cache in seconds. This var was introduced in ​

time to live of address' transactions counter in seconds. This var was introduced in ​

value in seconds which is to tune the time to live of exchange rates. Implemented in ​

A threshold to invalidate token balance cache. Implemented in ​

A threshold to invalidate coin balance cache. Implemented in ​

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

time to live of blocks with consensus count cache in seconds. This var was introduced in ​

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

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

The text inside the test label. Implemented in ​

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

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 embedded link is described here ​

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

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

Enable forum menu item in the footer. Implemented in ​

Link in Forum menu item in the footer. Implemented in ​

Github repository. Implemented in ​

The list of alternative explorers. This env var was introduced in PR .

Hide long arrays in smart-contracts. To get more details: ​

Hide long contract method data. For more details: ​

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

Displays token icons from TrustWallet assets repository if true. Implemented in ​

the comma-separated list of allowed EVM versions for contract verification. This var was introduced in ​

if true admin/* routes are available. Implemented in ​

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

If true, permanet dark mode is enabled. Dark mode switcher is hidden in this case. Implemented in ​

Google reCAPTCHA sectret key. Used by advanced CSV export. Implemented in ​

Google reCAPTCHA client key. Used by advanced CSV export. Implemented in ​

A global API rate limit: number or requests per second for all users. Implemented in ​

A dedicated API rate limit for a static API key. Implemented in ​

A dedicated API rate limit for whitelisted IPs. Implemented in ​

Comma-separated whitelisted IPs list with dedicated rate limit. Implemented in ​

Static API key with dedicated API rate limit. Implemented in ​

Domain for ​

Auth0 client ID ​

Auth0 client secret ​

Auth0 logout URL ​

Auth0 logout return URL ​

Account DB encryption key. )

If true, integration with is enabled. Implemented in ​

URL of Rust smart-contract verifier. Implemented in ​

If true, integration with is enabled. Implemented in ​

URL of Rust visualizer. Implemented in ​

​​

​**before 3.7.1 ​

if true, "Open in Tenderly" button is displayed on the transaction page. Implemented in ​

Chain path to the transaction in Tenderly. For instance, for transactions in xDai, Tenderly link looks like this https://dashboard.tenderly.co/tx/xdai/0x..., then TENDERLY_CHAIN_PATH =/xdai. Implemented in ​

Host configuration setting for .

Port configuration setting for .

​ and Datadog configuration setting.

​ and Datadog configuration setting.

​ project token.

Url to use Mixpanel with proxy ().

​ API key.

Url to use Amplitude with proxy ().

🖥️
Gauss Induction Labs Instance
General
Indexer
Exchange Rates
Cache
Gas Price Oracle
Main Page Dashboard
Header
Footer
Miscellaneous UI
CSV Export
API Rate Limit
Specific Smart Contracts
My Account
Integrations
#4931
#2294
#6316
#6316
#6361
#6391
#6391
#6391
#6544
#6196
#6196
#5783
https://pkg.go.dev/time#ParseDuration
#5505
#6001
#6001
#6450
#6450
#6454
#6454
#6454
#6454
#6583
#6583
#6721
#5671
#2822
#2862
#3330
#5671
#3870
#5240
#4699
#1876
here
#5732
#5732
#1900
#3184
#
here
#5719
#6351
#5719
#5719
#3414
#4218
#4667
#4611
#4596
#1964
#5208
#6204
#6204
#4747
#4747
#5030
#5080
#5090
#5090
#5080
Ueberauth Auth0
Ueberauth Auth0
Ueberauth Auth0
Ueberauth Auth0
Ueberauth Auth0
Instruction how to generate
Rust smart-contract verifier
#5860
#5860
Rust sol2uml visulizer
#6401
#6401
https://sourcify.dev/server
https://repo.sourcify.dev/contracts/
https://repo.sourcify.dev/contracts/full_match/
#4656
#4656
Datadog integration
Datadog integration
Spandex
Spandex
Mixpanel
Collection via Proxy
Amplitude
Use Domain Proxy to Relay Events