Canxium PoS guideline

We are happy to announce, Canxium PoS sidechain will launch in 7 days, at 2024–04–30 13:06:16 +0000 UTC, this is an extremely important step for us to realize the dream of offline mining. Which will take place not long after Canxium fully migrates to PoS consensus.

In this guideline, we will show you have to start the PoS sidechain on mainnet using one of 3 supported beacon client: Lodestar, Prysm and Lighthouse.

This guideline will mainly focus on Ubuntu only.

Hardware requirements:​
To run a reliable, performant node, we suggest that the node’s hardware profile should match or exceed the following specifications:

Validator node: 6 core CPU, 18 GB RAM, 256 GB SSD
Non-validator node: 4 core CPU, 8 GB RAM, 256 GB SSD

1. Create validator’s keys:

• Install docker:
  Please download and install docker here: https://www.docker.com/products/docker-desktop/
  Or using command line: https://docs.docker.com/engine/install/ubuntu/
• Create validator’s keys:

docker run -e NUM_VALIDATORS=1 -e KEYSTORE_PASSWORD=123456789 -e WITHDRAWAL_ADDRESS=0xBd65D6efb2C3e6B4dD33C664643BEB8e5E133055 -v ./keystores:/app/validator_keys canxium/staking-deposit-cli:v0.1

After you created the keys, save the mnemonic, keystores, password in a safe place.

• Save your password to password.txt inside the keystores :

echo "123456789" > ./keystores/password.txt

Now, let’s start the validator’s node use one of the following methods:

2. Run node in Docker Environment.
This is a simple launch method, but the performance will not be high compared to the native method.

• Download one of threes supported client in docker compose format:
  1. https://github.com/canxium/lighthouse/blob/main/docker-compose.validator.yml
  2. https://github.com/canxium/prysm/blob/main/docker-compose.validator.yml
  3. https://github.com/canxium/lodestar/blob/main/docker-compose.validator.yml
• Place the docker-compose.validator.yml in the folder same as keystores

Open the docker-compose.validator.yml and set your fee recipient address:

--suggested-fee-recipient 0x0000000000000000000000000000000000000000
--suggestedFeeRecipient 0x0000000000000000000000000000000000000000

• Run the docker compose:

docker compose -f docker-compose.validator.yml up -d

You should see this logs, mean your node is up and running fine:
a. Lighthouse

b. Lodestar

c. Prysm

2. Run node In Ubuntu, Native binary:

Use this all-in-one script if you want:

bash <(curl -fsSL https://raw.githubusercontent.com/canxium/scripts/main/validator.sh)

Or step by step:
First, you have to build and run go-canxium:

If you already run a node, you can skip this and upgrade your node to latest version: v0.1.3 (don’t forget to rename the folder: ~/.canxium/geth to ~/.canxium/canxium)

sudo snap install go --channel=1.22 --classic

git clone https://github.com/canxium/go-canxium.git

sudo apt install build-essential -y

cd go-canxium/ && git checkout v0.1.3

make canxium

mkdir -p /canxium

openssl rand -hex 32 | tr -d "\n" > "/canxium/jwt.hex"

./go-canxium/build/bin/canxium --db.engine=pebble init ./go-canxium/genesis/mainnet.genesis.json

echo "[Unit]
Description=Canxium Bootnode

[Service]
User=root
WorkingDirectory=/root
ExecStart=/root/go-canxium/build/bin/canxium --http --http.addr 127.0.0.1 --http.api debug,net,eth,shh,web3,txpool --ethstats [node_name]:canxium@stats.canxium.org --db.engine=pebble --syncmode "full" --authrpc.addr 127.0.0.1 --authrpc.jwtsecret=/canxium/jwt.hex --bootnodes enode://314f1041da4b27f5e4c02b4eac52ca7bd2f025cb585490cb7032fdb08db737aa10d7d64a780db697643ece6027d3bc1a511696420e76192648c0d2d74d099c73@boot.canxium.net:30303,enode://767d3e408b073ca501ea7336096c048eea46513ac5c44659ac902d7575881ca114c82277dff7826630ec9fb45d8cfa5a82b9eacc8b477dc475746eaec39e2f2a@boot.canxium.org:30303,enode://f06de34b87954abb25be2e8d592306bc55b396a4eead839dba90baf4e59465d3ef704866962cf2fd995e6ce04f17de31edebb11afcac9df4eaea847f35e3cbaf@boot-n2.canxium.org:30303
Restart=always

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/node.service

systemctl enable node
systemctl start node

Next, use one of the following clients:

a. Lighthouse:

• Install rustc, clang, make:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

source "$HOME/.cargo/env"

sudo apt install libclang-dev

sudo apt install build-essential

sudo apt install cmake

• Clone and build lighthouse binary:

git clone https://github.com/canxium/lighthouse.git

cd lighthouse/ && make

echo "[Unit]
Description=Lighthouse Static Node

[Service]
User=root
WorkingDirectory=/root
ExecStart=/root/lighthouse/target/release/lighthouse bn --network canxium --execution-endpoint http://127.0.0.1:8551 --execution-jwt /canxium/jwt.hex --http --debug-level info --datadir /canxium/lighthouse_static --enr-address [your_node_public_ipv4] --port 9000 --enr-udp-port 9000 --enr-tcp-port 9000

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/lighthouse.node.service

systemctl enable lighthouse.node.service

systemctl start lighthouse.node.service

Import keystores:

/root/lighthouse/target/release/lighthouse account --network canxium --datadir /canxium validator import --directory /keystores --reuse-password --password-file /keystores/password.txt

Run validator node:

echo "[Unit]
Description=Lighthouse Static Node

[Service]
User=root
WorkingDirectory=/root
ExecStart=/root/lighthouse/target/release/lighthouse vc --network canxium --suggested-fee-recipient 0x0000000000000000000000000000000000000000 --datadir /data --beacon-nodes http://beacon_node:5052 --debug-level info

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/lighthouse.validator.service

systemctl enable lighthouse.validator.service

systemctl start lighthouse.validator.service

b. Prysm:

• Install golang, build-essential:

sudo snap install go --channel=1.22 --classic

sudo apt install build-essential

• Clone and build Prysm:

git clone https://github.com/canxium/prysm.git

cd prysm && git checkout v5.0.1

go build -o=./build/bin/beacon-chain ./cmd/beacon-chain && go build -o=./build/bin/validator ./cmd/validator

• Start prysm node:

echo "[Unit]
Description=Prysm Static Node

[Service]
User=root
WorkingDirectory=/root
ExecStart=/root/prysm/build/bin/beacon-chain --datadir=/canxium/beacondata --min-sync-peers=3 --canxium --execution-endpoint=http://127.0.0.1:8551 --chain-id=3003 --accept-terms-of-use --jwt-secret=/canxium/jwt.hex --verbosity info

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/prysm.node.service

systemctl enable prysm.node.service

systemctl start prysm.node.service

• Import keystores:

/root/prysm/build/bin/validator accounts import --wallet-dir=/canxium/keystores --keys-dir=./keystores --wallet-password-file=./keystores/password.txt --account-password-file=./keystores/password.txt --accept-terms-of-use

• Run prysm validator node:

echo "[Unit]
Description=Prysm Static Node

[Service]
User=root
WorkingDirectory=/root
ExecStart=/root/prysm/build/bin/validator --suggested-fee-recipient 0x0000000000000000000000000000000000000000 --beacon-rpc-provider=127.0.0.1:4000 --datadir=/data --accept-terms-of-use --wallet-dir=/canxium/keystores --wallet-password-file=./keystores/password.txt --canxium 

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/prysm.validator.service

systemctl enable prysm.validator.service

systemctl start prysm.validator.service

c. Lodestar:

• Install node v20.12.2, yarn:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

nvm install v20.12.2

nvm use v20.12.2

ln -s /root/.nvm/versions/node/v20.12.2/bin/node /usr/bin/node

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -

echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

sudo apt update && sudo apt install --no-install-recommends yarn

• Clone and build Lodestar:

git clone https://github.com/canxium/lodestar.git

cd lodestart && git checkout v1.17.0

yarn && yarn build

• Run lodestar node:

echo "[Unit]
Description=Lodestar Static Node

[Service]
User=root
WorkingDirectory=/root/lodestar
ExecStart=/root/lodestar/lodestar beacon --network canxium --jwtSecret /canxium/jwt.hex --logLevel info --rest=true --rest.namespace "beacon","config","events","node","validator","lightclient","debug" --enr.ip [your_public_ipv4] --dataDir=/canxium/lodestar

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/lodestar.node.service

systemctl enable lodestar.node.service

systemctl start lodestar.node.service

• Run lodestar validator node:

echo "[Unit]
Description=Lodestar Static Node

[Service]
User=root
WorkingDirectory=/root/lodestar
ExecStart=/root/lodestar/lodestar validator --network canxium --suggestedFeeRecipient 0x0000000000000000000000000000000000000000 --dataDir /canxium --importKeystores ./keystores --importKeystoresPassword ./keystores/password.txt --server http://1217.0.0.1:9596 --logFile /logs/validator.log --logFileLevel info --logFileDailyRotate 5

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/lodestar.validator.service

systemctl enable lodestar.validator.service

systemctl start lodestar.validator.service