@onekeyfe/hwk-ledger-adapter 1.2.5-alpha.4 → 1.2.5

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.mjs CHANGED
@@ -6,41 +6,30 @@ import {
6
6
  DeviceJobQueue,
7
7
  EConnectorInteraction,
8
8
  HardwareErrorCode as HardwareErrorCode3,
9
- OperationRegistry,
10
- SDK,
11
9
  TypedEventEmitter,
12
10
  UI_REQUEST,
13
11
  UI_REQUEST_PREEMPTED_TAG,
14
12
  UiRequestRegistry,
15
- canReplayHardwareMethodAfterTransportFailure,
16
13
  createHwkError,
17
14
  deriveDeviceFingerprint,
18
15
  failure as failure2,
19
- isHardwareOperationId,
20
- isHwkRecoveryHint,
21
- operationMayHaveCompletedParams,
22
16
  rehydrateConnectorError,
23
- requestBleDeviceSelection,
24
- requestSaveDeviceBinding,
25
- resolveSearchTargetReusePolicy,
26
17
  success
27
18
  } from "@onekeyfe/hwk-adapter-core";
28
19
 
29
20
  // src/errors.ts
30
- import {
31
- HardwareErrorCode,
32
- defaultOriginForCode,
33
- defaultRecoveryForCode,
34
- enrichErrorMessage
35
- } from "@onekeyfe/hwk-adapter-core";
36
- function ledgerFailure(code, error, appName, tag, params, origin, recovery) {
21
+ import { HardwareErrorCode, enrichErrorMessage } from "@onekeyfe/hwk-adapter-core";
22
+ var MULTIPLE_USB_LEDGER_DEVICES_ERROR_MESSAGE = "Multiple Ledger USB devices are connected. Please connect only one Ledger device and try again.";
23
+ function createMultipleUsbLedgerDevicesError() {
24
+ return Object.assign(new Error(MULTIPLE_USB_LEDGER_DEVICES_ERROR_MESSAGE), {
25
+ code: HardwareErrorCode.DeviceOneDeviceOnly
26
+ });
27
+ }
28
+ function ledgerFailure(code, error, appName, tag, params) {
37
29
  const payload = { error, code };
38
30
  if (appName !== void 0) payload.appName = appName;
39
31
  if (tag !== void 0) payload._tag = tag;
40
32
  if (params !== void 0) payload.params = params;
41
- const resolvedOrigin = origin ?? defaultOriginForCode(code);
42
- if (resolvedOrigin !== void 0) payload.origin = resolvedOrigin;
43
- payload.recovery = recovery ?? defaultRecoveryForCode(code);
44
33
  return { success: false, payload };
45
34
  }
46
35
  var LOCKED_ERROR_CODES = /* @__PURE__ */ new Set(["5515", "21781", "6982", "27010", "5303", "21251"]);
@@ -181,10 +170,7 @@ var ERROR_TAG = {
181
170
  UnknownDevice: "UnknownDeviceError",
182
171
  DeviceSessionRefresher: "DeviceSessionRefresherError",
183
172
  DeviceNotInitialized: "DeviceNotInitializedError",
184
- // DMK class OpeningConnectionError carries `_tag` "ConnectionOpeningError"; both
185
- // spellings are kept so a DMK release that aligns them still classifies.
186
- OpeningConnection: "ConnectionOpeningError",
187
- OpeningConnectionLegacy: "OpeningConnectionError",
173
+ OpeningConnection: "OpeningConnectionError",
188
174
  DeviceDisconnectedBeforeSendingApdu: "DeviceDisconnectedBeforeSendingApdu",
189
175
  DeviceDisconnectedWhileSending: "DeviceDisconnectedWhileSendingError",
190
176
  Disconnect: "DisconnectError",
@@ -197,16 +183,7 @@ var ERROR_TAG = {
197
183
  // DMK remote-network failures (manager-api HTTP / secure-channel WS).
198
184
  WebSocketConnection: "WebSocketConnectionError",
199
185
  HttpFetch: "FetchError",
200
- NetworkDA: "NetworkDAError",
201
- InvalidFirmwareMetadataResponse: "InvalidGetFirmwareMetadataResponseError",
202
- ApplicationsMetadataTask: "GetApplicationsMetadataTaskError",
203
- // DMK OS device actions. SecureChannelError is what mapInstallDAErrors() leaves
204
- // after splitting out device answers, i.e. the relay itself broke.
205
- SecureChannel: "SecureChannelError",
206
- RefusedByUserDA: "RefusedByUserDAError",
207
- AppAlreadyInstalledDA: "AppAlreadyInstalledDAError",
208
- OutOfMemoryDA: "OutOfMemoryDAError",
209
- DeviceNotOnboarded: "DeviceNotOnboardedError"
186
+ InvalidFirmwareMetadataResponse: "InvalidGetFirmwareMetadataResponseError"
210
187
  };
211
188
  function isDeviceLockedError(err) {
212
189
  if (!err || typeof err !== "object") return false;
@@ -236,6 +213,7 @@ function isBlePairingFailureError(err) {
236
213
  return false;
237
214
  }
238
215
  var CONNECTION_LEVEL_TAGS = /* @__PURE__ */ new Set([
216
+ ERROR_TAG.DeviceLocked,
239
217
  ERROR_TAG.DeviceNotAdvertising,
240
218
  ERROR_TAG.BlePairingTimeout,
241
219
  ERROR_TAG.BleGattBondingFailed,
@@ -247,7 +225,6 @@ var CONNECTION_LEVEL_TAGS = /* @__PURE__ */ new Set([
247
225
  ERROR_TAG.DeviceSessionRefresher,
248
226
  ERROR_TAG.DeviceNotInitialized,
249
227
  ERROR_TAG.OpeningConnection,
250
- ERROR_TAG.OpeningConnectionLegacy,
251
228
  ERROR_TAG.DeviceDisconnectedBeforeSendingApdu,
252
229
  ERROR_TAG.DeviceDisconnectedWhileSending,
253
230
  ERROR_TAG.Disconnect,
@@ -262,10 +239,7 @@ var DEVICE_NOT_FOUND_TAGS = /* @__PURE__ */ new Set([
262
239
  // Map to DeviceNotFound so non-BLE-direct paths get a sensible error code.
263
240
  ERROR_TAG.DeviceNotInDiscoveryCache
264
241
  ]);
265
- var DEVICE_BUSY_TAGS = /* @__PURE__ */ new Set([
266
- ERROR_TAG.OpeningConnection,
267
- ERROR_TAG.OpeningConnectionLegacy
268
- ]);
242
+ var DEVICE_BUSY_TAGS = /* @__PURE__ */ new Set([ERROR_TAG.OpeningConnection]);
269
243
  var DEVICE_DISCONNECTED_TAGS = /* @__PURE__ */ new Set([
270
244
  ERROR_TAG.DeviceNotRecognized,
271
245
  ERROR_TAG.DeviceSessionNotFound,
@@ -277,18 +251,17 @@ var DEVICE_DISCONNECTED_TAGS = /* @__PURE__ */ new Set([
277
251
  ERROR_TAG.WebHIDDisconnect
278
252
  ]);
279
253
  function isConnectionLevelError(err) {
280
- return hasErrorTag(err, CONNECTION_LEVEL_TAGS);
254
+ if (!err || typeof err !== "object") return false;
255
+ const tag = err._tag;
256
+ if (tag && CONNECTION_LEVEL_TAGS.has(tag)) return true;
257
+ const e = err;
258
+ if (e.originalError != null && isConnectionLevelError(e.originalError)) return true;
259
+ if (e.error != null && e._tag && isConnectionLevelError(e.error)) return true;
260
+ return false;
281
261
  }
282
262
  function isKnownConnectionTag(tag) {
283
263
  return typeof tag === "string" && CONNECTION_LEVEL_TAGS.has(tag);
284
264
  }
285
- var CONNECTION_OPENING_TAGS = /* @__PURE__ */ new Set([
286
- ERROR_TAG.OpeningConnection,
287
- ERROR_TAG.OpeningConnectionLegacy
288
- ]);
289
- function isConnectionOpeningTag(tag) {
290
- return typeof tag === "string" && CONNECTION_OPENING_TAGS.has(tag);
291
- }
292
265
  function hasStatusCode(err, codeSet) {
293
266
  if (!err || typeof err !== "object") return false;
294
267
  const e = err;
@@ -324,28 +297,28 @@ function hasInvalidArgumentCode(err) {
324
297
  if (e.error != null && e._tag && hasInvalidArgumentCode(e.error)) return true;
325
298
  return false;
326
299
  }
327
- function hasErrorTag(err, tags) {
300
+ function isDeviceNotFoundError(err) {
328
301
  if (!err || typeof err !== "object") return false;
302
+ const tag = err._tag;
303
+ if (tag && DEVICE_NOT_FOUND_TAGS.has(tag)) return true;
329
304
  const e = err;
330
- if (typeof e._tag === "string" && tags.has(e._tag)) return true;
331
- if (e.originalError != null && hasErrorTag(e.originalError, tags)) return true;
332
- if (e.error != null && e._tag && hasErrorTag(e.error, tags)) return true;
305
+ if (e.originalError != null && isDeviceNotFoundError(e.originalError)) return true;
306
+ if (e.error != null && e._tag && isDeviceNotFoundError(e.error)) return true;
333
307
  return false;
334
308
  }
335
- function isDeviceNotFoundError(err) {
336
- return hasErrorTag(err, DEVICE_NOT_FOUND_TAGS);
337
- }
338
309
  function isDeviceBusyError(err) {
339
- return hasErrorTag(err, DEVICE_BUSY_TAGS);
310
+ if (!err || typeof err !== "object") return false;
311
+ const tag = err._tag;
312
+ if (tag && DEVICE_BUSY_TAGS.has(tag)) return true;
313
+ const e = err;
314
+ if (e.originalError != null && isDeviceBusyError(e.originalError)) return true;
315
+ if (e.error != null && e._tag && isDeviceBusyError(e.error)) return true;
316
+ return false;
340
317
  }
341
- var USER_REJECTED_TAGS = /* @__PURE__ */ new Set([
342
- ERROR_TAG.UserRefusedOnDevice,
343
- ERROR_TAG.RefusedByUserDA
344
- ]);
345
318
  function isUserRejectedError(err) {
346
319
  if (!err || typeof err !== "object") return false;
347
320
  const e = err;
348
- if (hasErrorTag(err, USER_REJECTED_TAGS)) return true;
321
+ if (e._tag === ERROR_TAG.UserRefusedOnDevice) return true;
349
322
  if (typeof e.message === "string" && /denied|rejected|refused/i.test(e.message)) return true;
350
323
  if (hasStatusCode(err, USER_REJECTED_CODES)) return true;
351
324
  return false;
@@ -376,33 +349,15 @@ function isAppNotInstalledError(err) {
376
349
  if (hasStatusCode(err, APP_NOT_INSTALLED_CODES)) return true;
377
350
  return false;
378
351
  }
379
- var OUT_OF_MEMORY_TAGS = /* @__PURE__ */ new Set([ERROR_TAG.OutOfMemoryDA]);
380
352
  function isOutOfMemoryError(err) {
381
- return hasErrorTag(err, OUT_OF_MEMORY_TAGS);
382
- }
383
- var APP_ALREADY_INSTALLED_TAGS = /* @__PURE__ */ new Set([ERROR_TAG.AppAlreadyInstalledDA]);
384
- function isAppAlreadyInstalledError(err) {
385
- return hasErrorTag(err, APP_ALREADY_INSTALLED_TAGS);
386
- }
387
- var DEVICE_NOT_ONBOARDED_TAGS = /* @__PURE__ */ new Set([ERROR_TAG.DeviceNotOnboarded]);
388
- function isDeviceNotOnboardedError(err) {
389
- return hasErrorTag(err, DEVICE_NOT_ONBOARDED_TAGS);
390
- }
391
- var FIRMWARE_METADATA_TAGS = /* @__PURE__ */ new Set([
392
- ERROR_TAG.InvalidFirmwareMetadataResponse,
393
- ERROR_TAG.ApplicationsMetadataTask
394
- ]);
395
- function isFirmwareMetadataError(err) {
396
- return hasErrorTag(err, FIRMWARE_METADATA_TAGS);
397
- }
398
- var SECURE_CHANNEL_TAGS = /* @__PURE__ */ new Set([ERROR_TAG.SecureChannel]);
399
- function isSecureChannelError(err) {
400
- return hasErrorTag(err, SECURE_CHANNEL_TAGS);
353
+ if (!err || typeof err !== "object") return false;
354
+ const e = err;
355
+ return e._tag === "OutOfMemoryDAError";
401
356
  }
402
357
  var NETWORK_ERROR_TAGS = /* @__PURE__ */ new Set([
403
358
  ERROR_TAG.WebSocketConnection,
404
359
  ERROR_TAG.HttpFetch,
405
- ERROR_TAG.NetworkDA
360
+ ERROR_TAG.InvalidFirmwareMetadataResponse
406
361
  ]);
407
362
  function isNetworkError(err) {
408
363
  if (!err || typeof err !== "object") return false;
@@ -452,34 +407,23 @@ function isTransportStuck(err) {
452
407
  function isStuckAppStateError(err) {
453
408
  return isAppStuckByApdu(err) || isTransportStuck(err);
454
409
  }
455
- var DMK_PLACEHOLDER_MESSAGE = "Unknown error.";
456
- function nestedErrorMessage(nested) {
457
- if (!nested || typeof nested !== "object") return void 0;
458
- const { message } = nested;
459
- if (typeof message !== "string") return void 0;
460
- const trimmed = message.trim();
461
- if (!trimmed || trimmed === DMK_PLACEHOLDER_MESSAGE) return void 0;
462
- return message;
463
- }
464
410
  function mapLedgerError(err, opts) {
465
411
  let originalMessage = "Unknown Ledger error";
466
412
  if (err instanceof Error) {
467
413
  originalMessage = err.message;
468
414
  } else if (err && typeof err === "object") {
469
415
  const e = err;
470
- originalMessage = String(
471
- e.message ?? nestedErrorMessage(e.originalError) ?? e._tag ?? e.type ?? JSON.stringify(err)
472
- );
416
+ originalMessage = String(e.message ?? e._tag ?? e.type ?? JSON.stringify(err));
473
417
  }
474
418
  let code;
475
419
  if (isDeviceLockedError(err)) {
476
420
  code = HardwareErrorCode.DeviceLocked;
477
421
  } else if (isDeviceNotAdvertisingError(err) || isDeviceNotFoundError(err)) {
478
422
  code = HardwareErrorCode.DeviceNotFound;
479
- } else if (isBlePairingFailureError(err)) {
480
- code = HardwareErrorCode.BlePairingTimeout;
481
423
  } else if (isDeviceBusyError(err)) {
482
424
  code = HardwareErrorCode.DeviceBusy;
425
+ } else if (isBlePairingFailureError(err)) {
426
+ code = HardwareErrorCode.BlePairingTimeout;
483
427
  } else if (isUserAbortedError(err)) {
484
428
  code = HardwareErrorCode.UserAborted;
485
429
  } else if (isUserRejectedError(err)) {
@@ -488,18 +432,10 @@ function mapLedgerError(err, opts) {
488
432
  code = HardwareErrorCode.WrongApp;
489
433
  } else if (isAppNotInstalledError(err)) {
490
434
  code = HardwareErrorCode.AppNotInstalled;
491
- } else if (isAppAlreadyInstalledError(err)) {
492
- code = HardwareErrorCode.AppAlreadyInstalled;
493
435
  } else if (isOutOfMemoryError(err)) {
494
436
  code = HardwareErrorCode.DeviceOutOfMemory;
495
- } else if (isDeviceNotOnboardedError(err)) {
496
- code = HardwareErrorCode.DeviceNotInitialized;
497
- } else if (isFirmwareMetadataError(err)) {
498
- code = HardwareErrorCode.LedgerFirmwareMetadataError;
499
437
  } else if (isNetworkError(err)) {
500
438
  code = HardwareErrorCode.NetworkError;
501
- } else if (isSecureChannelError(err)) {
502
- code = HardwareErrorCode.LedgerSecureChannelError;
503
439
  } else if (isDeviceDisconnectedError(err)) {
504
440
  code = HardwareErrorCode.DeviceDisconnected;
505
441
  } else if (isTimeoutError(err)) {
@@ -512,32 +448,11 @@ function mapLedgerError(err, opts) {
512
448
  }
513
449
  const errAppName = err && typeof err === "object" ? err.appName : void 0;
514
450
  const appName = errAppName ?? opts?.defaultAppName;
515
- return {
516
- code,
517
- message: enrichErrorMessage(code, originalMessage),
518
- origin: defaultOriginForCode(code),
519
- appName
520
- };
521
- }
522
-
523
- // src/utils/queueKey.ts
524
- var LEDGER_DEFAULT_QUEUE_KEY = "__ledger_default__";
525
- function ledgerQueueKey({
526
- operationId,
527
- connectId
528
- }) {
529
- return (operationId ?? connectId) || LEDGER_DEFAULT_QUEUE_KEY;
451
+ return { code, message: enrichErrorMessage(code, originalMessage), appName };
530
452
  }
531
453
 
532
454
  // src/adapter/methods/allNetworkGetAddress.ts
533
- import {
534
- HardwareErrorCode as HardwareErrorCode2,
535
- failure,
536
- isConnectionLost,
537
- isUserRefusal,
538
- resolveHardwareOperationTarget,
539
- runAllNetworkGetAddress
540
- } from "@onekeyfe/hwk-adapter-core";
455
+ import { HardwareErrorCode as HardwareErrorCode2, failure, runAllNetworkGetAddress } from "@onekeyfe/hwk-adapter-core";
541
456
 
542
457
  // src/utils/sdkEventBus.ts
543
458
  var listeners = /* @__PURE__ */ new Set();
@@ -594,103 +509,65 @@ var LEDGER_BTC_NETWORK_COIN_MAP = {
594
509
  var LEDGER_UNSUPPORTED_ALLNETWORK_NETWORKS = /* @__PURE__ */ new Set(["doge", "dogecoin"]);
595
510
  function createAllNetworkGetAddress({
596
511
  callChain,
597
- getChainFingerprint,
598
- retainOperation,
599
- errorToFailure,
600
- createCancelScope
512
+ getChainFingerprint
601
513
  }) {
602
514
  return async function allNetworkGetAddress(connectId, _deviceId, params) {
603
- debugLog("[LedgerAdapter][REQ]", {
604
- method: "allNetworkGetAddress",
605
- connectId,
606
- itemCount: params.bundle.length
607
- });
608
- const target = resolveHardwareOperationTarget(connectId, params.operationId, "ledger");
609
- if (!target.success) return target;
610
- const effectiveTargetId = target.payload.targetId ?? "";
611
- let releaseOperationRetention;
612
- try {
613
- releaseOperationRetention = target.payload.operationId ? retainOperation(target.payload.operationId) : void 0;
614
- } catch (error) {
615
- return errorToFailure(error);
616
- }
617
- const cancelScope = createCancelScope(
618
- ledgerQueueKey({ operationId: target.payload.operationId, connectId: effectiveTargetId })
619
- );
515
+ debugLog("[LedgerAdapter][REQ]", { method: "allNetworkGetAddress", connectId, params });
620
516
  const installContext = {};
621
517
  const commonParams = {
622
- autoInstallApp: params.autoInstallApp,
623
- operationId: target.payload.operationId,
624
- knownConnections: params.knownConnections,
625
- extra: params.extra,
626
- allowDeviceSelection: params.allowDeviceSelection,
627
- supportedTransports: params.supportedTransports
518
+ autoInstallApp: params.autoInstallApp
628
519
  };
629
520
  const chainFingerprints = /* @__PURE__ */ new Map();
630
- try {
631
- const result = await runAllNetworkGetAddress({
632
- connectId: effectiveTargetId,
633
- deviceId: _deviceId,
634
- params,
635
- normalizeItem: normalizeLedgerAllNetworkItem,
636
- buildUnsupportedNetworkResponse: (item) => isUnsupportedLedgerAllNetworkNetwork(item) ? buildUnsupportedNetworkResponse(item) : void 0,
637
- callItem: async ({ method, chain, item }) => {
638
- if (cancelScope.signal.aborted) return buildCancelledFailure(cancelScope.signal);
639
- const itemDeviceId = getItemDeviceId(item) ?? chainFingerprints.get(chain) ?? "";
640
- return callAllNetworkMethod(
641
- callChain,
642
- effectiveTargetId,
643
- itemDeviceId,
644
- method,
645
- item,
646
- commonParams,
647
- installContext
648
- );
649
- },
650
- attachIdentity: async ({ item, chain, payload }) => attachLedgerIdentity(
651
- getChainFingerprint,
652
- effectiveTargetId,
521
+ const result = await runAllNetworkGetAddress({
522
+ connectId,
523
+ deviceId: _deviceId,
524
+ params,
525
+ normalizeItem: normalizeLedgerAllNetworkItem,
526
+ buildUnsupportedNetworkResponse: (item) => isUnsupportedLedgerAllNetworkNetwork(item) ? buildUnsupportedNetworkResponse(item) : void 0,
527
+ callItem: async ({ method, chain, item }) => {
528
+ const itemDeviceId = getItemDeviceId(item) ?? chainFingerprints.get(chain) ?? "";
529
+ return callAllNetworkMethod(
530
+ callChain,
531
+ connectId,
532
+ itemDeviceId,
533
+ method,
653
534
  item,
654
- chain,
655
- payload,
656
- chainFingerprints,
657
- installContext,
658
- cancelScope.signal
659
- ),
660
- shouldAbortBundle: isTopLevelAllNetworkFailure,
661
- buildTopLevelFailure: (response) => {
662
- const code = response.payload?.code ?? HardwareErrorCode2.DeviceMismatch;
663
- return failure(
664
- code,
665
- response.payload?.error ?? "All-network get-address aborted",
666
- response.payload?.params
667
- );
668
- }
669
- });
670
- debugLog("[LedgerAdapter][RES]", {
671
- method: "allNetworkGetAddress",
672
- success: result.success,
673
- payload: result
674
- });
675
- return result;
676
- } finally {
677
- cancelScope.release();
678
- releaseOperationRetention?.();
679
- }
535
+ commonParams,
536
+ installContext
537
+ );
538
+ },
539
+ attachIdentity: async ({ item, chain, payload }) => attachLedgerIdentity(
540
+ getChainFingerprint,
541
+ connectId,
542
+ item,
543
+ chain,
544
+ payload,
545
+ chainFingerprints
546
+ ),
547
+ shouldAbortBundle: isTopLevelAllNetworkFailure,
548
+ buildTopLevelFailure: (response) => {
549
+ const code = response.payload?.code ?? HardwareErrorCode2.DeviceMismatch;
550
+ return failure(
551
+ code,
552
+ response.payload?.error ?? "All-network get-address aborted",
553
+ response.payload?.params
554
+ );
555
+ }
556
+ });
557
+ debugLog("[LedgerAdapter][RES]", {
558
+ method: "allNetworkGetAddress",
559
+ success: result.success,
560
+ payload: result
561
+ });
562
+ return result;
680
563
  };
681
564
  }
682
- function buildCancelledFailure(signal) {
683
- const reason = signal.reason;
684
- const code = typeof reason?.code === "number" ? reason.code : HardwareErrorCode2.UserAborted;
685
- const message = typeof reason?.message === "string" ? reason.message : "";
686
- return failure(code, message || "All-network get-address cancelled");
687
- }
688
565
  function isTopLevelAllNetworkFailure(response) {
689
566
  if (response.success) {
690
567
  return false;
691
568
  }
692
569
  const code = response.payload?.code;
693
- return code === HardwareErrorCode2.DeviceMismatch || isUserRefusal(code) || isConnectionLost(code);
570
+ return code === HardwareErrorCode2.DeviceMismatch || code === HardwareErrorCode2.UserAborted || code === HardwareErrorCode2.UserRejected;
694
571
  }
695
572
  function getItemDeviceId(item) {
696
573
  const { deviceId } = item;
@@ -720,18 +597,8 @@ function normalizeLedgerAllNetworkItem(method, item) {
720
597
  const coin = LEDGER_BTC_NETWORK_COIN_MAP[item.network];
721
598
  return coin ? { ...item, coin } : item;
722
599
  }
723
- async function attachLedgerIdentity(getChainFingerprint, connectId, item, chain, payload, chainFingerprints, context, cancelSignal) {
724
- const knownFingerprint = getItemDeviceId(item) || chainFingerprints.get(chain) || "";
725
- if (!knownFingerprint && cancelSignal.aborted) {
726
- const cancelled = buildCancelledFailure(cancelSignal);
727
- return { ...item, success: false, payload: cancelled.payload };
728
- }
729
- const fingerprint = knownFingerprint || await bootstrapChainFingerprint(
730
- getChainFingerprint,
731
- context.connection?.connectId ?? connectId,
732
- chain,
733
- context
734
- );
600
+ async function attachLedgerIdentity(getChainFingerprint, connectId, item, chain, payload, chainFingerprints) {
601
+ const fingerprint = getItemDeviceId(item) || chainFingerprints.get(chain) || await bootstrapChainFingerprint(getChainFingerprint, connectId, chain);
735
602
  if (!fingerprint) {
736
603
  return buildFingerprintBootstrapFailure(item, chain);
737
604
  }
@@ -752,8 +619,8 @@ async function attachLedgerIdentity(getChainFingerprint, connectId, item, chain,
752
619
  }
753
620
  };
754
621
  }
755
- async function bootstrapChainFingerprint(getChainFingerprint, connectId, chain, context) {
756
- const response = await getChainFingerprint(connectId, chain, context);
622
+ async function bootstrapChainFingerprint(getChainFingerprint, connectId, chain) {
623
+ const response = await getChainFingerprint(connectId, chain);
757
624
  return response.success ? response.payload : "";
758
625
  }
759
626
  function buildFingerprintBootstrapFailure(item, chain) {
@@ -846,16 +713,6 @@ function isLedgerBleDescriptor(connectionType, descriptor) {
846
713
  function formatDeviceMismatchError(expected, actual) {
847
714
  return `Wrong device: expected ${expected}, got ${actual}`;
848
715
  }
849
- var LOG_REDACTED_RESULT_KEYS = ["ufvk", "orchardFvk"];
850
- function redactResultForLog(result) {
851
- if (!result || typeof result !== "object") return result;
852
- const keys = LOG_REDACTED_RESULT_KEYS.filter((key) => key in result);
853
- if (!keys.length) return result;
854
- return { ...result, ...Object.fromEntries(keys.map((key) => [key, "[redacted]"])) };
855
- }
856
- function isLostConnectionError(err) {
857
- return isDeviceDisconnectedError(err) || isDeviceNotAdvertisingError(err) || isTimeoutError(err) || isConnectionLevelError(err);
858
- }
859
716
  var BTC_HIGH_INDEX_THRESHOLD = 100;
860
717
  function btcAccountIndexFromPath(path) {
861
718
  const segments = path.replace(/^m\//, "").split("/");
@@ -867,28 +724,9 @@ function btcAccountIndexFromPath(path) {
867
724
  var _LedgerAdapter = class _LedgerAdapter {
868
725
  constructor(connector, options) {
869
726
  this.vendor = "ledger";
870
- // Cancel frees the DMK action and its intent-queue slot, but cannot retract a
871
- // confirmation screen the device is already showing.
872
- this.cancelCapability = "stops-waiting";
873
727
  this.emitter = new TypedEventEmitter();
874
- this._operations = new OperationRegistry({
875
- vendor: "ledger",
876
- onEnded: (operation, reason) => {
877
- this.emitter.emit(SDK.OPERATION_ENDED, {
878
- type: SDK.OPERATION_ENDED,
879
- payload: { operationId: operation.operationId, reason }
880
- });
881
- if (reason === "timeout") {
882
- void this._releaseOperationConnection(operation);
883
- }
884
- }
885
- });
886
728
  this._discoveredDevices = /* @__PURE__ */ new Map();
887
729
  this._sessions = /* @__PURE__ */ new Map();
888
- // Transport each session was opened on, by sessionId. The adapter-wide
889
- // `_activeConnectionType` moves with every discovery and can go stale.
890
- this._sessionTransports = /* @__PURE__ */ new Map();
891
- this._selectedBleReconnectTargets = /* @__PURE__ */ new Map();
892
730
  this._uiRegistry = new UiRequestRegistry();
893
731
  // BTC App rejects account index >= 100 unless display=true. Cached per
894
732
  // adapter instance: first 100+ path asks the user once via UI request,
@@ -902,31 +740,10 @@ var _LedgerAdapter = class _LedgerAdapter {
902
740
  this._deviceAuthenticityQueueTail = Promise.resolve();
903
741
  // Shared across concurrent callers — only `cancel()` aborts.
904
742
  this._doConnectAbortController = null;
905
- this._unsettledConnectorOperations = /* @__PURE__ */ new Map();
906
- this._connectorIdleWaiters = /* @__PURE__ */ new Set();
907
- this._resetPromise = null;
908
- this._stateGeneration = 0;
909
- this._connectorTeardownTail = Promise.resolve();
910
- this._pendingConnectorTeardowns = 0;
911
- this._activeOperationJobs = /* @__PURE__ */ new Set();
912
- this._pendingOperationDisconnects = /* @__PURE__ */ new Set();
913
743
  this._installProgressLastEmittedValue = -Infinity;
914
744
  this.allNetworkGetAddress = createAllNetworkGetAddress({
915
745
  callChain: this.callChain.bind(this),
916
- getChainFingerprint: async (connectId, chain, context) => {
917
- try {
918
- const fingerprint = await this._computeChainFingerprint(
919
- chain,
920
- (method, params) => this.connectorCall(connectId, method, params, void 0, void 0, void 0, context)
921
- );
922
- return success(fingerprint);
923
- } catch (error) {
924
- return this.errorToFailure(error);
925
- }
926
- },
927
- retainOperation: (operationId) => this._operations.retain(operationId),
928
- errorToFailure: (error) => this.errorToFailure(error),
929
- createCancelScope: (queueKey) => this._jobQueue.createCancelScope(queueKey)
746
+ getChainFingerprint: (connectId, chain) => this.getChainFingerprint(connectId, "", chain)
930
747
  });
931
748
  // ---------------------------------------------------------------------------
932
749
  // Private helpers
@@ -936,7 +753,7 @@ var _LedgerAdapter = class _LedgerAdapter {
936
753
  *
937
754
  * - If a session already exists for the given connectId, reuse it.
938
755
  * - If ANY session exists (Ledger IDs are ephemeral), reuse it.
939
- * - Otherwise: search → one USB device auto-connects; multiple asks the host to choose.
756
+ * - Otherwise: search → exactly 1 USB device auto-connects; multiple or none throws.
940
757
  */
941
758
  // Mutex for ensureConnected — prevents concurrent calls from establishing duplicate connections
942
759
  this._connectingPromise = null;
@@ -953,12 +770,6 @@ var _LedgerAdapter = class _LedgerAdapter {
953
770
  });
954
771
  };
955
772
  this.deviceDisconnectHandler = (data) => {
956
- const activeOperation = this._operations.findActiveByConnectionKey(data.connectId);
957
- if (activeOperation && this._activeOperationJobs.has(activeOperation.operationId)) {
958
- this._pendingOperationDisconnects.add(activeOperation.operationId);
959
- } else {
960
- this._operations.endByConnectionKey(data.connectId, "disconnect");
961
- }
962
773
  this._discoveredDevices.delete(data.connectId);
963
774
  this._sessions.delete(data.connectId);
964
775
  this.emitter.emit(DEVICE.DISCONNECT, {
@@ -967,8 +778,10 @@ var _LedgerAdapter = class _LedgerAdapter {
967
778
  });
968
779
  };
969
780
  // Forward connector `ui-event` to the public hw.emitter so consumers only
970
- // need to subscribe in one place. The AppInstallProgress variant re-keys
971
- // sessionId to connectId via `_sessions`, and drops if no mapping exists.
781
+ // need to subscribe in one place. For the AppInstallProgress variant we
782
+ // re-key sessionId → connectId via the live _sessions map; if no mapping
783
+ // exists (race during teardown) we drop. All other variants pass through
784
+ // unchanged.
972
785
  this.uiEventForwarder = (event) => {
973
786
  if (event.type === EConnectorInteraction.AppInstallProgress) {
974
787
  let connectId;
@@ -1013,28 +826,11 @@ var _LedgerAdapter = class _LedgerAdapter {
1013
826
  this._jobQueue = new DeviceJobQueue();
1014
827
  this.registerEventListeners();
1015
828
  }
1016
- _finishBleBinding(status) {
1017
- const selectionRequestId = this._bindingSelectionRequestId;
1018
- this._bindingSelectionRequestId = void 0;
1019
- if (selectionRequestId)
1020
- this.emitter.emit(UI_REQUEST.DEVICE_BINDING_STATUS, {
1021
- type: UI_REQUEST.DEVICE_BINDING_STATUS,
1022
- payload: { selectionRequestId, status }
1023
- });
1024
- }
1025
- _isBleConnection() {
1026
- return isLedgerBleConnectionType(this._activeConnectionType ?? this.connector.connectionType);
1027
- }
1028
829
  // Transport
1029
830
  get activeTransport() {
1030
- return this._isBleConnection() ? "ble" : "hid";
831
+ return isLedgerBleConnectionType(this.connector.connectionType) ? "ble" : "hid";
1031
832
  }
1032
833
  getAvailableTransports() {
1033
- if (this.connector.availableTransports) {
1034
- return this.connector.availableTransports.map(
1035
- (transport) => transport === "ble" ? "ble" : "hid"
1036
- );
1037
- }
1038
834
  return this.activeTransport ? [this.activeTransport] : [];
1039
835
  }
1040
836
  // Connector is bound at construction; switching requires a new adapter.
@@ -1051,40 +847,21 @@ var _LedgerAdapter = class _LedgerAdapter {
1051
847
  * The next operation will re-discover and re-connect automatically.
1052
848
  */
1053
849
  resetState() {
1054
- void this._resetStateAndDisconnectSessions();
1055
- }
1056
- _resetStateAndDisconnectSessions() {
1057
- if (this._resetPromise) return this._resetPromise;
1058
- const sessionIds = new Set(this._sessions.values());
1059
- this._stateGeneration += 1;
1060
- this._finishBleBinding("cancelled");
1061
- this._operations.endAll("runtime-reset");
1062
- this._doConnectAbortController?.abort();
1063
850
  this._discoveredDevices.clear();
1064
851
  this._sessions.clear();
1065
- this._sessionTransports.clear();
1066
- this._selectedBleReconnectTargets.clear();
1067
852
  this._connectingPromise = null;
1068
- this._doConnectAbortController = null;
1069
853
  this._uiRegistry.reset();
1070
854
  this._jobQueue.clear();
1071
855
  this._btcHighIndexConfirmedThisSession = false;
1072
- const resetPromise = this._runConnectorTeardown(async () => {
1073
- for (const sessionId of sessionIds) {
1074
- await this.connector.disconnect(sessionId).catch(() => void 0);
1075
- }
1076
- });
1077
- this._resetPromise = resetPromise;
1078
- return resetPromise.finally(() => {
1079
- if (this._resetPromise === resetPromise) {
1080
- this._resetPromise = null;
1081
- }
1082
- });
1083
856
  }
1084
857
  async dispose() {
1085
- await this._resetStateAndDisconnectSessions();
858
+ this._uiRegistry.reset();
859
+ this._jobQueue.clear();
1086
860
  this.unregisterEventListeners();
1087
861
  this.connector.reset();
862
+ this._discoveredDevices.clear();
863
+ this._sessions.clear();
864
+ this._btcHighIndexConfirmedThisSession = false;
1088
865
  this.emitter.removeAllListeners();
1089
866
  }
1090
867
  uiResponse(response) {
@@ -1094,32 +871,17 @@ var _LedgerAdapter = class _LedgerAdapter {
1094
871
  // Device management
1095
872
  // ---------------------------------------------------------------------------
1096
873
  async searchDevices(options) {
1097
- return this._searchDevices(options);
1098
- }
1099
- async _searchDevices(options, signal) {
1100
874
  debugLog("[LedgerAdapter][REQ]", { method: "searchDevices", params: options });
1101
875
  try {
1102
876
  if (options?.resetSession) {
1103
- await this._resetStateAndDisconnectSessions();
1104
- } else {
1105
- await this._connectorTeardownTail;
1106
- }
1107
- await this._ensureDevicePermission(void 0, void 0, signal);
1108
- if (signal) _LedgerAdapter._throwIfAborted(signal);
1109
- const stateGeneration = this._stateGeneration;
1110
- const devices = await this.connector.searchDevices(
1111
- options?.transportType ? {
1112
- transportType: options.transportType,
1113
- waitForAll: options.waitForAllTransports
1114
- } : void 0
1115
- );
1116
- if (signal) _LedgerAdapter._throwIfAborted(signal);
1117
- if (stateGeneration !== this._stateGeneration) {
1118
- throw createHwkError({
1119
- code: HardwareErrorCode3.UserAborted,
1120
- message: "Ledger discovery was reset"
1121
- });
877
+ this._doConnectAbortController?.abort();
878
+ this._sessions.clear();
879
+ this._connectingPromise = null;
880
+ this._doConnectAbortController = null;
881
+ this._btcHighIndexConfirmedThisSession = false;
1122
882
  }
883
+ await this._ensureDevicePermission();
884
+ const devices = await this.connector.searchDevices();
1123
885
  this._discoveredDevices.clear();
1124
886
  for (const d of devices) {
1125
887
  if (d.connectId) {
@@ -1127,7 +889,7 @@ var _LedgerAdapter = class _LedgerAdapter {
1127
889
  }
1128
890
  }
1129
891
  if (this._discoveredDevices.size === 0) {
1130
- await this._ensureDevicePermission(void 0, void 0, signal);
892
+ await this._ensureDevicePermission();
1131
893
  }
1132
894
  const result = Array.from(this._discoveredDevices.values());
1133
895
  debugLog("[LedgerAdapter][RES]", {
@@ -1146,233 +908,41 @@ var _LedgerAdapter = class _LedgerAdapter {
1146
908
  throw err;
1147
909
  }
1148
910
  }
1149
- async searchDeviceTargets(options) {
1150
- const devices = await this.searchDevices(options);
1151
- return devices.map((device) => ({
1152
- searchTargetId: device.connectId,
1153
- searchTargetReusePolicy: resolveSearchTargetReusePolicy(device),
1154
- vendor: "ledger",
1155
- connectionType: device.connectionType,
1156
- kind: "physical",
1157
- label: device.label,
1158
- model: device.model,
1159
- modelName: device.modelName,
1160
- serialNumber: device.serialNumber
1161
- }));
1162
- }
1163
- async listConnectionTargets(options) {
1164
- const targets = await this.searchDeviceTargets(options);
1165
- return targets.map(({ searchTargetId, ...target }) => ({
1166
- ...target,
1167
- targetId: searchTargetId
1168
- }));
1169
- }
1170
911
  // USB single-session invariant: evict all sessions, best-effort (see connectDevice).
1171
- async _evictAllSessions(preserveOperationId) {
1172
- this._operations.endAll("explicit", preserveOperationId);
912
+ async _evictAllSessions() {
1173
913
  if (this._sessions.size === 0) return;
1174
914
  const stale = [...this._sessions.values()];
1175
915
  this._sessions.clear();
1176
- for (const sid of stale) this._sessionTransports.delete(sid);
1177
- await this._runConnectorTeardown(async () => {
1178
- for (const sid of stale) {
1179
- try {
1180
- await this.connector.disconnect(sid);
1181
- } catch {
1182
- }
916
+ for (const sid of stale) {
917
+ try {
918
+ await this.connector.disconnect(sid);
919
+ } catch {
1183
920
  }
1184
- });
921
+ }
1185
922
  }
1186
923
  static _createDeviceBusyError(method) {
1187
924
  return Object.assign(new Error(`Ledger device is busy while calling ${method}`), {
1188
925
  code: HardwareErrorCode3.DeviceBusy
1189
926
  });
1190
927
  }
1191
- async connectDevice(searchTargetId) {
1192
- try {
1193
- return await this._jobQueue.enqueue(
1194
- searchTargetId || "__ledger_connect__",
1195
- async (signal) => {
1196
- const connected = await this._connectTarget(searchTargetId, void 0, signal);
1197
- if (!connected.success) return connected;
1198
- return this._createOperation(searchTargetId, connected.payload);
1199
- },
1200
- {
1201
- label: "connectDevice",
1202
- rejectIfBusy: true,
1203
- busyError: _LedgerAdapter._createDeviceBusyError("connectDevice")
1204
- }
1205
- );
1206
- } catch (error) {
1207
- return this.errorToFailure(error);
1208
- }
1209
- }
1210
- /** Ledger binds whichever BLE device the user picks; its wallet is not checked. */
1211
- async bindBleDevice(params) {
1212
- try {
1213
- return await this._jobQueue.enqueue(
1214
- "__ledger_bind_ble__",
1215
- async (signal) => {
1216
- if (!this.getAvailableTransports().includes("ble")) {
1217
- throw createHwkError({
1218
- code: HardwareErrorCode3.TransportNotAvailable,
1219
- message: "Ledger Bluetooth transport is not available"
1220
- });
1221
- }
1222
- this._activeConnectionType = "ble";
1223
- await this._ensureDevicePermission(void 0, void 0, signal);
1224
- const attempt = {
1225
- extra: params.extra,
1226
- bindingReason: "manual-rebind"
1227
- };
1228
- try {
1229
- const connectId = await this._connectFirstOrSelect(
1230
- [],
1231
- void 0,
1232
- true,
1233
- void 0,
1234
- attempt,
1235
- signal
1236
- );
1237
- if (!attempt.bindingSaved) {
1238
- await this._dropSession(connectId, signal);
1239
- throw createHwkError({
1240
- code: HardwareErrorCode3.UnknownError,
1241
- message: "Bluetooth binding could not be saved",
1242
- origin: "host"
1243
- });
1244
- }
1245
- return success(connectId);
1246
- } catch (error) {
1247
- this._finishBleBinding(signal.aborted ? "cancelled" : "failed");
1248
- throw error;
1249
- }
1250
- },
1251
- {
1252
- label: "bindBleDevice",
1253
- rejectIfBusy: true,
1254
- busyError: _LedgerAdapter._createDeviceBusyError("bindBleDevice")
1255
- }
1256
- );
1257
- } catch (error) {
1258
- return this.errorToFailure(error);
1259
- }
1260
- }
1261
- async acquireOperation(connectId, context) {
1262
- try {
1263
- return await this._jobQueue.enqueue(
1264
- connectId || "__ledger_acquire__",
1265
- async (signal) => {
1266
- const transport = this._isBleConnection() ? "ble" : "usb";
1267
- const hint = context.knownConnections?.find(
1268
- (connection) => connection.transport === transport
1269
- );
1270
- const target = hint && hint.transport !== "qr" ? hint.connectId : connectId;
1271
- await this._ensureDevicePermission(target, void 0, signal);
1272
- const attempt = {
1273
- ...context,
1274
- extra: context.extra ? { ...context.extra } : void 0
1275
- };
1276
- try {
1277
- const resolvedConnectId = await this.ensureConnected(
1278
- target,
1279
- signal,
1280
- true,
1281
- void 0,
1282
- attempt
1283
- );
1284
- _LedgerAdapter._throwIfAborted(signal);
1285
- return this._createOperation(connectId, resolvedConnectId);
1286
- } catch (error) {
1287
- this._finishBleBinding(signal.aborted ? "cancelled" : "failed");
1288
- throw error;
1289
- }
1290
- },
1291
- {
1292
- label: "acquireOperation",
1293
- rejectIfBusy: true,
1294
- busyError: _LedgerAdapter._createDeviceBusyError("acquireOperation")
1295
- }
1296
- );
1297
- } catch (error) {
1298
- return this.errorToFailure(error);
1299
- }
1300
- }
1301
- _createOperation(searchTargetId, resolvedConnectId) {
1302
- this._operations.endByConnectionKey(resolvedConnectId, "explicit");
1303
- const sessionId = this._sessions.get(resolvedConnectId);
1304
- if (sessionId) this._operations.endByConnectionKey(sessionId, "explicit");
1305
- const connectionType = sessionId && this._sessionTransports.get(sessionId) || (this._isBleConnection() ? "ble" : "usb");
1306
- const device = this._discoveredDevices.get(resolvedConnectId) ?? {
1307
- vendor: "ledger",
1308
- model: "unknown",
1309
- firmwareVersion: "",
1310
- deviceId: "",
1311
- connectId: resolvedConnectId,
1312
- connectionType
1313
- };
1314
- const operation = this._operations.create({
1315
- searchTargetId,
1316
- connectId: resolvedConnectId,
1317
- device,
1318
- connectionType,
1319
- connectionKeys: [this._sessions.get(resolvedConnectId) ?? ""]
1320
- });
1321
- return success(operation.operationId);
1322
- }
1323
- async _connectTarget(connectId, preserveOperationId, signal) {
928
+ async connectDevice(connectId) {
1324
929
  debugLog("[LedgerAdapter][REQ]", { method: "connectDevice", connectId, params: { connectId } });
1325
930
  try {
1326
- this._assertConnectorReady("connectDevice");
1327
- const discoveredType = this._discoveredDevices.get(connectId)?.connectionType;
1328
- if (discoveredType === "usb" || discoveredType === "ble") {
1329
- this._activeConnectionType = discoveredType;
1330
- }
1331
- if (this._isBleConnection() && !connectId) {
931
+ if (isLedgerBleConnectionType(this.connector.connectionType) && !connectId) {
1332
932
  throw Object.assign(new Error("Ledger BLE connectId is required."), {
1333
933
  code: HardwareErrorCode3.DeviceNotFound
1334
934
  });
1335
935
  }
1336
- await this._ensureDevicePermission(connectId, void 0, signal);
1337
- if (signal) _LedgerAdapter._throwIfAborted(signal);
1338
- const isMultiTransport = (this.connector.availableTransports?.length ?? 0) > 1;
1339
- if (!isMultiTransport && this._isBleConnection()) {
1340
- const previousSessionId = this._sessions.get(connectId);
1341
- this._operations.endByConnectionKey(connectId, "explicit", preserveOperationId);
1342
- if (previousSessionId) {
1343
- this._operations.endByConnectionKey(previousSessionId, "explicit", preserveOperationId);
1344
- this._sessions.delete(connectId);
1345
- await this.connector.disconnect(previousSessionId).catch(() => void 0);
1346
- }
1347
- } else {
1348
- await this._evictAllSessions(preserveOperationId);
1349
- }
1350
- if (signal) _LedgerAdapter._throwIfAborted(signal);
1351
- const stateGeneration = this._stateGeneration;
1352
- const releaseOperation = this._retainConnectorOperation(`connect:${connectId}`);
1353
- let session;
1354
- this._connectingConnectId = connectId;
1355
- try {
1356
- session = this.connector.availableTransports?.length ? await this.connector.connect(connectId, {
1357
- transportType: this._activeConnectionType ?? "usb"
1358
- }) : await this.connector.connect(connectId);
1359
- if (signal?.aborted || stateGeneration !== this._stateGeneration) {
1360
- await this.connector.disconnect(session.sessionId).catch(() => void 0);
1361
- throw Object.assign(new Error("Ledger connection aborted"), {
1362
- code: HardwareErrorCode3.UserAborted
1363
- });
1364
- }
1365
- } finally {
1366
- if (this._connectingConnectId === connectId) this._connectingConnectId = void 0;
1367
- releaseOperation();
936
+ if (!isLedgerBleConnectionType(this.connector.connectionType)) {
937
+ await this._evictAllSessions();
1368
938
  }
1369
- const resolvedConnectId = session.deviceInfo?.connectId || connectId;
1370
- this._sessions.set(resolvedConnectId, session.sessionId);
1371
- this._sessionTransports.set(session.sessionId, this._isBleConnection() ? "ble" : "usb");
939
+ await this._ensureDevicePermission(connectId);
940
+ const session = await this.connector.connect(connectId);
941
+ this._sessions.set(connectId, session.sessionId);
1372
942
  if (session.deviceInfo) {
1373
- this._discoveredDevices.set(resolvedConnectId, session.deviceInfo);
943
+ this._discoveredDevices.set(connectId, session.deviceInfo);
1374
944
  }
1375
- const result = success(resolvedConnectId);
945
+ const result = success(connectId);
1376
946
  debugLog("[LedgerAdapter][RES]", { method: "connectDevice", success: true, payload: result });
1377
947
  return result;
1378
948
  } catch (err) {
@@ -1385,60 +955,30 @@ var _LedgerAdapter = class _LedgerAdapter {
1385
955
  return failureResult;
1386
956
  }
1387
957
  }
1388
- async releaseOperation(operationId) {
1389
- const operation = this._operations.find(operationId);
1390
- if (!operation) {
1391
- this._operations.resolve(operationId);
1392
- return;
1393
- }
1394
- const endedOperation = this._operations.end(operationId, "explicit");
1395
- if (!endedOperation) return;
1396
- const { connectId } = operation;
958
+ async disconnectDevice(connectId) {
1397
959
  debugLog("[LedgerAdapter][REQ]", {
1398
- method: "releaseOperation",
960
+ method: "disconnectDevice",
1399
961
  connectId,
1400
962
  params: { connectId }
1401
963
  });
1402
964
  try {
1403
- await this._releaseOperationConnection(endedOperation);
1404
- debugLog("[LedgerAdapter][RES]", { method: "releaseOperation", success: true });
965
+ const sessionId = this._sessions.get(connectId);
966
+ if (sessionId) {
967
+ await this.connector.disconnect(sessionId);
968
+ this._sessions.delete(connectId);
969
+ }
970
+ debugLog("[LedgerAdapter][RES]", { method: "disconnectDevice", success: true });
1405
971
  } catch (err) {
1406
972
  const e = err;
1407
973
  debugLog("[LedgerAdapter][RES]", {
1408
- method: "releaseOperation",
974
+ method: "disconnectDevice",
1409
975
  success: false,
1410
976
  error: { message: e?.message, _tag: e?._tag, code: e?.code ?? e?.errorCode }
1411
977
  });
1412
978
  throw err;
1413
979
  }
1414
980
  }
1415
- async _releaseOperationConnection(operation) {
1416
- const sessionIds = /* @__PURE__ */ new Set();
1417
- for (const [connectId, sessionId] of this._sessions) {
1418
- if (connectId === operation.connectId || operation.connectionKeys.includes(connectId) || operation.connectionKeys.includes(sessionId)) {
1419
- this._sessions.delete(connectId);
1420
- sessionIds.add(sessionId);
1421
- }
1422
- }
1423
- for (const sessionId of sessionIds) {
1424
- await this._runConnectorTeardown(
1425
- () => this.connector.disconnect(sessionId).catch(() => void 0)
1426
- );
1427
- }
1428
- }
1429
- async _releaseLostOperationConnection(operationId) {
1430
- const endedOperation = this._operations.end(operationId, "disconnect");
1431
- if (!endedOperation) return;
1432
- this._discoveredDevices.delete(endedOperation.connectId);
1433
- await this._releaseOperationConnection(endedOperation);
1434
- }
1435
- async getDeviceInfo(connectIdOrOperationId, deviceId) {
1436
- let connectId;
1437
- try {
1438
- connectId = isHardwareOperationId(connectIdOrOperationId) ? this._operations.resolve(connectIdOrOperationId).connectId : connectIdOrOperationId;
1439
- } catch (error) {
1440
- return this.errorToFailure(error);
1441
- }
981
+ async getDeviceInfo(connectId, deviceId) {
1442
982
  debugLog("[LedgerAdapter][REQ]", {
1443
983
  method: "getDeviceInfo",
1444
984
  connectId,
@@ -1473,9 +1013,12 @@ var _LedgerAdapter = class _LedgerAdapter {
1473
1013
  success: false,
1474
1014
  error: { message: e?.message, _tag: e?._tag, code: e?.code ?? e?.errorCode }
1475
1015
  });
1476
- return this.errorToFailure(err);
1016
+ throw err;
1477
1017
  }
1478
1018
  }
1019
+ getSupportedChains() {
1020
+ return ["evm", "btc", "sol", "tron"];
1021
+ }
1479
1022
  // ---------------------------------------------------------------------------
1480
1023
  // Chain call helper
1481
1024
  // ---------------------------------------------------------------------------
@@ -1510,23 +1053,13 @@ var _LedgerAdapter = class _LedgerAdapter {
1510
1053
  if (params && typeof params === "object") {
1511
1054
  const {
1512
1055
  autoInstallApp,
1513
- operationId,
1514
1056
  passphraseState: _passphraseState,
1515
1057
  useEmptyPassphrase: _useEmptyPassphrase,
1516
- knownConnections,
1517
- extra,
1518
- allowDeviceSelection,
1519
- supportedTransports,
1520
1058
  ...rest
1521
1059
  } = params;
1522
1060
  return {
1523
1061
  commonParams: {
1524
- autoInstallApp: typeof autoInstallApp === "boolean" ? autoInstallApp : void 0,
1525
- operationId: typeof operationId === "string" ? operationId : void 0,
1526
- knownConnections,
1527
- extra,
1528
- allowDeviceSelection: typeof allowDeviceSelection === "boolean" ? allowDeviceSelection : void 0,
1529
- supportedTransports
1062
+ autoInstallApp: typeof autoInstallApp === "boolean" ? autoInstallApp : void 0
1530
1063
  },
1531
1064
  rest
1532
1065
  };
@@ -1702,28 +1235,9 @@ var _LedgerAdapter = class _LedgerAdapter {
1702
1235
  );
1703
1236
  }
1704
1237
  // ---------------------------------------------------------------------------
1705
- // Zcash chain methods (viewing key + shielded address reads; Zcash app >= 3.8.0)
1706
- // ---------------------------------------------------------------------------
1707
- zcashGetFullViewingKey(connectId, deviceId, params) {
1708
- return this.callChainWithMergedParams(
1709
- connectId,
1710
- deviceId,
1711
- "zcash",
1712
- "zcashGetFullViewingKey",
1713
- params
1714
- );
1715
- }
1716
- zcashGetShieldedAddress(connectId, deviceId, params) {
1717
- return this.callChainWithMergedParams(
1718
- connectId,
1719
- deviceId,
1720
- "zcash",
1721
- "zcashGetShieldedAddress",
1722
- params
1723
- );
1724
- }
1725
- // ---------------------------------------------------------------------------
1726
- // App management: OS-level app install/list, no fingerprint or chain dispatch.
1238
+ // App management — OS-level Ledger app install / list. Bypasses fingerprint
1239
+ // and chain-handler dispatch; installApp progress is forwarded to the adapter
1240
+ // emitter via 'ui-event' AppInstallProgress events.
1727
1241
  // ---------------------------------------------------------------------------
1728
1242
  async installApp(connectId, appName) {
1729
1243
  try {
@@ -1809,7 +1323,7 @@ var _LedgerAdapter = class _LedgerAdapter {
1809
1323
  );
1810
1324
  }
1811
1325
  await this.connector.configure({ ledgerGenuineCheckWebSocketUrl: relayUrl });
1812
- await this._resetStateAndDisconnectSessions();
1326
+ this.resetState();
1813
1327
  }
1814
1328
  const result = await this.connectorCall(connectId, "getDeviceGenuineCheck", {});
1815
1329
  if (!result.isGenuine) {
@@ -1835,10 +1349,10 @@ var _LedgerAdapter = class _LedgerAdapter {
1835
1349
  if (relayUrl) {
1836
1350
  try {
1837
1351
  await this.connector.configure?.({ ledgerGenuineCheckWebSocketUrl: void 0 });
1838
- await this._resetStateAndDisconnectSessions();
1352
+ this.resetState();
1839
1353
  } catch {
1840
1354
  this.connector.reset();
1841
- await this._resetStateAndDisconnectSessions();
1355
+ this.resetState();
1842
1356
  }
1843
1357
  }
1844
1358
  }
@@ -1850,20 +1364,6 @@ var _LedgerAdapter = class _LedgerAdapter {
1850
1364
  this.emitter.off(event, listener);
1851
1365
  }
1852
1366
  cancel(connectId) {
1853
- const namedOperationIsLive = (id) => {
1854
- try {
1855
- this._operations.resolve(id);
1856
- return true;
1857
- } catch {
1858
- return false;
1859
- }
1860
- };
1861
- if (isHardwareOperationId(connectId) && !namedOperationIsLive(connectId)) {
1862
- debugLog("[LedgerAdapter] cancel target already ended; nothing to cancel", {
1863
- connectId
1864
- });
1865
- return;
1866
- }
1867
1367
  const userAbortReason = Object.assign(new Error("User aborted operation"), {
1868
1368
  code: HardwareErrorCode3.UserAborted,
1869
1369
  _tag: ERROR_TAG.UserAborted
@@ -1874,46 +1374,14 @@ var _LedgerAdapter = class _LedgerAdapter {
1874
1374
  this._lastCancelReason = void 0;
1875
1375
  }
1876
1376
  }, 2e3);
1877
- const activeJobId = this._jobQueue.getActiveJob()?.deviceId;
1878
- let operationId;
1879
- if (isHardwareOperationId(connectId)) {
1880
- operationId = connectId;
1881
- } else if (!connectId && isHardwareOperationId(activeJobId)) {
1882
- operationId = activeJobId;
1883
- }
1884
- let resolvedConnectId = connectId;
1885
- if (operationId) {
1886
- try {
1887
- resolvedConnectId = this._operations.resolve(operationId).connectId;
1888
- } catch {
1889
- resolvedConnectId = void 0;
1890
- }
1891
- }
1892
- const interactionForPhysicalId = !operationId && connectId ? this._operations.findActiveByConnectionKey(connectId) : void 0;
1893
- const pendingOperationId = operationId ?? interactionForPhysicalId?.operationId;
1894
- if (!connectId) {
1895
- this._uiRegistry.cancel();
1896
- } else if (pendingOperationId) {
1897
- this._uiRegistry.cancel(void 0, void 0, pendingOperationId);
1898
- }
1899
- this._finishBleBinding("cancelled");
1900
- const queueKeys = /* @__PURE__ */ new Set();
1901
- if (connectId) queueKeys.add(ledgerQueueKey({ connectId }));
1902
- if (pendingOperationId) queueKeys.add(ledgerQueueKey({ operationId: pendingOperationId }));
1903
- if (queueKeys.size) {
1904
- let cancelledAnyJob = false;
1905
- for (const key of queueKeys) {
1906
- cancelledAnyJob = this._jobQueue.cancelActiveAndPending(key, userAbortReason) || cancelledAnyJob;
1907
- }
1908
- debugLog("[LedgerAdapter] cancel routed to queue keys", {
1909
- queueKeys: [...queueKeys],
1910
- cancelledAnyJob
1911
- });
1377
+ this._uiRegistry.cancel();
1378
+ if (connectId) {
1379
+ this._jobQueue.cancelActiveAndPending(connectId, userAbortReason);
1912
1380
  } else {
1913
1381
  this._jobQueue.cancelActiveAndPending(void 0, userAbortReason);
1914
1382
  }
1915
- if (resolvedConnectId) {
1916
- const sessionId = this._sessions.get(resolvedConnectId) ?? resolvedConnectId;
1383
+ if (connectId) {
1384
+ const sessionId = this._sessions.get(connectId) ?? connectId;
1917
1385
  void this.connector.cancel(sessionId);
1918
1386
  } else {
1919
1387
  for (const sid of this._sessions.values()) void this.connector.cancel(sid);
@@ -1921,85 +1389,45 @@ var _LedgerAdapter = class _LedgerAdapter {
1921
1389
  if (this._connectingPromise) {
1922
1390
  this._doConnectAbortController?.abort(userAbortReason);
1923
1391
  }
1924
- const connectingConnectId = this._connectingConnectId;
1925
- if (connectingConnectId) void this.connector.cancel(connectingConnectId);
1926
1392
  }
1927
1393
  // ---------------------------------------------------------------------------
1928
1394
  // Chain fingerprint
1929
1395
  // ---------------------------------------------------------------------------
1930
- /** A non-empty deviceId is an expected chain fingerprint, not a transport identifier. */
1931
1396
  async getChainFingerprint(connectId, deviceId, chain) {
1932
1397
  try {
1933
1398
  const fingerprint = await this._computeChainFingerprint(
1934
1399
  chain,
1935
1400
  (method, params) => this.connectorCall(connectId, method, params, void 0, deviceId)
1936
1401
  );
1937
- if (deviceId) {
1938
- if (fingerprint !== deviceId) {
1939
- return failure2(
1940
- HardwareErrorCode3.DeviceMismatch,
1941
- formatDeviceMismatchError(deviceId, fingerprint)
1942
- );
1943
- }
1944
- }
1945
1402
  return success(fingerprint);
1946
1403
  } catch (err) {
1947
1404
  debugError("[LedgerAdapter] getChainFingerprint error:", chain, err);
1948
1405
  return this.errorToFailure(err);
1949
1406
  }
1950
1407
  }
1951
- /** Ledger takes the selected BLE endpoint as the device and binds it right away. */
1952
- async _saveSelectedBleBinding(connectId, selectionRequestId, context, operationId, signal) {
1408
+ /**
1409
+ * Verify fingerprint using an existing sessionId directly.
1410
+ * Safe to call inside connectorCall without causing queue deadlock.
1411
+ */
1412
+ async _verifyDeviceFingerprintWithSession(sessionId, deviceId, chain) {
1413
+ if (!deviceId) return { success: true };
1953
1414
  try {
1954
- const outcome = await requestSaveDeviceBinding(
1955
- this.emitter,
1956
- this._uiRegistry,
1957
- {
1958
- selectionRequestId,
1959
- connection: { transport: "ble", connectId },
1960
- extra: context?.extra,
1961
- operationId
1962
- },
1963
- signal
1415
+ const fingerprint = await this._computeChainFingerprint(
1416
+ chain,
1417
+ (method, params) => this._callConnector(sessionId, method, params)
1964
1418
  );
1965
- if (context) context.bindingSaved = outcome.saved;
1966
- if (!outcome.saved) {
1967
- debugLog("[LedgerAdapter] BLE binding not persisted by host", {
1968
- connectId,
1969
- reason: outcome.reason
1970
- });
1419
+ if (fingerprint === deviceId) {
1420
+ return { success: true };
1971
1421
  }
1972
- } catch (error) {
1973
- await this._dropSession(connectId, signal);
1974
- throw error;
1975
- } finally {
1976
- if (this._bindingSelectionRequestId === selectionRequestId) {
1977
- this._bindingSelectionRequestId = void 0;
1422
+ return { success: false, expected: deviceId, actual: fingerprint };
1423
+ } catch (err) {
1424
+ const mapped = mapLedgerError(err);
1425
+ if (mapped.code === HardwareErrorCode3.WrongApp || mapped.code === HardwareErrorCode3.DeviceLocked) {
1426
+ return { success: true };
1978
1427
  }
1428
+ throw err;
1979
1429
  }
1980
1430
  }
1981
- async _dropSession(connectId, signal) {
1982
- const sessionId = this._sessions.get(connectId);
1983
- this._sessions.delete(connectId);
1984
- if (!sessionId) return;
1985
- this._sessionTransports.delete(sessionId);
1986
- const teardown = this._runConnectorTeardown(() => this.connector.disconnect(sessionId)).catch(
1987
- () => void 0
1988
- );
1989
- if (!signal.aborted) await teardown;
1990
- }
1991
- /** Verify on the acquired session without re-entering the job queue. */
1992
- async _verifyDeviceFingerprintWithSession(sessionId, deviceId, chain) {
1993
- if (!deviceId) return { success: true };
1994
- const fingerprint = await this._computeChainFingerprint(
1995
- chain,
1996
- (method, params) => this._callConnector(sessionId, method, params)
1997
- );
1998
- if (fingerprint === deviceId) {
1999
- return { success: true };
2000
- }
2001
- return { success: false, expected: deviceId, actual: fingerprint };
2002
- }
2003
1431
  /**
2004
1432
  * Compute the chain fingerprint via a caller-supplied call strategy.
2005
1433
  *
@@ -2027,23 +1455,11 @@ var _LedgerAdapter = class _LedgerAdapter {
2027
1455
  address = (await callMethod("solGetAddress", { path, showOnDevice: false })).address;
2028
1456
  } else if (chain === "tron") {
2029
1457
  address = (await callMethod("tronGetAddress", { path, showOnDevice: false })).address;
2030
- } else if (chain === "zcash") {
2031
- address = (await callMethod("zcashGetShieldedAddress", { path, showOnDevice: false })).address;
2032
1458
  } else {
2033
1459
  throw new Error(`Unsupported chain for fingerprint: ${chain}`);
2034
1460
  }
2035
1461
  return deriveDeviceFingerprint(address);
2036
1462
  }
2037
- /**
2038
- * Operation owning the running job, so a mid-call UI request can name it.
2039
- * Undefined at cold start when no operation owns the job.
2040
- */
2041
- _activeOperationId() {
2042
- const activeJobId = this._jobQueue.getActiveJob()?.deviceId;
2043
- if (!activeJobId) return void 0;
2044
- if (isHardwareOperationId(activeJobId)) return activeJobId;
2045
- return this._operations.findActiveByConnectionKey(activeJobId)?.operationId;
2046
- }
2047
1463
  // Ledger WebUSB won't expose a locked device, so we can't auto-detect unlock.
2048
1464
  // The user must press Confirm after unlocking, which triggers a search retry.
2049
1465
  // If `signal` is provided, an abort cancels the pending UI request so the
@@ -2053,18 +1469,15 @@ var _LedgerAdapter = class _LedgerAdapter {
2053
1469
  if (signal?.aborted) {
2054
1470
  _LedgerAdapter._throwIfAborted(signal);
2055
1471
  }
2056
- const operationId = this._activeOperationId();
2057
1472
  const waitPromise = this._uiRegistry.wait(
2058
- UI_REQUEST.REQUEST_DEVICE_CONNECT,
2059
- { operationId }
1473
+ UI_REQUEST.REQUEST_DEVICE_CONNECT
2060
1474
  );
2061
1475
  this.emitter.emit(UI_REQUEST.REQUEST_DEVICE_CONNECT, {
2062
1476
  type: UI_REQUEST.REQUEST_DEVICE_CONNECT,
2063
1477
  payload: {
2064
1478
  vendor: "ledger",
2065
1479
  reason: "device-not-found",
2066
- message: "Please connect and unlock your Ledger device",
2067
- operationId
1480
+ message: "Please connect and unlock your Ledger device"
2068
1481
  }
2069
1482
  });
2070
1483
  let payload;
@@ -2125,18 +1538,15 @@ var _LedgerAdapter = class _LedgerAdapter {
2125
1538
  return { ...params, showOnDevice: true };
2126
1539
  }
2127
1540
  async _waitForBtcHighIndexConfirm(path, accountIndex) {
2128
- const operationId = this._activeOperationId();
2129
1541
  const waitPromise = this._uiRegistry.wait(
2130
- UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,
2131
- { operationId }
1542
+ UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM
2132
1543
  );
2133
1544
  this.emitter.emit(UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM, {
2134
1545
  type: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,
2135
1546
  payload: {
2136
1547
  vendor: "ledger",
2137
1548
  path,
2138
- accountIndex,
2139
- operationId
1549
+ accountIndex
2140
1550
  }
2141
1551
  });
2142
1552
  try {
@@ -2153,14 +1563,12 @@ var _LedgerAdapter = class _LedgerAdapter {
2153
1563
  // Ask the user whether to install a missing app (autoInstallApp flow).
2154
1564
  // Same register-then-emit ordering as the BTC high-index gate.
2155
1565
  async _waitForInstallAppConfirm(appName) {
2156
- const operationId = this._activeOperationId();
2157
1566
  const waitPromise = this._uiRegistry.wait(
2158
- UI_REQUEST.REQUEST_INSTALL_APP,
2159
- { operationId }
1567
+ UI_REQUEST.REQUEST_INSTALL_APP
2160
1568
  );
2161
1569
  this.emitter.emit(UI_REQUEST.REQUEST_INSTALL_APP, {
2162
1570
  type: UI_REQUEST.REQUEST_INSTALL_APP,
2163
- payload: { vendor: "ledger", appName, operationId }
1571
+ payload: { vendor: "ledger", appName }
2164
1572
  });
2165
1573
  try {
2166
1574
  const payload = await waitPromise;
@@ -2176,17 +1584,16 @@ var _LedgerAdapter = class _LedgerAdapter {
2176
1584
  // Layer 1 entry. Caller signal only races the outer awaiter; the shared
2177
1585
  // `_doConnect` runs under its own internal controller so caller A's cancel
2178
1586
  // doesn't kill caller B's await.
2179
- async ensureConnected(connectId, signal, allowUsbEphemeralFallback = false, preserveOperationId, context) {
1587
+ async ensureConnected(connectId, signal, allowUsbEphemeralFallback = false) {
2180
1588
  if (signal.aborted) _LedgerAdapter._throwIfAborted(signal);
2181
- this._assertConnectorReady("connectDevice");
2182
- if (this._isBleConnection() && !connectId && !allowUsbEphemeralFallback) {
1589
+ if (isLedgerBleConnectionType(this.connector.connectionType) && !connectId) {
2183
1590
  throw Object.assign(new Error("Ledger BLE connectId is required."), {
2184
1591
  code: HardwareErrorCode3.DeviceNotFound
2185
1592
  });
2186
1593
  }
2187
1594
  if (connectId && this._sessions.has(connectId)) return connectId;
2188
1595
  if (!connectId && this._sessions.size > 0) {
2189
- if (!this._isBleConnection() && this._sessions.size > 1) {
1596
+ if (!isLedgerBleConnectionType(this.connector.connectionType) && this._sessions.size > 1) {
2190
1597
  throw Object.assign(
2191
1598
  new Error(
2192
1599
  "Ledger USB session invariant violated: more than one session is active. Please reconnect the device."
@@ -2196,24 +1603,15 @@ var _LedgerAdapter = class _LedgerAdapter {
2196
1603
  }
2197
1604
  return this._sessions.keys().next().value;
2198
1605
  }
2199
- if (!this._connectingPromise || this._doConnectAbortController?.signal.aborted) {
2200
- const controller = new AbortController();
2201
- this._doConnectAbortController = controller;
2202
- const innerSignal = controller.signal;
1606
+ if (!this._connectingPromise) {
1607
+ this._doConnectAbortController = new AbortController();
1608
+ const innerSignal = this._doConnectAbortController.signal;
2203
1609
  this._connectingPromise = (async () => {
2204
1610
  try {
2205
- return await this._doConnect(
2206
- innerSignal,
2207
- connectId,
2208
- allowUsbEphemeralFallback,
2209
- preserveOperationId,
2210
- context
2211
- );
1611
+ return await this._doConnect(innerSignal, connectId, allowUsbEphemeralFallback);
2212
1612
  } finally {
2213
- if (this._doConnectAbortController === controller) {
2214
- this._connectingPromise = null;
2215
- this._doConnectAbortController = null;
2216
- }
1613
+ this._connectingPromise = null;
1614
+ this._doConnectAbortController = null;
2217
1615
  }
2218
1616
  })();
2219
1617
  }
@@ -2222,57 +1620,22 @@ var _LedgerAdapter = class _LedgerAdapter {
2222
1620
  // Layer 1 main loop — the ONLY place in SDK that emits unlock dialog.
2223
1621
  // Bounded by MAX_DOCONNECT_CONFIRMS — after N Confirms with no progress,
2224
1622
  // throw DeviceNotFound so the user is kicked out of the loop.
2225
- async _doConnect(internalSignal, targetConnectId, allowUsbEphemeralFallback = false, preserveOperationId, context) {
2226
- _LedgerAdapter._throwIfAborted(internalSignal);
2227
- if (this.connector.availableTransports?.includes("usb") && this.connector.availableTransports.includes("ble")) {
2228
- this._activeConnectionType = "usb";
2229
- const usbDevices = await this._searchDevices({ transportType: "usb" }, internalSignal);
2230
- _LedgerAdapter._throwIfAborted(internalSignal);
2231
- if (usbDevices.length > 0) {
2232
- const knownUsb = context?.knownConnections?.find(
2233
- (connection) => connection.transport === "usb"
2234
- );
2235
- const usbTarget = knownUsb?.transport === "usb" ? knownUsb.connectId : usbDevices.find((device) => device.connectId === targetConnectId)?.connectId;
2236
- return this._connectFirstOrSelect(
2237
- usbDevices,
2238
- usbTarget,
2239
- allowUsbEphemeralFallback,
2240
- preserveOperationId,
2241
- context,
2242
- internalSignal
2243
- );
2244
- }
2245
- if (context?.supportedTransports && !context.supportedTransports.includes("ble")) {
2246
- throw createHwkError({
2247
- code: HardwareErrorCode3.DeviceNotFound,
2248
- message: "This Ledger model has no Bluetooth transport; connect it over USB"
2249
- });
2250
- }
2251
- this._activeConnectionType = "ble";
2252
- const knownBle = context?.knownConnections?.find(
2253
- (connection) => connection.transport === "ble"
2254
- );
2255
- if (knownBle?.transport === "ble") {
2256
- return this._connectDeviceOrThrow(knownBle.connectId, preserveOperationId, internalSignal);
2257
- }
2258
- if (targetConnectId && context?.knownConnections === void 0) {
2259
- throw createHwkError({
2260
- code: HardwareErrorCode3.DeviceNotFound,
2261
- message: "Ledger connection metadata is required before starting Bluetooth binding"
2262
- });
1623
+ async _doConnect(internalSignal, targetConnectId, allowUsbEphemeralFallback = false) {
1624
+ if (isLedgerBleConnectionType(this.connector.connectionType) && targetConnectId) {
1625
+ try {
1626
+ return await this._connectDeviceOrThrow(targetConnectId);
1627
+ } catch (err) {
1628
+ if (!isDeviceLockedError(err) && !isDeviceNotAdvertisingError(err) && !isDeviceDisconnectedError(err)) {
1629
+ throw err;
1630
+ }
1631
+ this._discoveredDevices.delete(targetConnectId);
1632
+ if (isDeviceDisconnectedError(err)) {
1633
+ try {
1634
+ this.connector.reset?.();
1635
+ } catch {
1636
+ }
1637
+ }
2263
1638
  }
2264
- const bleDevices = await this._searchDevices({ transportType: "ble" }, internalSignal);
2265
- return this._connectFirstOrSelect(
2266
- bleDevices,
2267
- void 0,
2268
- allowUsbEphemeralFallback,
2269
- preserveOperationId,
2270
- context,
2271
- internalSignal
2272
- );
2273
- }
2274
- if (this._isBleConnection() && targetConnectId) {
2275
- return this._connectDeviceOrThrow(targetConnectId, preserveOperationId, internalSignal);
2276
1639
  }
2277
1640
  let confirms = 0;
2278
1641
  while (!internalSignal.aborted) {
@@ -2280,28 +1643,22 @@ var _LedgerAdapter = class _LedgerAdapter {
2280
1643
  type: EConnectorInteraction.Searching,
2281
1644
  payload: { sessionId: "" }
2282
1645
  });
2283
- let devices = await this._searchDevices(void 0, internalSignal);
2284
- _LedgerAdapter._throwIfAborted(internalSignal);
1646
+ let devices = await this.searchDevices();
2285
1647
  if (devices.length === 0) {
2286
1648
  for (let i = 0; i < 3 && !internalSignal.aborted; i += 1) {
2287
1649
  await new Promise((resolve) => {
2288
1650
  setTimeout(resolve, DEVICE_CONNECT_RETRY_DELAY_MS);
2289
1651
  });
2290
- _LedgerAdapter._throwIfAborted(internalSignal);
2291
- devices = await this._searchDevices(void 0, internalSignal);
2292
- _LedgerAdapter._throwIfAborted(internalSignal);
1652
+ devices = await this.searchDevices();
2293
1653
  if (devices.length > 0) break;
2294
1654
  }
2295
1655
  }
2296
- if (devices.length > 0 || this._isBleConnection() && allowUsbEphemeralFallback) {
1656
+ if (devices.length > 0) {
2297
1657
  try {
2298
1658
  return await this._connectFirstOrSelect(
2299
1659
  devices,
2300
1660
  targetConnectId,
2301
- allowUsbEphemeralFallback,
2302
- preserveOperationId,
2303
- context,
2304
- internalSignal
1661
+ allowUsbEphemeralFallback
2305
1662
  );
2306
1663
  } catch (err) {
2307
1664
  if (!isDeviceLockedError(err) && !isDeviceNotAdvertisingError(err) && !isDeviceDisconnectedError(err)) {
@@ -2330,143 +1687,45 @@ var _LedgerAdapter = class _LedgerAdapter {
2330
1687
  _LedgerAdapter._throwIfAborted(internalSignal);
2331
1688
  throw new Error("_doConnect aborted");
2332
1689
  }
2333
- async _connectFirstOrSelect(devices, targetConnectId, allowUsbEphemeralFallback, preserveOperationId, context, signal) {
2334
- _LedgerAdapter._throwIfAborted(signal);
1690
+ async _connectFirstOrSelect(devices, targetConnectId, allowUsbEphemeralFallback = false) {
2335
1691
  if (targetConnectId) {
2336
1692
  const target = devices.find(
2337
1693
  (d) => d.connectId === targetConnectId || d.deviceId === targetConnectId
2338
1694
  );
2339
1695
  if (target) {
2340
- return this._connectDeviceOrThrow(target.connectId, preserveOperationId, signal);
1696
+ return this._connectDeviceOrThrow(target.connectId);
2341
1697
  }
2342
- if (!this._isBleConnection() && devices.length === 1 && allowUsbEphemeralFallback) {
1698
+ if (!isLedgerBleConnectionType(this.connector.connectionType) && devices.length === 1 && allowUsbEphemeralFallback) {
2343
1699
  debugLog(
2344
1700
  `[LedgerAdapter] target ${targetConnectId} not in fresh enumeration; accepting sole USB device ${devices[0].connectId} for fingerprint-verified recovery`
2345
1701
  );
2346
- return this._connectDeviceOrThrow(devices[0].connectId, preserveOperationId, signal);
1702
+ return this._connectDeviceOrThrow(devices[0].connectId);
2347
1703
  }
2348
- if (!this._isBleConnection() || !allowUsbEphemeralFallback) {
2349
- const err = Object.assign(new Error(`Target Ledger unavailable: ${targetConnectId}`), {
2350
- code: HardwareErrorCode3.DeviceNotFound
2351
- });
2352
- if (this._isBleConnection()) {
2353
- err._tag = ERROR_TAG.DeviceNotAdvertising;
2354
- }
2355
- throw err;
1704
+ const err = Object.assign(new Error(`Target Ledger unavailable: ${targetConnectId}`), {
1705
+ code: HardwareErrorCode3.DeviceNotFound
1706
+ });
1707
+ if (isLedgerBleConnectionType(this.connector.connectionType)) {
1708
+ err._tag = ERROR_TAG.DeviceNotAdvertising;
2356
1709
  }
1710
+ throw err;
2357
1711
  }
2358
- const requiresBleSelection = this._isBleConnection();
2359
- if (requiresBleSelection && !allowUsbEphemeralFallback) {
1712
+ if (isLedgerBleConnectionType(this.connector.connectionType)) {
2360
1713
  throw Object.assign(new Error("Ledger BLE connectId is required."), {
2361
1714
  code: HardwareErrorCode3.DeviceNotFound
2362
1715
  });
2363
1716
  }
2364
- if (requiresBleSelection && context?.allowDeviceSelection !== false) {
2365
- const bindingSessionId = context?.bindingSessionId ?? this._uiRegistry.createRequestId();
2366
- if (context) context.bindingSessionId = bindingSessionId;
2367
- const allowUsbFallback = context?.bindingReason !== "manual-rebind" && Boolean(this.connector.availableTransports?.includes("usb"));
2368
- const knownUsb = context?.knownConnections?.find(
2369
- (connection) => connection.transport === "usb"
2370
- );
2371
- const usbConnectId = knownUsb?.transport === "usb" ? knownUsb.connectId : targetConnectId;
2372
- const { device, requestId } = await requestBleDeviceSelection({
2373
- emitter: this.emitter,
2374
- registry: this._uiRegistry,
2375
- signal,
2376
- allowUsbFallback,
2377
- scan: async () => {
2378
- if (allowUsbFallback) {
2379
- const usbDevices = await this._searchDevices({ transportType: "usb" }, signal);
2380
- const candidate = usbDevices.find(
2381
- (device2) => device2.connectionType === "usb" && device2.connectId === usbConnectId
2382
- ) ?? (usbDevices.length === 1 && usbDevices[0].connectionType === "usb" ? usbDevices[0] : void 0);
2383
- if (candidate) return [candidate];
2384
- }
2385
- return this._searchDevices({ transportType: "ble", waitForAllTransports: true }, signal);
2386
- },
2387
- request: {
2388
- devices,
2389
- bindingSessionId,
2390
- context: {
2391
- kind: "bind-connection",
2392
- transport: "ble",
2393
- reason: context?.bindingReason ?? (targetConnectId ? "known-connection-unavailable" : "missing-binding")
2394
- },
2395
- extra: context?.extra,
2396
- operationId: preserveOperationId
2397
- }
2398
- });
2399
- if (device.connectionType === "usb") {
2400
- this._activeConnectionType = "usb";
2401
- if (context) context.selectedConnection = void 0;
2402
- this._bindingSelectionRequestId = requestId;
2403
- this._finishBleBinding("cancelled");
2404
- return this._connectDeviceOrThrow(device.connectId, preserveOperationId, signal);
2405
- }
2406
- this._bindingSelectionRequestId = requestId;
2407
- const connected = await this._connectDeviceOrThrow(
2408
- device.connectId,
2409
- preserveOperationId,
2410
- signal
2411
- );
2412
- if (context) context.selectedConnection = { connectId: connected, requestId };
2413
- await this._saveSelectedBleBinding(
2414
- connected,
2415
- requestId,
2416
- context,
2417
- preserveOperationId,
2418
- signal
2419
- );
2420
- return connected;
2421
- }
2422
- if (devices.length > 0 && (devices.length > 1 || requiresBleSelection)) {
2423
- if (context?.allowDeviceSelection === false || !this.emitter.listenerCount(UI_REQUEST.REQUEST_SELECT_DEVICE)) {
2424
- throw createHwkError({
2425
- code: HardwareErrorCode3.DeviceNotFound,
2426
- message: "Select a Ledger device before continuing"
2427
- });
2428
- }
2429
- const requestId = this._uiRegistry.createRequestId();
2430
- const operationId = this._activeOperationId();
2431
- const waitPromise = this._uiRegistry.wait(
2432
- UI_REQUEST.REQUEST_SELECT_DEVICE,
2433
- { requestId, operationId }
2434
- );
2435
- this.emitter.emit(UI_REQUEST.REQUEST_SELECT_DEVICE, {
2436
- type: UI_REQUEST.REQUEST_SELECT_DEVICE,
2437
- payload: {
2438
- devices,
2439
- requestId,
2440
- operationId,
2441
- context: requiresBleSelection ? {
2442
- kind: "bind-connection",
2443
- transport: "ble",
2444
- reason: targetConnectId ? "known-connection-unavailable" : "missing-binding"
2445
- } : { kind: "select-device", transport: "usb", reason: "multiple-candidates" },
2446
- extra: context?.extra
2447
- }
2448
- });
2449
- const { sdkConnectId } = await this._abortable(signal, waitPromise);
2450
- _LedgerAdapter._throwIfAborted(signal);
2451
- const selected = devices.find((device) => device.connectId === sdkConnectId);
2452
- if (!selected) {
2453
- throw Object.assign(new Error("Selected Ledger is no longer available"), {
2454
- code: HardwareErrorCode3.DeviceNotFound
2455
- });
2456
- }
2457
- if (context && requiresBleSelection)
2458
- context.selectedConnection = { connectId: selected.connectId, requestId };
2459
- return this._connectDeviceOrThrow(selected.connectId, preserveOperationId, signal);
1717
+ if (devices.length > 1) {
1718
+ throw createMultipleUsbLedgerDevicesError();
2460
1719
  }
2461
1720
  if (devices.length !== 1) {
2462
1721
  throw Object.assign(new Error("Ledger device not found."), {
2463
1722
  code: HardwareErrorCode3.DeviceNotFound
2464
1723
  });
2465
1724
  }
2466
- return this._connectDeviceOrThrow(devices[0].connectId, preserveOperationId, signal);
1725
+ return this._connectDeviceOrThrow(devices[0].connectId);
2467
1726
  }
2468
- async _connectDeviceOrThrow(chosenConnectId, preserveOperationId, signal) {
2469
- const result = await this._connectTarget(chosenConnectId, preserveOperationId, signal);
1727
+ async _connectDeviceOrThrow(chosenConnectId) {
1728
+ const result = await this.connectDevice(chosenConnectId);
2470
1729
  if (!result.success) {
2471
1730
  const payload = result.payload;
2472
1731
  const rethrow = Object.assign(new Error(payload.error), {
@@ -2477,7 +1736,7 @@ var _LedgerAdapter = class _LedgerAdapter {
2477
1736
  }
2478
1737
  throw rethrow;
2479
1738
  }
2480
- return result.payload;
1739
+ return chosenConnectId;
2481
1740
  }
2482
1741
  /**
2483
1742
  * Call the connector with automatic session resolution and disconnect retry.
@@ -2507,133 +1766,33 @@ var _LedgerAdapter = class _LedgerAdapter {
2507
1766
  * lives in one place.
2508
1767
  */
2509
1768
  async _callConnector(sessionId, method, params, signal) {
2510
- this._assertConnectorReady(method);
2511
- if (signal?.aborted) throw this._abortReason(signal);
2512
- const releaseOperation = this._retainConnectorOperation(`call:${sessionId}`);
2513
- let promise;
2514
- try {
2515
- promise = this.connector.call(sessionId, method, params).finally(releaseOperation);
2516
- } catch (error) {
2517
- releaseOperation();
2518
- throw error;
2519
- }
1769
+ const promise = this.connector.call(sessionId, method, params);
2520
1770
  const result = signal ? await this._abortable(signal, promise) : await promise;
2521
1771
  return this._unwrapConnectorResult(result);
2522
1772
  }
2523
- _assertConnectorReady(method) {
2524
- if (this._resetPromise || this._pendingConnectorTeardowns > 0 || this._unsettledConnectorOperations.size > 0) {
2525
- throw _LedgerAdapter._createDeviceBusyError(method);
2526
- }
2527
- }
2528
- _runConnectorTeardown(task) {
2529
- const previous = this._connectorTeardownTail;
2530
- let releaseTail = () => void 0;
2531
- this._connectorTeardownTail = new Promise((resolve) => {
2532
- releaseTail = resolve;
2533
- });
2534
- this._pendingConnectorTeardowns += 1;
2535
- return (async () => {
2536
- try {
2537
- await previous;
2538
- await this._waitForConnectorOperationsToDrain();
2539
- await task();
2540
- } finally {
2541
- this._pendingConnectorTeardowns -= 1;
2542
- releaseTail();
2543
- }
2544
- })();
2545
- }
2546
- _waitForConnectorOperationsToDrain() {
2547
- if (this._unsettledConnectorOperations.size === 0) {
2548
- return Promise.resolve();
2549
- }
2550
- return new Promise((resolve) => {
2551
- this._connectorIdleWaiters.add(resolve);
2552
- });
2553
- }
2554
- _retainConnectorOperation(key) {
2555
- this._unsettledConnectorOperations.set(
2556
- key,
2557
- (this._unsettledConnectorOperations.get(key) ?? 0) + 1
2558
- );
2559
- let released = false;
2560
- return () => {
2561
- if (released) return;
2562
- released = true;
2563
- const remaining = (this._unsettledConnectorOperations.get(key) ?? 1) - 1;
2564
- if (remaining > 0) {
2565
- this._unsettledConnectorOperations.set(key, remaining);
2566
- } else {
2567
- this._unsettledConnectorOperations.delete(key);
2568
- }
2569
- if (this._unsettledConnectorOperations.size === 0) {
2570
- for (const resolve of this._connectorIdleWaiters) resolve();
2571
- this._connectorIdleWaiters.clear();
2572
- }
2573
- };
2574
- }
2575
1773
  async connectorCall(connectId, method, params, fingerprint, permissionDeviceId, commonParams, installContext) {
2576
- const positionalOperationId = isHardwareOperationId(connectId) ? connectId : void 0;
2577
- if (positionalOperationId && commonParams?.operationId && positionalOperationId !== commonParams.operationId) {
2578
- throw createHwkError({
2579
- code: HardwareErrorCode3.InvalidParams,
2580
- message: "Conflicting Ledger operation ids",
2581
- params: {
2582
- positionalOperationId,
2583
- commonOperationId: commonParams.operationId
2584
- }
2585
- });
2586
- }
2587
- const operationId = commonParams?.operationId ?? positionalOperationId;
2588
- const operation = operationId ? this._operations.resolve(operationId) : void 0;
2589
- const releaseOperationRetention = operationId ? this._operations.retain(operationId) : void 0;
2590
- const effectiveConnectId = operation?.connectId ?? connectId;
2591
- debugLog("[LedgerAdapter][REQ]", {
2592
- method,
2593
- connectId: effectiveConnectId || "(empty)",
2594
- params
2595
- });
2596
- const queueKey = ledgerQueueKey({ operationId, connectId: effectiveConnectId });
1774
+ debugLog("[LedgerAdapter][REQ]", { method, connectId: connectId || "(empty)", params });
1775
+ const queueKey = connectId || "__ledger_default__";
2597
1776
  try {
2598
1777
  const result = await this._jobQueue.enqueue(
2599
1778
  queueKey,
2600
- async (signal) => {
2601
- if (operationId) this._activeOperationJobs.add(operationId);
2602
- try {
2603
- return await this._runConnectorCall(
2604
- effectiveConnectId,
2605
- method,
2606
- params,
2607
- signal,
2608
- fingerprint,
2609
- permissionDeviceId,
2610
- commonParams,
2611
- installContext ?? {},
2612
- operationId
2613
- );
2614
- } catch (error) {
2615
- this._finishBleBinding(signal.aborted ? "cancelled" : "failed");
2616
- throw error;
2617
- } finally {
2618
- if (operationId) {
2619
- this._activeOperationJobs.delete(operationId);
2620
- if (this._pendingOperationDisconnects.delete(operationId)) {
2621
- await this._releaseLostOperationConnection(operationId);
2622
- }
2623
- }
2624
- }
2625
- },
1779
+ async (signal) => this._runConnectorCall(
1780
+ connectId,
1781
+ method,
1782
+ params,
1783
+ signal,
1784
+ fingerprint,
1785
+ permissionDeviceId,
1786
+ commonParams,
1787
+ installContext
1788
+ ),
2626
1789
  {
2627
1790
  label: method,
2628
1791
  rejectIfBusy: true,
2629
1792
  busyError: _LedgerAdapter._createDeviceBusyError(method)
2630
1793
  }
2631
1794
  );
2632
- debugLog("[LedgerAdapter][RES]", {
2633
- method,
2634
- success: true,
2635
- payload: redactResultForLog(result)
2636
- });
1795
+ debugLog("[LedgerAdapter][RES]", { method, success: true, payload: result });
2637
1796
  return result;
2638
1797
  } catch (err) {
2639
1798
  const e = err;
@@ -2647,22 +1806,15 @@ var _LedgerAdapter = class _LedgerAdapter {
2647
1806
  }
2648
1807
  });
2649
1808
  throw err;
2650
- } finally {
2651
- releaseOperationRetention?.();
2652
1809
  }
2653
1810
  }
2654
- /** Hermes/RN polyfills don't always populate signal.reason; fall back. */
2655
- _abortReason(signal) {
2656
- return signal.reason ?? this._lastCancelReason ?? new Error("Aborted");
2657
- }
2658
1811
  /**
2659
1812
  * Race a promise against an abort signal. On abort, rejects with
2660
1813
  * signal.reason → instance _lastCancelReason → generic Error('Aborted').
2661
1814
  */
2662
1815
  _abortable(signal, promise) {
2663
- const getAbortReason = () => this._abortReason(signal);
1816
+ const getAbortReason = () => signal.reason ?? this._lastCancelReason ?? new Error("Aborted");
2664
1817
  if (signal.aborted) {
2665
- void promise.catch(() => void 0);
2666
1818
  return Promise.reject(getAbortReason());
2667
1819
  }
2668
1820
  return new Promise((resolve, reject) => {
@@ -2689,15 +1841,13 @@ var _LedgerAdapter = class _LedgerAdapter {
2689
1841
  }
2690
1842
  }
2691
1843
  /** Actual work done under the job queue — connection, fingerprint, call, and recovery. */
2692
- async _runConnectorCall(connectId, method, params, signal, fingerprint, permissionDeviceId, commonParams, installContext, operationId, lockedRetryBudget = _LedgerAdapter.MAX_BUSINESS_RETRY_BUDGET) {
1844
+ async _runConnectorCall(connectId, method, params, signal, fingerprint, permissionDeviceId, commonParams, installContext) {
2693
1845
  _LedgerAdapter._throwIfAborted(signal);
2694
- if (!operationId) {
2695
- await this._ensureDevicePermission(
2696
- connectId,
2697
- permissionDeviceId ?? fingerprint?.deviceId,
2698
- signal
2699
- );
2700
- }
1846
+ await this._ensureDevicePermission(
1847
+ connectId,
1848
+ permissionDeviceId ?? fingerprint?.deviceId,
1849
+ signal
1850
+ );
2701
1851
  _LedgerAdapter._throwIfAborted(signal);
2702
1852
  let effectiveParams = params;
2703
1853
  if (method === "btcGetPublicKey") {
@@ -2711,49 +1861,19 @@ var _LedgerAdapter = class _LedgerAdapter {
2711
1861
  effectiveParams = gatedParams;
2712
1862
  }
2713
1863
  const allowUsbEphemeralFallback = !!fingerprint?.deviceId && !fingerprint.skipFingerprint;
2714
- let businessCallStarted = false;
2715
- const selectedBleTarget = connectId ? this._selectedBleReconnectTargets.get(connectId) : void 0;
2716
- const knownTransport = this._isBleConnection() ? "ble" : "usb";
2717
- const hintedConnectId = commonParams?.knownConnections?.find(
2718
- (connection) => connection.transport === knownTransport
2719
- );
2720
- const inputConnectId = hintedConnectId && hintedConnectId.transport !== "qr" ? hintedConnectId.connectId : connectId;
2721
- const preferredConnectId = fingerprint && !fingerprint.skipFingerprint && selectedBleTarget?.chain === fingerprint.chain && selectedBleTarget.fingerprint === fingerprint.deviceId ? selectedBleTarget.connectId : inputConnectId;
2722
- const connectionAttempt = { ...commonParams };
2723
- const bundleConnection = installContext?.connection;
2724
- if (bundleConnection && this._sessions.get(bundleConnection.connectId) !== bundleConnection.sessionId) {
2725
- throw createHwkError({
2726
- code: HardwareErrorCode3.DeviceDisconnected,
2727
- message: "Ledger all-network connection ended"
2728
- });
2729
- }
2730
- const resolvedConnectId = operationId ? this._operations.resolve(operationId).connectId : bundleConnection?.connectId ?? await this.ensureConnected(
2731
- preferredConnectId,
1864
+ const resolvedConnectId = await this.ensureConnected(
1865
+ connectId,
2732
1866
  signal,
2733
- allowUsbEphemeralFallback,
2734
- void 0,
2735
- connectionAttempt
1867
+ allowUsbEphemeralFallback
2736
1868
  );
2737
1869
  const sessionId = this._sessions.get(resolvedConnectId);
2738
- if (sessionId && installContext && !installContext.connection) {
2739
- installContext.connection = { connectId: resolvedConnectId, sessionId };
2740
- }
2741
1870
  if (!sessionId) {
2742
- if (operationId) {
2743
- this._operations.end(operationId, "disconnect");
2744
- throw createHwkError({
2745
- code: HardwareErrorCode3.OperationEnded,
2746
- message: "Ledger operation connection is no longer active",
2747
- params: { operationId, reason: "disconnect" }
2748
- });
2749
- }
2750
1871
  throw Object.assign(new Error("Auto-connect succeeded but no session found"), {
2751
1872
  _tag: ERROR_TAG.DeviceSessionNotFound
2752
1873
  });
2753
1874
  }
2754
1875
  try {
2755
- const isBleSession = this._sessionTransports.get(sessionId) === "ble";
2756
- if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId && !isBleSession) {
1876
+ if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId) {
2757
1877
  const fp = await this._abortable(
2758
1878
  signal,
2759
1879
  this._verifyDeviceFingerprintWithSession(
@@ -2768,33 +1888,9 @@ var _LedgerAdapter = class _LedgerAdapter {
2768
1888
  });
2769
1889
  }
2770
1890
  }
2771
- if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId && !operationId && isBleSession && connectionAttempt.selectedConnection?.connectId === resolvedConnectId) {
2772
- this._selectedBleReconnectTargets.set(connectId, {
2773
- connectId: resolvedConnectId,
2774
- chain: fingerprint.chain,
2775
- fingerprint: fingerprint.deviceId
2776
- });
2777
- }
2778
- businessCallStarted = true;
2779
1891
  return await this._callConnector(sessionId, method, effectiveParams, signal);
2780
1892
  } catch (err) {
2781
1893
  if (signal.aborted) throw err;
2782
- if (isLostConnectionError(err)) {
2783
- this._discoveredDevices.delete(resolvedConnectId);
2784
- if (operationId) await this._releaseLostOperationConnection(operationId);
2785
- else {
2786
- this._sessions.delete(resolvedConnectId);
2787
- await this.connector.disconnect(sessionId).catch(() => void 0);
2788
- }
2789
- const ambiguous = businessCallStarted && !canReplayHardwareMethodAfterTransportFailure(method);
2790
- const interactionParams = operationId ? { operationId, reason: "disconnect" } : void 0;
2791
- throw createHwkError({
2792
- code: operationId ? HardwareErrorCode3.OperationEnded : mapLedgerError(err).code,
2793
- message: "Ledger operation connection was lost; start a new operation",
2794
- params: ambiguous ? operationMayHaveCompletedParams(method, { operationId }) : interactionParams,
2795
- recovery: ambiguous ? { scope: "unknown" } : void 0
2796
- });
2797
- }
2798
1894
  const errObj = err;
2799
1895
  debugLog("[LedgerAdapter] connectorCall error:", method, {
2800
1896
  message: errObj?.message,
@@ -2806,60 +1902,6 @@ var _LedgerAdapter = class _LedgerAdapter {
2806
1902
  isNotAdvertising: isDeviceNotAdvertisingError(err),
2807
1903
  isStuckApp: isStuckAppStateError(err)
2808
1904
  });
2809
- const assertSessionCurrent = (message) => {
2810
- if (this._sessions.get(resolvedConnectId) === sessionId) return;
2811
- throw createHwkError({
2812
- code: operationId ? HardwareErrorCode3.OperationEnded : HardwareErrorCode3.DeviceDisconnected,
2813
- message
2814
- });
2815
- };
2816
- if ((isDeviceLockedError(err) || errObj?.code === HardwareErrorCode3.DeviceLocked) && lockedRetryBudget > 0) {
2817
- await this._waitForDeviceConnect(signal);
2818
- assertSessionCurrent("Ledger connection ended while waiting for unlock");
2819
- return this._runConnectorCall(
2820
- resolvedConnectId,
2821
- method,
2822
- effectiveParams,
2823
- signal,
2824
- fingerprint,
2825
- permissionDeviceId,
2826
- commonParams,
2827
- installContext,
2828
- operationId,
2829
- lockedRetryBudget - 1
2830
- );
2831
- }
2832
- if (businessCallStarted && isStuckAppStateError(err)) {
2833
- await this._sleepAbortable(_LedgerAdapter.STUCK_APP_RETRY_DELAY_MS, signal);
2834
- assertSessionCurrent("Ledger connection ended during the app transition");
2835
- try {
2836
- return await this._callConnector(sessionId, method, effectiveParams, signal);
2837
- } catch (retryErr) {
2838
- if (isStuckAppStateError(retryErr)) throw err;
2839
- if (isLostConnectionError(retryErr)) {
2840
- if (operationId) await this._releaseLostOperationConnection(operationId);
2841
- else {
2842
- this._sessions.delete(resolvedConnectId);
2843
- this._discoveredDevices.delete(resolvedConnectId);
2844
- await this.connector.disconnect(sessionId).catch(() => void 0);
2845
- }
2846
- const ambiguous = !canReplayHardwareMethodAfterTransportFailure(method);
2847
- throw createHwkError({
2848
- code: operationId ? HardwareErrorCode3.OperationEnded : mapLedgerError(retryErr).code,
2849
- message: `Ledger ${method} may have completed before the connection was lost`,
2850
- params: ambiguous ? operationMayHaveCompletedParams(method, { operationId, reason: "disconnect" }) : { operationId, reason: "disconnect" },
2851
- recovery: ambiguous ? { scope: "unknown" } : void 0
2852
- });
2853
- }
2854
- throw retryErr;
2855
- }
2856
- }
2857
- if (!operationId && errObj?.code === HardwareErrorCode3.DeviceMismatch) {
2858
- this._sessions.delete(resolvedConnectId);
2859
- this._discoveredDevices.delete(resolvedConnectId);
2860
- await this.connector.disconnect(sessionId).catch(() => void 0);
2861
- throw err;
2862
- }
2863
1905
  const autoInstallApp = commonParams?.autoInstallApp ?? this._defaultAutoInstallApp;
2864
1906
  const isAppMissing = isAppNotInstalledError(err) || err?.code === HardwareErrorCode3.AppNotInstalled;
2865
1907
  if (autoInstallApp && isAppMissing) {
@@ -2915,14 +1957,157 @@ var _LedgerAdapter = class _LedgerAdapter {
2915
1957
  fingerprint,
2916
1958
  permissionDeviceId,
2917
1959
  commonParams,
2918
- installContext,
2919
- operationId
1960
+ installContext
1961
+ );
1962
+ }
1963
+ }
1964
+ if (isStuckAppStateError(err)) {
1965
+ try {
1966
+ this._sessions.delete(resolvedConnectId);
1967
+ this._discoveredDevices.delete(resolvedConnectId);
1968
+ this.connector.reset?.();
1969
+ } catch {
1970
+ }
1971
+ debugLog(
1972
+ "[LedgerAdapter] stuck-app retry: method=",
1973
+ method,
1974
+ "delayMs=",
1975
+ _LedgerAdapter.STUCK_APP_RETRY_DELAY_MS,
1976
+ "_tag=",
1977
+ err?._tag
1978
+ );
1979
+ try {
1980
+ const retryResult = await this._retryAfterStuckApp(
1981
+ resolvedConnectId,
1982
+ method,
1983
+ effectiveParams,
1984
+ signal,
1985
+ err,
1986
+ fingerprint
1987
+ );
1988
+ debugLog("[LedgerAdapter] stuck-app retry succeeded: method=", method);
1989
+ return retryResult;
1990
+ } catch (retryErr) {
1991
+ if (signal.aborted) throw retryErr;
1992
+ if (isStuckAppStateError(retryErr)) {
1993
+ debugLog("[LedgerAdapter] stuck-app retry exhausted (2nd 6901): method=", method);
1994
+ throw err;
1995
+ }
1996
+ debugLog(
1997
+ "[LedgerAdapter] stuck-app retry threw non-stuck error: method=",
1998
+ method,
1999
+ "retryErrTag=",
2000
+ retryErr?._tag
2920
2001
  );
2002
+ throw retryErr;
2003
+ }
2004
+ }
2005
+ if (isDeviceLockedError(err) || isDeviceNotAdvertisingError(err) || isDeviceDisconnectedError(err)) {
2006
+ let lastErr = err;
2007
+ for (let attempt = 0; attempt < _LedgerAdapter.MAX_BUSINESS_RETRY_BUDGET; attempt += 1) {
2008
+ if (signal.aborted) throw lastErr;
2009
+ try {
2010
+ this._sessions.delete(resolvedConnectId);
2011
+ this._discoveredDevices.delete(resolvedConnectId);
2012
+ if (isDeviceDisconnectedError(lastErr)) {
2013
+ try {
2014
+ this.connector.reset?.();
2015
+ } catch {
2016
+ }
2017
+ }
2018
+ const reConnectId = await this.ensureConnected(
2019
+ resolvedConnectId,
2020
+ signal,
2021
+ allowUsbEphemeralFallback
2022
+ );
2023
+ const reSessionId = this._sessions.get(reConnectId);
2024
+ if (!reSessionId) throw lastErr;
2025
+ if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId) {
2026
+ const fp = await this._abortable(
2027
+ signal,
2028
+ this._verifyDeviceFingerprintWithSession(
2029
+ reSessionId,
2030
+ fingerprint.deviceId,
2031
+ fingerprint.chain
2032
+ )
2033
+ );
2034
+ if (!fp.success) {
2035
+ throw Object.assign(new Error(formatDeviceMismatchError(fp.expected, fp.actual)), {
2036
+ code: HardwareErrorCode3.DeviceMismatch
2037
+ });
2038
+ }
2039
+ }
2040
+ return await this._callConnector(reSessionId, method, effectiveParams, signal);
2041
+ } catch (retryErr) {
2042
+ if (signal.aborted) throw retryErr;
2043
+ lastErr = retryErr;
2044
+ const canRetry = attempt < _LedgerAdapter.MAX_BUSINESS_RETRY_BUDGET - 1 && (isDeviceLockedError(retryErr) || isDeviceNotAdvertisingError(retryErr) || isDeviceDisconnectedError(retryErr));
2045
+ if (!canRetry) {
2046
+ throw retryErr;
2047
+ }
2048
+ }
2921
2049
  }
2050
+ throw lastErr;
2051
+ }
2052
+ if (isTimeoutError(err)) {
2053
+ debugLog("[LedgerAdapter] timeout, retrying with fresh connection...");
2054
+ this._discoveredDevices.delete(resolvedConnectId);
2055
+ return this._retryWithFreshConnection(
2056
+ resolvedConnectId,
2057
+ method,
2058
+ effectiveParams,
2059
+ signal,
2060
+ err,
2061
+ fingerprint
2062
+ );
2063
+ }
2064
+ if (isConnectionLevelError(err)) {
2065
+ debugLog("[LedgerAdapter] connection-level fail-closed reset");
2066
+ this._sessions.delete(resolvedConnectId);
2067
+ this._discoveredDevices.delete(resolvedConnectId);
2068
+ this.connector.reset();
2069
+ const codeNum = err?.code;
2070
+ throw Object.assign(err, {
2071
+ code: codeNum ?? HardwareErrorCode3.DeviceDisconnected
2072
+ });
2922
2073
  }
2923
2074
  throw err;
2924
2075
  }
2925
2076
  }
2077
+ /**
2078
+ * Stuck-app recovery: pause for the device's UI transition, then retry once.
2079
+ *
2080
+ * Caller has already cleared the session + reset connector. We wait so Stax
2081
+ * finishes its post-CloseApp animation, then go through ensureConnected +
2082
+ * fingerprint check + call exactly once. Caller decides what to do on a
2083
+ * second stuck-app hit.
2084
+ */
2085
+ async _retryAfterStuckApp(resolvedConnectId, method, params, signal, originalErr, fingerprint) {
2086
+ await this._sleepAbortable(_LedgerAdapter.STUCK_APP_RETRY_DELAY_MS, signal);
2087
+ const retryConnectId = await this.ensureConnected(
2088
+ resolvedConnectId,
2089
+ signal,
2090
+ !!fingerprint?.deviceId && !fingerprint.skipFingerprint
2091
+ );
2092
+ const retrySessionId = this._sessions.get(retryConnectId);
2093
+ if (!retrySessionId) throw originalErr;
2094
+ if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId) {
2095
+ const fp = await this._abortable(
2096
+ signal,
2097
+ this._verifyDeviceFingerprintWithSession(
2098
+ retrySessionId,
2099
+ fingerprint.deviceId,
2100
+ fingerprint.chain
2101
+ )
2102
+ );
2103
+ if (!fp.success) {
2104
+ throw Object.assign(new Error(formatDeviceMismatchError(fp.expected, fp.actual)), {
2105
+ code: HardwareErrorCode3.DeviceMismatch
2106
+ });
2107
+ }
2108
+ }
2109
+ return this._callConnector(retrySessionId, method, params, signal);
2110
+ }
2926
2111
  _sleepAbortable(ms, signal) {
2927
2112
  return new Promise((resolve, reject) => {
2928
2113
  if (signal.aborted) {
@@ -2941,22 +2126,111 @@ var _LedgerAdapter = class _LedgerAdapter {
2941
2126
  });
2942
2127
  }
2943
2128
  /**
2944
- * Ensure OS-level Bluetooth/USB permission; times out after 60s if the host never
2945
- * replies. Without connectId the request is environment-level, else device-level.
2129
+ * Clear stale session, reconnect, and retry the call.
2130
+ *
2131
+ * Timeout recovery starts with a full connector reset. After an APDU
2132
+ * timeout, DMK/transport state may still emit malformed responses; retrying
2133
+ * on the same DMK can poison the next chain switch.
2134
+ */
2135
+ async _retryWithFreshConnection(targetConnectId, method, params, signal, originalErr, fingerprint) {
2136
+ this.connector.reset();
2137
+ this._sessions.clear();
2138
+ this._discoveredDevices.clear();
2139
+ this._connectingPromise = null;
2140
+ const allowUsbEphemeralFallback = !!fingerprint?.deviceId && !fingerprint.skipFingerprint;
2141
+ const retryConnectId = await this.ensureConnected(
2142
+ targetConnectId,
2143
+ signal,
2144
+ allowUsbEphemeralFallback
2145
+ );
2146
+ const retrySessionId = this._sessions.get(retryConnectId);
2147
+ if (!retrySessionId) {
2148
+ throw originalErr;
2149
+ }
2150
+ try {
2151
+ if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId) {
2152
+ const fp = await this._abortable(
2153
+ signal,
2154
+ this._verifyDeviceFingerprintWithSession(
2155
+ retrySessionId,
2156
+ fingerprint.deviceId,
2157
+ fingerprint.chain
2158
+ )
2159
+ );
2160
+ if (!fp.success) {
2161
+ throw Object.assign(new Error(formatDeviceMismatchError(fp.expected, fp.actual)), {
2162
+ code: HardwareErrorCode3.DeviceMismatch
2163
+ });
2164
+ }
2165
+ }
2166
+ return await this._callConnector(retrySessionId, method, params, signal);
2167
+ } catch (retryErr) {
2168
+ if (signal.aborted) throw retryErr;
2169
+ this.connector.reset();
2170
+ this._sessions.clear();
2171
+ this._discoveredDevices.clear();
2172
+ this._connectingPromise = null;
2173
+ if (!isDeviceDisconnectedError(retryErr) && !isTimeoutError(retryErr)) {
2174
+ throw retryErr;
2175
+ }
2176
+ debugLog(
2177
+ "[LedgerAdapter] fresh-session retry still failed; resetting connector and rebuilding DMK"
2178
+ );
2179
+ this.connector.reset();
2180
+ this._sessions.clear();
2181
+ this._discoveredDevices.clear();
2182
+ this._connectingPromise = null;
2183
+ const finalConnectId = await this.ensureConnected(
2184
+ targetConnectId,
2185
+ signal,
2186
+ allowUsbEphemeralFallback
2187
+ );
2188
+ const finalSessionId = this._sessions.get(finalConnectId);
2189
+ if (!finalSessionId) {
2190
+ throw originalErr;
2191
+ }
2192
+ if (fingerprint && !fingerprint.skipFingerprint && fingerprint.deviceId) {
2193
+ const fp = await this._abortable(
2194
+ signal,
2195
+ this._verifyDeviceFingerprintWithSession(
2196
+ finalSessionId,
2197
+ fingerprint.deviceId,
2198
+ fingerprint.chain
2199
+ )
2200
+ );
2201
+ if (!fp.success) {
2202
+ throw Object.assign(new Error(formatDeviceMismatchError(fp.expected, fp.actual)), {
2203
+ code: HardwareErrorCode3.DeviceMismatch
2204
+ });
2205
+ }
2206
+ }
2207
+ return this._callConnector(finalSessionId, method, params, signal);
2208
+ }
2209
+ }
2210
+ /**
2211
+ * Ensure OS-level device permission (Bluetooth / USB) before proceeding.
2212
+ *
2213
+ * Emits `REQUEST_DEVICE_PERMISSION` and awaits the consumer's
2214
+ * `RECEIVE_DEVICE_PERMISSION` reply (60s budget covers "probe → system
2215
+ * prompt → user tap" plus a generous margin). If the consumer never wires
2216
+ * a handler or never replies, the wait times out and the operation fails
2217
+ * fast so scanners/callers don't hang silently.
2218
+ *
2219
+ * - No connectId (searchDevices): environment-level permission
2220
+ * - With connectId (business methods): device-level permission
2946
2221
  */
2947
2222
  async _ensureDevicePermission(connectId, deviceId, signal) {
2948
2223
  if (signal?.aborted) {
2949
2224
  _LedgerAdapter._throwIfAborted(signal);
2950
2225
  }
2951
2226
  const transportType = this.activeTransport ?? "hid";
2952
- const operationId = this._activeOperationId();
2953
2227
  const waitPromise = this._uiRegistry.wait(
2954
2228
  UI_REQUEST.REQUEST_DEVICE_PERMISSION,
2955
- { timeoutMs: 6e4, operationId }
2229
+ { timeoutMs: 6e4 }
2956
2230
  );
2957
2231
  this.emitter.emit(UI_REQUEST.REQUEST_DEVICE_PERMISSION, {
2958
2232
  type: UI_REQUEST.REQUEST_DEVICE_PERMISSION,
2959
- payload: { transportType, connectId, deviceId, operationId }
2233
+ payload: { transportType, connectId, deviceId }
2960
2234
  });
2961
2235
  let response;
2962
2236
  const onAbort = () => {
@@ -3002,15 +2276,7 @@ var _LedgerAdapter = class _LedgerAdapter {
3002
2276
  if (err && typeof err === "object" && "code" in err && typeof err.code === "number") {
3003
2277
  const e = err;
3004
2278
  const params = e.code === HardwareErrorCode3.DevicePermissionDenied && e.reason ? { permissionDeniedReason: e.reason } : e.params;
3005
- return ledgerFailure(
3006
- e.code,
3007
- e.message ?? "Unknown error",
3008
- e.appName,
3009
- tag,
3010
- params,
3011
- void 0,
3012
- isHwkRecoveryHint(e.recovery) ? e.recovery : void 0
3013
- );
2279
+ return ledgerFailure(e.code, e.message ?? "Unknown error", e.appName, tag, params);
3014
2280
  }
3015
2281
  const mapped = mapLedgerError(err);
3016
2282
  return ledgerFailure(mapped.code, mapped.message, mapped.appName, tag);
@@ -3037,7 +2303,7 @@ var _LedgerAdapter = class _LedgerAdapter {
3037
2303
  deviceId: device.deviceId,
3038
2304
  connectId: device.connectId,
3039
2305
  label: device.name,
3040
- connectionType: device.connectionType ?? this.connector.connectionType,
2306
+ connectionType: this.connector.connectionType,
3041
2307
  rssi: device.rssi,
3042
2308
  isConnectable: device.isConnectable,
3043
2309
  serialNumber: device.serialNumber,
@@ -3063,8 +2329,8 @@ var LedgerAdapter = _LedgerAdapter;
3063
2329
 
3064
2330
  // src/connector/LedgerConnectorBase.ts
3065
2331
  import {
3066
- EConnectorInteraction as EConnectorInteraction3,
3067
- HardwareErrorCode as HardwareErrorCode7,
2332
+ EConnectorInteraction as EConnectorInteraction4,
2333
+ HardwareErrorCode as HardwareErrorCode8,
3068
2334
  isKnownNonTargetHardwareVendor,
3069
2335
  serializeConnectorError
3070
2336
  } from "@onekeyfe/hwk-adapter-core";
@@ -3337,7 +2603,7 @@ var LedgerDeviceManager = class {
3337
2603
 
3338
2604
  // src/signer/SignerManager.ts
3339
2605
  import { SignerEthBuilder } from "@ledgerhq/device-signer-kit-ethereum";
3340
- import { ContextModuleBuilder, ContextModuleChainID } from "@ledgerhq/context-module";
2606
+ import { ContextModuleBuilder } from "@ledgerhq/context-module";
3341
2607
 
3342
2608
  // src/signer/SignerEth.ts
3343
2609
  import { hexToBytes } from "@onekeyfe/hwk-adapter-core";
@@ -3603,7 +2869,7 @@ var SignerManager = class _SignerManager {
3603
2869
  return (args) => new SignerEthBuilder(args);
3604
2870
  }
3605
2871
  static _createContextModule() {
3606
- const contextModule = new ContextModuleBuilder({}).setChain(ContextModuleChainID.Ethereum).removeDefaultLoaders().build();
2872
+ const contextModule = new ContextModuleBuilder({}).removeDefaultLoaders().build();
3607
2873
  return _SignerManager.wrapBlindSigningReportNonBlocking(contextModule);
3608
2874
  }
3609
2875
  static wrapBlindSigningReportNonBlocking(contextModule) {
@@ -3641,27 +2907,6 @@ function collapseSignerInteraction(interaction) {
3641
2907
  return EConnectorInteraction2.ConfirmOnDevice;
3642
2908
  }
3643
2909
  }
3644
- function wireSignerToSession(ctx, sessionId, chain, signer) {
3645
- signer.onInteraction = (interaction) => {
3646
- debugLog(`[LedgerConnector] ${chain}.onInteraction:`, interaction);
3647
- ctx.emit("ui-event", {
3648
- type: collapseSignerInteraction(interaction),
3649
- payload: { sessionId }
3650
- });
3651
- };
3652
- signer.onRegisterCanceller = (cancel) => ctx.registerCanceller(sessionId, cancel);
3653
- return signer;
3654
- }
3655
- async function runSignerCall(ctx, sessionId, call) {
3656
- try {
3657
- return await call();
3658
- } catch (err) {
3659
- ctx.invalidateSession(sessionId);
3660
- throw ctx.wrapError(err);
3661
- } finally {
3662
- ctx.clearCanceller(sessionId);
3663
- }
3664
- }
3665
2910
 
3666
2911
  // src/connector/chains/evm.ts
3667
2912
  async function evmGetAddress(ctx, sessionId, params) {
@@ -4094,8 +3339,7 @@ function _applySignaturesToPsbt(psbtHex, signatures) {
4094
3339
  }
4095
3340
 
4096
3341
  // src/connector/chains/sol.ts
4097
- import { bytesToHex, hexToBytes as hexToBytes3, prepareSolanaOffchainMessageV1 } from "@onekeyfe/hwk-adapter-core";
4098
- import bs58 from "bs58";
3342
+ import { bytesToHex, hexToBytes as hexToBytes3 } from "@onekeyfe/hwk-adapter-core";
4099
3343
 
4100
3344
  // src/signer/SignerSol.ts
4101
3345
  var SignerSol = class {
@@ -4179,21 +3423,8 @@ async function solSignMessage(ctx, sessionId, params) {
4179
3423
  const path = normalizePath(params.path);
4180
3424
  const messageBytes = hexToBytes3(params.message);
4181
3425
  try {
4182
- if (params.messageVersion === 1) {
4183
- const preparedMessage = prepareSolanaOffchainMessageV1({
4184
- message: messageBytes,
4185
- requiredSigners: params.requiredSigners
4186
- });
4187
- const { SignMessageVersion } = await ctx.importLedgerKit(
4188
- "@ledgerhq/device-signer-kit-solana"
4189
- );
4190
- const result2 = await solSigner.signMessage(path, preparedMessage.serializedMessage, {
4191
- version: SignMessageVersion.Raw
4192
- });
4193
- return { signature: decodeBase58Signature(result2.signature) };
4194
- }
4195
3426
  const result = await solSigner.signMessage(path, messageBytes);
4196
- return { signature: decodeBase58EnvelopeSignature(result.signature) };
3427
+ return { signature: result.signature };
4197
3428
  } catch (err) {
4198
3429
  ctx.invalidateSession(sessionId);
4199
3430
  throw ctx.wrapError(err);
@@ -4201,27 +3432,11 @@ async function solSignMessage(ctx, sessionId, params) {
4201
3432
  ctx.clearCanceller(sessionId);
4202
3433
  }
4203
3434
  }
4204
- function decodeBase58Signature(signature) {
4205
- const bytes = bs58.decode(signature);
4206
- if (bytes.length !== 64) {
4207
- throw new Error(`Ledger Solana signature must be 64 bytes, received ${bytes.length}`);
4208
- }
4209
- return bytesToHex(bytes);
4210
- }
4211
- function decodeBase58EnvelopeSignature(envelope) {
4212
- const bytes = bs58.decode(envelope);
4213
- if (bytes.length < 65 || bytes[0] !== 1) {
4214
- throw new Error("Ledger Solana signature envelope is invalid");
4215
- }
4216
- return bytesToHex(bytes.subarray(1, 65));
4217
- }
4218
3435
  async function _createSolSigner(ctx, sessionId) {
4219
3436
  const dmk = await ctx.getOrCreateDmk();
4220
- const { ContextModuleBuilder: ContextModuleBuilder2, ContextModuleChainID: ContextModuleChainID2 } = await ctx.importLedgerKit(
4221
- "@ledgerhq/context-module"
4222
- );
3437
+ const { ContextModuleBuilder: ContextModuleBuilder2 } = await ctx.importLedgerKit("@ledgerhq/context-module");
4223
3438
  const { SignerSolanaBuilder } = await ctx.importLedgerKit("@ledgerhq/device-signer-kit-solana");
4224
- const contextModule = new ContextModuleBuilder2({}).setChain(ContextModuleChainID2.Solana).removeDefaultLoaders().build();
3439
+ const contextModule = new ContextModuleBuilder2({}).removeDefaultLoaders().build();
4225
3440
  const sdkSigner = new SignerSolanaBuilder({ dmk, sessionId }).withContextModule(contextModule).build();
4226
3441
  const signer = new SignerSol(sdkSigner);
4227
3442
  signer.onInteraction = (interaction) => {
@@ -4237,147 +3452,361 @@ async function _createSolSigner(ctx, sessionId) {
4237
3452
  return signer;
4238
3453
  }
4239
3454
 
4240
- // src/connector/chains/zcash.ts
4241
- import { bytesToHex as bytesToHex2 } from "@onekeyfe/hwk-adapter-core";
3455
+ // src/connector/chains/tron.ts
3456
+ import { HardwareErrorCode as HardwareErrorCode7 } from "@onekeyfe/hwk-adapter-core";
3457
+ import Trx from "@ledgerhq/hw-app-trx";
4242
3458
 
4243
- // src/signer/SignerZcash.ts
4244
- var SignerZcash = class {
4245
- // eslint-disable-next-line no-useless-constructor, no-empty-function
4246
- constructor(_sdk) {
4247
- this._sdk = _sdk;
3459
+ // src/connector/chains/legacyChainCall.ts
3460
+ import { EConnectorInteraction as EConnectorInteraction3 } from "@onekeyfe/hwk-adapter-core";
3461
+
3462
+ // src/app/AppManager.ts
3463
+ import {
3464
+ CloseAppCommand,
3465
+ GetAppAndVersionCommand,
3466
+ OpenAppCommand,
3467
+ isSuccessCommandResult
3468
+ } from "@ledgerhq/device-management-kit";
3469
+ import { HardwareErrorCode as HardwareErrorCode6 } from "@onekeyfe/hwk-adapter-core";
3470
+ var APP_NAME_MAP = {
3471
+ ETH: "Ethereum",
3472
+ BTC: "Bitcoin",
3473
+ SOL: "Solana",
3474
+ TRX: "Tron",
3475
+ XRP: "XRP",
3476
+ ADA: "Cardano",
3477
+ DOT: "Polkadot",
3478
+ ATOM: "Cosmos"
3479
+ };
3480
+ var DASHBOARD_APP_NAME = "BOLOS";
3481
+ var AppManager = class {
3482
+ constructor(dmk, options) {
3483
+ this._dmk = dmk;
3484
+ this._waitMs = options?.waitMs ?? 1e3;
3485
+ this._maxRetries = options?.maxRetries ?? 10;
4248
3486
  }
4249
- /** GET_VK: UFVK string (default) or raw 96-byte Orchard FVK. */
4250
- async getFullViewingKey(derivationPath, options) {
4251
- const action = this._sdk.getFullViewingKey(derivationPath, options);
4252
- return deviceActionToPromise(
4253
- action,
4254
- this.onInteraction,
4255
- void 0,
4256
- this.onRegisterCanceller
3487
+ /**
3488
+ * Return the Ledger app name for a given chain ticker,
3489
+ * or undefined if the chain is not supported.
3490
+ */
3491
+ static getAppName(chain) {
3492
+ return APP_NAME_MAP[chain];
3493
+ }
3494
+ /**
3495
+ * Ensure the target app is open on the device identified by `sessionId`.
3496
+ *
3497
+ * Flow:
3498
+ * 1. Check the currently running app.
3499
+ * 2. If it is already the target, return immediately.
3500
+ * 3. If a different app is running (not dashboard), close it first.
3501
+ * 4. Open the target app.
3502
+ * 5. Poll until the device confirms the target app is running.
3503
+ */
3504
+ /**
3505
+ * @param onConfirmOnDevice Called BEFORE OpenAppCommand is issued — the
3506
+ * device is about to display "Open <app>" on screen and wait for the
3507
+ * user's button press. UI consumers should show their "open app" prompt
3508
+ * in response. NOT called when the target app is already open (no user
3509
+ * interaction needed in that case).
3510
+ *
3511
+ * Important: OpenAppCommand is blocking. It does not resolve until the user
3512
+ * has physically confirmed on the device, so anything that runs AFTER
3513
+ * `await this._openApp(...)` lands AFTER the prompt is already gone.
3514
+ * Hence the callback must fire BEFORE that await.
3515
+ */
3516
+ async ensureAppOpen(sessionId, targetAppName, onConfirmOnDevice) {
3517
+ const currentApp = await this._getCurrentApp(sessionId);
3518
+ if (currentApp === targetAppName) {
3519
+ return;
3520
+ }
3521
+ if (!this._isDashboard(currentApp)) {
3522
+ await this._closeCurrentApp(sessionId);
3523
+ await this._waitForApp(sessionId, DASHBOARD_APP_NAME);
3524
+ }
3525
+ onConfirmOnDevice?.();
3526
+ await this._openApp(sessionId, targetAppName);
3527
+ await this._waitForApp(sessionId, targetAppName);
3528
+ }
3529
+ // ---------------------------------------------------------------------------
3530
+ // Private helpers
3531
+ // ---------------------------------------------------------------------------
3532
+ async _getCurrentApp(sessionId) {
3533
+ const result = await this._dmk.sendCommand({
3534
+ sessionId,
3535
+ command: new GetAppAndVersionCommand()
3536
+ });
3537
+ if (isSuccessCommandResult(result)) {
3538
+ debugLog("[AppManager] currentApp:", result.data.name);
3539
+ return result.data.name;
3540
+ }
3541
+ const errResult = result;
3542
+ const dmkErr = errResult.error ?? {};
3543
+ const original = dmkErr.originalError;
3544
+ debugLog(
3545
+ "[AppManager] _getCurrentApp failed sessionId=",
3546
+ sessionId,
3547
+ "tag=",
3548
+ dmkErr._tag,
3549
+ "errorCode=",
3550
+ dmkErr.errorCode,
3551
+ "message=",
3552
+ dmkErr.message,
3553
+ "originalErrorMessage=",
3554
+ original?.message ?? String(original ?? "")
3555
+ );
3556
+ throw Object.assign(
3557
+ new Error(
3558
+ dmkErr.message ?? "Failed to get current app from device"
3559
+ ),
3560
+ {
3561
+ _tag: dmkErr._tag,
3562
+ errorCode: dmkErr.errorCode,
3563
+ originalError: original
3564
+ }
4257
3565
  );
4258
3566
  }
4259
- /** GET_SHIELDED_ADDRESS: single-Orchard-receiver UA for a 5-level transparent path. */
4260
- async getShieldedAddress(derivationPath, options) {
4261
- const action = this._sdk.getShieldedAddress(derivationPath, options);
4262
- return deviceActionToPromise(
4263
- action,
4264
- this.onInteraction,
4265
- void 0,
4266
- this.onRegisterCanceller
3567
+ async _openApp(sessionId, appName) {
3568
+ const result = await this._dmk.sendCommand({
3569
+ sessionId,
3570
+ command: new OpenAppCommand({ appName })
3571
+ });
3572
+ if (!isSuccessCommandResult(result)) {
3573
+ const dmkErr = result.error;
3574
+ const errorCode = "errorCode" in dmkErr && dmkErr.errorCode != null ? String(dmkErr.errorCode) : "";
3575
+ const message = "message" in dmkErr && typeof dmkErr.message === "string" ? dmkErr.message : "";
3576
+ debugLog(
3577
+ "[AppManager] openApp failed:",
3578
+ appName,
3579
+ "errorCode:",
3580
+ errorCode,
3581
+ "tag:",
3582
+ dmkErr._tag
3583
+ );
3584
+ let code;
3585
+ if (errorCode === "6807" || /unknown application/i.test(message)) {
3586
+ code = HardwareErrorCode6.AppNotInstalled;
3587
+ } else if (errorCode === "5501" || dmkErr._tag === "ActionRefusedError") {
3588
+ code = HardwareErrorCode6.UserRejected;
3589
+ }
3590
+ throw Object.assign(new Error(`Failed to open "${appName}"`), {
3591
+ _tag: ERROR_TAG.OpenAppCommand,
3592
+ code,
3593
+ errorCode,
3594
+ statusCode: errorCode,
3595
+ appName,
3596
+ originalError: dmkErr
3597
+ });
3598
+ }
3599
+ }
3600
+ async _closeCurrentApp(sessionId) {
3601
+ debugLog("[AppManager] closeCurrentApp");
3602
+ await this._dmk.sendCommand({
3603
+ sessionId,
3604
+ command: new CloseAppCommand()
3605
+ });
3606
+ }
3607
+ /**
3608
+ * Poll the device until the expected app is reported as running,
3609
+ * or throw after `_maxRetries` attempts.
3610
+ */
3611
+ async _waitForApp(sessionId, expectedAppName) {
3612
+ let lastSeen = "";
3613
+ for (let i = 0; i < this._maxRetries; i++) {
3614
+ await this._wait();
3615
+ const current = await this._getCurrentApp(sessionId);
3616
+ lastSeen = current;
3617
+ if (current === expectedAppName) {
3618
+ return;
3619
+ }
3620
+ }
3621
+ debugLog(
3622
+ "[AppManager] waitForApp exhausted: expected=",
3623
+ expectedAppName,
3624
+ "lastSeen=",
3625
+ lastSeen
3626
+ );
3627
+ throw new Error(
3628
+ `Ledger: failed to open "${expectedAppName}" after ${this._maxRetries} retries (last seen: ${lastSeen})`
4267
3629
  );
4268
3630
  }
3631
+ _isDashboard(appName) {
3632
+ return appName === DASHBOARD_APP_NAME;
3633
+ }
3634
+ _wait() {
3635
+ return new Promise((resolve) => setTimeout(resolve, this._waitMs));
3636
+ }
4269
3637
  };
4270
3638
 
4271
- // src/connector/chains/zcash.ts
4272
- async function zcashGetFullViewingKey(ctx, sessionId, params) {
4273
- const signer = await _createZcashSigner(ctx, sessionId);
4274
- const path = normalizePath(params.path);
4275
- const mode = params.mode ?? "ufvk";
4276
- return runSignerCall(ctx, sessionId, async () => {
4277
- const result = await signer.getFullViewingKey(path, { mode });
4278
- if (result.mode === "ufvk") {
4279
- return { path: params.path, mode, ufvk: result.fullViewingKey };
4280
- }
4281
- return { path: params.path, mode, orchardFvk: bytesToHex2(result.fullViewingKey) };
4282
- });
3639
+ // src/connector/chains/legacyChainCall.ts
3640
+ function isLegacyWrongAppError(err, _appName) {
3641
+ return isWrongAppError(err);
4283
3642
  }
4284
- async function zcashGetShieldedAddress(ctx, sessionId, params) {
4285
- const signer = await _createZcashSigner(ctx, sessionId);
4286
- const path = normalizePath(params.path);
4287
- return runSignerCall(ctx, sessionId, async () => {
4288
- const result = await signer.getShieldedAddress(path, {
4289
- checkOnDevice: params.showOnDevice ?? false
3643
+ async function withLegacyChainCall(ctx, sessionId, options, action) {
3644
+ const { appName, needsConfirmation } = options;
3645
+ let openAppPromptShown = false;
3646
+ const onAppOpenPrompt = () => {
3647
+ openAppPromptShown = true;
3648
+ ctx.emit("ui-event", {
3649
+ type: EConnectorInteraction3.ConfirmOpenApp,
3650
+ payload: { sessionId }
4290
3651
  });
4291
- return { address: result.address, path: params.path };
4292
- });
3652
+ };
3653
+ const closeOpenAppUiIfShown = () => {
3654
+ if (openAppPromptShown) {
3655
+ ctx.emit("ui-event", {
3656
+ type: EConnectorInteraction3.InteractionComplete,
3657
+ payload: { sessionId }
3658
+ });
3659
+ openAppPromptShown = false;
3660
+ }
3661
+ };
3662
+ try {
3663
+ await _ensureAppOpen(ctx, sessionId, appName, onAppOpenPrompt);
3664
+ } catch (err) {
3665
+ debugLog(
3666
+ "[LegacyChainCall] pre-flight ensureAppOpen failed:",
3667
+ appName,
3668
+ err?.message
3669
+ );
3670
+ closeOpenAppUiIfShown();
3671
+ throw ctx.wrapError(err, { defaultAppName: appName });
3672
+ }
3673
+ const runOnce = async () => {
3674
+ let confirmEmitted = false;
3675
+ if (needsConfirmation) {
3676
+ ctx.emit("ui-event", {
3677
+ type: EConnectorInteraction3.ConfirmOnDevice,
3678
+ payload: { sessionId }
3679
+ });
3680
+ confirmEmitted = true;
3681
+ }
3682
+ try {
3683
+ return await action(sessionId);
3684
+ } finally {
3685
+ if (confirmEmitted || openAppPromptShown) {
3686
+ ctx.emit("ui-event", {
3687
+ type: EConnectorInteraction3.InteractionComplete,
3688
+ payload: { sessionId }
3689
+ });
3690
+ openAppPromptShown = false;
3691
+ }
3692
+ }
3693
+ };
3694
+ try {
3695
+ return await runOnce();
3696
+ } catch (err) {
3697
+ if (!isLegacyWrongAppError(err, appName)) {
3698
+ debugLog("[LegacyChainCall] non-wrong-app failure:", appName, err?.message);
3699
+ ctx.invalidateSession(sessionId);
3700
+ throw ctx.wrapError(err, { defaultAppName: appName });
3701
+ }
3702
+ debugLog("[LegacyChainCall] wrong-app detected, retrying:", appName);
3703
+ try {
3704
+ await _ensureAppOpen(ctx, sessionId, appName, onAppOpenPrompt);
3705
+ } catch (switchErr) {
3706
+ debugLog(
3707
+ "[LegacyChainCall] retry ensureAppOpen failed:",
3708
+ appName,
3709
+ switchErr?.message
3710
+ );
3711
+ closeOpenAppUiIfShown();
3712
+ throw ctx.wrapError(switchErr, { defaultAppName: appName });
3713
+ }
3714
+ ctx.clearAllSigners();
3715
+ const result = await runOnce();
3716
+ debugLog("[LegacyChainCall] retry succeeded:", appName);
3717
+ return result;
3718
+ }
4293
3719
  }
4294
- async function _createZcashSigner(ctx, sessionId) {
3720
+ async function _ensureAppOpen(ctx, sessionId, appName, onPrompt) {
4295
3721
  const dmk = await ctx.getOrCreateDmk();
4296
- const { SignerZcashBuilder } = await ctx.importLedgerKit("@ledgerhq/device-signer-kit-zcash");
4297
- const sdkSigner = new SignerZcashBuilder({ dmk, sessionId }).build();
4298
- return wireSignerToSession(ctx, sessionId, "zcash", new SignerZcash(sdkSigner));
3722
+ const appManager = new AppManager(dmk);
3723
+ await appManager.ensureAppOpen(sessionId, appName, onPrompt);
4299
3724
  }
4300
3725
 
4301
- // src/connector/chains/tron.ts
4302
- import { HardwareErrorCode as HardwareErrorCode6, bytesToHex as bytesToHex3, hexToBytes as hexToBytes4 } from "@onekeyfe/hwk-adapter-core";
4303
-
4304
- // src/signer/SignerTron.ts
4305
- var SignerTron = class {
4306
- // eslint-disable-next-line no-useless-constructor, no-empty-function
4307
- constructor(_sdk) {
4308
- this._sdk = _sdk;
4309
- }
4310
- /** Base58 Tron address plus the uncompressed public key at `derivationPath`. */
4311
- async getAddress(derivationPath, options) {
4312
- const action = this._sdk.getAddress(derivationPath, options);
4313
- const result = await deviceActionToPromise(
4314
- action,
4315
- this.onInteraction,
4316
- void 0,
4317
- this.onRegisterCanceller
4318
- );
4319
- return { address: result.address, publicKey: result.publicKey };
3726
+ // src/transport/DmkTransport.ts
3727
+ import Transport from "@ledgerhq/hw-transport";
3728
+ var DmkTransport = class extends Transport {
3729
+ constructor(dmk, sessionId) {
3730
+ super();
3731
+ this._dmk = dmk;
3732
+ this._sessionId = sessionId;
4320
3733
  }
4321
- /** Sign a protobuf-encoded raw transaction. */
4322
- async signTransaction(derivationPath, transaction, options) {
4323
- const action = this._sdk.signTransaction(derivationPath, transaction, options);
4324
- return deviceActionToPromise(
4325
- action,
4326
- this.onInteraction,
4327
- void 0,
4328
- this.onRegisterCanceller
4329
- );
3734
+ async exchange(apdu) {
3735
+ const response = await this._dmk.sendApdu({
3736
+ sessionId: this._sessionId,
3737
+ apdu: new Uint8Array(apdu)
3738
+ });
3739
+ const { data, statusCode } = response;
3740
+ const result = Buffer.alloc(data.length + 2);
3741
+ if (data.length > 0) {
3742
+ result.set(data, 0);
3743
+ }
3744
+ result.set(statusCode, data.length);
3745
+ return result;
4330
3746
  }
4331
- /** Sign a personal message (TIP-191). */
4332
- async signPersonalMessage(derivationPath, message, options) {
4333
- const action = this._sdk.signPersonalMessage(derivationPath, message, options);
4334
- return deviceActionToPromise(
4335
- action,
4336
- this.onInteraction,
4337
- void 0,
4338
- this.onRegisterCanceller
4339
- );
3747
+ async close() {
4340
3748
  }
4341
3749
  };
4342
3750
 
4343
3751
  // src/connector/chains/tron.ts
4344
3752
  async function tronGetAddress(ctx, sessionId, params) {
4345
- const tronSigner = await _createTronSigner(ctx, sessionId);
4346
3753
  const path = normalizePath(params.path);
4347
- return runSignerCall(ctx, sessionId, async () => {
4348
- const result = await tronSigner.getAddress(path, {
4349
- checkOnDevice: params.showOnDevice ?? false
4350
- });
4351
- return { address: result.address, publicKey: result.publicKey, path: params.path };
4352
- });
3754
+ const showOnDevice = params.showOnDevice ?? false;
3755
+ return withLegacyChainCall(
3756
+ ctx,
3757
+ sessionId,
3758
+ {
3759
+ appName: "Tron",
3760
+ // Only show "confirm on device" UI when the device is actually going
3761
+ // to display the address for the user to verify.
3762
+ needsConfirmation: showOnDevice
3763
+ },
3764
+ async (sid) => {
3765
+ const trx = await _createTrx(ctx, sid);
3766
+ const result = await trx.getAddress(path, showOnDevice);
3767
+ return { address: result.address, publicKey: result.publicKey, path: params.path };
3768
+ }
3769
+ );
4353
3770
  }
4354
3771
  async function tronSignTransaction(ctx, sessionId, params) {
4355
3772
  if (!params.rawTxHex) {
4356
3773
  throw Object.assign(
4357
3774
  new Error("TRON signing requires a protobuf-encoded raw transaction hex (rawTxHex)."),
4358
- { code: HardwareErrorCode6.InvalidParams }
3775
+ { code: HardwareErrorCode7.InvalidParams }
4359
3776
  );
4360
3777
  }
4361
- const tronSigner = await _createTronSigner(ctx, sessionId);
4362
3778
  const path = normalizePath(params.path);
4363
- return runSignerCall(ctx, sessionId, async () => {
4364
- const signature = await tronSigner.signTransaction(path, hexToBytes4(params.rawTxHex));
4365
- return { signature: bytesToHex3(signature) };
4366
- });
3779
+ return withLegacyChainCall(
3780
+ ctx,
3781
+ sessionId,
3782
+ { appName: "Tron", needsConfirmation: true },
3783
+ async (sid) => {
3784
+ const trx = await _createTrx(ctx, sid);
3785
+ const signature = await trx.signTransaction(
3786
+ path,
3787
+ params.rawTxHex,
3788
+ params.tokenSignatures ?? []
3789
+ );
3790
+ return { signature };
3791
+ }
3792
+ );
4367
3793
  }
4368
3794
  async function tronSignMessage(ctx, sessionId, params) {
4369
- const tronSigner = await _createTronSigner(ctx, sessionId);
4370
3795
  const path = normalizePath(params.path);
4371
- return runSignerCall(ctx, sessionId, async () => {
4372
- const signature = await tronSigner.signPersonalMessage(path, hexToBytes4(params.messageHex));
4373
- return { signature: bytesToHex3(signature) };
4374
- });
3796
+ return withLegacyChainCall(
3797
+ ctx,
3798
+ sessionId,
3799
+ { appName: "Tron", needsConfirmation: true },
3800
+ async (sid) => {
3801
+ const trx = await _createTrx(ctx, sid);
3802
+ const signature = await trx.signPersonalMessage(path, params.messageHex);
3803
+ return { signature };
3804
+ }
3805
+ );
4375
3806
  }
4376
- async function _createTronSigner(ctx, sessionId) {
3807
+ async function _createTrx(ctx, sessionId) {
4377
3808
  const dmk = await ctx.getOrCreateDmk();
4378
- const { SignerTrxBuilder } = await ctx.importLedgerKit("@ledgerhq/device-signer-kit-tron");
4379
- const sdkSigner = new SignerTrxBuilder({ dmk, sessionId }).build();
4380
- return wireSignerToSession(ctx, sessionId, "tron", new SignerTron(sdkSigner));
3809
+ return new Trx(new DmkTransport(dmk, sessionId));
4381
3810
  }
4382
3811
 
4383
3812
  // src/device-apps/customActions.ts
@@ -4556,7 +3985,7 @@ var DeviceApps = class {
4556
3985
  seTargetId: v.seTargetId,
4557
3986
  mcuTargetId: v.mcuTargetId,
4558
3987
  seVersion: v.seVersion,
4559
- seFlagsHex: bytesToHex4(v.seFlags),
3988
+ seFlagsHex: bytesToHex2(v.seFlags),
4560
3989
  mcuSephVersion: v.mcuSephVersion,
4561
3990
  mcuBootloaderVersion: v.mcuBootloaderVersion,
4562
3991
  hwVersion: v.hwVersion
@@ -4630,7 +4059,7 @@ var DeviceApps = class {
4630
4059
  }
4631
4060
  }
4632
4061
  };
4633
- function bytesToHex4(bytes) {
4062
+ function bytesToHex2(bytes) {
4634
4063
  if (!bytes) return "";
4635
4064
  return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
4636
4065
  }
@@ -4673,11 +4102,10 @@ var METHOD_PREFIX_TO_APP_NAME = {
4673
4102
  evm: "Ethereum",
4674
4103
  btc: "Bitcoin",
4675
4104
  sol: "Solana",
4676
- tron: "Tron",
4677
- zcash: "Zcash"
4105
+ tron: "Tron"
4678
4106
  };
4679
4107
  var HARDWARE_ERROR_CODE_VALUES = new Set(
4680
- Object.values(HardwareErrorCode7).filter((value) => typeof value === "number")
4108
+ Object.values(HardwareErrorCode8).filter((value) => typeof value === "number")
4681
4109
  );
4682
4110
  var BLE_CONNECT_SCAN_TIMEOUT_MS = 1500;
4683
4111
  var LEDGER_RELAY_ALLOWED_ROOT_DOMAINS = ["onekeytest.com", "onekey.com"];
@@ -4714,10 +4142,6 @@ async function defaultLedgerKitImporter(pkg) {
4714
4142
  return import("@ledgerhq/device-signer-kit-bitcoin");
4715
4143
  case "@ledgerhq/device-signer-kit-solana":
4716
4144
  return import("@ledgerhq/device-signer-kit-solana");
4717
- case "@ledgerhq/device-signer-kit-tron":
4718
- return import("@ledgerhq/device-signer-kit-tron");
4719
- case "@ledgerhq/device-signer-kit-zcash":
4720
- return import("@ledgerhq/device-signer-kit-zcash");
4721
4145
  case "@ledgerhq/context-module":
4722
4146
  return import("@ledgerhq/context-module");
4723
4147
  default:
@@ -4777,7 +4201,6 @@ var LedgerConnectorBase = class {
4777
4201
  this._ctx = {
4778
4202
  emit: (event, data) => this._emit(event, data),
4779
4203
  invalidateSession: (sid) => this._invalidateSession(sid),
4780
- teardownSecureChannelSession: (sid) => this._teardownSecureChannelSession(sid),
4781
4204
  wrapError: (err, opts) => this._wrapError(err, opts),
4782
4205
  getOrCreateDmk: () => this._getOrCreateDmk(),
4783
4206
  getDeviceManager: () => this._getDeviceManager(),
@@ -4877,7 +4300,7 @@ var LedgerConnectorBase = class {
4877
4300
  `Ledger BLE connect did not return within ${HANG_CEILING_MS / 6e4}min \u2014 DMK hang fallback.`
4878
4301
  );
4879
4302
  err._tag = ERROR_TAG.BlePairingTimeout;
4880
- err.code = HardwareErrorCode7.BlePairingTimeout;
4303
+ err.code = HardwareErrorCode8.BlePairingTimeout;
4881
4304
  reject(err);
4882
4305
  }, HANG_CEILING_MS);
4883
4306
  });
@@ -4910,7 +4333,7 @@ var LedgerConnectorBase = class {
4910
4333
  "Ledger device is not currently advertising. Wake up and unlock the device, keep it nearby, then try again."
4911
4334
  );
4912
4335
  err._tag = ERROR_TAG.DeviceNotAdvertising;
4913
- err.code = HardwareErrorCode7.DeviceNotFound;
4336
+ err.code = HardwareErrorCode8.DeviceNotFound;
4914
4337
  throw err;
4915
4338
  };
4916
4339
  const doConnect = async (path) => {
@@ -4967,14 +4390,14 @@ var LedgerConnectorBase = class {
4967
4390
  this._resetSignersAndSessions();
4968
4391
  if (isLedgerBleConnectionType(this.connectionType)) {
4969
4392
  const tag = err?._tag;
4970
- if (isKnownConnectionTag(tag) && !isConnectionOpeningTag(tag)) {
4393
+ if (isKnownConnectionTag(tag)) {
4971
4394
  throw err;
4972
4395
  }
4973
4396
  const wrapped = new Error(
4974
4397
  "Ledger Bluetooth pairing failed. Make sure the device is unlocked and nearby, then try again."
4975
4398
  );
4976
4399
  wrapped._tag = ERROR_TAG.BleGattBondingFailed;
4977
- wrapped.code = HardwareErrorCode7.BlePairingTimeout;
4400
+ wrapped.code = HardwareErrorCode8.BlePairingTimeout;
4978
4401
  wrapped.originalError = err;
4979
4402
  throw wrapped;
4980
4403
  }
@@ -5052,7 +4475,7 @@ var LedgerConnectorBase = class {
5052
4475
  this._unwatchSessionState(sessionId);
5053
4476
  this._signerManager?.invalidate(sessionId);
5054
4477
  this._cancellers.get(sessionId)?.({
5055
- code: HardwareErrorCode7.DeviceDisconnected,
4478
+ code: HardwareErrorCode8.DeviceDisconnected,
5056
4479
  tag: "DeviceDisconnected",
5057
4480
  message: "Device disconnected"
5058
4481
  });
@@ -5078,7 +4501,7 @@ var LedgerConnectorBase = class {
5078
4501
  success: false,
5079
4502
  error: serializeConnectorError(
5080
4503
  Object.assign(new Error("Ledger app is unresponsive"), {
5081
- code: HardwareErrorCode7.DeviceAppStuck,
4504
+ code: HardwareErrorCode8.DeviceAppStuck,
5082
4505
  _tag: ERROR_TAG.DeviceAppStuck,
5083
4506
  originalError: err
5084
4507
  })
@@ -5090,7 +4513,7 @@ var LedgerConnectorBase = class {
5090
4513
  success: false,
5091
4514
  error: serializeConnectorError(
5092
4515
  Object.assign(new Error("Device communication interrupted, please retry"), {
5093
- code: HardwareErrorCode7.TransportError,
4516
+ code: HardwareErrorCode8.TransportError,
5094
4517
  _tag: ERROR_TAG.DeviceTransportStuck,
5095
4518
  originalError: err
5096
4519
  })
@@ -5136,11 +4559,6 @@ var LedgerConnectorBase = class {
5136
4559
  return solSignTransaction(ctx, sessionId, params);
5137
4560
  case "solSignMessage":
5138
4561
  return solSignMessage(ctx, sessionId, params);
5139
- // ZCASH
5140
- case "zcashGetFullViewingKey":
5141
- return zcashGetFullViewingKey(ctx, sessionId, params);
5142
- case "zcashGetShieldedAddress":
5143
- return zcashGetShieldedAddress(ctx, sessionId, params);
5144
4562
  // TRON
5145
4563
  case "tronGetAddress":
5146
4564
  return tronGetAddress(ctx, sessionId, params);
@@ -5165,7 +4583,7 @@ var LedgerConnectorBase = class {
5165
4583
  try {
5166
4584
  return await apps.install(p.appName, ({ progress }) => {
5167
4585
  ctx.emit("ui-event", {
5168
- type: EConnectorInteraction3.AppInstallProgress,
4586
+ type: EConnectorInteraction4.AppInstallProgress,
5169
4587
  payload: {
5170
4588
  sessionId,
5171
4589
  appName: p.appName,
@@ -5174,7 +4592,7 @@ var LedgerConnectorBase = class {
5174
4592
  });
5175
4593
  });
5176
4594
  } catch (err) {
5177
- ctx.teardownSecureChannelSession(sessionId);
4595
+ ctx.invalidateSession(sessionId);
5178
4596
  throw ctx.wrapError(err);
5179
4597
  } finally {
5180
4598
  ctx.clearCanceller(sessionId);
@@ -5264,7 +4682,7 @@ var LedgerConnectorBase = class {
5264
4682
  );
5265
4683
  return { isGenuine: output.isGenuine, deviceId };
5266
4684
  } catch (err) {
5267
- ctx.teardownSecureChannelSession(sessionId);
4685
+ ctx.invalidateSession(sessionId);
5268
4686
  throw ctx.wrapError(err);
5269
4687
  } finally {
5270
4688
  ctx.clearCanceller(sessionId);
@@ -5383,26 +4801,9 @@ var LedgerConnectorBase = class {
5383
4801
  }
5384
4802
  return this._deviceAppsManager;
5385
4803
  }
5386
- // DeviceAppsManager is a per-call factory with no cached session state, so
5387
- // there is nothing to invalidate for it here.
5388
4804
  _invalidateSession(sessionId) {
5389
4805
  this._signerManager?.invalidate(sessionId);
5390
4806
  }
5391
- /**
5392
- * Fire the canceller so DMK closes the secure-channel WebSocket. The DMK device
5393
- * session is kept: unlock/retry recovery reuses it.
5394
- */
5395
- _teardownSecureChannelSession(sessionId) {
5396
- const cancel = this._cancellers.get(sessionId);
5397
- this._cancellers.delete(sessionId);
5398
- if (cancel) {
5399
- try {
5400
- cancel();
5401
- } catch {
5402
- }
5403
- }
5404
- this._invalidateSession(sessionId);
5405
- }
5406
4807
  /**
5407
4808
  * Replace an old session with a new one after app switch.
5408
4809
  * Emits device-connect so the adapter updates its _sessions Map.
@@ -5487,7 +4888,7 @@ var LedgerConnectorBase = class {
5487
4888
  * at every catch site. Falls through unchanged for unknown methods.
5488
4889
  */
5489
4890
  _ctxForMethod(method) {
5490
- const prefix = /^(evm|btc|sol|tron|zcash)/.exec(method)?.[1];
4891
+ const prefix = /^(evm|btc|sol|tron)/.exec(method)?.[1];
5491
4892
  const defaultAppName = prefix ? METHOD_PREFIX_TO_APP_NAME[prefix] : void 0;
5492
4893
  if (!defaultAppName) return this._ctx;
5493
4894
  return {
@@ -5521,209 +4922,6 @@ var LedgerConnectorBase = class {
5521
4922
  return error;
5522
4923
  }
5523
4924
  };
5524
-
5525
- // src/transport/DmkTransport.ts
5526
- import Transport from "@ledgerhq/hw-transport";
5527
- var DmkTransport = class extends Transport {
5528
- constructor(dmk, sessionId) {
5529
- super();
5530
- this._dmk = dmk;
5531
- this._sessionId = sessionId;
5532
- }
5533
- async exchange(apdu) {
5534
- const response = await this._dmk.sendApdu({
5535
- sessionId: this._sessionId,
5536
- apdu: new Uint8Array(apdu)
5537
- });
5538
- const { data, statusCode } = response;
5539
- const result = Buffer.alloc(data.length + 2);
5540
- if (data.length > 0) {
5541
- result.set(data, 0);
5542
- }
5543
- result.set(statusCode, data.length);
5544
- return result;
5545
- }
5546
- async close() {
5547
- }
5548
- };
5549
-
5550
- // src/app/AppManager.ts
5551
- import {
5552
- CloseAppCommand,
5553
- GetAppAndVersionCommand,
5554
- OpenAppCommand,
5555
- isSuccessCommandResult
5556
- } from "@ledgerhq/device-management-kit";
5557
- import { HardwareErrorCode as HardwareErrorCode8 } from "@onekeyfe/hwk-adapter-core";
5558
- var APP_NAME_MAP = {
5559
- ETH: "Ethereum",
5560
- BTC: "Bitcoin",
5561
- SOL: "Solana",
5562
- TRX: "Tron",
5563
- ZEC: "Zcash",
5564
- XRP: "XRP",
5565
- ADA: "Cardano",
5566
- DOT: "Polkadot",
5567
- ATOM: "Cosmos"
5568
- };
5569
- var DASHBOARD_APP_NAME = "BOLOS";
5570
- var AppManager = class {
5571
- constructor(dmk, options) {
5572
- this._dmk = dmk;
5573
- this._waitMs = options?.waitMs ?? 1e3;
5574
- this._maxRetries = options?.maxRetries ?? 10;
5575
- }
5576
- /**
5577
- * Return the Ledger app name for a given chain ticker,
5578
- * or undefined if the chain is not supported.
5579
- */
5580
- static getAppName(chain) {
5581
- return APP_NAME_MAP[chain];
5582
- }
5583
- /**
5584
- * Ensure the target app is open on the device identified by `sessionId`.
5585
- *
5586
- * Flow:
5587
- * 1. Check the currently running app.
5588
- * 2. If it is already the target, return immediately.
5589
- * 3. If a different app is running (not dashboard), close it first.
5590
- * 4. Open the target app.
5591
- * 5. Poll until the device confirms the target app is running.
5592
- */
5593
- /**
5594
- * @param onConfirmOnDevice Called BEFORE OpenAppCommand is issued — the
5595
- * device is about to display "Open <app>" on screen and wait for the
5596
- * user's button press. UI consumers should show their "open app" prompt
5597
- * in response. NOT called when the target app is already open (no user
5598
- * interaction needed in that case).
5599
- *
5600
- * Important: OpenAppCommand is blocking. It does not resolve until the user
5601
- * has physically confirmed on the device, so anything that runs AFTER
5602
- * `await this._openApp(...)` lands AFTER the prompt is already gone.
5603
- * Hence the callback must fire BEFORE that await.
5604
- */
5605
- async ensureAppOpen(sessionId, targetAppName, onConfirmOnDevice) {
5606
- const currentApp = await this._getCurrentApp(sessionId);
5607
- if (currentApp === targetAppName) {
5608
- return;
5609
- }
5610
- if (!this._isDashboard(currentApp)) {
5611
- await this._closeCurrentApp(sessionId);
5612
- await this._waitForApp(sessionId, DASHBOARD_APP_NAME);
5613
- }
5614
- onConfirmOnDevice?.();
5615
- await this._openApp(sessionId, targetAppName);
5616
- await this._waitForApp(sessionId, targetAppName);
5617
- }
5618
- // ---------------------------------------------------------------------------
5619
- // Private helpers
5620
- // ---------------------------------------------------------------------------
5621
- async _getCurrentApp(sessionId) {
5622
- const result = await this._dmk.sendCommand({
5623
- sessionId,
5624
- command: new GetAppAndVersionCommand()
5625
- });
5626
- if (isSuccessCommandResult(result)) {
5627
- debugLog("[AppManager] currentApp:", result.data.name);
5628
- return result.data.name;
5629
- }
5630
- const errResult = result;
5631
- const dmkErr = errResult.error ?? {};
5632
- const original = dmkErr.originalError;
5633
- debugLog(
5634
- "[AppManager] _getCurrentApp failed sessionId=",
5635
- sessionId,
5636
- "tag=",
5637
- dmkErr._tag,
5638
- "errorCode=",
5639
- dmkErr.errorCode,
5640
- "message=",
5641
- dmkErr.message,
5642
- "originalErrorMessage=",
5643
- original?.message ?? String(original ?? "")
5644
- );
5645
- throw Object.assign(
5646
- new Error(
5647
- dmkErr.message ?? "Failed to get current app from device"
5648
- ),
5649
- {
5650
- _tag: dmkErr._tag,
5651
- errorCode: dmkErr.errorCode,
5652
- originalError: original
5653
- }
5654
- );
5655
- }
5656
- async _openApp(sessionId, appName) {
5657
- const result = await this._dmk.sendCommand({
5658
- sessionId,
5659
- command: new OpenAppCommand({ appName })
5660
- });
5661
- if (!isSuccessCommandResult(result)) {
5662
- const dmkErr = result.error;
5663
- const errorCode = "errorCode" in dmkErr && dmkErr.errorCode != null ? String(dmkErr.errorCode) : "";
5664
- const message = "message" in dmkErr && typeof dmkErr.message === "string" ? dmkErr.message : "";
5665
- debugLog(
5666
- "[AppManager] openApp failed:",
5667
- appName,
5668
- "errorCode:",
5669
- errorCode,
5670
- "tag:",
5671
- dmkErr._tag
5672
- );
5673
- let code;
5674
- if (errorCode === "6807" || /unknown application/i.test(message)) {
5675
- code = HardwareErrorCode8.AppNotInstalled;
5676
- } else if (errorCode === "5501" || dmkErr._tag === "ActionRefusedError") {
5677
- code = HardwareErrorCode8.UserRejected;
5678
- }
5679
- throw Object.assign(new Error(`Failed to open "${appName}"`), {
5680
- _tag: ERROR_TAG.OpenAppCommand,
5681
- code,
5682
- errorCode,
5683
- statusCode: errorCode,
5684
- appName,
5685
- originalError: dmkErr
5686
- });
5687
- }
5688
- }
5689
- async _closeCurrentApp(sessionId) {
5690
- debugLog("[AppManager] closeCurrentApp");
5691
- await this._dmk.sendCommand({
5692
- sessionId,
5693
- command: new CloseAppCommand()
5694
- });
5695
- }
5696
- /**
5697
- * Poll the device until the expected app is reported as running,
5698
- * or throw after `_maxRetries` attempts.
5699
- */
5700
- async _waitForApp(sessionId, expectedAppName) {
5701
- let lastSeen = "";
5702
- for (let i = 0; i < this._maxRetries; i++) {
5703
- await this._wait();
5704
- const current = await this._getCurrentApp(sessionId);
5705
- lastSeen = current;
5706
- if (current === expectedAppName) {
5707
- return;
5708
- }
5709
- }
5710
- debugLog(
5711
- "[AppManager] waitForApp exhausted: expected=",
5712
- expectedAppName,
5713
- "lastSeen=",
5714
- lastSeen
5715
- );
5716
- throw new Error(
5717
- `Ledger: failed to open "${expectedAppName}" after ${this._maxRetries} retries (last seen: ${lastSeen})`
5718
- );
5719
- }
5720
- _isDashboard(appName) {
5721
- return appName === DASHBOARD_APP_NAME;
5722
- }
5723
- _wait() {
5724
- return new Promise((resolve) => setTimeout(resolve, this._waitMs));
5725
- }
5726
- };
5727
4925
  export {
5728
4926
  AppManager,
5729
4927
  DmkTransport,
@@ -5734,7 +4932,6 @@ export {
5734
4932
  SignerEth,
5735
4933
  SignerManager,
5736
4934
  SignerSol,
5737
- SignerZcash,
5738
4935
  debugLog,
5739
4936
  deviceActionToPromise,
5740
4937
  isDeviceLockedError,