What is the Komodo DeFi Framework?

The Komodo DeFi Framework is open-source atomic-swap software for seamless, decentralised, peer to peer trading between almost every blockchain asset in existence. This software works with propagation of orderbooks and swap states through the libp2p protocol and uses Hash Time Lock Contracts (HTLCs) for ensuring that the two parties in a swap either mutually complete a trade, or funds return to thier original owner.

There is no 3rd party intermediary, no proxy tokens, and at all times users remain in sole possession of their private keys.

A well documented API offers simple access to the underlying services using simple language agnostic JSON structured methods and parameters such that users can communicate with the core in a variety of methods such as curl in CLI, or fully functioning desktop and mobile applications like Komodo Wallet Desktop.

For a curated list of Komodo DeFi Framework based projects and resources, check out Awesome AtomicDEX.

Features

• Perform blockchain transactions without a local native chain (e.g. via Electrum servers)
• Query orderbooks for all pairs within the supported coins
• Buy/sell from the orderbook, or create maker orders
• Configure automated "makerbot" trading with periodic price updates and optional telegram alerts

System Requirements

• 64-bit MacOS, Windows, or Linux operating system
• 2GB of free RAM (or more)
• User account with admin/root privileges

Building from source

On Host System:

Pre-built release binaries are available for OSX, Linux or Windows.

If you want to build from source, the following prerequisites are required:

• Rustup
• OS specific build tools (e.g. build-essential on Linux, XCode on OSX or MSVC on Win)
• (Optional) OSX: install openssl, e.g. brew install openssl.
• (Optional) OSX: run LIBRARY_PATH=/usr/local/opt/openssl/lib
• (Optional) Linux: Install libudev-dev (dpkg) or libudev-devel (rpm) package.
• Download or compile protoc 3.21.x+ and add it to your PATH env. It is also available via package managers depending on the OS.

To build, run cargo build (or cargo build -vv to get verbose build output).

For more detailed instructions, please refer to the Installation Guide.

From Container:

If you want to build from source without installing prerequisites to your host system, you can do so by binding the source code inside a container and compiling it there.

Build the image:

docker build -t mm2-build-container -f .docker/Dockerfile .

Bind source code into container and compile it:

docker run -v "$(pwd)":/app -w /app mm2-build-container cargo build

Just like building it on your host system, you will now have the target directory containing the build files.

Building WASM binary

Please refer to the WASM Build Guide.

Configuration

Basic config is contained in two files, MM2.json and coins

The user configuration MM2.json file contains rpc credentials, your mnemonic seed phrase, a netid (8762 is the current main network) and some extra optional parameters.

For example:

{
  "gui": "core_readme",
  "netid": 8762,
  "rpc_password": "Ent3r_Un1Qu3_Pa$$w0rd",
  "passphrase": "ENTER_UNIQUE_SEED_PHRASE_DONT_USE_THIS_CHANGE_IT_OR_FUNDS_NOT_SAFU"
}

The coins file contains information about the coins and tokens you want to trade. A regularly updated version is maintained in the Komodo Platform coins repository. Pull Requests to add any coins not yet included are welcome.

To facilitate interoperability with the mm2 service, there is the adex-cli command line utility. It provides a questionnaire initialization mode to set up the configuration and obtain the proper coin set through the internet. It can also be used to start or stop the service.

Usage

To launch the Komodo DeFi Framework, run ./mm2 (or mm2.exe in Windows)

To activate a coin:

curl --url "http://127.0.0.1:7783" --data '{
	"coin": "KMD",
	"method": "electrum",
	"servers": [
		{"url": "electrum1.cipig.net:10001"},
		{"url": "electrum2.cipig.net:10001"},
		{"url": "electrum3.cipig.net:10001"}
	],
	"required_confirmations":10,
	"requires_notarization":true,
	"mm2":1,
	"userpass": "$userpass"
}'

To view the orderbook for a pair:

curl --url "http://127.0.0.1:7783" --data '{
    "userpass":"$userpass",
    "method":"orderbook",
    "base":"KMD",
    "rel":"BTC"
}'

To place a buy order:

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "$userpass",
  "method": "buy",
  "base": "KMD",
  "rel": "DOGE",
  "volume": "10",
  "price": "4"
}'

Refer to the Komodo Developer Docs for details of additional RPC methods and parameters

Project structure

mm2src - Rust code, contains some parts ported from C as is (e.g. lp_ordermatch) to reach the most essential/error prone code. Some other modules/crates are reimplemented from scratch.

Additional docs for developers

• Contribution guide
• Setting up the environment to run the full tests suite
• Git flow and general workflow
• Komodo Developer Docs

Disclaimer

This repository contains the work in progress code of the brand new Komodo DeFi Framework (mm2) built mainly on Rust.
The current state can be considered as a alpha version.

WARNING: Use with test coins only or with assets which value does not exceed an amount you are willing to lose. This is alpha stage software!

Help and troubleshooting

If you have any question/want to report a bug/suggest an improvement feel free to open an issue or join the Komodo Platform Discord dev-marketmaker channel.