@onekeyfe/hwk-adapter-core 1.1.29-alpha.2 → 1.1.29-alpha.4

package/dist/{chunk-QD4EQWQA.js → chunk-CIFXSGRW.js}

@@ -16,6 +16,7 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["DeviceAppStuck"] = 10107] = "DeviceAppStuck";
   HardwareErrorCode2[HardwareErrorCode2["ChainNotSupported"] = 10108] = "ChainNotSupported";
   HardwareErrorCode2[HardwareErrorCode2["DeviceOneDeviceOnly"] = 10109] = "DeviceOneDeviceOnly";
+  HardwareErrorCode2[HardwareErrorCode2["DevicePathForbidden"] = 10110] = "DevicePathForbidden";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareTooOld"] = 10200] = "FirmwareTooOld";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareUpdateRequired"] = 10201] = "FirmwareUpdateRequired";
   HardwareErrorCode2[HardwareErrorCode2["TransportError"] = 10300] = "TransportError";
@@ -26,6 +27,8 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["NetworkError"] = 10305] = "NetworkError";
   HardwareErrorCode2[HardwareErrorCode2["ThpPairingFailed"] = 10306] = "ThpPairingFailed";
   HardwareErrorCode2[HardwareErrorCode2["BleBondInvalid"] = 10307] = "BleBondInvalid";
+  HardwareErrorCode2[HardwareErrorCode2["ThpPairingRequired"] = 10308] = "ThpPairingRequired";
+  HardwareErrorCode2[HardwareErrorCode2["BleConnectFailed"] = 10309] = "BleConnectFailed";
   HardwareErrorCode2[HardwareErrorCode2["PinInvalid"] = 10400] = "PinInvalid";
   HardwareErrorCode2[HardwareErrorCode2["PinCancelled"] = 10401] = "PinCancelled";
   HardwareErrorCode2[HardwareErrorCode2["PassphraseRejected"] = 10402] = "PassphraseRejected";
@@ -58,7 +61,9 @@ var ORPHAN_ELIGIBLE_ERROR_CODES = [
   10303 /* DevicePermissionDenied */,
   10304 /* BlePairingTimeout */,
   10306 /* ThpPairingFailed */,
-  10307 /* BleBondInvalid */
+  10308 /* ThpPairingRequired */,
+  10307 /* BleBondInvalid */,
+  10309 /* BleConnectFailed */
 ];
 function createHwkError(payload) {
   return Object.assign(new Error(payload.message), {
@@ -135,4 +140,4 @@ function enrichErrorMessage(code, originalMessage) {
 
 
 exports.HardwareErrorCode = HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = createHwkError; exports.enrichErrorMessage = enrichErrorMessage;
-//# sourceMappingURL=chunk-QD4EQWQA.js.map
+//# sourceMappingURL=chunk-CIFXSGRW.js.map

package/dist/chunk-CIFXSGRW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-CIFXSGRW.js","../src/types/errors.ts","../src/utils/errorMessages.ts"],"names":["HardwareErrorCode"],"mappings":"AAAA;ACuBO,IAAK,kBAAA,kBAAL,CAAA,CAAKA,kBAAAA,EAAAA,GAAL;AAEL,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,GAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,eAAA,EAAA,EAAgB,KAAA,EAAA,EAAhB,eAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,kBAAA,EAAA,EAAmB,KAAA,EAAA,EAAnB,kBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,aAAA,EAAA,EAAc,KAAA,EAAA,EAAd,aAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,YAAA,EAAA,EAAa,KAAA,EAAA,EAAb,YAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,sBAAA,EAAA,EAAuB,KAAA,EAAA,EAAvB,sBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,mBAAA,EAAA,EAAoB,KAAA,EAAA,EAApB,mBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,qBAAA,EAAA,EAAsB,KAAA,EAAA,EAAtB,qBAAA;AAOA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,qBAAA,EAAA,EAAsB,KAAA,EAAA,EAAtB,qBAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,wBAAA,EAAA,EAAyB,KAAA,EAAA,EAAzB,wBAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,uBAAA,EAAA,EAAwB,KAAA,EAAA,EAAxB,uBAAA;AAMA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,wBAAA,EAAA,EAAyB,KAAA,EAAA,EAAzB,wBAAA;AAQA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,mBAAA,EAAA,EAAoB,KAAA,EAAA,EAApB,mBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AASA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,kBAAA,EAAA,EAAmB,KAAA,EAAA,EAAnB,kBAAA;AAUA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AAQA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAUA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,kBAAA,EAAA,EAAmB,KAAA,EAAA,EAAnB,kBAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,YAAA,EAAA,EAAa,KAAA,EAAA,EAAb,YAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAOA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,yBAAA,EAAA,EAA0B,KAAA,EAAA,EAA1B,yBAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,iBAAA,EAAA,EAAkB,KAAA,EAAA,EAAlB,iBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,UAAA,EAAA,EAAW,KAAA,EAAA,EAAX,UAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,WAAA,EAAA,EAAY,KAAA,EAAA,EAAZ,WAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,mBAAA,EAAA,EAAoB,KAAA,EAAA,EAApB,mBAAA;AAKA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,yBAAA,EAAA,EAA0B,IAAA,EAAA,EAA1B,yBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,2BAAA,EAAA,EAA4B,KAAA,EAAA,EAA5B,2BAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,iBAAA,EAAA,EAAkB,KAAA,EAAA,EAAlB,iBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,uBAAA,EAAA,EAAwB,KAAA,EAAA,EAAxB,uBAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,4BAAA,EAAA,EAA6B,KAAA,EAAA,EAA7B,4BAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,4BAAA,EAAA,EAA6B,KAAA,EAAA,EAA7B,4BAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,yBAAA,EAAA,EAA0B,KAAA,EAAA,EAA1B,yBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,wBAAA,EAAA,EAAyB,KAAA,EAAA,EAAzB,wBAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,6BAAA,EAAA,EAA8B,KAAA,EAAA,EAA9B,6BAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AA9IU,EAAA,OAAAA,kBAAAA;AAAA,CAAA,CAAA,CAAA,kBAAA,GAAA,CAAA,CAAA,CAAA;AA4JL,IAAM,4BAAA,EAAwC;AAAA,EACnD,uBAAA;AAAA,EACA,wBAAA;AAAA,EACA,0BAAA;AAAA,EACA,8BAAA;AAAA,EACA,0BAAA;AAAA,EACA,0BAAA;AAAA,EACA,+BAAA;AAAA,EACA,0BAAA;AAAA,EACA,kCAAA;AAAA,EACA,6BAAA;AAAA,EACA,4BAAA;AAAA,EACA,8BAAA;AAAA,EACA,0BAAA;AAAA,EACA;AACF,CAAA;AA4BO,SAAS,cAAA,CAAe,OAAA,EAAqC;AAClE,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AAAA,IAC/C,IAAA,EAAM,OAAA,CAAQ,IAAA;AAAA,IACd,GAAI,OAAA,CAAQ,KAAA,IAAS,KAAA,EAAA,GAAa,EAAE,IAAA,EAAM,OAAA,CAAQ,KAAK,CAAA;AAAA,IACvD,GAAI,OAAA,CAAQ,QAAA,IAAY,KAAA,EAAA,GAAa,EAAE,OAAA,EAAS,OAAA,CAAQ,QAAQ,CAAA;AAAA,IAChE,GAAI,OAAA,CAAQ,OAAA,IAAW,KAAA,EAAA,GAAa,EAAE,MAAA,EAAQ,OAAA,CAAQ,OAAO;AAAA,EAC/D,CAAC,CAAA;AACH;AD1JA;AACA;AEtEO,SAAS,kBAAA,CAAmB,IAAA,EAAyB,eAAA,EAAiC;AAC3F,EAAA,OAAA,CAAQ,IAAA,EAAM;AAAA,IACZ,KAAA,sBAAA;AACE,MAAA,OAAO,CAAA,EAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACX,EAAA;AACF;AFwEc;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-CIFXSGRW.js","sourcesContent":[null,"/**\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-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\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  // --- 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  // --- 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\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.DeviceMismatch,\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];\n\n// ---------------------------------------------------------------------------\n// Standard throwable for HWK adapters\n// ---------------------------------------------------------------------------\n\nexport interface IHwkErrorPayload {\n  code: HardwareErrorCode;\n  message: string;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type HwkError = Error & {\n  code: HardwareErrorCode;\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  return Object.assign(new Error(payload.message), {\n    code: payload.code,\n    ...(payload._tag !== undefined && { _tag: payload._tag }),\n    ...(payload.appName !== undefined && { appName: payload.appName }),\n    ...(payload.params !== undefined && { params: payload.params }),\n  });\n}\n","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.DeviceBusy:\n      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;\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.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"]}

package/dist/{chunk-D5OZT7RZ.mjs → chunk-JPP3QN5E.mjs}

@@ -16,6 +16,7 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["DeviceAppStuck"] = 10107] = "DeviceAppStuck";
   HardwareErrorCode2[HardwareErrorCode2["ChainNotSupported"] = 10108] = "ChainNotSupported";
   HardwareErrorCode2[HardwareErrorCode2["DeviceOneDeviceOnly"] = 10109] = "DeviceOneDeviceOnly";
+  HardwareErrorCode2[HardwareErrorCode2["DevicePathForbidden"] = 10110] = "DevicePathForbidden";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareTooOld"] = 10200] = "FirmwareTooOld";
   HardwareErrorCode2[HardwareErrorCode2["FirmwareUpdateRequired"] = 10201] = "FirmwareUpdateRequired";
   HardwareErrorCode2[HardwareErrorCode2["TransportError"] = 10300] = "TransportError";
@@ -26,6 +27,8 @@ var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
   HardwareErrorCode2[HardwareErrorCode2["NetworkError"] = 10305] = "NetworkError";
   HardwareErrorCode2[HardwareErrorCode2["ThpPairingFailed"] = 10306] = "ThpPairingFailed";
   HardwareErrorCode2[HardwareErrorCode2["BleBondInvalid"] = 10307] = "BleBondInvalid";
+  HardwareErrorCode2[HardwareErrorCode2["ThpPairingRequired"] = 10308] = "ThpPairingRequired";
+  HardwareErrorCode2[HardwareErrorCode2["BleConnectFailed"] = 10309] = "BleConnectFailed";
   HardwareErrorCode2[HardwareErrorCode2["PinInvalid"] = 10400] = "PinInvalid";
   HardwareErrorCode2[HardwareErrorCode2["PinCancelled"] = 10401] = "PinCancelled";
   HardwareErrorCode2[HardwareErrorCode2["PassphraseRejected"] = 10402] = "PassphraseRejected";
@@ -58,7 +61,9 @@ var ORPHAN_ELIGIBLE_ERROR_CODES = [
   10303 /* DevicePermissionDenied */,
   10304 /* BlePairingTimeout */,
   10306 /* ThpPairingFailed */,
-  10307 /* BleBondInvalid */
+  10308 /* ThpPairingRequired */,
+  10307 /* BleBondInvalid */,
+  10309 /* BleConnectFailed */
 ];
 function createHwkError(payload) {
   return Object.assign(new Error(payload.message), {
@@ -135,4 +140,4 @@ export {
   createHwkError,
   enrichErrorMessage
 };
-//# sourceMappingURL=chunk-D5OZT7RZ.mjs.map
+//# sourceMappingURL=chunk-JPP3QN5E.mjs.map

package/dist/chunk-JPP3QN5E.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/errors.ts","../src/utils/errorMessages.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-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\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  // --- 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  // --- 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\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.DeviceMismatch,\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];\n\n// ---------------------------------------------------------------------------\n// Standard throwable for HWK adapters\n// ---------------------------------------------------------------------------\n\nexport interface IHwkErrorPayload {\n  code: HardwareErrorCode;\n  message: string;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type HwkError = Error & {\n  code: HardwareErrorCode;\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  return Object.assign(new Error(payload.message), {\n    code: payload.code,\n    ...(payload._tag !== undefined && { _tag: payload._tag }),\n    ...(payload.appName !== undefined && { appName: payload.appName }),\n    ...(payload.params !== undefined && { params: payload.params }),\n  });\n}\n","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.DeviceBusy:\n      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;\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.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":"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","names":["HardwareErrorCode"]}

package/dist/errors.d.mts

@@ -42,6 +42,13 @@ declare enum HardwareErrorCode {
     ChainNotSupported = 10108,
     /** Current operation supports only one connected device. */
     DeviceOneDeviceOnly = 10109,
+    /**
+     * The device rejected the requested derivation path (Trezor Failure_DataError
+     * "Forbidden key path") — the path is non-standard or its index is outside the
+     * range the device's safety checks allow. Distinct from ChainNotSupported
+     * (whole chain) and MethodNotSupported (the operation/method itself).
+     */
+    DevicePathForbidden = 10110,
     FirmwareTooOld = 10200,
     FirmwareUpdateRequired = 10201,
     TransportError = 10300,
@@ -82,6 +89,24 @@ declare enum HardwareErrorCode {
      * ThpPairingFailed (THP code mismatch).
      */
     BleBondInvalid = 10307,
+    /**
+     * A stored THP pairing credential was rejected by the device during the
+     * handshake (device returned completion `state=0`), so the autoconnect session
+     * could not be established. The SDK discards the stale credential; recovery is
+     * a fresh pairing. Distinct from ThpPairingFailed (user mistyped the code
+     * during an *active* pairing) and BleBondInvalid (OS-level BLE bond).
+     */
+    ThpPairingRequired = 10308,
+    /**
+     * Generic BLE connect failure where the OS dropped the specific reason. On
+     * macOS the noble native binding hardcodes "connection failed" (and a connect
+     * timeout) and discards the CoreBluetooth NSError, so the SDK cannot tell a
+     * stale bond from an out-of-range / unresponsive device. Surfaced as a
+     * generic "couldn't connect — check the device, re-pair if paired before".
+     * Distinct from BleBondInvalid (a *known* stale-bond signal, iOS/Android only)
+     * and BlePairingTimeout (the SMP bonding window).
+     */
+    BleConnectFailed = 10309,
     PinInvalid = 10400,
     PinCancelled = 10401,
     PassphraseRejected = 10402,

package/dist/errors.d.ts

@@ -42,6 +42,13 @@ declare enum HardwareErrorCode {
     ChainNotSupported = 10108,
     /** Current operation supports only one connected device. */
     DeviceOneDeviceOnly = 10109,
+    /**
+     * The device rejected the requested derivation path (Trezor Failure_DataError
+     * "Forbidden key path") — the path is non-standard or its index is outside the
+     * range the device's safety checks allow. Distinct from ChainNotSupported
+     * (whole chain) and MethodNotSupported (the operation/method itself).
+     */
+    DevicePathForbidden = 10110,
     FirmwareTooOld = 10200,
     FirmwareUpdateRequired = 10201,
     TransportError = 10300,
@@ -82,6 +89,24 @@ declare enum HardwareErrorCode {
      * ThpPairingFailed (THP code mismatch).
      */
     BleBondInvalid = 10307,
+    /**
+     * A stored THP pairing credential was rejected by the device during the
+     * handshake (device returned completion `state=0`), so the autoconnect session
+     * could not be established. The SDK discards the stale credential; recovery is
+     * a fresh pairing. Distinct from ThpPairingFailed (user mistyped the code
+     * during an *active* pairing) and BleBondInvalid (OS-level BLE bond).
+     */
+    ThpPairingRequired = 10308,
+    /**
+     * Generic BLE connect failure where the OS dropped the specific reason. On
+     * macOS the noble native binding hardcodes "connection failed" (and a connect
+     * timeout) and discards the CoreBluetooth NSError, so the SDK cannot tell a
+     * stale bond from an out-of-range / unresponsive device. Surfaced as a
+     * generic "couldn't connect — check the device, re-pair if paired before".
+     * Distinct from BleBondInvalid (a *known* stale-bond signal, iOS/Android only)
+     * and BlePairingTimeout (the SMP bonding window).
+     */
+    BleConnectFailed = 10309,
     PinInvalid = 10400,
     PinCancelled = 10401,
     PassphraseRejected = 10402,

package/dist/errors.js

@@ -3,11 +3,11 @@
 
 
 
-var _chunkQD4EQWQAjs = require('./chunk-QD4EQWQA.js');
+var _chunkCIFXSGRWjs = require('./chunk-CIFXSGRW.js');
 
 
 
 
 
-exports.HardwareErrorCode = _chunkQD4EQWQAjs.HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkQD4EQWQAjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = _chunkQD4EQWQAjs.createHwkError; exports.enrichErrorMessage = _chunkQD4EQWQAjs.enrichErrorMessage;
+exports.HardwareErrorCode = _chunkCIFXSGRWjs.HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkCIFXSGRWjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = _chunkCIFXSGRWjs.createHwkError; exports.enrichErrorMessage = _chunkCIFXSGRWjs.enrichErrorMessage;
 //# sourceMappingURL=errors.js.map

package/dist/errors.mjs

@@ -3,7 +3,7 @@ import {
   ORPHAN_ELIGIBLE_ERROR_CODES,
   createHwkError,
   enrichErrorMessage
-} from "./chunk-D5OZT7RZ.mjs";
+} from "./chunk-JPP3QN5E.mjs";
 export {
   HardwareErrorCode,
   ORPHAN_ELIGIBLE_ERROR_CODES,

package/dist/index.js

@@ -3,7 +3,7 @@
 
 
 
-var _chunkQD4EQWQAjs = require('./chunk-QD4EQWQA.js');
+var _chunkCIFXSGRWjs = require('./chunk-CIFXSGRW.js');
 
 
 
@@ -286,13 +286,13 @@ function isDeviceUnavailableError(error) {
   return false;
 }
 function combinedDeviceNotFoundError(message) {
-  return _chunkQD4EQWQAjs.createHwkError.call(void 0, {
+  return _chunkCIFXSGRWjs.createHwkError.call(void 0, {
     code: 10100 /* DeviceNotFound */,
     message
   });
 }
 function combinedSessionNotFoundError(message) {
-  return _chunkQD4EQWQAjs.createHwkError.call(void 0, {
+  return _chunkCIFXSGRWjs.createHwkError.call(void 0, {
     code: 10101 /* DeviceDisconnected */,
     message
   });
@@ -414,7 +414,7 @@ function createCombinedConnector(connectors) {
       }
     }
     const message = lastError instanceof Error ? lastError.message : `Combined connector: device not found: ${deviceId}`;
-    throw _chunkQD4EQWQAjs.createHwkError.call(void 0, {
+    throw _chunkCIFXSGRWjs.createHwkError.call(void 0, {
       code: 10100 /* DeviceNotFound */,
       message
     });
@@ -760,5 +760,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.HardwareErrorCode = _chunkQD4EQWQAjs.HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkQD4EQWQAjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.SDK = SDK; exports.TypedEventEmitter = TypedEventEmitter; exports.UI_EVENT = _chunkLYVS67EXjs.UI_EVENT; exports.UI_REQUEST = _chunkLYVS67EXjs.UI_REQUEST; exports.UI_REQUEST_CANCELLED_TAG = _chunkLYVS67EXjs.UI_REQUEST_CANCELLED_TAG; exports.UI_REQUEST_DEFAULT_TIMEOUT_MS = _chunkLYVS67EXjs.UI_REQUEST_DEFAULT_TIMEOUT_MS; exports.UI_REQUEST_PREEMPTED_TAG = _chunkLYVS67EXjs.UI_REQUEST_PREEMPTED_TAG; exports.UI_REQUEST_TIMEOUT_TAG = _chunkLYVS67EXjs.UI_REQUEST_TIMEOUT_TAG; exports.UI_RESPONSE = _chunkLYVS67EXjs.UI_RESPONSE; exports.UiRequestRegistry = _chunkLYVS67EXjs.UiRequestRegistry; exports.batchCall = batchCall; exports.buildUnsupportedMethodResponse = buildUnsupportedMethodResponse; exports.bytesToHex = bytesToHex2; exports.compareSemver = compareSemver; exports.createBridgedConnector = createBridgedConnector; exports.createCombinedConnector = createCombinedConnector; exports.createHwkError = _chunkQD4EQWQAjs.createHwkError; exports.deriveDeviceFingerprint = deriveDeviceFingerprint; exports.detectHardwareVendorFromDescriptor = detectHardwareVendorFromDescriptor; exports.enrichErrorMessage = _chunkQD4EQWQAjs.enrichErrorMessage; exports.ensure0x = ensure0x; exports.failure = failure; exports.getAllNetworkMethodChain = getAllNetworkMethodChain; exports.getHardwareMethodMetadata = getHardwareMethodMetadata; exports.hexToBytes = hexToBytes; exports.isAllNetworkMethodName = isAllNetworkMethodName; exports.isKnownNonTargetHardwareVendor = isKnownNonTargetHardwareVendor; exports.padHex64 = padHex64; exports.rehydrateConnectorError = rehydrateConnectorError; 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.HardwareErrorCode = _chunkCIFXSGRWjs.HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkCIFXSGRWjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.SDK = SDK; exports.TypedEventEmitter = TypedEventEmitter; exports.UI_EVENT = _chunkLYVS67EXjs.UI_EVENT; exports.UI_REQUEST = _chunkLYVS67EXjs.UI_REQUEST; exports.UI_REQUEST_CANCELLED_TAG = _chunkLYVS67EXjs.UI_REQUEST_CANCELLED_TAG; exports.UI_REQUEST_DEFAULT_TIMEOUT_MS = _chunkLYVS67EXjs.UI_REQUEST_DEFAULT_TIMEOUT_MS; exports.UI_REQUEST_PREEMPTED_TAG = _chunkLYVS67EXjs.UI_REQUEST_PREEMPTED_TAG; exports.UI_REQUEST_TIMEOUT_TAG = _chunkLYVS67EXjs.UI_REQUEST_TIMEOUT_TAG; exports.UI_RESPONSE = _chunkLYVS67EXjs.UI_RESPONSE; exports.UiRequestRegistry = _chunkLYVS67EXjs.UiRequestRegistry; exports.batchCall = batchCall; exports.buildUnsupportedMethodResponse = buildUnsupportedMethodResponse; exports.bytesToHex = bytesToHex2; exports.compareSemver = compareSemver; exports.createBridgedConnector = createBridgedConnector; exports.createCombinedConnector = createCombinedConnector; exports.createHwkError = _chunkCIFXSGRWjs.createHwkError; exports.deriveDeviceFingerprint = deriveDeviceFingerprint; exports.detectHardwareVendorFromDescriptor = detectHardwareVendorFromDescriptor; exports.enrichErrorMessage = _chunkCIFXSGRWjs.enrichErrorMessage; exports.ensure0x = ensure0x; exports.failure = failure; exports.getAllNetworkMethodChain = getAllNetworkMethodChain; exports.getHardwareMethodMetadata = getHardwareMethodMetadata; exports.hexToBytes = hexToBytes; exports.isAllNetworkMethodName = isAllNetworkMethodName; exports.isKnownNonTargetHardwareVendor = isKnownNonTargetHardwareVendor; exports.padHex64 = padHex64; exports.rehydrateConnectorError = rehydrateConnectorError; exports.runAllNetworkGetAddress = runAllNetworkGetAddress; exports.serializeConnectorError = serializeConnectorError; exports.stripHex = stripHex; exports.success = success;
 //# sourceMappingURL=index.js.map

package/dist/index.mjs

@@ -3,7 +3,7 @@ import {
   ORPHAN_ELIGIBLE_ERROR_CODES,
   createHwkError,
   enrichErrorMessage
-} from "./chunk-D5OZT7RZ.mjs";
+} from "./chunk-JPP3QN5E.mjs";
 import {
   UI_EVENT,
   UI_REQUEST,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hwk-adapter-core",
-  "version": "1.1.29-alpha.2",
+  "version": "1.1.29-alpha.4",
   "description": "Shared types and utilities for OneKey hardware wallet kit",
   "author": "OneKey",
   "license": "MIT",
@@ -70,5 +70,5 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0"
   },
-  "gitHead": "f38cc2a0f28fa72831c459d57cd8218eb42a0feb"
+  "gitHead": "b8dd3f340cfccea5da08c4b644cea6861c1b7b04"
 }

package/dist/chunk-D5OZT7RZ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/errors.ts","../src/utils/errorMessages.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-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  // --- 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  // --- 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  // --- 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\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.DeviceMismatch,\n  HardwareErrorCode.DeviceAppStuck,\n  HardwareErrorCode.DeviceOneDeviceOnly,\n  HardwareErrorCode.TransportError,\n  HardwareErrorCode.DevicePermissionDenied,\n  HardwareErrorCode.BlePairingTimeout,\n  HardwareErrorCode.ThpPairingFailed,\n  HardwareErrorCode.BleBondInvalid,\n];\n\n// ---------------------------------------------------------------------------\n// Standard throwable for HWK adapters\n// ---------------------------------------------------------------------------\n\nexport interface IHwkErrorPayload {\n  code: HardwareErrorCode;\n  message: string;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type HwkError = Error & {\n  code: HardwareErrorCode;\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  return Object.assign(new Error(payload.message), {\n    code: payload.code,\n    ...(payload._tag !== undefined && { _tag: payload._tag }),\n    ...(payload.appName !== undefined && { appName: payload.appName }),\n    ...(payload.params !== undefined && { params: payload.params }),\n  });\n}\n","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.DeviceBusy:\n      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;\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.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":"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","names":["HardwareErrorCode"]}

package/dist/chunk-QD4EQWQA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-QD4EQWQA.js","../src/types/errors.ts","../src/utils/errorMessages.ts"],"names":["HardwareErrorCode"],"mappings":"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","file":"/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-QD4EQWQA.js","sourcesContent":[null,"/**\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-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  // --- 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  // --- 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  // --- 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\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.DeviceMismatch,\n  HardwareErrorCode.DeviceAppStuck,\n  HardwareErrorCode.DeviceOneDeviceOnly,\n  HardwareErrorCode.TransportError,\n  HardwareErrorCode.DevicePermissionDenied,\n  HardwareErrorCode.BlePairingTimeout,\n  HardwareErrorCode.ThpPairingFailed,\n  HardwareErrorCode.BleBondInvalid,\n];\n\n// ---------------------------------------------------------------------------\n// Standard throwable for HWK adapters\n// ---------------------------------------------------------------------------\n\nexport interface IHwkErrorPayload {\n  code: HardwareErrorCode;\n  message: string;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type HwkError = Error & {\n  code: HardwareErrorCode;\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  return Object.assign(new Error(payload.message), {\n    code: payload.code,\n    ...(payload._tag !== undefined && { _tag: payload._tag }),\n    ...(payload.appName !== undefined && { appName: payload.appName }),\n    ...(payload.params !== undefined && { params: payload.params }),\n  });\n}\n","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.DeviceBusy:\n      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;\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.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"]}