getDeviceInfo

Retrieves information about the connected DCENT hardware wallet — device id, firmware version, label, and active transport. Returns a typed V1Response<DeviceInfoPayload>, so fields like parameter.label are directly accessible.

Summary

Call after a device is connected to read its metadata, or to confirm which device/transport is active. Distinct from info, which reports bridge status rather than device data.

Signature

await dcent.getDeviceInfo(): Promise<V1Response<DeviceInfoPayload>>

Response — body.parameter (DeviceInfoPayload)

Field	Type	Description
deviceId	string?	Device identifier
version	string?	Firmware version
ksm_version	string?	Secure-module version
state	string?	Device state
label	string?	User-set device label
connectType	'usb' | 'ble'	Active transport
coin_list	{ name }[]?	Installed coin apps
fingerprint	{ max, enrolled }?	Biometric slots
isAttached	boolean?	Whether a device is attached
deviceModel	string?	Connected hardware model — 'DCENT-X' for a DCENT X; undefined for a DCENT Biometric Wallet or a bridge that does not report the model.

Request / Response

Request

const res = await dcent.getDeviceInfo()
const label = res.body.parameter?.label      // typed access

Response

{
  "header": {
    "version": "1.0",
    "status": "success"
  },
  "body": {
    "command": "getDeviceInfo",
    "parameter": {
      "deviceId": "…",
      "version": "2.x.x",
      "ksm_version": "1.x.x",
      "label": "My DCENT",
      "connectType": "usb",
      "coin_list": [
        {
          "name": "ETHEREUM"
        }
      ],
      "fingerprint": {
        "max": 10,
        "enrolled": 2
      }
    }
  }
}

info

This example is a DCENT Biometric Wallet, which does not report a model — so deviceModel is absent. A DCENT X returns "deviceModel": "DCENT-X" in the same object.

tip

Cache the result — device info rarely changes within a session.

• info
• setLabel
• V1Response