@exodus/hardware-wallets 3.5.0 → 3.6.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 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

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 { DeviceUninitializedError, 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;
@@ -168,7 +177,7 @@ export class HardwareWallets {
                     baseAssetName,
                     scenario,
                 });
-                await device.ensureApplicationIsOpened(baseAssetName);
+                await device.ensureDeviceReady({ baseAssetName, walletAccount });
                 return sign({ device });
             },
             resolve: deferred.resolve,
@@ -256,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();
@@ -389,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);
@@ -413,6 +406,7 @@ export class HardwareWallets {
             model: device.descriptor.model,
             assetNames: useableAssetNames,
             keysToSync,
+            walletId,
         });
         return id;
     };
@@ -430,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();
@@ -456,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;
@@ -148,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.5.0",
+  "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.3.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": "91c5651b997e904755c35158697523f816611d71"
+  "gitHead": "43e7fa9467acd5e681d99473eb54d9e790130e04"
 }