isabella232 / explorer-5

RSK Block Explorer

RSK Block Explorer

Local installation

Clone the repo

git clone https://github.com/rsksmart/explorer

Download Nodejs and npm if you don't have them

Install dependencies:

npm install

Install mongodb:

MacOS: brew install mongodb

Ubuntu: sudo apt-get install -y mongodb-org

Populate the DB

This will fetch and parse the entire blockchain.

Example configuration file: /tools/config.json

Basic settings:

{
	"gethHost": "mynode.com",
    "gethPort": 4444, 
    "blocks": [ {"start": 2000, "end": "latest"}],
    "quiet": false,
    "terminateAtExistingDB": true,
    "listenOnly": false
}

blocks is a list of blocks to grab. It can be specified as a list of block numbers or an interval of block numbers. When specified as an interval, it will start at the end block and keep recording decreasing block numbers.

terminateAtExistingDB will terminate the block grabber once it gets to a block it has already stored in the DB.

quiet prints out the log of what it is doing.

listenOnly When true, the grabber will create a filter to receive the latest blocks from geth as they arrive. It will not continue to populate older block numbers.

Note: When listenOnly is set to true, the blocks option is ignored.

Note 2: terminateAtExistingDB and listenOnly are mutually exclusive. Do not use terminateAtExistingDB when in listenOnly mode.

Run:

node ./tools/grabber.js

Leave this running in the background to continuously fetch new blocks.

Stats

Tools for updating network stats are under development, but can be found in:

node ./tools/stats.js

WebApp:

export NODE_ENV="{ENV}" 
node app.js

NODE_ENV can be deveploment for dummy data or another string for real data.