Skip to content

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

License

Notifications You must be signed in to change notification settings

meefs/bsv-explorer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The project was forked to support a private chain that has no historical data.

The following bugs were fixed:

  • Excluding ElectrumX servers from the environment variables no longer produces any errors.
  • The exchange rate service is deprecated and no longer works, an environment variable was added to support this.

You will find a env.sample under the config directory, please rename this to .env or use it as a reference to add your own environment variables.

The following environment variables were added

  • DISABLE_HISTORICAL_DATA
    • If you are using a private chain then its likely you will not have 1 year or more of blocks, so this environment variable should be included and set this to true.
  • DISABLE_EXCHANGE_RATES
    • The exchange rate server has been deprecated and no longer works, these values were originally hard coded. Rather than removing code, I have decided to give an option to disabled it.

WhatsOnChain Blockchain Explorer

Simple, database-free SV 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.

Live demo available at:

Features

  • Browse blocks
  • View block details
  • View transaction details, with navigation "backward" via spent transaction outputs
  • View JSON content used to generate most pages
  • Search supports transactions, blocks, addresses
  • Mempool summary, with fee, size, and age breakdowns

Prerequisites

  1. Install and run a full, archiving node - https://github.com/bitcoin-sv/bitcoin-sv. Ensure that your node has full transaction indexing enabled (txindex=1) and the RPC server enabled (server=1).
  2. Synchronize your node with the Bitcoin network.
  3. "Recent" version of Node.js (8+ recommended).

Instructions

  1. Clone this repo: git clone https://github.com/waqas64/btc-rpc-explorer
  2. npm install
  3. npm run build
  4. Edit the "rpc" settings in app/credentials.js to target your node
  5. Optional: Change the "coin" value in app/config.js.
  6. Optional: Add an ipstack.com API access key to app/credentials.js. Doing so will add a map to the /peers page.
  7. npm start to start the local server
  8. Visit http://127.0.0.1:3002/

Run via Docker

  1. docker build -t btc-rpc-explorer .
  2. docker run -p 3002:3002 -it btc-rpc-explorer

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 52.4%
  • Pug 44.7%
  • CSS 2.2%
  • Other 0.7%