Stargaze - Mainnet

Planned Genesis Start Time: October 29th at 17:00 UTC.

Gentx submission deadline: October 28th at 17:00 UTC.

Setup

Prerequisites: Make sure to have Golang >=1.17.

Build from source

You need to ensure your GOPATH configuration is correct. You might have to add these lines to your .profile or .zshrc if you don't have them already:

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

git clone https://github.com/public-awesome/stargaze
cd stargaze
git checkout v1.0.0-alpha.1
make build && make install

This will build and install starsd binary into $GOPATH\bin.

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

At the end, you should have a working starsd binary with the following version:

$ starsd version --long
name: stargaze
server_name: starsd
version: TBD
commit: TBD

Minimum hardware requirements

• 8GB RAM
• 500GB of disk space
• 1.6 GHz AMD64 CPU

Setup validator node

Below are the instructions to generate & submit your genesis transaction

Generate genesis transaction (pre-launch only)

Only nodes that participated in the testnet will be able to validate. Others will be able to join the validator set at a later date after the chain launches.

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

   starsd config chain-id stargaze-1
   starsd init <MONIKER-NAME> --chain-id stargaze-1

2. Create a local key pair (you should use the same key associated with you submitted for testnet rewards)

   starsd keys add <key-name>

   Note: if you're using an offline key for signing (for example, with a Ledger), do this with starsd keys add <KEY-NAME> --pubkey <YOUR-PUBKEY>. For the rest of the transactions, you will use the --generate-only flag and sign them offline with starsd tx sign.

3. Download the pre-genesis file:

   curl -s  https://raw.githubusercontent.com/public-awesome/mainnet/main/stargaze-1/pre-genesis.json >~/.starsd/config/genesis.json

   Find your account in the stargaze-1/pre-genesis.json file.

4. Create the gentx, replace <KEY-NAME>:

   starsd gentx <KEY-NAME> 10000000000ustars --commission-rate=0.05 --chain-id stargaze-1

   Note, amounts other than 10000000000ustars will fail in CI, you will be able to delegate the remainder of your testnet rewards after chain start. Commission should be set to at least 5%

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

   Genesis transaction written to "/home/[user]/.starsd/config/gentx/gentx-******.json"

Submit genesis transaction

• Fork this repo into your Github account

• Clone your repo using:

  git clone https://github.com/<YOUR-GITHUB-USERNAME>/mainnet

• Copy the generated gentx json file to <REPO-PATH>/stargaze-1/gentx/

  cd mainnet
  cp ~/.starsd/config/gentx/gentx*.json ./stargaze-1/gentx/

• Commit and push to your repo

• Create a PR onto https://github.com/public-awesome/mainnet

• Only PRs from individuals / groups with a history successfully running validator nodes and that have initial STARS balance from the testnet will be accepted. This is to ensure the network successfully starts on time.

Running in production

Note, we'll be going through some upgrades soon after Stargaze mainnet. Consider using Cosmovisor to make your life easier.

Download genesis file when the time is right. Put it in your /home/<YOUR-USERNAME>/.starsd folder.

Create a systemd file for your Stargaze service:

sudo nano /etc/systemd/system/starsd.service

Copy and paste the following and update <YOUR-USERNAME>:

Description=Stargaze daemon
After=network-online.target

[Service]
User=<YOUR_USERNAME>
ExecStart=/home/<YOUR-USERNAME>/go/bin/starsd start --home /home/<YOUR-USERNAME>/.starsd
Restart=on-failure
RestartSec=3
LimitNOFILE=4096

[Install]
WantedBy=multi-user.target

This assumes $HOME/.starsd to be your directory for config and data. Your actual directory locations may vary.

Enable and start the new service:

sudo systemctl enable starsd
sudo systemctl start starsd

Check status:

starsd status

Check logs:

journalctl -u starsd -f

Learn more

• Stargaze Community Discord
• Stargaze Community Telegram