testnets

Source Testnet Set up

For full Source Chain Documentation and testnet set up click: HERE

Minimum hardware requirements

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

Install Go

Prerequisites: Make sure to have Golang >=1.18.

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

sudo tar -C /usr/local -xzf go1.18.2.linux-amd64.tar.gz

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 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

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/Source-Protocol-Cosmos/testnets/master/sourcechain-testnet/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"

Set Minimum Gas Price

nano ~/.source/config/app.toml

0.025usource

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. 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>/testnets

• Copy the generated gentx json file to <repo_path>/testnets/gentx/

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

• Commit and push to your repo

• Create a PR onto https://github.com/Source-Protocol-Cosmos/testnets

• 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

Note, we'll be going through some upgrades for this testnet. Consider using Cosmovisor to make your life easier.

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