Lightweight Ethereum blockchain explorer
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 16 commits ahead of gobitfly:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
public/stylesheets
routes
utils
views
.dockerignore
.env-example
.gitignore
.gitmodules
Dockerfile
LICENSE
README.md
app.js
config.docker.js
config.js.example
docker-compose.yml
docker-entrypoint
package-lock.json
package.json

README.md

Sentinel Chain Explorer

Lightweight blockchain explorer for your private Sentinel chain

Sentinel Chain Explorer is a Sentinel blockchain explorer built with NodeJS, Express and Parity. It does not require an external database and retrieves all information on the fly from a backend Sentinel node.

Current Features

  • Browse blocks, transactions, accounts, bridge information and contracts
  • View pending transactions
  • Display contract internal calls (call, create, suicide)
  • Upload & verify contract sources
  • Show Solidity function calls & parameters (for contracts with available source code)
  • Display the current state of verified contracts
  • Named accounts
  • Advanced transaction tracing (VM Traces & State Diff)
  • View failed transactions
  • Live Backend Node status display
  • Submit signed Transactions to the Network
  • Support for all Bootswatch skins
  • Accounts enumeration
  • Signature verification
  • Supports IPC and HTTP backend connections
  • Responsive layout

Planned features

  • ERC20 Token support

Missing a feature? Please request it by creating a new Issue.

Usage notes

This blockchain explorer is intended for private Sentinel chains. As it does not have a dedicated database all data will be retrived on demand from a backend Parity node. Some of those calls are ressource intensive (e.g. retrieval of the full tx list of an account) and do not scale well for acounts with a huge number of transactions. We currently develop the explorer using the Kovan testnet but it will work with every Parity compatible Ethereum network configuration. The explorer is still under heavy development, if you find any problems please create an issue or prepare a pull request.

Getting started

Setup from source

Supported OS: Ubuntu 16.04

Supported Sentinel backend nodes: Parity (Geth is currently not supported as it does not allow account and received/sent tx enumeration)

  1. Setup a nodejs & npm environment
  2. Install the latest version of the Parity Sentinel client
  3. Start parity using the following options: parity --chain=<yourchain> --tracing=on --fat-db=on --pruning=archive
  4. Clone this repository to your local machine: git clone https://github.com/InfoCorp-Technologies/sentinel-chain-explorer --recursive (Make sure to include --recursive in order to fetch the solc-bin git submodule)
  5. Install all dependencies: npm install
  6. Rename config.js.example into config.js and adjust the file to your local environment
  7. Start the explorer: npm start
  8. Browse to http://localhost:3000

Setup using docker

Build then run the container

docker build -t sentinel-chain-explorer .
docker run -p 3000:3000 sentinel-chain-explorer

Or directly bind the config.js file to avoid rebuilding the image

docker run -p "3000:3000" \
    -v "$(pwd)/config.js":/usr/src/app/config.js \
    sentinel-chain-explorer

Setup using docker-compose

docker-compose up