CELESTIA
October 16, 2023

Celestia- testnet [--home $HOME/.celestia-app-test]

Web Discord Github

Details

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

Обновляем репозитории

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 lz4 -y

Устанавливаем Go ОДНОЙ КОМАНДОЙ

ver="1.22.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

Новая установка ноды

ВАЖНО — ИСПОЛЬЗУЕМ НЕ СТАНДАРТНУЮ ДИРЕКТОРИЮ И МЕНЯЕМ НАЗВАНИЕ БИНАРНИКА ПРИ УСТАНОВКЕ НА 1 СЕРВЕРЕ ВМЕСТЕ С MAINNET

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

git clone https://github.com/celestiaorg/celestia-app && cd celestia-app
git checkout v2.1.2
make build
mv $HOME/celestia-app/build/celestia-appd $HOME/go/bin/celestia-appd-test

celestia-appd-test version --long --home $HOME/.celestia-app-test
#version: 2.1.2
#commit: 48173df3

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

celestia-appd-test init UTSA_guide --chain-id mocha-4 --home $HOME/.celestia-app-test

Скачиваем Genesis

cd
git clone https://github.com/celestiaorg/networks
cp $HOME/networks/mocha-4/genesis.json $HOME/.celestia-app-test/config
wget -O $HOME/.celestia-app-test/config/genesis.json "https://share103.utsa.tech/celestia-testnet/genesis.json"

# Проверим генезис
sha256sum ~/.celestia-app-test/config/genesis.json
# 0846b99099271b240b638a94e17a6301423b5e4047f6558df543d6e91db7e575

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

cd && cat .celestia-app-test/data/priv_validator_state.json
{
  "height": "0",
  "round": 0,
  "step": 0
}

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

Скачиваем addrbook

wget -O $HOME/.celestia-app-test/config/addrbook.json "https://share103.utsa.tech/celestia-testnet/addrbook.json"

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

# правим конфиг, благодаря чему мы можем больше не использовать флаг chain-id для каждой команды CLI в client.toml
chain_id="mocha-4"
sed -i -e "s/^chain-id *=.*/chain-id = \"$chain_id\"/" $HOME/.celestia-app-test/config/client.toml

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

seeds="5d0bf034d6e6a8b5ee31a2f42f753f1107b3a00e@celestia-testnet-seed.itrocket.net:11656"
sed -i.bak -e "s/^seeds =.*/seeds = \"$seeds\"/" $HOME/.celestia-app-test/config/config.toml

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

# настраиваем timeout_commit
sed -i -e "s|^target_height_duration *=.*|timeout_commit = \"11s\"|" $HOME/.celestia-app-test/config/config.toml

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

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

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

indexer="kv"
sed -i -e "s/^indexer *=.*/indexer = \"$indexer\"/" $HOME/.celestia-app-test/config/config.toml

(ОПЦИОНАЛЬНО) Смена портов #для 2 ноды ИЗМЕНИТЬ ПОРТЫ

# для 2 ноды
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/.celestia-app-test/config/config.toml
# для 2 ноды
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/.celestia-app-test/config/app.toml
# для 2 ноды
sed -i.bak -e "s%^node = \"tcp://localhost:26657\"%node = \"tcp://localhost:36657\"%" $HOME/.celestia-app-test/config/client.toml
# для 2 ноды
sed -i.bak -e "s/^external_address *=.*/external_address = \"$external_address:36656\"/" $HOME/.celestia-app-test/config/config.toml

Подробнее о смене портов здесь

(ОПЦИОНАЛЬНО) State Sync

# добавляем пир
peers="[email protected]:36656"
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.celestia-app-test/config/config.toml
SNAP_RPC=https://t-celestia.archive.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/.celestia-app-test/config/config.toml

Snapshot Pruned

ВАЖНО - проверьте путь к Вашей директории. В нашем примере мы используем $HOME/.celestia-app-test

time: every 6 hours | pruning: custom: 100/10 | indexer: null

🌐 https://share106-3.utsa.tech/celestia/

cd $HOME
systemctl stop celestia-appd-test

cp $HOME/.celestia-app-test/data/priv_validator_state.json $HOME/.celestia-app-test/priv_validator_state.json.backup

# удаляем старую базу данных
rm -rf $HOME/.celestia-app-test/data 

# скачиваем snapshot
curl -o - -L https://share106-3.utsa.tech/celestia/celestia_pruned_testnet.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.celestia-app-test/

mv $HOME/.celestia-app-test/priv_validator_state.json.backup $HOME/.celestia-app-test/data/priv_validator_state.json

systemctl restart celestia-appd-test && journalctl -u celestia-appd-test -f -o cat

Snapshot Archive

ВАЖНО — проверьте путь к Вашей директории. В нашем примере мы используем $HOME/.celestia-app-test

time: every 3 days | pruning: nothing | indexer: kv

🌐 https://share106-4.utsa.tech/celestia/

cd $HOME
systemctl stop celestia-appd-test

cp $HOME/.celestia-app-test/data/priv_validator_state.json $HOME/.celestia-app-test/priv_validator_state.json.backup

# удаляем старую базу данных
rm -rf $HOME/.celestia-app-test/data 

# скачиваем snapshot
curl -o - -L https://share106-4.utsa.tech/celestia/celestia_archive_testnet.tar.lz4 | lz4 -c -d - | tar -x -C $HOME/.celestia-app-test/

mv $HOME/.celestia-app-test/priv_validator_state.json.backup $HOME/.celestia-app-test/data/priv_validator_state.json

systemctl restart celestia-appd-test && journalctl -u celestia-appd-test -f -o cat

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

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

[Service]
User=$USER
ExecStart=$(which celestia-appd-test) start --home $HOME/.celestia-app-test
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

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

Если после старта нода долго не может подцепиться к пирам, то ищем новые пиры или просим addrbook.json в дискорд

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

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

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

# создать кошелек
celestia-appd-test keys add lesnik_utsa_wallet_test --keyring-backend os --home $HOME/.celestia-app-test

# восстановить кошелек (после команды вставить seed)
celestia-appd-test keys add lesnik_utsa_wallet_test --recover --keyring-backend os --home $HOME/.celestia-app-test

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

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

celestia-appd-test tx staking create-validator \
--chain-id mocha-4 \
--commission-rate 0.05 \
--commission-max-rate 0.2 \
--commission-max-change-rate 0.1 \
--min-self-delegation "1000000" \
--amount 1000000utia \
--pubkey $(celestia-appd-test tendermint show-validator --home $HOME/.celestia-app-test) \
--moniker "<name_moniker>" \
--from <name_wallet> \
--home $HOME/.celestia-app-test \
--fees 5550utia

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

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

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

Для добавления лого в mintscan:

  • форк https://github.com/cosmostation/cosmostation_token_resource
  • в папке Moniker находим название проекта
  • через add file/upload file добавляем свою аватарку. название файла обязательно должно быть валопер.png . и только png
  • PR

Информация

# проверить блоки
celestia-appd-test status --home $HOME/.celestia-app-test --node tcp://localhost:$PORT

# проверить логи
journalctl -u celestia-appd-test -f -o cat

# проверить баланс
celestia-appd-test q bank balances <address> --home $HOME/.celestia-app-test

! Если транзакции не отправляются с ошибкой account sequence mismatch, expected 18, got 17: incorrect account sequence, то добавьте в команду ключ -s 18 (номер замените на тот, который ждет sequence)

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

# вывести список кошельков
celestia-appd-test keys list --home $HOME/.celestia-app-test --keyring-backend os

# показать ключ аккаунта
celestia-appd-test keys show <name_wallet> --bech acc --home $HOME/.celestia-app-test --keyring-backend os

# показать ключ валидатора
celestia-appd-test keys show <name_wallet> --bech val --home $HOME/.celestia-app-test --keyring-backend os

# показать ключ консенсуса
celestia-appd-test keys show <name_wallet> --bech cons --home $HOME/.celestia-app-test --keyring-backend os

# показать все поддерживаемые адреса
celestia-appd-test debug addr <wallet_addr> --home $HOME/.celestia-app-test --keyring-backend os

# показать приватный ключ
celestia-appd-test keys export <name_wallet> --unarmored-hex --unsafe --home $HOME/.celestia-app-test --keyring-backend os
# удалить кошелек
celestia-appd-test keys delete <name_wallet> --home $HOME/.celestia-app-test --keyring-backend os

Транзакции

# собрать комиссионные + реварды
celestia-appd-test tx distribution withdraw-rewards <valoper_address> --from <name_wallet> --fees 5555utia --commission -y --home $HOME/.celestia-app-test

# заделегировать себе в стейк еще (так отправляется 1 монетa)
celestia-appd-test tx staking delegate <valoper_address> 1000000utia --from <name_wallet> --fees 5555utia -y --home $HOME/.celestia-app-test

# ределегирование на другого валидатора
celestia-appd-test tx staking redelegate <src-validator-addr> <dst-validator-addr> 1000000utia --from <name_wallet> --fees 5555utia -y --home $HOME/.celestia-app-test

# unbond 
celestia-appd-test tx staking unbond <addr_valoper> 1000000utia --from <name_wallet> --fees 5555utia -y --home $HOME/.celestia-app-test 

# отправить монеты на другой адрес
celestia-appd-test tx bank send <name_wallet> <address> 1000000utia --fees 5555utia -y --home $HOME/.celestia-app-test

# выбраться из тюрьмы
celestia-appd-test tx slashing unjail --from <name_wallet> --fees 5555utia -y --home $HOME/.celestia-app-test

ГОВЕРНАНС

# список proposals
celestia-appd q gov proposals --home $HOME/.celestia-app-test

# проголосовать за предложение 
celestia-appd tx gov vote 1 yes --from <name_wallet> --fees 5550utia --home $HOME/.celestia-app-test

# внести депозит в предложение
celestia-appd tx gov deposit 1 1000000utia --from <name_wallet> --fees 5550utia --home $HOME/.celestia-app-test

Удалить ноду

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

Peers and RPC

FOLDER=.celestia-app-test

# узнать свой peer
PORTR=$(grep -A 3 "\[p2p\]" ~/$FOLDER/config/config.toml | egrep -o ":[0-9]+") && \
echo $(celestia-appd-test tendermint show-node-id --home $HOME/.celestia-app-test)@$(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'
Поддержим природу вместе: 0xa7476EC14cD663C742d527113638C77a1631Cc89 cosmos1m2mm7kzvw6m3464h94ryqg8xvr6tyeyyecppnq