Skip to content

Releases: Meshbits/khoji

Khoji v0.0.1

20 Feb 13:51

Choose a tag to compare

Khoji v0.0.1 Pre-release
Pre-release

Getting started with Khoji Explorer

To get started, you only need

Follow instructions from RethinkDB docs to install it for your platform.

Download and unzip Khoji explorer files.

Troubleshooting for MacOS

On MacOS if you see a message like “khoji” can’t be opened because Apple cannot check it for malicious software. when you execute ./khoji and the binary gets killed after you click OK for the prompt, then follow these steps:

  • Go to Systems Preferences > Security & Privacy
  • Click on General tab
  • If you see a message there like "khoji" was blocked from use because it is not from an identified developer. with a button Allow Anyway, then Allow it.

Now try executing the ./khoji executable from command line and and it should work as expected.

Running Khoji

First start RethinkDB database with command rethinkdb.

This will make RethinkDB console accessible on http://localhost:8080.

Once RethinkDB database is ready, execute the following command to setup a database for Khoji explorer with the following command:

./khoji -setupdb vrsctest

This will create database and tables needed by Khoji explorer.

Assuming you already has VRSCTEST running on your local machine, execute the following command to start syncing Khoji explorer with the VRSCTEST blockchain:

./khoji -chain VRSCTEST -dbname vrsctest

This will start updating Khoji explorer database with the VRSCTEST blockchain data sets. You will also see sync progress in console output. If you want to see bit more detailed logs, you can check khoji.log file in the same directory where you executed ./khoji command from.

tail -f ./khoji.log

To terminate khoji executable process, press CTRL+C on your keyboard.

If you restart ./khoji executable again, it will resume sync process from where it had stopped previously.

At the moment, it is recommended to let the sync process finish from start to latest and not cancel the process in between. There can be unknown bugs canceling the process in between, so please report if you find any odd behaviour.

Some block explorer APIs are accessible with this format:

http://localhost:3334/api/network
http://localhost:3334/api/balance/{address}
http://localhost:3334/api/transactions/{address}
http://localhost:3334/api/transactions/last
http://localhost:3334/api/transaction/{hash}
http://localhost:3334/api/block/{height}
http://localhost:3334/api/blocks/{page}
http://localhost:3334/api/blocks/last
http://localhost:3334/api/identity/{hash}
http://localhost:3334/api/identities/{page}
http://localhost:3334/api/richlist/{page}