@exodus/hardware-wallets 3.4.1 → 3.6.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.6.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/hardware-wallets@3.5.0...@exodus/hardware-wallets@3.6.0) (2026-01-21)
+
+### Features
+
+- feat: trezor passphrase support (#14965)
+
+## [3.5.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/hardware-wallets@3.4.0...@exodus/hardware-wallets@3.5.0) (2025-12-11)
+
+### Features
+
+- feat: throw device unininitialized error for hw (#14601)
+
+### Bug Fixes
+
+- fix: various trezor and hardware-wallets fixes (#14502)
+
 ## [3.4.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/hardware-wallets@3.4.0...@exodus/hardware-wallets@3.4.1) (2025-11-28)
 
 ### Bug Fixes

package/lib/api/index.d.ts

@@ -16,7 +16,6 @@ declare const hardwareWalletsApiDefinition: {
             listUseableAssetNames: () => Promise<string[]>;
             scanForDevices: (deviceType?: import("libraries/hw-common/lib/types.js").HardwareWalletManufacturer) => Promise<void>;
             canAccessAsset: ({ assetName }: import("../module/interfaces.js").CanAccessAssetParams) => Promise<boolean>;
-            ensureApplicationIsOpened: ({ assetName }: import("../module/interfaces.js").EnsureApplicationIsOpenedParams) => Promise<void>;
             scan: ({ assetName, accountIndexes, addressLimit, addressOffset, }: import("../module/interfaces.js").ScanParams) => Promise<import("../module/interfaces.js").ScanResult>;
             sync: ({ accountIndex: index, isMultisig }?: import("../module/interfaces.js").SyncParams) => Promise<import("../module/interfaces.js").SyncedKeysId>;
             addPublicKeysToWalletAccount: ({ walletAccount, syncedKeysId }: import("../module/interfaces.js").StoreSyncedKeysParams) => Promise<void>;
@@ -25,6 +24,7 @@ declare const hardwareWalletsApiDefinition: {
             cancelSigningRequest: (id: string, fromUI: boolean) => Promise<void>;
             submitPairingCode: ({ code }: import("../module/interfaces.js").ProcessPairingCodeParams) => Promise<any>;
             clearPairingRequest: () => () => Promise<void>;
+            setPassphraseMode: ({ enabled }: import("../module/interfaces.js").SetPassphraseModeParams) => Promise<void>;
         };
     };
     readonly dependencies: readonly ["hardwareWallets", "txLogMonitors", "restoreProgressTracker"];

package/lib/api/index.js

@@ -23,7 +23,6 @@ const createHardwareWalletsApi = ({ hardwareWallets, restoreProgressTracker, txL
             listUseableAssetNames: hardwareWallets.listUseableAssetNames,
             scanForDevices: hardwareWallets.scanForDevices,
             canAccessAsset: hardwareWallets.canAccessAsset,
-            ensureApplicationIsOpened: hardwareWallets.ensureApplicationIsOpened,
             scan: hardwareWallets.scan,
             sync: hardwareWallets.sync,
             addPublicKeysToWalletAccount: hardwareWallets.addPublicKeysToWalletAccount,
@@ -32,6 +31,7 @@ const createHardwareWalletsApi = ({ hardwareWallets, restoreProgressTracker, txL
             cancelSigningRequest: hardwareWallets.cancelSigningRequest,
             submitPairingCode: hardwareWallets.submitPairingCode,
             clearPairingRequest: () => hardwareWallets.clearPairingRequest,
+            setPassphraseMode: hardwareWallets.setPassphraseMode,
         },
     };
 };

package/lib/index.d.ts

@@ -19,7 +19,6 @@ declare const hardwareWallets: () => {
                     listUseableAssetNames: () => Promise<string[]>;
                     scanForDevices: (deviceType?: import("libraries/hw-common/lib/types.js").HardwareWalletManufacturer) => Promise<void>;
                     canAccessAsset: ({ assetName }: import("./module/interfaces.js").CanAccessAssetParams) => Promise<boolean>;
-                    ensureApplicationIsOpened: ({ assetName }: import("./module/interfaces.js").EnsureApplicationIsOpenedParams) => Promise<void>;
                     scan: ({ assetName, accountIndexes, addressLimit, addressOffset, }: import("./module/interfaces.js").ScanParams) => Promise<import("./module/interfaces.js").ScanResult>;
                     sync: ({ accountIndex: index, isMultisig }?: import("./module/interfaces.js").SyncParams) => Promise<import("./module/interfaces.js").SyncedKeysId>;
                     addPublicKeysToWalletAccount: ({ walletAccount, syncedKeysId }: import("./module/interfaces.js").StoreSyncedKeysParams) => Promise<void>;
@@ -28,6 +27,7 @@ declare const hardwareWallets: () => {
                     cancelSigningRequest: (id: string, fromUI: boolean) => Promise<void>;
                     submitPairingCode: ({ code }: import("./module/interfaces.js").ProcessPairingCodeParams) => Promise<any>;
                     clearPairingRequest: () => () => Promise<void>;
+                    setPassphraseMode: ({ enabled }: import("./module/interfaces.js").SetPassphraseModeParams) => Promise<void>;
                 };
             };
             readonly dependencies: readonly ["hardwareWallets", "txLogMonitors", "restoreProgressTracker"];

package/lib/module/hardware-wallets.d.ts

@@ -1,6 +1,6 @@
 import { WalletAccount } from '@exodus/models';
 import Emitter from '@exodus/wild-emitter';
-import type { HardwareSignerProvider, CanAccessAssetParams, CreateParams, StoreSyncedKeysParams, ScanParams, SyncParams, EnsureApplicationIsOpenedParams, SignTransactionParams, ScanResult, SyncedKeysId, GetAddressParams, RequireDeviceForParams, ProcessPairingCodeParams, SigningRequestState } from './interfaces.js';
+import type { HardwareSignerProvider, CanAccessAssetParams, CreateParams, StoreSyncedKeysParams, ScanParams, SyncParams, SignTransactionParams, ScanResult, SyncedKeysId, GetAddressParams, RequireDeviceForParams, ProcessPairingCodeParams, SigningRequestState, SetPassphraseModeParams } from './interfaces.js';
 import type { HardwareWalletDiscovery, HardwareWalletManufacturer, SignMessageParams } from '@exodus/hw-common';
 import type { Atom } from '@exodus/atoms';
 import type { IPublicKeyStore } from '@exodus/public-key-provider/lib/module/store/types';
@@ -38,7 +38,6 @@ export declare class HardwareWallets implements HardwareSignerProvider {
     }[]>;
     canAccessAsset: ({ assetName }: CanAccessAssetParams) => Promise<boolean>;
     listUseableAssetNames: () => Promise<string[]>;
-    ensureApplicationIsOpened: ({ assetName }: EnsureApplicationIsOpenedParams) => Promise<void>;
     getAddress: ({ assetName, accountIndex, addressIndex, multisigData, displayOnDevice, }: GetAddressParams) => Promise<string>;
     scan: ({ assetName, accountIndexes, addressLimit, addressOffset, }: ScanParams) => Promise<ScanResult>;
     sync: ({ accountIndex: index, isMultisig }?: SyncParams) => Promise<SyncedKeysId>;
@@ -46,6 +45,7 @@ export declare class HardwareWallets implements HardwareSignerProvider {
     create: ({ syncedKeysId, isMultisig }: CreateParams) => Promise<WalletAccount>;
     clearPairingRequest: () => Promise<void>;
     submitPairingCode: ({ code }: ProcessPairingCodeParams) => Promise<any>;
+    setPassphraseMode: ({ enabled }: SetPassphraseModeParams) => Promise<void>;
     requireDeviceFor: ({ walletAccount }: RequireDeviceForParams) => Promise<{
         signTransaction: ({ baseAssetName, unsignedTx, walletAccount, multisigData, }: SignTransactionParams) => Promise<any>;
         signMessage: ({ assetName, derivationPath, message }: SignMessageParams) => Promise<any>;

package/lib/module/hardware-wallets.js

@@ -3,7 +3,7 @@ import { WalletAccount } from '@exodus/models';
 import Emitter from '@exodus/wild-emitter';
 import { randomBytes } from '@exodus/crypto/randomBytes';
 import delay from 'delay';
-import { NoDeviceFoundError, UserRefusedError } from '@exodus/hw-common';
+import { DeviceUninitializedError, NoDeviceFoundError, HardwareWalletManufacturerMismatchError, UserRefusedError, } from '@exodus/hw-common';
 import restrictConcurrency from 'make-concurrent';
 import pDefer from 'p-defer';
 export class HardwareWallets {
@@ -20,6 +20,15 @@ export class HardwareWallets {
     #signingRequest;
     #isRetrying = false;
     events = new Emitter();
+    #requireTrezorDevice = (device) => {
+        if (device.descriptor.manufacturer !== WalletAccount.TREZOR_SRC) {
+            throw new HardwareWalletManufacturerMismatchError({
+                expected: WalletAccount.TREZOR_SRC,
+                actual: String(device.descriptor.manufacturer),
+            });
+        }
+        return device;
+    };
     constructor({ assetsModule, ledgerDiscovery, trezorDiscovery, logger, hardwareWalletSigningRequestsAtom, publicKeyStore, wallet, walletAccountsAtom, walletAccounts, }) {
         this.#assetsModule = assetsModule;
         this.#ledgerDiscovery = ledgerDiscovery;
@@ -31,12 +40,41 @@ export class HardwareWallets {
         this.#walletAccountsAtom = walletAccountsAtom;
         this.#walletAccounts = walletAccounts;
     }
-    #getSelectedDevice = async () => {
-        const [trezors, ledgers] = await Promise.all([
-            this.#trezorDiscovery.list().catch(() => []),
-            this.#ledgerDiscovery.list().catch(() => []),
-        ]);
-        const descriptors = [...trezors, ...ledgers];
+    #listTrezorDevicesOrEmpty = async () => {
+        try {
+            return await this.#trezorDiscovery.list();
+        }
+        catch (error) {
+            if (error instanceof DeviceUninitializedError) {
+                throw error;
+            }
+            return [];
+        }
+    };
+    #listLedgerDevicesOrEmpty = async () => {
+        try {
+            return await this.#ledgerDiscovery.list();
+        }
+        catch {
+            return [];
+        }
+    };
+    #getSelectedDevice = async (walletAccount) => {
+        let descriptors;
+        const manufacturer = walletAccount?.source;
+        if (manufacturer === 'ledger') {
+            descriptors = await this.#listLedgerDevicesOrEmpty();
+        }
+        else if (manufacturer === 'trezor') {
+            descriptors = await this.#listTrezorDevicesOrEmpty();
+        }
+        else {
+            const [trezors, ledgers] = await Promise.all([
+                this.#listTrezorDevicesOrEmpty(),
+                this.#listLedgerDevicesOrEmpty(),
+            ]);
+            descriptors = [...trezors, ...ledgers];
+        }
         if (descriptors[0]) {
             return { device: await descriptors[0].get() };
         }
@@ -70,7 +108,7 @@ export class HardwareWallets {
         this.#isRetrying = true;
         try {
             this.#logger.debug(`Attempting to get selected device for signing request with id: ${id}`);
-            const { device } = await this.#getSelectedDevice();
+            const { device } = await this.#getSelectedDevice(request.walletAccount);
             this.#logger.debug(`Attempting to sign for signing request with id: ${id}`);
             const result = await request.sign({ device });
             await this.#deleteSigningRequest(id);
@@ -115,7 +153,7 @@ export class HardwareWallets {
         if (fromUI) {
             this.#logger.debug(`Cancelling signing request on device for id: ${id}`);
             try {
-                const { device } = await this.#getSelectedDevice();
+                const { device } = await this.#getSelectedDevice(request.walletAccount);
                 await device.cancelAction();
                 this.#logger.debug(`Succesfully cancelled signing request on device for id: ${id}`);
             }
@@ -125,20 +163,21 @@ export class HardwareWallets {
         }
         request.reject(new UserRefusedError(!fromUI));
     };
-    #signGeneric = restrictConcurrency(async ({ baseAssetName, scenario, sign }) => {
+    #signGeneric = restrictConcurrency(async ({ baseAssetName, scenario, sign, walletAccount }) => {
         const id = randomBytes(16).toString('hex');
         this.#logger.debug(`Starting signing request for ${baseAssetName} with scenario: ${scenario} and id: ${id}`);
         const deferred = pDefer();
         this.#signingRequest = {
             id,
             baseAssetName,
+            walletAccount,
             sign: async ({ device }) => {
                 await this.#updateSigningRequest({
                     id,
                     baseAssetName,
                     scenario,
                 });
-                await device.ensureApplicationIsOpened(baseAssetName);
+                await device.ensureDeviceReady({ baseAssetName, walletAccount });
                 return sign({ device });
             },
             resolve: deferred.resolve,
@@ -158,7 +197,12 @@ export class HardwareWallets {
                 multisigData,
             });
         };
-        return this.#signGeneric({ baseAssetName, scenario: 'signTransaction', sign });
+        return this.#signGeneric({
+            baseAssetName,
+            scenario: 'signTransaction',
+            sign,
+            walletAccount,
+        });
     };
     signMessage = async ({ assetName, derivationPath, message }) => {
         const baseAssetName = this.#assetsModule.getAsset(assetName).baseAsset.name;
@@ -178,7 +222,11 @@ export class HardwareWallets {
                 return true;
             }
         }
-        catch { }
+        catch (error) {
+            if (error instanceof DeviceUninitializedError) {
+                throw error;
+            }
+        }
         try {
             const devices = await this.#ledgerDiscovery.list();
             return devices.length > 0;
@@ -199,8 +247,8 @@ export class HardwareWallets {
     };
     getAvailableDevices = async () => {
         const [ledgers, trezors] = await Promise.all([
-            this.#ledgerDiscovery.list().catch(() => []),
-            this.#trezorDiscovery.list().catch(() => []),
+            this.#listLedgerDevicesOrEmpty(),
+            this.#listTrezorDevicesOrEmpty(),
         ]);
         return [...ledgers, ...trezors].map((device) => ({
             model: device.model,
@@ -217,23 +265,6 @@ export class HardwareWallets {
         const { device } = await this.#getSelectedDevice();
         return device.listUseableAssetNames();
     };
-    ensureApplicationIsOpened = async ({ assetName }) => {
-        const asset = this.#assetsModule.getAsset(assetName);
-        let i = 0;
-        while (i < 3) {
-            try {
-                const { device } = await this.#getSelectedDevice();
-                await device.ensureApplicationIsOpened(asset.baseAsset.name);
-            }
-            catch (error) {
-                this.#logger.log(error);
-            }
-            finally {
-                await delay(1000);
-                i++;
-            }
-        }
-    };
     getAddress = async ({ assetName, accountIndex, addressIndex, multisigData, displayOnDevice, }) => {
         const asset = this.#assetsModule.getAsset(assetName);
         const { device } = await this.#getSelectedDevice();
@@ -350,6 +381,7 @@ export class HardwareWallets {
         const { device } = await this.#getSelectedDevice();
         const source = device.descriptor.manufacturer;
         const accountIndex = index ?? this.#walletAccounts.getNextIndex({ source });
+        const walletId = (await device.getWalletId?.()) ?? randomBytes(32).toString('hex');
         const useableAssetNames = new Set(await device.listUseableAssetNames());
         for (const assetName of useableAssetNames) {
             const asset = this.#assetsModule.getAsset(assetName);
@@ -374,6 +406,7 @@ export class HardwareWallets {
             model: device.descriptor.model,
             assetNames: useableAssetNames,
             keysToSync,
+            walletId,
         });
         return id;
     };
@@ -391,18 +424,14 @@ export class HardwareWallets {
         const { device } = await this.#getSelectedDevice();
         const source = device.descriptor.manufacturer;
         const label = source === WalletAccount.LEDGER_SRC ? 'Ledger' : 'Trezor';
-        const id = source === WalletAccount.TREZOR_SRC
-            ? device.descriptor.internalDescriptor
-            :
-                randomBytes(32).toString('hex');
-        const { accountIndex, model } = this.#syncedKeysMap.get(syncedKeysId);
+        const { accountIndex, model, walletId } = this.#syncedKeysMap.get(syncedKeysId);
         const walletAccount = new WalletAccount({
             label: `${label}${accountIndex === 0 ? '' : '_' + accountIndex}`,
             icon: source,
             source,
             model,
             index: accountIndex,
-            id,
+            id: walletId,
             isMultisig: !!isMultisig,
         });
         const walletAccountName = walletAccount.toString();
@@ -417,6 +446,11 @@ export class HardwareWallets {
     submitPairingCode = async ({ code }) => {
         return this.#trezorDiscovery.submitPairingCode(code);
     };
+    setPassphraseMode = async ({ enabled }) => {
+        const { device } = await this.#getSelectedDevice();
+        const trezorDevice = this.#requireTrezorDevice(device);
+        trezorDevice.setPassphraseMode(enabled ? 'hidden' : 'standard');
+    };
     requireDeviceFor = async ({ walletAccount }) => {
         return {
             signTransaction: this.signTransaction,

package/lib/module/interfaces.d.ts

@@ -6,7 +6,6 @@ export interface HardwareSignerProvider {
     scanForDevices: (deviceType: HardwareWalletManufacturer) => Promise<void>;
     canAccessAsset: ({ assetName }: CanAccessAssetParams) => Promise<boolean>;
     listUseableAssetNames: () => Promise<string[]>;
-    ensureApplicationIsOpened: ({ assetName }: EnsureApplicationIsOpenedParams) => Promise<void>;
     scan: ({ assetName, accountIndexes, addressOffset }: ScanParams) => Promise<ScanResult>;
     sync: ({ accountIndex }: SyncParams) => Promise<SyncedKeysId>;
     addPublicKeysToWalletAccount: ({ walletAccount, syncedKeysId, }: StoreSyncedKeysParams) => Promise<void>;
@@ -14,6 +13,7 @@ export interface HardwareSignerProvider {
     signTransaction: ({ baseAssetName, unsignedTx, walletAccount, }: SignTransactionParams) => Promise<any>;
     signMessage: ({ assetName, derivationPath, message }: SignMessageParams) => Promise<any>;
     submitPairingCode: ({ code }: ProcessPairingCodeParams) => Promise<any>;
+    setPassphraseMode: ({ enabled }: SetPassphraseModeParams) => Promise<void>;
 }
 type Asset = {
     name: string;
@@ -64,6 +64,7 @@ export interface SyncedKeysData {
     model: HardwareWalletDeviceModels;
     assetNames: Set<string>;
     keysToSync: KeyToSyncData[];
+    walletId: string;
 }
 export type KeyToSyncData = [KeyIdentifier, {
     xpub?: string;
@@ -84,6 +85,7 @@ export interface GenericSignParams {
     baseAssetName: string;
     scenario: 'signTransaction' | 'signMessage';
     sign: GenericSignCallback;
+    walletAccount?: WalletAccount;
 }
 export interface SigningRequestState {
     id: string;
@@ -94,6 +96,7 @@ export interface SigningRequestState {
 export interface SigningRequest {
     id: string;
     baseAssetName?: string;
+    walletAccount?: WalletAccount;
     sign: GenericSignCallback;
     resolve: (result: any) => void;
     reject: (error: Error) => void;
@@ -146,4 +149,7 @@ export interface RequireDeviceForParams {
 export interface ProcessPairingCodeParams {
     code: string;
 }
+export interface SetPassphraseModeParams {
+    enabled: boolean;
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/hardware-wallets",
-  "version": "3.4.1",
+  "version": "3.6.0",
   "description": "An Exodus SDK feature that provides a high level abstraction for interacting with hardware wallet devices",
   "author": "Exodus Movement, Inc.",
   "repository": {
@@ -32,7 +32,7 @@
     "@exodus/basic-utils": "^3.2.0",
     "@exodus/bip32": "^4.0.2",
     "@exodus/crypto": "^1.0.0-rc.14",
-    "@exodus/hw-common": "^3.2.0",
+    "@exodus/hw-common": "^3.4.0",
     "@exodus/models": "^12.18.0",
     "@exodus/redux-dependency-injection": "^4.0.0",
     "@exodus/wild-emitter": "^1.1.0",
@@ -53,5 +53,5 @@
     "access": "public",
     "provenance": false
   },
-  "gitHead": "7c1b8b88571d94cec15b9512e5301922ac1b6017"
+  "gitHead": "43e7fa9467acd5e681d99473eb54d9e790130e04"
 }