COSMOS
November 15

Atlas

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

Web Discord Github

Details

Обновления

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

# узнать порт 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 🕊 v (Высота обновления: )

cd $HOME/atlas
mkdir -p $HOME/atlas/build
git pull
git checkout v0.1.3
GOTOOLCHAIN=go1.26.5 GOBIN=$HOME/atlas/build make install

$HOME/atlas/build/atlasd version --long | grep -e version -e commit
# version: 
# commit: 

# AFTER STOPPING THE NETWORK ON THE REQUIRED BLOCK!!!
systemctl stop atlasd
mv $HOME/atlas/build/atlasd $HOME/go/bin/atlasd
atlasd version --long | grep -e version -e commit
#

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

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

# обновляем репозитории
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.24.5" && \
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/atlas-depin/atlas && cd atlas
git checkout v0.1.0
make install

atlasd version --long
#version: HEAD-a0d2fd0a6d4ebdc1136d671ffebc8976a143ab10
#commit: a0d2fd0a6d4ebdc1136d671ffebc8976a143ab10

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

atlasd init UTSA_guide --chain-id itineraria-1

Скачиваем Genesis

wget -O $HOME/.atlas/config/genesis.json "https://raw.githubusercontent.com/atlas-depin/networks/refs/heads/main/testnet/genesis/genesis.json"

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

Скачиваем Addr book

#wget -O $HOME/.atlas/config/addrbook.json "https://share103.utsa.tech/atlas/addrbook.json"

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

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

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

peers="0b74c3e67f36bd1a808a5da2cb21f0e831270171@188.68.36.11:28656,c1f90424ad4224b9fd8fd756f602bc5489209db5@65.109.32.61:14356,565f78d4137b3af129cab42e582563ccc83d225f@195.3.222.20:28656,0a6f897a1ba27fd726a8e41074c8a79abb0626ef@95.216.102.220:11556,cb05c18878c91a269dcd656f674fca23ece36837@116.202.218.189:32656,5fdf5cebdca8f41238b9a81a5cc19a1cca0ca566@146.19.24.32:56656,e701138b2a23db46f8fd9518a6cd7669b2f8c679@69.129.192.135:46656,412f338fe2e8e1de27dc33e99a515f4292f837b5@42.119.242.229:26651,9551a410d0038c0f32dadb1d90d76b11d453d75f@65.108.229.19:27016,91afae91a317103d11ba9f876e173a7574ce5fcf@155.94.170.5:26656,875b69641b227f33c8e22cf0396753da46da8ea3@192.3.154.237:26656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.atlas/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.atlas/config/config.toml

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

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

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

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

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

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

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

State sync

systemctl stop atlasd
atlasd comet unsafe-reset-all --home $HOME/.atlas --keep-addr-book
# add peer
peers=""
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.atlas/config/config.toml
SNAP_RPC=https://atlas.rpc.t.anode.team: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/.atlas/config/config.toml
systemctl restart atlasd && journalctl -u atlasd -f -o cat

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

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

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

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

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

# создать кошелек
atlasd keys add <name_wallet>

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

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

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

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

atlasd comet show-validator
#

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

nano $HOME/.atlas/validator.json

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

{
  "pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"<from: atlasd comet show-validator>"},
  "amount": "1000000uatl",
  "moniker": "community-1",
  "identity": "",
  "website": "",
  "security": "",
  "details": "",
  "commission-rate": "0.10",
  "commission-max-rate": "0.20",
  "commission-max-change-rate": "0.01",
  "min-self-delegation": "1"
}

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

atlasd tx staking create-validator $HOME/.atlas/validator.json \
  --from <wallet_name> --chain-id itineraria-1 --gas auto --gas-adjustment 1.3 --fees 20000uatl -y

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

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

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

Информация

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

Транзакции

# собрать комиссионные + реварды
atlasd tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --gas auto --gas-adjustment 1.3 --fees 20000uatl --commission -y

# заделегировать себе в стейк еще (так отправляется 1 монетa)
atlasd tx staking delegate <valoper_address> 1000000000000000000uatl --from <name_wallet> --gas auto --gas-adjustment 1.3 --fees 20000uatl -y

# ределегирование на другого валидатора
atlasd tx staking redelegate <src-validator-addr> <dst-validator-addr> 1000000000000000000uatl --from <name_wallet> --gas auto --gas-adjustment 1.3 --fees 20000uatl -y

# unbond 
atlasd tx staking unbond <addr_valoper> 1000000000000000000uatl --from <name_wallet> --gas auto --gas-adjustment 1.3 --fees 20000uatl -y

# отправить монеты на другой адрес
atlasd tx send <name_wallet> <address> 1000000000000000000uatl --gas auto --gas-adjustment 1.3 --fees 20000uatl -y

# выбраться из тюрьмы
atlasd tx slashing unjail --from <name_wallet --gas auto --gas-adjustment 1.3 --fees 20000uatl -y

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

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

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

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

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

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

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

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

Удалить ноду

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

ГОВЕРНАНС

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

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

# проголосовать за предложение 
atlasd tx gov vote 1 yes --from <name_wallet> --gas auto --gas-adjustment 1.3 --fees 20000uatl

# внести депозит в предложение
atlasd tx gov deposit 1 1000000uatl --from <name_wallet> --gas auto --gas-adjustment 1.3 --fees 20000uatl

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

Peers and RPC

FOLDER=".atlas"

NODE_ID=$(atlasd comet show-node-id --home $HOME/$FOLDER)
PORT=$(sed -n '/^\[p2p\]/,/^\[/p' $HOME/$FOLDER/config/config.toml | grep '^laddr' | grep -oE ':[0-9]+' | tr -d ':')
IP=$(curl -4 -s https://api.ipify.org)

echo "${NODE_ID}@${IP}:${PORT}"

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