Skip to content

majcosta/bch-rpc-explorer

 
 

Repository files navigation

BCH RPC Explorer

npm version NPM downloads

Simple, database-free Bitcoin Cash blockchain explorer, via RPC. Built with Node.js, express, bootstrap-v4.

This tool is intended to be a simple, self-hosted explorer for the Bitcoin blockchain, driven by RPC calls to your own bitcoind node. This tool is easy to run but currently lacks features compared to database-backed explorers.

Live demo available at: https://explorer.bitcoinabc.org

Features

  • Network Summary "dashboard"
  • View details of blocks, transactions, and addresses
  • Analysis tools for viewing stats on blocks, transactions, and miner activity
  • View JSON content used to generate most pages
  • Search by transaction ID, block hash/height, and address
  • Optional transaction history for addresses by querying from ElectrumX and blockchair.com
  • Mempool summary, with fee, size, and age breakdowns
  • RPC command browser and terminal

Changelog / Release notes

See CHANGELOG.md.

Getting started

The below instructions are geared toward BCH, but can be adapted easily to other coins.

Prerequisites

  1. Recent version of Docker
  2. Install and run a full, archiving node - instructions. Ensure that your bitcoin node has full transaction indexing enabled (txindex=1) and the RPC server enabled (server=1).
  3. Synchronize your node with the Bitcoin network.

Instructions

On the project base directory:

docker build -t bch-rpc-explorer .
docker run -p 3002:3002 bch-rpc-explorer --bitcoind-user [rpcusername] --bitcoind-pass [rpcpassword]

If have a mainnet node running with the default datadir and port, this should work. Open http://127.0.0.1:3002/ to view the explorer.

Configuration (Advanced)

Configuration options may be passed as environment variables or by creating an env file at ~/.config/bch-rpc-explorer.env or at .env in the working directory. See .env-sample for a list of the options and details for formatting .env.

You may also pass options as CLI arguments, for example:

docker run bch-rpc-explorer --port 8080 --bitcoind-port 18443 --bitcoind-user [rpcusername] --bitcoind-pass [rpcpassword]

See docker run bch-rpc-explorer --help for the full list of CLI options.

Support

  • bitcoincash:qqeht8vnwag20yv8dvtcrd4ujx09fwxwsqqqw93w88

About

Database-free, self-hosted Bitcoin Cash explorer, via RPC. Built with Node.js, express, bootstrap-v4.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 79.8%
  • Pug 17.6%
  • CSS 2.5%
  • Dockerfile 0.1%