COSMOS
February 16

Tellor

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

Web Discord Github

Testnet details


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

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

cd
rm -r $HOME/layer
git clone https://github.com/tellor-io/layer && cd layer

wget https://github.com/tellor-io/layer/releases/download/4.0.1/layer_Linux_x86_64.tar.gz
tar -xvzf layer_Linux_x86_64.tar.gz
$HOME/layer/layerd version --long | grep -e version -e commit
# version: 4.0.1
# commit: 9e25c0ae96970d960c49ede51d008e6eecdd5bd3

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!

mv $HOME/layer/layerd $(which layerd)
layerd version --long | grep -e version -e commit
# 
systemctl restart layerd && journalctl -u layerd -f -o cat

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

cd
rm -r $HOME/layer
git clone https://github.com/tellor-io/layer && cd layer

wget https://github.com/tellor-io/layer/releases/download/v4.0.2/layer_Linux_x86_64.tar.gz
tar -xvzf layer_Linux_x86_64.tar.gz
$HOME/layer/layerd version --long | grep -e version -e commit
# version: 4.0.2
# commit: a145758262e7ca5fe568897f3c1bc04bf75a2039

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!

mv $HOME/layer/layerd $(which layerd)
layerd version --long | grep -e version -e commit
# 
systemctl restart layerd && journalctl -u layerd -f -o cat

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

cd
rm -r $HOME/layer
git clone https://github.com/tellor-io/layer && cd layer

wget https://github.com/tellor-io/layer/releases/download/v4.0.3/layer_Linux_x86_64.tar.gz
tar -xvzf layer_Linux_x86_64.tar.gz
$HOME/layer/layerd version --long | grep -e version -e commit
# version: 4.0.3
# commit: 683b709191e1342b8722f62b0f9bb897b525a92f

# ПОСЛЕ ОСТАНОВКИ СЕТИ НА НУЖНОМ БЛОКЕ!!!

mv $HOME/layer/layerd $(which layerd)
layerd version --long | grep -e version -e commit
# 
systemctl restart layerd && journalctl -u layerd -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.21.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/tellor-io/layer && cd layer
#git checkout v4.0.0
#make install

cd $HOME/layer
wget https://github.com/tellor-io/layer/releases/download/v4.0.3/layer_Linux_x86_64.tar.gz
tar -xvzf layer_Linux_x86_64.tar.gz
mv $HOME/layer/layerd $(which layerd)

layerd version --long | grep -e version -e commit
# version: 4.0.3
# commit: 683b709191e1342b8722f62b0f9bb897b525a92f

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

layerd init UTSA_guide --chain-id layertest-4

Скачиваем Genesis

curl https://node-palmito.tellorlayer.com/rpc/genesis | jq '.result.genesis' > ~/.layer/config/genesis.json
#wget -O $HOME/.layer/config/genesis.json "https://tellor.test.rpc.nodeshub.online/genesis"

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

Скачиваем Addrbook

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

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

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

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

peers="c7b175a5bafb35176cdcba3027e764a0dbd0811c@34.219.95.82:26656,05105e8bb28e8c5ace1cecacefb8d4efb0338ec6@18.218.114.74:26656,705f6154c6c6aeb0ba36c8b53639a5daa1b186f6@3.80.39.230:26656,1f6522a346209ee99ecb4d3e897d9d97633ae146@3.101.138.30:26656,3822fa2eb0052b36360a7a6e285c18cc92e26215@175.41.188.192:26656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.layer/config/config.toml
seeds=""
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.layer/config/config.toml
sed -i 's/timeout_commit = "5s"/timeout_commit = "1s"/' ~/.layer/config/config.toml

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

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

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

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

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

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

State sync

systemctl stop layerd
rm -rf /root/.layer/data/{tx_index.db,state.db,snapshots,evidence.db,blockstore.db,application.db}
# add peer
peers="18a60772ed3b2e06a780f5701a5fe17d95955566@5.9.87.231:56656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.layer/config/config.toml
SNAP_RPC=https://t-tellor.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/.layer/config/config.toml
systemctl restart layerd && journalctl -u layerd -f -o cat

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

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

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

# подключить кошелек ledger
layerd keys add <name_wallet> --ledger 

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

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

Замените <name_wallet> на название своего кошелька

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

[Service]
User=$USER
ExecStart=$(which layerd) start --home /root/.layer --key-name <name_wallet> --keyring-backend test
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

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

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

Сначала нужно получить монеты в дискорде используя кошелек EVM, после используя мост https://bridge.tellor.io/ обменять монеты. Обмен будет происходить 12 часов

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

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

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

nano $HOME/.layer/validator.json

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

{
    "pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"c+EuycPpudgiyVl6guYG9oyPSImHHJz1z0Pg4ODKveo="},
    "amount": "69666420loya",
    "moniker": "yourmoniker",
    "identity": "optional identity signature (ex. UPort or Keybase)",
    "website": "validator's (optional) website",
    "security": "validator's (optional) security contact email",
    "details": "validator's (optional) details",
    "commission-rate": "0.1",
    "commission-max-rate": "0.2",
    "commission-max-change-rate": "0.01",
    "min-self-delegation": "1"
}

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

layerd tx staking create-validator $HOME/.layer/validator.json \
    --from=<key-name> \
    --chain-id=layertest-4 \
    --fees=5loya

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

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

Запуск Data Reporter

Предполагается, что у Вас уже работает нода и валидатор

1. Выполняем команду create-reporter

  • commision-rate 0.25 означает, что Вы будете получать 25% вознаграждений от selectors
  • min-tokens-required предотвращает спам, требуя, чтобы у selectors было не менее 1 монеты в их кошельке
# layerd tx reporter create-reporter 0.25 1000000 REPORTER_MONIKER --from YOUR_ACCOUNT_NAME --chain-id layertest-4 --fees 10loya --yes
layerd tx reporter create-reporter 0.25 1000000 UTSA_guide--from <name_wallet> --chain-id layertest-4 --fees 5loya --yes

2. Проверьте, успешно ли был создан ваш репортер. Если Вы видите свой адрес в списке, значит, ваш репортер был успешно создан

layerd query reporter reporters | grep <tellor1k8v5l...>

3. В сервисном файле измените строку запуска и добавьте Environments. Замените на свои значения все, что находится в <>

nano /etc/systemd/system/layerd.service
[Unit]
Description=layerd
After=network-online.target

[Service]
User=root
ExecStart=/root/go/bin/layerd start --api.enable --api.swagger --price-daemon-enabled=true --panic-on-daemon-failure-enabled=false --home /root/.layer --key-name <name_wallet> --keyring-backend test
Restart=on-failure
RestartSec=3
LimitNOFILE=65535
Environment="WITHDRAW_FREQUENCY=21600"
Environment="REPORTERS_VALIDATOR_ADDRESS=<tellorvaloper1k8v...>"
Environment="ETH_RPC_URL=<wss://a.good.sepolia.rpc.url>"
Environment="TOKEN_BRIDGE_CONTRACT=0x5acb5977f35b1A91C4fE0F4386eB669E046776F2"

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

4. Проверьте успешные транзакции оракла

layerd query oracle get-reportsby-reporter <tellor1k8v5l...>

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

Информация

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

Транзакции

# собрать комиссионные + реварды
layerd tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --fees=5loya --commission -y

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

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

# unbond 
layerd tx staking unbond <addr_valoper> 1000000loya --from <name_wallet> --fees=5loya -y

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

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

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

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

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

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

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

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

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

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

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

Удалить ноду

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

ГОВЕРНАНС

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

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

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

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

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

Peers and RPC

FOLDER=.layer

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