ARCHIVE
May 31, 2023

Archway

🪓 Telegram канал UTSA 🪓 Telegram чат UTSA

Web Discord Github

Details

Подача Gentx - mainnet

Сначала не забываем обновить репозитории и установить GO

https://docs.archway.io/validators/becoming-a-validator/running-a-validator-node

Устанавливаем бинарные файлы

git clone https://github.com/archway-network/archway && cd archway
git checkout v1.0.0
make install

archwayd version --long | grep -e version -e commit
# version: v1.0.0
# commit: 62fd473e7f0f31489600f81a8f745f73f1284281

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

archwayd init <name_node> --chain-id archway-1
archwayd config chain-id archway-1

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

# создаем или восстанавливаем кошелек (после команды вставить seed)
archwayd keys add <key-name>
archwayd keys add <key-name> --recover

Добавляем учетную запись в свой локальный файл genesis с заданной суммой и ключом, которые вы только что создали

archwayd add-genesis-account <address_or_key_name> 10000000000000000000aarch --keyring-backend os

Создаем Gentx (предварительно меняем под себя к примеру в блокноте)

archwayd gentx <name_wallet> 9500000000000000000aarch \
  --chain-id archway-1 \
  --commission-rate="0.01" \
  --commission-max-rate="0.10" \
  --commission-max-change-rate="0.1" \
  --pubkey $(archwayd tendermint show-validator) \
  --moniker="<moniker-name>" \
  --website=<your-node-website> \
  --details=<your-node-details> \
  --min-self-delegation="1" \
  --fees 180000000000000000aarch

Просмотреть Gentx

cat ~/.archway/config/gentx/gentx-*

Обновления

# проверяем статус prevotes/precommits
FOLDER=.archway

# узнать порт RPC
echo -e "\033[0;32m$(grep -A 3 "\[rpc\]" ~/$FOLDER/config/config.toml | egrep -o ":[0-9]+")\033[0m"

PORT=<ввести свой порт>

# Проверка prevotes/precommits. Пригодится при обновах
curl -s localhost:$PORT/consensus_state | jq '.result.round_state.height_vote_set[0].prevotes_bit_array' && \
curl -s localhost:$PORT/consensus_state | jq '.result.round_state.height_vote_set[0].precommits_bit_array'

UPD 🕊 на v1.0.1 (Высота обновления: без нарушения консенсуса)

cd $HOME/archway
git pull
git checkout v1.0.1
make build
$HOME/archway/build/archwayd version --long | grep -e version -e commit
# version: 1.0.1
# commit: 86409142585b7157c628ca52b8357002fe60a165

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!
systemctl stop archwayd
mv $HOME/archway/build/archwayd $(which archwayd)
archwayd version --long | grep -e version -e commit
# 

systemctl restart archwayd && journalctl -u archwayd -f -o cat

UPD 🕊 на v2.0.0 (Высота обновления: 525000)

cd $HOME/archway
git pull
git checkout v2.0.0
make build
$HOME/archway/build/archwayd version --long | grep -e version -e commit
# version: 2.0.0
# commit: d6c5cf4509e1c848f26d539c3519685f1d323dfd

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!
systemctl stop archwayd
mv $HOME/archway/build/archwayd $(which archwayd)
archwayd version --long | grep -e version -e commit
# 

systemctl restart archwayd && journalctl -u archwayd -f -o cat

UPD 🕊 на v4.0.3 (Высота обновления: 1215711)

cd $HOME/archway
git pull
git checkout v4.0.3
make build
$HOME/archway/build/archwayd version --long | grep -e version -e commit
# version: 4.0.3
# commit: 3cc9228982f651d3a54b395d6ff026e61e91f4b6

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!
systemctl stop archwayd
mv $HOME/archway/build/archwayd $(which archwayd)
archwayd version --long | grep -e version -e commit
# 

systemctl restart archwayd && journalctl -u archwayd -f -o cat

UPD 🕊 на v6.0.2 (Высота обновления: 3554500)

cd $HOME/archway
git pull
git checkout v6.0.2
make build
$HOME/archway/build/archwayd version --long | grep -e version -e commit
# version: 6.0.2
# commit: a72ebfe851fc980586b253958196f7b449ac9fe8

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!
systemctl stop archwayd
mv $HOME/archway/build/archwayd $(which archwayd)
archwayd version --long | grep -e version -e commit
# 

systemctl restart archwayd && journalctl -u archwayd -f -o cat

UPD 🕊 на v7.0.0 (Высота обновления: 4473000)

cd $HOME/archway
git pull
git checkout v8.0.0
make build
$HOME/archway/build/archwayd version --long | grep -e version -e commit
# version: 8.0.0
# commit: e92af8cddf06c6d3e9d0205369f9a6f2c6f5985b

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!
systemctl stop archwayd
mv $HOME/archway/build/archwayd $(which archwayd)
archwayd version --long | grep -e version -e commit
# 

systemctl restart archwayd && journalctl -u archwayd -f -o cat

Подготовка сервера

# обновляем репозитории
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

File2Ban - подробнее здесь и здесь

# устанавливаем и копируем конфиг, который будет иметь больший приоритет
apt install fail2ban -y && \
cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local && \
nano /etc/fail2ban/jail.local
# раскомментировать и добавить свой IP: ignoreip = 127.0.0.1/8 ::1 <ip>
systemctl restart fail2ban

# проверяем status 
systemctl status fail2ban
# проверяем, какие jails активны (по умолчанию только sshd)
fail2ban-client status
# проверяем статистику по sshd
fail2ban-client status sshd
# смотрим логи
tail /var/log/fail2ban.log
# останавливаем работу и удаляем с автозагрузки
#systemctl stop fail2ban && systemctl disable fail2ban

Устанавливаем GO

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

Новая установка ноды

ВАЖНО — в командах ниже все, что в <> меняем на свое значение и убираем сами <>

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

git clone https://github.com/archway-network/archway && cd archway
git checkout v8.0.0
make install

archwayd version --long | grep -e version -e commit
# version: 8.0.0
# commit: e92af8cddf06c6d3e9d0205369f9a6f2c6f5985b

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

archwayd init UTSA_guide --chain-id archway-1

Скачиваем Genesis

wget -O $HOME/.archway/config/genesis.json "https://share.utsa.tech/archway/genesis.json"

# Проверим генезис
shasum -a 256 $HOME/.archway/config/genesis.json
#b7c63fc5705c0e11a73e7278b93fba3ba93691ddd5b02b8e72503dd7221e25af

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

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

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

Скачиваем Addr book

wget -O $HOME/.archway/config/addrbook.json "https://share.utsa.tech/archway/addrbook.json"

Настраиваем конфигурацию ноды

# правим конфиг, благодаря чему мы можем больше не использовать флаг chain-id для каждой команды CLI в client.toml
archwayd config chain-id archway-1
# при необходимости настраиваем keyring-backend в client.toml 
archwayd config keyring-backend os
# настраиваем минимальную цену за газ в app.toml
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"140000000000aarch\"/;" ~/.archway/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/.archway/config/config.toml
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.archway/config/config.toml
seeds="[email protected]:26656"
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.archway/config/config.toml
# при необходимости увеличиваем количество входящих и исходящих пиров для подключения, за исключением постоянных пиров в config.toml
sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 40/g' $HOME/.archway/config/config.toml
sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 20/g' $HOME/.archway/config/config.toml
# настраиваем фильтрацию "плохих" peers
sed -i -e "s/^filter_peers *=.*/filter_peers = \"true\"/" $HOME/.archway/config/config.toml
# Consensus
#sed -i -e "s/^timeout_commit *=.*/timeout_commit = \"10s\"/" $HOME/.archway/config/config.toml
#sed -i -e "s/^timeout_propose *=.*/timeout_propose = \"10s\"/" $HOME/.archway/config/config.toml
#sed -i -e "s/^create_empty_blocks_interval *=.*/create_empty_blocks_interval = \"10s\"/" $HOME/.archway/config/config.toml
#sed -i 's/create_empty_blocks = .*/create_empty_blocks = true/g' ~/.archway/config/config.toml
#sed -i 's/timeout_broadcast_tx_commit = ".*s"/timeout_broadcast_tx_commit = "10s"/g' ~/.archway/config/config.tom

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

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

Также можно самостоятельно настроить параметр min-retain-blocks: Это значение относится к обрезке блоков Tendermint. Оно отличается от настроек обычного Pruning. Если min-retain-blocks=0, то ничего не удаляется.

min-retain-blocks определяет минимальное смещение высоты блока от текущего фиксируемого блока, так что все блоки, превышающие это смещение, удаляются из Tendermint

min-retain-blocks=10

inter-block-cache = false

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

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

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

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

(ОПЦИОНАЛЬНО) Смена портов #для 2 ноды

# 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/.archway/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\"%; s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:1327\"%" $HOME/.archway/config/app.toml
# client.toml
sed -i.bak -e "s%^node = \"tcp://localhost:26657\"%node = \"tcp://localhost:36657\"%" $HOME/.archway/config/client.toml
external_address=$(wget -qO- eth0.me)
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:36656\"/" $HOME/.archway/config/config.toml

Подробнее о смене портов здесь

(ОПЦИОНАЛЬНО) State Sync


# при необходимости скачиваем wasm
curl -L https://share.utsa.tech/archway/wasm-archway.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.archway --strip-components 2
# добавляем пир
peers="[email protected]:56656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.archway/config/config.toml
SNAP_RPC=https://m-archway.rpc.utsa.tech:443

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/.archway/config/config.toml
systemctl restart archwayd && journalctl -u archwayd -f -o cat

Важно - для разных блокчейнов нужно разное количество RAM для успешного старта со State sync

systemctl stop archwayd
archwayd tendermint unsafe-reset-all --home $HOME/.archway --keep-addr-book

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

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

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

[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable archwayd
systemctl restart archwayd && journalctl -u archwayd -f -o cat

Если после старта нода долго не может подцепиться к пирам, то ищем новые пиры или просим addrbook.json в дискорд

# стопаем ноду, удаляем адресную книгу и сбрасываем данные
systemctl stop archwayd
rm $HOME/.archway/config/addrbook.json
archwayd tendermint unsafe-reset-all --home $HOME/.archway

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

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

# создать кошелек
archwayd keys add <name_wallet> --keyring-backend os
# восстановить кошелек (после команды вставить seed)
archwayd keys add <name_wallet> --recover --keyring-backend os
# восстановить кошелек для EVM сетей
archwayd keys add <name_wallet> --recover --coin-type 118 --algo secp256k1

Не забываем сохранить seed !!!

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

archwayd tx staking create-validator \
--chain-id archway-1 \
--commission-rate 0.05 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.1 \
--min-self-delegation "1000000" \
--amount 1000000000000000000aarch \
--pubkey $(archwayd tendermint show-validator) \
--moniker "<name_moniker>" \
--from <name_wallet> \
--fees 230400000000000000aarch \
--gas 256000

Не забываем сохранить priv_validator_key.json !!!

Подробнее о создании/редактировании валидатора можно почитать здесь

Полезные команды

Для добавления лого в mintscan (ТОЛЬКО ДЛЯ MINTSCAN):

  • форк https://github.com/cosmostation/chainlist
  • в папке Moniker находим название проекта
  • через add file/upload file добавляем свою аватарку. название файла обязательно должно быть валопер.png . и только png
  • PR

Информация

# проверить блоки
archwayd status 2>&1 | jq ."SyncInfo"."latest_block_height"
# проверить логи
journalctl -u archwayd -f -o cat
# проверить статус
curl localhost:26657/status
# проверить баланс
archwayd q bank balances <address>
# проверить pubkey валидатора
archwayd tendermint show-validator
# проверить валидатора
archwayd query staking validator <valoper_address>
archwayd query staking validators --limit 1000000 -o json | jq '.validators[] | select(.description.moniker=="<name_moniker>")' | jq
# проверка информации по TX_HASH
archwayd query tx <TX_HASH>
# параметры сети
archwayd q staking params
archwayd q slashing params
# проверить сколько блоков пропущено валидатором и с какого блока актив
archwayd q slashing signing-info $(archwayd tendermint show-validator)
# узнать транзакцию создания валидатора (заменить свой valoper_address)
archwayd query txs --events='create_validator.validator=<your_valoper_address>' -o=json | jq .txs[0].txhash -r
# просмотр активного сета
archwayd q staking validators -o json --limit=1000 \
| jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' \
| jq -r '.tokens + " - " + .description.moniker' \
| sort -gr | nl
# просмотр неактивного сета
archwayd q staking validators -o json --limit=1000 \
| jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' \
| jq -r '.tokens + " - " + .description.moniker' \
| sort -gr | nl

Транзакции

# собрать реварды со всех валидаторов, которым делегировали (без комиссии)
archwayd tx distribution withdraw-all-rewards --from <name_wallet> --fees 230400000000000000aarch --gas 256000 -y
# собрать реварды c отдельного валидатора или реварды + комиссию со своего валидатора
archwayd tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --fees 230400000000000000aarch --gas 256000 --commission -y
# заделегировать себе в стейк еще (так отправляется 1 монетa)
archwayd tx staking delegate <valoper_address> 1000000aarch --from <name_wallet> --fees 230400000000000000aarch --gas 256000 -y
# ределегирование на другого валидатора
archwayd tx staking redelegate <src-validator-addr> <dst-validator-addr> 1000000aarch --from <name_wallet> --fees 230400000000000000aarch --gas 256000 -y
# unbond 
archwayd tx staking unbond <addr_valoper> 1000000aarch --from <name_wallet> --fees 230400000000000000aarch --gas 256000 -y
# отправить монеты на другой адрес
archwayd tx bank send <name_wallet> <address> 1000000aarch --fees 230400000000000000aarch --gas 256000 -y
# выбраться из тюрьмы
archwayd tx slashing unjail --from <name_wallet> --fees 230400000000000000aarch --gas 256000 -y

! Если транзакции не отправляются с ошибкой account sequence mismatch, expected 18, got 17: incorrect account sequence, то добавьте в команду ключ -s 18 (номер замените на тот, который ждет sequence)

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

# вывести список кошельков
archwayd keys list
# показать ключ аккаунта
archwayd keys show <name_wallet> --bech acc
# показать ключ валидатора
archwayd keys show <name_wallet> --bech val
# показать ключ консенсуса
archwayd keys show <name_wallet> --bech cons
# показать все поддерживаемые адреса
archwayd debug addr <wallet_addr>
# показать приватный ключ
archwayd keys export <name_wallet> --unarmored-hex --unsafe
# запрос учетной записи
archwayd q auth account $(archwayd keys show <name_wallet> -a) -o text
# удалить кошелек
archwayd keys delete <name_wallet>
# проверяем награды на кошельке через genesis
jq '.app_state.bank.balances[]|select(.address=="<addr_wallet>")' $HOME/.archway/config/genesis.json
grep -C 10 <addr_wallet> $HOME/.archway/config/genesis.json

Удалить ноду

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

ГОВЕРНАНС (подробнее здесь)

# список proposals
archwayd q gov proposals
# посмотреть результат голосования
archwayd q gov proposals --voter <ADDRESS>
# проголосовать за предложение 
archwayd tx gov vote 1 yes --from <name_wallet> --fees 555aarch
# внести депозит в предложение
archwayd tx gov deposit 1 1000000aarch --from <name_wallet> --fees 230400000000000000aarch --gas 256000
# создать предложение
archwayd 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 500aarch

Peers and RPC

FOLDER=.archway

# узнать свой peer
PORTR=$(grep -A 3 "\[p2p\]" ~/$FOLDER/config/config.toml | egrep -o ":[0-9]+") && \
echo $(archwayd tendermint show-node-id)@$(wget -qO- eth0.me)$PORTR
# узнать порт RPC
echo -e "\033[0;32m$(grep -A 3 "\[rpc\]" ~/$FOLDER/config/config.toml | egrep -o ":[0-9]+")\033[0m"
# проверка количества пиров
PORT=
curl -s http://localhost:$PORT/net_info | jq -r '.result.peers[] | "\(.node_info.id)@\(.remote_ip):\(.node_info.listen_addr | split(":")[2])"' | wc -l
# cписок моникеров подключенных пиров
curl -s http://localhost:$PORT/net_info | jq '.result.peers[].node_info.moniker'
# Проверка prevotes/precommits. Пригодится при обновах
curl -s localhost:$PORT/consensus_state | jq '.result.round_state.height_vote_set[0].prevotes_bit_array' && \
curl -s localhost:$PORT/consensus_state | jq '.result.round_state.height_vote_set[0].precommits_bit_array'
# check prevote of your validator
curl -s localhost:$PORT/consensus_state -s | grep $(curl -s localhost:26657/status | jq -r .result.validator_info.address[:12])
Поддержим природу вместе: 0xa7476EC14cD663C742d527113638C77a1631Cc89 cosmos1m2mm7kzvw6m3464h94ryqg8xvr6tyeyyecppnq