Fullnode Install

Side Protocol, as an extension layer of Bitcoin, is the first fully Bitcoin-compatible dPoS Layer 1 blockchain, designed to shape the future of Bitcoin finance. It enables developers to create secure, high-performance decentralized applications within the Bitcoin-centric internet, aiming to onboard billions of users globally and establish BTC as the definitive global currency.

tip: the following commands are executed as root by default. If you are not a root user, please prepend the commands with sudo

Network: sidechain-testnet-4
Latest Version: 0.9.5

Requirements

The minimum hardware requirements for running an Junction node are:

CPU: 4 cores
Memory: 16GB RAM
Disk: 500GB NVMe/SSD Storage
System: Ubuntu 22.04 x64

Install Tools

apt -q update
apt -qy install curl git jq lz4 build-essential aria2 unzip wget

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

Clone and Build

export TAG=v0.9.5
git clone https://github.com/sideprotocol/side.git
cd side
git checkout $TAG && make build

sided version --long | grep -e version -e commit

basic setup

# Set home dir, example: /data/junction
export DIR=/data/side
export Moniker="xx"
mkdir -pv $DIR
ln -sv $DIR $HOME/.side

# A moniker is a human-readable name for your node. Moniker can contain only ASCII characters, and cannot exceed 70 characters.
sided init $Moniker --chain-id sidechain-testnet-4

Set Custom Port

export DIR=$HOME/.side
export MIN_GAS=0.001uside
export NUM=2

bash portset.sh $DIR $MIN_GAS $NUM

Genesis File

export DIR=$HOME/.side
export TAG=v0.1.0
curl -Ls https://genesis.blocknth.com/side-testnet/genesis.json > \
         $DIR/config/genesis.json

Add Seeds

export DIR=$HOME/.side
export PEERS=e0013b839bdfd7e189b39cf174ae9406b8576db1@194.163.137.141:26656,63a1ff3d245ac8f70790326249245d049c7114fc@78.46.45.174:15656,6bb2e3fbd2494495865a8ad0f08591e3157d4b1f@161.97.83.189:26656,95e99ef9761f18770d6ccd177370ff77e4e2e9d5@5.161.85.171:26656,573b0ac9b2b7ed4ce90c05205ad8370e113d4aab@185.207.106.147:26656,e9ee4fb923d5aab89207df36ce660ff1b882fc72@136.243.33.177:21656
sed -i -e 's|^seeds *=.*|seeds = "'$SEEDS'"|' $DIR/config/config.toml

Address Book

export DIR=$HOME/.side
rm -rf $DIR/config/addrbook.json
curl -Ls https://addrbook.blocknth.com/side-testnet/addrbook.json > $DIR/config/addrbook.json

Create Service with Cosmovisor

DIR=$HOME/.side
BIN=$(which sided)
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest
mkdir -pv $DIR/cosmovisor/genesis/bin
ln -sv $DIR/cosmovisor/genesis $DIR/cosmovisor/current
cp $BIN $DIR/cosmovisor/genesis/bin/

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

[Service]
User=$USER
Restart=on-failure
Type=simple
ExecStart=$(which cosmovisor) run start
WorkingDirectory=$DIR
SyslogIdentifier=sided
LimitNOFILE=65545
Environment="DAEMON_NAME=sided"
Environment="DAEMON_HOME=$DIR"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_LOG_BUFFER_SIZE=512"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="UNSAFE_SKIP_BACKUP=true"

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable sided.service
systemctl start sided.service
journalctl -u sided.service -f -o cat

PreviousSide Protocol NextCommands

Last updated 4 months ago