Entangle
- Network Chain ID:
entangle_33133-1
- Denom:
aNGL
- Binary:
entangled
- Working directory:
.entangled
- API:
- RPC:
- Explorers: 1 2
- Docs: https://entangle-protocol.gitbook.io/entangle-protocol/validator-guidelines-technical
Portal - https://test.entangle.fi/
Форма после создания валидатора - https://docs.google.com/forms/d/e/1FAIpQLSdbz39mklMegjmw4G4EBzvBbb-IAEOJrooOUwTesIc6xnDGUA/viewform
Обновления
# проверяем статус prevotes/precommits FOLDER=.entangled # узнать порт 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 🕊 на (Высота обновления: )
cd $HOME/entangle-blockchain git pull git checkout make build $HOME/entangle-blockchain/build/entangled version --long | grep -e version -e commit # version: # commit: # ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!! systemctl stop entangled mv $HOME/entangle-blockchain/build/entangled $(which entangled) entangled version --long | grep -e version -e commit # systemctl restart entangled && journalctl -u entangled -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
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/Entangle-Protocol/entangle-blockchain && cd entangle-blockchain make install entangled version --long | grep -e version -e commit #version: 1.0.1 #commit: "134d9e558aee52abe81fa825272d118f293036f6"
Инициализируем ноду, чтобы создать необходимые файлы конфигурации
entangled init UTSA_guide --chain-id entangle_33133-1
#скачиваем genesis wget -O $HOME/.entangled/config/genesis.json "https://entangle-public.s3.amazonaws.com/genesis.json" #cp -f config/config.toml $HOME/.entangled/config #cp -f config/genesis.json $HOME/.entangled/config # Проверим генезис sha256sum ~/.entangled/config/genesis.json # ca032fabda646ad98f4709e1e6fd4f06b31435b4a37d62a3539793944bfda692
Проверяем, что состояние валидатора на начальном этапе
cd && cat .entangled/data/priv_validator_state.json { "height": "0", "round": 0, "step": 0 } # если нет, то выполняем команду entangled tendermint unsafe-reset-all --home $HOME/.entangled
wget -O $HOME/.entangled/config/addrbook.json "https ://raw.githubusercontent.com/obajay/nodes-Guides/main/Projects/Entangle/addrbook.json"
Настраиваем конфигурацию ноды
# правим конфиг, благодаря чему мы можем больше не использовать флаг chain-id для каждой команды CLI в client.toml entangled config chain-id entangle_33133-1 # при необходимости настраиваем keyring-backend в client.toml entangled config keyring-backend os # настраиваем минимальную цену за газ в app.toml sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0001aNGL\"/;" ~/.entangled/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/.entangled/config/config.toml peers="" sed -i -e "s|^persistent_peers *=.*|persistent_peers = \"$peers\"|" $HOME/.entangled/config/config.toml seeds="[email protected]:26656" sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.entangled/config/config.toml # при необходимости увеличиваем количество входящих и исходящих пиров для подключения, за исключением постоянных пиров в config.toml sed -i 's/max_num_inbound_peers =.*/max_num_inbound_peers = 40/g' $HOME/.entangled/config/config.toml sed -i 's/max_num_outbound_peers =.*/max_num_outbound_peers = 10/g' $HOME/.entangled/config/config.toml # настраиваем фильтрацию "плохих" peers sed -i -e "s/^filter_peers *=.*/filter_peers = \"true\"/" $HOME/.entangled/config/config.toml
(ОПЦИОНАЛЬНО) Настраиваем прунинг одной командой вapp.toml
pruning="custom" pruning_keep_recent="1000" pruning_interval="10" sed -i -e "s/^pruning *=.*/pruning = \"$pruning\"/" $HOME/.entangled/config/app.toml sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"$pruning_keep_recent\"/" $HOME/.entangled/config/app.toml sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"$pruning_interval\"/" $HOME/.entangled/config/app.toml
Также можно самостоятельно настроить параметр min-retain-blocks
: Это значение относится к обрезке блоков Tendermint. Оно отличается от настроек обычного Pruning. Если min-retain-blocks=0
, то ничего не удаляется.
min-retain-blocks
определяет минимальное смещение высоты блока от текущего фиксируемого блока, так что все блоки, превышающие это смещение, удаляются из Tendermint
(ОПЦИОНАЛЬНО) Выкл индексацию вconfig.toml
indexer="null" sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.entangled/config/config.toml
(ОПЦИОНАЛЬНО) Вкл/выкл снэпшоты вapp.toml
# По умолчанию снэпшоты выключены "snapshot-interval=0" snapshot_interval=1000 sed -i.bak -e "s/^snapshot-interval *=.*/snapshot-interval = \"$snapshot_interval\"/" ~/.entangled/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/.entangled/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/.entangled/config/app.toml # client.toml sed -i.bak -e "s%^node = \"tcp://localhost:26657\"%node = \"tcp://localhost:36657\"%" $HOME/.entangled/config/client.toml external_address=$(wget -qO- eth0.me) sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:36656\"/" $HOME/.entangled/config/config.toml
Подробнее о смене портов здесь
(ОПЦИОНАЛЬНО) State Sync
# при необходимости скачиваем wasm
# добавляем пир peers="" sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.entangled/config/config.toml
SNAP_RPC=https://<IP>: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/.entangled/config/config.toml
systemctl restart entangled && journalctl -u entangled -f -o cat
Важно - для разных блокчейнов нужно разное количество RAM для успешного старта со State sync
# при ошибке очищаем базу данных systemctl stop entangled entangled tendermint unsafe-reset-all --home $HOME/.entangled --keep-addr-book
(ОПЦИОНАЛЬНО) Snapshot
tee /etc/systemd/system/entangled.service > /dev/null <<EOF [Unit] Description=entangled After=network-online.target [Service] User=$USER ExecStart=$(which entangled) start Restart=on-failure RestartSec=3 LimitNOFILE=65535 [Install] WantedBy=multi-user.target EOF
systemctl daemon-reload systemctl enable entangled systemctl restart entangled && journalctl -u entangled -f -o cat
Если после старта нода долго не может подцепиться к пирам, то ищем новые пиры или просим addrbook.json в дискорд
# стопаем ноду, удаляем адресную книгу и сбрасываем данные systemctl stop entangled entangled tendermint unsafe-reset-all --home $HOME/.entangled # перезагружаем ноду systemctl restart entangled && journalctl -u entangled -f -o cat
Создаем или восстанавливаем кошелек и сохраняем вывод
Примечание: В журнале выполнения команды будет отображаться публичный адрес кошелька в формате ethm1c7tm4r9wl6v6s57zpq7dj49v7sk4eqr5mc5fwd, а также мнемоническая фраза. Пожалуйста, сохраните их в безопасном месте
# создать кошелек entangled keys add <name_wallet> --keyring-backend os # восстановить кошелек (после команды вставить seed) entangled keys add <name_wallet> --recover --keyring-backend os # восстановить кошелек для EVM сетей entangled keys add <name_wallet> --recover --coin-type 118 --algo secp256k1
entangled tx staking create-validator \ --chain-id entangle_33133-1 \ --commission-rate 0.1 \ --commission-max-rate 0.2 \ --commission-max-change-rate 0.1 \ --amount 1000000000000000000aNGL \ --pubkey $(entangled tendermint show-validator) \ --min-self-delegation="1" \ --moniker "<name_moniker>" \ --from <name_wallet> \ --gas=500000 \ --gas-prices="10aNGL"
Не забываем сохранить priv_validator_key.json !!!
Подробнее о создании/редактировании валидатора можно почитать здесь
Полезные команды
Для добавления лого в mintscan (ТОЛЬКО ДЛЯ MINTSCAN):
- форк https://github.com/cosmostation/chainlist
- в папке Moniker находим название проекта
- через add file/upload file добавляем свою аватарку. название файла обязательно должно быть валопер.png . и только png
- PR
# проверить блоки entangled status 2>&1 | jq ."SyncInfo"."latest_block_height" # проверить логи journalctl -u entangled -f -o cat # проверить статус curl localhost:$PORT/status | jq # проверить баланс entangled q bank balances <address> # проверить pubkey валидатора entangled tendermint show-validator # проверить валидатора entangled query staking validator <valoper_address> entangled query staking validators --limit 1000000 -o json | jq '.validators[] | select(.description.moniker=="<name_moniker>")' | jq # проверка информации по TX_HASH entangled query tx <TX_HASH> # параметры сети entangled q staking params entangled q slashing params # узнать транзакцию создания валидатора (заменить свой valoper_address) entangled query txs --events='create_validator.validator=<your_valoper_address>' -o=json | jq .txs[0].txhash -r # просмотр активного сета entangled q staking validators -o json --limit=1000 \ | jq '.validators[] | select(.status=="BOND_STATUS_BONDED")' \ | jq -r '.tokens + " - " + .description.moniker' \ | sort -gr | nl # просмотр неактивного сета entangled q staking validators -o json --limit=1000 \ | jq '.validators[] | select(.status=="BOND_STATUS_UNBONDED")' \ | jq -r '.tokens + " - " + .description.moniker' \ | sort -gr | nl
# собрать реварды со всех валидаторов, которым делегировали (без комиссии) entangled tx distribution withdraw-all-rewards --from <name_wallet> --gas=500000 --gas-prices="10aNGL" -y # собрать реварды c отдельного валидатора или реварды + комиссию со своего валидатора entangled tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --gas=500000 --gas-prices="10aNGL" --commission -y # заделегировать себе в стейк еще (так отправляется 1 монетa) entangled tx staking delegate <valoper_address> 1000000aNGL --from <name_wallet> --gas=500000 --gas-prices="10aNGL" -y # ределегирование на другого валидатора entangled tx staking redelegate <src-validator-addr> <dst-validator-addr> 1000000aNGL --from <name_wallet> --gas=500000 --gas-prices="10aNGL" -y # unbond entangled tx staking unbond <addr_valoper> 1000000aNGL --from <name_wallet> --gas=500000 --gas-prices="10aNGL" -y # отправить монеты на другой адрес entangled tx bank send <name_wallet> <address> 1000000aNGL --gas=500000 --gas-prices="10aNGL" -y # выбраться из тюрьмы entangled tx slashing unjail --from <name_wallet> ---gas=500000 --gas-prices="10aNGL" -y
! Если транзакции не отправляются с ошибкой account sequence mismatch, expected 18, got 17: incorrect account sequence
, то добавьте в команду ключ -s 18
(номер замените на тот, который ждет sequence)
# вывести список кошельков entangled keys list # показать ключ аккаунта entangled keys show <name_wallet> --bech acc # показать ключ валидатора entangled keys show <name_wallet> --bech val # показать ключ консенсуса entangled keys show <name_wallet> --bech cons # показать все поддерживаемые адреса entangled debug addr <wallet_addr> # показать приватный ключ entangled keys export <name_wallet> --unarmored-hex --unsafe entangled keys unsafe-export-eth-key <name_wallet> # запрос учетной записи entangled q auth account $(entangled keys show <name_wallet> -a) -o text # удалить кошелек entangled keys delete <name_wallet>
systemctl stop entangled && \ systemctl disable entangled && \ rm /etc/systemd/system/entangled.service && \ systemctl daemon-reload && \ cd $HOME && \ rm -rf .entangled entangle-blockchain && \ rm -rf $(which entangled)
ГОВЕРНАНС (подробнее здесь)
# список proposals entangled q gov proposals # посмотреть результат голосования entangled q gov proposals --voter <ADDRESS> # проголосовать за предложение entangled tx gov vote 1 yes --from <name_wallet> --gas=500000 --gas-prices="10aNGL" # внести депозит в предложение entangled tx gov deposit 1 1000000aNGL --from <name_wallet> --gas=500000 --gas-prices="10aNGL" # создать предложение entangled 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> --gas=500000 --gas-prices="10aNGL"
FOLDER=.entangled # узнать свой peer PORTR=$(grep -A 3 "\[p2p\]" ~/$FOLDER/config/config.toml | egrep -o ":[0-9]+") && \ echo $(entangled 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])