Node Operators
User Manual for Node Operators
Please note that Node Operation is currently permissioned to select node operators and is not available to the public at this time. Availability for new operators will continuously be assessed as we progress through Open Testnet towards Mainnet launch.
Introduction
Welcome to Supra! This manual will guide you through the process of setting up and operating a node on our blockchain network for our inaugural Testnet. Our system leverages Docker for ease of deployment and a Chrome extension wallet for managing your test tokens.
Prerequisites
Ensure you are a member of our Supra Discord Testnet Communication Channel
Ask the Supra team in Discord channel to grant read access to the Validator node image repository.
Install Docker Engine or Docker Desktop on your machine using the following https://docs.docker.com/engine/install/.
You might need to follow the post installation steps (https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) too.
Install Google Cloud CLI (gcloud CLI) using this https://cloud.google.com/sdk/docs/install#linux.
Install wget, shasum and jq.
Run the following commands to authorize gcloud and Docker to pull the image from the image repository:
gcloud auth login
gcloud auth configure-docker asia-docker.pkg.dev
Minimum Hardware Requirements:
Cores: 32
RAM: 64G
CPU: Intel Xeon (or) AMD EPYC CPU @ 3.2GHz speed or higher
Architecture: x86/64
Disk Type: SSD
Minimum Disk Size: 2TB
Network Bandwidth: 2 Gbps or more
The onboarding process has been divided into 5 phases.
Select Phase I - Generate Operator Keys
smr and validator (SK, PK) are generated.
Operator keys are uploaded to the node-Ops data repo.
Select Phase II - Perform Signing Operation
Supra_committee.json is signed.
The generated signature will need to be uploaded to the nodeOp data repo.
GenesisBlob is created and required to start the node.
Node and Grafana services are started.
Step 1: Download the Onboarding Script
Ensure youβve installed prerequisites `wget` as per your OS distributions.
Step 2: Executing the Onboarding script
Run the script
An example of successful execution
Command:
More Information on Prerequisites
The script will check the installation of the following on your machine
expect
gCloud
gcloud auth login
gcloud auth configure-docker asia-docker.pkg.dev
Docker
toml-cli
Openssl
Zip
Make sure, to not run the script with the root user.
If all checks are successful then it will show All Checks Passed: β
Output:
And since all of you have completed Phase 1 and 2 already, let's begin directly from Phase 3.
Select Phase III - Create Genesis Blob
Note:
Please start phase 3, once announced by Supra Team on Discord.
Make sure you are on the root path where the onboarding_round_6.sh script is present
Command :
Command :
Note: Make sure you have run the above commands before starting the script to avoid the issue at the time of running.
Command :
Output:
Now Enter 3 to enter into Phase3
Note : Make sure that you donβt exit the process, as generating genesis will take at least 40 minutes
Output:
Enter the following GitHub zip file link:
Output:
Select Phase IV - Start the node and other services
Note: Make sure you are on the root path where the onboarding_round_6.sh script is present
Command :
Output:
Now Enter 4 to enter into Phase4
Output :
Select Your System Type: 1 (Ubuntu/Debian Linux) or 2 (Amazon Linux/Centos Linux)
Output :
Enter Your "y" to Confirm
Output :
Enter Your e-mail for Dashboard Access: "Your Email Id for the Grafana"
Output :
Note: To check the logs, we need to exit the script by pressing Enter.
Output:
Now press 6 to exit the script.
Select Phase V - Restart the network using a snapshot
Note: Make sure you are on the root path where the onboarding_round_6.sh script is present
Output:
Now Enter 5 to enter into Phase5
Note: To check the logs, we need to exit the script by pressing Enter.
Now press 6 to exit the script.
Step 3: Identifying Successful Onboarding
Please make sure the following keywords are present in the logs. You can use a text editor or a command line tool to search the logs.
Consensus check:
If present, this indicates that your node has successfully joined the network and is moving along with the consensus rounds.
Block production check:
This indicates that your node is producing blocks along the network and has successfully onboarded.
Step 4: Install the Chrome Extension Wallet
Obtain the extension from a Supra team member.
Extract the extension package
Open Chrome->Settings->Extensions
Click βLoad Unpacked" (top-left corner)
Select the folder where the extension has been unpacked
Step 5: Create a Wallet Address
Open the installed Chrome extension.
Follow the instructions to create a new wallet.
Write down and securely store the mnemonic phrase provided. This phrase is essential for recovering your wallet down the road.
Step 6: Collect Test Tokens from the Testnet Faucet
Wallet Interface:
Select SUPRA network from the list of the networks in the wallet.
Click on the Collect button to collect tokens.
Swagger Interface:
Access our Faucet API documentation via the following link: https://rpc-testnet.supra.com/rpc/v1/wallet/faucet/{account_address}
Experiment with the API endpoint by inputting your wallet address and requesting tokens.
To keep track of your wallet balance, refer to the Balance API Documentation found here: https://rpc-testnet.supra.com/rpc/v1/accounts/{account_address}/resources/0x1%3A%3Acoin%3A%3ACoinStore%3C0x1%3A%3Asupra_coin%3A%3ASupraCoin%3E.
Note: Make sure to select the Testnet endpoint
Troubleshooting and Support
If you encounter any issues, please feel free to contact us on our Discord channel.
Conclusion
Thank you for participating as a node operator in the Supra ecosystem. We sincerely appreciate your contribution to the strength and security of our network.
Important: Please make sure you read and understand Terms of Use before start using Supra products and services.
Last updated