How to get your toes wet in v0.9 software



I’m Bruce and I am a NKN-holic. I’m not a developer, but I like to tinkle with the latest and greatest technology. Yesterday, NKN announced that v0.9 Beluga is released. Even though there is NO mining reward for v0.9 (the chain data can be reset to zero at any time), I decided to try it out just for fun. If you are like me, please read on.

I have about 10 nodes running v0.8.1-alpha on DigitalOcean. So I decided to migrate one of them for trying out v0.9. This particular node was created using ChrisT’s tutorial.

After SSH into my DO node as root, I first stop the nknd:

systemctl stop nkn.service

Then I switch to user nkn:

su - nkn
cd /home/nkn/go/src/

I switch to v0.9 branch, and check to make sure:

git checkout v0.9
git branch

You should see something like this on display:

[email protected]:/home/nkn/go/src/ git branch
* v0.9

Before updating the software, it is important to back up your wallet.dat and config.json. Both will change between v0.8.x testnet and v0.9 mainnet:

mv wallet.dat wallet.dat.08
mv config.json config.json.08

Then you do the usual commands to upgrade the software to latest v0.9:

git pull
make deepclean
make vendor

The new config.testnet.json will provide the seed nodes for v0.9 testing:

cp config.testnet.json config.json

It will look like this:

  "HttpWsPort": 30002,
  "HttpJsonPort": 30003,
  "SeedList": [
  "GenesisBlockProposer": "040149c42944eea91f094c16538eff0449d4d1e236f31c8c706b2

You will need to create a new wallet in v0.9:

nknc wallet -c

And you can see that the wallet address now starts with “NKN” instead of just “N”:

Address                             Public Key

-------                             ----------

NKNUL7aqaB7jfm53KqrauPgsHQtjZRnjSUpU  0441b73a9482282f552b264eb98e38b1bcaf88bbc876fe8f06666e31fac1c09577

Switch back to root user and restart the nknd:

systemctl restart nkn.service

After the nknd is running again, you can again switch back to nkn user and check how it is running with nknc:

su - nkn
nknc info -s

You can check if your v0.9 node is running properly. You can see the below info. One thing is a little bit confusing: the version said v0.8.0-alpha-75-g4077, but trust me, it is indeed v0.9. NKN core dev team cannot tag it into v0.9 yet, because that will trigger a massive auto-update for all the 1-click nodes out there. Not yet.

[email protected]:~/go/src/$ ./nknc info -s
	"id": "1",
	"jsonrpc": "2.0",
	"result": {
		"addr": "tcp://",
		"currTimeStamp": 1554159243,
		"height": 18479,
		"id": "19b282eaaed5894e25a41192162a397a34532e5598334f58e34c5a10f2ad8125",
		"jsonRpcPort": 30003,
		"proposalSubmitted": 0,
		"protocolVersion": 1,
		"publicKey": "0441b73a9482282f552b264eb98e38b1bcaf88bbc876fe8f06666e31fac1c09577",
		"relayMessageCount": 0,
		"syncState": "PersistFinished",
		"uptime": 337,
		"version": "v0.8.0-alpha-75-g4077",
		"websocketPort": 30002

And check if you have mined anything on v0.9:

nknc wallet -l balance

And you should see something like this. No mining reward yet :disappointed_relieved:

	"id": "1",
	"jsonrpc": "2.0",
	"result": {
		"amount": "0"

Happy news is that you can even see your v0.9 node on, under node manager. You can clearly see your node sw version and block height are totally different from the v0.8.x testnet nodes.
Have fun!

1 Like

Two blocks (30 NKN) in about 6 hours, not bad!

./nknc wallet -l balance

"id": "1",
"jsonrpc": "2.0",
"result": {
"amount": "30"

Tip for cloning only the v0.9 branch with single command without the need to checkout.

git clone -b v0.9 --single-branch


For those getting “error: pathspec ‘v0.9’ did not match any file(s) known to git.” run the following command

git fetch


I decided to upgrade a Hetzner node to 0.9 to compare its performance with my LTE 0.9 node. I believe I did everything according to this guide, but faced a problem.

Command make vendor gives me first:
[WARN] Lock file may be out of date. Hash check of YAML failed. You may need to run ‘update’

Then later:

[INFO] --> Fetching updates for
[WARN] Download failed.
[ERROR] Update failed for Unable to update repository: exit status 255

[WARN] Download failed.
[ERROR] Update failed for Unable to update repository: exit status 128
[ERROR] Failed to install: Unable to update repository: exit status 255

Unable to update repository: exit status 255
Unable to update repository: exit status 128
Makefile:52: recipe for target ‘vendor’ failed
make: *** [vendor] Error 1

What might be the reason?


It seems that you met errors when glide fetch dependent 3rd package from

Maybe below clues can help you:


Thanks! They did not help, so I gave up. I cannot spend too much time on this.

Is there instructions to install a 0.9 node from scratch somewhere?


Hi, I had the same problem when I was building the latest v0.9, but figured out a way.

Root cause: glide and some dependency has changed, causing errors.

Solution: clean up the glide cache for package repository and info. Go in as root:

cd /home/nkn/.glide/cache/src
rm -Rf *

Redo the same procedure:

make deepclean
make vendor

And voila, my node is built properly (v0.8.0-alpha-117-ga1e2), and joined v0.9 testnet happily and PersistFinished.


Worked fine now, thanks!