Masternode Documentation

Masternode Setup Guide

Complete guide to configure and run a BoostChain masternode

â„šī¸
Important: This guide covers the setup of Regular Masternodes. Evo Masternodes will be activated in a future update and their documentation will be published at that time.

📋 Table of Contents

  1. Prerequisites
  2. Collateral Preparation
  3. VPS Configuration
  4. Wallet Configuration
  5. Starting the Masternode
  6. Verification & Maintenance

1. Prerequisites

1,000 BOOST
Collateral required for a Regular Masternode

đŸ–Ĩī¸ Server Specifications (VPS)

đŸ’ģ CPU

1 core (minimum)
2+ cores (recommended)

🧠 RAM

2 GB (minimum)
4 GB (recommended)

💾 Storage

40 GB SSD
(with room for growth)

🌐 Network

100 Mbps
Static public IPv4

💡
Recommended VPS Providers: Vultr, DigitalOcean, Linode, Contabo, Hetzner. Choose a datacenter with low latency and good connectivity.

💰 Wallet Requirements

2. Collateral Preparation

1

Send exactly 1,000 BOOST

Send exactly 1,000.00000000 BOOST to a new address in your wallet. It's crucial that it's exactly 1,000 BOOST in a single transaction.

âš ī¸
Important: Don't send 999.99 or 1000.01. It must be exactly 1,000.00000000 BOOST. Any deviation will invalidate the collateral.
2

Wait for collateral to mature

Wait for at least 5 confirmations (approximately 5 minutes) before proceeding to the next step.

â„šī¸
The collateral needs to mature on the blockchain (5 blocks minimum) before it can be used for masternode registration.
3

Get the Transaction ID (txid) and Output Index

In your wallet console, run:

Console
masternode outputs

You'll get something like:

{
  "fdab9dff1ff9caf5d291905ad43b9f7d69775189d4d22cb085d7fedd94ea1c6a": "0"
}

The first value is your collateralHash and the second is your collateralIndex (usually "0" or "1"). Save both values.

4

Generate a BLS Key Pair

In the wallet console, run:

Console
bls generate

You'll get something like:

{
  "secret": "64f6f0e27be5d171b23f91803e9ad8fa1a92cb6a1f857eb664d5ab1ac35e514b",
  "public": "0b961a0679d231f2837515b4e7952792fae047143089fc7bc160ec5946496a61485993e358fad5342be32e3ce239fe8f",
  "scheme": "legacy"
}

Save both keys securely. The secret will be used on the VPS and the public in the ProTx registration.

5

Generate required addresses

Generate three addresses for different purposes. Run this command three times in the console:

Console
getnewaddress

Label each address as follows:

💡
Tip: You can use the same address for owner and voting if you want to simplify. Save all addresses in a text file for reference.
6

Find an address with funds for fees

In Core wallet:

  1. Go to Send tab
  2. Click Inputs button
  3. Look for an address with balance (for transaction fees)
  4. Right-click on it and Copy Address

This will be your feeSourceAddress. You need a small amount (~ 0.01 BOOST) for registration fees.

7

Register the Masternode (ProTx)

Now you'll use the protx register command to register your masternode on the network.

Command Syntax:

protx register "collateralHash" "collateralIndex" "ipAndPort" "ownerAddress" "operatorPubKey" "votingAddress" "operatorReward" "payoutAddress" "feeSourceAddress"
📝
Use the interactive form below to generate your command automatically!

đŸ› ī¸ ProTx Command Generator

Fill in all the fields below to generate your protx register command:

From: masternode outputs
Usually "0" or "1"
Your VPS IP and port 9939
From: getnewaddress
From: bls generate (public key)
Can be same as owner address
Usually 0 (you get 100% of rewards)
Where masternode rewards are sent
Address with funds for registration fee

3. VPS Configuration

1

Connect to VPS via SSH

Bash
ssh root@YOUR_VPS_IP
2

Update the system

Bash
apt update && apt upgrade -y
3

Create a new user (recommended for security)

Bash
adduser boostchain usermod -aG sudo boostchain su - boostchain
4

Download and install BoostChain Core

Download the latest version from the official repository:

Bash
# Create directory for binary mkdir -p ~/boostchain cd ~/boostchain # Download (replace X.X.X with current version) wget https://github.com/boostchain/boostchain/releases/download/vX.X.X/boostchain-X.X.X-x86_64-linux-gnu.tar.gz # Extract tar -xvzf boostchain-X.X.X-x86_64-linux-gnu.tar.gz # Copy binaries to PATH sudo cp boostchain-X.X.X/bin/* /usr/local/bin/ # Verify installation boostchaind --version
5

Create configuration file

First, create the data directory:

Bash
mkdir -p ~/.boostchaincore nano ~/.boostchaincore/boostchain.conf
📝
Use the interactive form below to generate your configuration file automatically with secure random credentials!

đŸ› ī¸ Config File Generator

Fill in the required fields to generate your boostchain.conf file with secure random RPC credentials:

Your VPS external IP address
From: bls generate (secret key from step 2.4)
6

Start the BoostChain daemon

Bash
boostchaind

The node will start syncing with the blockchain. This may take several hours.

To check progress:

boostchain-cli getblockcount
boostchain-cli mnsync status

4. Masternode Registration Complete

What happens after registration?

After successfully running the protx register command, you'll receive a ProTx Hash (transaction ID). This is your masternode's unique identifier on the network.

✓
Your masternode is now registered! The registration will be confirmed on the blockchain in the next block. You can now proceed to start your VPS node.

Save your ProTx Hash

The output will look something like:

7da2e1187202a1a497beca05e0e53a6e4df0dc06046f72fbf8b61c942db2982a

This is your ProTx Hash. Keep it safe - you'll need it to check your masternode status.

5. Starting the Masternode

1

Verify VPS is synced

On the VPS, run:

boostchain-cli mnsync status

It should show "AssetName": "MASTERNODE_SYNC_FINISHED"

2

Masternode starts automatically

After completing the ProTx registration and once your VPS is fully synced, your masternode will automatically start and appear in the masternode list.

â„šī¸
No manual start needed! Unlike the old system, masternodes registered via ProTx start automatically once the VPS daemon is synced and running.
3

Verify status

On the VPS, check masternode status:

boostchain-cli masternode status

You should see:

{
  "outpoint": "fdab9dff1ff9caf5d291905ad43b9f7d69775189d4d22cb085d7fedd94ea1c6a-0",
  "service": "1.2.3.4:9939",
  "proTxHash": "7da2e1187202a1a497beca05e0e53a6e4df0dc06046f72fbf8b61c942db2982a",
  "status": "Ready"
}

You can also check from your wallet console:

protx info "YOUR_PROTX_HASH"

6. Verification & Maintenance

🔍 Useful verification commands

Masternode status

boostchain-cli masternode status

List all masternodes

boostchain-cli masternode list

Network info

boostchain-cli getinfo

VPS wallet balance

boostchain-cli getbalance

âš ī¸ Common troubleshooting

Problem Solution
Masternode not showing as ENABLED Verify the collateral has at least 15 confirmations and the masternode.conf file is correct.
Error "Not capable masternode" Verify the VPS has port 9999 open and externalip is configured correctly.
Node not syncing Check network connectivity, make sure you're using the latest software version.
Masternode in POSE_BANNED state Your node has had too much downtime. Verify the service is running and wait for automatic restoration.

🔒 Additional security recommendations

🔐
Never share: Your BLS secret key, private keys, wallet.dat, or RPC credentials. Store them securely offline.