Side Protocol — это полностековая и омничейн-инфраструктура для обмена активами, которая предоставляет необходимые инструменты, приложения и инфраструктуру для децентрализованного обмена.
Минимальные системные требования:
-
Тип ноды: Testnet
-
CPU: 4
-
RAM: 8GB
-
Хранилище: 150GB
Установка
Автоустановка
wget -O sidem https://raw.githubusercontent.com/111STAVR111/props/main/Side/sidem && chmod +x sidem && ./sidem
Ручная установка
Подготовка сервера:
sudo apt update && sudo apt upgrade -y
sudo apt install curl tar wget clang pkg-config libssl-dev jq build-essential bsdmainutils git make ncdu gcc git jq chrony liblz4-tool -y
Установка GO 1.21.6:
ver="1.21.6"
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
Сборка:
cd $HOME && mkdir -p go/bin/
git clone https://github.com/sideprotocol/side.git
cd side
git checkout v0.9.0
make install
sided version --long | grep -e version -e commit
Инициализация:
sided init STAVR_guide --chain-id=grimoria-testnet-1
sided config chain-id grimoria-testnet-1
Создание/восстановление кошелька:
sided keys add <walletname> --key-type="segwit"
Загрузка Genesis:
wget -O $HOME/.side/config/genesis.json "https://raw.githubusercontent.com/111STAVR111/props/main/Side/genesis.json"
sha256sum $HOME/.side/config/genesis.json
Настройка параметров сети и пиров:
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.005uside\"/;" ~/.side/config/app.toml
external_address=$(wget -qO- eth0.me)
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:26656\"/" $HOME/.side/config/config.toml
peers="6bef0693d7a31fed473b95123ad19b544b414093@202.182.119.24:26656,44f8009ed91fddd7ee51117482ede20fb4f33e78@149.28.156.79:26656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.side/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.side/config/config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 50/g' $HOME/.side/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 50/g' $HOME/.side/config/config.toml
Настройка Pruning (опционально):
pruning="custom"
pruning_keep_recent="1000"
pruning_keep_every="0"
pruning_interval="10"
sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.side/config/app.toml
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.side/config/app.toml
sed -i -e "s/^pruning-keep-every *=.*/pruning-keep-every = \"$pruning_keep_every\"/" $HOME/.side/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.side/config/app.toml
Настройка Indexer (опционально):
indexer="null" &&
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.side/config/config.toml
Загрузка addrbook:
wget -O $HOME/.side/config/addrbook.json "https://raw.githubusercontent.com/111STAVR111/props/main/Side/addrbook.json"
Создание service-файла:
sudo tee /etc/systemd/system/sided.service > /dev/null <<EOF
[Unit]
Description=sided
After=network-online.target
[Service]
User=$USER
ExecStart=$(which sided) start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
StateSync Testnet
SNAP_RPC=https://side.rpc.t.stavr.tech:443
peers="fe54f3964664592b3be89eb685cc72e9aecb14e9@side-t.seed.stavr.tech:21306"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.side/config/config.toml
LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)); \
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/.side/config/config.toml
sided tendermint unsafe-reset-all --home /root/.side
wget -O $HOME/.side/config/addrbook.json "https://raw.githubusercontent.com/111STAVR111/props/main/Side/addrbook.json"
curl -o - -L https://side-t.wasm.stavr.tech/wasm-side.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.side --strip-components 2
systemctl restart sided && journalctl -fu sided -o cat
SnapShot Testnet
cd $HOME
apt install lz4
sudo systemctl stop sided
cp $HOME/.side/data/priv_validator_state.json $HOME/.side/priv_validator_state.json.backup
rm -rf $HOME/.side/data
curl -o - -L https://side-t.snapshot.stavr.tech/side-snap.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.side --strip-components 2
curl -o - -L https://side-t.wasm.stavr.tech/wasm-side.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.side --strip-components 2
mv $HOME/.side/priv_validator_state.json.backup $HOME/.side/data/priv_validator_state.json
wget -O $HOME/.side/config/addrbook.json "https://raw.githubusercontent.com/111STAVR111/props/main/Side/addrbook.json"
sudo systemctl restart sided && journalctl -u sided -f -o cat
Создание валидатора
sided tx staking create-validator \
--commission-rate 0.1 \
--commission-max-rate 0.1 \
--commission-max-change-rate 0.1 \
--min-self-delegation "1" \
--amount 1000000uside \
--pubkey $(sided tendermint show-validator) \
--from <wallet> \
--moniker="STAVRguide" \
--chain-id grimoria-testnet-1 \
--fees 300uside
Полезные команды
Service
Информация:
sided status 2>&1 | jq .NodeInfo
sided status 2>&1 | jq .SyncInfo
sided status 2>&1 | jq .ValidatorInfo
Проверка логов ноды:
sudo journalctl -fu sided -o cat
Проверка статуса сервиса:
sudo systemctl status sided
Перезапуск сервиса:
sudo systemctl restart sided
Остановка сервиса:
sudo systemctl stop sided
Запуск сервиса:
sudo systemctl start sided
Перезагрузка/отключение/включение:
sudo systemctl daemon-reload
sudo systemctl disable sided
sudo systemctl enable sided
Ваш Peer:
echo $(sided tendermint show-node-id)'@'$(wget -qO- eth0.me)':'$(cat $HOME/.side/config/config.toml | sed -n '/Address to listen for incoming connection/{n;p;}' | sed 's/.*://; s/".*//')
Работа с ключами
Создать новый ключ или восстановить:
sided keys add Wallet_Name
OR
sided keys add Wallet_Name --recover
Показать все ключи:
Проверка баланса:
sided query bank balances addressjkl1yjgn7z09ua9vms259j
Удалить ключ:
sided keys delete Wallet_Name
Экспортировать ключ:
Импортировать ключ:
sided keys import wallet wallet.backup
Управление валидатором
Редактирование валидатора:
sided tx staking edit-validator \
--new-moniker "Your_Moniker" \
--identity "Keybase_ID" \
--details "Your_Description" \
--website "Your_Website" \
--security-contact "Your_Email" \
--chain-id S2-testnet-1 \
--commission-rate 0.05 \
--from Wallet_Name \
--gas 350000 -y
Ваш Valoper-Address:
sided keys show Wallet_Name --bech val
Ваш Valcons-Address:
sided tendermint show-address
Информация о вашем валидаторе:
sided query staking validator valoperaddress......
Информация о Jail:
sided query slashing signing-info $(sided tendermint show-validator)
Unjail:
sided tx slashing unjail --from Wallet_name --chain-id S2-testnet-1 --gas 350000 -y
Список активных валидаторов:
sided 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
Список неактивных валидаторов:
sided 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
Проверка соответствия ключа валидатора:
VALOPER=Enter_Your_valoper_Here
[[ $(sided q staking validator $VALOPER -oj | jq -r .consensus_pubkey.key) = $(sided status | jq -r .ValidatorInfo.PubKey.value) ]] && echo -e "\nYou win\n" || echo -e "\nYou lose\n"
Вывод всех наград со всех валидаторов:
sided tx distribution withdraw-all-rewards --from Wallet_Name --chain-id S2-testnet-1 --gas 350000 -y
Вывод награды и комиссии с вашего валидатора:
sided tx distribution withdraw-rewards valoper1a........ --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 --commission -y
Делегирование токенов вашему валидатору:
sided tx staking delegate Your_valpoer........ "100000000"uside --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Делегирование токенов другому валидатору:
sided tx staking delegate valpoer........ "100000000"uside --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Ределегирование токенов другому валидатору:
sided tx staking redelegate Your_valpoer........ valpoer........ "100000000"uside --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Анбондинг токенов от вашего валидатора или другого валидатора:
sided tx staking unbond Your_valpoer........ "100000000"uside --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
sided tx staking unbond valpoer........ "100000000"uside --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Перевод токенов с кошелька на кошелек:
sided tx bank send Your_address............ address........... "1000000000000000000"uside --gas 350000 --chain-id=S2-testnet-1 -y
Голосование
Просмотр всех предложений:
sided query gov proposals
Просмотр конкретного предложения:
sided query gov proposal 1
Голосование "за":
sided tx gov vote 1 yes --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Голосование "против":
sided tx gov vote 1 no --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Воздержаться:
sided tx gov vote 1 abstain --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y
Голосование "против с вето":
sided tx gov vote 1 no_with_veto --from Wallet_Name --gas 350000 --chain-id=S2-testnet-1 -y