@onekeyfe/hwk-adapter-core 1.2.4 → 1.2.5-alpha.1

package/dist/{chunk-U63HTLGJ.mjs → chunk-AYA6FQES.mjs}

@@ -1,3 +1,7 @@
+import {
+  createHwkError
+} from "./chunk-KTRQZ5AJ.mjs";
+
 // src/events/ui-request.ts
 var UI_EVENT = "UI_EVENT";
 var UI_REQUEST = {
@@ -11,6 +15,8 @@ var UI_REQUEST = {
   REQUEST_QR_SCAN: "ui-request-qr-scan",
   REQUEST_DEVICE_PERMISSION: "ui-request-device-permission",
   REQUEST_SELECT_DEVICE: "ui-request-select-device",
+  REQUEST_SAVE_DEVICE_BINDING: "ui-request-save-device-binding",
+  DEVICE_BINDING_STATUS: "ui-device-binding-status",
   REQUEST_DEVICE_CONNECT: "ui-request-device-connect",
   // Ledger BTC App: account index >= 100 requires display=true. Adapter asks
   // the user once per session before promoting the call.
@@ -30,6 +36,7 @@ var UI_RESPONSE = {
   RECEIVE_PASSPHRASE: "receive-passphrase",
   RECEIVE_QR_RESPONSE: "receive-qr-response",
   RECEIVE_SELECT_DEVICE: "receive-select-device",
+  RECEIVE_SAVE_DEVICE_BINDING: "receive-save-device-binding",
   RECEIVE_DEVICE_CONNECT: "receive-device-connect",
   RECEIVE_DEVICE_PERMISSION: "receive-device-permission",
   RECEIVE_BTC_HIGH_INDEX_CONFIRM: "receive-btc-high-index-confirm",
@@ -45,6 +52,7 @@ var RESPONSE_TO_REQUEST = {
   [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,
   [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,
   [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,
+  [UI_RESPONSE.RECEIVE_SAVE_DEVICE_BINDING]: UI_REQUEST.REQUEST_SAVE_DEVICE_BINDING,
   [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,
   [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,
   [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,
@@ -56,10 +64,15 @@ var RESPONSE_TO_REQUEST = {
 var UI_REQUEST_PREEMPTED_TAG = "UiRequestPreempted";
 var UI_REQUEST_CANCELLED_TAG = "UiRequestCancelled";
 var UI_REQUEST_TIMEOUT_TAG = "UiRequestTimeout";
+var requestSequence = 0;
 var UiRequestRegistry = class {
   constructor() {
     this.pending = /* @__PURE__ */ new Map();
   }
+  createRequestId() {
+    requestSequence += 1;
+    return `hwk-ui-${Date.now()}-${requestSequence}`;
+  }
   wait(requestType, options) {
     const existing = this.pending.get(requestType);
     if (existing) {
@@ -84,6 +97,8 @@ var UiRequestRegistry = class {
         }
       }, timeoutMs);
       this.pending.set(requestType, {
+        requestId: options?.requestId,
+        operationId: options?.operationId,
         resolve,
         reject,
         timer
@@ -102,32 +117,49 @@ var UiRequestRegistry = class {
     if (!requestType) return;
     const entry = this.pending.get(requestType);
     if (!entry) return;
+    const response = payload && typeof payload === "object" ? payload : void 0;
+    if (entry.requestId !== void 0 && response?.requestId !== entry.requestId) return;
     clearTimeout(entry.timer);
     this.pending.delete(requestType);
-    entry.resolve(payload);
-  }
-  cancel(requestType) {
-    if (requestType) {
-      const entry = this.pending.get(requestType);
-      if (!entry) return;
-      clearTimeout(entry.timer);
-      this.pending.delete(requestType);
+    if (requestType === UI_REQUEST.REQUEST_SELECT_DEVICE && response?.cancelled === true) {
       entry.reject(
-        Object.assign(new Error(`UI request '${requestType}' was cancelled`), {
+        createHwkError({
+          code: 10005 /* UserAborted */,
+          message: "Device selection was cancelled",
           _tag: UI_REQUEST_CANCELLED_TAG
         })
       );
       return;
     }
-    for (const [type, entry] of this.pending) {
+    entry.resolve(payload);
+  }
+  /**
+   * Each argument narrows the cancel: none rejects every waiter (teardown); an `operationId` alone
+   * rejects only that operation's prompts and leaves another operation's PIN or QR wait untouched.
+   */
+  cancel(requestType, requestId, operationId) {
+    const reject = (type, entry) => {
       clearTimeout(entry.timer);
+      this.pending.delete(type);
       entry.reject(
         Object.assign(new Error(`UI request '${type}' was cancelled`), {
           _tag: UI_REQUEST_CANCELLED_TAG
         })
       );
+    };
+    if (requestType) {
+      const entry = this.pending.get(requestType);
+      if (!entry) return;
+      if (requestId !== void 0 && entry.requestId !== requestId) return;
+      if (operationId !== void 0 && entry.operationId !== operationId) return;
+      reject(requestType, entry);
+      return;
+    }
+    for (const [type, entry] of [...this.pending]) {
+      if (operationId === void 0 || entry.operationId === operationId) {
+        reject(type, entry);
+      }
     }
-    this.pending.clear();
   }
   reset() {
     this.cancel();
@@ -148,4 +180,4 @@ export {
   UI_REQUEST_TIMEOUT_TAG,
   UiRequestRegistry
 };
-//# sourceMappingURL=chunk-U63HTLGJ.mjs.map
+//# sourceMappingURL=chunk-AYA6FQES.mjs.map

package/dist/chunk-AYA6FQES.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/events/ui-request.ts","../src/utils/UiRequestRegistry.ts"],"sourcesContent":["import type { QrResponseData } from '../types/qr';\n\nexport const UI_EVENT = 'UI_EVENT';\n\nexport const UI_REQUEST = {\n  REQUEST_PIN: 'ui-request-pin',\n  REQUEST_PASSPHRASE: 'ui-request-passphrase',\n  // One-way UI notification: device is waiting for passphrase entry on-device.\n  // The prompt response path remains RECEIVE_PASSPHRASE with passphraseOnDevice=true.\n  REQUEST_PASSPHRASE_ON_DEVICE: 'ui-request-passphrase-on-device',\n  REQUEST_BUTTON: 'ui-request-button',\n  REQUEST_QR_DISPLAY: 'ui-request-qr-display',\n  REQUEST_QR_SCAN: 'ui-request-qr-scan',\n  REQUEST_DEVICE_PERMISSION: 'ui-request-device-permission',\n  REQUEST_SELECT_DEVICE: 'ui-request-select-device',\n  REQUEST_SAVE_DEVICE_BINDING: 'ui-request-save-device-binding',\n  DEVICE_BINDING_STATUS: 'ui-device-binding-status',\n  REQUEST_DEVICE_CONNECT: 'ui-request-device-connect',\n  // Ledger BTC App: account index >= 100 requires display=true. Adapter asks\n  // the user once per session before promoting the call.\n  REQUEST_BTC_HIGH_INDEX_CONFIRM: 'ui-request-btc-high-index-confirm',\n  // Required app is not installed; with autoInstallApp on, ask the user\n  // whether to install it before retrying the operation.\n  REQUEST_INSTALL_APP: 'ui-request-install-app',\n  REQUEST_PREEMPTION: 'ui-request-preemption',\n  REQUEST_TREZOR_THP_PAIRING: 'ui-request-trezor-thp-pairing',\n  CLOSE_UI_WINDOW: 'ui-close',\n  DEVICE_PROGRESS: 'ui-device_progress',\n  FIRMWARE_PROGRESS: 'ui-firmware-progress',\n  FIRMWARE_TIP: 'ui-firmware-tip',\n} as const;\n\nexport const UI_RESPONSE = {\n  RECEIVE_PIN: 'receive-pin',\n  RECEIVE_PASSPHRASE: 'receive-passphrase',\n  RECEIVE_QR_RESPONSE: 'receive-qr-response',\n  RECEIVE_SELECT_DEVICE: 'receive-select-device',\n  RECEIVE_SAVE_DEVICE_BINDING: 'receive-save-device-binding',\n  RECEIVE_DEVICE_CONNECT: 'receive-device-connect',\n  RECEIVE_DEVICE_PERMISSION: 'receive-device-permission',\n  RECEIVE_BTC_HIGH_INDEX_CONFIRM: 'receive-btc-high-index-confirm',\n  RECEIVE_INSTALL_APP: 'receive-install-app',\n  RECEIVE_PREEMPTION: 'receive-preemption',\n  RECEIVE_TREZOR_THP_PAIRING: 'receive-trezor-thp-pairing',\n  CANCEL: 'cancel',\n} as const;\n\n/**\n * The operation a UI request was opened under, so a cancel for one operation spares another's\n * prompts. Absent outside any operation (cold start, teardown).\n */\nexport type UiRequestOperationAttribution = {\n  operationId?: string;\n};\n\nexport type DevicePermissionDeniedReason =\n  | 'bluetoothTurnedOff'\n  | 'permissionDenied'\n  | (string & Record<never, never>);\n\nexport type DevicePermissionResponse = {\n  granted: boolean;\n  reason?: DevicePermissionDeniedReason;\n  message?: string;\n};\n\n/**\n * `mismatch`: the selected device is not this operation's device, surfaced as `DeviceMismatch`.\n * `skipped`: the host had nothing to bind, a host contract problem rather than a user action.\n */\nexport type SaveDeviceBindingDeclineReason = 'mismatch' | 'skipped';\n\nexport type UiResponseEvent =\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_SAVE_DEVICE_BINDING;\n      payload: {\n        requestId: string;\n        saved: boolean;\n        reason?: SaveDeviceBindingDeclineReason;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PIN;\n      payload: string;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PASSPHRASE;\n      payload: {\n        value: string;\n        passphraseOnDevice?: boolean;\n        save?: boolean;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_QR_RESPONSE;\n      payload: QrResponseData;\n    }\n  | {\n      // sdkConnectId echoes one of the DeviceInfo.connectId values emitted in\n      // the REQUEST_SELECT_DEVICE event's `devices` list. Scope is the current\n      // search session; may be ephemeral (e.g. Ledger USB DMK UUID).\n      type: typeof UI_RESPONSE.RECEIVE_SELECT_DEVICE;\n      payload: { requestId?: string } & (\n        | { sdkConnectId: string; cancelled?: false }\n        | { cancelled: true }\n      );\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_CONNECT;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_PERMISSION;\n      payload: DevicePermissionResponse;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_INSTALL_APP;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PREEMPTION;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING;\n      payload: {\n        selectedMethod?: number | string;\n        tag?: string;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.CANCEL;\n      payload?: undefined;\n    };\n","import { UI_REQUEST, UI_RESPONSE } from '../events/ui-request';\nimport { createHwkError, HardwareErrorCode } from '../types/errors';\n\n/** 10 min — every UI request is human-in-the-loop; bias toward \"wait long\". */\nexport const UI_REQUEST_DEFAULT_TIMEOUT_MS = 600_000;\n\nconst RESPONSE_TO_REQUEST: Record<string, string> = {\n  [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,\n  [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,\n  [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,\n  [UI_RESPONSE.RECEIVE_SAVE_DEVICE_BINDING]: UI_REQUEST.REQUEST_SAVE_DEVICE_BINDING,\n  [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,\n  [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,\n  [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,\n  [UI_RESPONSE.RECEIVE_INSTALL_APP]: UI_REQUEST.REQUEST_INSTALL_APP,\n  [UI_RESPONSE.RECEIVE_PREEMPTION]: UI_REQUEST.REQUEST_PREEMPTION,\n  [UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING]: UI_REQUEST.REQUEST_TREZOR_THP_PAIRING,\n  // RECEIVE_QR_RESPONSE maps to QR_DISPLAY or QR_SCAN — resolved dynamically below.\n};\n\nexport const UI_REQUEST_PREEMPTED_TAG = 'UiRequestPreempted';\nexport const UI_REQUEST_CANCELLED_TAG = 'UiRequestCancelled';\nexport const UI_REQUEST_TIMEOUT_TAG = 'UiRequestTimeout';\n\nlet requestSequence = 0;\n\ntype PendingEntry = {\n  requestId?: string;\n  /** The operation this waiter belongs to, when it was opened under one. */\n  operationId?: string;\n  resolve: (payload: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Per-type single-slot registry for adapter-level UI requests. A new `wait`\n * of the same type supersedes (rejects) the prior pending entry. With the\n * job queue running globally serially, cross-type collisions don't occur in\n * normal flow — same-type preemption is a defensive measure for callers\n * that fire the same request twice without waiting on the first.\n *\n * Unknown response types are dropped silently so the public `uiResponse`\n * entry never throws.\n */\nexport class UiRequestRegistry {\n  private pending = new Map<string, PendingEntry>();\n\n  createRequestId(): string {\n    requestSequence += 1;\n    return `hwk-ui-${Date.now()}-${requestSequence}`;\n  }\n\n  wait<T = unknown>(\n    requestType: string,\n    options?: { timeoutMs?: number; requestId?: string; operationId?: string }\n  ): Promise<T> {\n    const existing = this.pending.get(requestType);\n    if (existing) {\n      clearTimeout(existing.timer);\n      this.pending.delete(requestType);\n      existing.reject(\n        Object.assign(new Error(`UI request '${requestType}' was superseded by a new request`), {\n          _tag: UI_REQUEST_PREEMPTED_TAG,\n        })\n      );\n    }\n\n    const timeoutMs = options?.timeoutMs ?? UI_REQUEST_DEFAULT_TIMEOUT_MS;\n\n    return new Promise<T>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        if (this.pending.get(requestType)?.timer === timer) {\n          this.pending.delete(requestType);\n          reject(\n            Object.assign(new Error(`UI request '${requestType}' timed out after ${timeoutMs}ms`), {\n              _tag: UI_REQUEST_TIMEOUT_TAG,\n            })\n          );\n        }\n      }, timeoutMs);\n\n      this.pending.set(requestType, {\n        requestId: options?.requestId,\n        operationId: options?.operationId,\n        resolve: resolve as (payload: unknown) => void,\n        reject,\n        timer,\n      });\n    });\n  }\n\n  resolve(responseType: string, payload: unknown): void {\n    let requestType = RESPONSE_TO_REQUEST[responseType];\n    if (responseType === UI_RESPONSE.RECEIVE_QR_RESPONSE) {\n      if (this.pending.has(UI_REQUEST.REQUEST_QR_DISPLAY)) {\n        requestType = UI_REQUEST.REQUEST_QR_DISPLAY;\n      } else if (this.pending.has(UI_REQUEST.REQUEST_QR_SCAN)) {\n        requestType = UI_REQUEST.REQUEST_QR_SCAN;\n      }\n    }\n    if (!requestType) return;\n\n    const entry = this.pending.get(requestType);\n    if (!entry) return;\n\n    const response =\n      payload && typeof payload === 'object'\n        ? (payload as { requestId?: unknown; cancelled?: unknown })\n        : undefined;\n    // A late response must not resolve (or cancel) a newer request of the same type.\n    if (entry.requestId !== undefined && response?.requestId !== entry.requestId) return;\n    clearTimeout(entry.timer);\n    this.pending.delete(requestType);\n    if (requestType === UI_REQUEST.REQUEST_SELECT_DEVICE && response?.cancelled === true) {\n      entry.reject(\n        createHwkError({\n          code: HardwareErrorCode.UserAborted,\n          message: 'Device selection was cancelled',\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n      return;\n    }\n    entry.resolve(payload);\n  }\n\n  /**\n   * Each argument narrows the cancel: none rejects every waiter (teardown); an `operationId` alone\n   * rejects only that operation's prompts and leaves another operation's PIN or QR wait untouched.\n   */\n  cancel(requestType?: string, requestId?: string, operationId?: string): void {\n    const reject = (type: string, entry: PendingEntry) => {\n      clearTimeout(entry.timer);\n      this.pending.delete(type);\n      entry.reject(\n        Object.assign(new Error(`UI request '${type}' was cancelled`), {\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n    };\n\n    if (requestType) {\n      const entry = this.pending.get(requestType);\n      if (!entry) return;\n      if (requestId !== undefined && entry.requestId !== requestId) return;\n      if (operationId !== undefined && entry.operationId !== operationId) return;\n      reject(requestType, entry);\n      return;\n    }\n\n    for (const [type, entry] of [...this.pending]) {\n      if (operationId === undefined || entry.operationId === operationId) {\n        reject(type, entry);\n      }\n    }\n  }\n\n  reset(): void {\n    this.cancel();\n  }\n\n  hasPending(requestType?: string): boolean {\n    if (requestType) return this.pending.has(requestType);\n    return this.pending.size > 0;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-DB4JOPZO.mjs

@@ -0,0 +1,74 @@
+// src/utils/errorMessages.ts
+function enrichErrorMessage(code, originalMessage) {
+  switch (code) {
+    case 10400 /* PinInvalid */:
+      return `${originalMessage}. Please re-enter your PIN.`;
+    case 10401 /* PinCancelled */:
+      return `${originalMessage}. PIN entry was cancelled.`;
+    case 10404 /* PinMismatch */:
+      return `${originalMessage}. The entered PINs do not match. Please try again.`;
+    case 10102 /* DeviceBusy */:
+      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;
+    case 10111 /* DeviceBusyInternal */:
+      return `${originalMessage}. The device is busy. Please try again in a moment.`;
+    case 10101 /* DeviceDisconnected */:
+      return `${originalMessage}. Please reconnect the device and try again.`;
+    case 10103 /* DeviceLocked */:
+      return `${originalMessage}. Please unlock your device and try again.`;
+    case 10109 /* DeviceOneDeviceOnly */:
+      return `${originalMessage}. Disconnect the extra device and try again.`;
+    case 10001 /* UserRejected */:
+      return `${originalMessage}. The request was rejected on the device.`;
+    case 10501 /* WrongApp */:
+      return `${originalMessage}. Please open the correct app on your device.`;
+    case 10500 /* AppNotInstalled */:
+      return `${originalMessage}. The required app is not installed on the device.`;
+    case 10503 /* DeviceOutOfMemory */:
+      return `${originalMessage}. Not enough free space on the device. Please uninstall some apps and try again.`;
+    case 10302 /* TransportNotAvailable */:
+      return `${originalMessage}. Ensure the device bridge/transport is available and running.`;
+    case 10305 /* NetworkError */:
+      return `${originalMessage}. Network error \u2014 check your internet connection and try again.`;
+    case 10311 /* LedgerSecureChannelError */:
+      return `${originalMessage}. The secure connection to Ledger's servers was interrupted. Keep the device unlocked on the dashboard and try again.`;
+    case 10312 /* LedgerFirmwareMetadataError */:
+      return `${originalMessage}. Ledger's app catalog returned an unusable response. Please try again later.`;
+    case 10504 /* AppAlreadyInstalled */:
+      return `${originalMessage}. The app is already installed on the device.`;
+    case 10200 /* FirmwareTooOld */:
+      return `${originalMessage}. Please update your device firmware.`;
+    case 10104 /* DeviceNotInitialized */:
+      return `${originalMessage}. The device may need to be set up first.`;
+    case 10003 /* OperationTimeout */:
+      return `${originalMessage}. The operation timed out. Please try again.`;
+    case 11e3 /* EvmBlindSigningRequired */:
+      return "Ledger: Blind signing not enabled in Ethereum app.";
+    case 11001 /* EvmClearSignPluginMissing */:
+      return "Ledger: Required plugin not installed (install via Ledger Live).";
+    case 11002 /* EvmDataTooLarge */:
+      return "Ledger: Transaction data too large for device memory.";
+    case 11003 /* EvmTxTypeNotSupported */:
+      return "Ledger: Transaction type not supported by current Ethereum app.";
+    case 10502 /* AppTooOld */:
+      return "Ledger: App out of date (update via Ledger Live).";
+    case 11100 /* SolanaBlindSigningRequired */:
+      return "Blind signing disabled in the Solana app.";
+    case 11200 /* TronCustomContractRequired */:
+      return "Custom Contracts setting disabled in the Tron app.";
+    case 11201 /* TronDataSigningRequired */:
+      return "Transactions Data setting disabled in the Tron app.";
+    case 11202 /* TronSignByHashRequired */:
+      return "Sign by Hash setting disabled in the Tron app.";
+    case 11300 /* BtcWalletPolicyHmacMismatch */:
+      return "Wallet policy not registered or HMAC mismatch.";
+    case 11301 /* BtcUnexpectedState */:
+      return "Signing aborted due to unexpected device state.";
+    default:
+      return originalMessage;
+  }
+}
+
+export {
+  enrichErrorMessage
+};
+//# sourceMappingURL=chunk-DB4JOPZO.mjs.map

package/dist/chunk-DB4JOPZO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/errorMessages.ts"],"sourcesContent":["import { HardwareErrorCode } from '../types/errors';\n\n/**\n * Enrich a hardware error message with actionable recovery hints.\n * Shared across adapters (Ledger, Trezor, etc.).\n */\nexport function enrichErrorMessage(code: HardwareErrorCode, originalMessage: string): string {\n  switch (code) {\n    case HardwareErrorCode.PinInvalid:\n      return `${originalMessage}. Please re-enter your PIN.`;\n    case HardwareErrorCode.PinCancelled:\n      return `${originalMessage}. PIN entry was cancelled.`;\n    case HardwareErrorCode.PinMismatch:\n      return `${originalMessage}. The entered PINs do not match. Please try again.`;\n    case HardwareErrorCode.DeviceBusy:\n      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;\n    case HardwareErrorCode.DeviceBusyInternal:\n      return `${originalMessage}. The device is busy. Please try again in a moment.`;\n    case HardwareErrorCode.DeviceDisconnected:\n      return `${originalMessage}. Please reconnect the device and try again.`;\n    case HardwareErrorCode.DeviceLocked:\n      return `${originalMessage}. Please unlock your device and try again.`;\n    case HardwareErrorCode.DeviceOneDeviceOnly:\n      return `${originalMessage}. Disconnect the extra device and try again.`;\n    case HardwareErrorCode.UserRejected:\n      return `${originalMessage}. The request was rejected on the device.`;\n    case HardwareErrorCode.WrongApp:\n      return `${originalMessage}. Please open the correct app on your device.`;\n    case HardwareErrorCode.AppNotInstalled:\n      return `${originalMessage}. The required app is not installed on the device.`;\n    case HardwareErrorCode.DeviceOutOfMemory:\n      return `${originalMessage}. Not enough free space on the device. Please uninstall some apps and try again.`;\n    case HardwareErrorCode.TransportNotAvailable:\n      return `${originalMessage}. Ensure the device bridge/transport is available and running.`;\n    case HardwareErrorCode.NetworkError:\n      return `${originalMessage}. Network error — check your internet connection and try again.`;\n    case HardwareErrorCode.LedgerSecureChannelError:\n      return `${originalMessage}. The secure connection to Ledger's servers was interrupted. Keep the device unlocked on the dashboard and try again.`;\n    case HardwareErrorCode.LedgerFirmwareMetadataError:\n      return `${originalMessage}. Ledger's app catalog returned an unusable response. Please try again later.`;\n    case HardwareErrorCode.AppAlreadyInstalled:\n      return `${originalMessage}. The app is already installed on the device.`;\n    case HardwareErrorCode.FirmwareTooOld:\n      return `${originalMessage}. Please update your device firmware.`;\n    case HardwareErrorCode.DeviceNotInitialized:\n      return `${originalMessage}. The device may need to be set up first.`;\n    case HardwareErrorCode.OperationTimeout:\n      return `${originalMessage}. The operation timed out. Please try again.`;\n    case HardwareErrorCode.EvmBlindSigningRequired:\n      return 'Ledger: Blind signing not enabled in Ethereum app.';\n    case HardwareErrorCode.EvmClearSignPluginMissing:\n      return 'Ledger: Required plugin not installed (install via Ledger Live).';\n    case HardwareErrorCode.EvmDataTooLarge:\n      return 'Ledger: Transaction data too large for device memory.';\n    case HardwareErrorCode.EvmTxTypeNotSupported:\n      return 'Ledger: Transaction type not supported by current Ethereum app.';\n    case HardwareErrorCode.AppTooOld:\n      return 'Ledger: App out of date (update via Ledger Live).';\n    case HardwareErrorCode.SolanaBlindSigningRequired:\n      return 'Blind signing disabled in the Solana app.';\n    case HardwareErrorCode.TronCustomContractRequired:\n      return 'Custom Contracts setting disabled in the Tron app.';\n    case HardwareErrorCode.TronDataSigningRequired:\n      return 'Transactions Data setting disabled in the Tron app.';\n    case HardwareErrorCode.TronSignByHashRequired:\n      return 'Sign by Hash setting disabled in the Tron app.';\n    case HardwareErrorCode.BtcWalletPolicyHmacMismatch:\n      return 'Wallet policy not registered or HMAC mismatch.';\n    case HardwareErrorCode.BtcUnexpectedState:\n      return 'Signing aborted due to unexpected device state.';\n    default:\n      return originalMessage;\n  }\n}\n"],"mappings":";AAMO,SAAS,mBAAmB,MAAyB,iBAAiC;AAC3F,UAAQ,MAAM;AAAA,IACZ;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO,GAAG,eAAe;AAAA,IAC3B;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;","names":[]}

package/dist/{chunk-BAGEFFFY.js → chunk-H7BZ2C6J.js}

@@ -1,4 +1,8 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/events/ui-request.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkT5HIQPNGjs = require('./chunk-T5HIQPNG.js');
+
+// src/events/ui-request.ts
 var UI_EVENT = "UI_EVENT";
 var UI_REQUEST = {
   REQUEST_PIN: "ui-request-pin",
@@ -11,6 +15,8 @@ var UI_REQUEST = {
   REQUEST_QR_SCAN: "ui-request-qr-scan",
   REQUEST_DEVICE_PERMISSION: "ui-request-device-permission",
   REQUEST_SELECT_DEVICE: "ui-request-select-device",
+  REQUEST_SAVE_DEVICE_BINDING: "ui-request-save-device-binding",
+  DEVICE_BINDING_STATUS: "ui-device-binding-status",
   REQUEST_DEVICE_CONNECT: "ui-request-device-connect",
   // Ledger BTC App: account index >= 100 requires display=true. Adapter asks
   // the user once per session before promoting the call.
@@ -30,6 +36,7 @@ var UI_RESPONSE = {
   RECEIVE_PASSPHRASE: "receive-passphrase",
   RECEIVE_QR_RESPONSE: "receive-qr-response",
   RECEIVE_SELECT_DEVICE: "receive-select-device",
+  RECEIVE_SAVE_DEVICE_BINDING: "receive-save-device-binding",
   RECEIVE_DEVICE_CONNECT: "receive-device-connect",
   RECEIVE_DEVICE_PERMISSION: "receive-device-permission",
   RECEIVE_BTC_HIGH_INDEX_CONFIRM: "receive-btc-high-index-confirm",
@@ -45,6 +52,7 @@ var RESPONSE_TO_REQUEST = {
   [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,
   [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,
   [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,
+  [UI_RESPONSE.RECEIVE_SAVE_DEVICE_BINDING]: UI_REQUEST.REQUEST_SAVE_DEVICE_BINDING,
   [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,
   [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,
   [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,
@@ -56,10 +64,15 @@ var RESPONSE_TO_REQUEST = {
 var UI_REQUEST_PREEMPTED_TAG = "UiRequestPreempted";
 var UI_REQUEST_CANCELLED_TAG = "UiRequestCancelled";
 var UI_REQUEST_TIMEOUT_TAG = "UiRequestTimeout";
+var requestSequence = 0;
 var UiRequestRegistry = class {
   constructor() {
     this.pending = /* @__PURE__ */ new Map();
   }
+  createRequestId() {
+    requestSequence += 1;
+    return `hwk-ui-${Date.now()}-${requestSequence}`;
+  }
   wait(requestType, options) {
     const existing = this.pending.get(requestType);
     if (existing) {
@@ -84,6 +97,8 @@ var UiRequestRegistry = class {
         }
       }, timeoutMs);
       this.pending.set(requestType, {
+        requestId: _optionalChain([options, 'optionalAccess', _6 => _6.requestId]),
+        operationId: _optionalChain([options, 'optionalAccess', _7 => _7.operationId]),
         resolve,
         reject,
         timer
@@ -102,32 +117,49 @@ var UiRequestRegistry = class {
     if (!requestType) return;
     const entry = this.pending.get(requestType);
     if (!entry) return;
+    const response = payload && typeof payload === "object" ? payload : void 0;
+    if (entry.requestId !== void 0 && _optionalChain([response, 'optionalAccess', _8 => _8.requestId]) !== entry.requestId) return;
     clearTimeout(entry.timer);
     this.pending.delete(requestType);
-    entry.resolve(payload);
-  }
-  cancel(requestType) {
-    if (requestType) {
-      const entry = this.pending.get(requestType);
-      if (!entry) return;
-      clearTimeout(entry.timer);
-      this.pending.delete(requestType);
+    if (requestType === UI_REQUEST.REQUEST_SELECT_DEVICE && _optionalChain([response, 'optionalAccess', _9 => _9.cancelled]) === true) {
       entry.reject(
-        Object.assign(new Error(`UI request '${requestType}' was cancelled`), {
+        _chunkT5HIQPNGjs.createHwkError.call(void 0, {
+          code: 10005 /* UserAborted */,
+          message: "Device selection was cancelled",
           _tag: UI_REQUEST_CANCELLED_TAG
         })
       );
       return;
     }
-    for (const [type, entry] of this.pending) {
+    entry.resolve(payload);
+  }
+  /**
+   * Each argument narrows the cancel: none rejects every waiter (teardown); an `operationId` alone
+   * rejects only that operation's prompts and leaves another operation's PIN or QR wait untouched.
+   */
+  cancel(requestType, requestId, operationId) {
+    const reject = (type, entry) => {
       clearTimeout(entry.timer);
+      this.pending.delete(type);
       entry.reject(
         Object.assign(new Error(`UI request '${type}' was cancelled`), {
           _tag: UI_REQUEST_CANCELLED_TAG
         })
       );
+    };
+    if (requestType) {
+      const entry = this.pending.get(requestType);
+      if (!entry) return;
+      if (requestId !== void 0 && entry.requestId !== requestId) return;
+      if (operationId !== void 0 && entry.operationId !== operationId) return;
+      reject(requestType, entry);
+      return;
+    }
+    for (const [type, entry] of [...this.pending]) {
+      if (operationId === void 0 || entry.operationId === operationId) {
+        reject(type, entry);
+      }
     }
-    this.pending.clear();
   }
   reset() {
     this.cancel();
@@ -148,4 +180,4 @@ var UiRequestRegistry = class {
 
 
 exports.UI_EVENT = UI_EVENT; exports.UI_REQUEST = UI_REQUEST; exports.UI_RESPONSE = UI_RESPONSE; exports.UI_REQUEST_DEFAULT_TIMEOUT_MS = UI_REQUEST_DEFAULT_TIMEOUT_MS; exports.UI_REQUEST_PREEMPTED_TAG = UI_REQUEST_PREEMPTED_TAG; exports.UI_REQUEST_CANCELLED_TAG = UI_REQUEST_CANCELLED_TAG; exports.UI_REQUEST_TIMEOUT_TAG = UI_REQUEST_TIMEOUT_TAG; exports.UiRequestRegistry = UiRequestRegistry;
-//# sourceMappingURL=chunk-BAGEFFFY.js.map
+//# sourceMappingURL=chunk-H7BZ2C6J.js.map

package/dist/chunk-H7BZ2C6J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-H7BZ2C6J.js","../src/events/ui-request.ts","../src/utils/UiRequestRegistry.ts"],"names":[],"mappings":"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","file":"/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-H7BZ2C6J.js","sourcesContent":[null,"import type { QrResponseData } from '../types/qr';\n\nexport const UI_EVENT = 'UI_EVENT';\n\nexport const UI_REQUEST = {\n  REQUEST_PIN: 'ui-request-pin',\n  REQUEST_PASSPHRASE: 'ui-request-passphrase',\n  // One-way UI notification: device is waiting for passphrase entry on-device.\n  // The prompt response path remains RECEIVE_PASSPHRASE with passphraseOnDevice=true.\n  REQUEST_PASSPHRASE_ON_DEVICE: 'ui-request-passphrase-on-device',\n  REQUEST_BUTTON: 'ui-request-button',\n  REQUEST_QR_DISPLAY: 'ui-request-qr-display',\n  REQUEST_QR_SCAN: 'ui-request-qr-scan',\n  REQUEST_DEVICE_PERMISSION: 'ui-request-device-permission',\n  REQUEST_SELECT_DEVICE: 'ui-request-select-device',\n  REQUEST_SAVE_DEVICE_BINDING: 'ui-request-save-device-binding',\n  DEVICE_BINDING_STATUS: 'ui-device-binding-status',\n  REQUEST_DEVICE_CONNECT: 'ui-request-device-connect',\n  // Ledger BTC App: account index >= 100 requires display=true. Adapter asks\n  // the user once per session before promoting the call.\n  REQUEST_BTC_HIGH_INDEX_CONFIRM: 'ui-request-btc-high-index-confirm',\n  // Required app is not installed; with autoInstallApp on, ask the user\n  // whether to install it before retrying the operation.\n  REQUEST_INSTALL_APP: 'ui-request-install-app',\n  REQUEST_PREEMPTION: 'ui-request-preemption',\n  REQUEST_TREZOR_THP_PAIRING: 'ui-request-trezor-thp-pairing',\n  CLOSE_UI_WINDOW: 'ui-close',\n  DEVICE_PROGRESS: 'ui-device_progress',\n  FIRMWARE_PROGRESS: 'ui-firmware-progress',\n  FIRMWARE_TIP: 'ui-firmware-tip',\n} as const;\n\nexport const UI_RESPONSE = {\n  RECEIVE_PIN: 'receive-pin',\n  RECEIVE_PASSPHRASE: 'receive-passphrase',\n  RECEIVE_QR_RESPONSE: 'receive-qr-response',\n  RECEIVE_SELECT_DEVICE: 'receive-select-device',\n  RECEIVE_SAVE_DEVICE_BINDING: 'receive-save-device-binding',\n  RECEIVE_DEVICE_CONNECT: 'receive-device-connect',\n  RECEIVE_DEVICE_PERMISSION: 'receive-device-permission',\n  RECEIVE_BTC_HIGH_INDEX_CONFIRM: 'receive-btc-high-index-confirm',\n  RECEIVE_INSTALL_APP: 'receive-install-app',\n  RECEIVE_PREEMPTION: 'receive-preemption',\n  RECEIVE_TREZOR_THP_PAIRING: 'receive-trezor-thp-pairing',\n  CANCEL: 'cancel',\n} as const;\n\n/**\n * The operation a UI request was opened under, so a cancel for one operation spares another's\n * prompts. Absent outside any operation (cold start, teardown).\n */\nexport type UiRequestOperationAttribution = {\n  operationId?: string;\n};\n\nexport type DevicePermissionDeniedReason =\n  | 'bluetoothTurnedOff'\n  | 'permissionDenied'\n  | (string & Record<never, never>);\n\nexport type DevicePermissionResponse = {\n  granted: boolean;\n  reason?: DevicePermissionDeniedReason;\n  message?: string;\n};\n\n/**\n * `mismatch`: the selected device is not this operation's device, surfaced as `DeviceMismatch`.\n * `skipped`: the host had nothing to bind, a host contract problem rather than a user action.\n */\nexport type SaveDeviceBindingDeclineReason = 'mismatch' | 'skipped';\n\nexport type UiResponseEvent =\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_SAVE_DEVICE_BINDING;\n      payload: {\n        requestId: string;\n        saved: boolean;\n        reason?: SaveDeviceBindingDeclineReason;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PIN;\n      payload: string;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PASSPHRASE;\n      payload: {\n        value: string;\n        passphraseOnDevice?: boolean;\n        save?: boolean;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_QR_RESPONSE;\n      payload: QrResponseData;\n    }\n  | {\n      // sdkConnectId echoes one of the DeviceInfo.connectId values emitted in\n      // the REQUEST_SELECT_DEVICE event's `devices` list. Scope is the current\n      // search session; may be ephemeral (e.g. Ledger USB DMK UUID).\n      type: typeof UI_RESPONSE.RECEIVE_SELECT_DEVICE;\n      payload: { requestId?: string } & (\n        | { sdkConnectId: string; cancelled?: false }\n        | { cancelled: true }\n      );\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_CONNECT;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_PERMISSION;\n      payload: DevicePermissionResponse;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_INSTALL_APP;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PREEMPTION;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING;\n      payload: {\n        selectedMethod?: number | string;\n        tag?: string;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.CANCEL;\n      payload?: undefined;\n    };\n","import { UI_REQUEST, UI_RESPONSE } from '../events/ui-request';\nimport { createHwkError, HardwareErrorCode } from '../types/errors';\n\n/** 10 min — every UI request is human-in-the-loop; bias toward \"wait long\". */\nexport const UI_REQUEST_DEFAULT_TIMEOUT_MS = 600_000;\n\nconst RESPONSE_TO_REQUEST: Record<string, string> = {\n  [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,\n  [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,\n  [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,\n  [UI_RESPONSE.RECEIVE_SAVE_DEVICE_BINDING]: UI_REQUEST.REQUEST_SAVE_DEVICE_BINDING,\n  [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,\n  [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,\n  [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,\n  [UI_RESPONSE.RECEIVE_INSTALL_APP]: UI_REQUEST.REQUEST_INSTALL_APP,\n  [UI_RESPONSE.RECEIVE_PREEMPTION]: UI_REQUEST.REQUEST_PREEMPTION,\n  [UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING]: UI_REQUEST.REQUEST_TREZOR_THP_PAIRING,\n  // RECEIVE_QR_RESPONSE maps to QR_DISPLAY or QR_SCAN — resolved dynamically below.\n};\n\nexport const UI_REQUEST_PREEMPTED_TAG = 'UiRequestPreempted';\nexport const UI_REQUEST_CANCELLED_TAG = 'UiRequestCancelled';\nexport const UI_REQUEST_TIMEOUT_TAG = 'UiRequestTimeout';\n\nlet requestSequence = 0;\n\ntype PendingEntry = {\n  requestId?: string;\n  /** The operation this waiter belongs to, when it was opened under one. */\n  operationId?: string;\n  resolve: (payload: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Per-type single-slot registry for adapter-level UI requests. A new `wait`\n * of the same type supersedes (rejects) the prior pending entry. With the\n * job queue running globally serially, cross-type collisions don't occur in\n * normal flow — same-type preemption is a defensive measure for callers\n * that fire the same request twice without waiting on the first.\n *\n * Unknown response types are dropped silently so the public `uiResponse`\n * entry never throws.\n */\nexport class UiRequestRegistry {\n  private pending = new Map<string, PendingEntry>();\n\n  createRequestId(): string {\n    requestSequence += 1;\n    return `hwk-ui-${Date.now()}-${requestSequence}`;\n  }\n\n  wait<T = unknown>(\n    requestType: string,\n    options?: { timeoutMs?: number; requestId?: string; operationId?: string }\n  ): Promise<T> {\n    const existing = this.pending.get(requestType);\n    if (existing) {\n      clearTimeout(existing.timer);\n      this.pending.delete(requestType);\n      existing.reject(\n        Object.assign(new Error(`UI request '${requestType}' was superseded by a new request`), {\n          _tag: UI_REQUEST_PREEMPTED_TAG,\n        })\n      );\n    }\n\n    const timeoutMs = options?.timeoutMs ?? UI_REQUEST_DEFAULT_TIMEOUT_MS;\n\n    return new Promise<T>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        if (this.pending.get(requestType)?.timer === timer) {\n          this.pending.delete(requestType);\n          reject(\n            Object.assign(new Error(`UI request '${requestType}' timed out after ${timeoutMs}ms`), {\n              _tag: UI_REQUEST_TIMEOUT_TAG,\n            })\n          );\n        }\n      }, timeoutMs);\n\n      this.pending.set(requestType, {\n        requestId: options?.requestId,\n        operationId: options?.operationId,\n        resolve: resolve as (payload: unknown) => void,\n        reject,\n        timer,\n      });\n    });\n  }\n\n  resolve(responseType: string, payload: unknown): void {\n    let requestType = RESPONSE_TO_REQUEST[responseType];\n    if (responseType === UI_RESPONSE.RECEIVE_QR_RESPONSE) {\n      if (this.pending.has(UI_REQUEST.REQUEST_QR_DISPLAY)) {\n        requestType = UI_REQUEST.REQUEST_QR_DISPLAY;\n      } else if (this.pending.has(UI_REQUEST.REQUEST_QR_SCAN)) {\n        requestType = UI_REQUEST.REQUEST_QR_SCAN;\n      }\n    }\n    if (!requestType) return;\n\n    const entry = this.pending.get(requestType);\n    if (!entry) return;\n\n    const response =\n      payload && typeof payload === 'object'\n        ? (payload as { requestId?: unknown; cancelled?: unknown })\n        : undefined;\n    // A late response must not resolve (or cancel) a newer request of the same type.\n    if (entry.requestId !== undefined && response?.requestId !== entry.requestId) return;\n    clearTimeout(entry.timer);\n    this.pending.delete(requestType);\n    if (requestType === UI_REQUEST.REQUEST_SELECT_DEVICE && response?.cancelled === true) {\n      entry.reject(\n        createHwkError({\n          code: HardwareErrorCode.UserAborted,\n          message: 'Device selection was cancelled',\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n      return;\n    }\n    entry.resolve(payload);\n  }\n\n  /**\n   * Each argument narrows the cancel: none rejects every waiter (teardown); an `operationId` alone\n   * rejects only that operation's prompts and leaves another operation's PIN or QR wait untouched.\n   */\n  cancel(requestType?: string, requestId?: string, operationId?: string): void {\n    const reject = (type: string, entry: PendingEntry) => {\n      clearTimeout(entry.timer);\n      this.pending.delete(type);\n      entry.reject(\n        Object.assign(new Error(`UI request '${type}' was cancelled`), {\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n    };\n\n    if (requestType) {\n      const entry = this.pending.get(requestType);\n      if (!entry) return;\n      if (requestId !== undefined && entry.requestId !== requestId) return;\n      if (operationId !== undefined && entry.operationId !== operationId) return;\n      reject(requestType, entry);\n      return;\n    }\n\n    for (const [type, entry] of [...this.pending]) {\n      if (operationId === undefined || entry.operationId === operationId) {\n        reject(type, entry);\n      }\n    }\n  }\n\n  reset(): void {\n    this.cancel();\n  }\n\n  hasPending(requestType?: string): boolean {\n    if (requestType) return this.pending.has(requestType);\n    return this.pending.size > 0;\n  }\n}\n"]}