Posthuman Service Bridge Node Setup for Mocha Testnet (mocha-4)

Hardware Requirements

Ensure your system meets the hardware requirements before proceeding.

Setting Up a Posthuman Service Node

Update Packages and Install Dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make gcc tar clang pkg-config libssl-dev ncdu -y

Install Go

cd ~
! [ -x "$(command -v go)" ] && {
VER="1.23.1"
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"
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source ~/.bash_profile
}
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin
go version

Install Celestia-Node

cd $HOME
rm -rf celestia-node
git clone https://github.com/celestiaorg/celestia-node.git
cd celestia-node/
git checkout tags/v0.21.5-mocha 
make build 
sudo make install 
make cel-key

Configure and Initialize the Application

celestia bridge init --core.ip <RPC_NODE_IP> --p2p.network mocha

Once started, a wallet key is generated. You need to fund this address with testnet tokens. Find your wallet address:

cd $HOME/celestia-node
./cel-key list --node.type bridge --keyring-backend test --p2p.network mocha

Create a Systemd Service File

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

[Service]
User=$USER
ExecStart=$(which celestia) bridge start \
--p2p.network mocha --archival \
--metrics.tls=true --metrics --metrics.endpoint otel.mocha.celestia.observer
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Enable and Start the Service

sudo systemctl daemon-reload
sudo systemctl enable celestia-bridge
sudo systemctl restart celestia-bridge && sudo journalctl -u celestia-bridge -fo cat

Get Node Peer ID Information

❗ You can only generate an auth token after initializing and starting your Celestia node.

NODE_TYPE=bridge
AUTH_TOKEN=$(celestia $NODE_TYPE auth admin --p2p.network mocha)
curl -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

Download and Restore Snapshot

sudo apt install aria2 jq lz4 unzip -y
cd $HOME
aria2c -x 16 -s 16 -o celestia-bridge-snap.tar.lz4 https://server-8.itrocket.net/testnet/celestia/bridge/celestia_2025-03-03_4981368_snap.tar.lz4
sudo systemctl stop celestia-bridge
rm -rf ~/.celestia-bridge-mocha-4/{blocks,data,index,inverted_index,transients,.lock}
tar -I lz4 -xvf ~/celestia-bridge-snap.tar.lz4 -C ~/.celestia-bridge-mocha-4/
sudo systemctl restart celestia-bridge && sudo journalctl -u celestia-bridge -fo cat
rm ~/celestia-bridge-snap.tar.lz4

Cheat Sheet

Check Wallet Balance

celestia state balance --node.store ~/.celestia-bridge-mocha-4/

Get Wallet Address

cd $HOME/celestia-node
./cel-key list --node.type bridge --keyring-backend test --p2p.network mocha

Restore an Existing cel_key

KEY_NAME="my_celes_key"
cd ~/celestia-node
./cel-key add $KEY_NAME --keyring-backend test --node.type bridge --recover --p2p.network mocha

Check Bridge Node Status

celestia header sync-state --node.store ~/.celestia-bridge-mocha-4/

Get Node ID

celestia p2p info --node.store ~/.celestia-bridge-mocha-4/

Set Permissions for Transferring Keys

chmod -R 700 ~/.celestia-bridge-mocha-4

Reset Node

celestia bridge unsafe-reset-store --p2p.network mocha

Upgrade

Stop Bridge Node

sudo systemctl stop celestia-bridge

Download and Install Latest Version

cd $HOME
rm -rf celestia-node
git clone https://github.com/celestiaorg/celestia-node.git
cd celestia-node/
git checkout tags/v0.21.5-mocha 
make build 
sudo make install 
make cel-key

Update Configuration

celestia bridge config-update --p2p.network mocha

Restart Bridge Node

sudo systemctl restart celestia-bridge && sudo journalctl -u celestia-bridge -fo cat

Delete Bridge Node

sudo systemctl stop celestia-bridge
sudo systemctl disable celestia-bridge
sudo rm /etc/systemd/system/celestia-bridge*
rm -rf $HOME/celestia-node $HOME/.celestia-bridge-mocha-4