Connect headless wallet to testnet

Goal

This article will guide you to connect Hathor headless wallet to testnet.

Requirement

Hathor headless wallet $\ge$ v0.41.0

Step-by-step

1. Configure headless wallet to connect to testnet.
2. Obtain HTR tokens on testnet.

Step 1: configure headless wallet to connect to testnet

Source code

If you installed your headless wallet from source code, follow these substeps:

1. Start a shell session.
2. Change the working directory to <absolute_path_headless>/hathor-wallet-headless/src replacing the <absolute_path_headless> to where you installed the application.
3. Open the config.js file.
4. Set testnet as the value for the network key, and 'https://node1.testnet.hathor.network/v1a/' as the value for the server key:

hathor-wallet-headless/src/config.js

module.exports = {

  ...

  network: 'testnet',
  server: 'https://node1.testnet.hathor.network/v1a/',

  ...

};

5. Restart the application as usual.

Note that your headless wallet will connect to a public full node on testnet. Now, if you want to operate your own full node see Installation of Hathor full node, and set server with your full node's URL.

Docker container

If you installed your headless wallet as a Docker container, follow these substeps:

1. Start a shell session.
2. Start the headless wallet as usual, setting --network and --server as follows:

docker run \
  -it -p 8000:8000 \
  -e HEADLESS_SEED_DEFAULT \
  hathornetwork/hathor-wallet-headless \
  --network testnet \
  --server https://node1.testnet.hathor.network/v1a/

:::warning Do not pass seed phrases as command-line arguments

Passing --seed_default '<seed_phrase>' inline exposes your seed phrase in shell history, in process listings (ps aux), and in Docker container inspection output. Instead, export the seed as an environment variable in the current shell and let Docker read it:

read -rs HEADLESS_SEED_DEFAULT && export HEADLESS_SEED_DEFAULT

read -rs reads the value without echoing it to the terminal or writing it to shell history. For production deployments, use a secrets manager rather than environment variables.

:::

Note that your headless wallet will connect to a public full node on testnet. Now, if you want to operate your own full node see Installation of Hathor full node, and set --server with your full node's URL.

Docker compose

If you installed Hathor headless wallet along Hathor full node with Docker compose, follow these substeps:

1. Start a shell session.
2. Change the working directory to where you installed the applications.
3. Open the docker-compose.yml file.
4. Set the environment variables HATHOR_TESTNET and HEADLESS_NETWORK to true:

<absolute_path_hathor_installation>/docker-compose.yml

services:
  hathor-core:
    image: <docker_image_id>
    ...
    environment:
      - HATHOR_TESTNET=true
      ...
  hathor-wallet-headless:
    image: <docker_image_id>
    ...
    environment:
      ...
      - HEADLESS_NETWORK=testnet
      ...

5. Restart the applications as usual.

Step 2: obtain HTR tokens on Testnet

The faucet for Hathor Network's can be accessed at https://faucet.testnet.hathor.network/. You can use this faucet to obtain HTR tokens on testnet for free using your testnet wallet address.

Keep in mind the following resources to connect your wallet to the testnet:

• Fullnode: https://node1.testnet.hathor.network/v1a/
• Tx Mining Server: https://txmining.testnet.hathor.network
• Explorer: https://explorer.testnet.hathor.network
• Explorer-service: https://explorer-service.testnet.hathor.network

Task completed

You now have a running instance of Hathor headless wallet on testnet. For how to operate and use this application, see Hathor headless wallet pathway.