Source protocol

Testnet details

• Network Chain ID: source-1
• Denom: usource
• Binary: sourced
• Working directory: .source
• Cosmos explorer: https://explorer.stavr.tech/Source-Mainnet/block
• Офф инструкция: https://github.com/Source-Protocol-Cosmos/mainnet

# обновляем репозитории
sudo apt update && sudo apt upgrade -y

# устанавливаем необходимые утилиты
sudo apt install curl build-essential git wget jq make gcc tmux htop nvme-cli pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y

# проверяем работу жестких дисков
curl -sL yabs.sh | bash -s — -ig

# проверяем работу интернета
curl -sL yabs.sh | bash -s — -fg

Устанавливаем Go ОДНОЙ КОМАНДОЙ

ver="1.19.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

Устанавливаем бинарники

git clone -b testnet https://github.com/Source-Protocol-Cosmos/source && cd source
git checkout v3.0.1
make install

sourced version --long | head
# version: v3.0.1
# commit: 2aae45f6e2d23f6c81c02075b74ee9f5b7598e3e

Инициализируем ноду, чтобы создать необходимые файлы конфигурации

sourced init UTSA_guide --chain-id source-1

Скачиваем Genesis

wget -O $HOME/.source/config/genesis.json "https://raw.githubusercontent.com/Source-Protocol-Cosmos/mainnet/master/source-1/genesis.json"

# Проверим генезис
sha256sum ~/.source/config/genesis.json
# ba2261082818227073bd8b49717a9781bf5c440c8e34e21ec72fb15806f047cc

Проверяем, что состояние валидатора на начальном этапе

cd && cat .source/data/priv_validator_state.json
{
  "height": "0",
  "round": 0,
  "step": 0
}

# если нет, то выполняем команду
sourced tendermint unsafe-reset-all --home $HOME/.source

Скачиваем Addr book

wget -O $HOME/.source/config/addrbook.json "https://raw.githubusercontent.com/obajay/nodes-Guides/main/Projects/Source/addrbook.json"

# правим конфиг, благодаря чему мы можем больше не использовать флаг chain-id для каждой команды CLI в client.toml
sourced config chain-id source-1

# при необходимости настраиваем keyring-backend в client.toml 
sourced config keyring-backend os

# настраиваем минимальную цену за газ в app.toml
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"1usource\"/;" ~/.source/config/app.toml

# добавляем seeds/bpeers/peers в config.toml
external_address=$(wget -qO- eth0.me)
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.source/config/config.toml

peers="[email protected]:26656,[email protected]:26656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.source/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.source/config/config.toml

# при необходимости увеличиваем количество входящих и исходящих пиров для подключения, за исключением постоянных пиров в config.toml
# может помочь при падении ноды, но увеличивает нагрузку
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 40/g' $HOME/.source/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 10/g' $HOME/.source/config/config.toml

# настраиваем фильтрацию "плохих" peers
sed -i -e "s/^filter_peers *=.*/filter_peers = \"true\"/" $HOME/.source/config/config.toml

(ОПЦИОНАЛЬНО) Настраиваем прунинг одной командой вapp.toml

pruning="custom" && \
pruning_keep_recent="1000" && \
pruning_keep_every="0" && \
pruning_interval="10" && \
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.source/config/app.toml && \
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.source/config/app.toml && \
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.source/config/app.toml && \
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.source/config/app.toml

(ОПЦИОНАЛЬНО) Выкл индексацию вconfig.toml

indexer="null" && \
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.source/config/config.toml

(ОПЦИОНАЛЬНО) Вкл/выкл снэпшоты вapp.toml

# По умолчанию снэпшоты выключены "snapshot-interval=1500"
snapshot_interval=1000 && \
sed -i.bak -e "s/^snapshot-interval *=.*/snapshot-interval = \"$snapshot_interval\"/" ~/.source/config/app.toml

# config.toml
sed -i.bak -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:36658\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:36657\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:6061\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:36656\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":36660\"%" $HOME/.source/config/config.toml

# app.toml
sed -i.bak -e "s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:9190\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:9191\"%" $HOME/.source/config/app.toml

# client.toml
sed -i.bak -e "s%^node = \"tcp://localhost:26657\"%node = \"tcp://localhost:36657\"%" $HOME/.source/config/client.toml

external_address=$(wget -qO- eth0.me)
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:36656\"/" $HOME/.source/config/config.toml

peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.source/config/config.toml

SNAP_RPC=

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)

echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_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\"| ; \
s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.source/config/config.toml

Создаем сервисный файл

tee /etc/systemd/system/sourced.service > /dev/null <<EOF
[Unit]
Description=sourced
After=network-online.target

[Service]
User=$USER
ExecStart=$(which sourced) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable sourced
systemctl restart sourced && journalctl -u sourced -f -o cat

systemctl stop sourced
sourced tendermint unsafe-reset-all --home $HOME/.source --keep-addr-book

# перезагружаем ноду
systemctl restart sourced && journalctl -u sourced -f -o cat

Cоздаем или восстанавливаем кошелек и сохраняем вывод

# создать кошелек
sourced keys add <name_wallet> --keyring-backend os

# восстановить кошелек (после команды вставить seed)
sourced keys add <name_wallet> --recover --keyring-backend os

# подключить кошелек ledger
sourced keys add <name_wallet> --ledger 

Создаем валидатора

sourced tx staking create-validator \
--chain-id source-1 \
--commission-rate 0.05 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.1 \
--min-self-delegation "1000000" \
--amount 1000000usource \
--pubkey $(sourced tendermint show-validator) \
--moniker "<name_moniker>" \
--from <name_wallet> \
--fees 200000usource

Информация

# проверить блоки
sourced status 2>&1 | jq ."SyncInfo"."latest_block_height"

# проверить логи
journalctl -u sourced -f -o cat
journalctl --lines=100 --follow --unit sourced

# проверить статус
curl localhost:26657/status

# проверить баланс
sourced q bank balances <address>

# проверить pubkey валидатора
sourced tendermint show-validator

# проверить валидатора
sourced query staking validator <valoper_address>
sourced query staking validators --limit 1000000 -o json | jq '.validators[] | select(.description.moniker=="<name_moniker>")' | jq

# проверка информации по TX_HASH
sourced query tx <TX_HASH>

# параметры сети
sourced q staking params
sourced q slashing params

# проверить сколько блоков пропущено валидатором и с какого блока актив
sourced q slashing signing-info $(sourced tendermint show-validator)

# узнать транзакцию создания валидатора (заменить свой valoper_address)
sourced query txs --events='create_validator.validator=<your_valoper_address>' -o=json | jq .txs[0].txhash -r

# просмотр активного сета
sourced q staking validators -o json --limit=1000 \
| jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' \
| jq -r '.tokens + " - " + .description.moniker' \
| sort -gr | nl

# просмотр неактивного сета
sourced q staking validators -o json --limit=1000 \
| jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' \
| jq -r '.tokens + " - " + .description.moniker' \
| sort -gr | nl

Транзакции

# собрать реварды со всех валидаторов, которым делегировали (без комиссии)
sourced tx distribution withdraw-all-rewards --from <name_wallet> --fees 200000usource -y

# собрать реварды c отдельного валидатора или реварды + комиссию со своего валидатора
sourced tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --fees 200000usource --commission -y

# заделегировать себе в стейк еще (так отправляется 1 монетa)
sourced tx staking delegate <valoper_address> 1000000usource --from <name_wallet> --fees 200000usource -y

# ределегирование на другого валидатора
sourced tx staking redelegate <src-validator-addr> <dst-validator-addr> 1000000usource --from <name_wallet> --fees 200000usource -y

# unbond 
sourced tx staking unbond <addr_valoper> 1000000usource --from <name_wallet> --fees 200000usource -y

# отправить монеты на другой адрес
sourced tx bank send <name_wallet> <address> 1000000usource --fees 200000usource -y

# выбраться из тюрьмы
sourced tx slashing unjail --from <name_wallet> --fees 200000usource -y

Работа с кошельками

# вывести список кошельков
sourced keys list

# показать ключ аккаунта
sourced keys show <name_wallet> --bech acc

# показать ключ валидатора
sourced keys show <name_wallet> --bech val

# показать ключ консенсуса
sourced keys show <name_wallet> --bech cons

# запрос учетной записи
sourced q auth account $(sourced keys show <name_wallet> -a) -o text

# удалить кошелек
sourced keys delete <name_wallet>

Удалить ноду

systemctl stop sourced && \
systemctl disable sourced && \
rm /etc/systemd/system/sourced.service && \
systemctl daemon-reload && \
cd $HOME && \
rm -rf .source source && \
rm -rf $(which sourced)

ГОВЕРНАНС

# список proposals
sourced q gov proposals

# посмотреть результат голосования
sourced q gov proposals --voter <ADDRESS>

# проголосовать за предложение 
sourced tx gov vote 1 yes --from <name_wallet> --fees 200000usource

# внести депозит в предложение
sourced tx gov deposit 1 1000000usource --from <name_wallet> --fees 200000usource

# создать предложение
sourced tx gov submit-proposal --title="Randomly reward" --description="Reward 10 testnet participants who completed more than 3 tasks" --type="Text" --deposit="11000000grain" --from=<name_wallet> --fees 500grain

Peers

# проверка количества пиров
curl -s http://localhost:26657/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr | split(":")[2])"' | wc -l

# cписок моникеров подключенных пиров
curl -s http://localhost:26657/net_info | jq '.result.peers[].node_info.moniker'

# Проверка vote power онлайн. Пригодится при обновах
curl -s localhost:26657/consensus_state | jq '.result.round_state.height_vote_set[0].prevotes_bit_array'

# check prevote of your validator
curl -s localhost:26657/consensus_state -s | grep $(curl -s localhost:26657/status | jq -r .result.validator_info.address[:12])

Поиск всех исходящих транзакций по адресу

sourced q txs --events transfer.sender=<ADDRESS> 2>&1 | jq | grep txhash

Поиск всех входящих транзакций по адресу

sourced q txs --events transfer.recipient=<ADDRESS> 2>&1 | jq | grep txhash

Получение ID@IP:PORT - cohod исправить на нужное

echo "$(sourced tendermint show-node-id)@$(curl ifconfig.me):26656"

Узнать порт RPC

echo $(grep -A 3 "\[rpc\]" ~/.source/config/config.toml | egrep -o ":[0-9]+")