RC1 Testnet - Build from Source Mac OS (Intermediate Level)

In order to increase security and stability of the Main Chain, rigorous RC1 load testing must be conducted. To achieve this, we need to simulate a load on the network. This load is important, as it will expose any instabilities or flaws in the system, so they can be reviewed and updated.


The following is a detailed explanation on how to participate using a Mac OS system — provided by the Hybrid Network team. There are 3 parts. The first is how to create a node on the testnet itself, the second is how to participate in staking and mining, and lastly is a set of important links to report any bugs which are found.


Please note that these instructions require the use of command lines, which requires some skill.


What does Testnet mean?


A Testnet is a functioning model of a Mainnet. Developers use this to introduce a protocol whilst testing for bugs, and as a trial period before new implementations. Unlike a Mainnet, Testnets utilize a “faucet”, which provides free tokens. The availability made possible by the faucet allows for users to stress the system to simulate a high-volume environment.


Why is it important?


By mimicking this type of scenario, developers can determine benchmarks that point to the max capacity of the proposed Mainnet prior to launch. If not optimal, developers can make adjustments prior to the ecosystem going live to prevent disruption and provide additional security.


How to participate in the Testnet?


Please follow the instructions below to build from source.


Video Guide (Mac OS)


Hx Testnet Build from Source Mac OS Part 1


Hx Testnet Build from Source Mac OS Part 2



Written Instructions to Build from Source (Mac OS)


Download the most recent version of Go at https://golang.org/dl.



Select the appropriate operating system to build from source with.


Intermediate Level — Step 1 (Mac OS)


Open the Go file and install.



After installing Go, visit to https://git-scm.com/downloads. Click on Mac OS X to download the install file for git. Open the package and install.


**If you get a message that says it cannot be opened then go to System Preferences → Security & Privacy → and then click on “Open Anyways”. Confirm by pressing open and install git.**



Now open a Terminal window. On OS X, open your Applications folder, then open the Utilities folder. Open the Terminal application. Type the following commands:


(Use Shift + the \ key to create a | character)


mkdir $HOME/go

mkdir $HOME/go/src

mkdir $HOME/go/bin

mkdir $HOME/go/src/github.com

mkdir $HOME/go/src/github.com/hybridnetwork

export GOPATH=$HOME/go

export PATH=$GOPATH/bin:$PATH

curl https://glide.sh/get | sh

cd HOME/go/src/github.com/hybridnetwork

git clone https://github.com/hybridnetwork/hxd

git clone https://github.com/hybridnetwork/hxwallet

cd hxd

glide install

go install $(glide nv)

cd ..

cd hxwallet

glide install

go install $(glide nv)



Running a Test Node


Open up a new Terminal window. Enter the following commands:


export GOPATH=$HOME/go

export PATH=$PATH:$HOME/go/bin

hxd -u user -P pass --testnet


The node (hxd) has been created, leave this window running.



Creating a Wallet


Open up a new Terminal window. Type the following commands:


export GOPATH=$HOME/go

export PATH=$PATH:$HOME/go/bin

hxwallet -u user -P pass --create


Type a priv passphrase for your new wallet and press Enter.


Type the same priv passphrase again and press Enter to confirm.


** For the purposes of testing, press Enter on the next two lines to choose default options**



***IMPORTANT*** WRITE your wallet information down. It contains your wallet generation seed and Hex, which will be needed if you want to recover your wallet.


Running your Wallet


In the same Terminal window, enter the following command:


hxwallet -u user -P pass --testnet


Leave this window running.



Testing your Wallet


Open up a new Terminal. Enter the following commands:


export GOPATH=$HOME/go

export PATH=$PATH:$HOME/go/bin

hxctl -u user -P pass --testnet --wallet getnewaddress default




hxctl -u user -P pass --testnet --wallet getnewaddress postquantum


This will generate a Default or Post Quantum address. Copy this address to your clipboard.



Using the Faucet and Block Explorer


Open up your web browser. Navigate to http://faucet1.hybrid.network. Paste your wallet address into the space provided and press send. You will receive a transaction id (txid).



Open up a new tab in your web browser. Navigate to http://explorer1.hybrid.network. 



Paste your wallet address into the search bar at the top and press enter. Refresh if you do not see that your wallet has received Testnet tokens. It may take up to 5 minutes for your transaction to show and up to another 5 minutes to complete. Feel free to relax and stretch during this time and refresh your browser until it looks like this.



**Depending on the difficulty and hashrate on the Tesnet, this may take longer depending on the size mempool**

You can click on the blue down arrow to get more information on the transaction.

Congratulations! You should now have 2 coins. Now you can verify the transaction in the Terminal.


Return to the Terminal window that you are currently using and type:


hxctl -u user -P pass --testnet --wallet getreceivedbyaddress walletaddresshere



You can also get a detailed view of your wallet and balance by entering:


hxctl -u user -P pass --testnet --wallet getbalance



You now have a running node and a Command-line wallet for Hx! If you’re interested in going to the next level, please see our instructional guide on staking and mining through Command-line.

RC1 Testnet — Staking and Mining through Command-line Mac OS (Advanced Level)


Bug Reporting

Report bugs using integrated tracking in GitHub. Please follow the corresponding links. When reporting bugs please include as much information as possible, but not limited to the date, summary of the issue encountered, and suggested workaround.



hxd — Hx daemon in Go (golang).github.com


hxwallet — Hx wallet daemon written in Go (golang).github.com


hxify — Cross-platform GUI for Hx.github.com


testnetfaucet — Hx testnet faucet.github.com


hxstakepool — Stakepool for Hx.github.com

Block Explorer

insight — Hx blockchain API for web wallets.github.com