Skip to content

Operating Instructions

Types of Nodes

Xian Network has 3 types of nodes

Validator Nodes

  • Validators are responsible for creating & validating blocks.
  • A block is considered valid when 75% of validators vote for a block.

Full Nodes

  • Full nodes keep a copy of the entire history & state of the blockchain.
  • They are a key component to keeping the network healthy.

Blockchain Data Service Nodes

Blockchain Data Service (BDS) nodes improve developer experience by providing :

  • Rich data & querying via REST & Websocket interfaces
  • Stamp estimation, allowing a dAPP to know how many stamps a transaction will cost before submitting it to the network.
  • A Validator cannot also be a BDS
  • Xian provides access to service nodes free of charge, although this service may be limited in the future, depending on use.

Server Specs

These specs are subject to change depending on network growth & use.

Node TypeRAMSSDCPU
Validator / Full Node8GB256GB4 Cores
BDS8GB512GB4 Cores
  • OS : Ubuntu 24.02
  • Architecture : Intel / AMD x86

Generate a wallet.

  • Create a wallet using the browser wallet
  • Export the private key
    • Click Settings
    • Click Export Private Key

Install prerequisites

  1. Install make
bash
sudo apt update
sudo apt install make
  1. Install Docker
bash
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
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
rm get-docker.sh

Install Xian & Configure Node

Install

bash
git clone https://github.com/xian-network/xian-stack.git
cd xian-stack
make setup

Build

  • For a Validator / Regular Full-Node
bash
make core-build
make core-up
make init
make configure CONFIGURE_ARGS='--moniker <your-moniker> --genesis-file-name genesis-rcnet.json --validator-privkey <priv-key> --seed-node 188.68.33.32 --copy-genesis'
  • For a Blockchain Data Service Node
bash
make core-bds-build
make core-bds-up
make init
make configure CONFIGURE_ARGS='--moniker <your-moniker> --genesis-file-name genesis-rcnet.json --validator-privkey <priv-key> --seed-node 188.68.33.32 --copy-genesis --service-node'

Starting the Validator Node

  • Headless Mode
bash
make up
  • Interactive Shell
bash
make core-shell
make up

Starting the Full Node / BDS

  • Headless Mode
bash
make up
  • Interactive Shell
bash
make core-bds-shell
make up-bds
  • When finished
bash
exit

Viewing Logs

bash
make core-shell
cd xian-core
pm2 logs
  • When finished
bash
exit

Stopping the node

  • Headless mode
bash
make down
  • From Container Shell
bash
make down

Shutting down the node container

  • Needed if rebuilding the container
bash
make core-down
# or
make core-bds-down