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
      • Sorting and Pagination
      • Tracing
      • Reown Project ID for contract Read/Write
    • 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
  • Supported JSON RPC Clients
  • Configs
  • Variables to connect to JSON RPC client
  • Geth
  • Erigon
  • Nethermind
  • Reth
  • RSKj
  • Besu
  • Lotus
  • OpenEthereum

Was this helpful?

Export as PDF
  1. Setup and Run Blockscout
  2. Requirements

Client Setting Requirements

Last updated 16 days ago

Was this helpful?

🚗 , providing a simple one-click explorer deployment with Blockscout's optimized hosting infrastructure. Use it for early testing, modifications, and launching a full production-grade explorer. and have your explorer up-and-running in minutes.

Supported JSON RPC Clients

BlockScout currently supports , , , , , , , and JSON RPC clients. To define the JSON RPC node variant, it's advised to define the ETHEREUM_JSONRPC_VARIANT environment variable*. Correct values include:

JSON RPC Client
Value
Note

Geth

`geth`

Default. This value is applicable for both Geth and Reth JSON RPC clients

Erigon

`erigon`

It is suggested to use erigon variant for Reth JSON RPC client.

Nethermind

`nethermind`

This value is applicable for Reth and deprecated OpenEthereum (aka Parity) JSON RPC clients

Besu

`besu`

RSKj

`rsk`

Lotus

`filecoin`

Anvil

`anvil`

*If the variable is not set, JSON RPC variant will be chosen based on CHAIN_TYPE variable according to the mapping https://github.com/blockscout/blockscout/blob/a2625803c831fb86e38ffe0e28d94bfd697914ce/apps/ethereum_jsonrpc/lib/ethereum_jsonrpc/variant.ex#L114-L120

  defp get_default_variant do
    case Application.get_env(:explorer, :chain_type) do
      :rsk -> "rsk"
      :filecoin -> "filecoin"
      _ -> "geth"
    end
  end

BlockScout currently requires a full archive node in order to import every state change for every address on the target network.

Configs

Application
Environment
Config path

Explorer

Dev

Prod

Indexer

Dev

Prod

Variables to connect to JSON RPC client

Name
Environment Variable
Default Value
Description

HTTP Endpoint

ETHEREUM_JSONRPC_HTTP_URL

http://localhost:8545

The HTTP Endpoint is used to fetch blocks, transactions, receipts, coin/token balances.

Fallback HTTP Endpoint

ETHEREUM_JSONRPC_FALLBACK_HTTP_URL

(empty)

Fallback JSON RPC HTTP url.

Tracing Endpoint

ETHEREUM_JSONRPC_TRACE_URL

http://localhost:8545

The Tracing endpoint is used to fetch internal transactions and block traces. In most cases this endpoint is identical to the HTTP Endpoint.

Fallback Tracing Endpoint

ETHEREUM_JSONRPC_FALLBACK_TRACE_URL

(empty)

Fallback JSON RPC tracing url.

Eth_call Requests Endpoint

ETHEREUM_JSONRPC_ETH_CALL_URL

(empty)

JSON RPC url for eth_call method requests.

Fallback Eth_call Requests Endpoint

ETHEREUM_JSONRPC_FALLBACK_ETH_CALL_URL

(empty)

Fallback JSON RPC eth_call url.

WebSockets Endpoint

ETHEREUM_JSONRPC_WS_URL

ws://localhost:8546

The WebSockets endpoint subscribes to newHeads which alerts the indexer to fetch the new block from the subscription.

Geth

sudo /usr/bin/geth --http --http.addr 0.0.0.0 --port 30303 --http.port 8545 --http.api debug,net,eth,shh,web3,txpool --ws.api "eth,net,web3,network,debug,txpool" --ws --ws.addr 0.0.0.0 --ws.port 8546 --ws.origins "*" --sepolia --datadir=/rinkeby --syncmode "full" --gcmode "archive" --http.vhosts "*"

Tracing and pruning: By default, state for the last 128 blocks kept in memory. Most states are garbage collected. If you are running a block explorer or other service relying on transaction tracing without an archive node (--gcmode=archive), you need to trace within this window! Alternatively, specify the "reexec" tracer option to allow regenerating historical state; and ideally switch to chain tracing which amortizes overhead across all traced blocks.

Erigon

Nethermind

Reth

RSKj

Besu

Lotus

OpenEthereum

--jsonrpc-interface all --jsonrpc-apis web3,eth,net,parity,pubsub,traces --ws-interface all --fat-db=on --pruning=archive --ws-apis all --ws-origins all --ws-hosts all

More information on Geth JSON-RPC .

More information on Erigon configuration .

More information on Nethermind configuration .

More information on Reth configuration .

More information on RSKj configuration .

More information on Besu configuration .

More information on Lotus configuration .

🏃‍♂️
Autoscout is now available
Get Started Now
Geth
Erigon
Nethermind
Reth
Besu
RSKj
Lotus
Anvil
is available here
is available here
is available here
is available here
is available here
is available here
is available here
https://github.com/blockscout/blockscout/tree/master/apps/explorer/config/dev
https://github.com/blockscout/blockscout/tree/master/apps/explorer/config/prod
https://github.com/blockscout/blockscout/tree/master/apps/indexer/config/dev
https://github.com/blockscout/blockscout/tree/master/apps/indexer/config/prod