Step by step instructions:

The following tutorial will enable new users of Komodo to launch their own asset chain using the Komodo Platform. Upon completion of these steps, the user will be in possession of a newly created blockchain and its associated cryptocurrency with parameters of their own design. Additional tutorials will follow this document that outline the various applications and methods of use for your new blockchain.

Disclaimer: This document is intended for use by experienced computer and network administrators. It is assumed that the user of this guide has a working knowledge of Linux and Command Line Interface (CLI) tools.

Prerequisites for Implementing a New Asset Chain on the Komodo Platform

The following requirements must be met prior to beginning this process. If at any time there are questions that arise which you cannot find answers to in the text of this document, please contact Komodo support:

  • New users must have minimum two Virtual Public Servers (VPS) with public static IP addresses. Recommended sources for obtaining a VPS include but are not limited to:
  • Vps servers must meet the following minimum system requirements:
    • At least two CPU Cores (2 Virtual CPU Cores are acceptable)
    • Minimum 4 GB of RAM
    • 64-bit Linux/Unix Operating System (Ubuntu 16.04 recommended)

Building Komodo 

Step One: Build Komodo on Both VPS Servers

  • To build Komodo you need to install the following dependencies:

    sudo apt-get install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git python python-zmq zlib1g-dev wget libcurl3-gnutls-dev bsdmainutils automake
  • After installing dependencies clone the Komodo repository:

    cdgit clone https://github.com/komodoplatform/komodocd komodo
  • After moving to the new Komodo directory execute the following commands to build Komodo:

    ./zcutil/fetch-params.sh./zcutil/build.sh
  • Repeat all of Step One for your Second VPS.

Step Two: Create Your Own Asset Chain

Note: Recommended max supply is 1 Billion.

Execute the First Komodo Daemon

You will now initiate the new asset chain on your primary VPS, which will become the seed node for your network.

  • In your primary VPS, change the directory to ~/komodo/src/:

    cdcd komodo/src
  • Execute the following command in the terminal:
    • ASSETCHAINAME should be in capital letters and will be the ticker symbol that you intend to use in the future for trading coins generated by your asset chain (Example: Komodo's ticker is KMD).
    • SUPPLYOFCOINS determines the total supply of coins that your new asset chain will contain. This number should be entered as a whole number with no decimal places or commas.
    • Verify that the IP address of your primary VPS server (the machine you are currently using) is input correctly in place of PUBLICIPOFPRIMARYVPS.
  • ./komodod -ac_name=ASSETCHAINNAME -ac_supply=SUPPLYOFCOINS -addnode=PUBLICIPOFPRIMARYVPS -gen &

Your primary VPS server is now deployed and you have created the basis for your new asset chain. Next we will move on to the secondary server, which will be responsible for the initial mining activity on your newly created asset chain.

Step Three: Activating Your Secondary Node to Mine Your New Asset Chain

    • In your secondary VPS,  change directory to ~/komodo/src/:

      cdcd komodo/src
    • Execute the command for running the second daemon:
      • Verify that the ASSETCHAINNAME exactly matches the name you used when setting up your primary VPS.
        • Verify that the SUPPLYOFCOINS exactly matches the parameters used when creating the asset chain in your primary VPS.
        • Verify that the IP address of your primary VPS server is input correctly in place of PUBLICIPOFPRIMARYVPS.
    • ./komodod -ac_name=ASSETCHAINNAME -ac_supply=SUPPLYOFCOINS -addnode=PUBLICIPOFPRIMARYVPS -gen &

Step Four: Access Your Coins

    • In the terminal of your primary VPS, enter the following command string to verify that the asset chain is running and is mining blocks:

      ./komodo-cli -ac_name=ASSETCHAINNAME getinfo
    • To send coins to an external wallet, enter the following command string:
      • ASSETCHAINADDRESS is the address of an Agama wallet. The Agama wallet will need to first be configured by the Chainmakers team to be able to accept deposits of the new cryptocurrency. Contact Chainmakers at support@chainmakers.co for assistance with configuring the Agama wallet to be compatible with your new asset chain.
    • ./komodo-cli -ac_name=ASSETCHAINNAME sendtoaddress <ASSETCHAINADDRESS> <AMOUNT>

You have now completed the deployment of your new asset chain. Additional documentation regarding use and management of your asset chain can be found at:  

Step Five: Connecting Nodes to Your Asset Chain

Additional nodes that need to use the same asset chain will connect to the first node which spawned the asset chain. Client nodes can be implemented by use of the following Komodo daemon command:

./komodod -ac_name=ASSETCHAINNAME -ac_supply=SUPPLYOFCOINS -addnode=PUBLICIPOFPRIMARYVPS

For example, the first node which spawned this new Asset Chain (EXAMPLECHAIN) had a public static IPv4 address of: "123.123.123.123" and EXAMPLECHAIN has a supply of 1,000,000 coins. The command for nodes connecting to this asset chain will look like this:

./komodod -ac_name=EXAMPLECHAIN -ac_supply=1000000 -addnode=123.123.123.123

Step Six (Optional): Secure Your Asset Chain with Delayed Proof of Work

You can further secure your new asset chain by employing Notary Nodes provided by the Komodo network.

These nodes will notarize your asset chain blocks to the Komodo network. Since the Komodo network is secured with dPoW by notarizing its blocks onto the Bitcoin blockchain, client asset chains inherit that security via Komodo.

To implement Notary Nodes on your new asset chain, contact Chainmakers or ChainZilla via email at: