Sonic | Official Documentation
Official WebsiteExplorerFaucet
  • Welcome to Sonic
  • Users
    • Getting Started
      • Setting up your wallet
      • Bridging funds to Sonic
      • Join Sonic community!
  • Developers
    • Why Choose Sonic?
    • Getting Started
      • Setup local development for Sonic SVM
      • Build & Deploy Your First Program
    • Developer Tooling
      • Explorer
      • Faucet
      • Wallet Extensions
  • Additional Tools & Examples
  • Additional Resources
  • Architecture
    • Overview
    • Sonic SVM Whitepaper
    • Vision & Architecture
    • Clusters
    • HyperGrid Framework
      • HyperGrid Infrastructure
        • Architectural Overview
        • Grids and Network Relationships
          • Grids
      • Interoperability with Solana
        • Data Synchronization Between HyperGrid and Solana Base Layer
      • HyperGrid Shared State Network (HSSN)
      • HSSN Explorer Overview
      • HSSN Gas Fee Mechanism
      • Operator Guides
        • Deploying a New Grid
        • Deploying a Sonic RPC Node
        • Deploying an HSSN Validator
        • Mainnet
          • Deploying an HSSN Validator
      • Verifiable Compute & Zero-Knowledge Proofing on HyperGrid
    • Sorada
      • Introduction
      • Architecture
      • How to Deploy Sorada
      • Resources
    • Rush ECS Framework
      • Introduction
      • Features
      • Quickstart
      • Reference
      • Demo
  • RESOURCES
    • Audit Reports
    • We're Hiring!
Powered by GitBook
On this page
  • System Requirements
  • Operating System
  • Hardware Requirements
  • Install Grid Validator Client
  • Initialization
  • HSSN Client Setup
  • Run the Validator
  • Register Node
  • Post-Deployment
  • Operator Guides
  • Support
Edit on GitHub
  1. Architecture
  2. HyperGrid Framework
  3. Operator Guides

Deploying a New Grid

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

System Requirements

Operating System

  • Ubuntu Server 22.04.4 LTS

Hardware Requirements

Configuration
CPU
RAM
SSD

Low-End

64-core

128GB

5TB

Mid-Range

128-core

384GB

10TB

Install Grid Validator Client

Option 1: Pre-built Binary Package

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

Option 2: Build from Source Code

Install dependencies:

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

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

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

mkdir ~/grid_node
./scripts/cargo-install-all.sh ~/grid_node
cp ./run_rpcnode.sh ~/grid_node/

Initialization

cd grid_node
./bin/solana-keygen new --no-passphrase
./bin/solana config set --url http://127.0.0.1:8899

./init_validator.sh
./bin/solana address

Note: Use the account address obtained from the last command to get SOL tokens from the Sonic grid faucet.

HSSN Client Setup

cd ..
wget https://grid-sonic.hypergrid.dev/downloads/hypergrid-ssn_client.tar.gz
tar -zxvf hypergrid-ssn.tar.gz

cd .hypergrid-ssn
./bin/hypergrid-ssnd init

Modify the config/client.toml file:

node = "tcp://172.31.10.244:26657"

Create a key pair:

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

Note: Use the account address obtained from the last command to get HSOL tokens from the HSSN faucet.

Run the Validator

cd ../grid_node
./run_validator.sh

Register Node

./bin/solana validators

Send the Identity information to operators@sonic.game

Post-Deployment

After successfully deploying your new Grid, it becomes part of the HSSN, participating in the broader Grid ecosystem. Your Grid will:

  • Process transactions and interact with users

  • Participate in the gas fee distribution process

  • Sync with the Solana Base Layer through the HSSN

For monitoring your Grid's performance and interactions within the network, refer to the HSSN Dashboard Explorer.

Learn more about the HSSN Explorer Overview

Operator Guides

It is recommended to read the guides and operator best practices outlined in the official Solana documentation.

Support

For support or questions, contact the Sonic Operators team at operators@sonic.game or DM @codebender828 on X.

PreviousOperator GuidesNextDeploying a Sonic RPC Node

Last updated 10 months ago