Node operators

Node configuration

Prerequisites

Below is a list of standard requirements for running nodes on the Bool chain:

1. Operating system: Ubuntu 18.04 or Linux Kernel 5.16.

2. Hardware:

   • CPU: 4 Cores

   • Memory: 16GB RAM

   • Storage: 1TB SSD/HHD

   • Network: At least 20Mb bandwidth with an independent IP address

Node initialization

Download binaries

Compiling from binaries is temporarily unsupported since the network is not open-source at the Testnet stage.

Using Docker

Docker is the only avaliable way to operate nodes on Bool chain at the alpha testnet stage. Developers can quickly run nodes through the images posted by Bool team via the following command:

docker run -p 30333:30333 boolnetwork/bnk-node:alpha-testnet --validator --chain=alpha_testnet --name <name on telemetry>

If you prefer to run in the backstage, please add -d on docker command.

If you prefer to persist the node's data on the host machine, please add-v ./data:/data on docker command.

If you intend to run an RPC service that is exteranlly accessibe for applications or third-party applicaitions, such as Polkadot.js, please add following flags to run a full node:

• --unsafe-rpc-external: Listen to all RPC interfaces.

• --unsafe-ws-external: Listen to all Websocket interfaces.

More details can be found be executing the following command:

docker run --rm boolnetwork/bnk-node:alpha-testnet --help

Examples

Node initialization

2024-01-30 08:08:26 BoolNetwork Node    
2024-01-30 08:08:26 ✌️  version 0.10.0-f53ea677650    
2024-01-30 08:08:26 ❤️  by BoolNetwork, 2022-2024    
2024-01-30 08:08:26 📋 Chain specification: BoolNetwork Alpha Testnet    
2024-01-30 08:08:26 🏷  Node name: grandiose-voyage-2878    
2024-01-30 08:08:26 👤 Role: AUTHORITY    
2024-01-30 08:08:26 💾 Database: RocksDb at /bool/.local/share/bnk-node/chains/boolnetwork_alpha_testnet/db/full    
2024-01-30 08:08:26 ⛓  Native runtime: moonbase-194 (moonbase-2.tx1.au2)    
2024-01-30 08:08:31 🔨 Initializing Genesis block/state (state: 0x5e9c…3f30, header-hash: 0x1808…0b78)    
2024-01-30 08:08:31 👴 Loading GRANDPA authority set from genesis on what appears to be first startup.    
2024-01-30 08:08:36 👶 Creating empty BABE epoch changes on what appears to be first startup.    
2024-01-30 08:08:36 🏷  Local node identity is: 12D3KooWFBrtXis73pD5aVbmyRNAGzCKaZ3q9VZFHgPmL3RNDEyH  

Node sync

2024-01-30 08:09:06 No device mining and no deposit    
2024-01-30 08:09:06 ⚙️  Syncing 262.4 bps, target=#146111 (3 peers), best: #8016 (0x6811…5d1c), finalized #7788 (0x883a…fe33), ⬇ 82.6kiB/s ⬆ 0.9kiB/s    
2024-01-30 08:09:06 [8188] 💸 generated 3 npos voters, 3 from validators and 0 nominators    
2024-01-30 08:09:06 [8188] 💸 generated 3 npos targets    
2024-01-30 08:09:06 [8188] 💸 new validator set of size 3 has been processed for era 14    
2024-01-30 08:09:09 [8788] 💸 generated 3 npos voters, 3 from validators and 0 nominators    
2024-01-30 08:09:09 [8788] 💸 generated 3 npos targets    
2024-01-30 08:09:09 [8788] 💸 new validator set of size 3 has been processed for era 15    
2024-01-30 08:09:10 No device mining and no deposit    
2024-01-30 08:09:11 ⚙️  Syncing 233.9 bps, target=#146112 (3 peers), best: #9186 (0x5d6c…2de1), finalized #8988 (0xa05e…64df), ⬇ 71.5kiB/s ⬆ 1.2kiB/s    
2024-01-30 08:09:11 [9388] 💸 generated 3 npos voters, 3 from validators and 0 nominators    
2024-01-30 08:09:11 [9388] 💸 generated 3 npos targets    
2024-01-30 08:09:11 [9388] 💸 new validator set of size 3 has been processed for era 16    
2024-01-30 08:09:14 [9988] 💸 generated 3 npos voters, 3 from validators and 0 nominators    
2024-01-30 08:09:14 [9988] 💸 generated 3 npos targets    
2024-01-30 08:09:14 [9988] 💸 new validator set of size 3 has been processed for era 17    
2024-01-30 08:09:14 No device mining and no deposit    
2024-01-30 08:09:16 ⚙️  Syncing 268.2 bps, target=#146114 (3 peers), best: #10527 (0x31ca…9b7d), finalized #10240 (0xf654…d810), ⬇ 82.8kiB/s ⬆ 1.1kiB/s    
2024-01-30 08:09:16 [10588] 💸 generated 3 npos voters, 3 from validators and 0 nominators    

FAQ

Why are nodes out of sync?

If the number of peers on your node is unstable and occasionally reaches 0, causing normal synchronization, try adding port mapping on your router to your public IP: 30333-> node's internal IP: 30333, and Set the firewall to allow port 30333 to connect.