@onekeyfe/hd-shared 1.2.0-alpha.18 → 1.2.0-alpha.180

package/dist/HardwareError.d.ts

@@ -86,6 +86,7 @@ export declare const HardwareErrorCode: {
     readonly BleDeviceDisconnected: 720;
     readonly BlePoweredOff: 721;
     readonly BleUnsupported: 722;
+    readonly BleUnavailableWhileUsbConnected: 723;
     readonly RuntimeError: 800;
     readonly PinInvalid: 801;
     readonly PinCancelled: 802;
@@ -115,8 +116,9 @@ export declare const HardwareErrorCode: {
     readonly DeviceSettingsLanguageNotSupport: 826;
     readonly TooManyInputs: 827;
     readonly PinMismatch: 828;
-    readonly DeviceLocked: 829;
-    readonly KaspaPrevTxIdMismatch: 830;
+    readonly DeviceLocked: 830;
+    readonly WalletSessionInvalid: 831;
+    readonly NftStorageLimitReached: 832;
     readonly LowlevelTrasnportConnectError: 900;
     readonly WebDeviceNotFoundOrNeedsPermission: 901;
     readonly WebDevicePromptAccessError: 902;

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAibpB,CAAC;AAEX,eAAO,MAAM,wBAAwB,EAAE,+BAkJ7B,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAybpB,CAAC;AAEX,eAAO,MAAM,wBAAwB,EAAE,+BAsJ7B,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

@@ -8,6 +8,10 @@ export declare const ONEKEY_WEBUSB_FILTER: {
     vendorId: number;
     productId: number;
 }[];
+export declare const ONEKEY_PROTOCOL_V2_USB_IDS: readonly [{
+    readonly vendorId: 4617;
+    readonly productId: 20300;
+}];
 type WebUsbIdentityDescriptor = {
     vendorId?: number;
     productId?: number;
@@ -33,17 +37,47 @@ export declare enum EOneKeyBleMessageKeys {
     NOBLE_BLE_STOP_SCAN = "$onekey-noble-ble-stop-scan",
     NOBLE_BLE_GET_DEVICE = "$onekey-noble-ble-get-device",
     NOBLE_BLE_CONNECT = "$onekey-noble-ble-connect",
+    NOBLE_BLE_RELEASE = "$onekey-noble-ble-release",
     NOBLE_BLE_DISCONNECT = "$onekey-noble-ble-disconnect",
     NOBLE_BLE_WRITE = "$onekey-noble-ble-write",
     NOBLE_BLE_SUBSCRIBE = "$onekey-noble-ble-subscribe",
     NOBLE_BLE_UNSUBSCRIBE = "$onekey-noble-ble-unsubscribe",
     NOBLE_BLE_NOTIFICATION = "$onekey-noble-ble-notification",
+    NOBLE_BLE_MTU_CHANGED = "$onekey-noble-ble-mtu-changed",
     NOBLE_BLE_CANCEL_PAIRING = "$onekey-noble-ble-cancel-pairing"
 }
+export declare enum EBleDisconnectReason {
+    DeviceDisconnected = "device-disconnected",
+    IdleKeepAlive = "idle-keep-alive"
+}
 export declare const ONEKEY_SERVICE_UUID = "00000001-0000-1000-8000-00805f9b34fb";
 export declare const ONEKEY_WRITE_CHARACTERISTIC_UUID = "00000002-0000-1000-8000-00805f9b34fb";
 export declare const ONEKEY_NOTIFY_CHARACTERISTIC_UUID = "00000003-0000-1000-8000-00805f9b34fb";
 export declare const isHeaderChunk: (chunk: Buffer | Uint8Array) => boolean;
 export declare const isOnekeyDevice: (name: string | null, id?: string) => boolean;
+export declare const inferProtocolHintFromUsbId: (vendorId?: number | null, productId?: number | null) => "V2" | undefined;
+type UsbDevicePathInput = {
+    serialNumber?: string | null;
+    vendorId?: number;
+    productId?: number;
+    productName?: string | null;
+};
+export declare const resolveOneKeyUsbDevicePath: (device: UsbDevicePathInput) => string | undefined;
+type BluetoothDeviceIdentity = {
+    id?: string;
+    name?: string | null;
+    localName?: string | null;
+    serviceUuids?: Array<string | null | undefined> | null;
+};
+export declare const normalizeBleUuid: (uuid?: string | null) => string;
+export declare const createKnownBleUuidAliases: (uuid: string) => ReadonlySet<string>;
+export declare const matchesKnownBleUuid: (actualUuid: string | null | undefined, aliases: ReadonlySet<string>) => boolean;
+export declare const isPro2FindMyAdvertisementName: (value?: string | null) => boolean;
+export declare const normalizePro2FindMyAdvertisementName: (value: string) => string;
+export declare const canonicalizePro2BleAdvertisementName: (value: string) => string;
+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 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":";AAEA,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAE7E,eAAO,MAAM,oBAAoB;;;GAOhC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAIF,eAAO,MAAM,yBAAyB,eAAgB,wBAAwB,KAAG,OAQhF,CAAC;AAMF,eAAO,MAAM,2BAA2B,mDAS9B,CAAC;AAMX,eAAO,MAAM,8BAA8B,qBAGjC,CAAC;AAGX,oBAAY,qBAAqB;IAE/B,UAAU,uBAAuB;IACjC,iBAAiB,8BAA8B;IAC/C,aAAa,0BAA0B;IACvC,kBAAkB,+BAA+B;IACjD,cAAc,2BAA2B;IACzC,oBAAoB,iCAAiC;IAGrD,mBAAmB,gCAAgC;IACnD,oBAAoB,iCAAiC;IAGrD,aAAa,0BAA0B;IACvC,oBAAoB,iCAAiC;IAGrD,uBAAuB,oCAAoC;IAC3D,sBAAsB,mCAAmC;IAGzD,mBAAmB,gCAAgC;IACnD,mBAAmB,gCAAgC;IACnD,oBAAoB,iCAAiC;IACrD,iBAAiB,8BAA8B;IAC/C,oBAAoB,iCAAiC;IACrD,eAAe,4BAA4B;IAC3C,mBAAmB,gCAAgC;IACnD,qBAAqB,kCAAkC;IACvD,sBAAsB,mCAAmC;IACzD,wBAAwB,qCAAqC;CAC9D;AAED,eAAO,MAAM,mBAAmB,yCAAyC,CAAC;AAC1E,eAAO,MAAM,gCAAgC,yCAAyC,CAAC;AACvF,eAAO,MAAM,iCAAiC,yCAAyC,CAAC;AAIxF,eAAO,MAAM,aAAa,UAAW,MAAM,GAAG,UAAU,KAAG,OAa1D,CAAC;AAkBF,eAAO,MAAM,cAAc,SAAU,MAAM,GAAG,IAAI,OAAO,MAAM,KAAG,OAsBjE,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/deviceType.d.ts

@@ -6,6 +6,7 @@ export declare enum EDeviceType {
     Mini = "mini",
     Touch = "touch",
     Pro = "pro",
-    Pro2 = "pro2"
+    Pro2 = "pro2",
+    Neo = "neo"
 }
 //# sourceMappingURL=deviceType.d.ts.map

package/dist/deviceType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceType.d.ts","sourceRoot":"","sources":["../src/deviceType.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,IAAI,SAAS;CACd"}
+{"version":3,"file":"deviceType.d.ts","sourceRoot":"","sources":["../src/deviceType.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ"}

package/dist/index.d.ts

@@ -7,13 +7,26 @@ declare const ONEKEY_WEBUSB_FILTER: {
     vendorId: number;
     productId: number;
 }[];
+/** USB IDs whose first probe should be Protocol V2. Shared Pro/Touch PIDs stay unhinted. */
+declare const ONEKEY_PROTOCOL_V2_USB_IDS: readonly [{
+    readonly vendorId: 4617;
+    readonly productId: 20300;
+}];
 type WebUsbIdentityDescriptor = {
     vendorId?: number;
     productId?: number;
     manufacturerName?: string | null;
 };
 declare const isKnownTrezorWebUsbDevice: (descriptor: WebUsbIdentityDescriptor) => boolean;
+/**
+ * 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];
+/**
+ * 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 enum EOneKeyBleMessageKeys {
     BLE_SELECT = "$onekey-ble-select",
@@ -32,18 +45,71 @@ declare enum EOneKeyBleMessageKeys {
     NOBLE_BLE_STOP_SCAN = "$onekey-noble-ble-stop-scan",
     NOBLE_BLE_GET_DEVICE = "$onekey-noble-ble-get-device",
     NOBLE_BLE_CONNECT = "$onekey-noble-ble-connect",
+    NOBLE_BLE_RELEASE = "$onekey-noble-ble-release",
     NOBLE_BLE_DISCONNECT = "$onekey-noble-ble-disconnect",
     NOBLE_BLE_WRITE = "$onekey-noble-ble-write",
     NOBLE_BLE_SUBSCRIBE = "$onekey-noble-ble-subscribe",
     NOBLE_BLE_UNSUBSCRIBE = "$onekey-noble-ble-unsubscribe",
     NOBLE_BLE_NOTIFICATION = "$onekey-noble-ble-notification",
+    NOBLE_BLE_MTU_CHANGED = "$onekey-noble-ble-mtu-changed",
     NOBLE_BLE_CANCEL_PAIRING = "$onekey-noble-ble-cancel-pairing"
 }
+/**
+ * Why a BLE link went down, carried on BLE_DEVICE_DISCONNECTED.
+ *
+ * The main process frees an idle link on its own keep-alive timer, which is an
+ * internal optimisation the device knows nothing about — consumers must not
+ * treat it as "the device is gone". Only DeviceDisconnected means the
+ * peripheral actually dropped.
+ */
+declare enum EBleDisconnectReason {
+    /** Unsolicited peripheral drop: powered off, out of range, cable/BLE lost. */
+    DeviceDisconnected = "device-disconnected",
+    /** Main-process keep-alive timer released an idle link; device still present. */
+    IdleKeepAlive = "idle-keep-alive"
+}
 declare const ONEKEY_SERVICE_UUID = "00000001-0000-1000-8000-00805f9b34fb";
 declare const ONEKEY_WRITE_CHARACTERISTIC_UUID = "00000002-0000-1000-8000-00805f9b34fb";
 declare const ONEKEY_NOTIFY_CHARACTERISTIC_UUID = "00000003-0000-1000-8000-00805f9b34fb";
 declare const isHeaderChunk: (chunk: Buffer | Uint8Array) => boolean;
 declare const isOnekeyDevice: (name: string | null, id?: string) => boolean;
+declare const inferProtocolHintFromUsbId: (vendorId?: number | null, productId?: number | null) => "V2" | undefined;
+type UsbDevicePathInput = {
+    serialNumber?: string | null;
+    vendorId?: number;
+    productId?: number;
+    productName?: string | null;
+};
+declare const resolveOneKeyUsbDevicePath: (device: UsbDevicePathInput) => string | undefined;
+type BluetoothDeviceIdentity = {
+    id?: string;
+    name?: string | null;
+    localName?: string | null;
+    serviceUuids?: Array<string | null | undefined> | null;
+};
+declare const normalizeBleUuid: (uuid?: string | null) => string;
+declare const createKnownBleUuidAliases: (uuid: string) => ReadonlySet<string>;
+declare const matchesKnownBleUuid: (actualUuid: string | null | undefined, aliases: ReadonlySet<string>) => boolean;
+declare const isPro2FindMyAdvertisementName: (value?: string | null) => boolean;
+declare const normalizePro2FindMyAdvertisementName: (value: string) => string;
+/**
+ * Current Pro2 advertisements use "Pro 2 XXXX". Older firmware used "Pro2 XXXX".
+ * Discovery and DeviceInfo both go through this helper so the public BLE name
+ * stays on the spaced form without changing OneKey Pro / Neo names.
+ *
+ * Match the compact Pro2 form first. A leading "Pro 2" regex would also eat the
+ * first digit of a OneKey Pro suffix such as "Pro 22D8" or "Pro 2D8F".
+ */
+declare const canonicalizePro2BleAdvertisementName: (value: string) => string;
+declare const isSameOnekeyBleName: (left?: string | null, right?: string | null) => boolean;
+declare const hasOnekeyCommunicationService: (serviceUuids: Array<string | null | undefined> | null | undefined) => boolean;
+/**
+ * Protocol V2 family (Pro2 / Neo) by advertised BLE name. Callers use it to
+ * pick a connection strategy: this family also advertises under Find My names
+ * that carry no OneKey service UUID, so a scan cannot always see it.
+ */
+declare const isPro2FamilyBleName: (value?: string | null) => boolean;
+declare const isOnekeyBluetoothDevice: ({ id, name, localName, serviceUuids, }: BluetoothDeviceIdentity) => boolean;
 
 type Deferred<T, I = any, D = any> = {
     id?: I;
@@ -76,53 +142,201 @@ declare class HardwareError extends Error {
     constructor(hardwareError: IHardwareError | string);
 }
 declare const HardwareErrorCode: {
+    /**
+     * This error can be thrown when unexpected error occurred and in most cases it is related to implementation bug.
+     * Original message is available in message property.
+     */
     readonly UnknownError: 0;
+    /**
+     * Firmware version mismatch
+     */
     readonly DeviceFwException: 101;
+    /**
+     * Device unexpected mode
+     */
     readonly DeviceUnexpectedMode: 102;
+    /**
+     * Device list is not initialized
+     */
     readonly DeviceListNotInitialized: 103;
+    /**
+     * Please select the connected device
+     */
     readonly SelectDevice: 104;
+    /**
+     * Device not found
+     */
     readonly DeviceNotFound: 105;
+    /**
+     * Device is not initialized
+     */
     readonly DeviceInitializeFailed: 106;
+    /**
+     * Device interrupted from another operation
+     */
     readonly DeviceInterruptedFromOutside: 107;
+    /**
+     * Device should be in bootloader mode
+     */
     readonly RequiredButInBootloaderMode: 108;
+    /**
+     * Device interrupted from user
+     */
     readonly DeviceInterruptedFromUser: 109;
+    /**
+     * Check device id is same
+     */
     readonly DeviceCheckDeviceIdError: 110;
+    /**
+     * Do not support passphrase
+     * @params: { require: string }
+     */
     readonly DeviceNotSupportPassphrase: 111;
     readonly DeviceCheckPassphraseStateError: 112;
+    /**
+     * use passphrase, but passphrase is not opened
+     */
     readonly DeviceNotOpenedPassphrase: 113;
+    /**
+     * not use passphrase, but passphrase is opened
+     */
     readonly DeviceOpenedPassphrase: 114;
+    /**
+     *  Detect hardware that is in bootloader mode and return an error.
+     */
     readonly DeviceDetectInBootloaderMode: 115;
+    /**
+     * Device not allow in bootloader mode
+     */
     readonly NotAllowInBootloaderMode: 116;
+    /**
+     * Device is busy
+     */
     readonly DeviceBusy: 117;
+    /**
+     * Device check unlock type not match error
+     */
     readonly DeviceCheckUnlockTypeError: 118;
+    /**
+     * Not initialized
+     */
     readonly NotInitialized: 200;
+    /**
+     * Iframe not initialized
+     */
     readonly IFrameNotInitialized: 300;
+    /**
+     * iframe repeat initialization
+     */
     readonly IFrameAleradyInitialized: 301;
+    /**
+     * iframe load failure
+     */
     readonly IFrameLoadFail: 302;
+    /**
+     * init iframe time out
+     */
     readonly IframeTimeout: 303;
+    /**
+     * iframe blocked
+     */
     readonly IframeBlocked: 304;
+    /**
+     * iframe host not trust
+     */
     readonly IframeDistrust: 305;
+    /**
+     * Runtime errors during method execution
+     */
     readonly CallMethodError: 400;
+    /**
+     * Method does not responding
+     */
     readonly CallMethodNotResponse: 404;
+    /**
+     * Call method invalid parameter
+     */
     readonly CallMethodInvalidParameter: 405;
+    /**
+     * firmware update download failed
+     */
     readonly FirmwareUpdateDownloadFailed: 406;
+    /**
+     * Call method not supported, need update firmware
+     * @params: { current: string, require: string }
+     */
     readonly CallMethodNeedUpgradeFirmware: 407;
+    /**
+     * Call method not supported, is deprecated
+     * @params: { current: string, deprecated: string }
+     */
     readonly CallMethodDeprecated: 408;
+    /**
+     * Only one device can be connected during firmware upgrade
+     */
     readonly FirmwareUpdateLimitOneDevice: 409;
+    /**
+     * You need to manually enter boot
+     */
     readonly FirmwareUpdateManuallyEnterBoot: 410;
+    /**
+     * Manual entry fails. You must manually enter the boot
+     */
     readonly FirmwareUpdateAutoEnterBootFailure: 411;
+    /**
+     * The new firmware has not been released yet
+     */
     readonly NewFirmwareUnRelease: 412;
+    /**
+     * use OneKey desktop client to update the firmware
+     * because need copy resource file to Touch
+     */
     readonly UseDesktopToUpdateFirmware: 413;
+    /**
+     * Mandatory firmware update
+     * @params:{ connectId: string? , deviceId: string? }
+     */
     readonly NewFirmwareForceUpdate: 414;
+    /**
+     * Device not support this method
+     */
     readonly DeviceNotSupportMethod: 415;
+    /**
+     * Forbidden key path
+     */
     readonly ForbiddenKeyPath: 416;
+    /**
+     * Repeat unlocking
+     * all network get address by loop need repeat unlocking
+     */
     readonly RepeatUnlocking: 417;
+    /**
+     * Defective firmware detected
+     */
     readonly DefectiveFirmware: 418;
+    /**
+     * Netword request error
+     */
     readonly NetworkError: 500;
+    /**
+     * Transport not configured
+     */
     readonly TransportNotConfigured: 600;
+    /**
+     * Transport call in progress
+     */
     readonly TransportCallInProgress: 601;
+    /**
+     * Transport not found
+     */
     readonly TransportNotFound: 602;
+    /**
+     * Transport invalid protobuf
+     */
     readonly TransportInvalidProtobuf: 603;
+    /**
+     * Bluetooth error code
+     */
     readonly BleScanError: 700;
     readonly BlePermissionError: 701;
     readonly BleLocationError: 702;
@@ -146,39 +360,145 @@ declare const HardwareErrorCode: {
     readonly BleDeviceDisconnected: 720;
     readonly BlePoweredOff: 721;
     readonly BleUnsupported: 722;
+    readonly BleUnavailableWhileUsbConnected: 723;
+    /**
+     * Hardware runtiome errors
+     */
     readonly RuntimeError: 800;
+    /**
+     * invalid pin
+     */
     readonly PinInvalid: 801;
+    /**
+     * pin cancelled by user
+     */
     readonly PinCancelled: 802;
+    /**
+     * Action cancelled by user
+     */
     readonly ActionCancelled: 803;
+    /**
+     * Firmware installation failed
+     */
     readonly FirmwareError: 804;
+    /**
+     * transport response unexpect error
+     */
     readonly ResponseUnexpectTypeError: 805;
+    /**
+     * bridge network error
+     */
     readonly BridgeNetworkError: 806;
+    /**
+     * Bridge network timeout
+     */
     readonly BridgeTimeoutError: 807;
+    /**
+     * Bridge not installed
+     */
     readonly BridgeNotInstalled: 808;
+    /**
+     * ensure connect timeout
+     */
     readonly PollingTimeout: 809;
+    /**
+     * ensure connect stop polling
+     */
     readonly PollingStop: 810;
+    /**
+     * Device does not open blid sign
+     */
     readonly BlindSignDisabled: 811;
     readonly UnexpectPassphrase: 812;
+    /**
+     * NFT file already exists
+     */
     readonly FileAlreadyExists: 813;
+    /**
+     * check file length error
+     */
     readonly CheckDownloadFileError: 814;
+    /**
+     * not in signing mode
+     */
     readonly NotInSigningMode: 815;
+    /**
+     * not in signing mode
+     */
     readonly DataOverload: 816;
+    /**
+     * device disconnected during action
+     */
     readonly BridgeDeviceDisconnected: 817;
+    /**
+     * BTC PSBT too many utxos
+     * @params:{ count: number }
+     */
     readonly BTCPsbtTooManyUtxos: 818;
+    /**
+     * EMMC file write firmware error
+     */
     readonly EmmcFileWriteFirmwareError: 819;
+    /**
+     * Firmware verification failed (e.g., bootloader file verify failed)
+     */
     readonly FirmwareVerificationFailed: 820;
+    /**
+     * Web bridge coonect needs permission
+     */
     readonly BridgeNeedsPermission: 821;
     readonly CallQueueActionCancelled: 822;
+    /**
+     * Firmware downgrade not allowed
+     */
     readonly FirmwareDowngradeNotAllowed: 823;
+    /**
+     * Cosmos invalid JSON message, Only support Amino msgs.
+     */
     readonly CosmosInvalidJsonMessage: 824;
+    /**
+     * No setting provided
+     */
     readonly DeviceSettingsNotProvided: 825;
+    /**
+     * Language not supported
+     */
     readonly DeviceSettingsLanguageNotSupport: 826;
+    /**
+     * Too many inputs
+     * @params: { count?: string }
+     */
     readonly TooManyInputs: 827;
+    /**
+     * The two PIN entries did not match while setting/changing PIN on device
+     */
     readonly PinMismatch: 828;
-    readonly DeviceLocked: 829;
-    readonly KaspaPrevTxIdMismatch: 830;
+    /**
+     * Protocol V2 device must be unlocked before the requested operation.
+     * @params: { failureCode?: string; subcode?: number; firmwareMessage?: string }
+     */
+    readonly DeviceLocked: 830;
+    /**
+     * The cached wallet session is invalid or has expired.
+     * @params: { failureCode?: string; subcode?: number; firmwareMessage?: string }
+     */
+    readonly WalletSessionInvalid: 831;
+    /**
+     * Pro2 NFT storage has reached its item limit.
+     * @params: { count: number; limit: number }
+     */
+    readonly NftStorageLimitReached: 832;
+    /**
+     * Lowlevel transport connect error
+     */
     readonly LowlevelTrasnportConnectError: 900;
+    /**
+     * Web USB or Web Bluetooth device not found or needs permission
+     */
     readonly WebDeviceNotFoundOrNeedsPermission: 901;
+    /**
+     * Web USB or Web Bluetooth device prompt access error
+     */
     readonly WebDevicePromptAccessError: 902;
 };
 declare const HardwareErrorCodeMessage: HardwareErrorCodeMessageMapping;
@@ -250,7 +570,8 @@ declare enum EDeviceType {
     Mini = "mini",
     Touch = "touch",
     Pro = "pro",
-    Pro2 = "pro2"
+    Pro2 = "pro2",
+    Neo = "neo"
 }
 
-export { CreateErrorByMessage, CreateHardwareErrorByBridgeError, Deferred, 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_SERVICE_UUID, ONEKEY_WEBUSB_FILTER, ONEKEY_WRITE_CHARACTERISTIC_UUID, TypedError, createDefectiveFirmwareError, createDeferred, createDeprecatedHardwareError, createDeviceNotSupportMethodError, createNeedUpgradeFirmwareHardwareError, createNewFirmwareForceUpdateHardwareError, createNewFirmwareUnReleaseHardwareError, isHeaderChunk, isKnownTrezorWebUsbDevice, isOnekeyDevice, 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, resolveOneKeyUsbDevicePath, serializeError, wait };