Shardeum

This guide for Shardeum testnet.

Guide was successfully tested on several dedicated servers (Hetzner AX41-NVMe, AX51-NVMe, AX101) and Hetzner Cloud VPS: CPX31, CX41, CPX41 and CPX51.

Requirements

Recommended requirements:

CPU: 4 cores

RAM: 8 GB RAM

SSD: 250 GB

OS: Ubuntu 20.04 LTS

Installation

Step 1. Install packages and upgrades

sudo apt update && sudo apt upgrade -y

sudo apt-get install curl

sudo apt install git

sudo apt update

Step 2. Install docker

sudo apt install docker.io

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

Step 3. Install validator node

curl -O https://gitlab.com/shardeum/validator/dashboard/-/raw/main/installer.sh && chmod +x installer.sh && ./installer.sh

After running installation process you will see several questions in your terminal:

  • Do you want to run the web based Dashboard? (y/n): y
  • Set the password to access the Dashboard: create a password
  • Enter the port (1025-65536) to access the web based Dashboard (default 8080): If default just type Enter
  • This allows p2p communication between nodes. Enter the first port (1025-65536) for p2p communication (default 9001): If default just type Enter
  • Enter the second port (1025-65536) for p2p communication (default 10001): If default just type Enter
  • What base directory should the node use (defaults to ~/.shardeum): If default just type Enter

Open the validator CLI

cd .shardeum

./shell.sh

operator-cli gui start

Working with the dashboard

  1. Go to https://your_node_ip:8080/
  2. Enter your password
  3. Go to Maintenance
  4. Click on «Start Node» button

Staking tokens

Step 1

First, you need to create a wallet via Metamask.

Step 2

Go to https://docs.shardeum.org/Network/Endpoints#connect-wallet and add Shardeum Sphinx 1.X network to your wallet.

Step 3

Go to faucet and request some tokens using your wallet address. It works quite unstable, so it may take several attempts until you’ve got tokens.

Step 4

Go to your dashboard and add your wallet on the Maintenance tab

Step 5

After adding a wallet, you can, finally, stake your tokens.

Updating the node

  1. Follow this step if you need to update your node:
  2. Unstake your coins * 
  3. Stop the node
  4. Run this command 
    curl -O https://gitlab.com/shardeum/validator/dashboard/-/raw/main/installer.sh && chmod +x installer.sh && ./installer.sh
  5. Run your node
  6. Stake your coins

 

* Make sure that you have enough coins on your wallet for unstaking and staking. However, you are always able to use the faucet again to get some tokens.