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

package/dist/chunk-QD4EQWQA.js

@@ -0,0 +1,138 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/types/errors.ts
+var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
+  HardwareErrorCode2[HardwareErrorCode2["UnknownError"] = 1e4] = "UnknownError";
+  HardwareErrorCode2[HardwareErrorCode2["UserRejected"] = 10001] = "UserRejected";
+  HardwareErrorCode2[HardwareErrorCode2["InvalidParams"] = 10002] = "InvalidParams";
+  HardwareErrorCode2[HardwareErrorCode2["OperationTimeout"] = 10003] = "OperationTimeout";
+  HardwareErrorCode2[HardwareErrorCode2["MethodNotSupported"] = 10004] = "MethodNotSupported";
+  HardwareErrorCode2[HardwareErrorCode2["UserAborted"] = 10005] = "UserAborted";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceNotFound"] = 10100] = "DeviceNotFound";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceDisconnected"] = 10101] = "DeviceDisconnected";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceBusy"] = 10102] = "DeviceBusy";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceLocked"] = 10103] = "DeviceLocked";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceNotInitialized"] = 10104] = "DeviceNotInitialized";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceInBootloader"] = 10105] = "DeviceInBootloader";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceMismatch"] = 10106] = "DeviceMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceAppStuck"] = 10107] = "DeviceAppStuck";
+  HardwareErrorCode2[HardwareErrorCode2["ChainNotSupported"] = 10108] = "ChainNotSupported";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceOneDeviceOnly"] = 10109] = "DeviceOneDeviceOnly";
+  HardwareErrorCode2[HardwareErrorCode2["FirmwareTooOld"] = 10200] = "FirmwareTooOld";
+  HardwareErrorCode2[HardwareErrorCode2["FirmwareUpdateRequired"] = 10201] = "FirmwareUpdateRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TransportError"] = 10300] = "TransportError";
+  HardwareErrorCode2[HardwareErrorCode2["BridgeNotFound"] = 10301] = "BridgeNotFound";
+  HardwareErrorCode2[HardwareErrorCode2["TransportNotAvailable"] = 10302] = "TransportNotAvailable";
+  HardwareErrorCode2[HardwareErrorCode2["DevicePermissionDenied"] = 10303] = "DevicePermissionDenied";
+  HardwareErrorCode2[HardwareErrorCode2["BlePairingTimeout"] = 10304] = "BlePairingTimeout";
+  HardwareErrorCode2[HardwareErrorCode2["NetworkError"] = 10305] = "NetworkError";
+  HardwareErrorCode2[HardwareErrorCode2["ThpPairingFailed"] = 10306] = "ThpPairingFailed";
+  HardwareErrorCode2[HardwareErrorCode2["BleBondInvalid"] = 10307] = "BleBondInvalid";
+  HardwareErrorCode2[HardwareErrorCode2["PinInvalid"] = 10400] = "PinInvalid";
+  HardwareErrorCode2[HardwareErrorCode2["PinCancelled"] = 10401] = "PinCancelled";
+  HardwareErrorCode2[HardwareErrorCode2["PassphraseRejected"] = 10402] = "PassphraseRejected";
+  HardwareErrorCode2[HardwareErrorCode2["PassphraseStateMismatch"] = 10403] = "PassphraseStateMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["AppNotInstalled"] = 10500] = "AppNotInstalled";
+  HardwareErrorCode2[HardwareErrorCode2["WrongApp"] = 10501] = "WrongApp";
+  HardwareErrorCode2[HardwareErrorCode2["AppTooOld"] = 10502] = "AppTooOld";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceOutOfMemory"] = 10503] = "DeviceOutOfMemory";
+  HardwareErrorCode2[HardwareErrorCode2["EvmBlindSigningRequired"] = 11e3] = "EvmBlindSigningRequired";
+  HardwareErrorCode2[HardwareErrorCode2["EvmClearSignPluginMissing"] = 11001] = "EvmClearSignPluginMissing";
+  HardwareErrorCode2[HardwareErrorCode2["EvmDataTooLarge"] = 11002] = "EvmDataTooLarge";
+  HardwareErrorCode2[HardwareErrorCode2["EvmTxTypeNotSupported"] = 11003] = "EvmTxTypeNotSupported";
+  HardwareErrorCode2[HardwareErrorCode2["SolanaBlindSigningRequired"] = 11100] = "SolanaBlindSigningRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TronCustomContractRequired"] = 11200] = "TronCustomContractRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TronDataSigningRequired"] = 11201] = "TronDataSigningRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TronSignByHashRequired"] = 11202] = "TronSignByHashRequired";
+  HardwareErrorCode2[HardwareErrorCode2["BtcWalletPolicyHmacMismatch"] = 11300] = "BtcWalletPolicyHmacMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["BtcUnexpectedState"] = 11301] = "BtcUnexpectedState";
+  return HardwareErrorCode2;
+})(HardwareErrorCode || {});
+var ORPHAN_ELIGIBLE_ERROR_CODES = [
+  10005 /* UserAborted */,
+  10001 /* UserRejected */,
+  10100 /* DeviceNotFound */,
+  10101 /* DeviceDisconnected */,
+  10106 /* DeviceMismatch */,
+  10107 /* DeviceAppStuck */,
+  10109 /* DeviceOneDeviceOnly */,
+  10300 /* TransportError */,
+  10303 /* DevicePermissionDenied */,
+  10304 /* BlePairingTimeout */,
+  10306 /* ThpPairingFailed */,
+  10307 /* BleBondInvalid */
+];
+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 }
+  });
+}
+
+// src/utils/errorMessages.ts
+function enrichErrorMessage(code, originalMessage) {
+  switch (code) {
+    case 10400 /* PinInvalid */:
+      return `${originalMessage}. Please re-enter your PIN.`;
+    case 10401 /* PinCancelled */:
+      return `${originalMessage}. PIN entry was cancelled.`;
+    case 10102 /* DeviceBusy */:
+      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;
+    case 10101 /* DeviceDisconnected */:
+      return `${originalMessage}. Please reconnect the device and try again.`;
+    case 10103 /* DeviceLocked */:
+      return `${originalMessage}. Please unlock your device and try again.`;
+    case 10109 /* DeviceOneDeviceOnly */:
+      return `${originalMessage}. Disconnect the extra device and try again.`;
+    case 10001 /* UserRejected */:
+      return `${originalMessage}. The request was rejected on the device.`;
+    case 10501 /* WrongApp */:
+      return `${originalMessage}. Please open the correct app on your device.`;
+    case 10500 /* AppNotInstalled */:
+      return `${originalMessage}. The required app is not installed on the device.`;
+    case 10503 /* DeviceOutOfMemory */:
+      return `${originalMessage}. Not enough free space on the device. Please uninstall some apps and try again.`;
+    case 10302 /* TransportNotAvailable */:
+      return `${originalMessage}. Ensure the device bridge/transport is available and running.`;
+    case 10305 /* NetworkError */:
+      return `${originalMessage}. Network error \u2014 check your internet connection and try again.`;
+    case 10200 /* FirmwareTooOld */:
+      return `${originalMessage}. Please update your device firmware.`;
+    case 10104 /* DeviceNotInitialized */:
+      return `${originalMessage}. The device may need to be set up first.`;
+    case 10003 /* OperationTimeout */:
+      return `${originalMessage}. The operation timed out. Please try again.`;
+    case 11e3 /* EvmBlindSigningRequired */:
+      return "Ledger: Blind signing not enabled in Ethereum app.";
+    case 11001 /* EvmClearSignPluginMissing */:
+      return "Ledger: Required plugin not installed (install via Ledger Live).";
+    case 11002 /* EvmDataTooLarge */:
+      return "Ledger: Transaction data too large for device memory.";
+    case 11003 /* EvmTxTypeNotSupported */:
+      return "Ledger: Transaction type not supported by current Ethereum app.";
+    case 10502 /* AppTooOld */:
+      return "Ledger: App out of date (update via Ledger Live).";
+    case 11100 /* SolanaBlindSigningRequired */:
+      return "Blind signing disabled in the Solana app.";
+    case 11200 /* TronCustomContractRequired */:
+      return "Custom Contracts setting disabled in the Tron app.";
+    case 11201 /* TronDataSigningRequired */:
+      return "Transactions Data setting disabled in the Tron app.";
+    case 11202 /* TronSignByHashRequired */:
+      return "Sign by Hash setting disabled in the Tron app.";
+    case 11300 /* BtcWalletPolicyHmacMismatch */:
+      return "Wallet policy not registered or HMAC mismatch.";
+    case 11301 /* BtcUnexpectedState */:
+      return "Signing aborted due to unexpected device state.";
+    default:
+      return originalMessage;
+  }
+}
+
+
+
+
+
+
+exports.HardwareErrorCode = HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = createHwkError; exports.enrichErrorMessage = enrichErrorMessage;
+//# sourceMappingURL=chunk-QD4EQWQA.js.map

package/dist/chunk-QD4EQWQA.js.map

@@ -0,0 +1 @@
+{"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"]}

package/dist/errors.d.mts

@@ -0,0 +1,164 @@
+/**
+ * HWK HardwareErrorCode — independent namespace from the legacy
+ * `@onekeyfe/shared` HardwareErrorCode (which occupies 0-902).
+ *
+ * All HWK codes are 5-digit (>= 10000) so the two tables never collide
+ * even if either side grows. Each sub-category gets a 100-slot block.
+ *
+ *   10000-10099  Generic / cross-cutting primitives
+ *   10100-10199  Device state
+ *   10200-10299  Firmware
+ *   10300-10399  Transport + OS-level permission
+ *   10400-10499  PIN / Passphrase
+ *   10500-10599  App lifecycle (wrong app, not open, too old)
+ *   10600-10999  RESERVED — future adapter-level categories
+ *
+ *   11000-11099  EVM APDU (reactive mapping)
+ *   11100-11199  Solana APDU
+ *   11200-11299  Tron APDU
+ *   11300-11399  BTC APDU
+ *   11400-11999  RESERVED — future chain APDU blocks (100 per chain)
+ *
+ *   12000-99999  RESERVED — future major categories
+ */
+declare enum HardwareErrorCode {
+    UnknownError = 10000,
+    UserRejected = 10001,
+    InvalidParams = 10002,
+    OperationTimeout = 10003,
+    MethodNotSupported = 10004,
+    /** User dismissed in-app cancel UI. Distinct from UserRejected (on-device). */
+    UserAborted = 10005,
+    DeviceNotFound = 10100,
+    DeviceDisconnected = 10101,
+    DeviceBusy = 10102,
+    DeviceLocked = 10103,
+    DeviceNotInitialized = 10104,
+    DeviceInBootloader = 10105,
+    DeviceMismatch = 10106,
+    /** Chain app wedged (e.g. Ledger BTC 0x6901). User must exit app on device. */
+    DeviceAppStuck = 10107,
+    /** Vendor (Ledger / Trezor) doesn't support the chain at all. */
+    ChainNotSupported = 10108,
+    /** Current operation supports only one connected device. */
+    DeviceOneDeviceOnly = 10109,
+    FirmwareTooOld = 10200,
+    FirmwareUpdateRequired = 10201,
+    TransportError = 10300,
+    BridgeNotFound = 10301,
+    TransportNotAvailable = 10302,
+    /**
+     * OS-level permission (Bluetooth / USB / etc.) — denied, blocked,
+     * unavailable, or dismissed. Consumers surface a single "please grant
+     * permission" toast and let the user retry manually.
+     */
+    DevicePermissionDenied = 10303,
+    /**
+     * BLE SMP pairing did not complete within the GATT bonding window.
+     * GATT connected but the device didn't acknowledge SMP — typically
+     * because the user didn't confirm the passkey on the device, or the
+     * device went out of range mid-pairing. Distinct from OperationTimeout
+     * (generic) and from DeviceLocked (Secure Element actually locked).
+     */
+    BlePairingTimeout = 10304,
+    /** Remote network failure reaching a vendor's servers (HTTP/WS). Distinct from TransportError (local USB/BLE link). */
+    NetworkError = 10305,
+    /**
+     * Host-managed pairing handshake failed (Trezor THP). The device rejected the
+     * pairing exchange — e.g. CodeEntry: the user mistyped the code shown on the
+     * device, so the CPace tag didn't match ("Unexpected Code Entry Tag").
+     * Recoverable: the user re-pairs and re-enters the code. Distinct from
+     * BlePairingTimeout (BLE SMP bonding window) and UserRejected (on-device
+     * reject button).
+     */
+    ThpPairingFailed = 10306,
+    /**
+     * The OS-level BLE bond is stale/invalid, so the device rejected link
+     * encryption: Android GATT_INSUF_AUTHENTICATION (status 5) or iOS "Peer
+     * removed pairing information". Happens after the device is wiped/re-flashed
+     * or unpaired elsewhere while the host still holds an old bond. The SDK cannot
+     * remove an OS bond — the user must forget the device in system Bluetooth
+     * settings and re-pair. Distinct from BlePairingTimeout (SMP window) and
+     * ThpPairingFailed (THP code mismatch).
+     */
+    BleBondInvalid = 10307,
+    PinInvalid = 10400,
+    PinCancelled = 10401,
+    PassphraseRejected = 10402,
+    /**
+     * The passphrase entered produced a different wallet (`passphraseState`) than
+     * the one the caller asked to operate on. Trezor-only: the host pins a wallet
+     * by its derived state and the SDK refuses to sign with a mismatched
+     * passphrase session. Surfaced by TrezorAdapter.getPassphraseState.
+     */
+    PassphraseStateMismatch = 10403,
+    /** Chain app NOT INSTALLED on device. User must install via Ledger Live. */
+    AppNotInstalled = 10500,
+    WrongApp = 10501,
+    /** 0x911c Command code not supported — app predates current SDK. */
+    AppTooOld = 10502,
+    /** Not enough free storage for install/update; user must uninstall apps first. */
+    DeviceOutOfMemory = 10503,
+    /** 0x6a80 Invalid data — observed on blindSignTransactionFallback when the
+     *  user has not enabled Blind signing on the device. */
+    EvmBlindSigningRequired = 11000,
+    /** 0x6984 Plugin not installed */
+    EvmClearSignPluginMissing = 11001,
+    /** 0x6a84 Insufficient memory (typical on Nano S with large calldata) */
+    EvmDataTooLarge = 11002,
+    /** 0x6501 TransactionType not supported (app too old for EIP-1559 / blob / 7702) */
+    EvmTxTypeNotSupported = 11003,
+    /** 0x6808 Blind signing disabled for this instruction. */
+    SolanaBlindSigningRequired = 11100,
+    /** 0x6a8d Custom Contracts setting disabled (blocks TRC-20 etc.). */
+    TronCustomContractRequired = 11200,
+    /** 0x6a8b Transactions Data setting disabled. */
+    TronDataSigningRequired = 11201,
+    /** 0x6a8c Sign by Hash setting disabled (hash-signing fallback). */
+    TronSignByHashRequired = 11202,
+    /** 0xb008 Wallet policy HMAC mismatch or not registered. */
+    BtcWalletPolicyHmacMismatch = 11300,
+    /** 0xb007 Aborted due to unexpected state (malformed PSBT / missing UTXO). */
+    BtcUnexpectedState = 11301
+}
+/**
+ * Device-level failures the SDK cannot self-recover from — affect the entire
+ * batch (vs per-chain failures like AppNotInstalled / WrongApp which soft-
+ * skip in onboarding). Combined with `accounts.length === 0`, signals
+ * genuine orphan. Also reused as the batch-abort whitelist for HWK.
+ * Single source of truth.
+ *
+ * UserRejected (device-side reject) is included: pressing reject is an
+ * explicit "I don't consent" — continuing the batch to ask again on the
+ * next chain is harassment, not helpful.
+ */
+declare const ORPHAN_ELIGIBLE_ERROR_CODES: number[];
+interface IHwkErrorPayload {
+    code: HardwareErrorCode;
+    message: string;
+    appName?: string;
+    _tag?: string;
+    params?: Record<string, unknown>;
+}
+type HwkError = Error & {
+    code: HardwareErrorCode;
+    appName?: string;
+    _tag?: string;
+    params?: Record<string, unknown>;
+};
+/**
+ * Canonical throwable for HWK adapters. Plain Error + canonical extra fields,
+ * shape-compatible with `rehydrateConnectorError` so locally-thrown and
+ * cross-boundary errors are indistinguishable to downstream classifiers
+ * (`err.code` / `err._tag` / `err.appName`). Do NOT mutate caught errors
+ * with `Object.assign` — construct a fresh one via this factory.
+ */
+declare function createHwkError(payload: IHwkErrorPayload): HwkError;
+
+/**
+ * Enrich a hardware error message with actionable recovery hints.
+ * Shared across adapters (Ledger, Trezor, etc.).
+ */
+declare function enrichErrorMessage(code: HardwareErrorCode, originalMessage: string): string;
+
+export { HardwareErrorCode, type HwkError, type IHwkErrorPayload, ORPHAN_ELIGIBLE_ERROR_CODES, createHwkError, enrichErrorMessage };

package/dist/errors.d.ts

@@ -0,0 +1,164 @@
+/**
+ * HWK HardwareErrorCode — independent namespace from the legacy
+ * `@onekeyfe/shared` HardwareErrorCode (which occupies 0-902).
+ *
+ * All HWK codes are 5-digit (>= 10000) so the two tables never collide
+ * even if either side grows. Each sub-category gets a 100-slot block.
+ *
+ *   10000-10099  Generic / cross-cutting primitives
+ *   10100-10199  Device state
+ *   10200-10299  Firmware
+ *   10300-10399  Transport + OS-level permission
+ *   10400-10499  PIN / Passphrase
+ *   10500-10599  App lifecycle (wrong app, not open, too old)
+ *   10600-10999  RESERVED — future adapter-level categories
+ *
+ *   11000-11099  EVM APDU (reactive mapping)
+ *   11100-11199  Solana APDU
+ *   11200-11299  Tron APDU
+ *   11300-11399  BTC APDU
+ *   11400-11999  RESERVED — future chain APDU blocks (100 per chain)
+ *
+ *   12000-99999  RESERVED — future major categories
+ */
+declare enum HardwareErrorCode {
+    UnknownError = 10000,
+    UserRejected = 10001,
+    InvalidParams = 10002,
+    OperationTimeout = 10003,
+    MethodNotSupported = 10004,
+    /** User dismissed in-app cancel UI. Distinct from UserRejected (on-device). */
+    UserAborted = 10005,
+    DeviceNotFound = 10100,
+    DeviceDisconnected = 10101,
+    DeviceBusy = 10102,
+    DeviceLocked = 10103,
+    DeviceNotInitialized = 10104,
+    DeviceInBootloader = 10105,
+    DeviceMismatch = 10106,
+    /** Chain app wedged (e.g. Ledger BTC 0x6901). User must exit app on device. */
+    DeviceAppStuck = 10107,
+    /** Vendor (Ledger / Trezor) doesn't support the chain at all. */
+    ChainNotSupported = 10108,
+    /** Current operation supports only one connected device. */
+    DeviceOneDeviceOnly = 10109,
+    FirmwareTooOld = 10200,
+    FirmwareUpdateRequired = 10201,
+    TransportError = 10300,
+    BridgeNotFound = 10301,
+    TransportNotAvailable = 10302,
+    /**
+     * OS-level permission (Bluetooth / USB / etc.) — denied, blocked,
+     * unavailable, or dismissed. Consumers surface a single "please grant
+     * permission" toast and let the user retry manually.
+     */
+    DevicePermissionDenied = 10303,
+    /**
+     * BLE SMP pairing did not complete within the GATT bonding window.
+     * GATT connected but the device didn't acknowledge SMP — typically
+     * because the user didn't confirm the passkey on the device, or the
+     * device went out of range mid-pairing. Distinct from OperationTimeout
+     * (generic) and from DeviceLocked (Secure Element actually locked).
+     */
+    BlePairingTimeout = 10304,
+    /** Remote network failure reaching a vendor's servers (HTTP/WS). Distinct from TransportError (local USB/BLE link). */
+    NetworkError = 10305,
+    /**
+     * Host-managed pairing handshake failed (Trezor THP). The device rejected the
+     * pairing exchange — e.g. CodeEntry: the user mistyped the code shown on the
+     * device, so the CPace tag didn't match ("Unexpected Code Entry Tag").
+     * Recoverable: the user re-pairs and re-enters the code. Distinct from
+     * BlePairingTimeout (BLE SMP bonding window) and UserRejected (on-device
+     * reject button).
+     */
+    ThpPairingFailed = 10306,
+    /**
+     * The OS-level BLE bond is stale/invalid, so the device rejected link
+     * encryption: Android GATT_INSUF_AUTHENTICATION (status 5) or iOS "Peer
+     * removed pairing information". Happens after the device is wiped/re-flashed
+     * or unpaired elsewhere while the host still holds an old bond. The SDK cannot
+     * remove an OS bond — the user must forget the device in system Bluetooth
+     * settings and re-pair. Distinct from BlePairingTimeout (SMP window) and
+     * ThpPairingFailed (THP code mismatch).
+     */
+    BleBondInvalid = 10307,
+    PinInvalid = 10400,
+    PinCancelled = 10401,
+    PassphraseRejected = 10402,
+    /**
+     * The passphrase entered produced a different wallet (`passphraseState`) than
+     * the one the caller asked to operate on. Trezor-only: the host pins a wallet
+     * by its derived state and the SDK refuses to sign with a mismatched
+     * passphrase session. Surfaced by TrezorAdapter.getPassphraseState.
+     */
+    PassphraseStateMismatch = 10403,
+    /** Chain app NOT INSTALLED on device. User must install via Ledger Live. */
+    AppNotInstalled = 10500,
+    WrongApp = 10501,
+    /** 0x911c Command code not supported — app predates current SDK. */
+    AppTooOld = 10502,
+    /** Not enough free storage for install/update; user must uninstall apps first. */
+    DeviceOutOfMemory = 10503,
+    /** 0x6a80 Invalid data — observed on blindSignTransactionFallback when the
+     *  user has not enabled Blind signing on the device. */
+    EvmBlindSigningRequired = 11000,
+    /** 0x6984 Plugin not installed */
+    EvmClearSignPluginMissing = 11001,
+    /** 0x6a84 Insufficient memory (typical on Nano S with large calldata) */
+    EvmDataTooLarge = 11002,
+    /** 0x6501 TransactionType not supported (app too old for EIP-1559 / blob / 7702) */
+    EvmTxTypeNotSupported = 11003,
+    /** 0x6808 Blind signing disabled for this instruction. */
+    SolanaBlindSigningRequired = 11100,
+    /** 0x6a8d Custom Contracts setting disabled (blocks TRC-20 etc.). */
+    TronCustomContractRequired = 11200,
+    /** 0x6a8b Transactions Data setting disabled. */
+    TronDataSigningRequired = 11201,
+    /** 0x6a8c Sign by Hash setting disabled (hash-signing fallback). */
+    TronSignByHashRequired = 11202,
+    /** 0xb008 Wallet policy HMAC mismatch or not registered. */
+    BtcWalletPolicyHmacMismatch = 11300,
+    /** 0xb007 Aborted due to unexpected state (malformed PSBT / missing UTXO). */
+    BtcUnexpectedState = 11301
+}
+/**
+ * Device-level failures the SDK cannot self-recover from — affect the entire
+ * batch (vs per-chain failures like AppNotInstalled / WrongApp which soft-
+ * skip in onboarding). Combined with `accounts.length === 0`, signals
+ * genuine orphan. Also reused as the batch-abort whitelist for HWK.
+ * Single source of truth.
+ *
+ * UserRejected (device-side reject) is included: pressing reject is an
+ * explicit "I don't consent" — continuing the batch to ask again on the
+ * next chain is harassment, not helpful.
+ */
+declare const ORPHAN_ELIGIBLE_ERROR_CODES: number[];
+interface IHwkErrorPayload {
+    code: HardwareErrorCode;
+    message: string;
+    appName?: string;
+    _tag?: string;
+    params?: Record<string, unknown>;
+}
+type HwkError = Error & {
+    code: HardwareErrorCode;
+    appName?: string;
+    _tag?: string;
+    params?: Record<string, unknown>;
+};
+/**
+ * Canonical throwable for HWK adapters. Plain Error + canonical extra fields,
+ * shape-compatible with `rehydrateConnectorError` so locally-thrown and
+ * cross-boundary errors are indistinguishable to downstream classifiers
+ * (`err.code` / `err._tag` / `err.appName`). Do NOT mutate caught errors
+ * with `Object.assign` — construct a fresh one via this factory.
+ */
+declare function createHwkError(payload: IHwkErrorPayload): HwkError;
+
+/**
+ * Enrich a hardware error message with actionable recovery hints.
+ * Shared across adapters (Ledger, Trezor, etc.).
+ */
+declare function enrichErrorMessage(code: HardwareErrorCode, originalMessage: string): string;
+
+export { HardwareErrorCode, type HwkError, type IHwkErrorPayload, ORPHAN_ELIGIBLE_ERROR_CODES, createHwkError, enrichErrorMessage };

package/dist/errors.js

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkQD4EQWQAjs = require('./chunk-QD4EQWQA.js');
+
+
+
+
+
+exports.HardwareErrorCode = _chunkQD4EQWQAjs.HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = _chunkQD4EQWQAjs.ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = _chunkQD4EQWQAjs.createHwkError; exports.enrichErrorMessage = _chunkQD4EQWQAjs.enrichErrorMessage;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/errors.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACA;AACA;AACA;AACF,+QAAC","file":"/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/errors.js"}

package/dist/errors.mjs

@@ -0,0 +1,13 @@
+import {
+  HardwareErrorCode,
+  ORPHAN_ELIGIBLE_ERROR_CODES,
+  createHwkError,
+  enrichErrorMessage
+} from "./chunk-D5OZT7RZ.mjs";
+export {
+  HardwareErrorCode,
+  ORPHAN_ELIGIBLE_ERROR_CODES,
+  createHwkError,
+  enrichErrorMessage
+};
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}