@onekeyfe/hwk-adapter-core 1.2.3-alpha.1 → 1.2.3-alpha.3

package/dist/index.js

@@ -10,7 +10,7 @@ var _chunk7SFFS2NLjs = require('./chunk-7SFFS2NL.js');
 
 
 
-var _chunkRRCFH7X6js = require('./chunk-RRCFH7X6.js');
+var _chunkS7X2HM7Pjs = require('./chunk-S7X2HM7P.js');
 
 
 
@@ -19,7 +19,7 @@ var _chunkRRCFH7X6js = require('./chunk-RRCFH7X6.js');
 
 
 
-var _chunkIZEVYMJKjs = require('./chunk-IZEVYMJK.js');
+var _chunkZ3IH25KVjs = require('./chunk-Z3IH25KV.js');
 
 // src/types/response.ts
 function success(payload) {
@@ -32,7 +32,7 @@ function failure(code, error, params, origin, recovery) {
       error,
       code,
       ...origin !== void 0 ? { origin } : {},
-      recovery: _nullishCoalesce(recovery, () => ( _chunkIZEVYMJKjs.defaultRecoveryForCode.call(void 0, code))),
+      recovery: _nullishCoalesce(recovery, () => ( _chunkZ3IH25KVjs.defaultRecoveryForCode.call(void 0, code))),
       ...params ? { params } : {}
     }
   };
@@ -76,10 +76,6 @@ var DEVICE = {
   DISCONNECT: "device-disconnect",
   CHANGED: "device-changed",
   FEATURES: "features",
-  /** Trezor transport binding, emitted only after matching the expected firmware device_id. */
-  TREZOR_CONNECTION_VERIFIED: "device-trezor-connection-verified",
-  /** Ledger BLE address repair, emitted only after matching the stored chain fingerprint. */
-  LEDGER_CONNECTION_VERIFIED: "device-ledger-connection-verified",
   /**
    * Trezor-only. Emitted after a successful THP handshake that minted or
    * refreshed pairing credentials. The host should persist `credentials`
@@ -99,7 +95,7 @@ var SDK = {
   DEVICE_UNRESPONSIVE: "device-unresponsive",
   DEVICE_RECOVERED: "device-recovered",
   DEVICE_INTERACTION: "device-interaction",
-  INTERACTION_ENDED: "interaction-ended"
+  OPERATION_ENDED: "operation-ended"
 };
 
 // src/utils/DeviceJobQueue.ts
@@ -130,12 +126,13 @@ var DeviceJobQueue = class {
       abortController: ac,
       startedAt: Date.now()
     };
-    this._jobs.set(jobToken, { deviceId });
+    this._jobs.set(jobToken, activeJob);
     const next = prev.catch(() => {
     }).then(async () => {
       if (this._generation !== gen) {
         throw _nullishCoalesce(this._generationCancelReasons.get(gen), () => ( new Error("Job cancelled: queue was cleared")));
       }
+      if (ac.signal.aborted) throw ac.signal.reason;
       this._active = activeJob;
       try {
         return await job(ac.signal);
@@ -151,31 +148,27 @@ var DeviceJobQueue = class {
     });
     return next;
   }
-  /** Cancel the active job. If `deviceId` is given, only cancels when it matches. */
-  cancelActive(deviceId) {
+  /** Cancel the running job. `reason` becomes signal.reason. */
+  cancelActive(deviceId, reason) {
     if (!this._active) return false;
     if (deviceId && this._active.deviceId !== deviceId) return false;
-    this._active.abortController.abort(new Error("Manually cancelled"));
+    this._active.abortController.abort(_nullishCoalesce(reason, () => ( new Error("Cancelled"))));
     return true;
   }
-  /** Force cancel the active job. `reason` becomes signal.reason. */
-  forceCancelActive(deviceId, reason) {
-    if (!this._active) return false;
-    if (deviceId && this._active.deviceId !== deviceId) return false;
-    this._active.abortController.abort(_nullishCoalesce(reason, () => ( new Error("Force cancelled for recovery"))));
-    return true;
-  }
-  /** Cancel the active job (alias for callers that previously needed multi-device cancel). */
-  cancelAllActive(reason) {
-    if (!this._active) return;
-    this._active.abortController.abort(_nullishCoalesce(reason, () => ( new Error("Cancelled by cancelAllActive"))));
-  }
   /** Cancel the active job and invalidate queued jobs that have not started. */
   cancelActiveAndPending(deviceId, reason) {
-    if (deviceId && this._active && this._active.deviceId !== deviceId) {
-      return false;
+    const cancelReason = _nullishCoalesce(reason, () => ( new Error("Cancelled by cancelActiveAndPending")));
+    if (deviceId) {
+      let cancelled = false;
+      for (const job of this._jobs.values()) {
+        if (job.deviceId === deviceId) {
+          job.abortController.abort(cancelReason);
+          cancelled = true;
+        }
+      }
+      return cancelled;
     }
-    this.clear(_nullishCoalesce(reason, () => ( new Error("Cancelled by cancelActiveAndPending"))));
+    this.clear(cancelReason);
     return true;
   }
   /** Get info about the currently active job, or null if idle. */
@@ -188,10 +181,6 @@ var DeviceJobQueue = class {
       startedAt: this._active.startedAt
     };
   }
-  /** True if any job is currently running. */
-  isBusy() {
-    return this._jobs.size > 0;
-  }
   clear(reason) {
     const cancelledGeneration = this._generation;
     this._generation++;
@@ -210,22 +199,28 @@ var DeviceJobQueue = class {
 
 // src/utils/hardwareRuntimeId.ts
 
-var HARDWARE_RUNTIME_ID_PREFIX = "hwk:runtime:v1";
+var HARDWARE_RUNTIME_ID_PREFIX = "hwk:runtime";
 var RANDOM_ID_BYTES = 16;
 var RANDOM_ID_PATTERN = /^[0-9a-f]{32}$/;
+var KINDS = /* @__PURE__ */ new Set([
+  "operation",
+  "search-target",
+  "link"
+]);
 var VENDORS = /* @__PURE__ */ new Set(["trezor", "ledger", "keystone"]);
-var CONNECTION_TYPES = /* @__PURE__ */ new Set(["usb", "ble", "qr"]);
-function createNonce() {
-  return _utils.bytesToHex.call(void 0, _utils.randomBytes.call(void 0, RANDOM_ID_BYTES));
+function create(kind, vendor) {
+  return `${HARDWARE_RUNTIME_ID_PREFIX}:${kind}:${vendor}:${_utils.bytesToHex.call(void 0, 
+    _utils.randomBytes.call(void 0, RANDOM_ID_BYTES)
+  )}`;
 }
-function createHardwareInteractionId(vendor) {
-  return `${HARDWARE_RUNTIME_ID_PREFIX}:interaction:${vendor}:${createNonce()}`;
+function createHardwareOperationId(vendor) {
+  return create("operation", vendor);
 }
-function createHardwareSearchTargetId(params) {
-  return `${HARDWARE_RUNTIME_ID_PREFIX}:search-target:${params.vendor}:${params.connectionType}:${createNonce()}`;
+function createHardwareSearchTargetId(vendor) {
+  return create("search-target", vendor);
 }
-function createHardwareConnectorSessionId(params) {
-  return `${HARDWARE_RUNTIME_ID_PREFIX}:connector-session:${params.vendor}:${params.connectionType}:${createNonce()}`;
+function createHardwareLinkId(vendor) {
+  return create("link", vendor);
 }
 function hasHardwareRuntimeIdPrefix(value) {
   return typeof value === "string" && value.startsWith(`${HARDWARE_RUNTIME_ID_PREFIX}:`);
@@ -233,50 +228,32 @@ function hasHardwareRuntimeIdPrefix(value) {
 function parseHardwareRuntimeId(value) {
   if (!hasHardwareRuntimeIdPrefix(value)) return void 0;
   const parts = value.split(":");
-  const kind = parts[3];
-  const vendor = parts[4];
-  if (!VENDORS.has(vendor)) return void 0;
-  if (kind === "interaction" && parts.length === 6 && RANDOM_ID_PATTERN.test(parts[5])) {
-    return {
-      kind,
-      vendor,
-      nonce: parts[5]
-    };
-  }
-  const connectionType = parts[5];
-  if ((kind === "search-target" || kind === "connector-session") && parts.length === 7 && CONNECTION_TYPES.has(connectionType) && RANDOM_ID_PATTERN.test(parts[6])) {
-    return {
-      kind,
-      vendor,
-      connectionType,
-      nonce: parts[6]
-    };
+  if (parts.length !== 5) return void 0;
+  const [, , kind, vendor, nonce] = parts;
+  if (!KINDS.has(kind) || !VENDORS.has(vendor) || !RANDOM_ID_PATTERN.test(nonce)) {
+    return void 0;
   }
-  return void 0;
+  return { kind, vendor };
 }
-function isHardwareInteractionId(value) {
-  return _optionalChain([parseHardwareRuntimeId, 'call', _3 => _3(value), 'optionalAccess', _4 => _4.kind]) === "interaction";
-}
-function isHardwareSearchTargetId(value) {
-  return _optionalChain([parseHardwareRuntimeId, 'call', _5 => _5(value), 'optionalAccess', _6 => _6.kind]) === "search-target";
+function isHardwareOperationId(value) {
+  return _optionalChain([parseHardwareRuntimeId, 'call', _3 => _3(value), 'optionalAccess', _4 => _4.kind]) === "operation";
 }
 
-// src/utils/InteractionRegistry.ts
-var INTERACTION_DEFAULT_TTL_MS = 6e5;
-var InteractionRegistry = class {
+// src/utils/OperationRegistry.ts
+var OPERATION_DEFAULT_TTL_MS = 6e5;
+var OperationRegistry = class {
   constructor(options) {
     this._active = /* @__PURE__ */ new Map();
     this._ended = /* @__PURE__ */ new Map();
     this._vendor = options.vendor;
-    this._ttlMs = _nullishCoalesce(options.ttlMs, () => ( INTERACTION_DEFAULT_TTL_MS));
+    this._ttlMs = _nullishCoalesce(options.ttlMs, () => ( OPERATION_DEFAULT_TTL_MS));
     this._onEnded = options.onEnded;
   }
   create(params) {
     const now = Date.now();
-    const interactionId = createHardwareInteractionId(this._vendor);
-    const interaction = {
-      interactionId,
-      searchTargetId: params.searchTargetId,
+    const operationId = createHardwareOperationId(this._vendor);
+    const operation = {
+      operationId,
       connectId: params.connectId,
       device: params.device,
       connectionKeys: Array.from(
@@ -289,35 +266,35 @@ var InteractionRegistry = class {
       createdAt: now,
       lastActiveAt: now
     };
-    const timer = this._createTimer(interactionId);
-    this._active.set(interactionId, { ...interaction, timer, retainCount: 0 });
-    return interaction;
+    const timer = this._createTimer(operationId);
+    this._active.set(operationId, { ...operation, timer, retainCount: 0 });
+    return operation;
   }
-  resolve(interactionId) {
-    const active = this._active.get(interactionId);
+  resolve(operationId) {
+    const active = this._active.get(operationId);
     if (!active) {
-      const ended = this._ended.get(interactionId);
+      const ended = this._ended.get(operationId);
       if (ended) {
-        throw _chunkIZEVYMJKjs.createHwkError.call(void 0, {
-          code: 10113 /* InteractionEnded */,
-          message: `Hardware interaction has ended (${ended.reason})`,
-          params: { interactionId, reason: ended.reason }
+        throw _chunkZ3IH25KVjs.createHwkError.call(void 0, {
+          code: 10113 /* OperationEnded */,
+          message: `Hardware operation has ended (${ended.reason})`,
+          params: { operationId, reason: ended.reason }
         });
       }
-      throw _chunkIZEVYMJKjs.createHwkError.call(void 0, {
-        code: 10112 /* InteractionNotFound */,
-        message: "Hardware interaction was not found",
-        params: { interactionId }
+      throw _chunkZ3IH25KVjs.createHwkError.call(void 0, {
+        code: 10112 /* OperationNotFound */,
+        message: "Hardware operation was not found",
+        params: { operationId }
       });
     }
     if (active.timer) clearTimeout(active.timer);
     active.lastActiveAt = Date.now();
-    active.timer = active.retainCount === 0 ? this._createTimer(interactionId) : void 0;
+    active.timer = active.retainCount === 0 ? this._createTimer(operationId) : void 0;
     return active;
   }
-  /** Keep an interaction alive while one device job is actively using it. */
-  retain(interactionId) {
-    const active = this.resolve(interactionId);
+  /** Keep an operation alive while one device job is actively using it. */
+  retain(operationId) {
+    const active = this.resolve(operationId);
     if (active.timer) clearTimeout(active.timer);
     active.timer = void 0;
     active.retainCount += 1;
@@ -325,31 +302,31 @@ var InteractionRegistry = class {
     return () => {
       if (released) return;
       released = true;
-      const current = this._active.get(interactionId);
+      const current = this._active.get(operationId);
       if (!current) return;
       current.retainCount = Math.max(0, current.retainCount - 1);
       current.lastActiveAt = Date.now();
       if (current.retainCount === 0) {
-        current.timer = this._createTimer(interactionId);
+        current.timer = this._createTimer(operationId);
       }
     };
   }
   /** Return active or tombstoned binding data without refreshing its TTL. */
-  find(interactionId) {
-    return _nullishCoalesce(this._active.get(interactionId), () => ( _optionalChain([this, 'access', _7 => _7._ended, 'access', _8 => _8.get, 'call', _9 => _9(interactionId), 'optionalAccess', _10 => _10.interaction])));
+  find(operationId) {
+    return _nullishCoalesce(this._active.get(operationId), () => ( _optionalChain([this, 'access', _5 => _5._ended, 'access', _6 => _6.get, 'call', _7 => _7(operationId), 'optionalAccess', _8 => _8.operation])));
   }
   findActiveByConnectionKey(connectionKey) {
     if (!connectionKey) return void 0;
     return [...this._active.values()].find(
-      (interaction) => interaction.connectionKeys.includes(connectionKey)
+      (operation) => operation.connectionKeys.includes(connectionKey)
     );
   }
   /** Replace the live transport binding after the same target was reconnected. */
-  rebind(interactionId, params) {
-    const active = this._active.get(interactionId);
+  rebind(operationId, params) {
+    const active = this._active.get(operationId);
     if (!active) {
-      this.resolve(interactionId);
-      throw new Error("Unreachable interaction rebind");
+      this.resolve(operationId);
+      throw new Error("Unreachable operation rebind");
     }
     if (active.timer) clearTimeout(active.timer);
     active.connectId = params.connectId;
@@ -358,42 +335,42 @@ var InteractionRegistry = class {
       new Set([params.connectId, ..._nullishCoalesce(params.connectionKeys, () => ( []))].filter(Boolean))
     );
     active.lastActiveAt = Date.now();
-    active.timer = active.retainCount === 0 ? this._createTimer(interactionId) : void 0;
+    active.timer = active.retainCount === 0 ? this._createTimer(operationId) : void 0;
     return active;
   }
-  end(interactionId, reason) {
-    const active = this._active.get(interactionId);
+  end(operationId, reason) {
+    const active = this._active.get(operationId);
     if (!active) return void 0;
     if (active.timer) clearTimeout(active.timer);
-    this._active.delete(interactionId);
+    this._active.delete(operationId);
     this._rememberEnded(active, reason);
-    _optionalChain([this, 'access', _11 => _11._onEnded, 'optionalCall', _12 => _12(active, reason)]);
+    _optionalChain([this, 'access', _9 => _9._onEnded, 'optionalCall', _10 => _10(active, reason)]);
     return active;
   }
-  endByConnectionKey(connectionKey, reason, exceptInteractionId) {
+  endByConnectionKey(connectionKey, reason, exceptOperationId) {
     if (!connectionKey) return;
-    for (const interaction of [...this._active.values()]) {
-      if (interaction.interactionId === exceptInteractionId) continue;
-      if (interaction.connectionKeys.includes(connectionKey)) {
-        this.end(interaction.interactionId, reason);
+    for (const operation of [...this._active.values()]) {
+      if (operation.operationId === exceptOperationId) continue;
+      if (operation.connectionKeys.includes(connectionKey)) {
+        this.end(operation.operationId, reason);
       }
     }
   }
-  endAll(reason, exceptInteractionId) {
-    for (const interactionId of [...this._active.keys()]) {
-      if (interactionId === exceptInteractionId) continue;
-      this.end(interactionId, reason);
+  endAll(reason, exceptOperationId) {
+    for (const operationId of [...this._active.keys()]) {
+      if (operationId === exceptOperationId) continue;
+      this.end(operationId, reason);
     }
   }
-  _createTimer(interactionId) {
+  _createTimer(operationId) {
     const timer = setTimeout(() => {
-      this.end(interactionId, "timeout");
+      this.end(operationId, "timeout");
     }, this._ttlMs);
-    _optionalChain([timer, 'access', _13 => _13.unref, 'optionalCall', _14 => _14()]);
+    _optionalChain([timer, 'access', _11 => _11.unref, 'optionalCall', _12 => _12()]);
     return timer;
   }
-  _rememberEnded(interaction, reason) {
-    this._ended.set(interaction.interactionId, { reason, interaction });
+  _rememberEnded(operation, reason) {
+    this._ended.set(operation.operationId, { reason, operation });
     if (this._ended.size <= 100) return;
     const oldest = this._ended.keys().next().value;
     if (oldest) this._ended.delete(oldest);
@@ -401,40 +378,40 @@ var InteractionRegistry = class {
 };
 
 // src/utils/hardwareOperationTarget.ts
-function resolveHardwareOperationTarget(positionalTargetId, commonInteractionId, expectedVendor) {
+function resolveHardwareOperationTarget(positionalTargetId, commonOperationId, expectedVendor) {
   const normalizedPositionalTargetId = _nullishCoalesce(positionalTargetId, () => ( void 0));
-  const normalizedCommonInteractionId = commonInteractionId || void 0;
-  const positionalInteractionId = isHardwareInteractionId(normalizedPositionalTargetId) ? normalizedPositionalTargetId : void 0;
+  const normalizedCommonOperationId = commonOperationId || void 0;
+  const positionalOperationId = isHardwareOperationId(normalizedPositionalTargetId) ? normalizedPositionalTargetId : void 0;
   const parsedPositionalTarget = parseHardwareRuntimeId(normalizedPositionalTargetId);
-  const parsedCommonInteraction = parseHardwareRuntimeId(normalizedCommonInteractionId);
+  const parsedCommonOperation = parseHardwareRuntimeId(normalizedCommonOperationId);
   if (normalizedPositionalTargetId && hasHardwareRuntimeIdPrefix(normalizedPositionalTargetId) && !parsedPositionalTarget) {
     return failure(10002 /* InvalidParams */, "Invalid hardware operation target id");
   }
-  if (_optionalChain([parsedPositionalTarget, 'optionalAccess', _15 => _15.kind]) === "connector-session") {
+  if (_optionalChain([parsedPositionalTarget, 'optionalAccess', _13 => _13.kind]) === "link") {
     return failure(
       10002 /* InvalidParams */,
-      "Hardware connector session id cannot be used as an operation target"
+      "Hardware transport link id cannot be used as an operation target"
     );
   }
-  if (normalizedCommonInteractionId && _optionalChain([parsedCommonInteraction, 'optionalAccess', _16 => _16.kind]) !== "interaction") {
-    return failure(10002 /* InvalidParams */, "Invalid hardware interaction id");
+  if (normalizedCommonOperationId && _optionalChain([parsedCommonOperation, 'optionalAccess', _14 => _14.kind]) !== "operation") {
+    return failure(10002 /* InvalidParams */, "Invalid hardware operation id");
   }
-  if (expectedVendor && (parsedPositionalTarget && parsedPositionalTarget.vendor !== expectedVendor || parsedCommonInteraction && parsedCommonInteraction.vendor !== expectedVendor)) {
+  if (expectedVendor && (parsedPositionalTarget && parsedPositionalTarget.vendor !== expectedVendor || parsedCommonOperation && parsedCommonOperation.vendor !== expectedVendor)) {
     return failure(
       10002 /* InvalidParams */,
-      `Hardware interaction does not belong to ${expectedVendor}`
+      `Hardware operation does not belong to ${expectedVendor}`
     );
   }
-  if (positionalInteractionId && normalizedCommonInteractionId && positionalInteractionId !== normalizedCommonInteractionId) {
-    return failure(10002 /* InvalidParams */, "Conflicting hardware interaction ids", {
-      positionalInteractionId,
-      commonInteractionId: normalizedCommonInteractionId
+  if (positionalOperationId && normalizedCommonOperationId && positionalOperationId !== normalizedCommonOperationId) {
+    return failure(10002 /* InvalidParams */, "Conflicting hardware operation ids", {
+      positionalOperationId,
+      commonOperationId: normalizedCommonOperationId
     });
   }
-  const interactionId = _nullishCoalesce(normalizedCommonInteractionId, () => ( positionalInteractionId));
+  const operationId = _nullishCoalesce(normalizedCommonOperationId, () => ( positionalOperationId));
   return success({
-    interactionId,
-    targetId: _nullishCoalesce(interactionId, () => ( normalizedPositionalTargetId))
+    operationId,
+    targetId: _nullishCoalesce(operationId, () => ( normalizedPositionalTargetId))
   });
 }
 
@@ -474,14 +451,14 @@ function createBridgedConnector(vendor, connectionType, bridge) {
     },
     off: (event, handler) => {
       const inner = handlerMap.get(event);
-      const bridgeHandler = _optionalChain([inner, 'optionalAccess', _17 => _17.get, 'call', _18 => _18(handler)]);
+      const bridgeHandler = _optionalChain([inner, 'optionalAccess', _15 => _15.get, 'call', _16 => _16(handler)]);
       if (!bridgeHandler || !inner) return;
       bridge.offEvent({ vendor }, bridgeHandler);
       inner.delete(handler);
       if (inner.size === 0) handlerMap.delete(event);
     },
     reset: () => bridge.reset({ vendor }),
-    configure: bridge.configure ? (config) => _optionalChain([bridge, 'access', _19 => _19.configure, 'optionalCall', _20 => _20({ vendor, config })]) : void 0,
+    configure: bridge.configure ? (config) => _optionalChain([bridge, 'access', _17 => _17.configure, 'optionalCall', _18 => _18({ vendor, config })]) : void 0,
     setKnownCredentials: bridge.setKnownCredentials ? (credentials) => bridge.setKnownCredentials({ vendor, credentials }) : void 0
   };
 }
@@ -550,13 +527,13 @@ function isDeviceUnavailableError(error) {
   return false;
 }
 function combinedDeviceNotFoundError(message) {
-  return _chunkIZEVYMJKjs.createHwkError.call(void 0, {
+  return _chunkZ3IH25KVjs.createHwkError.call(void 0, {
     code: 10100 /* DeviceNotFound */,
     message
   });
 }
 function combinedSessionNotFoundError(message) {
-  return _chunkIZEVYMJKjs.createHwkError.call(void 0, {
+  return _chunkZ3IH25KVjs.createHwkError.call(void 0, {
     code: 10101 /* DeviceDisconnected */,
     message
   });
@@ -585,7 +562,7 @@ function createCombinedConnector(connectors) {
   };
   const broadcastCredentials = async () => {
     await Promise.all(
-      connectors.map((child) => Promise.resolve(_optionalChain([child, 'access', _21 => _21.setKnownCredentials, 'optionalCall', _22 => _22(sharedCredentials)])))
+      connectors.map((child) => Promise.resolve(_optionalChain([child, 'access', _19 => _19.setKnownCredentials, 'optionalCall', _20 => _20(sharedCredentials)])))
     );
   };
   for (const child of connectors) {
@@ -655,7 +632,7 @@ function createCombinedConnector(connectors) {
     return merged.sort((a, b) => rank(a) - rank(b));
   };
   const resolveOwner = async (deviceId, transportType) => {
-    if (deviceId && deviceOwner.has(deviceId) && (!transportType || _optionalChain([deviceOwner, 'access', _23 => _23.get, 'call', _24 => _24(deviceId), 'optionalAccess', _25 => _25.connectionType]) === transportType)) {
+    if (deviceId && deviceOwner.has(deviceId) && (!transportType || _optionalChain([deviceOwner, 'access', _21 => _21.get, 'call', _22 => _22(deviceId), 'optionalAccess', _23 => _23.connectionType]) === transportType)) {
       return { owner: deviceOwner.get(deviceId), deviceId };
     }
     const devices = await searchDevices({ waitForAll: Boolean(deviceId), transportType });
@@ -689,7 +666,7 @@ function createCombinedConnector(connectors) {
       }
     }
     const message = lastError instanceof Error ? lastError.message : `Combined connector: device not found: ${deviceId}`;
-    throw _chunkIZEVYMJKjs.createHwkError.call(void 0, {
+    throw _chunkZ3IH25KVjs.createHwkError.call(void 0, {
       code: 10100 /* DeviceNotFound */,
       message
     });
@@ -704,9 +681,9 @@ function createCombinedConnector(connectors) {
       let owner;
       let session;
       if (deviceId) {
-        ({ session, owner } = await connectByExplicitId(deviceId, _optionalChain([options, 'optionalAccess', _26 => _26.transportType])));
+        ({ session, owner } = await connectByExplicitId(deviceId, _optionalChain([options, 'optionalAccess', _24 => _24.transportType])));
       } else {
-        const resolved = await resolveOwner(void 0, _optionalChain([options, 'optionalAccess', _27 => _27.transportType]));
+        const resolved = await resolveOwner(void 0, _optionalChain([options, 'optionalAccess', _25 => _25.transportType]));
         owner = resolved.owner;
         session = await owner.connect(resolved.deviceId);
       }
@@ -749,7 +726,7 @@ function createCombinedConnector(connectors) {
     },
     off: (event, handler) => {
       const inner = forwarders.get(event);
-      const attached = _optionalChain([inner, 'optionalAccess', _28 => _28.get, 'call', _29 => _29(handler)]);
+      const attached = _optionalChain([inner, 'optionalAccess', _26 => _26.get, 'call', _27 => _27(handler)]);
       if (!attached || !inner) return;
       for (const { child, handler: forward } of attached) {
         child.off(event, forward);
@@ -764,7 +741,7 @@ function createCombinedConnector(connectors) {
       forwarders.clear();
     },
     configure: connectors.some((c) => c.configure) ? async (config) => {
-      await Promise.all(connectors.map((child) => Promise.resolve(_optionalChain([child, 'access', _30 => _30.configure, 'optionalCall', _31 => _31(config)]))));
+      await Promise.all(connectors.map((child) => Promise.resolve(_optionalChain([child, 'access', _28 => _28.configure, 'optionalCall', _29 => _29(config)]))));
       deviceOwner.clear();
       sessionOwner.clear();
     } : void 0,
@@ -808,44 +785,51 @@ var TypedEventEmitter = class {
   }
   /** Number of listeners registered for `event`. 0 if none. */
   listenerCount(event) {
-    return _nullishCoalesce(_optionalChain([this, 'access', _32 => _32._listeners, 'access', _33 => _33.get, 'call', _34 => _34(event), 'optionalAccess', _35 => _35.size]), () => ( 0));
+    return _nullishCoalesce(_optionalChain([this, 'access', _30 => _30._listeners, 'access', _31 => _31.get, 'call', _32 => _32(event), 'optionalAccess', _33 => _33.size]), () => ( 0));
   }
 };
 
 // src/utils/requestSaveDeviceBinding.ts
 async function requestSaveDeviceBinding(emitter, registry, binding, signal) {
-  const type = _chunkRRCFH7X6js.UI_REQUEST.REQUEST_SAVE_DEVICE_BINDING;
-  if (!emitter.listenerCount(type)) return false;
-  if (_optionalChain([signal, 'optionalAccess', _36 => _36.aborted])) throw signal.reason;
+  const type = _chunkS7X2HM7Pjs.UI_REQUEST.REQUEST_SAVE_DEVICE_BINDING;
+  const declined = (reason) => {
+    emitter.emit(_chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS, {
+      type: _chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS,
+      payload: { selectionRequestId: binding.selectionRequestId, status: "failed" }
+    });
+    return { saved: false, reason };
+  };
+  if (!emitter.listenerCount(type)) {
+    return declined("skipped");
+  }
+  if (_optionalChain([signal, 'optionalAccess', _34 => _34.aborted])) throw signal.reason;
   const requestId = registry.createRequestId();
   const pending = registry.wait(type, { requestId });
   void pending.catch(() => void 0);
   const cancel = () => registry.cancel(type, requestId);
-  _optionalChain([signal, 'optionalAccess', _37 => _37.addEventListener, 'call', _38 => _38("abort", cancel, { once: true })]);
+  _optionalChain([signal, 'optionalAccess', _35 => _35.addEventListener, 'call', _36 => _36("abort", cancel, { once: true })]);
   try {
     emitter.emit(type, { type, payload: { ...binding, requestId } });
     const response = await pending;
-    if (_optionalChain([signal, 'optionalAccess', _39 => _39.aborted])) throw signal.reason;
-    if (_optionalChain([response, 'optionalAccess', _40 => _40.saved]) !== true) {
-      throw _chunkIZEVYMJKjs.createHwkError.call(void 0, {
-        code: 1e4 /* UnknownError */,
-        message: "Verified device binding could not be saved"
-      });
+    if (_optionalChain([signal, 'optionalAccess', _37 => _37.aborted])) throw signal.reason;
+    if (_optionalChain([response, 'optionalAccess', _38 => _38.saved]) !== true) {
+      return declined(_nullishCoalesce(_optionalChain([response, 'optionalAccess', _39 => _39.reason]), () => ( "skipped")));
     }
-    emitter.emit(_chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS, {
-      type: _chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS,
+    emitter.emit(_chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS, {
+      type: _chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS,
       payload: { selectionRequestId: binding.selectionRequestId, status: "saved" }
     });
-    return true;
+    return { saved: true };
   } catch (error) {
-    emitter.emit(_chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS, {
-      type: _chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS,
+    emitter.emit(_chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS, {
+      type: _chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS,
       payload: {
         selectionRequestId: binding.selectionRequestId,
-        status: _optionalChain([signal, 'optionalAccess', _41 => _41.aborted]) ? "cancelled" : "failed"
+        status: _optionalChain([signal, 'optionalAccess', _40 => _40.aborted]) ? "cancelled" : "failed"
       }
     });
-    throw error;
+    if (_optionalChain([signal, 'optionalAccess', _41 => _41.aborted])) throw error;
+    return { saved: false, reason: "skipped" };
   } finally {
     _optionalChain([signal, 'optionalAccess', _42 => _42.removeEventListener, 'call', _43 => _43("abort", cancel)]);
     registry.cancel(type, requestId);
@@ -859,18 +843,20 @@ async function requestBleDeviceSelection({
   request,
   scan,
   signal,
+  allowUsbFallback = false,
   pollIntervalMs = 1500
 }) {
-  const type = _chunkRRCFH7X6js.UI_REQUEST.REQUEST_SELECT_DEVICE;
+  const type = _chunkS7X2HM7Pjs.UI_REQUEST.REQUEST_SELECT_DEVICE;
   if (signal.aborted) throw signal.reason;
   if (!emitter.listenerCount(type)) {
-    throw _chunkIZEVYMJKjs.createHwkError.call(void 0, {
+    throw _chunkZ3IH25KVjs.createHwkError.call(void 0, {
       code: 10100 /* DeviceNotFound */,
       message: "Select a Bluetooth device before continuing"
     });
   }
   const requestId = registry.createRequestId();
-  let { devices } = request;
+  let devices = allowUsbFallback ? request.devices.filter((device) => device.connectionType === "ble") : request.devices;
+  const publishedDevices = /* @__PURE__ */ new Map();
   let stopped = false;
   let timer;
   let wake;
@@ -887,10 +873,13 @@ async function requestBleDeviceSelection({
   const cancel = () => registry.cancel(type, requestId);
   const reply = registry.wait(type, { requestId }).finally(stop);
   void reply.catch(() => void 0);
-  const publish = () => emitter.emit(type, {
-    type,
-    payload: { ...request, devices, requestId, scanning: true }
-  });
+  const publish = () => {
+    for (const device of devices) publishedDevices.set(device.connectId, device);
+    emitter.emit(type, {
+      type,
+      payload: { ...request, devices, requestId, scanning: true }
+    });
+  };
   signal.addEventListener("abort", cancel, { once: true });
   let polling;
   try {
@@ -900,31 +889,36 @@ async function requestBleDeviceSelection({
       while (!stopped) {
         const snapshot = await scan();
         if (stopped || signal.aborted) return;
+        const usbFallback = allowUsbFallback ? snapshot.find((device2) => device2.connectionType === "usb") : void 0;
+        if (usbFallback) return usbFallback;
         devices = snapshot;
         publish();
         if (stopped) return;
         await waitForNextScan();
       }
     })();
-    const selected = await Promise.race([reply, polling.then(() => reply)]);
+    const userSelection = reply.then((selected) => publishedDevices.get(selected.sdkConnectId));
+    const device = await Promise.race([
+      userSelection,
+      polling.then((usbFallback) => _nullishCoalesce(usbFallback, () => ( userSelection)))
+    ]);
     stop();
     await polling;
     if (signal.aborted) throw signal.reason;
-    const device = devices.find((candidate) => candidate.connectId === selected.sdkConnectId);
     if (!device) {
-      throw _chunkIZEVYMJKjs.createHwkError.call(void 0, {
+      throw _chunkZ3IH25KVjs.createHwkError.call(void 0, {
         code: 10100 /* DeviceNotFound */,
         message: "Selected Bluetooth device is no longer available"
       });
     }
-    emitter.emit(_chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS, {
-      type: _chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS,
+    emitter.emit(_chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS, {
+      type: _chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS,
       payload: { selectionRequestId: requestId, status: "verifying" }
     });
     return { device, requestId };
   } catch (error) {
-    emitter.emit(_chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS, {
-      type: _chunkRRCFH7X6js.UI_REQUEST.DEVICE_BINDING_STATUS,
+    emitter.emit(_chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS, {
+      type: _chunkS7X2HM7Pjs.UI_REQUEST.DEVICE_BINDING_STATUS,
       payload: { selectionRequestId: requestId, status: signal.aborted ? "cancelled" : "failed" }
     });
     throw error;
@@ -1307,6 +1301,5 @@ var DEVICE_CONNECT_RETRY_DELAY_MS = 1e3;
 
 
 
-
-exports.ALL_NETWORK_METHOD_NAMES = ALL_NETWORK_METHOD_NAMES; exports.CHAIN_FINGERPRINT_PATHS = CHAIN_FINGERPRINT_PATHS; exports.DEVICE = DEVICE; exports.DEVICE_CONNECT_RETRY_DELAY_MS = DEVICE_CONNECT_RETRY_DELAY_MS; exports.DEVICE_EVENT = DEVICE_EVENT; exports.DeviceJobQueue = DeviceJobQueue; exports.EConnectorInteraction = EConnectorInteraction; exports.HARDWARE_METHOD_CATALOG = HARDWARE_METHOD_CATALOG; exports.HARDWARE_RUNTIME_ID_PREFIX = HARDWARE_RUNTIME_ID_PREFIX; exports.HardwareErrorCode = _chunkIZEVYMJKjs.HardwareErrorCode; exports.INTERACTION_DEFAULT_TTL_MS = INTERACTION_DEFAULT_TTL_MS; exports.InteractionRegistry = InteractionRegistry; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkIZEVYMJKjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.SDK = SDK; exports.TypedEventEmitter = TypedEventEmitter; exports.UI_EVENT = _chunkRRCFH7X6js.UI_EVENT; exports.UI_REQUEST = _chunkRRCFH7X6js.UI_REQUEST; exports.UI_REQUEST_CANCELLED_TAG = _chunkRRCFH7X6js.UI_REQUEST_CANCELLED_TAG; exports.UI_REQUEST_DEFAULT_TIMEOUT_MS = _chunkRRCFH7X6js.UI_REQUEST_DEFAULT_TIMEOUT_MS; exports.UI_REQUEST_PREEMPTED_TAG = _chunkRRCFH7X6js.UI_REQUEST_PREEMPTED_TAG; exports.UI_REQUEST_TIMEOUT_TAG = _chunkRRCFH7X6js.UI_REQUEST_TIMEOUT_TAG; exports.UI_RESPONSE = _chunkRRCFH7X6js.UI_RESPONSE; exports.UiRequestRegistry = _chunkRRCFH7X6js.UiRequestRegistry; exports.batchCall = batchCall; exports.buildUnsupportedMethodResponse = buildUnsupportedMethodResponse; exports.bytesToHex = bytesToHex3; exports.canReplayHardwareMethodAfterTransportFailure = canReplayHardwareMethodAfterTransportFailure; exports.compareSemver = compareSemver; exports.createBridgedConnector = createBridgedConnector; exports.createCombinedConnector = createCombinedConnector; exports.createHardwareConnectorSessionId = createHardwareConnectorSessionId; exports.createHardwareInteractionId = createHardwareInteractionId; exports.createHardwareSearchTargetId = createHardwareSearchTargetId; exports.createHwkError = _chunkIZEVYMJKjs.createHwkError; exports.defaultOriginForCode = _chunkIZEVYMJKjs.defaultOriginForCode; exports.defaultRecoveryForCode = _chunkIZEVYMJKjs.defaultRecoveryForCode; exports.deriveDeviceFingerprint = deriveDeviceFingerprint; exports.deriveWalletId = deriveWalletId; exports.detectHardwareVendorFromDescriptor = detectHardwareVendorFromDescriptor; exports.enrichErrorMessage = _chunk7SFFS2NLjs.enrichErrorMessage; exports.ensure0x = ensure0x; exports.failure = failure; exports.getAllNetworkMethodChain = getAllNetworkMethodChain; exports.getHardwareMethodMetadata = getHardwareMethodMetadata; exports.hasHardwareRuntimeIdPrefix = hasHardwareRuntimeIdPrefix; exports.hexToBytes = hexToBytes; exports.isAllNetworkMethodName = isAllNetworkMethodName; exports.isHardwareInteractionId = isHardwareInteractionId; exports.isHardwareSearchTargetId = isHardwareSearchTargetId; exports.isHwkRecoveryHint = _chunkIZEVYMJKjs.isHwkRecoveryHint; exports.isKnownNonTargetHardwareVendor = isKnownNonTargetHardwareVendor; exports.operationMayHaveCompletedParams = _chunkIZEVYMJKjs.operationMayHaveCompletedParams; exports.padHex64 = padHex64; exports.parseBip32MasterFingerprint = parseBip32MasterFingerprint; exports.parseHardwareRuntimeId = parseHardwareRuntimeId; exports.prepareSolanaOffchainMessageV1 = prepareSolanaOffchainMessageV1; exports.rehydrateConnectorError = rehydrateConnectorError; exports.requestBleDeviceSelection = requestBleDeviceSelection; exports.requestSaveDeviceBinding = requestSaveDeviceBinding; exports.resolveHardwareOperationTarget = resolveHardwareOperationTarget; exports.resolveSearchTargetReusePolicy = resolveSearchTargetReusePolicy; exports.runAllNetworkGetAddress = runAllNetworkGetAddress; exports.serializeConnectorError = serializeConnectorError; exports.stripHex = stripHex; exports.success = success;
+exports.ALL_NETWORK_METHOD_NAMES = ALL_NETWORK_METHOD_NAMES; exports.CHAIN_FINGERPRINT_PATHS = CHAIN_FINGERPRINT_PATHS; exports.DEVICE = DEVICE; exports.DEVICE_CONNECT_RETRY_DELAY_MS = DEVICE_CONNECT_RETRY_DELAY_MS; exports.DEVICE_EVENT = DEVICE_EVENT; exports.DeviceJobQueue = DeviceJobQueue; exports.EConnectorInteraction = EConnectorInteraction; exports.HARDWARE_METHOD_CATALOG = HARDWARE_METHOD_CATALOG; exports.HARDWARE_RUNTIME_ID_PREFIX = HARDWARE_RUNTIME_ID_PREFIX; exports.HardwareErrorCode = _chunkZ3IH25KVjs.HardwareErrorCode; exports.OPERATION_DEFAULT_TTL_MS = OPERATION_DEFAULT_TTL_MS; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkZ3IH25KVjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.OperationRegistry = OperationRegistry; exports.SDK = SDK; exports.TypedEventEmitter = TypedEventEmitter; exports.UI_EVENT = _chunkS7X2HM7Pjs.UI_EVENT; exports.UI_REQUEST = _chunkS7X2HM7Pjs.UI_REQUEST; exports.UI_REQUEST_CANCELLED_TAG = _chunkS7X2HM7Pjs.UI_REQUEST_CANCELLED_TAG; exports.UI_REQUEST_DEFAULT_TIMEOUT_MS = _chunkS7X2HM7Pjs.UI_REQUEST_DEFAULT_TIMEOUT_MS; exports.UI_REQUEST_PREEMPTED_TAG = _chunkS7X2HM7Pjs.UI_REQUEST_PREEMPTED_TAG; exports.UI_REQUEST_TIMEOUT_TAG = _chunkS7X2HM7Pjs.UI_REQUEST_TIMEOUT_TAG; exports.UI_RESPONSE = _chunkS7X2HM7Pjs.UI_RESPONSE; exports.UiRequestRegistry = _chunkS7X2HM7Pjs.UiRequestRegistry; exports.batchCall = batchCall; exports.buildUnsupportedMethodResponse = buildUnsupportedMethodResponse; exports.bytesToHex = bytesToHex3; exports.canReplayHardwareMethodAfterTransportFailure = canReplayHardwareMethodAfterTransportFailure; exports.compareSemver = compareSemver; exports.createBridgedConnector = createBridgedConnector; exports.createCombinedConnector = createCombinedConnector; exports.createHardwareLinkId = createHardwareLinkId; exports.createHardwareOperationId = createHardwareOperationId; exports.createHardwareSearchTargetId = createHardwareSearchTargetId; exports.createHwkError = _chunkZ3IH25KVjs.createHwkError; exports.defaultOriginForCode = _chunkZ3IH25KVjs.defaultOriginForCode; exports.defaultRecoveryForCode = _chunkZ3IH25KVjs.defaultRecoveryForCode; exports.deriveDeviceFingerprint = deriveDeviceFingerprint; exports.deriveWalletId = deriveWalletId; exports.detectHardwareVendorFromDescriptor = detectHardwareVendorFromDescriptor; exports.enrichErrorMessage = _chunk7SFFS2NLjs.enrichErrorMessage; exports.ensure0x = ensure0x; exports.failure = failure; exports.getAllNetworkMethodChain = getAllNetworkMethodChain; exports.getHardwareMethodMetadata = getHardwareMethodMetadata; exports.hasHardwareRuntimeIdPrefix = hasHardwareRuntimeIdPrefix; exports.hexToBytes = hexToBytes; exports.isAllNetworkMethodName = isAllNetworkMethodName; exports.isHardwareOperationId = isHardwareOperationId; exports.isHwkRecoveryHint = _chunkZ3IH25KVjs.isHwkRecoveryHint; exports.isKnownNonTargetHardwareVendor = isKnownNonTargetHardwareVendor; exports.operationMayHaveCompletedParams = _chunkZ3IH25KVjs.operationMayHaveCompletedParams; exports.padHex64 = padHex64; exports.parseBip32MasterFingerprint = parseBip32MasterFingerprint; exports.parseHardwareRuntimeId = parseHardwareRuntimeId; exports.prepareSolanaOffchainMessageV1 = prepareSolanaOffchainMessageV1; exports.rehydrateConnectorError = rehydrateConnectorError; exports.requestBleDeviceSelection = requestBleDeviceSelection; exports.requestSaveDeviceBinding = requestSaveDeviceBinding; exports.resolveHardwareOperationTarget = resolveHardwareOperationTarget; exports.resolveSearchTargetReusePolicy = resolveSearchTargetReusePolicy; exports.runAllNetworkGetAddress = runAllNetworkGetAddress; exports.serializeConnectorError = serializeConnectorError; exports.stripHex = stripHex; exports.success = success;
 //# sourceMappingURL=index.js.map