@onekeyfe/hd-shared 1.2.8 → 1.2.10-alpha.1

package/dist/HardwareError.d.ts

@@ -63,6 +63,8 @@ export declare const HardwareErrorCode: {
     readonly TransportCallInProgress: 601;
     readonly TransportNotFound: 602;
     readonly TransportInvalidProtobuf: 603;
+    readonly TransportProtocolProbeFailed: 604;
+    readonly TransportProtocolMismatch: 605;
     readonly BleScanError: 700;
     readonly BlePermissionError: 701;
     readonly BleLocationError: 702;
@@ -123,11 +125,10 @@ export declare const HardwareErrorCode: {
     readonly LowlevelTrasnportConnectError: 900;
     readonly WebDeviceNotFoundOrNeedsPermission: 901;
     readonly WebDevicePromptAccessError: 902;
+    readonly WebUsbDeviceAccessError: 903;
 };
 export declare const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping;
 export declare const TypedError: (hardwareError: ErrorCodeUnion | string, message?: string, params?: any) => HardwareError;
-export declare const isBleStaleBondHardwareError: (error: unknown) => boolean;
-export declare const isBleStaleBondErrorText: (text: string) => boolean;
 export declare const serializeError: (payload: any) => any;
 export declare const CreateErrorByMessage: (message: string) => HardwareError;
 export declare const CreateHardwareErrorByBridgeError: (raw: string) => HardwareError;

package/dist/HardwareError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HardwareError.d.ts","sourceRoot":"","sources":["../src/HardwareError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5C,KAAK,+BAA+B,GAAG;KAAG,CAAC,IAAI,OAAO,CAAC,OAAO,iBAAiB,CAAC,GAAG,MAAM;CAAE,CAAC;AAE5F,KAAK,cAAc,GAAG,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAsCxD,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAS,EAAE,cAAc,CAAkC;IAE3D,OAAO,SAAM;IAEb,MAAM,EAAE,GAAG,CAAM;gBAEL,aAAa,EAAE,cAAc,GAAG,MAAM;CAmBnD;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8bpB,CAAC;AAEX,eAAO,MAAM,wBAAwB,EAAE,+BAyJ7B,CAAC;AAEX,eAAO,MAAM,UAAU,kBACN,cAAc,GAAG,MAAM,YAC5B,MAAM,WACP,GAAG,kBAMb,CAAC;AAEF,eAAO,MAAM,2BAA2B,UAAW,OAAO,KAAG,OAO5D,CAAC;AAEF,eAAO,MAAM,uBAAuB,SAAU,MAAM,KAAG,OAStD,CAAC;AAEF,eAAO,MAAM,cAAc,YAAa,GAAG,QAe1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,aAOtD,CAAC;AAGF,eAAO,MAAM,gCAAgC,QAAS,MAAM,KAAG,aAQ9D,CAAC;AAEF,QAAA,MAAM,uCAAuC;oBAM3B,MAAM;oBACN,MAAM;;;mBAcvB,CAAC;AAEF,QAAA,MAAM,sCAAsC;oBAM1B,MAAM;oBACN,MAAM;;;mBAcvB,CAAC;AAEF,QAAA,MAAM,yCAAyC,cAClC,MAAM,GAAG,SAAS,YACnB,MAAM,GAAG,SAAS,iBACb,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,oBACnB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,kBAsBF,CAAC;AAEF,QAAA,MAAM,6BAA6B,mBACjB,MAAM,qBACH,MAAM,eACZ,MAAM,kBAQpB,CAAC;AAEF,QAAA,MAAM,4BAA4B,aACtB,MAAM,aACL,MAAM,cACL,MAAM,cACN,MAAM,aACP,MAAM,kBAWlB,CAAC;AAEF,QAAA,MAAM,iCAAiC,eAAgB,MAAM,gBAAgB,aAAa,kBAItF,CAAC;AAEL,OAAO,EACL,uCAAuC,EACvC,sCAAsC,EACtC,yCAAyC,EACzC,6BAA6B,EAC7B,4BAA4B,EAC5B,iCAAiC,GAClC,CAAC"}
+{"version":3,"file":"HardwareError.d.ts","sourceRoot":"","sources":["../src/HardwareError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5C,KAAK,+BAA+B,GAAG;KAAG,CAAC,IAAI,OAAO,CAAC,OAAO,iBAAiB,CAAC,GAAG,MAAM;CAAE,CAAC;AAE5F,KAAK,cAAc,GAAG,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAsCxD,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAS,EAAE,cAAc,CAAkC;IAE3D,OAAO,SAAM;IAEb,MAAM,EAAE,GAAG,CAAM;gBAEL,aAAa,EAAE,cAAc,GAAG,MAAM;CAmBnD;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgdpB,CAAC;AAEX,eAAO,MAAM,wBAAwB,EAAE,+BA8J7B,CAAC;AAEX,eAAO,MAAM,UAAU,kBACN,cAAc,GAAG,MAAM,YAC5B,MAAM,WACP,GAAG,kBAMb,CAAC;AAEF,eAAO,MAAM,cAAc,YAAa,GAAG,QAe1C,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,aAOtD,CAAC;AAGF,eAAO,MAAM,gCAAgC,QAAS,MAAM,KAAG,aAQ9D,CAAC;AAEF,QAAA,MAAM,uCAAuC;oBAM3B,MAAM;oBACN,MAAM;;;mBAcvB,CAAC;AAEF,QAAA,MAAM,sCAAsC;oBAM1B,MAAM;oBACN,MAAM;;;mBAcvB,CAAC;AAEF,QAAA,MAAM,yCAAyC,cAClC,MAAM,GAAG,SAAS,YACnB,MAAM,GAAG,SAAS,iBACb,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,oBACnB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,kBAsBF,CAAC;AAEF,QAAA,MAAM,6BAA6B,mBACjB,MAAM,qBACH,MAAM,eACZ,MAAM,kBAQpB,CAAC;AAEF,QAAA,MAAM,4BAA4B,aACtB,MAAM,aACL,MAAM,cACL,MAAM,cACN,MAAM,aACP,MAAM,kBAWlB,CAAC;AAEF,QAAA,MAAM,iCAAiC,eAAgB,MAAM,gBAAgB,aAAa,kBAItF,CAAC;AAEL,OAAO,EACL,uCAAuC,EACvC,sCAAsC,EACtC,yCAAyC,EACzC,6BAA6B,EAC7B,4BAA4B,EAC5B,iCAAiC,GAClC,CAAC"}

package/dist/constants.d.ts

@@ -18,8 +18,8 @@ type WebUsbIdentityDescriptor = {
     manufacturerName?: string | null;
 };
 export declare const isKnownTrezorWebUsbDevice: (descriptor: WebUsbIdentityDescriptor) => boolean;
-export declare const ERROR_CODES_REQUIRE_RELEASE: readonly [106, 107, 109, 112, 805, 801, 802, 812];
-export declare const ERROR_CODES_REQUIRE_DISCONNECT: readonly [106, 805];
+export declare const ERROR_CODES_REQUIRE_RELEASE: readonly [903, 604, 605, 106, 107, 109, 112, 805, 801, 802, 812];
+export declare const ERROR_CODES_REQUIRE_DISCONNECT: readonly [903, 604, 605, 106, 805];
 export declare enum EOneKeyBleMessageKeys {
     BLE_SELECT = "$onekey-ble-select",
     BLE_SELECT_RESULT = "$onekey-ble-select-result",
@@ -78,6 +78,7 @@ export declare const canonicalizePro2BleAdvertisementName: (value: string) => st
 export declare const isSameOnekeyBleName: (left?: string | null, right?: string | null) => boolean;
 export declare const hasOnekeyCommunicationService: (serviceUuids: Array<string | null | undefined> | null | undefined) => boolean;
 export declare const isPro2FamilyBleName: (value?: string | null) => boolean;
+export declare const parseOnekeyBleColorCode: (manufacturerData: Uint8Array | null | undefined) => string | undefined;
 export declare const isOnekeyBluetoothDevice: ({ id, name, localName, serviceUuids, }: BluetoothDeviceIdentity) => boolean;
 export {};
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -22,12 +22,12 @@ declare const isKnownTrezorWebUsbDevice: (descriptor: WebUsbIdentityDescriptor)
  * Error codes that require device release after occurrence
  * These errors indicate the device is in an invalid state and needs to be released
  */
-declare const ERROR_CODES_REQUIRE_RELEASE: readonly [106, 107, 109, 112, 805, 801, 802, 812];
+declare const ERROR_CODES_REQUIRE_RELEASE: readonly [903, 604, 605, 106, 107, 109, 112, 805, 801, 802, 812];
 /**
  * Error codes that require device disconnect before release
  * These errors indicate a communication failure that requires full reconnection
  */
-declare const ERROR_CODES_REQUIRE_DISCONNECT: readonly [106, 805];
+declare const ERROR_CODES_REQUIRE_DISCONNECT: readonly [903, 604, 605, 106, 805];
 declare enum EOneKeyBleMessageKeys {
     BLE_SELECT = "$onekey-ble-select",
     BLE_SELECT_RESULT = "$onekey-ble-select-result",
@@ -109,6 +109,11 @@ declare const hasOnekeyCommunicationService: (serviceUuids: Array<string | null
  * that carry no OneKey service UUID, so a scan cannot always see it.
  */
 declare const isPro2FamilyBleName: (value?: string | null) => boolean;
+/**
+ * Reads the serial-number color letter from the raw 0xFF advertisement payload
+ * (the bytes after the AD type). Returns undefined when no valid letter is present.
+ */
+declare const parseOnekeyBleColorCode: (manufacturerData: Uint8Array | null | undefined) => string | undefined;
 declare const isOnekeyBluetoothDevice: ({ id, name, localName, serviceUuids, }: BluetoothDeviceIdentity) => boolean;
 
 type Deferred<T, I = any, D = any> = {
@@ -334,6 +339,16 @@ declare const HardwareErrorCode: {
      * Transport invalid protobuf
      */
     readonly TransportInvalidProtobuf: 603;
+    /**
+     * No supported device protocol answered the active probe.
+     * @params: { expectedProtocol?: 'V1' | 'V2'; attempts?: number }
+     */
+    readonly TransportProtocolProbeFailed: 604;
+    /**
+     * The actively detected device protocol differs from the required protocol.
+     * @params: { expectedProtocol: 'V1' | 'V2'; detectedProtocol?: 'V1' | 'V2' }
+     */
+    readonly TransportProtocolMismatch: 605;
     /**
      * Bluetooth error code
      */
@@ -449,7 +464,7 @@ declare const HardwareErrorCode: {
      */
     readonly FirmwareVerificationFailed: 820;
     /**
-     * Web bridge coonect needs permission
+     * USB access needs OS permission (bridge/libusb or WebUSB).
      */
     readonly BridgeNeedsPermission: 821;
     readonly CallQueueActionCancelled: 822;
@@ -505,11 +520,14 @@ declare const HardwareErrorCode: {
      * Web USB or Web Bluetooth device prompt access error
      */
     readonly WebDevicePromptAccessError: 902;
+    /**
+     * WebUSB device is present, but its interface or endpoint is unavailable
+     * @params: { operation: 'open' | 'claimInterface' | 'transferIn' | 'transferOut'; nativeErrorName?: string; nativeErrorMessage?: string }
+     */
+    readonly WebUsbDeviceAccessError: 903;
 };
 declare const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping;
 declare const TypedError: (hardwareError: ErrorCodeUnion | string, message?: string, params?: any) => HardwareError;
-declare const isBleStaleBondHardwareError: (error: unknown) => boolean;
-declare const isBleStaleBondErrorText: (text: string) => boolean;
 declare const serializeError: (payload: any) => any;
 declare const CreateErrorByMessage: (message: string) => HardwareError;
 declare const CreateHardwareErrorByBridgeError: (raw: string) => HardwareError;
@@ -545,8 +563,6 @@ declare const HardwareError$1_HardwareError: typeof HardwareError;
 declare const HardwareError$1_HardwareErrorCode: typeof HardwareErrorCode;
 declare const HardwareError$1_HardwareErrorCodeMessage: typeof HardwareErrorCodeMessage;
 declare const HardwareError$1_TypedError: typeof TypedError;
-declare const HardwareError$1_isBleStaleBondHardwareError: typeof isBleStaleBondHardwareError;
-declare const HardwareError$1_isBleStaleBondErrorText: typeof isBleStaleBondErrorText;
 declare const HardwareError$1_serializeError: typeof serializeError;
 declare const HardwareError$1_CreateErrorByMessage: typeof CreateErrorByMessage;
 declare const HardwareError$1_CreateHardwareErrorByBridgeError: typeof CreateHardwareErrorByBridgeError;
@@ -563,8 +579,6 @@ declare namespace HardwareError$1 {
     HardwareError$1_HardwareErrorCode as HardwareErrorCode,
     HardwareError$1_HardwareErrorCodeMessage as HardwareErrorCodeMessage,
     HardwareError$1_TypedError as TypedError,
-    HardwareError$1_isBleStaleBondHardwareError as isBleStaleBondHardwareError,
-    HardwareError$1_isBleStaleBondErrorText as isBleStaleBondErrorText,
     HardwareError$1_serializeError as serializeError,
     HardwareError$1_CreateErrorByMessage as CreateErrorByMessage,
     HardwareError$1_CreateHardwareErrorByBridgeError as CreateHardwareErrorByBridgeError,
@@ -585,4 +599,4 @@ declare enum EDeviceType {
     Neo = "neo"
 }
 
-export { CreateErrorByMessage, CreateHardwareErrorByBridgeError, Deferred, EBleDisconnectReason, EDeviceType, EFirmwareType, EOneKeyBleMessageKeys, HardwareError$1 as ERRORS, ERROR_CODES_REQUIRE_DISCONNECT, ERROR_CODES_REQUIRE_RELEASE, HARDWARE_CONNECT_PROTOCOL, HardwareConnectProtocol, HardwareError, HardwareErrorCode, HardwareErrorCodeMessage, IHardwareError, ONEKEY_NOTIFY_CHARACTERISTIC_UUID, ONEKEY_PROTOCOL_V2_USB_IDS, ONEKEY_SERVICE_UUID, ONEKEY_WEBUSB_FILTER, ONEKEY_WRITE_CHARACTERISTIC_UUID, TypedError, canonicalizePro2BleAdvertisementName, createDefectiveFirmwareError, createDeferred, createDeprecatedHardwareError, createDeviceNotSupportMethodError, createKnownBleUuidAliases, createNeedUpgradeFirmwareHardwareError, createNewFirmwareForceUpdateHardwareError, createNewFirmwareUnReleaseHardwareError, hasOnekeyCommunicationService, inferProtocolHintFromUsbId, isBleStaleBondErrorText, isBleStaleBondHardwareError, isHeaderChunk, isKnownTrezorWebUsbDevice, isOnekeyBluetoothDevice, isOnekeyDevice, isPro2FamilyBleName, isPro2FindMyAdvertisementName, isSameOnekeyBleName, matchesKnownBleUuid, normalizeBleUuid, normalizePro2FindMyAdvertisementName, resolveOneKeyUsbDevicePath, serializeError, wait };
+export { CreateErrorByMessage, CreateHardwareErrorByBridgeError, Deferred, EBleDisconnectReason, EDeviceType, EFirmwareType, EOneKeyBleMessageKeys, HardwareError$1 as ERRORS, ERROR_CODES_REQUIRE_DISCONNECT, ERROR_CODES_REQUIRE_RELEASE, HARDWARE_CONNECT_PROTOCOL, HardwareConnectProtocol, HardwareError, HardwareErrorCode, HardwareErrorCodeMessage, IHardwareError, ONEKEY_NOTIFY_CHARACTERISTIC_UUID, ONEKEY_PROTOCOL_V2_USB_IDS, ONEKEY_SERVICE_UUID, ONEKEY_WEBUSB_FILTER, ONEKEY_WRITE_CHARACTERISTIC_UUID, TypedError, canonicalizePro2BleAdvertisementName, createDefectiveFirmwareError, createDeferred, createDeprecatedHardwareError, createDeviceNotSupportMethodError, createKnownBleUuidAliases, createNeedUpgradeFirmwareHardwareError, createNewFirmwareForceUpdateHardwareError, createNewFirmwareUnReleaseHardwareError, hasOnekeyCommunicationService, inferProtocolHintFromUsbId, isHeaderChunk, isKnownTrezorWebUsbDevice, isOnekeyBluetoothDevice, isOnekeyDevice, isPro2FamilyBleName, isPro2FindMyAdvertisementName, isSameOnekeyBleName, matchesKnownBleUuid, normalizeBleUuid, normalizePro2FindMyAdvertisementName, parseOnekeyBleColorCode, resolveOneKeyUsbDevicePath, serializeError, wait };

package/dist/index.js

@@ -112,6 +112,8 @@ const HardwareErrorCode = {
     TransportCallInProgress: 601,
     TransportNotFound: 602,
     TransportInvalidProtobuf: 603,
+    TransportProtocolProbeFailed: 604,
+    TransportProtocolMismatch: 605,
     BleScanError: 700,
     BlePermissionError: 701,
     BleLocationError: 702,
@@ -172,6 +174,7 @@ const HardwareErrorCode = {
     LowlevelTrasnportConnectError: 900,
     WebDeviceNotFoundOrNeedsPermission: 901,
     WebDevicePromptAccessError: 902,
+    WebUsbDeviceAccessError: 903,
 };
 const HardwareErrorCodeMessage = {
     [HardwareErrorCode.UnknownError]: 'Unknown error occurred. Check message property.',
@@ -221,9 +224,11 @@ const HardwareErrorCodeMessage = {
     [HardwareErrorCode.TransportCallInProgress]: 'Transport call in progress',
     [HardwareErrorCode.TransportNotFound]: 'Transport not found',
     [HardwareErrorCode.TransportInvalidProtobuf]: 'Transport invalid protobuf',
+    [HardwareErrorCode.TransportProtocolProbeFailed]: 'Failed to detect the device communication protocol. Reconnect the device and try again.',
+    [HardwareErrorCode.TransportProtocolMismatch]: 'The device communication protocol does not match the expected protocol.',
     [HardwareErrorCode.BleScanError]: 'BLE scan error',
     [HardwareErrorCode.BlePermissionError]: 'Bluetooth required to be turned on',
-    [HardwareErrorCode.BleLocationError]: 'Location permissions for the application are not available',
+    [HardwareErrorCode.BleLocationError]: 'Bluetooth or location permissions for the application are not available',
     [HardwareErrorCode.BleRequiredUUID]: 'uuid is required',
     [HardwareErrorCode.BleConnectedError]: 'connected error is always runtime error',
     [HardwareErrorCode.BleDeviceNotBonded]: 'device is not bonded',
@@ -281,6 +286,7 @@ const HardwareErrorCodeMessage = {
     [HardwareErrorCode.LowlevelTrasnportConnectError]: 'Lowlevel transport connect error',
     [HardwareErrorCode.WebDeviceNotFoundOrNeedsPermission]: 'Web-USB or Web-Bluetooth device not found or needs permission',
     [HardwareErrorCode.WebDevicePromptAccessError]: 'Web-USB or Web-Bluetooth device prompt access error',
+    [HardwareErrorCode.WebUsbDeviceAccessError]: 'WebUSB device access failed',
 };
 const TypedError = (hardwareError, message, params) => {
     if (typeof hardwareError === 'string') {
@@ -288,20 +294,6 @@ const TypedError = (hardwareError, message, params) => {
     }
     return new HardwareError({ errorCode: hardwareError, message: message !== null && message !== void 0 ? message : '', params });
 };
-const isBleStaleBondHardwareError = (error) => {
-    const code = error === null || error === void 0 ? void 0 : error.errorCode;
-    return (code === HardwareErrorCode.BleDeviceBondError ||
-        code === HardwareErrorCode.BlePeerRemovedPairingInformation ||
-        code === HardwareErrorCode.BleBondInvalid);
-};
-const isBleStaleBondErrorText = (text) => {
-    const value = text.toLowerCase();
-    return (value.includes('encryption is insufficient') ||
-        value.includes('insufficient encryption') ||
-        value.includes('peer removed pairing information') ||
-        value.includes('cberrordomain:14') ||
-        value.includes('gatt_insuf_authentication'));
-};
 const serializeError = (payload) => {
     if (payload && payload.error instanceof HardwareError) {
         return {
@@ -393,8 +385,6 @@ var HardwareError$1 = /*#__PURE__*/Object.freeze({
     HardwareErrorCode: HardwareErrorCode,
     HardwareErrorCodeMessage: HardwareErrorCodeMessage,
     TypedError: TypedError,
-    isBleStaleBondHardwareError: isBleStaleBondHardwareError,
-    isBleStaleBondErrorText: isBleStaleBondErrorText,
     serializeError: serializeError,
     CreateErrorByMessage: CreateErrorByMessage,
     CreateHardwareErrorByBridgeError: CreateHardwareErrorByBridgeError,
@@ -428,6 +418,9 @@ const isKnownTrezorWebUsbDevice = (descriptor) => {
     return manufacturerName != null && TREZOR_WEBUSB_MANUFACTURER_NAMES.has(manufacturerName);
 };
 const ERROR_CODES_REQUIRE_RELEASE = [
+    HardwareErrorCode.WebUsbDeviceAccessError,
+    HardwareErrorCode.TransportProtocolProbeFailed,
+    HardwareErrorCode.TransportProtocolMismatch,
     HardwareErrorCode.DeviceInitializeFailed,
     HardwareErrorCode.DeviceInterruptedFromOutside,
     HardwareErrorCode.DeviceInterruptedFromUser,
@@ -438,6 +431,9 @@ const ERROR_CODES_REQUIRE_RELEASE = [
     HardwareErrorCode.UnexpectPassphrase,
 ];
 const ERROR_CODES_REQUIRE_DISCONNECT = [
+    HardwareErrorCode.WebUsbDeviceAccessError,
+    HardwareErrorCode.TransportProtocolProbeFailed,
+    HardwareErrorCode.TransportProtocolMismatch,
     HardwareErrorCode.DeviceInitializeFailed,
     HardwareErrorCode.ResponseUnexpectTypeError,
 ];
@@ -656,6 +652,13 @@ const isPro2FamilyBleName = (value) => {
         NEO_COMPACT_NAME_PATTERN.test(compact) ||
         isPro2FindMyAdvertisementName(value));
 };
+const ONEKEY_BLE_COLOR_PAYLOAD_LENGTH = 5;
+const parseOnekeyBleColorCode = (manufacturerData) => {
+    if ((manufacturerData === null || manufacturerData === void 0 ? void 0 : manufacturerData.length) !== ONEKEY_BLE_COLOR_PAYLOAD_LENGTH)
+        return undefined;
+    const code = manufacturerData[0];
+    return code >= 0x41 && code <= 0x5a ? String.fromCharCode(code) : undefined;
+};
 const isOnekeyBluetoothDevice = ({ id, name, localName, serviceUuids, }) => {
     const advertisedServiceUuids = serviceUuids !== null && serviceUuids !== void 0 ? serviceUuids : [];
     if (hasOnekeyCommunicationService(advertisedServiceUuids)) {
@@ -770,8 +773,6 @@ exports.createNewFirmwareForceUpdateHardwareError = createNewFirmwareForceUpdate
 exports.createNewFirmwareUnReleaseHardwareError = createNewFirmwareUnReleaseHardwareError;
 exports.hasOnekeyCommunicationService = hasOnekeyCommunicationService;
 exports.inferProtocolHintFromUsbId = inferProtocolHintFromUsbId;
-exports.isBleStaleBondErrorText = isBleStaleBondErrorText;
-exports.isBleStaleBondHardwareError = isBleStaleBondHardwareError;
 exports.isHeaderChunk = isHeaderChunk;
 exports.isKnownTrezorWebUsbDevice = isKnownTrezorWebUsbDevice;
 exports.isOnekeyBluetoothDevice = isOnekeyBluetoothDevice;
@@ -782,6 +783,7 @@ exports.isSameOnekeyBleName = isSameOnekeyBleName;
 exports.matchesKnownBleUuid = matchesKnownBleUuid;
 exports.normalizeBleUuid = normalizeBleUuid;
 exports.normalizePro2FindMyAdvertisementName = normalizePro2FindMyAdvertisementName;
+exports.parseOnekeyBleColorCode = parseOnekeyBleColorCode;
 exports.resolveOneKeyUsbDevicePath = resolveOneKeyUsbDevicePath;
 exports.serializeError = serializeError;
 exports.wait = wait;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-shared",
-  "version": "1.2.8",
+  "version": "1.2.10-alpha.1",
   "description": "Hardware SDK's shared tool library",
   "keywords": [
     "Hardware-SDK",
@@ -26,5 +26,5 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix"
   },
-  "gitHead": "9f016278a7f395bf66b8502815dc63191e162fd3"
+  "gitHead": "df785eba29f144fac2cfdcbd808426e0a2c259b2"
 }

package/src/HardwareError.test.ts

@@ -2,11 +2,25 @@ import {
   HardwareErrorCode,
   HardwareErrorCodeMessage,
   TypedError,
-  isBleStaleBondErrorText,
   serializeError,
 } from './HardwareError';
+import { ERROR_CODES_REQUIRE_DISCONNECT, ERROR_CODES_REQUIRE_RELEASE } from './constants';
 
 describe('HardwareErrorCode compatibility', () => {
+  test.each([
+    ['TransportProtocolProbeFailed', 604, { expectedProtocol: 'V1' }],
+    ['TransportProtocolMismatch', 605, { expectedProtocol: 'V2', detectedProtocol: 'V1' }],
+  ] as const)('serializes the dedicated %s transport error', (name, code, params) => {
+    expect(HardwareErrorCode[name]).toBe(code);
+    const message = HardwareErrorCodeMessage[HardwareErrorCode[name]];
+    expect(message).toBeTruthy();
+    expect(ERROR_CODES_REQUIRE_RELEASE).toContain(code);
+    expect(ERROR_CODES_REQUIRE_DISCONNECT).toContain(code);
+    expect(
+      JSON.parse(JSON.stringify(serializeError({ error: TypedError(code, undefined, params) })))
+    ).toEqual({ code, error: message, params });
+  });
+
   test('preserves published Protocol V2 values while leaving code 829 unused', () => {
     expect(HardwareErrorCode).not.toHaveProperty('KaspaPrevTxIdMismatch');
     expect(HardwareErrorCode.DeviceLocked).toBe(830);
@@ -50,14 +64,4 @@ describe('HardwareErrorCode compatibility', () => {
       'pairing information is no longer valid'
     );
   });
-
-  test('recognizes the macOS CoreBluetooth stale-pairing error without matching generic failures', () => {
-    expect(
-      isBleStaleBondErrorText(
-        'CBErrorDomain:14 Peer removed pairing information on the device side'
-      )
-    ).toBe(true);
-    expect(isBleStaleBondErrorText('CBATTErrorDomain:14 localized native message')).toBe(false);
-    expect(isBleStaleBondErrorText('connection failed')).toBe(false);
-  });
 });

package/src/HardwareError.ts

@@ -319,6 +319,18 @@ export const HardwareErrorCode = {
    */
   TransportInvalidProtobuf: 603,
 
+  /**
+   * No supported device protocol answered the active probe.
+   * @params: { expectedProtocol?: 'V1' | 'V2'; attempts?: number }
+   */
+  TransportProtocolProbeFailed: 604,
+
+  /**
+   * The actively detected device protocol differs from the required protocol.
+   * @params: { expectedProtocol: 'V1' | 'V2'; detectedProtocol?: 'V1' | 'V2' }
+   */
+  TransportProtocolMismatch: 605,
+
   /**
    * Bluetooth error code
    */
@@ -456,7 +468,7 @@ export const HardwareErrorCode = {
   FirmwareVerificationFailed: 820,
 
   /**
-   * Web bridge coonect needs permission
+   * USB access needs OS permission (bridge/libusb or WebUSB).
    */
   BridgeNeedsPermission: 821,
 
@@ -522,6 +534,12 @@ export const HardwareErrorCode = {
    * Web USB or Web Bluetooth device prompt access error
    */
   WebDevicePromptAccessError: 902,
+
+  /**
+   * WebUSB device is present, but its interface or endpoint is unavailable
+   * @params: { operation: 'open' | 'claimInterface' | 'transferIn' | 'transferOut'; nativeErrorName?: string; nativeErrorMessage?: string }
+   */
+  WebUsbDeviceAccessError: 903,
 } as const;
 
 export const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping = {
@@ -599,6 +617,10 @@ export const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping = {
   [HardwareErrorCode.TransportCallInProgress]: 'Transport call in progress',
   [HardwareErrorCode.TransportNotFound]: 'Transport not found',
   [HardwareErrorCode.TransportInvalidProtobuf]: 'Transport invalid protobuf',
+  [HardwareErrorCode.TransportProtocolProbeFailed]:
+    'Failed to detect the device communication protocol. Reconnect the device and try again.',
+  [HardwareErrorCode.TransportProtocolMismatch]:
+    'The device communication protocol does not match the expected protocol.',
 
   /**
    * Bluetooth Error
@@ -606,7 +628,7 @@ export const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping = {
   [HardwareErrorCode.BleScanError]: 'BLE scan error',
   [HardwareErrorCode.BlePermissionError]: 'Bluetooth required to be turned on',
   [HardwareErrorCode.BleLocationError]:
-    'Location permissions for the application are not available',
+    'Bluetooth or location permissions for the application are not available',
   [HardwareErrorCode.BleRequiredUUID]: 'uuid is required',
   [HardwareErrorCode.BleConnectedError]: 'connected error is always runtime error',
   [HardwareErrorCode.BleDeviceNotBonded]: 'device is not bonded',
@@ -677,6 +699,7 @@ export const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping = {
     'Web-USB or Web-Bluetooth device not found or needs permission',
   [HardwareErrorCode.WebDevicePromptAccessError]:
     'Web-USB or Web-Bluetooth device prompt access error',
+  [HardwareErrorCode.WebUsbDeviceAccessError]: 'WebUSB device access failed',
 } as const;
 
 export const TypedError = (
@@ -690,26 +713,6 @@ export const TypedError = (
   return new HardwareError({ errorCode: hardwareError, message: message ?? '', params });
 };
 
-export const isBleStaleBondHardwareError = (error: unknown): boolean => {
-  const code = (error as { errorCode?: unknown })?.errorCode;
-  return (
-    code === HardwareErrorCode.BleDeviceBondError ||
-    code === HardwareErrorCode.BlePeerRemovedPairingInformation ||
-    code === HardwareErrorCode.BleBondInvalid
-  );
-};
-
-export const isBleStaleBondErrorText = (text: string): boolean => {
-  const value = text.toLowerCase();
-  return (
-    value.includes('encryption is insufficient') ||
-    value.includes('insufficient encryption') ||
-    value.includes('peer removed pairing information') ||
-    value.includes('cberrordomain:14') ||
-    value.includes('gatt_insuf_authentication')
-  );
-};
-
 export const serializeError = (payload: any) => {
   if (payload && payload.error instanceof HardwareError) {
     return {

package/src/constants.test.ts

@@ -10,6 +10,7 @@ import {
   isSameOnekeyBleName,
   matchesKnownBleUuid,
   normalizePro2FindMyAdvertisementName,
+  parseOnekeyBleColorCode,
   resolveOneKeyUsbDevicePath,
 } from './constants';
 
@@ -251,3 +252,30 @@ describe('hardware device identity filters', () => {
     ).toBe(false);
   });
 });
+
+describe('Pro2 / Neo BLE advertisement color', () => {
+  it('reads the serial-number color letter from the 5-byte payload', () => {
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0x41, 0, 0, 0, 0]))).toBe('A');
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0x46, 0x12, 0x34, 0x56, 0x78]))).toBe('F');
+    expect(parseOnekeyBleColorCode(Buffer.from([0x5a, 0, 0, 0, 0]))).toBe('Z');
+  });
+
+  it('treats a missing serial number or a non-letter byte as unknown', () => {
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0x00, 0, 0, 0, 0]))).toBeUndefined();
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0x61, 0, 0, 0, 0]))).toBeUndefined();
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0x31, 0, 0, 0, 0]))).toBeUndefined();
+  });
+
+  it('does not read a color from other manufacturer data layouts', () => {
+    // Pro2 / Neo BLE firmware before the color: a 4-byte zero nonce.
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0, 0, 0, 0]))).toBeUndefined();
+    // Classic: company ID 0x00FE followed by the MAC.
+    expect(
+      parseOnekeyBleColorCode(Uint8Array.from([0xfe, 0x00, 0x41, 1, 2, 3, 4, 5]))
+    ).toBeUndefined();
+    expect(parseOnekeyBleColorCode(Uint8Array.from([0x41, 0, 0, 0, 0, 0]))).toBeUndefined();
+    expect(parseOnekeyBleColorCode(new Uint8Array())).toBeUndefined();
+    expect(parseOnekeyBleColorCode(null)).toBeUndefined();
+    expect(parseOnekeyBleColorCode(undefined)).toBeUndefined();
+  });
+});

package/src/constants.ts

@@ -43,6 +43,9 @@ export const isKnownTrezorWebUsbDevice = (descriptor: WebUsbIdentityDescriptor):
  * These errors indicate the device is in an invalid state and needs to be released
  */
 export const ERROR_CODES_REQUIRE_RELEASE = [
+  HardwareErrorCode.WebUsbDeviceAccessError,
+  HardwareErrorCode.TransportProtocolProbeFailed,
+  HardwareErrorCode.TransportProtocolMismatch,
   HardwareErrorCode.DeviceInitializeFailed,
   HardwareErrorCode.DeviceInterruptedFromOutside,
   HardwareErrorCode.DeviceInterruptedFromUser,
@@ -58,6 +61,9 @@ export const ERROR_CODES_REQUIRE_RELEASE = [
  * These errors indicate a communication failure that requires full reconnection
  */
 export const ERROR_CODES_REQUIRE_DISCONNECT = [
+  HardwareErrorCode.WebUsbDeviceAccessError,
+  HardwareErrorCode.TransportProtocolProbeFailed,
+  HardwareErrorCode.TransportProtocolMismatch,
   HardwareErrorCode.DeviceInitializeFailed,
   HardwareErrorCode.ResponseUnexpectTypeError,
 ] as const;
@@ -368,6 +374,24 @@ export const isPro2FamilyBleName = (value?: string | null): boolean => {
   );
 };
 
+// Pro2 / Neo manufacturer-specific data has no Bluetooth SIG company ID: byte 0 is
+// serial_number[10] (the color letter, 0x00 before the SN is known) and bytes 1-4
+// are a nonce. Older Pro2 / Neo firmware sends 4 zero bytes and Classic sends a
+// company ID plus MAC, so any other length is not a color.
+const ONEKEY_BLE_COLOR_PAYLOAD_LENGTH = 5;
+
+/**
+ * Reads the serial-number color letter from the raw 0xFF advertisement payload
+ * (the bytes after the AD type). Returns undefined when no valid letter is present.
+ */
+export const parseOnekeyBleColorCode = (
+  manufacturerData: Uint8Array | null | undefined
+): string | undefined => {
+  if (manufacturerData?.length !== ONEKEY_BLE_COLOR_PAYLOAD_LENGTH) return undefined;
+  const code = manufacturerData[0];
+  return code >= 0x41 && code <= 0x5a ? String.fromCharCode(code) : undefined;
+};
+
 export const isOnekeyBluetoothDevice = ({
   id,
   name,