Airchains

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

Details

• Network Chain ID: varanasi-1
• Denom: uamf
• Binary: junctiond
• Working directory: .junctiond
• RPC: https://t-airchains.rpc.utsa.tech/
• API: https://t-airchains.api.utsa.tech/
• Explorers: https://exp.utsa.tech/airchains-test/staking
• Docs: https://docs.airchains.io/
• Faucet: discord

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

# узнать порт 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'

mkdir -p $HOME/airchains && cd airchains
wget -O junctiond https://github.com/airchains-network/junction/releases/download/v0.2.0/junctiond-linux-amd64
chmod +x junctiond
$HOME/airchains/junctiond version --long | grep -e version -e commit
# version: v0.1.0
# commit: e3dd056fd17970e2e3a032afb0f2e293d222f2fe

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

systemctl restart junctiond && journalctl -u junctiond -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.23.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

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 
rustc --version

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

# если не установлен каталог GO, то создаейте его
mkdir -p $HOME/go/bin

mkdir -p $HOME/airchains && cd airchains

wget -O junctiond https://github.com/airchains-network/junction/releases/download/v0.3.1/junctiond-linux-amd64
chmod +x junctiond
mv $HOME/airchains/junctiond $HOME/go/bin/

junctiond version --long | grep -e version -e commit
# version: v0.3.1
# commit: 4e7ded5ecb7d8bcbe9976f74db87c33a679a165e

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

junctiond init UTSA_guide --chain-id varanasi-1 --default-denom uamf

Скачиваем Genesis

#скачиваем genesis
wget -O $HOME/.junctiond/config/genesis.json "https://raw.githubusercontent.com/airchains-network/junction-resources/refs/heads/main/varanasi-testnet/genesis/genesis.json"

# Проверим генезис
sha256sum ~/.junctiond/config/genesis.json
# 2ed96ef2262d9f089a972ceaff36c416ff382ef7a26494b1d588da93713dd15c

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

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

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

Скачиваем Addr book

wget -O $HOME/.junctiond/config/addrbook.json "https://share102.utsa.tech/airchains/addrbook.json"

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

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

# настраиваем минимальную цену за газ в app.toml
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.00025uamf\"/;" ~/.junctiond/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/.junctiond/config/config.toml

peers="cfb052e64e508f4b40f0ec07b52a31abfda82270@95.217.62.179:11956,db686fcfdf0b4676d601d5beb11faee5ad96bff1@37.27.71.199:28656,ec7d3566e70f479a4a6dd98d1e02e8827cf34f76@72.251.3.24:56256,f84b41b95e828ee915aea19dd656cca7d39cf47b@37.17.244.207:33656,306e1cc0936111831eedfa861abe3989d04acc19@158.220.114.0:26656,c0f3abcd838aeb72f6c7a1c817407bfe021547f3@135.181.139.249:26656"
sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$peers\"|" $HOME/.junctiond/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.junctiond/config/config.toml

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

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

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

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

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

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

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

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

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

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

# при необходимости скачиваем wasm

# добавляем пир
peers="d4fd89f3e5b96be9c1ebf86fb5f3d5dd4059332f@5.9.87.231:36656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.junctiond/config/config.toml

#SNAP_RPC=https://airchains.rpc.t.stavr.tech:443
SNAP_RPC=https://t-airchains.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/.junctiond/config/config.toml

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

# при ошибке очищаем базу данных
systemctl stop junctiond
junctiond tendermint unsafe-reset-all --home $HOME/.junctiond --keep-addr-book

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

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

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

[Install]
WantedBy=multi-user.target
EOF

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

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

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

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

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

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

# восстановить кошелек для EVM сетей
junctiond keys add <name_wallet> --recover --coin-type 118 --algo secp256k1

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

1. Получаем свой pubkey

junctiond comet show-validator
# {"@type":"/cosmos.crypto.ed25519.PubKey","key":"ZXONS7NNjLWH4HePBOoHKDAYeLXQO5iUwpCRQSi1poI="}

2. Создаем validator.json

nano $HOME/.junctiond/validator.json

3. Вставляем наш конфиг

{
  "pubkey": {#pubkey},
  "amount": "1000000uamf",
  "moniker": "moniker",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.05",
  "commission-max-rate": "0.5",
  "commission-max-change-rate": "0.5",
  "min-self-delegation": "1"
}

4. Отправляем транзакцию

junctiond tx staking create-validator $HOME/.junctiond/validator.json \
    --from=<key-name> \
    --chain-id=varanasi-1 \
    --fees=500uamf

Информация

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

Транзакции

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

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

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

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

# unbond 
junctiond tx staking unbond <addr_valoper> 1000000uamf --from <name_wallet> --fees=500uamf -y

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

# выбраться из тюрьмы
junctiond tx slashing unjail --from <name_wallet> --fees=500uamf -y

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

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

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

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

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

# показать все поддерживаемые адреса
junctiond debug addr <wallet_addr>

# показать приватный ключ
junctiond keys export <name_wallet> --unarmored-hex --unsafe
junctiond keys unsafe-export-eth-key <name_wallet>

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

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

Удалить ноду

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

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

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

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

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

# внести депозит в предложение
junctiond tx gov deposit 1 1000000uamf --from <name_wallet> --fees=500uamf

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

Peers and RPC

FOLDER=.junctiond

# узнать свой peer
PORTR=$(grep -A 3 "\[p2p\]" ~/$FOLDER/config/config.toml | egrep -o ":[0-9]+") && \
echo $(junctiond 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])