What is the AtomicDEX-API?

The AtomicDEX API core 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 intermediatary, 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 AtomicDEX Desktop.

For a curated list of AtomicDEX 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

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.
• Additional Rust Components

  rustup install nightly-2022-10-29
  rustup default nightly-2022-10-29
  rustup component add rustfmt-preview
  

Note for x86_64 UNIX systems: To have more efficient memory consumption please execute the following command before building mm2. (It's also good to have before launching mm2.)

export JEMALLOC_SYS_WITH_MALLOC_CONF="background_thread:true,narenas:1,tcache:false,dirty_decay_ms:0,muzzy_decay_ms:0,metadata_thp:auto"

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

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

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 (7777 is the current main network) and some extra optional parameters.

For example:

{
  "gui": "core_readme",
  "netid": 7777,
  "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.

Usage

To launch the AtomicDEX API, 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 AtomicDEX API core (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.