Installing Basic Komodo Software
To install the Komodo daemon,
komodod, and its necessary counterpart,
komodo-cli, the simplest method requires two steps.
Step 1 | MacOS & Linux
Download zcash parameters using the
fetch-params.sh script for Linux and MacOS from below.
Execute the file in the terminal.
The script will automatically download the Zcash parameters on your local machine. This process may take time depending on internet speed.
Step One | Windows
For Windows, you will find the
fetch-params.bat file included inside the zip that you will download in Step 2 below.
Double-click the file to download the Zcash parameters.
Once the Zcash parameters are downloaded, you are prepared to install pre-compiled binaries of the Komodo daemon,
Step 2 | All OS's
Once unzipped, the executables do not require installation. Simply find
komodo-cli in the directory where you unzipped the files.
You may also build
komodo-cli from source. This is not required, but it is considered the best practice. Building from source enables you to receive the latest patches and security upgrades the moment they are pushed to the
You will find a walkthrough on building from source here.
Interacting with Komodo Chains
There are two cooperating pieces of software that the user utilizes when running a Komodo-compatible blockchain from the command line.
The first is the coin daemon itself,
komodod. This is initiated by calling it from the command line and including any desired runtime parameters. When initiating any Komodo-compatible blockchain other than the main KMD blockchain, the user should always include all parameters used during the asset chain's creation.
Once the software is set up, change into the installation directory.
Note to Windows Users: Replace ./komodod and ./komodo-cli with komodod.exe and komodo-cli.exe for each step.
To launch the main KMD chain, execute:
After the daemon launches, you may interact with it using
komodo-cli like so:
To launch another Komodo-based blockchain, include the necessary parameters. A list of launch parameters for most of the Komodod-based blockchains in our ecosystem is found here.
For example, to launch the DEX asset chain, execute:
./komodod -ac_name=DEX -ac_supply=999999 -addnode=18.104.22.168 &
IMPORTANT: Always execute the launch command EXACTLY as indicated, and as the asset-chain's developers instruct. Failure to do so will cause you either to create a new chain, or to connect to another chain. If you make this mistake, you must delete the blockchain data and re-sync using the correct parameters to regain access to the blockchain's network.
To interact with the DEX daemon, use
komodo-cli like so:
./komodo-cli -ac_name=DEX API_COMMAND
Also, in the terminal you can call the Komodo documentation by executing:
To learn more via the terminal about a specific API command, execute:
./komodo-cli help API_COMMAND
./komodo-cli help getnewaddress
For more information about creating and interacting with asset chains, please visit our asset-chain creation documentation.
Follow this link to find information on accessing the coin daemon remotely.
Typically, a blockchain is vulnerable to double-spend attacks when its hash power is low. A Komodo-based blockchain can be secured against such attacks by enabling the dPoW security service. Please reach out to us when you are ready to purchase.
List of Asset-Chain Launch Parameters in the Komodo Ecosystem
A list of launch parameters for all chains in the Komodo ecosystem is found at this linked repository.
Komodo's Native DEX: BarterDEX
Komodo offers a native decentralized-exchange (DEX) compatibility through our software, BarterDEX. This software is separate from
BarterDEX is a pioneer in atomic-swap based exchange methods. If you're not familiar with the concept of atomic-swaps, check out Part III of our white paper.
We performed our first atomic swap in 2014, and using our BarterDEX v1.0 software we performed thousands in 2017 with the open-source community before the concept gained attention in the news. To date, users in the Komodo ecosystem have conducted over 100,000 atomic swaps. We are currently taking what we learned from these experiences and rewriting the software from the ground up for v2.0.
Via our open-source philosophy, anyone is welcome to use BarterDEX without restriction. As it is based on atomic-swap technology, the end-users utilizing BarterDEX maintain ownership of their private keys at all times. Therefore, developers maintaining any cluster of traders utilizing the BarterDEX software are not acting in the capacity of an escrow-service, a trading provider, a centralized exchange, or even a multi-coin decentralized gateway, unlike most other exchanges. This provides significant relief from the developer's technical security responsibilities.
Developers should consult with their local authorities about the legal nature of these decisions.
Because the BarterDEX software is separate from
komodo-cli, at this time we do not yet include it in this API documentation. Rather, you may find API documentation for BarterDEX here.