Awesome Open Source
Awesome Open Source

Bulwark Logo

Bulwark Explorer · GitHub license Build Status Discord GitHub version

The most advanced blockchain eplorer for masternode, proof-of-stake and proof-of-work chains.


  • Address-to-address blockchain data storage powered by Bulwark Carver2D Rev3 algorithm
  • World's most advanced Proof Of Stake calculator based on real blockchain rewards data
  • Running address balance powered by Bulwark's "Perfect Ledger" technology
  • Per-block POS, POW, MN rewards breakdown
  • Detailed per-address rewards breakdown and rewards summary
  • Automatic chain rewinding
  • Graceful error recovery (Unreconciliation)

Easy Installation Instructions

  1. SSH into a clean UBUNTU 18.04 VPS with root access
  2. apt-get install git
  3. adduser explorer
  4. usermod -aG sudo explorer
  5. Ensure your coin RPC is running
  6. su explorer
  7. bash <( curl )


Check block syncing status with tail -f /home/explorer/blockex/tmp/block.log

You will most likely see Error: connect ECONNREFUSED this is because your RPC username/password/port do not match your coin. Please check your coin .config file (ex: /home/explorer/.bulwark/bulwark.conf)

You will see something like this:


Please ensure your /home/explorer/blockex/config.js matches the rpc information of your coin.

Advanced Installation Instructions


This repo assumes git, mongodb, node, yarn, and are installed with configuration done. Please adjust commands to your local environment.

Download links:

It is also required to have the Bulwark daemon running in the background. It is recommended to set this up before beginning to set up the explorer so that it syncs by the time you need it.

Our geniuses here at BulwarkCorp™ have put together a script to Install Bulwark daemon. Just run bash script/

This will install the latest Bulwark wallet and create a rpc username/password before starting the daemon.

Manual Install

git clone - copy repo to local folder.

cd blockex - change into project directory.

yarn install - install packages used by the system.


BlockEx API Configuration

cp config.template.js config.js - setup configuration using template.

Database Configuration

mongo - connect using mongo client.

use blockex - switch to database.

db.createUser( { user: "blockexuser", pwd: "Explorer!1", roles: [ "readWrite" ] } ) - create a user with the values stored in the config.js file from above, meaning they should match.

exit - exit the mongo client.

IMPORTANT: You should not build the frontend using the same config.js file as created above or you WILL LEAK sensitive database information.

BlockEx UI Configuration

On the local development machine, not the server/VPS, run cp config.template.js config.js to create new configuration file that will have the UI information in it.

IMPORTANT: You should have two config.js files, one for the server with the sensitive database connection information, and one that is used by the developer/designer on their local machine to configure and build the UI.


The following automated tasks are currently needed for BlockEx to update but before running the tasks please update the cron script /path/to/blockex/script/ for the block with the local /path/to/node.

yarn run cron:coin - will fetch coin related information like price and supply from

yarn run cron:masternode - updates the masternodes list in the database with the most recent information clearing old information before.

yarn run cron:peer - gather the list of peers and fetch geographical IP information.

yarn run cron:block - will sync blocks and transactions by storing them in the database.

yarn run cron:rich - generate the rich list.

Note: is is recommended to run all the crons before editing the crontab to have the information right away. Follow the order above, start with cron:coin and end with cron:rich.

To setup the crontab please see run crontab -e to edit the crontab and paste the following lines (edit with your local information):

*/1 * * * * cd /path/to/blockex && ./script/ >> ./tmp/block.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/masternode.js >> ./tmp/masternode.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/peer.js >> ./tmp/peer.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/rich.js >> ./tmp/rich.log 2>&1
*/5 * * * * cd /path/to/blockex && /path/to/node ./cron/coin.js >> ./tmp/coin.log 2>&1
0 0 * * * cd /path/to/blockex && /path/to/node ./cron/timeIntervals.js >> ./tmp/timeIntervals.log 2>&1

For crontab config:

  • /path/to/blockex example is /home/explorer/blockex
  • /path/to/node example is /usr/bin/nodejs


At this time only the client web interface needs to be built using webpack and this can be done by running yarn run build:web. This will bundle the application and put it in the /public folder for delivery.


yarn run start:api - will start the api.

yarn run start:web - will start the web, open browser http://localhost:8081.


yarn run test:client - will run the client side tests.

yarn run test:server - will test the rpc connection, database connection, and api endpoints.

Development - Important File Locations

Client - Frontend (react, react-redux)

client/App.jsx - Contains all react routes to components (using react-router-dom)

client/core/Reducers.jsx - Contains all reducers used in redux connect() mapping (using react-redux)

client/core/Actions.jsx - Contains all actions used in redux connect() mapping (using react-redux)

Server - Rest API (node, express, mongo, mongoose)

server/route/api.js - Contains all public rest api endpoint routes

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,554,932
Database (9,547
Blockchain (8,499
Cryptocurrency (5,675
Daemon (574
Crontab (367
Explorer (306
Related Projects