# Coin Activation
There are two methods of coin activation:
enable
- Connects to a native daemon, or a url which handles RPCs for Platform coins (e.g. ETH, MATIC, FTM, BNB, ONE)electrum
- Connects to an electrum server (opens new window) for UTXO based coins and QTUM/QRC20 tokens.
A coin can only be activated once per session, and must be activated before it can be used in trading or wallet functions.
Important
The AtomicDEX API requires an mm2
parameter to be set for each coin
. This can be added to the enable/electrum command, or defined in your coins file.
The value of the mm2
parameter informs the software as to whether the coin
is expected to be compatible for atomic swaps.
0
=non-compatible
1
=compatible
TIP
Many examples of activation commands are available at kmd.stats.io (opens new window)
# Native mode activation
If you are running a UTXO based coin daemon locally and the blockchain is synchronised, you can connect the local daemon to the AtomicDEX API by using the enable
method, though some additional configuration is required. The AtomicDEX API requires the following options to be added to the native chain's .conf file (opens new window).
logevents=1
txindex=1
addressindex=1
Note
The AtomicDEX API node's coin address needs to be imported manually into the coin daemon using the importaddress method.
# Lite mode activation
Activating coins in 'lite mode' means you don't need to have a native coin daemon installed, or keep a local blockchain synchronised. In this mode, the AtomicDEX API communicates with an external node to perform transactions and query the blockchain. UTXO based coins and QTUM/QRC20 tokens communicate via electrum servers, while other platform coins communicate via JSON RPC urls.
AtomicDEX is a true cross chain, cross protocol Decentralized Exchange (DEX), allowing for trades between coins and tokens across many platforms and ecosystems, such as:
- UTXO based coins (e.g. DOGE, BTC, ZEC, LTC, DASH, DGB)
- Ethereum (ETH) (opens new window) & ERC20 tokens (opens new window)
- Binance Coin (BNB) (opens new window) & BEP20 (opens new window) tokens
- QTUM (opens new window) & QRC20 tokens (opens new window)
- Polygon (MATIC) (opens new window) & PLG20 tokens (opens new window)
- Harmony (ONE) (opens new window) & HRC20 tokens (opens new window)
- Fantom (FTM) (opens new window) & FTM20 tokens (opens new window)
- Avalanche (AVAX) (opens new window) & AVX20 tokens (opens new window)
- Moonriver (MOVR) (opens new window) & MVR20 tokens (opens new window)
- And more!
# Electrum
TIP
Electrum mode is only available for UTXO based coins and QTUM/QRC20 tokens.
# Arguments
Structure | Type | Description |
---|---|---|
coin | string | Ticker of coin to activate |
servers | array of objects | List of Electrum servers (opens new window) |
servers.url | string | Electrum server URL |
servers.protocol | string (optional, defaults to TCP ) | Transport protocol used by AtomicDEX API to connect to the electrum server (TCP or SSL ) |
servers.disable_cert_verification | bool (optional, defaults to false .) | If true , this disables server SSL/TLS certificate verification (e.g. to use self-signed certificate). Use at your own risk |
mm2 | integer | Required if not set in coins file. Informs the AtomicDEX API whether or not the coin is expected to function. Accepted values are 0 or 1 |
tx_history | bool | If true the AtomicDEX API will preload trasaction history as a background process. Must be set to true to use the my_tx_history method |
required_confirmations | integer (optional, defaults to 3 ) | Number of confirmations for the AtomicDEX API to wait during the transaction steps of an atomic swap. |
requires_notarization | boolean (optional, defaults to false ) | If true , coins protected by Komodo Platform's dPoW security (opens new window) will wait for a notarization before progressing to the next atomic swap transactions step. |
swap_contract_address | string (required for QRC20 only) | address of etomic swap smart contract |
fallback_swap_contract | string (required for QRC20 only) | address of backup etomic swap smart contract |
utxo_merge_params | object (optional) | If set, will consolidate excessive UTXOs (e.g. from mining) |
utxo_merge_params.merge_at | integer | Number of UTXOs in wallet required before merging |
utxo_merge_params.check_every | integer | How often to check the UTXO count, in seconds. Ideally should be at least 3x the coins block time. |
utxo_merge_params.max_merge_at_once | integer | Maximum number of UTXOs to merge in each consolidation transaction. Should be less that merge_at value, but will fail if so high the transaction becomes too large. Suggested maximum is 250. |
# Response
Structure | Type | Description |
---|---|---|
address | string | the address of the user's coin wallet, based on the user's passphrase |
balance | string (numeric) | the amount of coin the user holds in their wallet; does not include unspendable_balance |
unspendable_balance | string (numeric) | the coin balance that is unspendable at the moment (e.g. if the address has immature UTXOs) |
coin | string | the ticker of the enabled coin |
required_confirmations | number | the number of transaction confirmations for which the AtomicDEX API must wait during the atomic swap process |
mature_confirmations | number (optional) | the number of coinbase transaction confirmations required to become mature; UTXO coins only |
requires_notarization | bool | whether the node must wait for a notarization of the selected coin that is performing the atomic swap transactions; applicable only for coins using Komodo dPoW |
result | string | the result of the request; this value either indicates success , or an error, or another type of failure |
# 📌 Examples
# Command for UTXO based coins
curl --url "http://127.0.0.1:7783" --data "{
\"coin\": \"LTC\",
\"method\": \"electrum\",
\"servers\": [
{\"url\": \"electrum1.cipig.net:10063\"},
{\"url\": \"electrum2.cipig.net:10063\"},
{\"url\": \"electrum3.cipig.net:10063\"}
],
\"userpass\": \"$userpass\"
}"
# Command for UTXO based coins with required_confirmations
, requires_notarization
and mm2
arguments
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\"
}"
# Command (For QTUM/QRC20 tokens)
curl --url "http://127.0.0.1:7783" --data "{
\"coin\": \"QTUM\",
\"method\": \"electrum\",
\"servers\": [
{\"url\": \"electrum1.cipig.net:10050\"},
{\"url\": \"electrum2.cipig.net:10050\"},
{\"url\": \"electrum3.cipig.net:10050\"}
],
\"swap_contract_address\":\"0x2f754733acd6d753731c00fee32cb484551cc15d\",
\"userpass\": \"$userpass\"
}"
# Enable
# Arguments
Structure | Type | Description |
---|---|---|
coin | string | the name of the coin the user desires to enable |
urls | array of strings (required for ETH/ERC20 and other gas model chains) | urls of Ethereum RPC nodes to which the user desires to connect |
swap_contract_address | string (required for QRC20 only) | address of etomic swap smart contract |
fallback_swap_contract | string (required for QRC20 only) | address of backup etomic swap smart contract |
gas_station_url | string (optional for ETH/ERC20 and other gas model chains) | url of ETH gas station API (opens new window); The AtomicDEX API uses eth_gasPrice RPC API (opens new window) by default; when this parameter is set, the AtomicDEX API will request the current gas price from Station for new transactions, and this often results in lower fees |
gas_station_decimals | integer (optional for ETH/ERC20 and other gas model chains) | Defines the decimals used to denominate the gas station response to gwei units. For example, the ETH gas station uses 8 decimals, which means that "average": 860 is equal to 86 gwei. While the Matic gas station uses 9 decimals, so 860 would mean 860 gwei exactly. Defaults to 8 |
gas_station_policy.policy | string (optional for ETH/ERC20 and other gas model chains) | Defines the method of gas price calculation from the station response. "MeanAverageFast" will use the mean between average and fast fields. "Average" will return a simple average value. Defaults to "MeanAverageFast" . |
mm2 | integer | Required if not set in coins file. Informs the AtomicDEX API whether or not the coin is expected to function. Accepted values are 0 or 1 |
tx_history | bool | If true the AtomicDEX API will preload transaction history as a background process. Must be set to true to use the my_tx_history method |
required_confirmations | integer (optional, defaults to 3 ) | Number of confirmations for the AtomicDEX API to wait during the transaction steps of an atomic swap. |
requires_notarization | boolean (optional, defaults to false ) | If true , coins protected by Komodo Platform's dPoW security (opens new window) will wait for a notarization before progressing to the next atomic swap transactions step. |
# Response
Structure | Type | Description |
---|---|---|
address | string | the address of the user's coin wallet, based on the user's passphrase |
balance | string (numeric) | the amount of coin the user holds in their wallet; does not include unspendable_balance |
unspendable_balance | string (numeric) | the coin balance that is unspendable at the moment (e.g. if the address has immature UTXOs) |
coin | string | the ticker of enabled coin |
required_confirmations | number | AtomicDEX API will wait for the this number of coin's transaction confirmations during the swap |
requires_notarization | bool | whether the node must wait for a notarization of the selected coin that is performing the atomic swap transactions |
mature_confirmations | number (optional) | the number of coinbase transaction confirmations required to become mature; UTXO coins only |
result | string | the result of the request; this value either indicates success , or an error or other type of failure |
# 📌 Examples
# Command (for native UTXO-based blockchains)
curl --url "http://127.0.0.1:7783" --data "{
\"userpass\": \"$userpass\",
\"method\": \"enable\",
\"coin\": \"TKL\"
}"
# Command (With required_confirmations
, requires_notarization
and mm2
arguments)
curl --url "http://127.0.0.1:7783" --data "{
\"userpass\": \"$userpass\",
\"method\": \"enable\",
\"coin\": \"TKL\",
\"mm2\": 1,
\"required_confirmations\":10,
\"requires_notarization\":true
}"
# Command (for Ethereum and ERC20-based blockchains)
curl --url "http://127.0.0.1:7783" --data "{
\"coin\": \"ETH\",
\"method\": \"enable\",
\"urls\": [
\"http://eth1.cipig.net:8555\",
\"http://eth2.cipig.net:8555\",
\"http://eth3.cipig.net:8555\"
],
\"swap_contract_address\": \"0x24ABE4c71FC658C91313b6552cd40cD808b3Ea80\",
\"fallback_swap_contract\": \"0x8500AFc0bc5214728082163326C2FF0C73f4a871\",
\"userpass\": \"$userpass\"
}"
# Command (for Ethereum and ERC20-based blockchains with gas_station_url and policy)
curl --url "http://127.0.0.1:7783" --data "{
\"coin\": \"ETH\",
\"userpass\": \"$userpass\"
\"method\": \"enable\",
\"urls\": [
\"http://eth1.cipig.net:8555\",
\"http://eth2.cipig.net:8555\",
\"http://eth3.cipig.net:8555\"
],
\"swap_contract_address\": \"0x24ABE4c71FC658C91313b6552cd40cD808b3Ea80\",
\"fallback_swap_contract\": \"0x8500AFc0bc5214728082163326C2FF0C73f4a871\",
\"gas_station_url\": \"https://ethgasstation.info/json/ethgasAPI.json\",
\"gas_station_decimals\": 8,
\"gas_station_policy\": {
\"policy\": \"MeanAverageFast\"
}
}"
# Command for Polygon (MATIC) and PLG20 tokens
curl --url "http://127.0.0.1:7783" --data "{
\"coin\": \"NZDS-PLG20\",
\"method\": \"enable\",
\"swap_contract_address\": \"0x9130b257D37A52E52F21054c4DA3450c72f595CE\",
\"fallback_swap_contract\": \"0x9130b257D37A52E52F21054c4DA3450c72f595CE\",
\"urls\": [
\"https://polygon-rpc.com\"
],
\"userpass\": \"$userpass\"
}"
}"
# Command for Binance Coin (BNB) and BEP20 tokens
curl --url "http://127.0.0.1:7783" --data "{
\"coin\": \"BUSD-BEP20\",
\"method\": \"enable\",
\"swap_contract_address\": \"0xeDc5b89Fe1f0382F9E4316069971D90a0951DB31\",
\"fallback_swap_contract\": \"0xeDc5b89Fe1f0382F9E4316069971D90a0951DB31\",
\"urls\": [
\"http://bsc1.cipig.net:8655\",
\"http://bsc2.cipig.net:8655\",
\"http://bsc3.cipig.net:8655\"
],
\"userpass\": \"$userpass\"
}"
For enabling Z coins, refer to the Z coin tasks in the v2.0 Dev API.
To see more examples for other platforms like Fantom, Avalanche & Harmony, you can search the AtomicDEX API Coin Activation Commands List
(opens new window) or build a single batch
command to enable a set of selected coins via the
Batch Coin Activation Form (opens new window)
TIP
We welcome volunteers to test new coins for AtomicDEX API compatibility! Follow the Submitting Coin Test Results guide (opens new window) for more information, or drop into the Komodo Platform Discord Server (opens new window) for a chat if you need some help.