Goals of Heimdall:
- Everyone should have the opportunity to operate a stake pool.
- Maintaining a stake pool should be as easy as possible. Things that can be automated should be automated.
- Operating system independent creation of stake pools.
- Discussion base to find the optimal configuration and to collect knowledge.
If you already have one and just want to operate it, you can skip this step.
- Install Docker https://docs.docker.com/get-docker/
- Create creator docker image
./make-creator.sh
. You only need to run this script when you change something at the creator (e.g. updating the repository). - Create stake pool with
./create-stakepool.sh
. The script will guide you through the process to define the stake pool configuration. The created stake pool will be stored understakepools/stakepool-<TICKER>
. - Upload to the incentivized-testnet-stakepool registry. There you need to add the created dictionary under
stakepools/stakepool-<TICKER>/registry/
and create a pull request.
File | Description |
---|---|
operator/ |
Blueprint to create and use the operator docker image. |
registry/ |
If you create a stakepool you need to register the contents at incentivized-testnet-stakepool. |
node_secret.yaml |
Needed to run the stake pool. |
owner.pub |
The owner wallet public key. |
owner.prv |
The owner wallet private key. Never share. |
owner.addr |
The owner wallet address. |
stake_pool.id |
The stake pool id. |
After you created a stakepool you can also operate it with Heimdall.
- Install docker-compose (https://docs.docker.com/compose/install/)
- Build the operator docker image with
cd stakepools/stakepool-<TICKER> && ./build-operator.sh
- Replace
<YOUR_DOCKER_IMAGE>
indocker-compose.yaml
with the name of your created docker image. - Start the stakepool with
docker-compose up
Now the stakepool is running. You can check the status with ./jcli rest v0 node stats get --host "http://127.0.0.1:3100/api"
.
This project was heavily inspired by organicdesign.com.