HD Wallets Overview

The AtomicDEX API now is able to activate coins in Iguana and HW modes simultaneously!

For example, you can activate DOC with seed phrase or private key in Iguana mode and also activate MARTY with a Hardware wallet or using a HD account at the same time.

To get started, configure and launch the AtomicDEX API, then plug in your Trezor hardware wallet device.

Initialisation and authentication:

• Initialise connection with your Trezor with task::init_trezor::init
• Check the status of the connecton with task::init_trezor::status
• Cancel authentication process with task::init_trezor::cancel
• Authenticate using PIN or phrase with task::init_trezor::user_action

UTXO Coin Activation in Hardware Mode:

• Use task::enable_utxo::init for UTXO coins like KMD, BTC and DOGE.
• Check the activation status with task::enable_utxo::status
• Authenticate the activation with task::enable_utxo::user_action

QTUM Coin Activation in Hardware Mode:

• Use task::enable_qtum::init for QTUM Ecosystem coins.
• Check the activation status with task::enable_qtum::status
• Authenticate the activation with task::enable_qtum::user_action

Withdrawing your Funds:

• Prepare a transaction with task::withdraw::init
• Check the status of the transaction preparation with task::withdraw::status
• Cancel the transaction preparation with task::withdraw::cancel

Viewing Hardware Wallet Coin Balances:

• Initialise the balance request with task::account_balance::init
• Check the status of the balance request with task::account_balance::status

Creating New Addresses:

• Use can_get_new_address to determine if your current address has been used, or should be updated.
• Use get_new_address to generate a new address

Details for HwError error type

When requesting the status of a task, if an error_type of HwError is returned, the GUI / User should check the details in error_data field to know which action is required (as detailed below).

FoundUnexpectedDevice

The connected Trezor device has a different pubkey value than what was specified in the device_pubkey parameter

{
  "mmrpc": "2.0",
  "result": {
    "status": "Error",
    "details": {
      "error": "Found unexpected device. Please re-initialize Hardware wallet",
      "error_path": "lib.common_impl.coin_balance.utxo_common.hd_pubkey.hw_ctx",
      "error_trace": "lib:93] common_impl:46] coin_balance:304] utxo_common:163] hd_pubkey:176] hw_ctx:149]",
      "error_type": "HwError",
      "error_data": "FoundUnexpectedDevice"
    }
  },
  "id": null
}

FoundMultipleDevices

Multiple Trezor devices are plugged in. Remove the additional devices, and keep the one you want to use plugged in.

{
  "mmrpc": "2.0",
  "result": {
    "status": "Error",
    "details": {
      "error": "Found multiple devices. Please unplug unused devices",
      "error_path": "init_hw.crypto_ctx.hw_client",
      "error_trace": "init_hw:151] crypto_ctx:248] crypto_ctx:354] hw_client:152] hw_client:126]",
      "error_type": "HwError",
      "error_data": "FoundMultipleDevices"
    }
  },
  "id": null
}

NoTrezorDeviceAvailable

No Trezor device detected by the AtomicDEX API. Make sure it is plugged in, or try a different USB cable / port.

{
  "mmrpc": "2.0",
  "result": {
    "status": "Error",
    "details": {
      "error": "No Trezor device available",
      "error_path": "init_hw.crypto_ctx.hw_ctx.response.usb.libusb",
      "error_trace": "init_hw:151] crypto_ctx:248] crypto_ctx:354] hw_ctx:120] response:136] usb:46] libusb:195]",
      "error_type": "HwError",
      "error_data": "NoTrezorDeviceAvailable"
    }
  },
  "id": null
}