-
SOURCE PROTOCOL
Source is a decentralized, permissionless, and censorship resistant layer 1 proof-of-stake blockchain built in the Cosmos Zone ecosystem.
Chain Explorer:
Nodeist Explorer
Cosmos Explorer based on Ping Pub supported by Nodeist - is the best solution!exp.nodeist.net
Public Endpoints:
Bash:# API ENDPOINT https://api-testnet-source.nodeist.net # RPC ENDPOINT https://rpc-testnet-source.nodeist.net # GRPC ENDPOINT https://grpc-testnet-source.nodeist.net
Peering:
addrbook:
Bash:curl -Ls https://ss.nodeist.net/t/source/addrbook.json > $HOME/.source/config/addrbook.json
live-peers:
Bash:peers="[email protected]:20056,[email protected]:20056,[email protected]:26656,[email protected]:12856" sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$peers\"|" $HOME/.source/config/config.toml
-
Manual Installation
This section contains a list of commands to install the node in manual mode.
Server Preparation
Bash:apt update && apt upgrade -y apt install curl iptables build-essential git wget jq make gcc nano tmux htop nvme-cli pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y
Install GO
Bash:ver="1.20.3" wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" sudo rm -rf /usr/local/go sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" rm "go$ver.linux-amd64.tar.gz" echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile source $HOME/.bash_profile go version
Node Installation
ReplaceNodeist_Guide
in the first line with your moniker name.
Bash:NODE_MONIKER="Nodeist_Guide" cd || return git clone -b testnet https://github.com/Source-Protocol-Cosmos/source.git cd ~/source make install sourced config chain-id sourcechain-testnet sourced init "$NODE_MONIKER" --chain-id sourcechain-testnet curl -s https://ss.nodeist.net/t/source/genesis.json > $HOME/.source/config/genesis.json curl -s https://ss.nodeist.net/t/source/addrbook.json > $HOME/.source/config/addrbook.json SEEDS="" PEERS="" sed -i 's|^seeds *=.*|seeds = "'$SEEDS'"|; s|^persistent_peers *=.*|persistent_peers = "'$PEERS'"|' $HOME/.source/config/config.toml sed -i 's|^pruning *=.*|pruning = "custom"|g' $HOME/.source/config/app.toml sed -i 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|g' $HOME/.source/config/app.toml sed -i 's|^pruning-interval *=.*|pruning-interval = "10"|g' $HOME/.source/config/app.toml sed -i 's|^snapshot-interval *=.*|snapshot-interval = 0|g' $HOME/.source/config/app.toml sed -i 's|^minimum-gas-prices *=.*|minimum-gas-prices = "0.025usource"|g' $HOME/.source/config/app.toml sed -i 's|^prometheus *=.*|prometheus = true|' $HOME/.source/config/config.toml sudo tee /etc/systemd/system/sourced.service > /dev/null << EOF [Unit] Description=Source Node After=network-online.target [Service] User=$USER ExecStart=$(which sourced) start Restart=on-failure RestartSec=10 LimitNOFILE=10000 [Install] WantedBy=multi-user.target EOF sourced tendermint unsafe-reset-all --home $HOME/.source --keep-addr-book curl -L https://ss.nodeist.net/t/source/snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.source --strip-components 2 sudo systemctl daemon-reload sudo systemctl enable sourced sudo systemctl start sourced sudo journalctl -fu sourced -o cat
-
HEIGHT SIZE TIMESTAMP DOWNLOAD
Instructions
Stop the service and reset the data
Bash:sudo systemctl stop sourced cp $HOME/.source/data/priv_validator_state.json $HOME/.source/priv_validator_state.json.backup rm -rf $HOME/.source/data
Download latest snapshot
Bash:curl -L https://ss.nodeist.net/t/source/snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.source --strip-components 2 mv $HOME/.source/priv_validator_state.json.backup $HOME/.source/data/priv_validator_state.json
Restart the service and check the log
Bash:sudo systemctl restart sourced && sudo journalctl -fu sourced -o cat
-
Instructions
Stop the service and reset the data
Bash:sudo systemctl stop sourced cp $HOME/.source/data/priv_validator_state.json $HOME/.source/priv_validator_state.json.backup sourced tendermint unsafe-reset-all --home $HOME/.source
Get and configure the state sync information
Bash:SNAP_RPC="https://rpc-source.nodeist.net:443" LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \ BLOCK_HEIGHT=$((LATEST_HEIGHT - 2000)); \ TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash) sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \ s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \ s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \ s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"|" $HOME/.source/config/config.toml mv $HOME/.source/priv_validator_state.json.backup $HOME/.source/data/priv_validator_state.json
Restart the service and check the log
Bash:sudo systemctl restart sourced && sudo journalctl -fu sourced -o cat
-
🔑 Key management
Add new key
Bash:sourced keys add wallet
Recover existing key
Bash:sourced keys add wallet --recover
List all keys
Bash:sourced keys list
Delete key
Bash:sourced keys delete wallet
Export key to the file
Bash:sourced keys export wallet
Import key from the file
Bash:sourced keys import wallet wallet.backup
Query wallet balance
Bash:sourced q bank balances $(sourced keys show wallet -a)
👷 Validator management
- Please make sure you have adjusted moniker, identity, details and website to match your values.
Create new validator
Bash:sourced tx staking create-validator \ --amount 1000000usource \ --pubkey $(sourced tendermint show-validator) \ --moniker "YOUR_MONIKER_NAME" \ --identity "YOUR_KEYBASE_ID" \ --details "YOUR_DETAILS" \ --website "YOUR_WEBSITE_URL" \ --chain-id sourcechain-testnet \ --commission-rate 0.05 \ --commission-max-rate 0.20 \ --commission-max-change-rate 0.01 \ --min-self-delegation 1 \ --from wallet \ --gas-adjustment 1.4 \ --gas auto \ --gas-prices 0.025usource \ -y
Edit existing validator
Bash:sourced tx staking edit-validator \ --new-moniker "YOUR_MONIKER_NAME" \ --identity "YOUR_KEYBASE_ID" \ --details "YOUR_DETAILS" \ --website "YOUR_WEBSITE_URL" \ --chain-id sourcechain-testnet \ --commission-rate 0.05 \ --from wallet \ --gas-adjustment 1.4 \ --gas auto \ --gas-prices 0.025usource \ -y
Unjail validator
Bash:sourced tx slashing unjail --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Jail reason
Bash:sourced query slashing signing-info $(sourced tendermint show-validator)
List all active validators
Bash:sourced q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
List all inactive validators
Bash:sourced q staking validators -oj --limit=3000 | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' | jq -r '(.tokens|tonumber/pow(10; 6)|floor|tostring) + " \t " + .description.moniker' | sort -gr | nl
View validator details
Bash:sourced q staking validator $(sourced keys show wallet --bech val -a)
💲 Token management
Withdraw rewards from all validators
Bash:sourced tx distribution withdraw-all-rewards --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Withdraw commission and rewards from your validator
Bash:sourced tx distribution withdraw-rewards $(sourced keys show wallet --bech val -a) --commission --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Delegate tokens to yourself
Bash:sourced tx staking delegate $(sourced keys show wallet --bech val -a) 1000000usource --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Delegate tokens to validator
Bash:sourced tx staking delegate <TO_VALOPER_ADDRESS> 1000000usource --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Redelegate tokens to another validator
Bash:sourced tx staking redelegate $(sourced keys show wallet --bech val -a) <TO_VALOPER_ADDRESS> 1000000usource --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Unbond tokens from your validator
Bash:sourced tx staking unbond $(sourced keys show wallet --bech val -a) 1000000usource --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Send tokens to the wallet
Bash:sourced tx bank send wallet <TO_WALLET_ADDRESS> 1000000usource --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
🗳 Governance
List all proposals
Bash:sourced query gov proposals
View proposal by id
Bash:sourced query gov proposal 1
Vote 'Yes'
Bash:sourced tx gov vote 1 yes --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Vote 'No'
Bash:sourced tx gov vote 1 no --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Vote 'Abstain'
Bash:sourced tx gov vote 1 abstain --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
Vote 'NoWithVeto'
Bash:sourced tx gov vote 1 NoWithVeto --from wallet --chain-id sourcechain-testnet --gas-adjustment 1.4 --gas auto --gas-prices 0.025usource -y
⚡️ Utility
Update Indexer
Bash:sed -i -e 's|^indexer *=.*|indexer = "null"|' $HOME/.source/config/config.toml
Update pruning
Bash:sed -i \ -e 's|^pruning *=.*|pruning = "custom"|' \ -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \ -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \ -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \ $HOME/.source/config/app.toml
🚨 Maintenance
Get validator info
Bash:sourced status 2>&1 | jq .ValidatorInfo
Get sync info
Bash:sourced status 2>&1 | jq .SyncInfo
Get node peer
Bash:echo $(sourced tendermint show-node-id)'@'$(curl -s ifconfig.me)':'$(cat $HOME/.source/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Check if validator key is correct
Bash:[[ $(sourced q staking validator $(sourced keys show wallet --bech val -a) -oj | jq -r .consensus_pubkey.key) = $(sourced status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\n\e[1m\e[32mTrue\e[0m\n" || echo -e "\n\e[1m\e[31mFalse\e[0m\n"
Get live peers
Bash:curl -sS http://localhost:27657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr)"' | awk -F ':' '{print $1":"$(NF)}'
Set minimum gas price
Bash:sed -i -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.025usource\"/" $HOME/.source/config/app.toml
Enable prometheus
Bash:sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.source/config/config.toml
Reset chain data
Bash:sourced tendermint unsafe-reset-all --home $HOME/.source --keep-addr-book
Remove node
- Please, before proceeding with the next step! All chain data will be lost! Make sure you have backed up your priv_validator_key.json!
Bash:cd $HOME sudo systemctl stop sourced sudo systemctl disable sourced sudo rm /etc/systemd/system/sourced.service sudo systemctl daemon-reload rm -f $(which sourced) rm -rf $HOME/.source rm -rf $HOME/sourced
⚙️ Service Management
Reload service configuration
Bash:sudo systemctl daemon-reload
Enable service
Bash:sudo systemctl enable sourced
Disable service
Bash:sudo systemctl disable sourced
Start service
Bash:sudo systemctl start sourced
Stop service
Bash:sudo systemctl stop sourced
Restart service
Bash:sudo systemctl restart sourced
Check service status
Bash:sudo systemctl status sourced
Check service logs
Bash:sudo journalctl -u sourced -f --no-hostname -o cat
Last edited: