BlockScout provides a comprehensive, easy-to-use interface for users to view, confirm, and inspect transactions on all EVM (Ethereum Virtual Machine) blockchains. This includes the Ethereum main and test networks as well as Ethereum forks and sidechains.
Following is an overview of the project and instructions for getting started.
BlockScout is an Elixir application that allows users to search transactions, view accounts and balances, and verify smart contracts on the entire Ethereum network including all forks and sidechains.
Currently available block explorers (i.e. Etherscan and Etherchain) are closed systems which are not independently verifiable. As Ethereum sidechains continue to proliferate in both private and public settings, transparent tools are needed to analyze and validate transactions.
The first release will include a block explorer for the POA core and Sokol test networks. Additional networks will be added in upcoming versions.
Development is ongoing. Please see the project timeline for projected milestones.
-
Open source development: The code is community driven and available for anyone to use, explore and improve.
-
Real time transaction tracking: Transactions are updated in real time - no page refresh required. Infinite scrolling is also enabled.
-
Smart contract interaction: Users can read and verify Solidity smart contracts and access pre-existing contracts to fast-track development. Support for Vyper, LLL, and Web Assembly contracts is in progress.
-
Token support: Version 1 supports ERC20 and ERC721 tokens. Future releases will support additional token types including ERC223 and ERC1155.
-
User customization: Users can easily deploy on a network and customize the Bootstrap interface.
-
Ethereum sidechain networks: Version 1 supports the POA main network and Sokol test network. Future iterations will support Ethereum mainnet, Ethereum testnets, forks like Ethereum Classic, sidechains, and private EVM networks.
We use Terraform to build the correct infrastructure to run BlockScout. See https://github.com/poanetwork/blockscout-terraform for details.
The development stack page contains more information about these frameworks.
- Erlang/OTP 21.0.4
- Elixir 1.7.1
- Postgres 10.3
- Node.js 10.5.0
- Automake
- For Mac OSX users:
brew install automake
- For Mac OSX users:
- Libtool
- For Mac OSX users:
brew install libtool
- For Mac OSX users:
- GitHub for code storage
- Inotify-tools for Linux users only
-
Clone the repository.
git clone https://github.com/poanetwork/blockscout
-
Go to the explorer subdirectory.
cd blockscout
-
Set up default configurations.
cp apps/explorer/config/dev.secret.exs.example apps/explorer/config/dev.secret.exs
cp apps/block_scout_web/config/dev.secret.exs.example apps/block_scout_web/config/dev.secret.exs
Linux: Update the database username and password configuration inapps/explorer/config/dev.secret.exs
Mac: Remove theusername
andpassword
fields fromapps/explorer/config/dev.secret.exs
Optional: Set up default configuration for testing.
cp apps/explorer/config/test.secret.exs.example apps/explorer/config/test.secret.exs
Example usage: Changing the default Postgres port from localhost:15432 if Boxen is installed. -
Install dependencies.
mix do deps.get, local.rebar --force, deps.compile, compile
-
Create and migrate database.
mix ecto.create && mix ecto.migrate
Note: If you have run previously, drop the previous database
mix do ecto.drop, ecto.create, ecto.migrate
-
Install Node.js dependencies.
cd apps/block_scout_web/assets && npm install; cd -
cd apps/explorer && npm install; cd -
-
Start Phoenix Server.
mix phx.server
Now you can visit localhost:4000
from your browser.
Additional runtime options:
-
Run Phoenix Server with IEx (Interactive Elixer)
iex -S mix phx.server
-
Run Phoenix Server with real time indexer
iex -S mix phx.server
Note: Most of these modifications will be consolidated into a single file in the future.
-
Update the import file in
apps/block_scout_web/assets/css/theme/_variables.scss
. There are several preset css files for our supported chains which include Ethereum Classic, Ethereum Mainnet, Ropsten Testnet, Kovan Testnet, POA Core, and POA Sokol. To deploy Ethereum Classic, change the import toethereum_classic_variables
. -
Update the logo file in
apps/block_scout_web/config/config.exs
. To deploy Ethereum Classic, change this file toclassic_ethereum_logo.svg
. -
Update the
check_origin
configuration inapps/block_scout_web/config/prod.exs
. This allows realtime events to occur on your endpoint. -
Update the node configuration. You will need a full tracing node with WebSockets enabled. Make the changes in the following files (dev/prod):
apps/explorer/config/dev/parity.exs
apps/explorer/config/prod/parity.exs
apps/indexer/config/dev/parity.exs
apps/indexer/config/prod/parity.exs
-
Update the dropdown menu in the main navigation
apps/block_scout_web/lib/block_scout_web/templates/layout/_topnav.html.eex
-
Update the coin in
apps/explorer/config/config.exs
. This will pull relevant information from Coinmarketcap.com.
This repository is an umbrella project. Each directory under apps/
is a separate Mix project and OTP application, but the projects can use each other as a dependency in their mix.exs
.
Each OTP application has a restricted domain.
Directory | OTP Application | Namespace | Purpose |
---|---|---|---|
apps/ethereum_jsonrpc |
:ethereum_jsonrpc |
EthereumJSONRPC |
Ethereum JSONRPC client. It is allowed to know Explorer 's param format, but it cannot directly depend on :explorer |
apps/explorer |
:explorer |
Explorer |
Storage for the indexed chain. Can read and write to the backing storage. MUST be able to boot in a read-only mode when run independently from :indexer , so cannot depend on :indexer as that would start :indexer indexing. |
apps/block_scout_web |
:block_scout_web |
BlockScoutWeb |
Phoenix interface to :explorer . The minimum interface to allow web access should go in :block_scout_web . Any business rules or interface not tied directly to Phoenix or Plug should go in :explorer . MUST be able to boot in a read-only mode when run independently from :indexer , so cannot depend on :indexer as that would start :indexer indexing. |
apps/indexer |
:indexer |
Indexer |
Uses :ethereum_jsonrpc to index chain and batch import data into :explorer . Any process, Task , or GenServer that automatically reads from the chain and writes to :explorer should be in :indexer . This restricts automatic writes to :indexer and read-only mode can be achieved by not running :indexer . |
To monitor build status, configure your local CCMenu with the following url: https://circleci.com/gh/poanetwork/blockscout.cc.xml?circle-token=f8823a3d0090407c11f87028c73015a331dbf604
- PhantomJS (for wallaby)
-
Build the assets.
cd apps/block_scout_web/assets && npm run build; cd -
-
Format the Elixir code.
mix format
-
Run the test suite with coverage for whole umbrella project. This step can be run with different configuration outlined below.
mix coveralls.html --umbrella
-
Lint the Elixir code.
mix credo --strict
-
Run the dialyzer.
mix dialyzer --halt-exit-status
-
Check the Elixir code for vulnerabilities.
cd apps/explorer && mix sobelow --config; cd -
cd apps/block_scout_web && mix sobelow --config; cd -
-
Lint the JavaScript code.
cd apps/block_scout_web/assets && npm run eslint; cd -
-
Test the JavaScript code.
cd apps/block_scout_web/assets && npm run test; cd -
This is the default setup. mix coveralls.html --umbrella
will work on its own, but to be explicit, use the following setup:
export ETHEREUM_JSONRPC_CASE=EthereumJSONRPC.Case.Parity.Mox
export ETHEREUM_JSONRPC_WEB_SOCKET_CASE=EthereumJSONRPC.WebSocket.Case.Mox
mix coveralls.html --umbrella --exclude no_parity
export ETHEREUM_JSONRPC_CASE=EthereumJSONRPC.Case.Parity.HTTPWebSocket
export ETHEREUM_JSONRPC_WEB_SOCKET_CASE=EthereumJSONRPC.WebSocket.Case.Parity
mix coveralls.html --umbrella --exclude no_parity
Protocol | URL |
---|---|
HTTP | https://sokol-trace.poa.network |
WebSocket | wss://sokol-ws.poa.network/ws |
export ETHEREUM_JSONRPC_CASE=EthereumJSONRPC.Case.Geth.Mox
export ETHEREUM_JSONRPC_WEB_SOCKET_CASE=EthereumJSONRPC.WebSocket.Case.Mox
mix coveralls.html --umbrella --exclude no_geth
export ETHEREUM_JSONRPC_CASE=EthereumJSONRPC.Case.Geth.HTTPWebSocket
export ETHEREUM_JSONRPC_WEB_SOCKET_CASE=EthereumJSONRPC.WebSocket.Case.Geth
mix coveralls.html --umbrella --exclude no_geth
Protocol | URL |
---|---|
HTTP | https://mainnet.infura.io/8lTvJTKmHPCHazkneJsY |
WebSocket | wss://mainnet.infura.io/ws/8lTvJTKmHPCHazkneJsY |
To view Modules and API Reference documentation:
- Generate documentation.
mix docs
- View the generated docs.
open doc/index.html
The app is currently internationalized. It is only localized to U.S. English. To translate new strings.
- To setup translation file.
cd apps/block_scout_web; mix gettext.extract --merge; cd -
- To edit the new strings, go to
apps/block_scout_web/priv/gettext/en/LC_MESSAGES/default.po
.
We would like to thank the EthPrize foundation for their funding support.
See CONTRIBUTING.md for contribution and pull request protocol. We expect contributors to follow our code of conduct when submitting code or comments.
This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.