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 — a token the bridge does not recognize has no contractAddress and is flagged with meta.customToken: true instead when its parent chain can be derived; otherwise it comes back as an unresolved item) + meta.addressFormat (the encoding, or the account standard on Tezos / Algorand — absent on single-account chains and on accounts that no addressFormat value names, e.g. Bitcoin m/84', Substrate Ledger, Cardano m/1852'; Bitcoin m/49' / m/86' accounts do carry segwit-wrapped / taproot) + 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",
    "response_from": "getAccountInfo"
  },
  "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. The token's identifier in DCENT's registry: the on-chain address for EVM, SPL and similar tokens, but DCENT's internal form for Stellar, Stacks, XRP and Substrate parachain (Astar / Shibuya XC20) tokens (e.g. 0.GBNZ….AQUA.99994418409, 0.340282366920938463463374607431768211455) — convert it to the on-chain form (AQUA-GBNZ…, principal.contractName, the XRP <currency>.<issuer> — case-sensitive, and for some registered XRP tokens the currency must be the lowercase 40-hex code DCENT's registry keys it by (e.g. 454c53… for 2.rHXu….ELS.10000000000), which does not appear in contractAddress — the bare XC20 asset id) before passing it to syncAccount. Absent for native coins — and for a token the bridge does not recognize, which instead carries meta.customToken: true, meta.deviceCoinName (the device's coin name, a display hint) and the parent chain's chainId — when the parent chain cannot be derived, the item is returned as unresolved with chainId: null.
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.