Sonic Devnet HyperGrid Node Setup Guide

HyperGrid Operating System Requirements

Ubuntu Server 22.04.4 LTS

HyperGrid Hardware Requirements

Low-End Configuration:
CPU: 64-core
RAM: 256GB
SSD: 10TB

Mid-Range Configuration: CPU: 128-core
RAM: 512GB
SSD: 15TB

Server Port Policy

Open ports 80 and 443 to support RPC external services.
Open TCP and UDP protocol ports in the range of 8000 to 9000, and whitelist the IP addresses 52.10.174.63 and 35.164.22.3.
After completing the above configurations, please send your server's public IP address to [email protected].

System Tuning

Your system will need to be tuned in order to run properly. Your validator may not start without the settings below.

Optimize sysctl knobs​

sudo bash -c "cat >/etc/sysctl.d/21-solana-validator.conf <<EOF
# Increase UDP buffer sizes
net.core.rmem_default = 134217728
net.core.rmem_max = 134217728
net.core.wmem_default = 134217728
net.core.wmem_max = 134217728

# Increase memory mapped files limit
vm.max_map_count = 1000000

# Increase number of allowed open file descriptors
fs.nr_open = 1000000
EOF"
sudo sysctl -p /etc/sysctl.d/21-solana-validator.conf

Increase systemd and session file limits​

Add

LimitNOFILE=1000000

to the [Service] section of your systemd service file, if you use one, otherwise add

DefaultLimitNOFILE=1000000

to the [Manager] section of /etc/systemd/system.conf.

sudo systemctl daemon-reload

sudo bash -c "cat >/etc/security/limits.d/90-solana-nofiles.conf <<EOF
#### Increase process file descriptor count limit
* - nofile 1000000
EOF"

### Close all open sessions (log out then, in again) ###

Install Sonic Devnet Validator

1. Install Sonic devnet program

You can install a pre-built binary package, or build it from source codes.

1.1 Download and Extract the Installation Package

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

1.2 Building program from source codes。
1). Install rustc, cargo and rustfmt.

$ curl https://sh.rustup.rs -sSf | sh
$ source $HOME/.cargo/env
$ rustup component add rustfmt

On Ubuntu you may need to install libssl-dev, pkg-config, zlib1g-dev, protobuf etc.

$ sudo apt-get update
$ sudo apt-get install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang cmake make libprotobuf-dev protobuf-compiler

2). Download the source code.

$ git clone https://github.com/mirrorworld-universe/hypergrid-sonic-origin-grid
$ cd hypergrid-sonic-origin-grid

3). Build.

$ mkdir ~/grid_node
$ ./scripts/cargo-install-all.sh ~/grid_node
$ cp ./start_node.sh ~/grid_node/
$ cp ./stop_node.sh ~/grid_node/

2. Initialization

$ cd ~/grid_node
$ mkdir config
$ mkdir logs
$ ./bin/solana-keygen new --no-passphrase
$ ./bin/solana config set --url http://127.0.0.1:8899
$ ./bin/solana-keygen new -o ./config/validator-keypair.json

3. Modify Configuration

Edit the start_node.sh file to replace the IP address (xxx.xxx.xxx.xxx) with your machine's public IP address.

export RUST_LOG=${RUST_LOG:-solana=info,solana_runtime::message_processor=info,solana_metrics::metrics=warn}
export RUST_BACKTRACE=full

./bin/solana-validator \
  --identity ./config/validator-keypair.json \
  --known-validator CQqu5MsTpH1mTwEsZ75QzPtXGTz9ziEvKwpcAstKG9WJ \
  --ledger ./ledger \
	--no-voting \
  --rpc-port 8899 \
  --full-rpc-api \
  --rpc-bind-address 0.0.0.0 \
	--only-known-rpc \
	--gossip-host xxx.xxx.xxx.xxx \
	--gossip-port 8001 \
  --entrypoint 52.10.174.63:8001 \
	--public-rpc-address xxx.xxx.xxx.xxx:8899 \
	--enable-rpc-transaction-history \
	--enable-extended-tx-metadata-storage \
	--no-wait-for-vote-to-start-leader \
	--no-os-network-limits-test \
  --wal-recovery-mode skip_any_corrupted_record \
	--rpc-pubsub-enable-block-subscription \
	--rpc-pubsub-enable-vote-subscription \
	--account-index program-id \
	--account-index spl-token-owner \
	--account-index spl-token-mint \
	--rpc-threads 128 \
	--accounts-db-cache-limit-mb 102400 \
	--accounts-index-memory-limit-mb 40960 \
	--accounts-index-scan-results-limit-mb 40960 \
	--limit-ledger-size 300000000 \
  --expected-genesis-hash BsJstMXKW4DpjzHPsSCdEcAn4YtpNiLFRFa5M5L7UxFx \
	--log ./logs/validator.log &

4. Run the node

$ ./start_node.sh

5. Stop the node

$ ./stop_node.sh