Blockscout
SupportWebsiteGithubDiscord
  • Blockscout Open-Source Explorer
  • 💡About BlockScout
    • Features
      • Ethereum Bytecode Database Microservice
      • Blockscout Redesign
    • Chains Using Blockscout
    • Partners & Integrations
      • RaaS Providers
      • Vera: Verifier Alliance
        • Adding your chain to the Vera database
        • Programmatic verification via the API
    • News & Media
      • Newsletter & Blog
    • Funding
      • L2 Funding Proposal
        • Aux Funding Images
    • Roadmap
  • 🙎Using Blockscout
    • Getting Started
      • Glossary of Terms
      • Main Menu
      • Blocks
      • Transaction Types
      • Beacon Chain Withdrawal Views
    • My Account
      • Watch list
      • Private tags
      • Public tags
      • API keys
      • Custom ABI
      • Verified addresses
        • Copy and Sign Message
      • For developers
    • Dappscout Apps Marketplace
      • DApp Integration
    • Swapscout
      • Earn Merits when using Swapscout
    • Revokescout
    • Autoscout Explorer Launchpad
    • CSV Exports
    • Token Support
      • ERC-1155 Support
    • Merits
      • Streak rewards
      • Activity Pass
      • Leaderboard
      • Badges
      • FAQs
  • 👩‍💻Developer Support
    • For Web3 Developers
    • Link to Blockscout
    • Blockscout APIs
      • Requests & Limits
      • REST API Endpoints
        • Stats API
        • Interpreter API
      • JSON RPC & ETH Compatible RPC Endpoints
        • Account
        • Block
        • Contract
        • Logs
        • Stats
        • Token
        • Transaction
        • ETH RPC API
      • GraphQL in Blockscout
    • Smart Contract Verification
      • Blockscout UI
      • Blockscout smart-contract verification API
      • Hardhat Verification Plugin
        • Sourcify Plugin for Hardhat
      • Foundry Verification
      • Sourcify Verification
      • OpenZeppelin Contract Verification
      • Automate verifications with Catapulta
      • Verification via thirdweb
      • Interacting with Smart Contracts
    • Blockscout SDK
    • Integrate Merits
    • Chainscout chains list
  • 🏃‍♂️Setup and Run Blockscout
    • General Overview
      • Separate Indexer, Web App, and API
      • Umbrella Project Organization
      • Indexer Architecture Overview
      • ShareLock
      • EVM Version Information
    • Requirements
      • General Backend Requirements / Blockscout Backend Prerequisites
      • Backend/Frontend Compatibility Matrix
      • Hardware & Hosting Requirements
      • Database Storage Requirements
      • Client Setting Requirements
      • Node Tracing / JSON RPC Requirements
      • L2 -> L1 JSON-RPC Method Requests
    • ☑️ENV Variables
      • Backend ENVs: Common
      • Backend ENVs: Chain-Specific
      • Backend ENVs: Integrations
      • Frontend ENVs: Common
        • ENVs
        • Deprecated ENVs
      • Deprecated Backend ENVs
        • Previous ENV Variable Home Page
    • Deployment
      • ⭐Manual Deployment Guide
        • Ubuntu Setup
        • MacOS setup
      • ⭐Docker-compose Deployment
      • ⭐Kubernetes Deployment
      • Rollup Deployment
      • 🌟Cosmos-based chains
      • 🍀Upgrade Guide (v7.0 & v8.0)
      • Frontend Migration
        • All-In-One Container
        • Separate Frontend
        • Customized Backend
        • Proxy Setup
        • FAQs
      • Manual Deployment (backend + old UI)
        • Manual cleaning an instance from the previous deployment
      • Terraform Deployment
      • Ansible Deployment (AWS Cloud)
        • Overview
        • Prerequisites
        • AWS Permissions & Settings
          • Creating a Secret Key Pair
          • Login with AWS CLI
          • Creating an AWS certificate for SSL
          • Manually Cleaning Terraform Related Instances
        • Variables
        • Deploying the Blockscout Infrastructure
        • Deploying Blockscout
        • Destroying Provisioned Infrastructure
        • Common Additional Tasks
        • Common Errors and Questions
        • AWS Marketplace (deprecated)
          • Overview
          • CloudFormation Template
          • Prerequisites & Install Parameters
          • Install from AWS Marketplace
          • AWS EC2 archive node setup with OpenEthereum (formerly Parity)
          • Updating & Redeploying in AWS
          • Customizing CSS
    • Microservices
      • Blockscout ENS (BENS) Name Service Integration
      • Smart Contract Verification
    • Configuration Options
      • Admin Panel Usage
      • Automating Restarts
      • Branding Configs
      • Circle CI Updates
      • Charts and Stats
      • CSS Configuration & Presets
      • Exchange Rates
      • Front-end Config Files
      • haproxy Settings for Blockscout.com
      • Internationalization
      • Logger Configs
      • Memory Usage
      • Metrics
      • My Account Settings
      • reCAPTCHA
      • Reown (previously WalletConnect) Project ID for contract Read/Write
      • Sorting and Pagination
      • Tracing
    • Indexing
      • How do I fix indexer timeouts?
      • How do I update memory consumption to fix indexer memory errors?
    • Testing
    • DB schema
  • FAQs
    • User FAQs
    • Developer FAQs
  • 🧩Resources
    • EaaS: Hosting with Blockscout
    • Contributing to Blockscout
    • Bug Bounty Program
    • Media kit
    • Release Notes
      • v5.3.0: 10/23/23
      • v5.2.0: 6/20/23
      • v5.1.0: 2/13/23
      • v5.0.0: 1/11/23
    • Discord Channel
    • Discussion
    • GitHub Repo
Powered by GitBook
LogoLogo

Privacy and Terms

  • Privacy Notice
  • Terms and Conditions

Copyright © Blockscout Limited 2023-2024

On this page
  • Time format
  • Smart-contract verifier / Eth Bytecode DB
  • Sol2Uml
  • Sig-provider
  • Blockscout ENS
  • Blockscout Account Abstraction
  • Tx Interpreter (Summary) Service
  • Metadata Service
  • Multichain Search Service
  • TAC Operation Lifecycle Service
  • Sourcify
  • Tenderly
  • Datadog
  • Spandex
  • Analytics
  • Solidityscan
  • Noves.fi
  • MUD framework
  • Xname app
  • Stylus contract verifier

Was this helpful?

Export as PDF
  1. Setup and Run Blockscout
  2. ENV Variables

Backend ENVs: Integrations

Last updated 5 days ago

Was this helpful?

The following ENVs are used for different integrations. Some work with various microservices (when the variable begins with MICROSERVICE) while others are contained within the application.

More info on Blockscout Rust MicroServices is available in the .

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.

Smart-contract verifier / Eth Bytecode DB

Connecting to the smart contract verification service

Variable
Description
Parameters

MICROSERVICE_SC_VERIFIER_ENABLED

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

MICROSERVICE_SC_VERIFIER_URL

Version: v5.1.3+ Default: https://eth-bytecode-db.services.blockscout.com/ Applications: API

MICROSERVICE_ETH_BYTECODE_DB_INTERVAL_BETWEEN_LOOKUPS

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

MICROSERVICE_SC_VERIFIER_TYPE

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

MICROSERVICE_ETH_BYTECODE_DB_MAX_LOOKUPS_CONCURRENCY

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

MICROSERVICE_SC_VERIFIER_API_KEY

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

Sol2Uml

Sol2Uml is a visualization tool for Solidity contracts.

Variable
Description
Parameters

MICROSERVICE_VISUALIZE_SOL2UML_ENABLED

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

MICROSERVICE_VISUALIZE_SOL2UML_URL

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

Sig-provider

The Sig-provider microservice is used by Blockscout to display decoded transaction data on transaction pages and to determine transaction actions

Variable
Description
Parameters

MICROSERVICE_SIG_PROVIDER_ENABLED

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

MICROSERVICE_SIG_PROVIDER_URL

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

Blockscout ENS

Variable
Description
Parameters

MICROSERVICE_BENS_ENABLED

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

MICROSERVICE_BENS_URL

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

Blockscout Account Abstraction

Variable
Description
Parameters

MICROSERVICE_ACCOUNT_ABSTRACTION_ENABLED

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

MICROSERVICE_ACCOUNT_ABSTRACTION_URL

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

Tx Interpreter (Summary) Service

Variable
Description
Parameters

MICROSERVICE_TRANSACTION_INTERPRETATION_ENABLED

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

MICROSERVICE_TRANSACTION_INTERPRETATION_URL

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

Metadata Service

Variable
Description
Parameters

MICROSERVICE_METADATA_ENABLED

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

MICROSERVICE_METADATA_URL

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

MICROSERVICE_METADATA_PROXY_REQUESTS_TIMEOUT

Version: v7.0.0+ Default: 30s Applications: API

Multichain Search Service

Multichain Search is the single point of search of the data in the all blockchains.

Variable
Description
Parameters

MICROSERVICE_MULTICHAIN_SEARCH_URL

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

MICROSERVICE_MULTICHAIN_SEARCH_API_KEY

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

MICROSERVICE_MULTICHAIN_SEARCH_ADDRESSES_CHUNK_SIZE

Version: v8.1.0+ Default: 7000 Applications: API, Indexer

MIGRATION_BACKFILL_MULTICHAIN_SEARCH_BATCH_SIZE

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

INDEXER_DISABLE_MULTICHAIN_SEARCH_DB_EXPORT_RETRY_FETCHER

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

INDEXER_MULTICHAIN_SEARCH_DB_EXPORT_RETRY_BATCH_SIZE

Version: v8.1.0+ Default: 10 Applications: Indexer

INDEXER_MULTICHAIN_SEARCH_DB_EXPORT_RETRY_CONCURRENCY

Version: v8.1.0+ Default: 10 Applications: Indexer

INDEXER_MULTICHAIN_SEARCH_DB_EXPORT_RETRY_ENQUEUE_BUSY_WAITING_TIMEOUT

Version: v8.1.0+ Default: 1s Applications: Indexer

INDEXER_MULTICHAIN_SEARCH_DB_EXPORT_RETRY_MAX_QUEUE_SIZE

Version: v8.1.0+ Default: 1000 Applications: Indexer

TAC Operation Lifecycle Service

Variable
Description
Parameters

MICROSERVICE_TAC_OPERATION_LIFECYCLE_URL

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

MICROSERVICE_TAC_OPERATION_LIFECYCLE_ENABLED

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

Sourcify

Variable
Description
Parameters

SOURCIFY_INTEGRATION_ENABLED

Enables or disables verification of contracts through Sourcify.

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

SOURCIFY_SERVER_URL

URL to Sourcify backend.

Version: v3.7.0+ Default: https://sourcify.dev/server Applications: API

SOURCIFY_REPO_URL

URL to Sourcify repository with fully verified contracts.

Version: v3.7.0+ Default: https://repo.sourcify.dev/contracts/ Before v3.7.1: https://repo.sourcify.dev/contracts/full_match/ Applications: API

Tenderly

Variable
Description
Parameters

SHOW_TENDERLY_LINK

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

TENDERLY_CHAIN_PATH

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

Datadog

Integration with the Datadog monitoring and analytics tools

Variable
Description
Parameters

DATADOG_HOST

Version: all Default: (empty) Applications: API

DATADOG_PORT

Version: all Default: (empty) Applications: API

Spandex

Spandex is a library for tracing Elixir applications

Variable
Description
Parameters

SPANDEX_BATCH_SIZE

Version: all Default: (empty) Applications: API

SPANDEX_SYNC_THRESHOLD

Version: all Default: (empty) Applications: API

Analytics

Variables for adding Mixpanel and/or amplitude for visitor analytics.

Variable
Description
Parameters

MIXPANEL_TOKEN

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

MIXPANEL_URL

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

AMPLITUDE_API_KEY

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

AMPLITUDE_URL

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

Solidityscan

Enables security scoring for smart contracts

Variable
Description
Parameters

SOLIDITYSCAN_PLATFORM_ID

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

SOLIDITYSCAN_CHAIN_ID

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

SOLIDITYSCAN_API_TOKEN

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

Noves.fi

Variable
Description
Parameters

NOVES_FI_BASE_API_URL

Version: v6.1.0+ Default: https://blockscout.noves.fi Applications: API

NOVES_FI_CHAIN_NAME

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

NOVES_FI_API_TOKEN

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

MUD framework

Variable
Description
Parameters

MUD_INDEXER_ENABLED

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

MUD_DATABASE_URL

MUD indexer DB connection URL.

Version: v6.6.0+ Default: value from DATABASE_URL Applications: API

MUD_POOL_SIZE

MUD indexer DB pool_size

Version: v6.6.0+ Default: 50 Applications: API

Xname app

Enables Xname app integration, which includes humanity score displayment.

Variable
Description
Parameters

XNAME_BASE_API_URL

Version: v6.9.2+ Default: https://gateway.xname.app Applications: API

XNAME_API_TOKEN

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

Stylus contract verifier

Connecting to the Stylus smart contract verification service

Variable
Description
Parameters

MICROSERVICE_STYLUS_VERIFIER_URL

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

If true, integration with is enabled. true is the default value starting from version 6.4.0. Implemented in

URL of Rust smart-contract verifier. Implemented in

Minimal time after unsuccessful check of smart contract's sources in Eth Bytecode DB. Implemented in .

Type of smart contract microservice could be either eth_bytecode_db or sc_verifier. Implemented in

Maximum amount of concurrent requests for fetching smart contract's sources in Eth Bytecode DB. Implemented in

API key for verification that metadata sent to verifier microservice from a trusted source. Implemented in

If true, integration with is enabled. Implemented in

URL of Rust visualizer. Implemented in

If true, integration with is enabled. Implemented in

URL of Rust sig-provider service. Implemented in

Blockscout ENS provides indexed data of domain name service for blockscout instances. .

If true, integration with is enabled. Implemented in

URL of Blockscout ENS service. Implemented in

Enables the , a service designed to index, decode and serve user operations as per the ERC-4337 standard

If true, integration with is enabled. Implemented in

URL of Blockscout ENS service. Implemented in

If true, integration with Tx Interpreter Service is enabled. Implemented in

URL of Tx Interpreter Service. Implemented in

If true, integration with Metadata Service is enabled. Implemented in

URL of Metadata Service. Implemented in

Timeout for request forwarding from /api/v2/proxy/metadata/. Implemented in

Multichain Search Service API URL. Integration is enabled, if this variable value contains valid URL. Implemented in

Multichain Search Service API key. Implemented in

Chunk size of addresses while exporting to Multichain Search DB. Implemented in

Batch size of backfilling Multichain Search Service DB. Implemented in

If true, retry multichain search export fetcher doesn't run. Implemented in .

Batch size for retry multichain search export fetcher. Implemented in .

Concurrency for retry multichain search export fetcher. Implemented in .

Timeout before new attempt to append item to retry multichain search export queue if it's full. . Implemented in .

Maximum size of retry multichain search export queue. Implemented in .

TAC Operation Lifecycle Service API URL. Integration is enabled, if this variable value contains valid URL. Implemented in

If false, TAC Operation Lifecycle Service integration is disabled despite MICROSERVICE_TAC_OPERATION_LIFECYCLE_URL. Implemented in

Allows for contract verification via

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 ().

Internal platform id in . Implemented in

Internal chain id in . It may not match with actual chain ID. Implemented in

API token for usage of .

Adds additional transaction details such as summaries and asset flows. .

base URL. Implemented in .

chain name. Implemented in .

token. Implemented in .

provides standardized tools for data retrieval, libraries and more.

If true, integration with is enabled. Implemented in

base URL. Implemented in .

token. Implemented in .

URL of Stylus verifier. If set valid url and CHAIN_TYPE=arbitrum, integration with is enabled. Implemented in

🏃‍♂️
☑️
blockscout-rs Github Repo
Learn more
User Ops Indexer
Sourcify
More info here
The MUD framework
Rust smart-contract verifier
#5860
#5860
#7187
#7187
#8472
#8750
Rust sol2uml visualizer
#6401
#6401
Rust sig-provider service
#6541
#6541
Blockscout ENS service
#8972
#8972
Blockscout Account Abstraction service
#9145
#9145
#8957
#8957
#9706
#9706
#11656
#11139
#11139
#12377
#11139
#12377
#12377
#12377
Time format
#12377
#12377
#12367
#12367
#4656
#4656
Datadog integration
Datadog integration
Spandex
Spandex
Mixpanel
Collection via Proxy
Amplitude
Use Domain Proxy to Relay Events
Solidityscan
#10473
Solidityscan
#8908
Solidityscan API
Noves.fi API
#9056
Noves.fi API
#9056
Noves.fi API
#9056
MUD
#9869
Xname API
#11010
Xname API
#11010
Stylus verifier
#11183
Scroll down on the contract page to find the View UML diagram link
Contract visualization example