Skip to content

helikon-labs/chainviz

Repository files navigation

Quality Gate Status

Chainviz is a real-time 3D chain visualization of the Polkadot machinery.

You may find the release article on Medium.

Chainviz visualizes the following elements of the Polkadot and Kusama relay chains and validators in real-time:

  • Active validators in a 3D representation and list format.
  • Block production process.
  • Block list, and block contents on click.
  • Parachains, and their assigned validators.
  • Recent XCM transfer messages, and message contents (powered by Polkaholic API).
  • Basic network and staking data.
  • Validator details panel, where the user can observe the validator in real-time.

Chainviz uses the services provided by the SubVT backend, part of SubVT, a project supported by the Kusama Treasury and W3F Grants.

Please view the alpha version repository here.

Build & Run

Development

Follow the commands below to run the application in development mode with live code update.

git clone https://github.com/helikon-labs/chainviz.git
cd chainviz
npm install
npm run dev

Application is going to be available at port 8080.

Docker

You can build and run the Docker image locally by running the following commands:

git clone https://github.com/helikon-labs/chainviz.git
cd chainviz/docker
docker build -t helikon/chainviz:1.0.1 --no-cache -f ./chainviz.dockerfile ..
docker run --name chainviz -p 8080:8080 -d helikon/chainviz:1.0.1

Application is going to be available at port 8080.

If you'd like to use the existing image from Helikon on Docker Hub, then please use the following commands:

docker pull helikon/chainviz:1.0.1
docker run --name chainviz -p 8080:8080 -d helikon/chainviz:1.0.1

Test

Please view TEST.md for testing details.