@onekeyfe/hd-core 1.2.0-alpha.17 → 1.2.0-alpha.170

package/dist/utils/pro2Nft.d.ts

@@ -0,0 +1,38 @@
+export declare const PRO2_NFT_IMAGE_WIDTH = 540;
+export declare const PRO2_NFT_IMAGE_HEIGHT = 540;
+export declare const PRO2_NFT_THUMBNAIL_WIDTH = 263;
+export declare const PRO2_NFT_THUMBNAIL_HEIGHT = 263;
+export declare const PRO2_NFT_DIRECTORY = "vol1:/nft";
+export declare const PRO2_NFT_DEFAULT_CHUNK_SIZE = 2048;
+export declare const PRO2_NFT_DEFAULT_PACE_MS = 0;
+export declare const PRO2_NFT_DEFAULT_TIMEOUT_MS = 15000;
+export declare const PRO2_NFT_MIN_CHUNK_SIZE = 64;
+export declare const PRO2_NFT_MAX_CHUNK_SIZE = 2048;
+export declare const PRO2_NFT_MAX_ITEMS = 10;
+export type Pro2NftImage = {
+    width: number;
+    height: number;
+    rgba: Uint8Array | ArrayBuffer;
+};
+export type Pro2NftBundle = {
+    basename: string;
+    image: Uint8Array;
+    thumbnail: Uint8Array;
+    metadata: Uint8Array;
+};
+export declare function getCompletePro2NftBasenames(childFiles?: string): Set<string>;
+export declare function buildPro2NftBundle(options: {
+    image: Pro2NftImage;
+    thumbnail: Pro2NftImage;
+    title: string;
+    subtitle: string;
+    timestampMs: number;
+}): Pro2NftBundle;
+export declare function buildPro2NftBundleFromEncodedImages(options: {
+    image: Uint8Array;
+    thumbnail: Uint8Array;
+    title: string;
+    subtitle: string;
+    timestampMs: number;
+}): Pro2NftBundle;
+//# sourceMappingURL=pro2Nft.d.ts.map

package/dist/utils/pro2Nft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pro2Nft.d.ts","sourceRoot":"","sources":["../../src/utils/pro2Nft.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,UAAU,CAAC;CACtB,CAAC;AAiCF,wBAAgB,2BAA2B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAiB5E;AAsBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,aAAa,CAgBhB;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,aAAa,CAiChB"}

package/dist/utils/pro2Wallpaper.d.ts

@@ -1,10 +1,22 @@
 export declare const PRO2_WALLPAPER_WIDTH = 604;
 export declare const PRO2_WALLPAPER_HEIGHT = 1024;
-export type Pro2WallpaperColorFormat = 'RGB565' | 'RGB565A8';
+export type Pro2WallpaperColorFormat = 'RGB565' | 'RGB565A8' | 'I8';
+export type Pro2WallpaperEncoding = 'rgb565' | 'i8-lz4';
+export type Pro2ImageAlphaMode = 'preserve' | 'black-background';
+export declare function encodePro2Image(options: {
+    width: number;
+    height: number;
+    rgba: Uint8Array | ArrayBuffer;
+    alphaMode?: Pro2ImageAlphaMode;
+}): {
+    data: Uint8Array;
+    colorFormat: Pro2WallpaperColorFormat;
+};
 export declare function encodePro2Wallpaper(options: {
     width: number;
     height: number;
     rgba: Uint8Array | ArrayBuffer;
+    encoding?: Pro2WallpaperEncoding;
 }): {
     data: Uint8Array;
     colorFormat: Pro2WallpaperColorFormat;

package/dist/utils/pro2Wallpaper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pro2Wallpaper.d.ts","sourceRoot":"","sources":["../../src/utils/pro2Wallpaper.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAiC7D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;CAChC,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,wBAAwB,CAAA;CAAE,CAoE9D"}
+{"version":3,"file":"pro2Wallpaper.d.ts","sourceRoot":"","sources":["../../src/utils/pro2Wallpaper.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,kBAAkB,CAAC;AA4NjE,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,wBAAwB,CAAA;CAAE,CA4E9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,wBAAwB,CAAA;CAAE,CAK9D"}

package/dist/utils/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/utils/tracing.ts"],"names":[],"mappings":"AAmBA,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AASD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/E;AAOD,MAAM,WAAW,cAAc;IAE7B,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IAEnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,iBAAiB;IAEhC,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,EAAE,MAAM,CAAC;IAElB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAWD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAW3D;AAQD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,cAAc,CAyBhB;AAKD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK/F;AAKD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAuB9E;AAOD,wBAAgB,iCAAiC,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,EAAE,CAI5F;AAOD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmBpE;AAOD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAW9D"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/utils/tracing.ts"],"names":[],"mappings":"AAmBA,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AASD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/E;AAOD,MAAM,WAAW,cAAc;IAE7B,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IAEnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,iBAAiB;IAEhC,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,EAAE,MAAM,CAAC;IAElB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAWD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAW3D;AAQD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,cAAc,CAyBhB;AAKD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK/F;AAKD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAyB9E;AAOD,wBAAgB,iCAAiC,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,EAAE,CAI5F;AAOD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmBpE;AAOD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAW9D"}

package/dist/utils/uiProgressThrottle.d.ts

@@ -0,0 +1,3 @@
+import type { CoreMessage } from '../events';
+export declare const createUiProgressMessageFilter: (intervalMs?: number, now?: () => number) => (message: CoreMessage) => boolean;
+//# sourceMappingURL=uiProgressThrottle.d.ts.map

package/dist/utils/uiProgressThrottle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiProgressThrottle.d.ts","sourceRoot":"","sources":["../../src/utils/uiProgressThrottle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAiB7C,eAAO,MAAM,6BAA6B,yDAMvB,WAAW,YAqC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-core",
-  "version": "1.2.0-alpha.17",
+  "version": "1.2.0-alpha.170",
   "description": "Core processes and APIs for communicating with OneKey hardware devices.",
   "author": "OneKey",
   "homepage": "https://github.com/OneKeyHQ/hardware-js-sdk#readme",
@@ -25,11 +25,13 @@
     "url": "https://github.com/OneKeyHQ/hardware-js-sdk/issues"
   },
   "dependencies": {
-    "@onekeyfe/hd-shared": "1.2.0-alpha.17",
-    "@onekeyfe/hd-transport": "1.2.0-alpha.17",
+    "@onekeyfe/hd-shared": "1.2.0-alpha.170",
+    "@onekeyfe/hd-transport": "1.2.0-alpha.170",
     "axios": "1.15.2",
     "bignumber.js": "^9.0.2",
+    "buffer": "^6.0.3",
     "bytebuffer": "^5.0.1",
+    "jpeg-js": "^0.4.4",
     "jszip": "^3.10.1",
     "parse-uri": "^1.0.7",
     "semver": "^7.3.7"
@@ -44,5 +46,5 @@
     "@types/w3c-web-usb": "^1.0.10",
     "@types/web-bluetooth": "^0.0.21"
   },
-  "gitHead": "9027b743e4f73beb42e1a7950397504b4191f2a3"
+  "gitHead": "d702db069d6b19f74cd5f1cf42277a7152beb3a8"
 }

package/src/api/BaseMethod.ts

@@ -1,17 +1,23 @@
 import semver from 'semver';
 import {
+  type EFirmwareType,
   ERRORS,
   HardwareErrorCode,
   createDeviceNotSupportMethodError,
   createNeedUpgradeFirmwareHardwareError,
 } from '@onekeyfe/hd-shared';
+import {
+  type DeviceSessionPinType,
+  Enum_SafetyCheckLevel,
+  type ProtocolType,
+} from '@onekeyfe/hd-transport';
 
 import { createDeviceMessage } from '../events/device';
 import { UI_REQUEST } from '../constants/ui-request';
 import { DEVICE, FIRMWARE, createFirmwareMessage, createUiMessage } from '../events';
 import { getHDPath, toHardened } from './helpers/pathUtils';
 import { getBleFirmwareReleaseInfo, getFirmwareReleaseInfo } from './firmware/releaseHelper';
-import { LoggerNames, getFirmwareType, getLogger, isMethodVersionRangeUnsupported } from '../utils';
+import { LoggerNames, getLogger } from '../utils';
 import { generateInstanceId } from '../utils/tracing';
 import { DeviceModelToTypes } from '../types';
 
@@ -19,11 +25,13 @@ import type { Device } from '../device/Device';
 import type DeviceConnector from '../device/DeviceConnector';
 import type { DeviceFirmwareRange, KnownDevice } from '../types';
 import type { CoreMessage } from '../events';
+import type { UnlockPolicy } from '../protocols/protocol-v2/unlockPolicy';
 import type { ProtocolV2InteractionDescriptor } from '../protocols/protocol-v2/uiInteraction';
+import type { ProtocolV2UnlockContext } from '../protocols/protocol-v2/unlockPolicyRunner';
 import type { RequestContext } from '../utils/tracing';
 import type { CoreContext } from '../core';
 
-export type UnlockPolicy = 'none' | 'retry-on-locked';
+export type { UnlockPolicy } from '../protocols/protocol-v2/unlockPolicy';
 export type ProtocolV2UiMode = 'auto' | 'none';
 
 const Log = getLogger(LoggerNames.Method);
@@ -122,9 +130,7 @@ export abstract class BaseMethod<Params = undefined> {
    */
   checkDeviceId = false;
 
-  /**
-   * 该方法是否需要校验 passphrase state
-   */
+  /** Whether the method requires wallet-session selection and Protocol V2 pre-unlock. */
   useDevicePassphraseState = true;
 
   /**
@@ -162,21 +168,33 @@ export abstract class BaseMethod<Params = undefined> {
    */
   strictCheckDeviceSupport = false;
 
-  /**
-   * 方法是否仅支持 Protocol V2 设备（Pro2）。
-   * core 调度在设备协议确定（acquire + initialize）后统一守卫，
-   * 非 V2 设备直接抛出 NotSupport 错误，方法内部不必重复判断。
-   * @default false
-   */
-  requireProtocolV2 = false;
+  /** Non-wallet methods may explicitly require Protocol V2 pre-unlock. */
+  unlockPolicy: UnlockPolicy = 'none';
+
+  /** PIN type accepted by an explicit Protocol V2 pre-unlock. */
+  protocolV2PreUnlockPinType?: DeviceSessionPinType;
+
+  /** Shared by composite methods so nested calls do not repeat the root preflight. */
+  protocolV2UnlockContext?: ProtocolV2UnlockContext;
 
-  /** Protocol V2 业务方法锁定时默认由 Core 自动解锁并重试一次。 */
-  unlockPolicy: UnlockPolicy = 'retry-on-locked';
+  getSupportedProtocols(): readonly ProtocolType[] {
+    return ['V1'];
+  }
+
+  supportsProtocol(protocol: ProtocolType): boolean {
+    return this.getSupportedProtocols().includes(protocol);
+  }
+
+  assertProtocolSupported(protocol: ProtocolType, firmwareType: EFirmwareType): void {
+    if (!this.supportsProtocol(protocol)) {
+      throw createDeviceNotSupportMethodError(this.name, firmwareType);
+    }
+  }
 
-  /** Protocol V2 由 SDK 合成的非阻塞设备交互提示；未声明时不生成交互 Event。 */
+  /** Non-blocking Protocol V2 interaction synthesized by the SDK. */
   protocolV2UiInteraction?: ProtocolV2InteractionDescriptor;
 
-  /** 特殊后台方法可关闭包括自动解锁提示在内的全部 Protocol V2 合成 UI Event。 */
+  /** Special background methods may suppress method-level Protocol V2 UI events. */
   protocolV2UiMode: ProtocolV2UiMode = 'auto';
 
   protected throwIfAborted() {
@@ -251,11 +269,11 @@ export abstract class BaseMethod<Params = undefined> {
   }
 
   checkFirmwareRelease() {
-    // 固件 release 元数据（DataManager remote config）目前只覆盖 Protocol V1 设备；
-    // Pro2 的更新流程由 firmwareUpdateV4 自行管理，这里显式跳过而不是依赖 features 为空。
+    // DataManager release metadata currently covers Protocol V1 devices only.
+    // firmwareUpdateV4 manages Pro2 updates, so skip them explicitly.
     if (!this.device || this.device.isProtocolV2()) return;
     if (!this.device.features) return;
-    const firmwareType = getFirmwareType(this.device.features);
+    const firmwareType = this.device.getCurrentFirmwareType();
     const releaseInfo = getFirmwareReleaseInfo(this.device.features, firmwareType);
     this.postMessage(
       createFirmwareMessage(FIRMWARE.RELEASE_INFO, {
@@ -300,10 +318,6 @@ export abstract class BaseMethod<Params = undefined> {
     const firmwareVersion = this.device.getCurrentFirmwareVersionString() ?? '0.0.0';
     const versionRange = this.device.getCurrentMethodVersionRange(type => getVersionRange()[type]);
 
-    if (isMethodVersionRangeUnsupported(versionRange)) {
-      throw createDeviceNotSupportMethodError(this.name, this.device.getCurrentFirmwareType());
-    }
-
     if (!versionRange) {
       if (options?.strictCheckDeviceSupport) {
         throw createDeviceNotSupportMethodError(this.name, this.device.getCurrentFirmwareType());
@@ -359,10 +373,10 @@ export abstract class BaseMethod<Params = undefined> {
     if (this.shouldPromptSafetyCheckForEvmLedgerLegacyPath()) {
       checkFlag = true;
     }
-    if (checkFlag && this.device.getCurrentSafetyChecks() === 'Strict') {
+    if (checkFlag && this.device.getCurrentSafetyChecks() === Enum_SafetyCheckLevel.Strict) {
       Log.debug('will change safety_checks level');
       await this.device.commands.typedCall('ApplySettings', 'Success', {
-        safety_checks: 'PromptTemporarily',
+        safety_checks: Enum_SafetyCheckLevel.PromptTemporarily,
       });
       this.temporarySafetyCheckPrompted = true;
       return true;