Deploying an HSSN Validator

Step-by-step guide for deploying a new HSSN Validator Node, including system requirements, hardware configurations, and setup instructions.

Operating System Requirements

• Ubuntu Server 22.04.4 LTS

Hardware Requirements

Configuration	CPU	RAM	SSD
Low-End	32-core	128GB	5TB
Mid-Range	64-core	256GB	10TB

Key Things To Note

1. This document is a work in progress. Some parts of it may change as it's progressively polished. However, the bulk of will remain the same.

2. HSSN validator setup is currently only being gradually rolled out to selected Sonic's Ecosystem Partners, and will gradually be publicly rolled. If you would like to run an HSSN Node, please contact our team on Discord.

3. Please make use of the Discord chat to follow any new developments, as well as for node operator support.

HSSN Validator Setup

1. Download and Install the Package

wget https://grid-sonic.hypergrid.dev/downloads/hypergrid-ssn_testnet_v1.tar.gz
tar -zxvf hypergrid-ssn_testnet_v1.tar.gz

2. Initialization Settings

Navigate to the extracted directory:

cd .hypergrid-ssn

Create a key pair:

./bin/hypergrid-ssnd keys add my_validator --keyring-backend test

Initialize the configuration (replace <NODE_NAME> with your node name):

./bin/hypergrid-ssnd init <NODE_NAME> --default-denom hsol --chain-id hypergridssn

Copy the ~/.hypergrid-ssn/genesis.json file and overwrite the the contents of the file generated at ~/.hypergrid-ssn/config/genesis.json.

Modify config/app.toml:

minimum-gas-prices = "0hsol"

Modify config/config.toml:

Update the external IP. Make sure to replace the <YOUR_NODE_IP_ADDRESS> with your node's external IP address.

external_address = "<YOUR_NODE_IP_ADDRESS>:26656"
persistent_peers = "[email protected]:26656"

3. Run the Validator

Make sure to replace<NODE_NAME> with the name you configured in Step 2.

./bin/hypergrid-ssnd start --moniker <NODE_NAME>

1. Please share your validator's public IP address to our team on Discord.

2. Allow the start command to run until your node has fully indexed and caught up with all the rest of the HSSN network's block height. This may take a couple of hours. You can see the current block height of the HSSN network on the Blocks page of the HSSN Explorer Dashboard.

After your node has caught up with the rest of the network, please proceed to the next steps.

4. Networking

Display your validator's account address:

./bin/hypergrid-ssnd keys show my_validator -a --keyring-backend test

Use the account address obtained from the command above to get HSOL tokens from the HSSN faucet.

Important: The following steps require you to fund your validator account. The HSSN Faucet UI is currently under development and will be added to this document soon. For now, please contact our team on Discord and we can airdrop you some HSOL manually.

Show your HSSN validator public key:

./bin/hypergrid-ssnd tendermint show-validator

Replace the pubkey in validator.json with the the public key you obtained above and update the moniker with the corresponding node name you configured in Step 2. Please make sure to replace the "pubkey" and "moniker" fields.

{
    "pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"KRrCrMHaeog5IAwSxFsUk/teRwDaZIhHQ5gFkrqcums="},
    "amount": "100000000hsol",
    "moniker": "<NODE_NAME>",
    "commission-rate": "0.1",
    "commission-max-rate": "0.2",
    "commission-max-change-rate": "0.01",
    "min-self-delegation": "1"
}

Stake as a validator:

./bin/hypergrid-ssnd tx staking create-validator ./validator.json --from my_validator --keyring-backend test --chain-id hypergridssn

Check if the operation was successful:

./bin/hypergrid-ssnd q staking validators

5. Install and Configure Solana Client

Install the Solana client:

sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Verify the installation:

solana --version

Set the Solana configuration:

solana config set --url http://api.testnet.sonic.game
solana-keygen new --no-passphrase
solana address

Use the account address obtained from the command above to get SOL tokens from the Sonic grid faucet and the Solana Testnet faucet.

6. Register Node

Make sure to replace <NODE_NAME> with the name you configured in Step 2, and change the "https://your-node-rpc-url.com/" to the rpc URL of your choice for your node. (The url is not required at this step. You can configure this later using NGINX).

./bin/hypergrid-ssnd tx hypergridssn create-hypergrid-node $(solana address) "<NODE_NAME>" "https://your-node-rpc-url.com/" 1 "" $(date +%s) --from my_validator -y --chain-id hypergridssn --keyring-backend test

7. Confirm Validator Node Registration

You can confirm that your node was successfully registered with the following command:

./bin/hypergrid-ssnd query hypergridssn list-hypergrid-node

You should be able to see your validator node in the list of validators. You should also see your validator in the Validators page of the HSSN Explorer.

Congratulations! You should now be successfully running your HSSN node at this stage.

---

8. Community / Support

Please join the HyperGrid Discord to get more updates on latest changes as well as to get faster support responses.

For more official queries, please email [email protected] for assistance.