From ad38d7c29d7084d668a59f363ffd598aee0c504b Mon Sep 17 00:00:00 2001 From: Adam Forsyth Date: Sat, 8 May 2021 13:24:51 -0500 Subject: [PATCH 1/3] Small improvements to Claim instructions 1. Add `libunbound-dev` to the list of packages to install on Debian / Ubuntu, needed for me at least to successfully `npm install node-gyp`. 1. Remove specific version numbers from `cd` commands as they're out of date / won't match what people are downloading. 1. Clarify how to check if your key is in the airdrop and add the missing `--bare` option. --- claim/index.html | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/claim/index.html b/claim/index.html index 5b38a62..3875016 100644 --- a/claim/index.html +++ b/claim/index.html @@ -96,15 +96,15 @@

This page explains how github developers with over 15 followers on February 2019, or in the PGP WoT Strong Set can claim HNS. Being able to claim does NOT imply that one is a "top open source developer", this system was optimized for a list of previously scrapeable keys (and could not be modified after the Handshake network launches without a hard fork).

System Setup

Please read through these instructions carefully, as using cryptographic blockchains are a bit unusual.

-

Make sure you have nodejs and npm installed first. On MacOS, please install homebrew and run "brew install node". On debian/ubuntu, you can run "sudo apt-get install nodejs npm build-essential". If you run other distributions or OSes, you can probably figure this part out.

+

Make sure you have nodejs and npm installed first. On MacOS, please install homebrew and run "brew install node". On debian/ubuntu, you can run "sudo apt-get install nodejs npm build-essential libunbound-dev". If you run other distributions or OSes, you can probably figure this part out.

Next, install node-gyp: npm install node-gyp

Download

Download hsd, hs-client, and hs-airdrop from https://handshake.org/download/. If downloaded from github, the directory structure is slightly different (hsd-2.0.2/hsd should be replaced with just hsd in these instructions).

Extract hsd, hs-client, and hs-airdrop: tar xvf hs*

You may also verify the asc file if desired.

Install

-

In one window, change into the hsd directory and install cd hsd-2.0.2/hsd and then run npm install --production

. -

In the second window, change into the hs-client directory and install cd hs-client-0.0.8/hs-client and then run npm install --production

+

In one window, change into the hsd directory and install cd hsd-*/hsd and then run npm install --production

. +

In a second window, change into the hs-client directory and install cd hs-client-*/hs-client and then run npm install --production

Run hsd

hsd is the handshake fullnode and will sync with the network

To connect, in the first window run: ./bin/hsd --log-level info

@@ -115,12 +115,12 @@

To save a copy of your private key, write down the output of the 12 word phrase on a piece of paper (do not save it in the cloud anywhere): ./bin/hsw-cli master | grep phrase

Claim your HNS

In the second window, go to the hs-airdrop directory and install hs-airdrop:

-

cd hs-airdrop-0.7.1/hs-airdrop

+

cd hs-airdrop-*/hs-airdrop

Then install the dependencies: npm install --production

-

Check if your key is in the airdrop. Replace id_rsa with the location of your key you want to check and the hs1XXXX string with the public address you generated earlier. Please see the hs-airdrop README.md file for more information.

-

./bin/hs-airdrop ~/.ssh/id_rsa hs1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

+

Check if your key is in the airdrop. Replace id_rsa with the location of your private key you want to check and the hs1XXXX string with the public address you generated earlier. This will prompt for your key's passphrase if encrypted. Please see the hs-airdrop README.md file for more information.

+

./bin/hs-airdrop --bare ~/.ssh/id_rsa hs1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

This may take a while, as it is trying to find and decrypt a message to your key. If successful you should see a base64 string. A NonceError means your key was not included, you can try another key.

-

If you have a base64 string, you can broadcast it to the network by going back to hs-client (cd hs-client-0.0.8/hs-client) and typing (replace BASE64_STRING with the string dumped from hs-airdrop): ./bin/hsd-cli rpc sendrawairdrop BASE64_STRING

+

If you have a base64 string, you can broadcast it to the network by going back to hs-client (cd hs-client-*/hs-client) and typing (replace BASE64_STRING with the string dumped from hs-airdrop): ./bin/hsd-cli rpc sendrawairdrop BASE64_STRING

You should see it return a hex hash if successful. In an hour or two you should see it propogate over the network. You can see the updated balance by running: ./bin/hsw-cli balance

You can also try searching for your hs1 address balance by googling/searching: hns block explorer in your web browser and pasting in your hs1 address.

Bidding on names

From 48234cddc94a4e76891fcd2500687a78b8463ba3 Mon Sep 17 00:00:00 2001 From: Adam Forsyth Date: Mon, 17 May 2021 19:19:25 -0500 Subject: [PATCH 2/3] Update index.html Remove `and install` where it was unnecessary. --- claim/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/claim/index.html b/claim/index.html index c1ccb3f..690d3ab 100644 --- a/claim/index.html +++ b/claim/index.html @@ -104,8 +104,8 @@

Extract hsd, hs-client, and hs-airdrop: tar xvf hs*

You may also verify the asc file if desired.

Install

-

In one window, change into the hsd directory and install cd hsd-*/hsd and then run npm install --production

. -

In a second window, change into the hs-client directory and install cd hs-client-*/hs-client and then run npm install --production

+

In one window, change into the hsd directory cd hsd-*/hsd and then run npm install --production

. +

In a second window, change into the hs-client directory cd hs-client-*/hs-client and then run npm install --production

Run hsd

hsd is the handshake fullnode and will sync with the network

To connect, in the first window run: ./bin/hsd --log-level info

From cf5b8fa30598e2bfe25817a600af8286439fea0e Mon Sep 17 00:00:00 2001 From: Adam Forsyth Date: Wed, 19 May 2021 21:45:26 -0500 Subject: [PATCH 3/3] Update index.html Add `unbound` as dependency on OSX. --- claim/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/claim/index.html b/claim/index.html index 690d3ab..98eb8d8 100644 --- a/claim/index.html +++ b/claim/index.html @@ -97,7 +97,7 @@

This page explains how github developers with over 15 followers on February 2019, or in the PGP WoT Strong Set can claim HNS. Being able to claim does NOT imply that one is a "top open source developer", this system was optimized for a list of previously scrapeable keys (and could not be modified after the Handshake network launches without a hard fork).

System Setup

Please read through these instructions carefully, as using cryptographic blockchains are a bit unusual.

-

Make sure you have nodejs and npm installed first. On MacOS, please install homebrew and run "brew install node". On debian/ubuntu, you can run "sudo apt-get install nodejs npm build-essential libunbound-dev". If you run other distributions or OSes, you can probably figure this part out.

+

Make sure you have nodejs and npm installed first. On MacOS, please install homebrew and run "brew install node unbound". On debian/ubuntu, you can run "sudo apt-get install nodejs npm build-essential libunbound-dev". If you run other distributions or OSes, you can probably figure this part out.

Next, install node-gyp: npm install node-gyp

Download

Download hsd, hs-client, and hs-airdrop from https://handshake.org/download/. If downloaded from github, the directory structure is slightly different (hsd-2.4.0/hsd should be replaced with just hsd in these instructions).