XDC Test Network

• XDC Private - Create your own Private Blockchain,
• Setup a XDC private network with four Masternodes,
• In this repository you will get a step-by-step guidance on setting up a hassle free XDC blockchain without knowing blockchain knowledge.

Prerequisite -

Software requirements -

Software	Type
Operating System	Ubuntu 20.04 64-bit or higher
Language	Go, Shell
Wallet	XDCPay

Hardware requirements -

Hardware	Recommanded
Compute	t3 large AWS instance
Memory	16 GB
Storage	500 GB (min)

Step 1: Installation -

• Install golang - Golang

  sudo wget https://go.dev/dl/go1.18.linux-amd64.tar.gz

  sudo rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.linux-amd64.tar.gz

Step 2: Create Environment Variables for easier access -

• Go Paths -

export GOROOT=/usr/local/go

export GOPATH=/home/ubuntu/go

export PATH=$PATH:/usr/local/go/bin

• XDC path -

alias XDC=/home/ubuntu/XDPoSChain/build/bin/XDC

• For bootnode -

alias bootnode=/home/ubuntu/XDPoSChain/build/bin/bootnode

• For Puppeth -

alias puppeth=/home/ubuntu/XDPoSChain/build/bin/puppeth

Step 3: Prepare Test Network Client Software -

Clone the project -

  git clone https://github.com/XinFinOrg/XDPoSChain

• Go to the project directory -

  cd XDPoSChain

  git checkout v1.4.4

  sudo su

  apt-get install build-essential

  apt-get update

  apt-get install make

• Set go paths for make all ( Step 2 ) -

  make all

Step 4: Prepare Test Network Software -

Clone the Masternode Setup repository - XDC-Testnetwork-Leo

  cd home/ubuntu

  git clone https://github.com/XDCFoundation/xdc-testnetwork-leo.git

• Go to the project directory

  cd xdc-testnetwork-leo

Step 5: Customize the Genesis file Using the Puppeth Tool -

• Genesis File is the file that contains all the information about the blockchain network.

• Note: Use XDCPay wallet for creating accounts & Take a note of every mentioned account and their Private keys.

• Run the Puppeth command and answer questions about your private chain.

cd /home/ubuntu/xdc-testnetwork-leo/genesis

• Delete the existing Genesis file - rm -rf genesis.json
• Set Path for Puppeth tool -

alias puppeth=/home/ubuntu/XDPoSChain/build/bin/puppeth

puppeth

• For Creating Genesis file follow this document - Hackernoon.com

Step 6: Setup Bootnode -

Export bootnode path -

  alias bootnode=/home/ubuntu/XDPoSChain/build/bin/bootnode

• Initialize bootnode key by entering the command -

  bootnode -genkey bootnode.key

• Then you will get bootnode.key like: feadc15144001acacc5aa420e874fa34c66ba39851f48cf1746f94339ae49f7d

• Then start bootnode with the command -

  bootnode -nodekey ./bootnode.key

• Copy bootnode information shown like -

  enode://048fb0712b244999f62b8c4481f7ed4b2a47632a9b56e4947396b24a8cfa4af9e5490cb36294df76421269d83668f4ac51166bdf85b03b8e912ec07c0e8ef3a6@[::]:30301

• Note - Make sure to add Public ip in enode-id (For connecting two different location nodes you should have to go with aws public ip)
• Example -

  self=enode://048fb0712b244999f62b8c4481f7ed4b2a47632a9b56e4947396b24a8cfa4af9e5490cb36294df76421269d83668f4ac51166bdf85b03b8e912ec07c0e8ef3a6@13.96.100.33:30301

Step 7: Start the Masternode -

Follow the following steps to start the masternode -

• Edit node1.sh, node2.sh, node3.sh, node4.sh files by replacing the Bootnode enode-id which was generated earlier.
• Enter the private key of the 4 masternode in the .env file, ( masternode, and signers private keys ) which was mentioned in the genesis file.
• Give permission to all files

  chmod 777 <filename>

• Start your masternode with the commands, (Open new terminal for every node and set paths) -

  bash node1.sh

  Respectively same for more nodes...

• For Different Geo-Locations You need multiple AWS instances, atleast four instances for four MasterNodes, Repeat the steps till step-7 & keep same bootnode key & bootnode enode-id for every node Setup.

Step 8: Check Your Private Chain -

• Connect ipc endpoint -

cd home/ubuntu/xdc-testnetwork-leo/nodes/1

XDC attach XDC.ipc

• Output should look like this -

Welcome to the XDC JavaScript console!

instance: XDC/v1.4.4-stable-7808840b/linux-amd64/go1.17.7
coinbase: xdcb96016369693812449d6f08e64275d5d639258d1
at block: 10 (Mon, 28 Mar 2022 19:12:11 IST)
 datadir: /home/ubuntu/xdc-testnetwork-leo/nodes/1
 modules: XDCx:1.0 XDCxlending:1.0 XDPoS:1.0 admin:1.0 debug:1.0 eth:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0
 >

This is the XDC JavaScript console.

Commands -

• eth.accounts / personal.listWallets / personal - Accounts list .

• eth.coinbase - Check Default Account .

• eth.blockNumber - For check the block number.

• eth.getBalance("<Account Number>") - For check the balance of any account.

• admin.peers / net.peerCount -For Verifying your nodes are now communicating or not.

• eth.sendTransaction({from: "<account1_address>", to: "<account2_address>", value: "10"}) - For doing the transaction on console.

• eth.getTransactionReceipt("<Transaction hash>") - For transaction details.

• txpool / eth.pendingTransaction - Check transaction pool if transaction facing any issues.

• eth.getTransactionCount("<account public key>") - For check transaction count.

• admin.nodeInfo.enode It gives you the enode id.

Step 9: Troubleshooting (To stop the nodes or if you encounter any issues) -

• Run -

bash reset.sh

• kill the processes used by XDC -

lsof -i

 kill <PID>

INTEGRATING XDC PRIVATE NETWORK WITH OTHER XDC APPLICATIONS -

1. Connect XDC Test Network with XDCpay -

• Add Network -
• Network Name XDC Testnetwork
• RPC- http://<Public ip of AWS/Local>:8545
• Chain ID - 50
• Currency Symbol (Optional) - XDC
• Save

2. Connect XDC Test Network with XDC Network Stats -

• For Connect XDC Network Stats with Test Network - Need to add --ethstats flag in Node.sh script files.
• Format - --ethstats value Reporting URL of a ethstats service - (nodename:secret@host:port)
• Example - --ethstats "Node-01:[email protected]:3000"

3. Connect XDC Test Network with Testnet faucet -

Backend -

• Clone repository - git clone https://github.com/XDCFoundation/xdc-faucet-leo-backend.git
• Update config.json ./config.json (see config.json with placeholders below)
• npm install from project's root - npm install
• Start the localhost server - npm run dev
• Server config.json (./config.json) with placeholders -

"Ethereum": {
    "etherToTransfer": "type amount of Ether to be sent from faucet here, for example 0.5",
    "gasLimit": "type XDC transaction gas limit here, for example, 0x7b0c",
    "live": {
      "rpc": "type XDC RPC address here, for example http://127.0.0.1:8545",
      "account": "type sender address here, for example, 0xf36045454F66C7318adCDdF3B801E3bF8CfBc6a1",
      "privateKey": "type private key of sender here, for example, 54dd4125ed5418a7a68341413f4006256159f9f5ade8fed94e82785ef59523ab"
    },
    "dev": {
      ...
    }
}

Frontend -

• Clone repository - git clone https://github.com/XDCFoundation/xdc-faucet-leo.git

• Install Node Modules - npm install

• Start the localhost server - npm start

• Ex - XDC Faucet

Reference -

• For more reference - Hackernoon.com