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

package/dist/{chunk-YA4BWFTZ.mjs → chunk-KTRQZ5AJ.mjs}

@@ -18,6 +18,9 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["DeviceOneDeviceOnly"] = 10109] = "DeviceOneDeviceOnly";
   HardwareErrorCode2[HardwareErrorCode2["DevicePathForbidden"] = 10110] = "DevicePathForbidden";
   HardwareErrorCode2[HardwareErrorCode2["DeviceBusyInternal"] = 10111] = "DeviceBusyInternal";
+  HardwareErrorCode2[HardwareErrorCode2["OperationNotFound"] = 10112] = "OperationNotFound";
+  HardwareErrorCode2[HardwareErrorCode2["OperationEnded"] = 10113] = "OperationEnded";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceSearchMismatch"] = 10114] = "DeviceSearchMismatch";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareTooOld"] = 10200] = "FirmwareTooOld";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareUpdateRequired"] = 10201] = "FirmwareUpdateRequired";
   HardwareErrorCode2[HardwareErrorCode2["TransportError"] = 10300] = "TransportError";
@@ -31,6 +34,8 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["ThpPairingRequired"] = 10308] = "ThpPairingRequired";
   HardwareErrorCode2[HardwareErrorCode2["BleConnectFailed"] = 10309] = "BleConnectFailed";
   HardwareErrorCode2[HardwareErrorCode2["BlePairingCancelled"] = 10310] = "BlePairingCancelled";
+  HardwareErrorCode2[HardwareErrorCode2["LedgerSecureChannelError"] = 10311] = "LedgerSecureChannelError";
+  HardwareErrorCode2[HardwareErrorCode2["LedgerFirmwareMetadataError"] = 10312] = "LedgerFirmwareMetadataError";
   HardwareErrorCode2[HardwareErrorCode2["PinInvalid"] = 10400] = "PinInvalid";
   HardwareErrorCode2[HardwareErrorCode2["PinCancelled"] = 10401] = "PinCancelled";
   HardwareErrorCode2[HardwareErrorCode2["PassphraseRejected"] = 10402] = "PassphraseRejected";
@@ -41,6 +46,8 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["WrongApp"] = 10501] = "WrongApp";
   HardwareErrorCode2[HardwareErrorCode2["AppTooOld"] = 10502] = "AppTooOld";
   HardwareErrorCode2[HardwareErrorCode2["DeviceOutOfMemory"] = 10503] = "DeviceOutOfMemory";
+  HardwareErrorCode2[HardwareErrorCode2["AppAlreadyInstalled"] = 10504] = "AppAlreadyInstalled";
+  HardwareErrorCode2[HardwareErrorCode2["PayloadTooLarge"] = 10600] = "PayloadTooLarge";
   HardwareErrorCode2[HardwareErrorCode2["EvmBlindSigningRequired"] = 11e3] = "EvmBlindSigningRequired";
   HardwareErrorCode2[HardwareErrorCode2["EvmClearSignPluginMissing"] = 11001] = "EvmClearSignPluginMissing";
   HardwareErrorCode2[HardwareErrorCode2["EvmDataTooLarge"] = 11002] = "EvmDataTooLarge";
@@ -58,7 +65,10 @@ var ORPHAN_ELIGIBLE_ERROR_CODES = [
   10001 /* UserRejected */,
   10100 /* DeviceNotFound */,
   10101 /* DeviceDisconnected */,
+  10112 /* OperationNotFound */,
+  10113 /* OperationEnded */,
   10106 /* DeviceMismatch */,
+  10114 /* DeviceSearchMismatch */,
   10107 /* DeviceAppStuck */,
   10109 /* DeviceOneDeviceOnly */,
   10300 /* TransportError */,
@@ -71,83 +81,173 @@ var ORPHAN_ELIGIBLE_ERROR_CODES = [
   10310 /* BlePairingCancelled */,
   10405 /* PassphraseAlwaysOnDevice */
 ];
-function createHwkError(payload) {
-  return Object.assign(new Error(payload.message), {
-    code: payload.code,
-    ...payload._tag !== void 0 && { _tag: payload._tag },
-    ...payload.appName !== void 0 && { appName: payload.appName },
-    ...payload.params !== void 0 && { params: payload.params }
-  });
+var RECOVERY_SCOPES = /* @__PURE__ */ new Set([
+  "call",
+  "operation",
+  "search-target",
+  "transport",
+  "not-recoverable",
+  "unknown"
+]);
+function isHwkRecoveryHint(value) {
+  if (!value || typeof value !== "object") return false;
+  const { scope } = value;
+  return typeof scope === "string" && RECOVERY_SCOPES.has(scope);
 }
-
-// src/utils/errorMessages.ts
-function enrichErrorMessage(code, originalMessage) {
+var RECOVERY_CALL = Object.freeze({ scope: "call" });
+var RECOVERY_OPERATION = Object.freeze({ scope: "operation" });
+var RECOVERY_SEARCH_TARGET = Object.freeze({ scope: "search-target" });
+var RECOVERY_TRANSPORT = Object.freeze({ scope: "transport" });
+var RECOVERY_NOT_RECOVERABLE = Object.freeze({
+  scope: "not-recoverable"
+});
+var RECOVERY_UNKNOWN = Object.freeze({ scope: "unknown" });
+function defaultRecoveryForCode(code) {
   switch (code) {
+    case 10001 /* UserRejected */:
+    case 10005 /* UserAborted */:
+    case 10102 /* DeviceBusy */:
+    case 10103 /* DeviceLocked */:
+    case 10104 /* DeviceNotInitialized */:
+    case 10105 /* DeviceInBootloader */:
+    case 10107 /* DeviceAppStuck */:
+    case 10111 /* DeviceBusyInternal */:
+    case 10305 /* NetworkError */:
+    case 10311 /* LedgerSecureChannelError */:
+    case 10312 /* LedgerFirmwareMetadataError */:
     case 10400 /* PinInvalid */:
-      return `${originalMessage}. Please re-enter your PIN.`;
     case 10401 /* PinCancelled */:
-      return `${originalMessage}. PIN entry was cancelled.`;
+    case 10402 /* PassphraseRejected */:
+    case 10403 /* PassphraseStateMismatch */:
     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 10200 /* FirmwareTooOld */:
+    case 10201 /* FirmwareUpdateRequired */:
     case 10500 /* AppNotInstalled */:
-      return `${originalMessage}. The required app is not installed on the device.`;
+    case 10501 /* WrongApp */:
+    case 10502 /* AppTooOld */:
     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 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 10504 /* AppAlreadyInstalled */:
     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.";
+      return RECOVERY_CALL;
+    case 10100 /* DeviceNotFound */:
+    case 10101 /* DeviceDisconnected */:
+    case 10112 /* OperationNotFound */:
+    case 10113 /* OperationEnded */:
+    case 10300 /* TransportError */:
+    case 10304 /* BlePairingTimeout */:
+    case 10306 /* ThpPairingFailed */:
+    case 10308 /* ThpPairingRequired */:
+    case 10309 /* BleConnectFailed */:
+    case 10310 /* BlePairingCancelled */:
+      return RECOVERY_OPERATION;
+    case 10106 /* DeviceMismatch */:
+    case 10114 /* DeviceSearchMismatch */:
+    case 10109 /* DeviceOneDeviceOnly */:
+    case 10307 /* BleBondInvalid */:
+      return RECOVERY_SEARCH_TARGET;
+    case 10301 /* BridgeNotFound */:
+    case 10302 /* TransportNotAvailable */:
+    case 10303 /* DevicePermissionDenied */:
+    case 10600 /* PayloadTooLarge */:
+      return RECOVERY_TRANSPORT;
+    case 10002 /* InvalidParams */:
+    case 10004 /* MethodNotSupported */:
+    case 10108 /* ChainNotSupported */:
+    case 10110 /* DevicePathForbidden */:
+      return RECOVERY_NOT_RECOVERABLE;
+    case 1e4 /* UnknownError */:
+    case 10003 /* OperationTimeout */:
     default:
-      return originalMessage;
+      return RECOVERY_UNKNOWN;
   }
 }
+function defaultOriginForCode(code) {
+  if (code >= 11e3) return "device";
+  switch (code) {
+    case 10001 /* UserRejected */:
+    case 10103 /* DeviceLocked */:
+    case 10104 /* DeviceNotInitialized */:
+    case 10105 /* DeviceInBootloader */:
+    case 10106 /* DeviceMismatch */:
+    case 10114 /* DeviceSearchMismatch */:
+    case 10107 /* DeviceAppStuck */:
+    case 10110 /* DevicePathForbidden */:
+    case 10111 /* DeviceBusyInternal */:
+    case 10108 /* ChainNotSupported */:
+    case 10200 /* FirmwareTooOld */:
+    case 10201 /* FirmwareUpdateRequired */:
+    case 10400 /* PinInvalid */:
+    case 10404 /* PinMismatch */:
+    case 10402 /* PassphraseRejected */:
+    case 10403 /* PassphraseStateMismatch */:
+    case 10306 /* ThpPairingFailed */:
+    case 10308 /* ThpPairingRequired */:
+    case 10501 /* WrongApp */:
+    case 10500 /* AppNotInstalled */:
+    case 10502 /* AppTooOld */:
+    case 10503 /* DeviceOutOfMemory */:
+    case 10504 /* AppAlreadyInstalled */:
+      return "device";
+    case 10100 /* DeviceNotFound */:
+    case 10101 /* DeviceDisconnected */:
+    case 10300 /* TransportError */:
+    case 10301 /* BridgeNotFound */:
+    case 10302 /* TransportNotAvailable */:
+    case 10304 /* BlePairingTimeout */:
+    case 10305 /* NetworkError */:
+    case 10311 /* LedgerSecureChannelError */:
+    case 10312 /* LedgerFirmwareMetadataError */:
+    case 10307 /* BleBondInvalid */:
+    case 10309 /* BleConnectFailed */:
+      return "transport";
+    case 10303 /* DevicePermissionDenied */:
+    case 10005 /* UserAborted */:
+    case 10002 /* InvalidParams */:
+    case 10004 /* MethodNotSupported */:
+    case 10401 /* PinCancelled */:
+    case 10310 /* BlePairingCancelled */:
+    case 10600 /* PayloadTooLarge */:
+    case 10109 /* DeviceOneDeviceOnly */:
+      return "host";
+    default:
+      return void 0;
+  }
+}
+function operationMayHaveCompletedParams(method, params) {
+  return {
+    ...params,
+    operationMayHaveCompleted: true,
+    method
+  };
+}
+function createHwkError(payload) {
+  const recovery = payload.recovery ?? defaultRecoveryForCode(payload.code);
+  return Object.assign(new Error(payload.message), {
+    code: payload.code,
+    ...payload.origin !== void 0 && { origin: payload.origin },
+    recovery,
+    ...payload._tag !== void 0 && { _tag: payload._tag },
+    ...payload.appName !== void 0 && { appName: payload.appName },
+    ...payload.params !== void 0 && { params: payload.params }
+  });
+}
 
 export {
   HardwareErrorCode,
   ORPHAN_ELIGIBLE_ERROR_CODES,
-  createHwkError,
-  enrichErrorMessage
+  isHwkRecoveryHint,
+  defaultRecoveryForCode,
+  defaultOriginForCode,
+  operationMayHaveCompletedParams,
+  createHwkError
 };
-//# sourceMappingURL=chunk-YA4BWFTZ.mjs.map
+//# sourceMappingURL=chunk-KTRQZ5AJ.mjs.map

package/dist/chunk-KTRQZ5AJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/errors.ts"],"sourcesContent":["/**\n * HWK HardwareErrorCode — independent namespace from the legacy\n * `@onekeyfe/shared` HardwareErrorCode (which occupies 0-902).\n *\n * All HWK codes are 5-digit (>= 10000) so the two tables never collide\n * even if either side grows. Each sub-category gets a 100-slot block.\n *\n *   10000-10099  Generic / cross-cutting primitives\n *   10100-10199  Device state\n *   10200-10299  Firmware\n *   10300-10399  Transport + OS-level permission\n *   10400-10499  PIN / Passphrase\n *   10500-10599  App lifecycle (wrong app, not open, too old)\n *   10600-10699  Payload / framing limits (adapter-level)\n *   10700-10999  RESERVED, future adapter-level categories\n *\n *   11000-11099  EVM APDU (reactive mapping)\n *   11100-11199  Solana APDU\n *   11200-11299  Tron APDU\n *   11300-11399  BTC APDU\n *   11400-11999  RESERVED — future chain APDU blocks (100 per chain)\n *\n *   12000-99999  RESERVED — future major categories\n */\nexport enum HardwareErrorCode {\n  // --- 10000s Generic ---\n  UnknownError = 10000,\n  UserRejected = 10001,\n  InvalidParams = 10002,\n  OperationTimeout = 10003,\n  MethodNotSupported = 10004,\n  /** User dismissed in-app cancel UI. Distinct from UserRejected (on-device). */\n  UserAborted = 10005,\n\n  // --- 10100s Device state ---\n  DeviceNotFound = 10100,\n  DeviceDisconnected = 10101,\n  DeviceBusy = 10102,\n  DeviceLocked = 10103,\n  DeviceNotInitialized = 10104,\n  DeviceInBootloader = 10105,\n  DeviceMismatch = 10106,\n  /** Chain app wedged (e.g. Ledger BTC 0x6901). User must exit app on device. */\n  DeviceAppStuck = 10107,\n  /** Vendor (Ledger / Trezor) doesn't support the chain at all. */\n  ChainNotSupported = 10108,\n  /** Current operation supports only one connected device. */\n  DeviceOneDeviceOnly = 10109,\n  /**\n   * The device rejected the requested derivation path (Trezor Failure_DataError\n   * \"Forbidden key path\") — the path is non-standard or its index is outside the\n   * range the device's safety checks allow. Distinct from ChainNotSupported\n   * (whole chain) and MethodNotSupported (the operation/method itself).\n   */\n  DevicePathForbidden = 10110,\n  /** Busy with our own in-flight request (queue guard / firmware Failure_Busy), not another app — wait and retry, don't close other apps. */\n  DeviceBusyInternal = 10111,\n  /** The supplied runtime-only operation id is unknown to this adapter instance. */\n  OperationNotFound = 10112,\n  /** The supplied operation ended and can never be resumed. */\n  OperationEnded = 10113,\n  /**\n   * Discovery found devices but none is the expected wallet (wrong unit connected). DeviceMismatch\n   * is for reaching the expected device and finding a different identity on it.\n   */\n  DeviceSearchMismatch = 10114,\n\n  // --- 10200s Firmware ---\n  FirmwareTooOld = 10200,\n  FirmwareUpdateRequired = 10201,\n\n  // --- 10300s Transport + permission ---\n  TransportError = 10300,\n  BridgeNotFound = 10301,\n  TransportNotAvailable = 10302,\n  /**\n   * OS-level permission (Bluetooth / USB / etc.) — denied, blocked,\n   * unavailable, or dismissed. Consumers surface a single \"please grant\n   * permission\" toast and let the user retry manually.\n   */\n  DevicePermissionDenied = 10303,\n  /**\n   * BLE SMP pairing did not complete within the GATT bonding window.\n   * GATT connected but the device didn't acknowledge SMP — typically\n   * because the user didn't confirm the passkey on the device, or the\n   * device went out of range mid-pairing. Distinct from OperationTimeout\n   * (generic) and from DeviceLocked (Secure Element actually locked).\n   */\n  BlePairingTimeout = 10304,\n  /** Remote network failure reaching a vendor's servers (HTTP/WS). Distinct from TransportError (local USB/BLE link). */\n  NetworkError = 10305,\n  /**\n   * Host-managed pairing handshake failed (Trezor THP). The device rejected the\n   * pairing exchange — e.g. CodeEntry: the user mistyped the code shown on the\n   * device, so the CPace tag didn't match (\"Unexpected Code Entry Tag\").\n   * Recoverable: the user re-pairs and re-enters the code. Distinct from\n   * BlePairingTimeout (BLE SMP bonding window) and UserRejected (on-device\n   * reject button).\n   */\n  ThpPairingFailed = 10306,\n  /**\n   * The OS-level BLE bond is stale/invalid, so the device rejected link\n   * encryption: Android GATT_INSUF_AUTHENTICATION (status 5) or iOS \"Peer\n   * removed pairing information\". Happens after the device is wiped/re-flashed\n   * or unpaired elsewhere while the host still holds an old bond. The SDK cannot\n   * remove an OS bond — the user must forget the device in system Bluetooth\n   * settings and re-pair. Distinct from BlePairingTimeout (SMP window) and\n   * ThpPairingFailed (THP code mismatch).\n   */\n  BleBondInvalid = 10307,\n  /**\n   * A stored THP pairing credential was rejected by the device during the\n   * handshake (device returned completion `state=0`), so the autoconnect session\n   * could not be established. The SDK discards the stale credential; recovery is\n   * a fresh pairing. Distinct from ThpPairingFailed (user mistyped the code\n   * during an *active* pairing) and BleBondInvalid (OS-level BLE bond).\n   */\n  ThpPairingRequired = 10308,\n  /**\n   * Generic BLE connect failure where the OS dropped the specific reason. On\n   * macOS the noble native binding hardcodes \"connection failed\" (and a connect\n   * timeout) and discards the CoreBluetooth NSError, so the SDK cannot tell a\n   * stale bond from an out-of-range / unresponsive device. Surfaced as a\n   * generic \"couldn't connect — check the device, re-pair if paired before\".\n   * Distinct from BleBondInvalid (a *known* stale-bond signal, iOS/Android only)\n   * and BlePairingTimeout (the SMP bonding window).\n   */\n  BleConnectFailed = 10309,\n  /**\n   * The user cancelled BLE pairing from the app while the connect was still\n   * waiting on the OS pairing window. Not a failure to report — the flow ends\n   * because they asked it to. Distinct from UserAborted (generic in-app cancel)\n   * so the pairing UI can close quietly instead of surfacing a connect error,\n   * and from BlePairingTimeout (the SMP window elapsed on its own).\n   */\n  BlePairingCancelled = 10310,\n  /**\n   * Ledger manager-api WebSocket (app install/uninstall, genuine check) broke while relaying APDUs.\n   * The device link is fine, so retry; NetworkError never carried device traffic.\n   */\n  LedgerSecureChannelError = 10311,\n  /**\n   * Vendor metadata service returned an unusable payload (Ledger firmware metadata, app catalog).\n   * The request succeeded, so callers must not treat it as a dropped link.\n   */\n  LedgerFirmwareMetadataError = 10312,\n\n  // --- 10400s PIN / Passphrase ---\n  PinInvalid = 10400,\n  PinCancelled = 10401,\n  PassphraseRejected = 10402,\n  /**\n   * The passphrase entered produced a different wallet (`passphraseState`) than\n   * the one the caller asked to operate on. Trezor-only: the host pins a wallet\n   * by its derived state and the SDK refuses to sign with a mismatched\n   * passphrase session. Surfaced by TrezorAdapter.getPassphraseState.\n   */\n  PassphraseStateMismatch = 10403,\n  /**\n   * The two new-PIN entries did not match during set/change PIN. Only host-input\n   * models (Trezor Model One matrix) surface this; on-device-input models show\n   * the mismatch on the device and never return it.\n   */\n  PinMismatch = 10404,\n  /** Standard wallet is unavailable while Trezor enforces on-device passphrase entry. */\n  PassphraseAlwaysOnDevice = 10405,\n\n  // --- 10500s App lifecycle ---\n  /** Chain app NOT INSTALLED on device. User must install via Ledger Live. */\n  AppNotInstalled = 10500,\n  WrongApp = 10501,\n  /** 0x911c Command code not supported — app predates current SDK. */\n  AppTooOld = 10502,\n  /** Not enough free storage for install/update; user must uninstall apps first. */\n  DeviceOutOfMemory = 10503,\n  /** Install refused, the app is already on the device; benign when the caller only needs it. */\n  AppAlreadyInstalled = 10504,\n\n  // --- 10600s Payload / framing limits ---\n  /**\n   * Payload exceeds a transport's framing cap (Keystone USB: ~12.5KB, 200 frames of 64 bytes).\n   * Retrying on the same transport fails the same way; switch channel or shrink the payload.\n   */\n  PayloadTooLarge = 10600,\n\n  // --- 11000s EVM (Ledger Ethereum App) APDU-specific ---\n  /** 0x6a80 Invalid data — observed on blindSignTransactionFallback when the\n   *  user has not enabled Blind signing on the device. */\n  EvmBlindSigningRequired = 11000,\n  /** 0x6984 Plugin not installed */\n  EvmClearSignPluginMissing = 11001,\n  /** 0x6a84 Insufficient memory (typical on Nano S with large calldata) */\n  EvmDataTooLarge = 11002,\n  /** 0x6501 TransactionType not supported (app too old for EIP-1559 / blob / 7702) */\n  EvmTxTypeNotSupported = 11003,\n\n  // --- 11100s Solana ---\n  /** 0x6808 Blind signing disabled for this instruction. */\n  SolanaBlindSigningRequired = 11100,\n\n  // --- 11200s Tron ---\n  /** 0x6a8d Custom Contracts setting disabled (blocks TRC-20 etc.). */\n  TronCustomContractRequired = 11200,\n  /** 0x6a8b Transactions Data setting disabled. */\n  TronDataSigningRequired = 11201,\n  /** 0x6a8c Sign by Hash setting disabled (hash-signing fallback). */\n  TronSignByHashRequired = 11202,\n\n  // --- 11300s BTC ---\n  /** 0xb008 Wallet policy HMAC mismatch or not registered. */\n  BtcWalletPolicyHmacMismatch = 11300,\n  /** 0xb007 Aborted due to unexpected state (malformed PSBT / missing UTXO). */\n  BtcUnexpectedState = 11301,\n}\n\n/**\n * Device-level failures the SDK cannot self-recover from — affect the entire\n * batch (vs per-chain failures like AppNotInstalled / WrongApp which soft-\n * skip in onboarding). Combined with `accounts.length === 0`, signals\n * genuine orphan. Also reused as the batch-abort whitelist for HWK.\n * Single source of truth.\n *\n * UserRejected (device-side reject) is included: pressing reject is an\n * explicit \"I don't consent\" — continuing the batch to ask again on the\n * next chain is harassment, not helpful.\n */\nexport const ORPHAN_ELIGIBLE_ERROR_CODES: number[] = [\n  HardwareErrorCode.UserAborted,\n  HardwareErrorCode.UserRejected,\n  HardwareErrorCode.DeviceNotFound,\n  HardwareErrorCode.DeviceDisconnected,\n  HardwareErrorCode.OperationNotFound,\n  HardwareErrorCode.OperationEnded,\n  HardwareErrorCode.DeviceMismatch,\n  HardwareErrorCode.DeviceSearchMismatch,\n  HardwareErrorCode.DeviceAppStuck,\n  HardwareErrorCode.DeviceOneDeviceOnly,\n  HardwareErrorCode.TransportError,\n  HardwareErrorCode.DevicePermissionDenied,\n  HardwareErrorCode.BlePairingTimeout,\n  HardwareErrorCode.ThpPairingFailed,\n  HardwareErrorCode.ThpPairingRequired,\n  HardwareErrorCode.BleBondInvalid,\n  HardwareErrorCode.BleConnectFailed,\n  HardwareErrorCode.BlePairingCancelled,\n  HardwareErrorCode.PassphraseAlwaysOnDevice,\n];\n\n// ---------------------------------------------------------------------------\n// Standard throwable for HWK adapters\n// ---------------------------------------------------------------------------\n\n/**\n * Where a failure came from; code ranges can't tell (UserRejected=10001 is the device,\n * DevicePermissionDenied=10303 is the host).\n * `device`: the firmware answered (rejection, locked, wrong PIN); surface verbatim, never\n * auto-reconnect, switch channels, or drop a healthy session.\n * `transport`: the pipe failed (cable pulled, bus reset); reconnecting is fair game.\n * `host`: the environment refused (permission, picker, bad params); fix it, not the link.\n * A mapper that can't tell leaves it unset so consumers fall back to code-based tables.\n */\nexport type HwkErrorOrigin = 'device' | 'transport' | 'host';\n\n/**\n * Smallest resource to replace before retrying; never permission to auto-replay a signing command.\n * `call`: nothing. `operation`: rebind from the target if its identity is persistent.\n * `search-target`: rediscover and reselect. `transport`: repair or switch transport.\n * `not-recoverable`: retrying cannot succeed. `unknown`: no safe claim.\n */\nexport type HwkRecoveryScope =\n  | 'call'\n  | 'operation'\n  | 'search-target'\n  | 'transport'\n  | 'not-recoverable'\n  | 'unknown';\n\nexport interface HwkRecoveryHint {\n  scope: HwkRecoveryScope;\n}\n\nconst RECOVERY_SCOPES = new Set<HwkRecoveryScope>([\n  'call',\n  'operation',\n  'search-target',\n  'transport',\n  'not-recoverable',\n  'unknown',\n]);\n\nexport function isHwkRecoveryHint(value: unknown): value is HwkRecoveryHint {\n  if (!value || typeof value !== 'object') return false;\n  const { scope } = value as { scope?: unknown };\n  return typeof scope === 'string' && RECOVERY_SCOPES.has(scope as HwkRecoveryScope);\n}\n\nconst RECOVERY_CALL: HwkRecoveryHint = Object.freeze({ scope: 'call' });\nconst RECOVERY_OPERATION: HwkRecoveryHint = Object.freeze({ scope: 'operation' });\nconst RECOVERY_SEARCH_TARGET: HwkRecoveryHint = Object.freeze({ scope: 'search-target' });\nconst RECOVERY_TRANSPORT: HwkRecoveryHint = Object.freeze({ scope: 'transport' });\nconst RECOVERY_NOT_RECOVERABLE: HwkRecoveryHint = Object.freeze({\n  scope: 'not-recoverable',\n});\nconst RECOVERY_UNKNOWN: HwkRecoveryHint = Object.freeze({ scope: 'unknown' });\n\n/** Vendor-neutral fallback; adapters may stamp a narrower hint when session state is clear. */\nexport function defaultRecoveryForCode(code: HardwareErrorCode): HwkRecoveryHint {\n  switch (code) {\n    case HardwareErrorCode.UserRejected:\n    case HardwareErrorCode.UserAborted:\n    case HardwareErrorCode.DeviceBusy:\n    case HardwareErrorCode.DeviceLocked:\n    case HardwareErrorCode.DeviceNotInitialized:\n    case HardwareErrorCode.DeviceInBootloader:\n    case HardwareErrorCode.DeviceAppStuck:\n    case HardwareErrorCode.DeviceBusyInternal:\n    case HardwareErrorCode.NetworkError:\n    case HardwareErrorCode.LedgerSecureChannelError:\n    case HardwareErrorCode.LedgerFirmwareMetadataError:\n    case HardwareErrorCode.PinInvalid:\n    case HardwareErrorCode.PinCancelled:\n    case HardwareErrorCode.PassphraseRejected:\n    case HardwareErrorCode.PassphraseStateMismatch:\n    case HardwareErrorCode.PinMismatch:\n    case HardwareErrorCode.FirmwareTooOld:\n    case HardwareErrorCode.FirmwareUpdateRequired:\n    case HardwareErrorCode.AppNotInstalled:\n    case HardwareErrorCode.WrongApp:\n    case HardwareErrorCode.AppTooOld:\n    case HardwareErrorCode.DeviceOutOfMemory:\n    case HardwareErrorCode.AppAlreadyInstalled:\n    case HardwareErrorCode.EvmBlindSigningRequired:\n    case HardwareErrorCode.EvmClearSignPluginMissing:\n    case HardwareErrorCode.EvmDataTooLarge:\n    case HardwareErrorCode.EvmTxTypeNotSupported:\n    case HardwareErrorCode.SolanaBlindSigningRequired:\n    case HardwareErrorCode.TronCustomContractRequired:\n    case HardwareErrorCode.TronDataSigningRequired:\n    case HardwareErrorCode.TronSignByHashRequired:\n    case HardwareErrorCode.BtcWalletPolicyHmacMismatch:\n    case HardwareErrorCode.BtcUnexpectedState:\n      return RECOVERY_CALL;\n    case HardwareErrorCode.DeviceNotFound:\n    case HardwareErrorCode.DeviceDisconnected:\n    case HardwareErrorCode.OperationNotFound:\n    case HardwareErrorCode.OperationEnded:\n    case HardwareErrorCode.TransportError:\n    case HardwareErrorCode.BlePairingTimeout:\n    case HardwareErrorCode.ThpPairingFailed:\n    case HardwareErrorCode.ThpPairingRequired:\n    case HardwareErrorCode.BleConnectFailed:\n    case HardwareErrorCode.BlePairingCancelled:\n      return RECOVERY_OPERATION;\n    case HardwareErrorCode.DeviceMismatch:\n    case HardwareErrorCode.DeviceSearchMismatch:\n    case HardwareErrorCode.DeviceOneDeviceOnly:\n    case HardwareErrorCode.BleBondInvalid:\n      return RECOVERY_SEARCH_TARGET;\n    case HardwareErrorCode.BridgeNotFound:\n    case HardwareErrorCode.TransportNotAvailable:\n    case HardwareErrorCode.DevicePermissionDenied:\n    case HardwareErrorCode.PayloadTooLarge:\n      return RECOVERY_TRANSPORT;\n    case HardwareErrorCode.InvalidParams:\n    case HardwareErrorCode.MethodNotSupported:\n    case HardwareErrorCode.ChainNotSupported:\n    case HardwareErrorCode.DevicePathForbidden:\n      return RECOVERY_NOT_RECOVERABLE;\n    case HardwareErrorCode.UnknownError:\n    case HardwareErrorCode.OperationTimeout:\n    default:\n      return RECOVERY_UNKNOWN;\n  }\n}\n\n/**\n * Default code-to-origin table; vendors override only where their mapping knows better.\n * Context-dependent codes (UnknownError, OperationTimeout, DeviceBusy) return undefined.\n */\nexport function defaultOriginForCode(code: HardwareErrorCode): HwkErrorOrigin | undefined {\n  // Chain APDU codes (11000+) are always the device's chain app refusing or qualifying a request.\n  if (code >= 11_000) return 'device';\n  switch (code) {\n    case HardwareErrorCode.UserRejected:\n    case HardwareErrorCode.DeviceLocked:\n    case HardwareErrorCode.DeviceNotInitialized:\n    case HardwareErrorCode.DeviceInBootloader:\n    case HardwareErrorCode.DeviceMismatch:\n    case HardwareErrorCode.DeviceSearchMismatch:\n    case HardwareErrorCode.DeviceAppStuck:\n    case HardwareErrorCode.DevicePathForbidden:\n    case HardwareErrorCode.DeviceBusyInternal:\n    case HardwareErrorCode.ChainNotSupported:\n    case HardwareErrorCode.FirmwareTooOld:\n    case HardwareErrorCode.FirmwareUpdateRequired:\n    case HardwareErrorCode.PinInvalid:\n    case HardwareErrorCode.PinMismatch:\n    case HardwareErrorCode.PassphraseRejected:\n    case HardwareErrorCode.PassphraseStateMismatch:\n    case HardwareErrorCode.ThpPairingFailed:\n    case HardwareErrorCode.ThpPairingRequired:\n    case HardwareErrorCode.WrongApp:\n    case HardwareErrorCode.AppNotInstalled:\n    case HardwareErrorCode.AppTooOld:\n    case HardwareErrorCode.DeviceOutOfMemory:\n    case HardwareErrorCode.AppAlreadyInstalled:\n      return 'device';\n    case HardwareErrorCode.DeviceNotFound:\n    case HardwareErrorCode.DeviceDisconnected:\n    case HardwareErrorCode.TransportError:\n    case HardwareErrorCode.BridgeNotFound:\n    case HardwareErrorCode.TransportNotAvailable:\n    case HardwareErrorCode.BlePairingTimeout:\n    case HardwareErrorCode.NetworkError:\n    case HardwareErrorCode.LedgerSecureChannelError:\n    case HardwareErrorCode.LedgerFirmwareMetadataError:\n    case HardwareErrorCode.BleBondInvalid:\n    case HardwareErrorCode.BleConnectFailed:\n      return 'transport';\n    case HardwareErrorCode.DevicePermissionDenied:\n    case HardwareErrorCode.UserAborted:\n    case HardwareErrorCode.InvalidParams:\n    case HardwareErrorCode.MethodNotSupported:\n    case HardwareErrorCode.PinCancelled:\n    case HardwareErrorCode.BlePairingCancelled:\n    case HardwareErrorCode.PayloadTooLarge:\n    case HardwareErrorCode.DeviceOneDeviceOnly:\n      return 'host';\n    default:\n      return undefined;\n  }\n}\n\nexport interface IHwkErrorPayload {\n  code: HardwareErrorCode;\n  message: string;\n  origin?: HwkErrorOrigin;\n  recovery?: HwkRecoveryHint;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n}\n\nexport interface IOperationMayHaveCompletedParams extends Record<string, unknown> {\n  operationMayHaveCompleted: true;\n  method: string;\n}\n\n/**\n * Marks an unsafe request whose response was lost after dispatch; the transport error is not proof\n * that the device rejected or skipped it.\n */\nexport function operationMayHaveCompletedParams(\n  method: string,\n  params?: Record<string, unknown>\n): IOperationMayHaveCompletedParams {\n  return {\n    ...params,\n    operationMayHaveCompleted: true,\n    method,\n  };\n}\n\nexport type HwkError = Error & {\n  code: HardwareErrorCode;\n  /** See {@link HwkErrorOrigin}. Survives serializeConnectorError/rehydrate via `params`. */\n  origin?: HwkErrorOrigin;\n  recovery?: HwkRecoveryHint;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n};\n\n/**\n * Canonical throwable for HWK adapters. Plain Error + canonical extra fields,\n * shape-compatible with `rehydrateConnectorError` so locally-thrown and\n * cross-boundary errors are indistinguishable to downstream classifiers\n * (`err.code` / `err._tag` / `err.appName`). Do NOT mutate caught errors\n * with `Object.assign` — construct a fresh one via this factory.\n */\nexport function createHwkError(payload: IHwkErrorPayload): HwkError {\n  const recovery = payload.recovery ?? defaultRecoveryForCode(payload.code);\n  return Object.assign(new Error(payload.message), {\n    code: payload.code,\n    ...(payload.origin !== undefined && { origin: payload.origin }),\n    recovery,\n    ...(payload._tag !== undefined && { _tag: payload._tag }),\n    ...(payload.appName !== undefined && { appName: payload.appName }),\n    ...(payload.params !== undefined && { params: payload.params }),\n  });\n}\n"],"mappings":"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","names":["HardwareErrorCode"]}

package/dist/{chunk-SZZF623R.js → chunk-T5HIQPNG.js}

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/types/errors.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/types/errors.ts
 var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["UnknownError"] = 1e4] = "UnknownError";
   HardwareErrorCode2[HardwareErrorCode2["UserRejected"] = 10001] = "UserRejected";
@@ -18,6 +18,9 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["DeviceOneDeviceOnly"] = 10109] = "DeviceOneDeviceOnly";
   HardwareErrorCode2[HardwareErrorCode2["DevicePathForbidden"] = 10110] = "DevicePathForbidden";
   HardwareErrorCode2[HardwareErrorCode2["DeviceBusyInternal"] = 10111] = "DeviceBusyInternal";
+  HardwareErrorCode2[HardwareErrorCode2["OperationNotFound"] = 10112] = "OperationNotFound";
+  HardwareErrorCode2[HardwareErrorCode2["OperationEnded"] = 10113] = "OperationEnded";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceSearchMismatch"] = 10114] = "DeviceSearchMismatch";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareTooOld"] = 10200] = "FirmwareTooOld";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareUpdateRequired"] = 10201] = "FirmwareUpdateRequired";
   HardwareErrorCode2[HardwareErrorCode2["TransportError"] = 10300] = "TransportError";
@@ -31,6 +34,8 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["ThpPairingRequired"] = 10308] = "ThpPairingRequired";
   HardwareErrorCode2[HardwareErrorCode2["BleConnectFailed"] = 10309] = "BleConnectFailed";
   HardwareErrorCode2[HardwareErrorCode2["BlePairingCancelled"] = 10310] = "BlePairingCancelled";
+  HardwareErrorCode2[HardwareErrorCode2["LedgerSecureChannelError"] = 10311] = "LedgerSecureChannelError";
+  HardwareErrorCode2[HardwareErrorCode2["LedgerFirmwareMetadataError"] = 10312] = "LedgerFirmwareMetadataError";
   HardwareErrorCode2[HardwareErrorCode2["PinInvalid"] = 10400] = "PinInvalid";
   HardwareErrorCode2[HardwareErrorCode2["PinCancelled"] = 10401] = "PinCancelled";
   HardwareErrorCode2[HardwareErrorCode2["PassphraseRejected"] = 10402] = "PassphraseRejected";
@@ -41,6 +46,8 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["WrongApp"] = 10501] = "WrongApp";
   HardwareErrorCode2[HardwareErrorCode2["AppTooOld"] = 10502] = "AppTooOld";
   HardwareErrorCode2[HardwareErrorCode2["DeviceOutOfMemory"] = 10503] = "DeviceOutOfMemory";
+  HardwareErrorCode2[HardwareErrorCode2["AppAlreadyInstalled"] = 10504] = "AppAlreadyInstalled";
+  HardwareErrorCode2[HardwareErrorCode2["PayloadTooLarge"] = 10600] = "PayloadTooLarge";
   HardwareErrorCode2[HardwareErrorCode2["EvmBlindSigningRequired"] = 11e3] = "EvmBlindSigningRequired";
   HardwareErrorCode2[HardwareErrorCode2["EvmClearSignPluginMissing"] = 11001] = "EvmClearSignPluginMissing";
   HardwareErrorCode2[HardwareErrorCode2["EvmDataTooLarge"] = 11002] = "EvmDataTooLarge";
@@ -58,7 +65,10 @@ var ORPHAN_ELIGIBLE_ERROR_CODES = [
   10001 /* UserRejected */,
   10100 /* DeviceNotFound */,
   10101 /* DeviceDisconnected */,
+  10112 /* OperationNotFound */,
+  10113 /* OperationEnded */,
   10106 /* DeviceMismatch */,
+  10114 /* DeviceSearchMismatch */,
   10107 /* DeviceAppStuck */,
   10109 /* DeviceOneDeviceOnly */,
   10300 /* TransportError */,
@@ -71,83 +81,173 @@ var ORPHAN_ELIGIBLE_ERROR_CODES = [
   10310 /* BlePairingCancelled */,
   10405 /* PassphraseAlwaysOnDevice */
 ];
-function createHwkError(payload) {
-  return Object.assign(new Error(payload.message), {
-    code: payload.code,
-    ...payload._tag !== void 0 && { _tag: payload._tag },
-    ...payload.appName !== void 0 && { appName: payload.appName },
-    ...payload.params !== void 0 && { params: payload.params }
-  });
+var RECOVERY_SCOPES = /* @__PURE__ */ new Set([
+  "call",
+  "operation",
+  "search-target",
+  "transport",
+  "not-recoverable",
+  "unknown"
+]);
+function isHwkRecoveryHint(value) {
+  if (!value || typeof value !== "object") return false;
+  const { scope } = value;
+  return typeof scope === "string" && RECOVERY_SCOPES.has(scope);
 }
-
-// src/utils/errorMessages.ts
-function enrichErrorMessage(code, originalMessage) {
+var RECOVERY_CALL = Object.freeze({ scope: "call" });
+var RECOVERY_OPERATION = Object.freeze({ scope: "operation" });
+var RECOVERY_SEARCH_TARGET = Object.freeze({ scope: "search-target" });
+var RECOVERY_TRANSPORT = Object.freeze({ scope: "transport" });
+var RECOVERY_NOT_RECOVERABLE = Object.freeze({
+  scope: "not-recoverable"
+});
+var RECOVERY_UNKNOWN = Object.freeze({ scope: "unknown" });
+function defaultRecoveryForCode(code) {
   switch (code) {
+    case 10001 /* UserRejected */:
+    case 10005 /* UserAborted */:
+    case 10102 /* DeviceBusy */:
+    case 10103 /* DeviceLocked */:
+    case 10104 /* DeviceNotInitialized */:
+    case 10105 /* DeviceInBootloader */:
+    case 10107 /* DeviceAppStuck */:
+    case 10111 /* DeviceBusyInternal */:
+    case 10305 /* NetworkError */:
+    case 10311 /* LedgerSecureChannelError */:
+    case 10312 /* LedgerFirmwareMetadataError */:
     case 10400 /* PinInvalid */:
-      return `${originalMessage}. Please re-enter your PIN.`;
     case 10401 /* PinCancelled */:
-      return `${originalMessage}. PIN entry was cancelled.`;
+    case 10402 /* PassphraseRejected */:
+    case 10403 /* PassphraseStateMismatch */:
     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 10200 /* FirmwareTooOld */:
+    case 10201 /* FirmwareUpdateRequired */:
     case 10500 /* AppNotInstalled */:
-      return `${originalMessage}. The required app is not installed on the device.`;
+    case 10501 /* WrongApp */:
+    case 10502 /* AppTooOld */:
     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 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 10504 /* AppAlreadyInstalled */:
     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.";
+      return RECOVERY_CALL;
+    case 10100 /* DeviceNotFound */:
+    case 10101 /* DeviceDisconnected */:
+    case 10112 /* OperationNotFound */:
+    case 10113 /* OperationEnded */:
+    case 10300 /* TransportError */:
+    case 10304 /* BlePairingTimeout */:
+    case 10306 /* ThpPairingFailed */:
+    case 10308 /* ThpPairingRequired */:
+    case 10309 /* BleConnectFailed */:
+    case 10310 /* BlePairingCancelled */:
+      return RECOVERY_OPERATION;
+    case 10106 /* DeviceMismatch */:
+    case 10114 /* DeviceSearchMismatch */:
+    case 10109 /* DeviceOneDeviceOnly */:
+    case 10307 /* BleBondInvalid */:
+      return RECOVERY_SEARCH_TARGET;
+    case 10301 /* BridgeNotFound */:
+    case 10302 /* TransportNotAvailable */:
+    case 10303 /* DevicePermissionDenied */:
+    case 10600 /* PayloadTooLarge */:
+      return RECOVERY_TRANSPORT;
+    case 10002 /* InvalidParams */:
+    case 10004 /* MethodNotSupported */:
+    case 10108 /* ChainNotSupported */:
+    case 10110 /* DevicePathForbidden */:
+      return RECOVERY_NOT_RECOVERABLE;
+    case 1e4 /* UnknownError */:
+    case 10003 /* OperationTimeout */:
     default:
-      return originalMessage;
+      return RECOVERY_UNKNOWN;
   }
 }
+function defaultOriginForCode(code) {
+  if (code >= 11e3) return "device";
+  switch (code) {
+    case 10001 /* UserRejected */:
+    case 10103 /* DeviceLocked */:
+    case 10104 /* DeviceNotInitialized */:
+    case 10105 /* DeviceInBootloader */:
+    case 10106 /* DeviceMismatch */:
+    case 10114 /* DeviceSearchMismatch */:
+    case 10107 /* DeviceAppStuck */:
+    case 10110 /* DevicePathForbidden */:
+    case 10111 /* DeviceBusyInternal */:
+    case 10108 /* ChainNotSupported */:
+    case 10200 /* FirmwareTooOld */:
+    case 10201 /* FirmwareUpdateRequired */:
+    case 10400 /* PinInvalid */:
+    case 10404 /* PinMismatch */:
+    case 10402 /* PassphraseRejected */:
+    case 10403 /* PassphraseStateMismatch */:
+    case 10306 /* ThpPairingFailed */:
+    case 10308 /* ThpPairingRequired */:
+    case 10501 /* WrongApp */:
+    case 10500 /* AppNotInstalled */:
+    case 10502 /* AppTooOld */:
+    case 10503 /* DeviceOutOfMemory */:
+    case 10504 /* AppAlreadyInstalled */:
+      return "device";
+    case 10100 /* DeviceNotFound */:
+    case 10101 /* DeviceDisconnected */:
+    case 10300 /* TransportError */:
+    case 10301 /* BridgeNotFound */:
+    case 10302 /* TransportNotAvailable */:
+    case 10304 /* BlePairingTimeout */:
+    case 10305 /* NetworkError */:
+    case 10311 /* LedgerSecureChannelError */:
+    case 10312 /* LedgerFirmwareMetadataError */:
+    case 10307 /* BleBondInvalid */:
+    case 10309 /* BleConnectFailed */:
+      return "transport";
+    case 10303 /* DevicePermissionDenied */:
+    case 10005 /* UserAborted */:
+    case 10002 /* InvalidParams */:
+    case 10004 /* MethodNotSupported */:
+    case 10401 /* PinCancelled */:
+    case 10310 /* BlePairingCancelled */:
+    case 10600 /* PayloadTooLarge */:
+    case 10109 /* DeviceOneDeviceOnly */:
+      return "host";
+    default:
+      return void 0;
+  }
+}
+function operationMayHaveCompletedParams(method, params) {
+  return {
+    ...params,
+    operationMayHaveCompleted: true,
+    method
+  };
+}
+function createHwkError(payload) {
+  const recovery = _nullishCoalesce(payload.recovery, () => ( defaultRecoveryForCode(payload.code)));
+  return Object.assign(new Error(payload.message), {
+    code: payload.code,
+    ...payload.origin !== void 0 && { origin: payload.origin },
+    recovery,
+    ...payload._tag !== void 0 && { _tag: payload._tag },
+    ...payload.appName !== void 0 && { appName: payload.appName },
+    ...payload.params !== void 0 && { params: payload.params }
+  });
+}
+
+
+
 
 
 
 
 
 
-exports.HardwareErrorCode = HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = createHwkError; exports.enrichErrorMessage = enrichErrorMessage;
-//# sourceMappingURL=chunk-SZZF623R.js.map
+exports.HardwareErrorCode = HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = ORPHAN_ELIGIBLE_ERROR_CODES; exports.isHwkRecoveryHint = isHwkRecoveryHint; exports.defaultRecoveryForCode = defaultRecoveryForCode; exports.defaultOriginForCode = defaultOriginForCode; exports.operationMayHaveCompletedParams = operationMayHaveCompletedParams; exports.createHwkError = createHwkError;
+//# sourceMappingURL=chunk-T5HIQPNG.js.map