Set Up a Private Network

On this page, you will learn how to set up and bootstrap a private MakeOS network on your local machine. We will be creating a four (4) node local network where all the nodes are validators.

Step 1: Create Keys
Each node must be initialized with a unique validator key that will be used to identify the node and sign operations. We need to create a validator key for each of the nodes.
Node 1
Bash
Output
1
kit key gen
Copied!
1
Private Key: wgDGBTjRMawhiM4RfBrTJXCt...pTkcndMWmUSZi67zATqZ4
2
Public Key:  489XdyeZjDqx4GQiegutACHpeJb89ZBL5K3XEmfZTJtr1CcPJy1
Copied!
Node 2
Bash
Output
1
kit key gen
Copied!
1
Private Key: wcDVvz3UwHzPc2RxjtZVso1G...yd3Hc9GE7acZT74ARYpUXJ
2
Public Key:  49Ejroft49qZjvf8aAbUfhJEXtAy4L9W5rotS1z8v494Ebjxb
Copied!
Node 3
Bash
Output
1
kit key gen
Copied!
1
Private Key: wLPUBRgJ1kQ73AVaqfZ9vpfbNuu...68RYw8kG7gJ8qwmZC27EuQ
2
Public Key:  47p1YrT93a5m33SHsqH3CU1n3vYW7CR2bybjd4SNVicYLQ1CcSC
Copied!
Node 4
Bash
Output
1
kit key gen
Copied!
1
Private Key: wKQDFQiw4JYTUdeER2jx9ysP8rh...G4WUdZRc7vjYpmM16bDcy
2
Public Key:  48gR6x2Vym5M2dUfS3TpwqUYuhLqE91gxEmYRXaK7UFqVY6De5Z
Copied!
We use the command kit key gen  to generate an Ed25519 keypair. MakeOS uses Ed25519 public key signature system for signing and verifying operations.
Output from the kit key gen command will not match the output in the example above. This is normal.
Step 2: Initialize Nodes
Next, we must initialize the nodes individually so that they have their own data directory, configurations and are isolated from each other on the same machine. 
The kit init command tags the following flags when initializing a new node:
-v: The list of public keys of the nodes that will become the initial network validators.
-k: The validator private key of the node.
-t: The network's official launch Unix timestamp. 
Node 1
1
kit init --home.id n1 \
2
   -v=489XdyeZjDqx4GQiegutACHpeJb89ZBL5K3XEmfZTJtr1CcPJy1,\
3
      49Ejroft49qZjvf8aAbUfhJEXtAy4L9W5rotS1z8v494Ebjxb, \
4
      47p1YrT93a5m33SHsqH3CU1n3vYW7CR2bybjd4SNVicYLQ1CcSC \
5
      48gR6x2Vym5M2dUfS3TpwqUYuhLqE91gxEmYRXaK7UFqVY6De5Z \
6
   -k=wgDGBTjRMawhiM4RfBrTJXCt...pTkcndMWmUSZi67zATqZ4 \
7
   -t=1595700581
Copied!
Node 2
1
kit init --home.id n2 \
2
   -v=489XdyeZjDqx4GQiegutACHpeJb89ZBL5K3XEmfZTJtr1CcPJy1,\
3
      49Ejroft49qZjvf8aAbUfhJEXtAy4L9W5rotS1z8v494Ebjxb, \
4
      47p1YrT93a5m33SHsqH3CU1n3vYW7CR2bybjd4SNVicYLQ1CcSC \
5
      48gR6x2Vym5M2dUfS3TpwqUYuhLqE91gxEmYRXaK7UFqVY6De5Z \
6
   -k=wcDVvz3UwHzPc2RxjtZVso1G...yd3Hc9GE7acZT74ARYpUXJ \
7
   -t=1595700581
Copied!
Node 3
1
kit init --home.id n3 \
2
   -v=489XdyeZjDqx4GQiegutACHpeJb89ZBL5K3XEmfZTJtr1CcPJy1,\
3
      49Ejroft49qZjvf8aAbUfhJEXtAy4L9W5rotS1z8v494Ebjxb, \
4
      47p1YrT93a5m33SHsqH3CU1n3vYW7CR2bybjd4SNVicYLQ1CcSC \
5
      48gR6x2Vym5M2dUfS3TpwqUYuhLqE91gxEmYRXaK7UFqVY6De5Z \
6
   -k=wLPUBRgJ1kQ73AVaqfZ9vpfbNuu...68RYw8kG7gJ8qwmZC27EuQ \
7
   -t=1595700581
Copied!
Node 4
1
kit init --home.id n4 \
2
   -v=489XdyeZjDqx4GQiegutACHpeJb89ZBL5K3XEmfZTJtr1CcPJy1,\
3
      49Ejroft49qZjvf8aAbUfhJEXtAy4L9W5rotS1z8v494Ebjxb, \
4
      47p1YrT93a5m33SHsqH3CU1n3vYW7CR2bybjd4SNVicYLQ1CcSC \
5
      48gR6x2Vym5M2dUfS3TpwqUYuhLqE91gxEmYRXaK7UFqVY6De5Z \
6
   -k=wKQDFQiw4JYTUdeER2jx9ysP8rh...G4WUdZRc7vjYpmM16bDcy \
7
   -t=1595700581
Copied!
These commands will create 4 data directories, one for each node. You can find them in $HOME/.kit_n{1-4}.
Bootstrap The Network
If you successfully initialized the nodes in the last section, you are now ready to run them and create your very own local network.
Run the first node: n1
Start the first node with RPC service turned on so we can attach to it from another terminal.
Bash
Output
1
kit start --home.id=n1 --rpc.on
Copied!
1
INFO[0000] [node]: Starting node...                      DevMode=true NodeID=ac2ce8d01b1f26663ed30776503339bd3f6c684d
2
INFO[0000] [node]: App database has been loaded          AppDBDir=/Users/name/.lobe_n1/1/data/appdata.db
3
INFO[0000] [remote-server]: Server has started           Address="127.0.0.1:9004"
4
INFO[0000] [node]: Now listening for connections         Address="[email protected]:9000"
Copied!
 On a successful startup, the node will output details about its start and operation. Take note of the connection address, we will use it to get the other nodes to join the network started by n1. 
Connect the other nodes
Open three (3) new terminals and run each command below on each of them. The commands starts n2, n3 and n4, connecting them to n1. 
1
kit start --home.id=n2 \
2
   --node.address=127.0.0.1:8000 \
3
   --rpc.tmaddress=127.0.0.1:8001 \
4
   --node[email protected]127.0.0.1:9000
Copied!
1
kit start --home.id=n3  \
2
    --node.address=127.0.0.1:7000  \
3
    --rpc.tmaddress=127.0.0.1:7001  
4
    --node.addpeer=[email protected]:9000
Copied!
1
```shell script
2
kit start --home.id=n4 \
3
   --node.address=127.0.0.1:6000 \
4
   --rpc.tmaddress=127.0.0.1:6001 \
5
   --node[email protected]127.0.0.1:9000
Copied!
On success, all nodes will be connected and block creation will begin. Since all nodes are validators, they will take turns proposing new blocks.
Since Tendermint can tolerate 1/3 of nodes failing; 1 validator can go offline or become unresponsive and the network will still continue to create new blocks and process transactions.
Transfer Coins
Once you have a running node, you test the network by transferring the native coins from one account to another by using the user API available in the console mode.
Attach to the running node (n1)
To access the console API, we must attach to a running node. If you followed previous private network setup walkthrough, you can connect to n1 and start a console session with the following command
1
kit attach
Copied!
Create a recipient address
We need to create the address that will receive the coins we will send. You can use kit key gen to generate an address but since we are already in the console, you can use util.genKey method.
JavaScript
Output
1
> util.genKey()
Copied!
1
{
2
   "address": "os1m4aaslnzmdp4k3g52tk6eh94ghr547exvtcrkd",
3
   "privateKey": "wqEoX3B8o1M8SkU...eantBMK3XDZSvc8V8gSYu",
4
   "publicKey": "48u65FLpzAGNCepxPUAHaGQLwpbZyD7pRZ6AWhw6yaYHQ9p9HN5"
5
}
Copied!
Send Coins From Dev Account
When Kit is initialized in development mode, it creates a user account with an initial supply of 2,000,000 coins for development or testing purpose. The account's address and private key can be accessed via dev.accountAddress and dev.accountKeyrespectively.  
We are going to transfer 1,000 coins from the dev account to the beneficiary address we created earlier. We will use the user.send method. 
JavaScript
Output
1
user.send({ 
2
   to: "os1m4aaslnzmdp4k3g52tk6eh94ghr547exvtcrkd",  
3
   value:"1000", 
4
   fee: "1" 
5
}, dev.accountKey)
Copied!
1
{ "hash": "0xe971c8665e3430dd5a1d...b5dcc765b631dea133" }
Copied!
The hash of the transaction is returned when the transaction has been successfully validated and added into the Mempool. The transaction becomes processed when it is added to the next block by a block validator.
Check the balance
Let’s check the balance of the sender and the beneficiary. We use user.getBalance to check the account balance of an address. 
Bash
Output
1
user.getBalance(dev.accountAddress)
Copied!
1
"1999000"
Copied!