Skip to main content

getAccountInfo

Returns the list of accounts registered on the device as V2AccountInfo objects. Returns a typed V1Response<AccountListV2Payload>; the connector forwards the bridge-enriched response unchanged (no transform).

Signature​

await dcent.getAccountInfo(): Promise<V1Response<{ account: V2AccountInfo[] }>>

V2AccountInfo​

Asset identity is established by four axes: chainId (full CAIP-19) + contractAddress (token vs native) + meta.addressFormat (encoding) + keyPath.

// resolved
{ chainId: string,            // full CAIP-19 (no separate caip19 field)
  contractAddress?: string,
  keyPath: string,
  label: string,
  meta?: { customToken?, deviceCoinName?, addressFormat?, [k:string]: unknown } }
// unresolved (unknown to the bridge)
{ chainId: null, unresolved: true,
  raw: { coin_group, coin_name, address_path, label } }

Response​

{
  "header": {
    "version": "1.0",
    "status": "success"
  },
  "body": {
    "command": "getAccountInfo",
    "parameter": {
      "account": [
        {
          "chainId": "eip155:1/slip44:60",
          "keyPath": "m/44'/60'/0'/0/0",
          "label": "ETH 0"
        }
      ]
    }
  }
}

Response fields​

parameter.account is an array of V2AccountInfo. Each item is one of two shapes:

FieldTypeDescription
chainIdstring | nullFull CAIP-19 for a resolved account; null when the bridge could not resolve it (an unrecognized coin).
contractAddressstringOptional Token asset address. Absent for native coins.
keyPathstringThe device address path (BIP-44).
labelstringThe DCENT wallet label for the account.
metaobjectOptional Evolving metadata bag — customToken, deviceCoinName, addressFormat, plus forward-compatible keys.
unresolvedbooleantrue only on unresolved items; those carry raw: { coin_group, coin_name, address_path, label } instead of the resolved fields.