Guide To Set Up XinFin Master Node

This guide assumes foundational knowledge about blockchain technology and linux operating system. Ideally, person with technical background would be most suited. Also, careful thought has to be given to security aspect if hardware wallets are not being put into use.

Commercial masternode hosting services are also available in the market giving you the benefit of reduced workload of managing the operations.

Before You Begin

This guide will demonstrate how to set up a single masternode for the very first time. You will need the following before starting:

  1. At least 10,000,000 XDC with masternode holder to perform proof-of-stake consensus seamlessly.
  2. Wallet to store XDC tokens, preferably hardware.
  3. Dedicated and stable hardware environment.
  4. Dedicated Static Public IP address.
  5. 100% network uptime by IDC network.
  6. Minimum tier 3+ IDC environment.
  7. (Optional, but highly recommended) Virtual Private Server (VPS).
  8. For cloud based services, Amazon EC2's m3.large VM size would be appropriate. Similar configuration is applicable for Microsoft Azure Cloud network.

This guide will cater to the following system configurations:

Operating System

CentOS or RedHat Enterprise Linux (latest release) or Ubuntu (15.04+) supported


Mac OS X, Windows (64-bit), or most Linux distributions


64-bit x86_64, 2+ cores


Minimum 200GB SSD recommended (500+ IOPS, more is better) for the database partition


16+ GB

About XinFin Masternode

XinFin's token XDC supplants proof-of-work consensus algorithm (popularly linked with mining) with proof-of-stake consensus algorithm, fundamentally using the concept of "validators".

Validators are special nodes used in the DPoS consensus algorithm which validate each transaction occurring on the blockchain network. The result of this validation is to finally append the transaction on the blockchain. A transaction may be accepted by the validator or rejected. (Important: There can be multiple validator nodes in each network.)

Decisions made by these validator nodes are broadcasted through the network as messages which are signed (attested) using validated cryptographic public key. Every validator node running XDC protocol in the RCL network is responsible for deciding its Unique Node List (UNL). This list holds information about which regular nodes does the validator care about.

To set up a masternode, make sure your XDC protocol running node is publicly identified and has gone through the compliance process. Every Node Holder need to upload KYC document and this detail will be visible to the public network.

Why set up a masternode at all?

It is necessary to set up a masternode to operate on XDC protocol because masternodes make the decentralised blockchain network self-sustainable. Deploying masternode is conducive to trusted, scalable decentralised network infrastructure. Such an environment facilitates greater stability and reliability on the network.

Functions of masternode

In DPoS blockchain environment, masternode concept is cardinal to the functioning. A masternode validates each (or segment of transaction depending upon UNL) transaction and is also responsible for writing the transaction onto the truth ledger: the blockchain. As a consequence, this makes decentralised governance of the network possible.

Master node

  • Masternodes are full-nodes that create, verify and validate new blocks in XinFin's platform.
  • mXDC: Let's assume mXDC {mainNet-XDC} will be native crypto on XinFin dPOS network. mXDC will be rewarded to MN Owners.
  • Epoch: We can use epoch instead of hard date to distribute incentive/rewards to masternode owners (1 epoch could be number of block, for example {1 Epoch = 888 Blocks}
  • Masternode Candidate: Any account can deposit X mXDC using the official on-chain governance d-app to complete KYC complaint to become a Masternode Candidate. X'nos mXDC deposit can earn staking rewards. A Candidate can resign, but the mXDC tokens will be locked for the next 30 days ( Let's assume we have new block in each 2 sec 1,296,000 blocks) after the resignation.
  • Becoming a Masternode: A Candidate becomes a Masternode when he/she belongs to top 50 most voted Candidates in each epoch. A Masternode can resign, but the tokens will be locked for the next 30 days after the resignation.
  • Reward: The reward a Masternode receives in each epoch is proportional to the number of signatures he/she signs.

Restrictions on nodes which aspire to become masternodes

Nodes which possess any of the below mentioned characteristics may not qualify to become masternodes:

  • Anonymous entity on the network.
  • Intentions to fork XDC Software.
  • Entity or Individual with Criminal record in past.
  • Entity or Individual which does not comply with local law of land.

Incentives to set up your own masternode

Several reasons why setting up a masternode is useful are:

  • Reputation building within the network community.
  • Trust Factor enhances for your node particularly since network relies on your node.
  • More Incentive gain as your node pushes more transactions on network.
  • Private blockchain is capable of running its own use case.

Important: Max number of Master node allowed in the network is 5000.

Special incentives for 18th validator node: information required Depends on Nos of Block created by validator node (incentive In terms of XDC)

Reward Cycle: Every 15 days.


1. a. What is Masternode Node?

Masternode is simply a cryptocurrency full node or computer wallet that keeps the full copy of the blockchain record in real-time.

1 b. What is Validator node?

In XinFin, "Validator Node" are full nodes that incentivize node operators to perform the core consensus functions of running a DPoS based blockchain. Only Validator Node gets incentive to validate the transaction.

How to become a Validator Node?

Under XinFin DPoS, Highest XDC Stakeholder 21 Node Act as Validator node rest node act as Backup node and Private node.

If there is no transaction fees on network then how validator gets incentive?

Network generate additional coin to provide incentive to validator node. Nos depends on network load and numbers of transaction process within the network.

How to get XDC ?

XDC is listed with more then 20 Liquidity Exchanges. The full list of exchanges is available at so that you can purchase XDC from open market to stake under masternode.

Hands on guide: How to Setup Masternode

There are two methods to choose from to set up the masternode:

  1. DIY masternode environment set up
  2. Delegate masternode set up to third party service provider

METHOD 1: DIY Masternode environment set up

CentOS or RedHat Enterprise Linux (latest release) or Ubuntu (15.04+) supported

Clone repository

git clone

Enter XinFin-Node directory

cd XinFin-Node

Step 1: Install docker & docker-compose

sudo ./

Step 2: Update .env file with details

cp env.example .env
nano .env

Step 3: Start your Node


sudo docker-compose -f docker-services.yml up -d

Your coinbase address can be found in xdcchain/coinbase.txt file.

To stop the node or if you encounter any issues use:

sudo docker-compose -f docker-services.yml down


To upgrade please use the following commands

sudo docker-compose -f docker-services.yml down
sudo ./
sudo docker-compose -f docker-services.yml up -d

Windows/macOS Setup support using Vagrant

You need to download install below mention 3 Software:

  1. Install Oracle VirtualBox
  2. Install Vagrant
  3. Install GIT After installation of above 3 Software (this may also need restart of your machine.)
  4. Launch "command prompt" & follow the commands below
  5.  git clone
     cd XinFin-Node
     vagrant up
     vagrant ssh
  6. XinFin-Node is automatically copied to /home/vagrant/ follow Step 1, 2 & 3 as explained before in this document to complete the node setup.
  7. To shutdown the vagrant instance, run vagrant suspend. To delete it, run vagrant destroy.


If you are having problems with Setup, the first step is to collect more information to accurately characterize the problem. From there, it can be easier to figure out a root cause and a fix.

METHOD 2: Delegate masternode set up to third party service provider

Set up your Masternode using one of these 3rd party Masternode service providers.

DISCLAIMER: This list is provided for informational purposes only. Services listed here have not been evaluated or endorsed by XinFin and no guarantees are made as to the accuracy of this information. Please exercise discretion when using third-party services.

List of service provider to Setup masternode

    • IPv6 and tor Supported
    • Global geographical locations
    • Fully Managed Network
    • Network attack prevention (DDoS)
    • One time Setup Cost: Free
    • Monthly: 250 USD (pay in XDC, Paypal, debit, or credit card)

Are you a Provider?

If yes, then Contact us to List your service.

Masternode Tools

Where to operate? Mainnet vs Testnet:

In XinFin, there are two networks where you can run XDC protocol: the mainnet and the testnet.

The mainnet is used to transact real XDC. The XDC's value is tied to real fiat currency via cryptocurrency exchanges.

As developers, you do not want to run application tests with real money. That is what the testnet is for. We call the testnet XinFinTestNet.