Installation

Chain ID: celestia

Celestia-app Version: v2.3.1

Celestia-Bridge Version: v0.17.2

Setup validator name

Replace **MONIKER** with your validator name

MONIKER="MONIKER"

Install dependencies

Update system and install build tools

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade

Install Go

sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.23.1.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)

Download and build binaries

# Clone project repository
cd $HOME
rm -rf celestia-app
git clone https://github.com/celestiaorg/celestia-app.git
cd celestia-app
git checkout v2.3.1

# Build binaries
make build

# Prepare binaries for Cosmovisor
mkdir -p $HOME/.celestia-app/cosmovisor/genesis/bin
mv build/celestia-appd $HOME/.celestia-app/cosmovisor/genesis/bin/
rm -rf build

# Create application symlinks
sudo ln -s $HOME/.celestia-app/cosmovisor/genesis $HOME/.celestia-app/cosmovisor/current -f
sudo ln -s $HOME/.celestia-app/cosmovisor/current/bin/celestia-appd /usr/local/bin/celestia-appd -f

Install Cosmovisor and create a service

# Download and install Cosmovisor
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.5.0

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

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.celestia-app"
Environment="DAEMON_NAME=celestia-appd"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.celestia-app/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable celestia-appd

Initialize the node

Set node configuration

celestia-appd config chain-id celestia

Initialize the node

celestia-appd init $MONIKER --chain-id celestia

Download genesis and addrbook

curl -Ls https://github.com/celestiaorg/networks/blob/master/celestia/genesis.json > $HOME/.celestia-app/config/genesis.json
curl -Ls https://github.com/dvjromashkin/guides/raw/main/celestia-mainnet/addrbook.json > $HOME/.celestia-app/config/addrbook.json

Add seeds

sed -i -e "s|^seeds *=.*|seeds = \"e8657b97bcfcf7e522f2481f17358c4273ee0d55@185.144.99.12:26656\"|" $HOME/.celestia-app/config/config.toml

Set minimum gas price

sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.002utia\"|" $HOME/.celestia-app/config/app.toml

Set pruning

sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
  $HOME/.celestia-app/config/app.toml

Start service and check the logs

sudo systemctl start celestia-appd && sudo journalctl -u celestia-appd -f -o cat

Set up validator

Official documentation: https://docs.celestia.org/nodes/validator-node

Create a wallet

First of all we will need to create wallet for our validator. You have two options for that.

CREATE NEW WALLET

celestia-appd keys add wallet

RECOVER EXISTING WALLET

celestia-appd keys add wallet --recover

Save the mnemonic output as this is the only way to recover your validator wallet in case you lose it!

To list your wallets use command below

celestia-appd keys list

Top up wallet with tokens

You can buy tokens at https://app.osmosis.zone

To check wallet balance use command below

celestia-appd q bank balances $(celestia-appd keys show wallet -a)

Create validator

Please make sure you have adjusted moniker, identity, details, website to match your values.

celestia-appd tx staking create-validator \
--amount 1000000utia \
--pubkey $(celestia-appd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id celestia \
--commission-rate 0.05 \
--commission-max-rate 0.20 \
--commission-max-change-rate 0.05 \
--min-self-delegation 1 \
--from wallet \
--gas-adjustment 1.4 \
--gas auto \
--gas-prices 0.002utia \
-y

Save the ~/.celestia-app/config/priv_validator_key.json file as this is the only way to recover your validator signing key in case you lose it!

Install Bridge Node

Download and build binaries

cd $HOME 
rm -rf celestia-node 
git clone https://github.com/celestiaorg/celestia-node.git 
cd celestia-node
git checkout v0.17.2
make build
sudo mv build/celestia /usr/local/bin
make cel-key
sudo mv cel-key /usr/local/bin

Add Bridge wallet

Generate new wallet

cel-key add bridge-wallet --node.type bridge --p2p.network blockspacerace

Recover existing wallet

cel-key add bridge-wallet --node.type bridge --p2p.network celestia --recover

Fund the wallet with testnet tokens

Once you start the Bridge Node, a wallet key will be generated for you. You will need to fund that address with Testnet tokens to pay for PayForBlob transactions

Initialize Bridge node

celestia bridge init \
  --keyring.accname bridge-wallet \
  --core.ip http://localhost \
  --core.rpc.port 26657 \
  --core.grpc.port 9090 \
  --p2p.network celestia \
  --rpc.port 26658 \
  --gateway.port 26659

Create service

sudo tee /etc/systemd/system/celestia-bridge.service > /dev/null << EOF
[Unit]
Description=Celestia Bridge Node service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which celestia) bridge start \\
--keyring.accname bridge-wallet \\
--core.ip http://localhost \\
--core.rpc.port 26657 \\
--core.grpc.port 9090 \\
--p2p.network celestia \\
--rpc.port 26658 \\
--gateway.port 26659 \\
--metrics.tls=false \\
--metrics \\
--metrics.endpoint=otel.celestia.observer 
Restart=on-failure
RestartSec=10
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable celestia-bridge

Start Bridge node

systemctl restart celestia-bridge

Check Bridge node logs

journalctl -u celestia-bridge -f -o cat

Useful commands

Get Bridge Node ID

AUTH_TOKEN=$(celestia bridge auth admin --p2p.network blockspacerace)
curl -s -X POST -H "Authorization: Bearer $AUTH_TOKEN" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":0,"method":"p2p.Info","params":[]}' http://localhost:26658 | jq -r .result.ID

Get Bridge node key

cel-key show bridge-wallet --node.type bridge --p2p.network celestia -a | tail -1

Check Bridge node wallet balance

celestia-appd q bank balances $(cel-key show bridge-wallet --node.type bridge --p2p.network celestia -a | tail -1)

Upgrade Bridge Node

Stop Bridge node

sudo systemctl stop celestia-bridge

Download and build binaries

cd $HOME 
rm -rf celestia-node 
git clone https://github.com/celestiaorg/celestia-node.git 
cd celestia-node
git checkout v0.14.1
make build
sudo mv build/celestia /usr/local/bin
make cel-key
sudo mv cel-key /usr/local/bin

Check Bridge node version

celestia version

Node upgrade

To upgrade Celestia Bridge node you have two options

Soft upgrade

This option will only update attributes of configuration files without deleting any data.

Update configuration file

celestia bridge config-update --p2p.network celestia

Hard upgrade

This option will clear data store and re-initialize the node. Keys will not be deleted.

Clear data store and remove configuration file

celestia bridge unsafe-reset-store --p2p.network celestia
rm -rf $HOME/.celestia-bridge-celestia/config.toml

Initialize Bridge node

celestia bridge init \
  --keyring.accname bridge-wallet \
  --core.ip localhost \
  --core.rpc.port 26657 \
  --core.grpc.port 9090 \
  --p2p.network celestia \
  --rpc.port 26658 \
  --gateway.port 26659

Start Bridge node

sudo systemctl start celestia-bridge

Check Bridge node logs

journalctl -fu celestia-bridge -o cat

Useful commands

View validator details

Check the evm_address field if it has an address that you want to use to sign attestations.

celestia-appd query qgb evm $(celestia-appd keys show wallet --bech val -a)