@onekeyfe/hwk-ledger-adapter 1.2.8-alpha.4 → 1.2.8-alpha.50
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.
- package/dist/index.d.mts +86 -52
- package/dist/index.d.ts +86 -52
- package/dist/index.js +1925 -963
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +1865 -878
- package/dist/index.mjs.map +1 -1
- package/package.json +14 -11
package/dist/index.d.mts
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import * as _onekeyfe_hwk_adapter_core from '@onekeyfe/hwk-adapter-core';
|
|
2
|
-
import { IHardwareWallet, IConnector, TransportType, UiResponseEvent, SearchDevicesOptions, DeviceInfo, Response,
|
|
2
|
+
import { IHardwareWallet, IConnector, TransportType, UiResponseEvent, SearchDevicesOptions, DeviceInfo, DeviceSearchTarget, Response, BindBleDeviceParams, IHardwareConnectionContext, NullableCallArg, IHardwareCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxLedgerParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, IHardwareCommonCallParams, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, ZcashGetFullViewingKeyParams, ZcashFullViewingKey, ZcashGetShieldedAddressParams, ZcashShieldedAddress, DeviceAuthenticityParams, DeviceAuthenticityResult, HardwareEventMap, DeviceEventListener, ChainForFingerprint, DeviceDescriptor, DeviceChangeEvent, ConnectionType, ConnectorDevice, ConnectorSession, ConnectorCallResult, ConnectorEventType, ConnectorEventMap, ConnectorConfig, Failure, HardwareErrorCode, HwkErrorOrigin, HwkRecoveryHint } from '@onekeyfe/hwk-adapter-core';
|
|
3
3
|
import { DeviceActionState as DeviceActionState$1, DiscoveredDevice, ExecuteDeviceActionReturnType, DeviceManagementKit } from '@ledgerhq/device-management-kit';
|
|
4
4
|
import { Address, Signature, SignerEth as SignerEth$1, TypedData } from '@ledgerhq/device-signer-kit-ethereum';
|
|
5
5
|
import { ContextModule } from '@ledgerhq/context-module';
|
|
6
6
|
import { SignerBtc as SignerBtc$1 } from '@ledgerhq/device-signer-kit-bitcoin';
|
|
7
7
|
import { SignerSolana } from '@ledgerhq/device-signer-kit-solana';
|
|
8
|
+
import { SignerZcash as SignerZcash$1, FullViewingKeyOptions, GetFullViewingKeyDAOutput, GetShieldedAddressDAOutput } from '@ledgerhq/device-signer-kit-zcash';
|
|
8
9
|
import Transport from '@ledgerhq/hw-transport';
|
|
9
10
|
|
|
10
11
|
/**
|
|
@@ -95,16 +96,34 @@ type LedgerCallParams<T> = NullableCallArg<IHardwareCallParams<T>>;
|
|
|
95
96
|
type LedgerCommonParams = NullableCallArg<IHardwareCommonCallParams>;
|
|
96
97
|
declare class LedgerAdapter implements IHardwareWallet {
|
|
97
98
|
readonly vendor: "ledger";
|
|
99
|
+
readonly cancelCapability: "stops-waiting";
|
|
98
100
|
private readonly connector;
|
|
99
101
|
private readonly emitter;
|
|
102
|
+
private readonly _operations;
|
|
100
103
|
private _discoveredDevices;
|
|
101
104
|
private _sessions;
|
|
105
|
+
private readonly _pendingOperationBindings;
|
|
106
|
+
private readonly _pendingPickBindings;
|
|
107
|
+
private readonly _sessionTransports;
|
|
108
|
+
private readonly _selectedBleReconnectTargets;
|
|
102
109
|
private readonly _uiRegistry;
|
|
103
110
|
private _btcHighIndexConfirmedThisSession;
|
|
104
111
|
private readonly _jobQueue;
|
|
105
112
|
private _deviceAuthenticityQueueTail;
|
|
106
113
|
private _doConnectAbortController;
|
|
114
|
+
private _connectingConnectId;
|
|
107
115
|
private readonly _defaultAutoInstallApp;
|
|
116
|
+
private readonly _unsettledConnectorOperations;
|
|
117
|
+
private readonly _connectorIdleWaiters;
|
|
118
|
+
private _resetPromise;
|
|
119
|
+
private _stateGeneration;
|
|
120
|
+
private _connectorTeardownTail;
|
|
121
|
+
private _pendingConnectorTeardowns;
|
|
122
|
+
private _activeConnectionType;
|
|
123
|
+
private _bindingSelectionRequestId;
|
|
124
|
+
private _discardPendingBinding;
|
|
125
|
+
private _finishBleBinding;
|
|
126
|
+
private _isBleConnection;
|
|
108
127
|
constructor(connector: IConnector, options?: {
|
|
109
128
|
autoInstallApp?: boolean;
|
|
110
129
|
});
|
|
@@ -118,23 +137,41 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
118
137
|
* The next operation will re-discover and re-connect automatically.
|
|
119
138
|
*/
|
|
120
139
|
resetState(): void;
|
|
140
|
+
private _resetStateAndDisconnectSessions;
|
|
121
141
|
dispose(): Promise<void>;
|
|
122
142
|
uiResponse(response: UiResponseEvent): void;
|
|
123
143
|
searchDevices(options?: SearchDevicesOptions): Promise<DeviceInfo[]>;
|
|
144
|
+
private _searchDevices;
|
|
145
|
+
searchDeviceTargets(options?: SearchDevicesOptions): Promise<DeviceSearchTarget[]>;
|
|
124
146
|
private _evictAllSessions;
|
|
125
147
|
private static readonly MAX_BUSINESS_RETRY_BUDGET;
|
|
126
148
|
private static readonly STUCK_APP_RETRY_DELAY_MS;
|
|
127
149
|
private static readonly MAX_DOCONNECT_CONFIRMS;
|
|
128
150
|
private _lastCancelReason;
|
|
151
|
+
private readonly _activeOperationJobs;
|
|
152
|
+
private readonly _pendingOperationDisconnects;
|
|
129
153
|
private static readonly APP_INSTALL_PROGRESS_MIN_DELTA;
|
|
130
154
|
private _installProgressLastEmittedValue;
|
|
131
155
|
private _installProgressLastKey;
|
|
132
156
|
private static _createDeviceBusyError;
|
|
133
|
-
connectDevice(
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
157
|
+
connectDevice(searchTargetId: string): Promise<Response<string>>;
|
|
158
|
+
/** Binds the picked BLE device; with a recorded wallet identity it must match first. */
|
|
159
|
+
bindBleDevice(params: BindBleDeviceParams): Promise<Response<string>>;
|
|
160
|
+
acquireOperation(connectId: string, context: IHardwareConnectionContext): Promise<Response<string>>;
|
|
161
|
+
private _createOperation;
|
|
162
|
+
private _connectTarget;
|
|
163
|
+
releaseOperation(operationId: string): Promise<void>;
|
|
164
|
+
/**
|
|
165
|
+
* Ends a released operation's calls and prompts before teardown, which otherwise waits on a call
|
|
166
|
+
* that waits on a prompt nobody will answer. Device I/O already on the wire still drains.
|
|
167
|
+
*/
|
|
168
|
+
private _cancelOperationWork;
|
|
169
|
+
private _releaseOperationConnection;
|
|
170
|
+
private _releaseLostOperationConnection;
|
|
171
|
+
getDeviceInfo(connectIdOrOperationId: string, deviceId: string): Promise<Response<DeviceInfo>>;
|
|
137
172
|
allNetworkGetAddress: (connectId: string, _deviceId: string, params: _onekeyfe_hwk_adapter_core.AllNetworkGetAddressParams) => Promise<Response<_onekeyfe_hwk_adapter_core.AllNetworkAddressResponse[]>>;
|
|
173
|
+
/** A bundle's BLE pick that no item got past the wallet check is not kept. */
|
|
174
|
+
private _dropUncheckedBundlePick;
|
|
138
175
|
private callChain;
|
|
139
176
|
private static normalizeCallArgs;
|
|
140
177
|
private static splitCommonParams;
|
|
@@ -157,6 +194,8 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
157
194
|
tronGetAddress(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<TronGetAddressParams>): Promise<Response<TronAddress>>;
|
|
158
195
|
tronSignTransaction(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<TronSignTxParams>): Promise<Response<TronSignedTx>>;
|
|
159
196
|
tronSignMessage(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<TronSignMsgParams>): Promise<Response<TronSignature>>;
|
|
197
|
+
zcashGetFullViewingKey(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<ZcashGetFullViewingKeyParams>): Promise<Response<ZcashFullViewingKey>>;
|
|
198
|
+
zcashGetShieldedAddress(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<ZcashGetShieldedAddressParams>): Promise<Response<ZcashShieldedAddress>>;
|
|
160
199
|
installApp(connectId: string, appName: string): Promise<Response<void>>;
|
|
161
200
|
listInstalledApps(connectId: string): Promise<Response<AppMetadata[]>>;
|
|
162
201
|
listInstalledNames(connectId: string): Promise<Response<string[]>>;
|
|
@@ -181,11 +220,12 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
181
220
|
off<K extends keyof HardwareEventMap>(event: K, listener: (event: HardwareEventMap[K]) => void): void;
|
|
182
221
|
off(event: string, listener: DeviceEventListener): void;
|
|
183
222
|
cancel(connectId?: string): void;
|
|
223
|
+
/** A non-empty deviceId is an expected chain fingerprint, not a transport identifier. */
|
|
184
224
|
getChainFingerprint(connectId: string, deviceId: string, chain: ChainForFingerprint): Promise<Response<string>>;
|
|
185
|
-
/**
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
225
|
+
/** Saves a picked BLE endpoint; `identity` is set when its wallet was just checked. */
|
|
226
|
+
private _saveSelectedBleBinding;
|
|
227
|
+
private _dropSession;
|
|
228
|
+
/** Verify on the acquired session without re-entering the job queue. */
|
|
189
229
|
private _verifyDeviceFingerprintWithSession;
|
|
190
230
|
/**
|
|
191
231
|
* Compute the chain fingerprint via a caller-supplied call strategy.
|
|
@@ -202,14 +242,12 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
202
242
|
* to avoid queue deadlocks when running inside `connectorCall`.
|
|
203
243
|
*/
|
|
204
244
|
private _computeChainFingerprint;
|
|
245
|
+
private _connectingPromise;
|
|
205
246
|
/**
|
|
206
|
-
*
|
|
207
|
-
*
|
|
208
|
-
* - If a session already exists for the given connectId, reuse it.
|
|
209
|
-
* - If ANY session exists (Ledger IDs are ephemeral), reuse it.
|
|
210
|
-
* - Otherwise: search → exactly 1 USB device auto-connects; multiple or none throws.
|
|
247
|
+
* Operation owning the running job, so a mid-call UI request can name it.
|
|
248
|
+
* Undefined at cold start when no operation owns the job.
|
|
211
249
|
*/
|
|
212
|
-
private
|
|
250
|
+
private _activeOperationId;
|
|
213
251
|
private _waitForDeviceConnect;
|
|
214
252
|
/**
|
|
215
253
|
* Decide whether a BTC pubkey call needs `showOnDevice=true` because of
|
|
@@ -220,19 +258,13 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
220
258
|
*/
|
|
221
259
|
private _gateBtcHighIndex;
|
|
222
260
|
private _waitForBtcHighIndexConfirm;
|
|
261
|
+
/** A cancel of the job ends its open prompt, even when no operation names that prompt. */
|
|
262
|
+
private _awaitUiAnswer;
|
|
223
263
|
private _waitForInstallAppConfirm;
|
|
224
264
|
private ensureConnected;
|
|
225
265
|
private _doConnect;
|
|
226
266
|
private _connectFirstOrSelect;
|
|
227
267
|
private _connectDeviceOrThrow;
|
|
228
|
-
/**
|
|
229
|
-
* Call the connector with automatic session resolution and disconnect retry.
|
|
230
|
-
*
|
|
231
|
-
* 1. Resolves a valid connectId via ensureConnected()
|
|
232
|
-
* 2. Looks up sessionId from _sessions
|
|
233
|
-
* 3. Calls connector.call()
|
|
234
|
-
* 4. On disconnect error: clears stale session, re-connects, retries once
|
|
235
|
-
*/
|
|
236
268
|
/**
|
|
237
269
|
* Unwrap a `ConnectorCallResult` back into the throw-based control flow this
|
|
238
270
|
* class relies on. On failure, rehydrate a FLAT Error (lifting `params.*`
|
|
@@ -250,7 +282,13 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
250
282
|
* lives in one place.
|
|
251
283
|
*/
|
|
252
284
|
private _callConnector;
|
|
285
|
+
private _assertConnectorReady;
|
|
286
|
+
private _runConnectorTeardown;
|
|
287
|
+
private _waitForConnectorOperationsToDrain;
|
|
288
|
+
private _retainConnectorOperation;
|
|
253
289
|
private connectorCall;
|
|
290
|
+
/** Hermes/RN polyfills don't always populate signal.reason; fall back. */
|
|
291
|
+
private _abortReason;
|
|
254
292
|
/**
|
|
255
293
|
* Race a promise against an abort signal. On abort, rejects with
|
|
256
294
|
* signal.reason → instance _lastCancelReason → generic Error('Aborted').
|
|
@@ -260,35 +298,10 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
260
298
|
private static _throwIfAborted;
|
|
261
299
|
/** Actual work done under the job queue — connection, fingerprint, call, and recovery. */
|
|
262
300
|
private _runConnectorCall;
|
|
263
|
-
/**
|
|
264
|
-
* Stuck-app recovery: pause for the device's UI transition, then retry once.
|
|
265
|
-
*
|
|
266
|
-
* Caller has already cleared the session + reset connector. We wait so Stax
|
|
267
|
-
* finishes its post-CloseApp animation, then go through ensureConnected +
|
|
268
|
-
* fingerprint check + call exactly once. Caller decides what to do on a
|
|
269
|
-
* second stuck-app hit.
|
|
270
|
-
*/
|
|
271
|
-
private _retryAfterStuckApp;
|
|
272
301
|
private _sleepAbortable;
|
|
273
302
|
/**
|
|
274
|
-
*
|
|
275
|
-
*
|
|
276
|
-
* Timeout recovery starts with a full connector reset. After an APDU
|
|
277
|
-
* timeout, DMK/transport state may still emit malformed responses; retrying
|
|
278
|
-
* on the same DMK can poison the next chain switch.
|
|
279
|
-
*/
|
|
280
|
-
private _retryWithFreshConnection;
|
|
281
|
-
/**
|
|
282
|
-
* Ensure OS-level device permission (Bluetooth / USB) before proceeding.
|
|
283
|
-
*
|
|
284
|
-
* Emits `REQUEST_DEVICE_PERMISSION` and awaits the consumer's
|
|
285
|
-
* `RECEIVE_DEVICE_PERMISSION` reply (60s budget covers "probe → system
|
|
286
|
-
* prompt → user tap" plus a generous margin). If the consumer never wires
|
|
287
|
-
* a handler or never replies, the wait times out and the operation fails
|
|
288
|
-
* fast so scanners/callers don't hang silently.
|
|
289
|
-
*
|
|
290
|
-
* - No connectId (searchDevices): environment-level permission
|
|
291
|
-
* - With connectId (business methods): device-level permission
|
|
303
|
+
* Ensure OS-level Bluetooth/USB permission; times out after 60s if the host never
|
|
304
|
+
* replies. Without connectId the request is environment-level, else device-level.
|
|
292
305
|
*/
|
|
293
306
|
private _ensureDevicePermission;
|
|
294
307
|
/**
|
|
@@ -498,6 +511,7 @@ declare class LedgerConnectorBase implements IConnector {
|
|
|
498
511
|
private _getSignerManager;
|
|
499
512
|
private _getDeviceAppsManager;
|
|
500
513
|
private _invalidateSession;
|
|
514
|
+
private _teardownSecureChannelSession;
|
|
501
515
|
/**
|
|
502
516
|
* Replace an old session with a new one after app switch.
|
|
503
517
|
* Emits device-connect so the adapter updates its _sessions Map.
|
|
@@ -654,6 +668,25 @@ declare class SignerSol {
|
|
|
654
668
|
}>;
|
|
655
669
|
}
|
|
656
670
|
|
|
671
|
+
/**
|
|
672
|
+
* Wraps Ledger's Zcash SDK signer (Observable-based DeviceActions) into a
|
|
673
|
+
* simple async interface. Only the viewing-key and shielded-address reads are
|
|
674
|
+
* exposed; PCZT signing goes through a different host-side pipeline.
|
|
675
|
+
*/
|
|
676
|
+
declare class SignerZcash {
|
|
677
|
+
private readonly _sdk;
|
|
678
|
+
onInteraction?: (interaction: string) => void;
|
|
679
|
+
onRegisterCanceller?: (cancel: (reason?: CancelReason) => void) => void;
|
|
680
|
+
constructor(_sdk: SignerZcash$1);
|
|
681
|
+
/** GET_VK: UFVK string (default) or raw 96-byte Orchard FVK. */
|
|
682
|
+
getFullViewingKey(derivationPath: string, options?: FullViewingKeyOptions): Promise<GetFullViewingKeyDAOutput>;
|
|
683
|
+
/** GET_SHIELDED_ADDRESS: single-Orchard-receiver UA for a 5-level transparent path. */
|
|
684
|
+
getShieldedAddress(derivationPath: string, options?: {
|
|
685
|
+
checkOnDevice?: boolean;
|
|
686
|
+
skipOpenApp?: boolean;
|
|
687
|
+
}): Promise<GetShieldedAddressDAOutput>;
|
|
688
|
+
}
|
|
689
|
+
|
|
657
690
|
/**
|
|
658
691
|
* Transport adapter that bridges Ledger's legacy hw-app-* SDKs to DMK's sendApdu.
|
|
659
692
|
*
|
|
@@ -737,7 +770,7 @@ interface WrapErrorOptions {
|
|
|
737
770
|
/** Fallback when err has no `appName` (DMK signer errors don't carry it). */
|
|
738
771
|
defaultAppName?: string;
|
|
739
772
|
}
|
|
740
|
-
declare function ledgerFailure(code: HardwareErrorCode, error: string, appName?: string, tag?: string, params?: Record<string, unknown
|
|
773
|
+
declare function ledgerFailure(code: HardwareErrorCode, error: string, appName?: string, tag?: string, params?: Record<string, unknown>, origin?: HwkErrorOrigin, recovery?: HwkRecoveryHint): LedgerFailure;
|
|
741
774
|
declare function isDeviceLockedError(err: unknown): boolean;
|
|
742
775
|
/**
|
|
743
776
|
* Map a Ledger DMK error to a HardwareErrorCode and human-readable message.
|
|
@@ -747,6 +780,7 @@ declare function isDeviceLockedError(err: unknown): boolean;
|
|
|
747
780
|
declare function mapLedgerError(err: unknown, opts?: WrapErrorOptions): {
|
|
748
781
|
code: HardwareErrorCode;
|
|
749
782
|
message: string;
|
|
783
|
+
origin?: HwkErrorOrigin;
|
|
750
784
|
appName?: string;
|
|
751
785
|
};
|
|
752
786
|
|
|
@@ -782,4 +816,4 @@ declare function isLedgerDmkBleTransport(transport?: string): boolean;
|
|
|
782
816
|
declare function isLedgerBleConnectionType(connectionType?: ConnectionType): boolean;
|
|
783
817
|
declare function isLedgerBleDescriptor(connectionType: ConnectionType, descriptor: DeviceDescriptor): boolean;
|
|
784
818
|
|
|
785
|
-
export { AppManager, type DeviceActionState, type DmkDiscoveredDevice, DmkTransport, LedgerAdapter, LedgerConnectorBase, type LedgerConnectorBaseOptions, LedgerDeviceManager, type LedgerFailure, type SdkEvent, type SdkEventListener, type SdkLogEvent, SignerBtc, type SignerBtcAddress, SignerEth, type SignerEvmAddress, type SignerEvmSignature, SignerManager, SignerSol, type TransportFactory, debugLog, deviceActionToPromise, isDeviceLockedError, isLedgerBleConnectionType, isLedgerBleDescriptor, isLedgerDmkBleTransport, ledgerFailure, mapLedgerError, offSdkEvent, onSdkEvent };
|
|
819
|
+
export { AppManager, type DeviceActionState, type DmkDiscoveredDevice, DmkTransport, LedgerAdapter, LedgerConnectorBase, type LedgerConnectorBaseOptions, LedgerDeviceManager, type LedgerFailure, type SdkEvent, type SdkEventListener, type SdkLogEvent, SignerBtc, type SignerBtcAddress, SignerEth, type SignerEvmAddress, type SignerEvmSignature, SignerManager, SignerSol, SignerZcash, type TransportFactory, debugLog, deviceActionToPromise, isDeviceLockedError, isLedgerBleConnectionType, isLedgerBleDescriptor, isLedgerDmkBleTransport, ledgerFailure, mapLedgerError, offSdkEvent, onSdkEvent };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import * as _onekeyfe_hwk_adapter_core from '@onekeyfe/hwk-adapter-core';
|
|
2
|
-
import { IHardwareWallet, IConnector, TransportType, UiResponseEvent, SearchDevicesOptions, DeviceInfo, Response,
|
|
2
|
+
import { IHardwareWallet, IConnector, TransportType, UiResponseEvent, SearchDevicesOptions, DeviceInfo, DeviceSearchTarget, Response, BindBleDeviceParams, IHardwareConnectionContext, NullableCallArg, IHardwareCallParams, EvmGetAddressParams, EvmAddress, EvmSignTxLedgerParams, EvmSignedTx, EvmSignMsgParams, EvmSignature, EvmSignTypedDataParams, BtcGetAddressParams, BtcAddress, BtcGetPublicKeyParams, BtcPublicKey, BtcSignTxParams, BtcSignedTx, BtcSignPsbtParams, BtcSignedPsbt, BtcSignMsgParams, BtcSignature, IHardwareCommonCallParams, SolGetAddressParams, SolAddress, SolSignTxParams, SolSignedTx, SolSignMsgParams, SolSignature, TronGetAddressParams, TronAddress, TronSignTxParams, TronSignedTx, TronSignMsgParams, TronSignature, ZcashGetFullViewingKeyParams, ZcashFullViewingKey, ZcashGetShieldedAddressParams, ZcashShieldedAddress, DeviceAuthenticityParams, DeviceAuthenticityResult, HardwareEventMap, DeviceEventListener, ChainForFingerprint, DeviceDescriptor, DeviceChangeEvent, ConnectionType, ConnectorDevice, ConnectorSession, ConnectorCallResult, ConnectorEventType, ConnectorEventMap, ConnectorConfig, Failure, HardwareErrorCode, HwkErrorOrigin, HwkRecoveryHint } from '@onekeyfe/hwk-adapter-core';
|
|
3
3
|
import { DeviceActionState as DeviceActionState$1, DiscoveredDevice, ExecuteDeviceActionReturnType, DeviceManagementKit } from '@ledgerhq/device-management-kit';
|
|
4
4
|
import { Address, Signature, SignerEth as SignerEth$1, TypedData } from '@ledgerhq/device-signer-kit-ethereum';
|
|
5
5
|
import { ContextModule } from '@ledgerhq/context-module';
|
|
6
6
|
import { SignerBtc as SignerBtc$1 } from '@ledgerhq/device-signer-kit-bitcoin';
|
|
7
7
|
import { SignerSolana } from '@ledgerhq/device-signer-kit-solana';
|
|
8
|
+
import { SignerZcash as SignerZcash$1, FullViewingKeyOptions, GetFullViewingKeyDAOutput, GetShieldedAddressDAOutput } from '@ledgerhq/device-signer-kit-zcash';
|
|
8
9
|
import Transport from '@ledgerhq/hw-transport';
|
|
9
10
|
|
|
10
11
|
/**
|
|
@@ -95,16 +96,34 @@ type LedgerCallParams<T> = NullableCallArg<IHardwareCallParams<T>>;
|
|
|
95
96
|
type LedgerCommonParams = NullableCallArg<IHardwareCommonCallParams>;
|
|
96
97
|
declare class LedgerAdapter implements IHardwareWallet {
|
|
97
98
|
readonly vendor: "ledger";
|
|
99
|
+
readonly cancelCapability: "stops-waiting";
|
|
98
100
|
private readonly connector;
|
|
99
101
|
private readonly emitter;
|
|
102
|
+
private readonly _operations;
|
|
100
103
|
private _discoveredDevices;
|
|
101
104
|
private _sessions;
|
|
105
|
+
private readonly _pendingOperationBindings;
|
|
106
|
+
private readonly _pendingPickBindings;
|
|
107
|
+
private readonly _sessionTransports;
|
|
108
|
+
private readonly _selectedBleReconnectTargets;
|
|
102
109
|
private readonly _uiRegistry;
|
|
103
110
|
private _btcHighIndexConfirmedThisSession;
|
|
104
111
|
private readonly _jobQueue;
|
|
105
112
|
private _deviceAuthenticityQueueTail;
|
|
106
113
|
private _doConnectAbortController;
|
|
114
|
+
private _connectingConnectId;
|
|
107
115
|
private readonly _defaultAutoInstallApp;
|
|
116
|
+
private readonly _unsettledConnectorOperations;
|
|
117
|
+
private readonly _connectorIdleWaiters;
|
|
118
|
+
private _resetPromise;
|
|
119
|
+
private _stateGeneration;
|
|
120
|
+
private _connectorTeardownTail;
|
|
121
|
+
private _pendingConnectorTeardowns;
|
|
122
|
+
private _activeConnectionType;
|
|
123
|
+
private _bindingSelectionRequestId;
|
|
124
|
+
private _discardPendingBinding;
|
|
125
|
+
private _finishBleBinding;
|
|
126
|
+
private _isBleConnection;
|
|
108
127
|
constructor(connector: IConnector, options?: {
|
|
109
128
|
autoInstallApp?: boolean;
|
|
110
129
|
});
|
|
@@ -118,23 +137,41 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
118
137
|
* The next operation will re-discover and re-connect automatically.
|
|
119
138
|
*/
|
|
120
139
|
resetState(): void;
|
|
140
|
+
private _resetStateAndDisconnectSessions;
|
|
121
141
|
dispose(): Promise<void>;
|
|
122
142
|
uiResponse(response: UiResponseEvent): void;
|
|
123
143
|
searchDevices(options?: SearchDevicesOptions): Promise<DeviceInfo[]>;
|
|
144
|
+
private _searchDevices;
|
|
145
|
+
searchDeviceTargets(options?: SearchDevicesOptions): Promise<DeviceSearchTarget[]>;
|
|
124
146
|
private _evictAllSessions;
|
|
125
147
|
private static readonly MAX_BUSINESS_RETRY_BUDGET;
|
|
126
148
|
private static readonly STUCK_APP_RETRY_DELAY_MS;
|
|
127
149
|
private static readonly MAX_DOCONNECT_CONFIRMS;
|
|
128
150
|
private _lastCancelReason;
|
|
151
|
+
private readonly _activeOperationJobs;
|
|
152
|
+
private readonly _pendingOperationDisconnects;
|
|
129
153
|
private static readonly APP_INSTALL_PROGRESS_MIN_DELTA;
|
|
130
154
|
private _installProgressLastEmittedValue;
|
|
131
155
|
private _installProgressLastKey;
|
|
132
156
|
private static _createDeviceBusyError;
|
|
133
|
-
connectDevice(
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
157
|
+
connectDevice(searchTargetId: string): Promise<Response<string>>;
|
|
158
|
+
/** Binds the picked BLE device; with a recorded wallet identity it must match first. */
|
|
159
|
+
bindBleDevice(params: BindBleDeviceParams): Promise<Response<string>>;
|
|
160
|
+
acquireOperation(connectId: string, context: IHardwareConnectionContext): Promise<Response<string>>;
|
|
161
|
+
private _createOperation;
|
|
162
|
+
private _connectTarget;
|
|
163
|
+
releaseOperation(operationId: string): Promise<void>;
|
|
164
|
+
/**
|
|
165
|
+
* Ends a released operation's calls and prompts before teardown, which otherwise waits on a call
|
|
166
|
+
* that waits on a prompt nobody will answer. Device I/O already on the wire still drains.
|
|
167
|
+
*/
|
|
168
|
+
private _cancelOperationWork;
|
|
169
|
+
private _releaseOperationConnection;
|
|
170
|
+
private _releaseLostOperationConnection;
|
|
171
|
+
getDeviceInfo(connectIdOrOperationId: string, deviceId: string): Promise<Response<DeviceInfo>>;
|
|
137
172
|
allNetworkGetAddress: (connectId: string, _deviceId: string, params: _onekeyfe_hwk_adapter_core.AllNetworkGetAddressParams) => Promise<Response<_onekeyfe_hwk_adapter_core.AllNetworkAddressResponse[]>>;
|
|
173
|
+
/** A bundle's BLE pick that no item got past the wallet check is not kept. */
|
|
174
|
+
private _dropUncheckedBundlePick;
|
|
138
175
|
private callChain;
|
|
139
176
|
private static normalizeCallArgs;
|
|
140
177
|
private static splitCommonParams;
|
|
@@ -157,6 +194,8 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
157
194
|
tronGetAddress(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<TronGetAddressParams>): Promise<Response<TronAddress>>;
|
|
158
195
|
tronSignTransaction(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<TronSignTxParams>): Promise<Response<TronSignedTx>>;
|
|
159
196
|
tronSignMessage(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<TronSignMsgParams>): Promise<Response<TronSignature>>;
|
|
197
|
+
zcashGetFullViewingKey(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<ZcashGetFullViewingKeyParams>): Promise<Response<ZcashFullViewingKey>>;
|
|
198
|
+
zcashGetShieldedAddress(connectId?: string | null, deviceId?: string | null, params?: LedgerCallParams<ZcashGetShieldedAddressParams>): Promise<Response<ZcashShieldedAddress>>;
|
|
160
199
|
installApp(connectId: string, appName: string): Promise<Response<void>>;
|
|
161
200
|
listInstalledApps(connectId: string): Promise<Response<AppMetadata[]>>;
|
|
162
201
|
listInstalledNames(connectId: string): Promise<Response<string[]>>;
|
|
@@ -181,11 +220,12 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
181
220
|
off<K extends keyof HardwareEventMap>(event: K, listener: (event: HardwareEventMap[K]) => void): void;
|
|
182
221
|
off(event: string, listener: DeviceEventListener): void;
|
|
183
222
|
cancel(connectId?: string): void;
|
|
223
|
+
/** A non-empty deviceId is an expected chain fingerprint, not a transport identifier. */
|
|
184
224
|
getChainFingerprint(connectId: string, deviceId: string, chain: ChainForFingerprint): Promise<Response<string>>;
|
|
185
|
-
/**
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
225
|
+
/** Saves a picked BLE endpoint; `identity` is set when its wallet was just checked. */
|
|
226
|
+
private _saveSelectedBleBinding;
|
|
227
|
+
private _dropSession;
|
|
228
|
+
/** Verify on the acquired session without re-entering the job queue. */
|
|
189
229
|
private _verifyDeviceFingerprintWithSession;
|
|
190
230
|
/**
|
|
191
231
|
* Compute the chain fingerprint via a caller-supplied call strategy.
|
|
@@ -202,14 +242,12 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
202
242
|
* to avoid queue deadlocks when running inside `connectorCall`.
|
|
203
243
|
*/
|
|
204
244
|
private _computeChainFingerprint;
|
|
245
|
+
private _connectingPromise;
|
|
205
246
|
/**
|
|
206
|
-
*
|
|
207
|
-
*
|
|
208
|
-
* - If a session already exists for the given connectId, reuse it.
|
|
209
|
-
* - If ANY session exists (Ledger IDs are ephemeral), reuse it.
|
|
210
|
-
* - Otherwise: search → exactly 1 USB device auto-connects; multiple or none throws.
|
|
247
|
+
* Operation owning the running job, so a mid-call UI request can name it.
|
|
248
|
+
* Undefined at cold start when no operation owns the job.
|
|
211
249
|
*/
|
|
212
|
-
private
|
|
250
|
+
private _activeOperationId;
|
|
213
251
|
private _waitForDeviceConnect;
|
|
214
252
|
/**
|
|
215
253
|
* Decide whether a BTC pubkey call needs `showOnDevice=true` because of
|
|
@@ -220,19 +258,13 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
220
258
|
*/
|
|
221
259
|
private _gateBtcHighIndex;
|
|
222
260
|
private _waitForBtcHighIndexConfirm;
|
|
261
|
+
/** A cancel of the job ends its open prompt, even when no operation names that prompt. */
|
|
262
|
+
private _awaitUiAnswer;
|
|
223
263
|
private _waitForInstallAppConfirm;
|
|
224
264
|
private ensureConnected;
|
|
225
265
|
private _doConnect;
|
|
226
266
|
private _connectFirstOrSelect;
|
|
227
267
|
private _connectDeviceOrThrow;
|
|
228
|
-
/**
|
|
229
|
-
* Call the connector with automatic session resolution and disconnect retry.
|
|
230
|
-
*
|
|
231
|
-
* 1. Resolves a valid connectId via ensureConnected()
|
|
232
|
-
* 2. Looks up sessionId from _sessions
|
|
233
|
-
* 3. Calls connector.call()
|
|
234
|
-
* 4. On disconnect error: clears stale session, re-connects, retries once
|
|
235
|
-
*/
|
|
236
268
|
/**
|
|
237
269
|
* Unwrap a `ConnectorCallResult` back into the throw-based control flow this
|
|
238
270
|
* class relies on. On failure, rehydrate a FLAT Error (lifting `params.*`
|
|
@@ -250,7 +282,13 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
250
282
|
* lives in one place.
|
|
251
283
|
*/
|
|
252
284
|
private _callConnector;
|
|
285
|
+
private _assertConnectorReady;
|
|
286
|
+
private _runConnectorTeardown;
|
|
287
|
+
private _waitForConnectorOperationsToDrain;
|
|
288
|
+
private _retainConnectorOperation;
|
|
253
289
|
private connectorCall;
|
|
290
|
+
/** Hermes/RN polyfills don't always populate signal.reason; fall back. */
|
|
291
|
+
private _abortReason;
|
|
254
292
|
/**
|
|
255
293
|
* Race a promise against an abort signal. On abort, rejects with
|
|
256
294
|
* signal.reason → instance _lastCancelReason → generic Error('Aborted').
|
|
@@ -260,35 +298,10 @@ declare class LedgerAdapter implements IHardwareWallet {
|
|
|
260
298
|
private static _throwIfAborted;
|
|
261
299
|
/** Actual work done under the job queue — connection, fingerprint, call, and recovery. */
|
|
262
300
|
private _runConnectorCall;
|
|
263
|
-
/**
|
|
264
|
-
* Stuck-app recovery: pause for the device's UI transition, then retry once.
|
|
265
|
-
*
|
|
266
|
-
* Caller has already cleared the session + reset connector. We wait so Stax
|
|
267
|
-
* finishes its post-CloseApp animation, then go through ensureConnected +
|
|
268
|
-
* fingerprint check + call exactly once. Caller decides what to do on a
|
|
269
|
-
* second stuck-app hit.
|
|
270
|
-
*/
|
|
271
|
-
private _retryAfterStuckApp;
|
|
272
301
|
private _sleepAbortable;
|
|
273
302
|
/**
|
|
274
|
-
*
|
|
275
|
-
*
|
|
276
|
-
* Timeout recovery starts with a full connector reset. After an APDU
|
|
277
|
-
* timeout, DMK/transport state may still emit malformed responses; retrying
|
|
278
|
-
* on the same DMK can poison the next chain switch.
|
|
279
|
-
*/
|
|
280
|
-
private _retryWithFreshConnection;
|
|
281
|
-
/**
|
|
282
|
-
* Ensure OS-level device permission (Bluetooth / USB) before proceeding.
|
|
283
|
-
*
|
|
284
|
-
* Emits `REQUEST_DEVICE_PERMISSION` and awaits the consumer's
|
|
285
|
-
* `RECEIVE_DEVICE_PERMISSION` reply (60s budget covers "probe → system
|
|
286
|
-
* prompt → user tap" plus a generous margin). If the consumer never wires
|
|
287
|
-
* a handler or never replies, the wait times out and the operation fails
|
|
288
|
-
* fast so scanners/callers don't hang silently.
|
|
289
|
-
*
|
|
290
|
-
* - No connectId (searchDevices): environment-level permission
|
|
291
|
-
* - With connectId (business methods): device-level permission
|
|
303
|
+
* Ensure OS-level Bluetooth/USB permission; times out after 60s if the host never
|
|
304
|
+
* replies. Without connectId the request is environment-level, else device-level.
|
|
292
305
|
*/
|
|
293
306
|
private _ensureDevicePermission;
|
|
294
307
|
/**
|
|
@@ -498,6 +511,7 @@ declare class LedgerConnectorBase implements IConnector {
|
|
|
498
511
|
private _getSignerManager;
|
|
499
512
|
private _getDeviceAppsManager;
|
|
500
513
|
private _invalidateSession;
|
|
514
|
+
private _teardownSecureChannelSession;
|
|
501
515
|
/**
|
|
502
516
|
* Replace an old session with a new one after app switch.
|
|
503
517
|
* Emits device-connect so the adapter updates its _sessions Map.
|
|
@@ -654,6 +668,25 @@ declare class SignerSol {
|
|
|
654
668
|
}>;
|
|
655
669
|
}
|
|
656
670
|
|
|
671
|
+
/**
|
|
672
|
+
* Wraps Ledger's Zcash SDK signer (Observable-based DeviceActions) into a
|
|
673
|
+
* simple async interface. Only the viewing-key and shielded-address reads are
|
|
674
|
+
* exposed; PCZT signing goes through a different host-side pipeline.
|
|
675
|
+
*/
|
|
676
|
+
declare class SignerZcash {
|
|
677
|
+
private readonly _sdk;
|
|
678
|
+
onInteraction?: (interaction: string) => void;
|
|
679
|
+
onRegisterCanceller?: (cancel: (reason?: CancelReason) => void) => void;
|
|
680
|
+
constructor(_sdk: SignerZcash$1);
|
|
681
|
+
/** GET_VK: UFVK string (default) or raw 96-byte Orchard FVK. */
|
|
682
|
+
getFullViewingKey(derivationPath: string, options?: FullViewingKeyOptions): Promise<GetFullViewingKeyDAOutput>;
|
|
683
|
+
/** GET_SHIELDED_ADDRESS: single-Orchard-receiver UA for a 5-level transparent path. */
|
|
684
|
+
getShieldedAddress(derivationPath: string, options?: {
|
|
685
|
+
checkOnDevice?: boolean;
|
|
686
|
+
skipOpenApp?: boolean;
|
|
687
|
+
}): Promise<GetShieldedAddressDAOutput>;
|
|
688
|
+
}
|
|
689
|
+
|
|
657
690
|
/**
|
|
658
691
|
* Transport adapter that bridges Ledger's legacy hw-app-* SDKs to DMK's sendApdu.
|
|
659
692
|
*
|
|
@@ -737,7 +770,7 @@ interface WrapErrorOptions {
|
|
|
737
770
|
/** Fallback when err has no `appName` (DMK signer errors don't carry it). */
|
|
738
771
|
defaultAppName?: string;
|
|
739
772
|
}
|
|
740
|
-
declare function ledgerFailure(code: HardwareErrorCode, error: string, appName?: string, tag?: string, params?: Record<string, unknown
|
|
773
|
+
declare function ledgerFailure(code: HardwareErrorCode, error: string, appName?: string, tag?: string, params?: Record<string, unknown>, origin?: HwkErrorOrigin, recovery?: HwkRecoveryHint): LedgerFailure;
|
|
741
774
|
declare function isDeviceLockedError(err: unknown): boolean;
|
|
742
775
|
/**
|
|
743
776
|
* Map a Ledger DMK error to a HardwareErrorCode and human-readable message.
|
|
@@ -747,6 +780,7 @@ declare function isDeviceLockedError(err: unknown): boolean;
|
|
|
747
780
|
declare function mapLedgerError(err: unknown, opts?: WrapErrorOptions): {
|
|
748
781
|
code: HardwareErrorCode;
|
|
749
782
|
message: string;
|
|
783
|
+
origin?: HwkErrorOrigin;
|
|
750
784
|
appName?: string;
|
|
751
785
|
};
|
|
752
786
|
|
|
@@ -782,4 +816,4 @@ declare function isLedgerDmkBleTransport(transport?: string): boolean;
|
|
|
782
816
|
declare function isLedgerBleConnectionType(connectionType?: ConnectionType): boolean;
|
|
783
817
|
declare function isLedgerBleDescriptor(connectionType: ConnectionType, descriptor: DeviceDescriptor): boolean;
|
|
784
818
|
|
|
785
|
-
export { AppManager, type DeviceActionState, type DmkDiscoveredDevice, DmkTransport, LedgerAdapter, LedgerConnectorBase, type LedgerConnectorBaseOptions, LedgerDeviceManager, type LedgerFailure, type SdkEvent, type SdkEventListener, type SdkLogEvent, SignerBtc, type SignerBtcAddress, SignerEth, type SignerEvmAddress, type SignerEvmSignature, SignerManager, SignerSol, type TransportFactory, debugLog, deviceActionToPromise, isDeviceLockedError, isLedgerBleConnectionType, isLedgerBleDescriptor, isLedgerDmkBleTransport, ledgerFailure, mapLedgerError, offSdkEvent, onSdkEvent };
|
|
819
|
+
export { AppManager, type DeviceActionState, type DmkDiscoveredDevice, DmkTransport, LedgerAdapter, LedgerConnectorBase, type LedgerConnectorBaseOptions, LedgerDeviceManager, type LedgerFailure, type SdkEvent, type SdkEventListener, type SdkLogEvent, SignerBtc, type SignerBtcAddress, SignerEth, type SignerEvmAddress, type SignerEvmSignature, SignerManager, SignerSol, SignerZcash, type TransportFactory, debugLog, deviceActionToPromise, isDeviceLockedError, isLedgerBleConnectionType, isLedgerBleDescriptor, isLedgerDmkBleTransport, ledgerFailure, mapLedgerError, offSdkEvent, onSdkEvent };
|