Client Settings (Parity, OpenEthereum, Hyperledger Besu, Geth, Ganache)

Supported Clients
BlockScout currently supports Parity, OpenEthereum, Geth, Nethermind, Hyperledger Besu, and Ganache clients. To define the node variant, it's advised to define the ETHEREUM_JSONRPC_VARIANT environment variable. Correct values include:
parity the same for Parity, OpenEthereum and Nethermind (default)
geth
besu
ganache
BlockScout currently requires a full archive node in order to import every state change for every address on the target network.
Development
Explorer: https://github.com/poanetwork/blockscout/blob/master/apps/explorer/config/dev.exs​
Indexer: https://github.com/poanetwork/blockscout/blob/master/apps/indexer/config/dev.exs​
variant =
  if is_nil(System.get_env("ETHEREUM_JSONRPC_VARIANT")) do
    "ganache"
  else
    System.get_env("ETHEREUM_JSONRPC_VARIANT")
    |> String.split(".")
    |> List.last()
    |> String.downcase()
  end
Production
Explorer: https://github.com/poanetwork/blockscout/blob/master/apps/explorer/config/dev.exs​
Indexer: https://github.com/poanetwork/blockscout/blob/master/apps/indexer/config/prod.exs​
variant =
  if is_nil(System.get_env("ETHEREUM_JSONRPC_VARIANT")) do
    "parity"
  else
    System.get_env("ETHEREUM_JSONRPC_VARIANT")
    |> String.split(".")
    |> List.last()
    |> String.downcase()
  end
OpenEthereum Client
--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
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.
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.
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.
Development
Explorer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/explorer/config/dev/parity.exs#L8-L22​
Indexer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/indexer/config/dev/parity.exs#L9-L23​
Production
Explorer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/explorer/config/prod/parity.exs#L8-L22​
Indexer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/indexer/config/prod/parity.exs#L9-L23​
Geth Client
sudo /usr/bin/geth --rpc --rpcaddr 0.0.0.0 --port 30303 --rpcport 8545 --rpcapi debug,net,eth,shh,web3,txpool --wsapi "eth,net,web3,network,debug,txpool" --ws --wsaddr 0.0.0.0 --wsport 8546 --wsorigins "*" --rinkeby --datadir=/rinkeby --syncmode=full --gcmode=archive --rpcvhosts=*
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.
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.
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.
Development
Explorer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/explorer/config/dev/geth.exs#L8-L17​
Indexer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/indexer/config/dev/geth.exs#L9-L18​
Production
Explorer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/explorer/config/prod/geth.exs#L8-L17​
Indexer: https://github.com/poanetwork/blockscout/blob/59d8423e7ca3f608dbea411d4a0dc9bb4662a891/apps/indexer/config/prod/geth.exs#L9-L18​

Umbrella Project Organization

Deployment Differences Between Chains

Last updated 1 year ago

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`.
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.
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.