Skip to content
KHS Blockchain Browser
Branch: master
Clone or download
walmon and peterhle Support for TLS (#9)
* feat: ignore .history folder vscode and .env root

Signed-off-by: walmon <walmon93@hotmail.com>

* docs: instructions for TLS

Signed-off-by: walmon <walmon93@hotmail.com>

* feat: plumbing for TLS

Signed-off-by: walmon <walmon93@hotmail.com>

* fix: no env vars were loaded

Signed-off-by: walmon <walmon93@hotmail.com>

* fix: read json net profile

Signed-off-by: walmon <walmon93@hotmail.com>
Latest commit 20ca65a Mar 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode enabled multi channel support Aug 26, 2018
app
hfc-key-store initial commit Aug 16, 2018
images image update Sep 12, 2018
ui updated select channel placeholder message Jan 25, 2019
.gitignore Support for TLS (#9) Mar 22, 2019
.python-version documentation Sep 3, 2018
LICENSE Initial commit Aug 16, 2018
README.md Support for TLS (#9) Mar 22, 2019
app.js Clean up for local development to work Jan 15, 2019
block.json initial commit Aug 16, 2018
config.js
latestblock.js initial commit Aug 16, 2018
package-lock.json Support for TLS (#9) Mar 22, 2019
package.json
runApiServer.sh web socket api fix Oct 9, 2018

README.md

khs-blockchain-browser

The KHS Blockchain Browser is an open source analytics tool that gives developers and operators of Hyperledger blockchain networks real-time visibility into transactions and blocks as they are added to a HLF network.

Blockchain Browser is a React/Node.js web application with which a persistent database is not required. The Blockchain Browser "browses" the block store directly using the Fabric Node.js SDK.

View a three-minute video of the Blockchain Browser in action here.

Give a LIVE version a try, here's a link to a browser deployed to Heroku and pointing to a reference Hyperledger Fabric reference network here

Please see below for installation and startup instructions.

Screenshots

Real-time Block Information

Real-time Blockchain Metrics

Requirements

  • Node 8.9.x or above
  • Windows OS Only - Python 2.7+ (v3+ not supported)
  • Windows OS Only - For 'rm' and 'cp' commands, use Powershell or add Git to PATH (C:\Program Files\Git\usr\bin) or install Cygwin.
  • Access to HyperLedger Fabric network. Here's an example: khs-lab-results-blockchain

Note: Two useful tools for managing Node and Python versions are nvm and pyenv.

Installation

  1. Clone repo
  2. Install server and UI JavaScript modules
    $ npm install
    $ cd ui
    $ npm install
    $ cd ..
  1. The current keystore has credentials for the Hyperledger example networks. You can access other networks by modifying the config.js so that the network_url property points to a peer node address and an admin USERID property references an admin user and public/private keys located in the hfc-key-store folder.
    module.exports = {
        port: process.env.PORT || 4001,
        host: process.env.HOST || "localhost",
        loglevel: process.env.LOGLEVEL || "info",
        wallet_path: process.env.KEYSTORE || "../hfc-key-store",
        user_id: process.env.USERID || "PeerAdmin",
        network_url: process.env.NETWORK_URL || "grpc://localhost:7051",
        network_profile: process.env.NETWORKPROFILE || '',
        peer_pem: process.env.PEER_PEM || ''
    }

Here is an example public/private and user file in the hfc-key-store directory.

  1. Start the API Server and UI server with the following commands:
    $ ./runApiServer.sh 
    $ npm run start:dev 
  1. Browse to http://localhost:8080.

Note: to change the port, edit file ./ui/package.json.

Using TLS

These three variables are used to enable TLS with the targeted peer (put them in a .env file in the root and replace the values for your network's):

NETWORKPROFILE=../connection/networkprofile.json
PEER_PEM=-----BEGIN CERTIFICATE-----\nMIICb...
SSL_TARGET_NAME_OVERRIDE=peer1...

Be sure to also replace the files in the folder ./hfc-key-store with your keys.

Feedback

Please let us know if you have questions - asktheteam@keyholesoftware.com.

We at Keyhole are working to add new features all the time and would love your feedback.

You can’t perform that action at this time.