StateSet Network Quickstart

Getting started with the StateSet Network

Prerequisites

First we need to install Git, Node.js, Go and Rust:

Install Git

bash

sudo apt-get update
sudo apt-get install git

Install Node.js with NVM

bash

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

Currently, StateSet Network uses Go 1.19 to compile the code.

Install GO

Install Go 1.19

Verify the installation by typing go version in your terminal.

jsx

go version 
go version go1.18.1 darwin/amd64

Every RPC and faucet hostname in this guide sits on a domain that does not currently resolve. Confirm the endpoint you should be using with StateSet before working through the setup below — the commands are correct, but the hosts they point at are not reachable.

Setup

1. Stop your node
2. Reset Statesetd unsafe-reset-all
3. Remove genesis rm .StateSet/config/genesis.json
4. Remove gentxs rm -r .StateSet/config/gentx/
5. Follow generate gentx as normal below

Genesis File

Genesis File:

   curl -s  https://raw.githubusercontent.com/StateSet/networks/main/StateSet-1/genesis.json > ~/.StateSet/config/genesis.json

StateSetd version

$ Statesetd version
latest-8e35a4d3

Setup

Prerequisites: Make sure to have Golang >=1.19.

Build from source

You need to ensure your gopath configuration is correct. If the following ‘make’ step does not work then you might have to add these lines to your .profile or .zshrc in the users home folder:

nano ~/.profile

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin

Source update .profile

source .profile

git clone https://github.com/StateSet/StateSet
cd Stateset
make build && make install

This will build and install Statesetd binary into $GOBIN.

Note: When building from source, it is important to have your $GOPATH set correctly. When in doubt, the following should do:

mkdir ~/go
export GOPATH=~/go

Minimum hardware requirements

• 8-16GB RAM
• 100GB of disk space
• 2 cores

Setup validator node

Below are the instructions to generate & submit your genesis transaction

Generate genesis transaction (gentx)

1. Initialize the StateSet directories and create the local genesis file with the correct chain-id:

   Statesetd init <moniker-name> --chain-id=Stateset-1
   

2. Create a local key pair:

   Statesetd keys add <key-name>
   

3. Add your account to your local genesis file with a given amount and the key you just created.

   Statesetd add-genesis-account $(Statesetd keys show <key-name> -a) 10000000000ustate
   

4. Create the gentx, use only 9000000000ustate:

   Statesetd gentx <key-name> 9000000000ustate --chain-id=Stateset-1-testnet
   

   If all goes well, you will see a message similar to the following:

   Genesis transaction written to "/home/user/.StateSet/config/gentx/gentx-******.json"
   

Submit genesis transaction

• Fork the networks repo into your Github account

• Clone your repo using

  git clone https://github.com/<your-github-username>/networks
  

• Copy the generated gentx json file to <repo_path>/networks/StateSet-1/gentx/

  > cd testnets
  > cp ~/.StateSet/config/gentx/gentx*.json ./StateSet-1/gentx/
  

• Commit and push to your repo

• Create a PR onto https://github.com/StateSet/networks

• Only PRs from individuals / groups with a history successfully running nodes will be accepted. This is to ensure the network successfully starts on time.

Next steps

Network orders

Placing and settling orders on the network.

Contracts

The contracts a validator executes.

Sequencer

The sequencing layer above the chain.

Set L2

Settlement on the L2.