Wallet Setup

This guide will show you how to create, manage, and interact with your HTND wallet using the htnwallet command-line tool.

Prerequisites:

Building HTND wallet tool from source. View guide: (Windows) / (Linux)

Creating a New Wallet

Open a terminal window.
Run the following command to create a new HTND wallet:

htnwallet create

This command will generate a new wallet file and prompt you to set a strong password for security. Remember to keep your password confidential, as it protects your wallet and the HTND coins within.

Starting the Wallet Daemon

The htnwallet tool requires a daemon process to run in the background for wallet operations.

Use the following command to start the daemon:

htnwallet start-daemon

This will initiate the wallet daemon in the background, allowing you to interact with your wallet using other htnwallet commands.

Generating a New Address

To receive HTND coins, you'll need an address. Use the following command to generate a new receiving address:

htnwallet new-address

This command will display your new HTND address in the terminal. You can share this address with anyone who wants to send HTND coins to your wallet.

Backup your Wallet

There is a command to backup your wallet with a seed phrase. You can view your seed phrase with the following command:

htnwallet dump-unencrypted-data

This command will ask for the password you used when you created your wallet. It will give you 24-words which you should write down to recover your wallet in the future. Be sure that you are in a safe place where nobody can see your screen to steal your seed phrase.

Recover Wallet

There is a command to recover your wallet using your seed phrase. You can input your seed phrase by using the following command:

htnwallet create –import

You’ll be asked for the seed phrase. Enter it as it was given to you from the backup command. A new digital wallet will be created with the seed words and you will be asked to enter a new password.

Sending coins

To send coins to some public address you can use the following command:

htnwallet send -v coin_amount -t recipient_address

Replace coin amount with the amount of coins you are sending. Replace recipient address with the recipient address

Example (all on one line):

htnwallet send -v 1000 -t hoosat:qrzpkfml894ap29rphh77euv9xn5x9znkjdk65p4ngjfypr9encj6yy6cwz4g

Once you enter the command, it will ask for your wallet password. Once you type your password it will send the coins to the the address. Be sure that you are entering in the correct address as this transaction is irreversible.

Checking balance

In order to check your balance you must first:

Make sure your node is running and synced. You need the node to be up-to-date in order to see your latest balance. If you have not gone through this step, follow steps to setup a node: (Windows) / (Linux)
Open up another terminal and start the Wallet Daemon. You must make sure the wallet daemon is running for it to listen for commands
Open up another terminal and input wallet commands. This is the final terminal where you will interact with your wallet

In each of these steps you must always direct the terminal to where your htnwallet file resides

For example:

cd c:\Users\MrPixels\Go\bin

Commands:

Start the wallet daemon.

htnwallet start-daemon

Show wallet balance

htnwallet balance

Show wallet balance and any pending transactions

htnwallet balance -v

Important Notes:

It's crucial to back up your wallet. This ensures you can recover your funds if your system crashes or you lose access to your primary device.
Always double-check recipient addresses before sending HTND coins to avoid sending them to incorrect addresses. Transactions on the blockchain are irreversible.
Consider using a strong password manager to store your wallet password securely. By following these steps and familiarizing yourself with the available commands, you'll be able to effectively manage your HTND wallet on your system.
Refer to the official Hoosat Network documentation (if available) for more advanced usage and troubleshooting information

For feedback or support join the Discord: discord.gg/Vwt93bBDTB