@onekeyfe/hwk-trezor-adapter 1.2.8-alpha.11 → 1.2.8-alpha.111

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/index.d.mts +71 -25
  2. package/dist/index.d.ts +71 -25
  3. package/dist/index.js +1204 -249
  4. package/dist/index.js.map +1 -1
  5. package/dist/index.mjs +1191 -236
  6. package/dist/index.mjs.map +1 -1
  7. package/package.json +4 -4
package/dist/index.d.mts CHANGED
@@ -1,4 +1,4 @@
1
- import { IHardwareWallet, IConnector, TransportType, DeviceInfo, Response, ChainCapability, AllNetworkGetAddressParams, AllNetworkAddressResponse, DeviceAuthenticityParams, DeviceAuthenticityResult, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxTrezorParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, EvmEthereumDefinitions, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
1
+ import { IHardwareWallet, IConnector, TransportType, SearchDevicesOptions, DeviceInfo, DeviceSearchTarget, BindBleDeviceParams, Response, AllNetworkGetAddressParams, AllNetworkAddressResponse, IDeviceManagerOperationContext, DeviceAuthenticityParams, DeviceAuthenticityResult, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxTrezorParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, EvmEthereumDefinitions, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
2
2
 
3
3
  type TrezorPassphraseCallParams = {
4
4
  passphraseState?: string;
@@ -6,10 +6,21 @@ type TrezorPassphraseCallParams = {
6
6
  };
7
7
  type TrezorCallParams<T> = (T & ICommonCallParams & TrezorPassphraseCallParams) | null | undefined;
8
8
  type TrezorCommonParams = (ICommonCallParams & TrezorPassphraseCallParams) | null | undefined;
9
+ interface TrezorKnownDeviceConnection {
10
+ deviceId: string;
11
+ usbConnectId?: string;
12
+ bleConnectId?: string;
13
+ }
14
+ interface TrezorAdapterOptions {
15
+ /** Persisted endpoints are routing hints, never proof of device identity. */
16
+ knownDeviceConnections?: readonly TrezorKnownDeviceConnection[];
17
+ }
9
18
  declare class TrezorAdapter implements IHardwareWallet {
10
19
  readonly vendor: "trezor";
20
+ readonly cancelCapability: "stops-waiting";
11
21
  private readonly _connector;
12
22
  private readonly _emitter;
23
+ private readonly _operations;
13
24
  private readonly _devices;
14
25
  private readonly _sessions;
15
26
  private readonly _connectingPromises;
@@ -17,8 +28,16 @@ declare class TrezorAdapter implements IHardwareWallet {
17
28
  private readonly _uiRegistry;
18
29
  private readonly _passphraseRequestContextByConnectId;
19
30
  private readonly _verifiedPassphraseSessionsByConnectId;
31
+ /** Raw connector calls that outlive an aborted caller, keyed by session. */
32
+ private readonly _unsettledConnectorOperations;
33
+ private readonly _connectorIdleWaiters;
34
+ private _resetPromise;
35
+ private _connectorTeardownTail;
36
+ private _pendingConnectorTeardowns;
37
+ private _stateGeneration;
20
38
  private readonly _jobQueue;
21
- constructor(connector: IConnector);
39
+ private readonly _knownDeviceConnections;
40
+ constructor(connector: IConnector, options?: TrezorAdapterOptions);
22
41
  private static _createDeviceBusyError;
23
42
  /**
24
43
  * Split a Trezor-only `passphraseState` routing hint off the chain params so
@@ -31,6 +50,7 @@ declare class TrezorAdapter implements IHardwareWallet {
31
50
  private static readonly _sensitiveLogKeys;
32
51
  private static _normalizeLogKey;
33
52
  private static _sanitizeForLog;
53
+ private static _responseForLog;
34
54
  private static _redactForLog;
35
55
  private static _errorForLog;
36
56
  private _setPassphraseRequestContext;
@@ -41,19 +61,17 @@ declare class TrezorAdapter implements IHardwareWallet {
41
61
  * selected is gone (the device evicted it from its limited slot pool). The
42
62
  * caller drops the stale cache entry and recreates from scratch.
43
63
  *
44
- * NOTE: the exact eviction code still needs real-device confirmation — match
45
- * conservatively so a genuine error isn't mistaken for an evicted session
46
- * (which would silently re-prompt the passphrase).
64
+ * Match only the protocol's explicit unallocated-channel code. Guessing from
65
+ * an error message could replay a request after an unrelated business error.
47
66
  */
48
67
  private static _isStaleSessionError;
49
68
  private static _errorCode;
50
69
  private static _isConnectionUnavailableError;
51
70
  private static _isRecoverableProtocolResidueError;
52
71
  /**
53
- * Race a promise against an abort signal. Copied from LedgerAdapter:
54
- * IConnector.call() can't actually be cancelled at the protocol level, but
55
- * the caller gets the abort immediately and the underlying work completes
56
- * uselessly in the background.
72
+ * Race a promise against an abort signal. IConnector.call() can't actually
73
+ * be cancelled at the protocol level, so the caller gets the abort while the
74
+ * adapter keeps the transport exclusively reserved until the raw call drains.
57
75
  */
58
76
  private static _abortable;
59
77
  private _connectSession;
@@ -66,17 +84,24 @@ declare class TrezorAdapter implements IHardwareWallet {
66
84
  * error flows. Aborts active jobs and releases UI waits.
67
85
  */
68
86
  resetState(): void;
87
+ private _resetStateAndDisconnectSessions;
69
88
  getAvailableTransports(): TransportType[];
70
89
  switchTransport(_type: TransportType): Promise<void>;
71
- searchDevices(options?: {
72
- waitForAllTransports?: boolean;
73
- }): Promise<DeviceInfo[]>;
74
- connectDevice(connectId: string): Promise<Response<string>>;
75
- disconnectDevice(connectId: string): Promise<void>;
76
- getDeviceInfo(connectId: string, deviceId: string): Promise<Response<DeviceInfo>>;
77
- getSupportedChains(): ChainCapability[];
90
+ searchDevices(options?: SearchDevicesOptions): Promise<DeviceInfo[]>;
91
+ private _searchDevices;
92
+ searchDeviceTargets(options?: SearchDevicesOptions): Promise<DeviceSearchTarget[]>;
93
+ bindBleDevice(params: BindBleDeviceParams): Promise<Response<string>>;
94
+ connectDevice(searchTargetId: string): Promise<Response<string>>;
95
+ releaseOperation(operationId: string): Promise<void>;
96
+ /**
97
+ * Ends a released operation's calls and prompts before teardown, which otherwise waits on a call
98
+ * that waits on a prompt nobody will answer. Device I/O already on the wire still drains.
99
+ */
100
+ private _cancelOperationWork;
101
+ private _releaseOperationConnection;
102
+ getDeviceInfo(connectIdOrOperationId: string, deviceId: string): Promise<Response<DeviceInfo>>;
78
103
  allNetworkGetAddress(connectId: string, deviceId: string, params: AllNetworkGetAddressParams): Promise<Response<AllNetworkAddressResponse[]>>;
79
- getFeatures(connectId: string): Promise<Response<Record<string, unknown>>>;
104
+ getFeatures(connectId: string, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
80
105
  /**
81
106
  * Device authenticity attestation. Sends a host-generated challenge, has the
82
107
  * device sign it with its secure-element key, then verifies the returned
@@ -92,12 +117,17 @@ declare class TrezorAdapter implements IHardwareWallet {
92
117
  * enable it in a production accounting flow, it lets an emulator mint any id.
93
118
  */
94
119
  verifyDeviceAuthenticity(connectId: string, params?: DeviceAuthenticityParams): Promise<Response<DeviceAuthenticityResult>>;
95
- deviceSettings(connectId: string, params: TrezorDeviceSettingsParams): Promise<Response<Record<string, unknown>>>;
96
- setBrightness(connectId: string, params?: TrezorBrightnessParams): Promise<Response<Record<string, unknown>>>;
97
- changePin(connectId: string, params?: TrezorChangePinParams): Promise<Response<Record<string, unknown>>>;
98
- wipeDevice(connectId: string): Promise<Response<Record<string, unknown>>>;
120
+ deviceSettings(connectId: string, params: TrezorDeviceSettingsParams, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
121
+ setBrightness(connectId: string, params?: TrezorBrightnessParams, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
122
+ changePin(connectId: string, params?: TrezorChangePinParams, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
123
+ wipeDevice(connectId: string, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
99
124
  private _getTrezorDeviceId;
100
125
  cancel(connectId?: string): void;
126
+ /**
127
+ * Operation owning the running job: its queue key when pinned, else the live
128
+ * operation of its connectId, so a mid-call UI request can name it.
129
+ */
130
+ private _activeOperationId;
101
131
  /**
102
132
  * Routes to BOTH the adapter's local UI registry (preemption decisions,
103
133
  * future SELECT_DEVICE / DEVICE_PERMISSION) AND the connector's registry
@@ -114,7 +144,7 @@ declare class TrezorAdapter implements IHardwareWallet {
114
144
  * Unlike Ledger (which hashes a per-chain address), it is chain-global, so
115
145
  * `chain` is accepted for API parity but ignored.
116
146
  */
117
- getChainFingerprint(connectId: string, _deviceId: string, _chain: ChainForFingerprint): Promise<Response<string>>;
147
+ getChainFingerprint(connectId: string, deviceId: string, _chain: ChainForFingerprint): Promise<Response<string>>;
118
148
  /**
119
149
  * Resolve the active passphrase wallet identity (`passphraseState`).
120
150
  * See {@link IHardwareWallet.getPassphraseState} for the discover/verify
@@ -123,7 +153,7 @@ declare class TrezorAdapter implements IHardwareWallet {
123
153
  * can't interleave with a chain call on the same device (which would desync
124
154
  * the THP session selection).
125
155
  */
126
- getPassphraseState(connectId: string, passphraseState?: string): Promise<Response<string | null>>;
156
+ getPassphraseState(connectId: string, passphraseState?: string, operationContext?: IDeviceManagerOperationContext): Promise<Response<string | null>>;
127
157
  evmGetAddress(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<EvmGetAddressParams>): Promise<Response<EvmAddress>>;
128
158
  evmSignTransaction(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<EvmSignTxTrezorParams>): Promise<Response<EvmSignedTx>>;
129
159
  evmSignMessage(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<EvmSignMsgParams>): Promise<Response<EvmSignature>>;
@@ -143,7 +173,16 @@ declare class TrezorAdapter implements IHardwareWallet {
143
173
  tronSignTransaction(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<TronSignTxParams>): Promise<Response<TronSignedTx>>;
144
174
  tronSignMessage(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<TronSignMsgParams>): Promise<Response<TronSignature>>;
145
175
  private static _unwrapConnectorResult;
146
- private static _callConnector;
176
+ private _callConnector;
177
+ private _assertConnectorIdle;
178
+ private _runConnectorTeardown;
179
+ private _disconnectSession;
180
+ private _availableTransports;
181
+ /** Transports the connector offers and the host's model table allows; discovery opens no other. */
182
+ private _allowedTransports;
183
+ private _releaseProvisionalConnection;
184
+ private _waitForConnectorOperationsToDrain;
185
+ private _retainConnectorOperation;
147
186
  private static _normalizeAllNetworkItem;
148
187
  private static _getItemDeviceId;
149
188
  private _callAllNetworkMethod;
@@ -156,6 +195,13 @@ declare class TrezorAdapter implements IHardwareWallet {
156
195
  private _callMethod;
157
196
  private _callWithRetry;
158
197
  private _ensureSession;
198
+ /** An identity probe tears down only a session it opened; another caller's stays up. */
199
+ private _hasSessionOrConnect;
200
+ private _resolveExpectedDeviceConnectId;
201
+ private _selectBleDeviceForBinding;
202
+ private _emitBindingStatus;
203
+ private _rememberVerifiedConnection;
204
+ private _emitVerifiedBinding;
159
205
  /**
160
206
  * Pin the device's active wallet session to `passphraseState` (the target
161
207
  * wallet identity) before a wallet-bound op. THP has an app-session id; v1
@@ -413,4 +459,4 @@ declare function isTrezorBleServiceUuid(uuid: string): boolean;
413
459
  declare function isTrezorBleDescriptor(descriptor: TrezorBleDescriptor): boolean;
414
460
  declare function resolveTrezorBleConnectId(descriptor: TrezorBleDescriptor): string;
415
461
 
416
- export { type AuthenticateDeviceResult, type AuthenticityProof, type BuildEthereumDefinitionsForPathParams, type BuildEthereumDefinitionsForSignTxParams, DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL, DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL, type FetchEthereumDefinitionsParams, type FetchLike, type FetchSolanaTokenDefinitionParams, type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, authenticateDeviceFromProof, buildEthereumDefinitionsForPath, buildEthereumDefinitionsForSignTx, fetchEthereumDefinitions, fetchSolanaTokenDefinition, getRequiredDeviceAuthenticityLayers, getSlip44FromPath, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };
462
+ export { type AuthenticateDeviceResult, type AuthenticityProof, type BuildEthereumDefinitionsForPathParams, type BuildEthereumDefinitionsForSignTxParams, DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL, DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL, type FetchEthereumDefinitionsParams, type FetchLike, type FetchSolanaTokenDefinitionParams, type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorAdapterOptions, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, type TrezorKnownDeviceConnection, authenticateDeviceFromProof, buildEthereumDefinitionsForPath, buildEthereumDefinitionsForSignTx, fetchEthereumDefinitions, fetchSolanaTokenDefinition, getRequiredDeviceAuthenticityLayers, getSlip44FromPath, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { IHardwareWallet, IConnector, TransportType, DeviceInfo, Response, ChainCapability, AllNetworkGetAddressParams, AllNetworkAddressResponse, DeviceAuthenticityParams, DeviceAuthenticityResult, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxTrezorParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, EvmEthereumDefinitions, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
1
+ import { IHardwareWallet, IConnector, TransportType, SearchDevicesOptions, DeviceInfo, DeviceSearchTarget, BindBleDeviceParams, Response, AllNetworkGetAddressParams, AllNetworkAddressResponse, IDeviceManagerOperationContext, DeviceAuthenticityParams, DeviceAuthenticityResult, TrezorDeviceSettingsParams, TrezorBrightnessParams, TrezorChangePinParams, UiResponseEvent, ChainForFingerprint, ICommonCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxTrezorParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, HardwareEventMap, DeviceEventListener, EvmEthereumDefinitions, ConnectorDevice } from '@onekeyfe/hwk-adapter-core';
2
2
 
3
3
  type TrezorPassphraseCallParams = {
4
4
  passphraseState?: string;
@@ -6,10 +6,21 @@ type TrezorPassphraseCallParams = {
6
6
  };
7
7
  type TrezorCallParams<T> = (T & ICommonCallParams & TrezorPassphraseCallParams) | null | undefined;
8
8
  type TrezorCommonParams = (ICommonCallParams & TrezorPassphraseCallParams) | null | undefined;
9
+ interface TrezorKnownDeviceConnection {
10
+ deviceId: string;
11
+ usbConnectId?: string;
12
+ bleConnectId?: string;
13
+ }
14
+ interface TrezorAdapterOptions {
15
+ /** Persisted endpoints are routing hints, never proof of device identity. */
16
+ knownDeviceConnections?: readonly TrezorKnownDeviceConnection[];
17
+ }
9
18
  declare class TrezorAdapter implements IHardwareWallet {
10
19
  readonly vendor: "trezor";
20
+ readonly cancelCapability: "stops-waiting";
11
21
  private readonly _connector;
12
22
  private readonly _emitter;
23
+ private readonly _operations;
13
24
  private readonly _devices;
14
25
  private readonly _sessions;
15
26
  private readonly _connectingPromises;
@@ -17,8 +28,16 @@ declare class TrezorAdapter implements IHardwareWallet {
17
28
  private readonly _uiRegistry;
18
29
  private readonly _passphraseRequestContextByConnectId;
19
30
  private readonly _verifiedPassphraseSessionsByConnectId;
31
+ /** Raw connector calls that outlive an aborted caller, keyed by session. */
32
+ private readonly _unsettledConnectorOperations;
33
+ private readonly _connectorIdleWaiters;
34
+ private _resetPromise;
35
+ private _connectorTeardownTail;
36
+ private _pendingConnectorTeardowns;
37
+ private _stateGeneration;
20
38
  private readonly _jobQueue;
21
- constructor(connector: IConnector);
39
+ private readonly _knownDeviceConnections;
40
+ constructor(connector: IConnector, options?: TrezorAdapterOptions);
22
41
  private static _createDeviceBusyError;
23
42
  /**
24
43
  * Split a Trezor-only `passphraseState` routing hint off the chain params so
@@ -31,6 +50,7 @@ declare class TrezorAdapter implements IHardwareWallet {
31
50
  private static readonly _sensitiveLogKeys;
32
51
  private static _normalizeLogKey;
33
52
  private static _sanitizeForLog;
53
+ private static _responseForLog;
34
54
  private static _redactForLog;
35
55
  private static _errorForLog;
36
56
  private _setPassphraseRequestContext;
@@ -41,19 +61,17 @@ declare class TrezorAdapter implements IHardwareWallet {
41
61
  * selected is gone (the device evicted it from its limited slot pool). The
42
62
  * caller drops the stale cache entry and recreates from scratch.
43
63
  *
44
- * NOTE: the exact eviction code still needs real-device confirmation — match
45
- * conservatively so a genuine error isn't mistaken for an evicted session
46
- * (which would silently re-prompt the passphrase).
64
+ * Match only the protocol's explicit unallocated-channel code. Guessing from
65
+ * an error message could replay a request after an unrelated business error.
47
66
  */
48
67
  private static _isStaleSessionError;
49
68
  private static _errorCode;
50
69
  private static _isConnectionUnavailableError;
51
70
  private static _isRecoverableProtocolResidueError;
52
71
  /**
53
- * Race a promise against an abort signal. Copied from LedgerAdapter:
54
- * IConnector.call() can't actually be cancelled at the protocol level, but
55
- * the caller gets the abort immediately and the underlying work completes
56
- * uselessly in the background.
72
+ * Race a promise against an abort signal. IConnector.call() can't actually
73
+ * be cancelled at the protocol level, so the caller gets the abort while the
74
+ * adapter keeps the transport exclusively reserved until the raw call drains.
57
75
  */
58
76
  private static _abortable;
59
77
  private _connectSession;
@@ -66,17 +84,24 @@ declare class TrezorAdapter implements IHardwareWallet {
66
84
  * error flows. Aborts active jobs and releases UI waits.
67
85
  */
68
86
  resetState(): void;
87
+ private _resetStateAndDisconnectSessions;
69
88
  getAvailableTransports(): TransportType[];
70
89
  switchTransport(_type: TransportType): Promise<void>;
71
- searchDevices(options?: {
72
- waitForAllTransports?: boolean;
73
- }): Promise<DeviceInfo[]>;
74
- connectDevice(connectId: string): Promise<Response<string>>;
75
- disconnectDevice(connectId: string): Promise<void>;
76
- getDeviceInfo(connectId: string, deviceId: string): Promise<Response<DeviceInfo>>;
77
- getSupportedChains(): ChainCapability[];
90
+ searchDevices(options?: SearchDevicesOptions): Promise<DeviceInfo[]>;
91
+ private _searchDevices;
92
+ searchDeviceTargets(options?: SearchDevicesOptions): Promise<DeviceSearchTarget[]>;
93
+ bindBleDevice(params: BindBleDeviceParams): Promise<Response<string>>;
94
+ connectDevice(searchTargetId: string): Promise<Response<string>>;
95
+ releaseOperation(operationId: string): Promise<void>;
96
+ /**
97
+ * Ends a released operation's calls and prompts before teardown, which otherwise waits on a call
98
+ * that waits on a prompt nobody will answer. Device I/O already on the wire still drains.
99
+ */
100
+ private _cancelOperationWork;
101
+ private _releaseOperationConnection;
102
+ getDeviceInfo(connectIdOrOperationId: string, deviceId: string): Promise<Response<DeviceInfo>>;
78
103
  allNetworkGetAddress(connectId: string, deviceId: string, params: AllNetworkGetAddressParams): Promise<Response<AllNetworkAddressResponse[]>>;
79
- getFeatures(connectId: string): Promise<Response<Record<string, unknown>>>;
104
+ getFeatures(connectId: string, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
80
105
  /**
81
106
  * Device authenticity attestation. Sends a host-generated challenge, has the
82
107
  * device sign it with its secure-element key, then verifies the returned
@@ -92,12 +117,17 @@ declare class TrezorAdapter implements IHardwareWallet {
92
117
  * enable it in a production accounting flow, it lets an emulator mint any id.
93
118
  */
94
119
  verifyDeviceAuthenticity(connectId: string, params?: DeviceAuthenticityParams): Promise<Response<DeviceAuthenticityResult>>;
95
- deviceSettings(connectId: string, params: TrezorDeviceSettingsParams): Promise<Response<Record<string, unknown>>>;
96
- setBrightness(connectId: string, params?: TrezorBrightnessParams): Promise<Response<Record<string, unknown>>>;
97
- changePin(connectId: string, params?: TrezorChangePinParams): Promise<Response<Record<string, unknown>>>;
98
- wipeDevice(connectId: string): Promise<Response<Record<string, unknown>>>;
120
+ deviceSettings(connectId: string, params: TrezorDeviceSettingsParams, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
121
+ setBrightness(connectId: string, params?: TrezorBrightnessParams, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
122
+ changePin(connectId: string, params?: TrezorChangePinParams, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
123
+ wipeDevice(connectId: string, operationContext?: IDeviceManagerOperationContext): Promise<Response<Record<string, unknown>>>;
99
124
  private _getTrezorDeviceId;
100
125
  cancel(connectId?: string): void;
126
+ /**
127
+ * Operation owning the running job: its queue key when pinned, else the live
128
+ * operation of its connectId, so a mid-call UI request can name it.
129
+ */
130
+ private _activeOperationId;
101
131
  /**
102
132
  * Routes to BOTH the adapter's local UI registry (preemption decisions,
103
133
  * future SELECT_DEVICE / DEVICE_PERMISSION) AND the connector's registry
@@ -114,7 +144,7 @@ declare class TrezorAdapter implements IHardwareWallet {
114
144
  * Unlike Ledger (which hashes a per-chain address), it is chain-global, so
115
145
  * `chain` is accepted for API parity but ignored.
116
146
  */
117
- getChainFingerprint(connectId: string, _deviceId: string, _chain: ChainForFingerprint): Promise<Response<string>>;
147
+ getChainFingerprint(connectId: string, deviceId: string, _chain: ChainForFingerprint): Promise<Response<string>>;
118
148
  /**
119
149
  * Resolve the active passphrase wallet identity (`passphraseState`).
120
150
  * See {@link IHardwareWallet.getPassphraseState} for the discover/verify
@@ -123,7 +153,7 @@ declare class TrezorAdapter implements IHardwareWallet {
123
153
  * can't interleave with a chain call on the same device (which would desync
124
154
  * the THP session selection).
125
155
  */
126
- getPassphraseState(connectId: string, passphraseState?: string): Promise<Response<string | null>>;
156
+ getPassphraseState(connectId: string, passphraseState?: string, operationContext?: IDeviceManagerOperationContext): Promise<Response<string | null>>;
127
157
  evmGetAddress(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<EvmGetAddressParams>): Promise<Response<EvmAddress>>;
128
158
  evmSignTransaction(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<EvmSignTxTrezorParams>): Promise<Response<EvmSignedTx>>;
129
159
  evmSignMessage(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<EvmSignMsgParams>): Promise<Response<EvmSignature>>;
@@ -143,7 +173,16 @@ declare class TrezorAdapter implements IHardwareWallet {
143
173
  tronSignTransaction(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<TronSignTxParams>): Promise<Response<TronSignedTx>>;
144
174
  tronSignMessage(connectId?: string | null, deviceId?: string | null, params?: TrezorCallParams<TronSignMsgParams>): Promise<Response<TronSignature>>;
145
175
  private static _unwrapConnectorResult;
146
- private static _callConnector;
176
+ private _callConnector;
177
+ private _assertConnectorIdle;
178
+ private _runConnectorTeardown;
179
+ private _disconnectSession;
180
+ private _availableTransports;
181
+ /** Transports the connector offers and the host's model table allows; discovery opens no other. */
182
+ private _allowedTransports;
183
+ private _releaseProvisionalConnection;
184
+ private _waitForConnectorOperationsToDrain;
185
+ private _retainConnectorOperation;
147
186
  private static _normalizeAllNetworkItem;
148
187
  private static _getItemDeviceId;
149
188
  private _callAllNetworkMethod;
@@ -156,6 +195,13 @@ declare class TrezorAdapter implements IHardwareWallet {
156
195
  private _callMethod;
157
196
  private _callWithRetry;
158
197
  private _ensureSession;
198
+ /** An identity probe tears down only a session it opened; another caller's stays up. */
199
+ private _hasSessionOrConnect;
200
+ private _resolveExpectedDeviceConnectId;
201
+ private _selectBleDeviceForBinding;
202
+ private _emitBindingStatus;
203
+ private _rememberVerifiedConnection;
204
+ private _emitVerifiedBinding;
159
205
  /**
160
206
  * Pin the device's active wallet session to `passphraseState` (the target
161
207
  * wallet identity) before a wallet-bound op. THP has an app-session id; v1
@@ -413,4 +459,4 @@ declare function isTrezorBleServiceUuid(uuid: string): boolean;
413
459
  declare function isTrezorBleDescriptor(descriptor: TrezorBleDescriptor): boolean;
414
460
  declare function resolveTrezorBleConnectId(descriptor: TrezorBleDescriptor): string;
415
461
 
416
- export { type AuthenticateDeviceResult, type AuthenticityProof, type BuildEthereumDefinitionsForPathParams, type BuildEthereumDefinitionsForSignTxParams, DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL, DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL, type FetchEthereumDefinitionsParams, type FetchLike, type FetchSolanaTokenDefinitionParams, type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, authenticateDeviceFromProof, buildEthereumDefinitionsForPath, buildEthereumDefinitionsForSignTx, fetchEthereumDefinitions, fetchSolanaTokenDefinition, getRequiredDeviceAuthenticityLayers, getSlip44FromPath, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };
462
+ export { type AuthenticateDeviceResult, type AuthenticityProof, type BuildEthereumDefinitionsForPathParams, type BuildEthereumDefinitionsForSignTxParams, DEFAULT_ETHEREUM_DEFINITIONS_BASE_URL, DEFAULT_SOLANA_TOKEN_DEFINITION_BASE_URL, type FetchEthereumDefinitionsParams, type FetchLike, type FetchSolanaTokenDefinitionParams, type SdkEvent, type SdkEventListener, type SdkLogEvent, TREZOR_BLE_PACKET_SIZE, TREZOR_BLE_SUPPORTED_MODELS, TREZOR_BLE_UUIDS, TREZOR_SAFE_7_MODEL, TrezorAdapter, type TrezorAdapterOptions, type TrezorBleDescriptor, type TrezorBleTransport, type TrezorBleTransportFactory, type TrezorConnectedDevice, type TrezorConnectorDevice, type TrezorKnownDeviceConnection, authenticateDeviceFromProof, buildEthereumDefinitionsForPath, buildEthereumDefinitionsForSignTx, fetchEthereumDefinitions, fetchSolanaTokenDefinition, getRequiredDeviceAuthenticityLayers, getSlip44FromPath, isTrezorBleDescriptor, isTrezorBleServiceUuid, isTrezorBleSupportedModel, isTrezorSafe7BleDescriptor, isTrezorSafe7BleName, normalizeTrezorBleUuid, offSdkEvent, onSdkEvent, resolveTrezorBleConnectId };