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

package/dist/chunk-T5HIQPNG.js.map

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

package/dist/chunk-YLCHSNXO.js

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

package/dist/chunk-YLCHSNXO.js.map

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

package/dist/errors-BgJ4kzRx.d.mts

@@ -0,0 +1,276 @@
+/**
+ * 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-10699  Payload / framing limits (adapter-level)
+ *   10700-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,
+    /**
+     * 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,
+    /** Busy with our own in-flight request (queue guard / firmware Failure_Busy), not another app — wait and retry, don't close other apps. */
+    DeviceBusyInternal = 10111,
+    /** The supplied runtime-only operation id is unknown to this adapter instance. */
+    OperationNotFound = 10112,
+    /** The supplied operation ended and can never be resumed. */
+    OperationEnded = 10113,
+    /**
+     * Discovery found devices but none is the expected wallet (wrong unit connected). DeviceMismatch
+     * is for reaching the expected device and finding a different identity on it.
+     */
+    DeviceSearchMismatch = 10114,
+    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,
+    /**
+     * 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,
+    /**
+     * The user cancelled BLE pairing from the app while the connect was still
+     * waiting on the OS pairing window. Not a failure to report — the flow ends
+     * because they asked it to. Distinct from UserAborted (generic in-app cancel)
+     * so the pairing UI can close quietly instead of surfacing a connect error,
+     * and from BlePairingTimeout (the SMP window elapsed on its own).
+     */
+    BlePairingCancelled = 10310,
+    /**
+     * Ledger manager-api WebSocket (app install/uninstall, genuine check) broke while relaying APDUs.
+     * The device link is fine, so retry; NetworkError never carried device traffic.
+     */
+    LedgerSecureChannelError = 10311,
+    /**
+     * Vendor metadata service returned an unusable payload (Ledger firmware metadata, app catalog).
+     * The request succeeded, so callers must not treat it as a dropped link.
+     */
+    LedgerFirmwareMetadataError = 10312,
+    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,
+    /**
+     * The two new-PIN entries did not match during set/change PIN. Only host-input
+     * models (Trezor Model One matrix) surface this; on-device-input models show
+     * the mismatch on the device and never return it.
+     */
+    PinMismatch = 10404,
+    /** Standard wallet is unavailable while Trezor enforces on-device passphrase entry. */
+    PassphraseAlwaysOnDevice = 10405,
+    /** 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,
+    /** Install refused, the app is already on the device; benign when the caller only needs it. */
+    AppAlreadyInstalled = 10504,
+    /**
+     * Payload exceeds a transport's framing cap (Keystone USB: ~12.5KB, 200 frames of 64 bytes).
+     * Retrying on the same transport fails the same way; switch channel or shrink the payload.
+     */
+    PayloadTooLarge = 10600,
+    /** 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[];
+/**
+ * Where a failure came from; code ranges can't tell (UserRejected=10001 is the device,
+ * DevicePermissionDenied=10303 is the host).
+ * `device`: the firmware answered (rejection, locked, wrong PIN); surface verbatim, never
+ * auto-reconnect, switch channels, or drop a healthy session.
+ * `transport`: the pipe failed (cable pulled, bus reset); reconnecting is fair game.
+ * `host`: the environment refused (permission, picker, bad params); fix it, not the link.
+ * A mapper that can't tell leaves it unset so consumers fall back to code-based tables.
+ */
+type HwkErrorOrigin = 'device' | 'transport' | 'host';
+/**
+ * Smallest resource to replace before retrying; never permission to auto-replay a signing command.
+ * `call`: nothing. `operation`: rebind from the target if its identity is persistent.
+ * `search-target`: rediscover and reselect. `transport`: repair or switch transport.
+ * `not-recoverable`: retrying cannot succeed. `unknown`: no safe claim.
+ */
+type HwkRecoveryScope = 'call' | 'operation' | 'search-target' | 'transport' | 'not-recoverable' | 'unknown';
+interface HwkRecoveryHint {
+    scope: HwkRecoveryScope;
+}
+declare function isHwkRecoveryHint(value: unknown): value is HwkRecoveryHint;
+/** Vendor-neutral fallback; adapters may stamp a narrower hint when session state is clear. */
+declare function defaultRecoveryForCode(code: HardwareErrorCode): HwkRecoveryHint;
+/**
+ * Default code-to-origin table; vendors override only where their mapping knows better.
+ * Context-dependent codes (UnknownError, OperationTimeout, DeviceBusy) return undefined.
+ */
+declare function defaultOriginForCode(code: HardwareErrorCode): HwkErrorOrigin | undefined;
+interface IHwkErrorPayload {
+    code: HardwareErrorCode;
+    message: string;
+    origin?: HwkErrorOrigin;
+    recovery?: HwkRecoveryHint;
+    appName?: string;
+    _tag?: string;
+    params?: Record<string, unknown>;
+}
+interface IOperationMayHaveCompletedParams extends Record<string, unknown> {
+    operationMayHaveCompleted: true;
+    method: string;
+}
+/**
+ * Marks an unsafe request whose response was lost after dispatch; the transport error is not proof
+ * that the device rejected or skipped it.
+ */
+declare function operationMayHaveCompletedParams(method: string, params?: Record<string, unknown>): IOperationMayHaveCompletedParams;
+type HwkError = Error & {
+    code: HardwareErrorCode;
+    /** See {@link HwkErrorOrigin}. Survives serializeConnectorError/rehydrate via `params`. */
+    origin?: HwkErrorOrigin;
+    recovery?: HwkRecoveryHint;
+    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 as H, type IHwkErrorPayload as I, ORPHAN_ELIGIBLE_ERROR_CODES as O, type HwkErrorOrigin as a, type HwkRecoveryHint as b, type HwkError as c, type HwkRecoveryScope as d, type IOperationMayHaveCompletedParams as e, createHwkError as f, defaultOriginForCode as g, defaultRecoveryForCode as h, enrichErrorMessage as i, isHwkRecoveryHint as j, operationMayHaveCompletedParams as o };