Hardware Provider Onboarding
Register as a hardware provider for Coqnet.
Last updated
Register as a hardware provider for Coqnet.
Last updated
This guide is part of a series covering the end-to-end process of participating in Coqnet as a hardware provider. It walks you through setting up your environment, generating node keys, securely backing them up, and uploading them to the GoGoPool Provider Manager.
This guide is intended for developers familiar with Linux-based systems and command-line operations.
Before proceeding, ensure the following dependencies are installed on your system:
1.22 or higher: Required to build Tartarus.
C Compiler ( or ): Necessary for building dependencies.
: A lightweight JSON processor used by the scripts.
Run the following command to install Go 1.23 on your system, if not already installed:
For detailed installation instructions, refer to the .
Run the following commands to install the necessary packages:
Follow these steps to install it:
After successful compilation, you should see the tartarus
executable in your current directory.
Node keys are cryptographic credentials used to operate Coqnet nodes. These keys enable secure communication, authentication, and participation in consensus mechanisms. Each node requires a unique set of keys, which are stored in a nodes.json
file.
The nodes.json
file contains the following values for each node:
node_id
: Unique identifier for the node.
cert
: TLS certificate for secure communication.
key
: Private key corresponding to the TLS certificate, used for authentication.
bls_private
: Private key for Boneh-Lynn-Shacham (BLS) signatures.
bls_public
: Public key corresponding to the bls_private
key.
bls_signature
: BLS cryptographic signature used for validation purposes.
To generate these keys, follow the steps below:
Run the following command using the Tartarus executable:
Replace <number_of_nodes>
with the number of nodes allocated to you. For example, if you are allocated to run 5 nodes, replace <number_of_nodes>
with 5
.
Replace <your_prefix>
with your assigned prefix. This prefix ensures uniqueness across the network.
The -o
flag specifies the output file (nodes.json
) where the generated keys will be stored.
Note: The GoGoPool team will provide your assigned prefix and the number of nodes (allocated number).
Note: Key generation may take some time depending on the number of keys. With prefixes, it typically takes around 1 second per key.
Do not use the same keys on both Avalanche mainnet and Fuji testnet. Always generate new keys for each network to ensure security and isolation.
Securing your node keys is critical to maintaining the integrity of your participation in Coqnet. Here are some best practices to follow:
Store Keys Offline
Copy the generated nodes.json
file to a secure, offline location.
Secure the Backup
Use encryption tools like gpg
or BitLocker to protect the backup.
Limit Access Ensure only authorized personnel have access to the backup.
To upload your keys and participate in Coqnet, youβll need to create an account with GoGoPool.
After signing up, youβll need to upload your keys to the GoGoPool Provider Manager.
By following this guide, youβve successfully generated, backed up, and uploaded your node keys to the GoGoPool Provider Manager.
For instructions on running a Coqnet node, see the Running a Coqnet Node on Avalanche guide.
is a NodeID and key generation tool that simplifies the creation of node keys for Coqnet. Tartarus generates node IDs with customizable prefixes and saves them in a JSON file compatible with AvalancheGo.
Clone the Tartarus repository from :
After successful signup, check your email for a verification link and verify your account. The email should be from . If you donβt receive the verification email, do not forget to check your spam folder.
Once verified, message , our GoGoPool representative, on Telegram with your email and organization name. He will add your organization to the database, enabling you to upload your keys.
The keys generated by Tartarus need to be transformed into a format compatible with , the client software for running Coqnet nodes.
If you encounter any issues, refer to the provided scripts or reach out to GoGoPool support for assistance on or Live Support Chat on the .