NexaRail

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

Details

• Network Chain ID: nexarail-mainnet-1
• Denom: unxrl
• Binary: nexaraild
• Working directory: .nexarail
• RPC: https://m-nexarail.rpc.utsa.tech/
• API: https://m-nexarail.api.utsa.tech/
• Explorers: https://exp.utsa.tech/nexarail
• Docs:

git clone https://github.com/Bookings-cpu/nexarail && cd nexarail
#git checkout v0.1.0-rc1-validator-recovery-hotfix
#make build
#cp ./build/nexaraild $HOME/go/bin/

wget https://github.com/Bookings-cpu/nexarail/releases/download/v0.1.0-rc1-validator-recovery-hotfix/nexaraild-linux-amd64
cp $HOME/nexarail/nexaraild-linux-amd64 $HOME/go/bin/nexaraild

nexaraild version
# ABCI: 1.0.0
# BlockProtocol: 11
# P2PProtocol: 8
# Tendermint: 0.37.16

sha256sum $HOME/go/bin/nexaraild
# cdb03d84e2d998e3581f368cc3440fce179c34010398c7343298e94a3d82112c

nexaraild init <moniker> --chain-id nexarail-mainnet-1
sed -i.bak -e "s/^chain-id *=.*/chain-id = \"nexarail-mainnet-1\"/;" ~/.nexarail/config/client.toml
sed -i.bak -e "s/^keyring-backend *=.*/keyring-backend = \"os\"/;" ~/.nexarail/config/client.toml

nexaraild keys add <name_wallet> --keyring-backend os
#nexaraild keys add <name_wallet> --recover --keyring-backend os

nexaraild keys show <name_wallet> --bech val --keyring-backend os
# 

nexaraild add-genesis-account <ADDR> 7142857142857unxrl

nexaraild gentx <name_wallet> 7000000000000unxrl \
  --chain-id "nexarail-mainnet-1" \
  --commission-rate "0.10" \
  --commission-max-rate "0.20" \
  --commission-max-change-rate "0.01" \
  --pubkey $(nexaraild tendermint show-validator) \
  --moniker "<moniker>" \
  --keyring-backend "os" \
  --min-self-delegation "1000000"

shasum -a 256 "$HOME/.nexarail/config/gentx/gentx-"*.json

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

# устанавливаем необходимые утилиты
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

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.22.13" && \
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/Bookings-cpu/nexarail && cd nexarail
#git checkout v0.1.0-rc1-validator-recovery-hotfix
#make build
#cp ./build/nexaraild $HOME/go/bin/

wget https://github.com/Bookings-cpu/nexarail/releases/download/v0.1.0-rc1-validator-recovery-hotfix/nexaraild-linux-amd64
cp $HOME/nexarail/nexaraild-linux-amd64 $HOME/go/bin/nexaraild

nexaraild version
# ABCI: 1.0.0
# BlockProtocol: 11
# P2PProtocol: 8
# Tendermint: 0.37.16

sha256sum $HOME/go/bin/nexaraild
# cdb03d84e2d998e3581f368cc3440fce179c34010398c7343298e94a3d82112c

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

nexaraild init UTSA_guide --chain-id nexarail-mainnet-1

Скачиваем Genesis

wget -O $HOME/.nexarail/config/genesis.json "https://github.com/Bookings-cpu/nexarail/releases/download/mainnet-genesis-nexarail-mainnet-1/genesis.json"

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

Скачиваем Addr book

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

# правим конфиг, благодаря чему мы можем больше не использовать флаг chain-id для каждой команды CLI в client.toml
sed -i.bak -e "s/^chain-id *=.*/chain-id = \"nexarail-mainnet-1\"/;" ~/.nexarail/config/client.toml
sed -i.bak -e "s/^keyring-backend *=.*/keyring-backend = \"os\"/;" ~/.nexarail/config/client.toml

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

peers="96e659f9a87723304dcd614e3ca89d9b6daf26cc@bore.pub:32656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.nexarail/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.nexarail/config/config.toml

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

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

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

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

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

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

snapshot_interval=1000
sed -i.bak -e "s/^snapshot-interval *=.*/snapshot-interval = \"$snapshot_interval\"/" ~/.nexarail/config/app.toml

# add peer
peers="8c87ce08820b7f9d717da4d4a82eae1aac234911@144.76.29.90:60756"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.nexarail/config/config.toml

SNAP_RPC=https://m-nexarail.rpc.utsa.tech:443

LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \
BLOCK_HEIGHT=$((LATEST_HEIGHT - 100)); \
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/.nexarail/config/config.toml

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

cd $HOME
systemctl stop nexaraild

cp $HOME/.nexarail/data/priv_validator_state.json $HOME/.nexarail/priv_validator_state.json.backup

# удаляем старую базу данных
rm -rf $HOME/.nexarail/data/{application.db,evidence.db,snapshots,tx_index.db,blockstore.db,state.db,cs.wal}

# скачиваем snapshot
curl -o - -L https://share.utsa.tech/nexarail/nexarail.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.nexarail/

mv $HOME/.nexarail/priv_validator_state.json.backup $HOME/.nexarail/data/priv_validator_state.json

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

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

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

[Service]
User=$USER
ExecStart=$(which nexaraild) start --home /root/.nexarail --minimum-gas-prices 0.025unxrl
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

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

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

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

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

• Moniker
• Validator operator address

nexaraild keys show wallet --bech val

• Public key

nexaraild tendermint show-validator

Информация

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

# просмотр активного сета
nexaraild query tendermint-validator-set \
  --limit 1000 \
  -o json | jq -r '
.validators[]
| "\(.address) power=\(.voting_power) proposer_priority=\(.proposer_priority)"
'

Транзакции

# собрать комиссионные + реварды
nexaraild tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --keyring-backend os --fees 5000unxrl --commission -y

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

# ределегирование на другого валидатора
nexaraild tx staking redelegate <src-validator-addr> <dst-validator-addr> 1000000unxrl --from <name_wallet> --keyring-backend os --fees 5000unxrl -y

# unbond 
nexaraild tx staking unbond <addr_valoper> 1000000unxrl --from <name_wallet> --keyring-backend os --fees 5000unxrl -y

# отправить монеты на другой адрес
nexaraild tx send <name_wallet> <address> 1000000unxrl --keyring-backend os --fees 5000unxrl -y

# выбраться из тюрьмы
nexaraild tx slashing unjail --from <name_wallet> --keyring-backend os --fees 5000unxrl -y

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

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

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

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

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

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

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

Удалить ноду

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

ГОВЕРНАНС

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

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

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

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

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

Peers and RPC

FOLDER=.nexarail

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