Komodo DeFi Framework Method: task::init_trezor::status

API-v2task::init_trezor::status

task::init_trezor::status

After running the task::init_trezor::init method, you can query the status of device initialisation to check its progress.

Request Parameters

Parameter	Type	Required	Default	Description
task_id	integer	✓	`-`	The identifying number returned when initiating the initialisation process.
forget_if_finished	boolean	✗	`true`	If `false`, will return final response for completed tasks.

Response Parameters

Parameter	Type	Required	Description
status	string	✓	A short indication of how the requested process is progressing.
details	object	✓	Depending on the state of process progress, this will contain different information as detailed in the items below.
details.type	string	✓	Type of hardware wallet device (e.g. `Trezor`)
details.model	string	✓	The model of the hardware wallet device (e.g. `One` or `T`)
details.device_name	string	✓	The name of the device as defined by user in Trezor Suite or another wallet application.
details.device_id	string (hex)	✓	A unique identifier of the device, set during manufacturing.
details.device_pubkey	string (hex)	✓	The hardware wallet device's pubkey. If included in the `task::init_trezor::init` request, it will be the same as input. If not, it should be stored for future use.

📌 Examples

Command

task::init_trezor::status

POST

task::init_trezor::status

{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "task::init_trezor::status",
  "params": {
    "task_id": 0,
    "forget_if_finished": false
  }
}

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 Komodo DeFi Framework 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
}

On this page

Komodo DeFi Framework Method: task::init_trezor::status

task::init_trezor::status