Blockscout

Blockchain Explorer for inspecting and analyzing EVM Chains.

Blockscout provides a comprehensive, easy-to-use interface for users to view, confirm, and inspect transactions on EVM (Ethereum Virtual Machine) blockchains. This includes Ethereum Mainnet, Ethereum Classic, Optimism, Gnosis Chain and many other Ethereum testnets, private networks, L2s and sidechains.

See our project documentation for detailed information and setup instructions.

For questions, comments and feature requests see the discussions section or via Discord.

About Blockscout

Blockscout allows users to search transactions, view accounts and balances, verify and interact with smart contracts and view and interact with applications on the Ethereum network including many forks, sidechains, L2s and testnets.

Blockscout is an open-source alternative to centralized, closed source block explorers such as Etherscan, Etherchain and others. As Ethereum sidechains and L2s continue to proliferate in both private and public settings, transparent, open-source tools are needed to analyze and validate all transactions.

Supported Projects

Blockscout currently supports several hundred chains and rollups throughout the greater blockchain ecosystem. Ethereum, Cosmos, Polkadot, Avalanche, Near and many others include Blockscout integrations. A comprehensive list is available here. If your project is not listed, please submit a PR or contact the team in Discord.

Getting Started

See the project documentation for instructions:

• Manual deployment
• Docker-compose deployment
• Kubernetes deployment
• Manual deployment (backend + old UI)
• Ansible deployment
• ENV variables
• Configuration options

FAIR Network Blockscout Configuration

To deploy Blockscout for FAIR network, an .env file should be created based on this template.

Arguments

Required

• HOST - hostname where the explorer will be accessible (required)
• CHAIN_ID - chain ID for the FAIR network (required)
• ENDPOINT - RPC endpoint for blockchain interaction (required)
• WS_ENDPOINT - WebSocket endpoint for real-time data (required)
• SCHAIN_NAME - name of the FAIR chain for flexibility purposes (required)
• COMPOSE_PROJECT_NAME - Docker Compose project name (affects container naming) (required)
• SCHAIN_APP_NAME - application name shown in the UI (required)
• PROXY_PORT - HTTP/HTTPS proxy port for external access (required)
• DB_PORT - database port for main app (required)
• STATS_PORT - statistics service port (required)
• STATS_DB_PORT - statistics database port (required)
• WALLET_CONNECT_PROJECT_ID - WalletConnect project ID for wallet integration (required)

Optional

• IS_TESTNET - whether this is a testnet deployment (true/false) (optional)
• BLOCKSCOUT_BACKEND_DOCKER_TAG - version of blockscout backend container to use (optional)
• BLOCKSCOUT_FRONTEND_DOCKER_TAG - version of blockscout frontend container to use (optional)
• STATIC_BLOCK_REWARD - static block reward in wei for emission calculations (optional)
• BURNT_FEE_FRACTION - fraction of gas fees that are burnt (0.0 to 1.0) (optional)

Required for production

• DB_PASSWORD - password for PostgreSQL database (required for production)
• RE_CAPTCHA_SECRET_KEY - private key used on blockscout server side to securely verify that user interactions are performed by humans (required for production)

Contributing

See CONTRIBUTING.md for contribution and pull request protocol. We expect contributors to follow our code of conduct when submitting code or comments.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.