The purpose of this tutorial is to walk through the steps necessary to set up a masternode with Hellar Platform services.

Prerequisites

• Docker (v20.10.0+) and docker-compose (v1.25.0+) installed
• An installation of NodeJS (v20, NPM v8.0+)

The following is not necessary for setting up a local network for development, but is helpful if setting up a testnet masternode:

• Access to a Linux system configured with a non-root user (guide)

📘

More comprehensive details of using the dashmate tool can be found in the hellarmate README.

Use NPM to install hellarmate globally in your system:

npm install -g hellarmate

Local Network

Hellarmate can be used to create a local network on a single computer. This network contains multiple nodes to mimic conditions and features found in testnet/mainnet settings.

📘

Hellarmate local networks use the regtest network type so layer 1 blocks can be easily mined as needed.

Setup

Run the following command to start the setup wizard, then accept the default values at each step to create a local network:

hellarmate setup local

Example (partial) output of the setup wizard showing important information:

✔ Initialize SDK › HD private key: tprv8ZgxMBicQKsPfLTCjh8vdHkDHYM369tUeQ4aqpV9GzUfQyBKutfstB1sDfQyLERACTEYy5Qjph42gBiqqnqYmXJZZqRc4PQssGzbvwJXHnN ✔ Register HPNS identity › HPNS identity: 6whgUd1LzwzU4ob7K8FGCLV765K7dp2JbEmVgdTQEFxD ✔ Register HPNS contract › HPNS contract ID: EpCvWuoh3JcFetFY83HdwuzRUvwxF2hc3mU19MtBg2kK ✔ Obtain HPNS contract commit block height › HPNS contract block height: 5 ✔ Register top level domain "hellar" ✔ Register identity for Hellarpay › Hellarpay's owner identity: 2T7kLcbJzQrLhBV6BferW42Jimb3BJ5zAAore42mfNyE ✔ Register Hellarpay Contract › Hellarpay contract ID: EAv8ePXREdJ719ntcRiKuEYxv9XooMwL1mJmPHMGuW9r ✔ Obtain Hellarpay contract commit block height › Hellarpay contract block height: 15 ✔ Register Feature Flags identity › Feature Flags identity: 8BsvV4RCbW7srWj81kgjJCykRBF2rzyigys8XkBchY96 ✔ Register Feature Flags contract › Feature Flags contract ID: JDrDAGVqTWsM9k7KGBsSjcyC11Vd2UdPxPoPf4NzyyrP ✔ Obtain Feature Flags contract commit block height › Feature Flags contract block height: 20

📘 Make a note of the key and identity information displayed during setup as they may be required in the future.

Operation

Once the setup completes, start/stop/restart the network via the following commands: