Connect headless wallet to testnet

Goal

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

Requirement

Hathor headless wallet $\ge$ v0.26.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 \
  hathornetwork/hathor-wallet-headless \
  --seed_default '<24_words_seed_phrase_string>' \
  --network testnet \
  --server https://node1.testnet.hathor.network/v1a/

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

Currently, the faucet for Hathor Network's testnet is unavailable. As a result, to obtain HTR tokens for testing your use case on testnet, please send a private message to a Hathor team member on Hathor Discord server.

In your message, say "Hello, I have a use case and need HTR tokens for testing it on testnet. Could you please send X HTR tokens to <your_address>?", replacing <your_address> with the address on testnet you want to receive the tokens.

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.