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)
curl https://glide.sh/get | sh
git clone https://github.com/hybridnetwork/hxd
git clone https://github.com/hybridnetwork/hxwallet
go install $(glide nv)
go install $(glide nv)
Running a Test Node
Open up a new Terminal window. Enter the following commands:
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:
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:
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)
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
insight — Hx blockchain API for web wallets.github.com