Blockchain explorer for Ethereum based network and a tool for inspecting and analyzing EVM based blockchains.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Andrew Gross 55c7c56cdd added about and features info to readme, formatted content 6 years ago
.circleci Revert "Add circleci config to solidity cli" 6 years ago
apps Merge pull request #336 from poanetwork/fix-homepage-timeout-#330 6 years ago
bin Move to root folder 6 years ago
config Merge branch 'master' into optimized-indexer 7 years ago
.credo.exs Disable credo rules handled by mix format 7 years ago
.dialyzer-ignore Use nowarn_function instead of .dialyzer-ignore 7 years ago
.formatter.exs Benchmark 7 years ago
.gitignore Include solc-js as a dependency 6 years ago
.pairs Add Desmond to pairs 7 years ago
.tool-versions Update CircleCI to Elixir 1.6.5 6 years ago
CODE_OF_CONDUCT.md Move to root folder 6 years ago
CONTRIBUTING.md CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md 6 years ago
ISSUE_TEMPLATE.md Add that reproduction repos are appreciated. 6 years ago
LICENSE Add GPL3 license 7 years ago
PULL_REQUEST_TEMPLATE.md CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md 6 years ago
README.md added about and features info to readme, formatted content 6 years ago
appspec.yml [deployment] need to run build step as root, in order to set permissions correctly to run as ec2-user later 6 years ago
coveralls.json Extract Explorer.Indexer to Indexer 6 years ago
mix.exs Extract Explorer.Indexer to Indexer 6 years ago
mix.lock Remove Scrivener library (and clean up unused from mix.lock) 6 years ago

README.md

POA Explorer CircleCI Coverage Status

POA Explorer 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.

About POA Explorer

POA Explorer 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.

Features

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.

  • ERC20 token support: Solution supports ERC20 token ecosystem. Future releases will support additional token types including ERC223, ERC721, 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.

Getting Started

We use Terraform to build the correct infrastructure to run POA Explorer. See https://github.com/poanetwork/poa-explorer-infra for details.

Requirements

The development stack page contains more information about these frameworks.

Setup Instructions

  1. Fork and clone repository.
    https://github.com/poanetwork/poa-explorer/fork

  2. Set up default configurations.
    cp apps/explorer/config/dev.secret.exs.example apps/explorer/config/dev.secret.exs
    cp apps/explorer_web/config/dev.secret.exs.example apps/explorer_web/config/dev.secret.exs

  3. Install dependencies.
    mix do deps.get, local.rebar, deps.compile, compile

  4. Create and migrate database.
    mix ecto.create && mix ecto.migrate

  5. Install Node.js dependencies.
    cd apps/explorer_web/assets && npm install; cd - cd apps/explorer && npm install; cd -

  6. 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
    DEBUG_INDEXER=1 iex -S mix phx.server

Umbrella Project Organization

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/explorer_web :explorer_web ExplorerWeb Phoenix interface to :explorer. The minimum interface to allow web access should go in :explorer_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.

CircleCI Updates

To monitor build status, configure your local CCMenu with the following url: https://circleci.com/gh/poanetwork/poa-explorer.cc.xml?circle-token=f8823a3d0090407c11f87028c73015a331dbf604

Testing

Requirements

  • PhantomJS (for wallaby)

Running the tests

  1. Build the assets.
    cd apps/explorer_web/assets && npm run build; cd -

  2. Format the Elixir code.
    mix format

  3. Run the test suite with coverage for whole umbrella project.
    mix coveralls.html --umbrella

  4. Lint the Elixir code.
    mix credo --strict

  5. Run the dialyzer.
    mix dialyzer --halt-exit-status

  6. Check the Elixir code for vulnerabilities.
    cd apps/explorer && mix sobelow --config; cd -
    cd apps/explorer_web && mix sobelow --config; cd -

  7. Lint the JavaScript code.
    cd apps/explorer_web/assets && npm run eslint; cd -

API Documentation

To view Modules and API Reference documentation:

  1. mix docs generates documentation
  2. open doc/index.html to view

Internationalization

The app is currently internationalized. It is only localized to U.S. English.

To translate new strings, run cd apps/explorer_web; mix gettext.extract --merge and edit the new strings in apps/explorer_web/priv/gettext/en/LC_MESSAGES/default.po.

Acknowledgements

We would like to thank the EthPrize foundation for their funding support.

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

License: LGPL v3.0

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