testnet-genesis

Source Chain Testnet Set up

Minimum hardware requirements

4GB RAM 250GB of disk space 1.4 GHz amd64 CPU

Install Go

Prerequisites: Make sure to have Golang >=1.17.

wget https://golang.org/dl/go1.17.2.linux-amd64.tar.gz

sudo tar -xvf go1.17.2.linux-amd64.tar.gz -C /usr/local

sudo chown -R <YOUR_USERNAME>:<YOUR_USERNAME> /usr/local/go

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 GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin:/usr/local/go/bin

Source update .profile

source .profile

Install Ignite CLI/Starport

IGNITE CLI Install Docs

   sudo curl https://get.ignite.com/cli! | sudo bash

Clone Source Chain Repo

   git clone -b testnet https://github.com/Source-Protocol-Cosmos/source.git

Compile sourced Binary

cd ~/source
ignite chain build

Initialize the Source directories and create the local genesis file with the correct chain-id:

sourced init <moniker-name> --chain-id=sourcechain-testnet

Create a local key pair (or add existing key):

sourced keys add <key-name>

Download Genesis File

   curl -s  https://raw.githubusercontent.com/SourceNexxus/testnet-genesis/master/genesis.json > ~/.source/config/genesis.json

Genesis sha256

sha256sum ~/.source/config/genesis.json
# 2bf556b50a2094f252e0aac75c8018a9d6c0a77ba64ce39811945087f6a5165d

Seed nodes to add to config.toml

nano ~/.source/config/config.toml

# Comma separated list of nodes to keep persistent connections to persistent_peers = 
"[email protected]:26656"

Setup validator node

Below are the instructions to generate & submit your genesis transaction

Generate genesis transaction (gentx)

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

sourced init <moniker-name> --chain-id=sourcechain-testnet

2. Create a local key pair (skip this step if you already have a key):

> sourced keys add <key-name>

3. Add your account to your local genesis file with a given amount and the key you just created. Use only 10000000000usource, other amounts will be ignored.

sourced add-genesis-account $(sourced keys show <key-name> -a) 10000000000usource

4. Create the gentx, use only 9000000000usource:

sourced gentx <key-name> 9000000000usource --chain-id=sourcechain-testnet

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

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

5. Change minimum gas prices in app.toml to 0.025usource.

6. Start the chain

sourced start

6. Create Validator

sourced tx staking create-validator \
--amount 1000000000usource \
--commission-max-change-rate "0.1" \
--commission-max-rate "0.20" \
--commission-rate "0.1" \
--min-self-delegation "1" \
--details "validators write bios too" \
--pubkey=$(sourced tendermint show-validator) \
--moniker “<key-name>” \
--chain-id sourcechain-testnet \
--gas-prices 0.025usource \
--from <key-name>

Submit genesis transaction

• Fork the testnets repo into your Github account

• Clone your repo using

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

• Copy the generated gentx json file to <repo_path>/testnet-genesis/gentx/

  > cd testnet-genesis
  > cp ~/.source/config/gentx/gentx*.json ./testnet-genesis/gentx/

• Commit and push to your repo

• Create a PR onto https://github.com/SourceNexxus/testnet-genesis

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

Running in production

Consider using Cosmovisor for mainnet.

Create a systemd file for your Source service:

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

Copy and paste the following and update :

Description=Source daemon
After=network-online.target

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

[Install]
WantedBy=multi-user.target

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

Enable and start the new service:

sudo systemctl enable sourced

sudo systemctl start sourced

Check status:

sourced status

Check logs:

journalctl -u sourced -f