@onekeyfe/hd-core 1.2.0-alpha.2 → 1.2.0-alpha.20

package/src/types/api/index.ts

@@ -1,34 +1,28 @@
 import type {
+  deviceFactoryInfoGet,
+  deviceFactoryInfoSet,
   deviceFirmwareUpdate,
-  deviceGetDeviceInfo,
   deviceGetFirmwareUpdateStatus,
   deviceGetOnboardingStatus,
+  deviceInfoGet,
   deviceReboot,
-  devFirmwareUpdate,
-  devGetDeviceInfo,
-  devGetFirmwareUpdateStatus,
-  devReboot,
+  deviceSettingsGet,
+  deviceSettingsPageShow,
+  deviceSettingsSet,
+  deviceStatusGet,
+  deviceUploadWallpaper,
   dirList,
   dirMake,
   dirRemove,
-  factoryDeviceInfoSettings,
-  factoryGetDeviceInfo,
   fileDelete,
   fileRead,
   fileWrite,
-  filesystemDirList,
-  filesystemDirMake,
-  filesystemDirRemove,
-  filesystemDiskControl,
-  filesystemFileDelete,
-  filesystemFileRead,
-  filesystemFileWrite,
-  filesystemFixPermission,
   filesystemFormat,
-  filesystemPathInfoQuery,
-  getProtoVersion,
+  filesystemPermissionFix,
   pathInfo,
   ping,
+  protocolInfoRequest,
+  uploadPortfolio,
 } from './protocolV2';
 import type { off, on, removeAllListeners } from './event';
 import type { uiResponse } from './uiResponse';
@@ -36,6 +30,7 @@ import type { init, updateSettings } from './init';
 import type { testInitializeDeviceDuration } from './testInitializeDeviceDuration';
 import type { preInitialize } from './preInitialize';
 import type { getLogs } from './getLogs';
+import type { clearSessionCache } from './sessionCache';
 import type { checkBridgeStatus } from './checkBridgeStatus';
 import type { checkBridgeRelease } from './checkBridgeRelease';
 import type { checkBootloaderRelease } from './checkBootloaderRelease';
@@ -43,9 +38,10 @@ import type { checkAllFirmwareRelease } from './checkAllFirmwareRelease';
 import type { checkFirmwareTypeAvailable } from './checkFirmwareTypeAvailable';
 import type { searchDevices } from './searchDevices';
 import type { getFeatures } from './getFeatures';
-import type { getDeviceInfo } from './getDeviceInfo';
+import type { getDeviceState } from './getDeviceState';
 import type { getOnekeyFeatures } from './getOnekeyFeatures';
 import type { getPassphraseState } from './getPassphraseState';
+import type { openWalletSession } from './openWalletSession';
 import type { checkFirmwareRelease } from './checkFirmwareRelease';
 import type { checkBLEFirmwareRelease } from './checkBLEFirmwareRelease';
 import type {
@@ -169,19 +165,10 @@ import type { neoSignTransaction } from './neoSignTransaction';
 import type { ConnectSettings } from '../settings';
 
 export * from './export';
-export type {
-  DeviceInfoMode,
-  DeviceInfoProtocol,
-  DeviceInfoScope,
-  DeviceInfoSource,
-  DeviceInfoStatus,
-  DeviceProfile,
-  GetDeviceInfoParams,
-  DeviceProfileRaw,
-  DeviceProfileVerify,
-  DeviceProfileVersions,
-} from './getDeviceInfo';
-export type { GetPassphraseStateParams, GetPassphraseStatePayload } from './getPassphraseState';
+export type { DeviceStateScope, GetDeviceStateParams } from './getDeviceState';
+export type { GetPassphraseStateParams } from './getPassphraseState';
+export type { OpenWalletSessionParams, OpenWalletSessionPayload } from './openWalletSession';
+export type { ClearSessionCacheParams, ClearSessionCachePayload } from './sessionCache';
 
 export type CoreApi = {
   /**
@@ -192,13 +179,15 @@ export type CoreApi = {
   off: typeof off;
   emit: (event: string, ...args: any[]) => void;
   removeAllListeners: typeof removeAllListeners;
-  dispose: () => void;
+  dispose: () => void | Promise<void>;
   call: (params: any) => Promise<any>;
   uiResponse: typeof uiResponse;
   cancel: (connectId?: string) => void;
+  cancelOperation: (operationId: string) => void;
   updateSettings: typeof updateSettings;
   switchTransport: (env: ConnectSettings['env']) => Promise<{ success: boolean }>;
   getLogs: typeof getLogs;
+  clearSessionCache: typeof clearSessionCache;
 
   /**
    * Test function
@@ -221,9 +210,10 @@ export type CoreApi = {
   searchDevices: typeof searchDevices;
   promptWebDeviceAccess: typeof promptWebDeviceAccess;
   getFeatures: typeof getFeatures;
-  getDeviceInfo: typeof getDeviceInfo;
+  getDeviceState: typeof getDeviceState;
   getOnekeyFeatures: typeof getOnekeyFeatures;
   getPassphraseState: typeof getPassphraseState;
+  openWalletSession: typeof openWalletSession;
   deviceBackup: typeof deviceBackup;
   deviceChangePin: typeof deviceChangePin;
   deviceFlags: typeof deviceFlags;
@@ -253,22 +243,25 @@ export type CoreApi = {
   cipherKeyValue: typeof cipherKeyValue;
 
   /**
-   * File system & device control API (Protocol V2 only)
+   * Pro2 business API
    */
-  getProtoVersion: typeof getProtoVersion;
-  ping: typeof ping;
   deviceReboot: typeof deviceReboot;
-  deviceGetDeviceInfo: typeof deviceGetDeviceInfo;
   deviceGetOnboardingStatus: typeof deviceGetOnboardingStatus;
+  deviceUploadWallpaper: typeof deviceUploadWallpaper;
+  deviceInfoGet: typeof deviceInfoGet;
+  deviceStatusGet: typeof deviceStatusGet;
+  deviceSettingsGet: typeof deviceSettingsGet;
+  protocolInfoRequest: typeof protocolInfoRequest;
+  ping: typeof ping;
   deviceFirmwareUpdate: typeof deviceFirmwareUpdate;
   deviceGetFirmwareUpdateStatus: typeof deviceGetFirmwareUpdateStatus;
-  devReboot: typeof devReboot;
-  devGetDeviceInfo: typeof devGetDeviceInfo;
-  devFirmwareUpdate: typeof devFirmwareUpdate;
-  devGetFirmwareUpdateStatus: typeof devGetFirmwareUpdateStatus;
-  factoryDeviceInfoSettings: typeof factoryDeviceInfoSettings;
-  factoryGetDeviceInfo: typeof factoryGetDeviceInfo;
-  filesystemFixPermission: typeof filesystemFixPermission;
+  deviceFactoryInfoSet: typeof deviceFactoryInfoSet;
+  deviceFactoryInfoGet: typeof deviceFactoryInfoGet;
+  deviceSettingsSet: typeof deviceSettingsSet;
+  deviceSettingsPageShow: typeof deviceSettingsPageShow;
+  filesystemPermissionFix: typeof filesystemPermissionFix;
+  filesystemFormat: typeof filesystemFormat;
+  uploadPortfolio: typeof uploadPortfolio;
   fileRead: typeof fileRead;
   fileWrite: typeof fileWrite;
   fileDelete: typeof fileDelete;
@@ -276,15 +269,6 @@ export type CoreApi = {
   dirMake: typeof dirMake;
   dirRemove: typeof dirRemove;
   pathInfo: typeof pathInfo;
-  filesystemFileRead: typeof filesystemFileRead;
-  filesystemFileWrite: typeof filesystemFileWrite;
-  filesystemFileDelete: typeof filesystemFileDelete;
-  filesystemDirList: typeof filesystemDirList;
-  filesystemDirMake: typeof filesystemDirMake;
-  filesystemDirRemove: typeof filesystemDirRemove;
-  filesystemPathInfoQuery: typeof filesystemPathInfoQuery;
-  filesystemFormat: typeof filesystemFormat;
-  filesystemDiskControl: typeof filesystemDiskControl;
 
   /**
    * All network function

package/src/types/api/kaspaSignTransaction.ts

@@ -13,15 +13,47 @@ export type KaspaSignInputParams = {
   sequenceNumber: number | string;
   output: {
     satoshis: number | string;
-    script: string;
+    // Required by the legacy host-prehash flow; unused by the streaming protocol.
+    script?: string;
   };
   sigOpCount?: number;
 };
 
 export type KaspaSignOutputParams = {
   satoshis: number | string;
+  // Streaming protocol describes outputs by address; the device builds the script itself.
+  // `address` for an external output, `addressN` (BIP-32 path) for a change output.
+  address?: string;
+  addressN?: string | number[];
+  // Legacy host-prehash fields, unused by the streaming protocol but kept for compatibility.
+  script?: string;
+  scriptVersion?: number;
+};
+
+// Referenced (previous) transactions for the streaming protocol's input
+// verification: the device may ask for the transactions the inputs spend from
+// (selected by prev_tx_id) to verify input amounts on-device.
+export type KaspaRefTransactionInput = {
+  prevTxId: string;
+  outputIndex: number;
+  sequenceNumber: number | string;
+};
+
+export type KaspaRefTransactionOutput = {
+  satoshis: number | string;
+  scriptVersion?: number;
   script: string;
-  scriptVersion: number;
+};
+
+export type KaspaRefTransaction = {
+  txId: string;
+  version: number;
+  inputs: KaspaRefTransactionInput[];
+  outputs: KaspaRefTransactionOutput[];
+  lockTime?: number | string;
+  subNetworkID?: string;
+  gas?: number | string;
+  payload?: string;
 };
 
 export type KaspaSignTransactionParams = {
@@ -32,6 +64,12 @@ export type KaspaSignTransactionParams = {
   sigHashType?: SignatureType;
   sigOpCount?: number;
   subNetworkID?: string;
+  // Optional transaction payload (hex), streamed to the device in chunks.
+  payload?: string;
+  gas?: number | string;
+  // Previous transactions referenced by the inputs, required only when the
+  // device requests them for on-device input-amount verification.
+  refTxs?: KaspaRefTransaction[];
   scheme?: string;
   prefix?: string;
   useTweak?: boolean; // default is true

package/src/types/api/openWalletSession.ts

@@ -0,0 +1,64 @@
+import type { CommonParams, Response } from '../params';
+
+export type OpenWalletSessionParams =
+  | {
+      mode: 'standard';
+      deviceId?: never;
+      passphraseState?: never;
+      useEmptyPassphrase?: never;
+      initSession?: never;
+    }
+  | {
+      mode: 'select-hidden';
+      deviceId?: never;
+      passphraseState?: never;
+      useEmptyPassphrase?: never;
+      initSession?: never;
+    }
+  | {
+      mode: 'resume-hidden';
+      deviceId: string;
+      passphraseState: string;
+      useEmptyPassphrase?: never;
+      initSession?: never;
+    }
+  | {
+      /**
+       * Compatibility form. `useEmptyPassphrase: true` opens the standard wallet;
+       * otherwise `initSession: true` starts a fresh hidden-wallet selection, a
+       * complete wallet binding resumes a hidden wallet, and no binding starts the
+       * hidden-wallet selection flow.
+       */
+      mode?: undefined;
+      useEmptyPassphrase?: boolean;
+      initSession?: boolean;
+      deviceId?: string;
+      passphraseState?: string;
+    };
+
+type OpenWalletSessionPayloadBase = {
+  protocol: 'V1' | 'V2';
+  deviceId: string;
+  resumed: boolean;
+};
+
+export type OpenWalletSessionPayload = OpenWalletSessionPayloadBase &
+  (
+    | {
+        walletType: 'standard';
+        passphraseState: null;
+      }
+    | {
+        walletType: 'hidden';
+        passphraseState: string;
+      }
+  );
+
+/**
+ * Opens the standard, hidden, or Attach-to-PIN wallet flow through a unified
+ * Protocol V1/V2 API.
+ */
+export declare function openWalletSession(
+  connectId: string,
+  params: CommonParams & OpenWalletSessionParams
+): Response<OpenWalletSessionPayload>;

package/src/types/api/protocolV2.ts

@@ -1,33 +1,51 @@
 import type { CommonParams, Response } from '../params';
 import type {
+  DevOnboardingStatus,
+  DeviceFactoryInfo,
   DeviceFirmwareUpdateStatus,
-  DevFirmwareUpdateStatus,
-  FactoryDeviceInfo,
-  OnboardingStatus,
-  ProtoVersion,
+  DeviceSettings,
+  DeviceStatus,
+  ProtocolInfo,
   ProtocolV2DeviceInfo,
   Success,
 } from '@onekeyfe/hd-transport';
 import type {
+  DeviceFactoryInfoSetParams,
   DeviceFirmwareUpdateParams,
+  DeviceFirmwareUpdateStatusGetParams,
   DeviceRebootParams,
-  FactoryDeviceInfoSettingsParams,
 } from '../../api/protocol-v2/helpers';
-import type { DeviceGetDeviceInfoParams } from '../../api/protocol-v2/DeviceGetDeviceInfo';
+import type { DeviceInfoGetParams } from '../../api/protocol-v2/DeviceInfoGet';
+import type { DeviceSettingsSetParams } from '../../api/protocol-v2/DeviceSettingsSet';
+import type { DeviceSettingsPageShowParams } from '../../api/protocol-v2/DeviceSettingsPageShow';
+import type {
+  DeviceUploadWallpaperParams,
+  DeviceUploadWallpaperResponse,
+} from '../../api/protocol-v2/DeviceUploadWallpaper';
 
-// 参数类型单源：以 api/protocol-v2 的实现为准（type-only re-export，无运行时依赖）
+// Re-export implementation parameter types as the single source of truth.
 export type {
   DeviceFirmwareTargetInput,
   DeviceFirmwareUpdateParams,
+  DeviceFirmwareUpdateStatusGetParams,
   DeviceRebootParams,
-  FactoryDeviceInfoSettingsParams,
+  DeviceFactoryInfoSetParams,
   RebootTypeInput,
 } from '../../api/protocol-v2/helpers';
 export type {
-  DeviceGetDeviceInfoParams,
-  DeviceGetDeviceInfoTargets,
-  DeviceGetDeviceInfoTypes,
-} from '../../api/protocol-v2/DeviceGetDeviceInfo';
+  DeviceInfoGetParams,
+  DeviceInfoGetTargets,
+  DeviceInfoGetTypes,
+} from '../../api/protocol-v2/DeviceInfoGet';
+export type { DeviceSettingsSetParams } from '../../api/protocol-v2/DeviceSettingsSet';
+export type {
+  DeviceSettingsPageShowParams,
+  SupportedDeviceSettingsPage,
+} from '../../api/protocol-v2/DeviceSettingsPageShow';
+export type {
+  DeviceUploadWallpaperParams,
+  DeviceUploadWallpaperResponse,
+} from '../../api/protocol-v2/DeviceUploadWallpaper';
 
 // ── Shared response shapes (Protocol V2 file system) ────────────────────
 
@@ -49,7 +67,7 @@ export type DirInfo = {
   child_files?: string;
 };
 
-// proto 中 FilesystemPathInfo 的全部字段均为 required，类型与之保持一致
+// All FilesystemPathInfo proto fields are required; keep this type aligned.
 export type PathInfoResult = {
   exist: boolean;
   size: number;
@@ -68,10 +86,29 @@ export type PathInfoResult = {
 
 // ── Method signatures ─────────────────────────────────────────────────────
 
-export declare function getProtoVersion(
+/** @deprecated Development-only raw Protocol V2 command. Use `getDeviceState`. */
+export declare function deviceInfoGet(
+  connectId: string,
+  params?: CommonParams & DeviceInfoGetParams
+): Response<ProtocolV2DeviceInfo>;
+
+/** @deprecated Development-only raw Protocol V2 command. Use `getDeviceState`. */
+export declare function deviceStatusGet(
+  connectId: string,
+  params?: CommonParams
+): Response<DeviceStatus>;
+
+/** @deprecated Development-only raw Protocol V2 command. Use `getDeviceState`. */
+export declare function deviceSettingsGet(
   connectId: string,
   params?: CommonParams
-): Response<ProtoVersion>;
+): Response<DeviceSettings>;
+
+/** @deprecated Development-only raw Protocol V2 command. */
+export declare function protocolInfoRequest(
+  connectId: string,
+  params?: CommonParams
+): Response<ProtocolInfo>;
 
 export declare function ping(
   connectId: string,
@@ -83,54 +120,56 @@ export declare function deviceReboot(
   params: CommonParams & DeviceRebootParams
 ): Response<Success>;
 
-export declare function deviceGetDeviceInfo(
-  connectId: string,
-  params?: CommonParams & DeviceGetDeviceInfoParams
-): Response<ProtocolV2DeviceInfo>;
-
 export declare function deviceGetOnboardingStatus(
   connectId: string,
   params?: CommonParams
-): Response<OnboardingStatus>;
+): Response<DevOnboardingStatus>;
 
 export declare function deviceFirmwareUpdate(
   connectId: string,
   params: CommonParams & DeviceFirmwareUpdateParams
-): Response<Success | DevFirmwareUpdateStatus | DeviceFirmwareUpdateStatus>;
+): Response<Success | DeviceFirmwareUpdateStatus>;
 
 export declare function deviceGetFirmwareUpdateStatus(
   connectId: string,
-  params?: CommonParams
-): Response<DevFirmwareUpdateStatus | DeviceFirmwareUpdateStatus>;
+  params?: CommonParams & DeviceFirmwareUpdateStatusGetParams
+): Response<DeviceFirmwareUpdateStatus>;
 
-export declare function devReboot(
+export declare function deviceFactoryInfoSet(
   connectId: string,
-  params: CommonParams & DeviceRebootParams
+  params: CommonParams & DeviceFactoryInfoSetParams
 ): Response<Success>;
 
-export declare function devGetDeviceInfo(
+export declare function deviceFactoryInfoGet(
   connectId: string,
-  params?: CommonParams & DeviceGetDeviceInfoParams
-): Response<ProtocolV2DeviceInfo>;
-
-export declare function devFirmwareUpdate(
-  connectId: string,
-  params: CommonParams & DeviceFirmwareUpdateParams
-): Response<Success | DevFirmwareUpdateStatus>;
+  params?: CommonParams
+): Response<DeviceFactoryInfo>;
 
-export declare function devGetFirmwareUpdateStatus(
+/**
+ * @deprecated Use the protocol-independent `deviceSettings`.
+ */
+export declare function deviceSettingsSet(
   connectId: string,
-  params?: CommonParams
-): Response<DevFirmwareUpdateStatus>;
+  params: CommonParams & DeviceSettingsSetParams
+): Response<Success>;
 
-export declare function factoryDeviceInfoSettings(
+/**
+ * @deprecated Use `deviceSettings`, `deviceChangePin`, or `deviceWipe`.
+ */
+export declare function deviceSettingsPageShow(
   connectId: string,
-  params: FactoryDeviceInfoSettingsParams
+  params: CommonParams & DeviceSettingsPageShowParams
 ): Response<Success>;
 
-export declare function factoryGetDeviceInfo(connectId: string): Response<FactoryDeviceInfo>;
+export declare function deviceUploadWallpaper(
+  connectId: string,
+  params: CommonParams & DeviceUploadWallpaperParams
+): Response<DeviceUploadWallpaperResponse>;
 
-export declare function filesystemFixPermission(connectId: string): Response<Success>;
+export declare function filesystemPermissionFix(
+  connectId: string,
+  params?: CommonParams
+): Response<Success>;
 
 export declare function fileRead(
   connectId: string,
@@ -184,18 +223,13 @@ export declare function pathInfo(
   params: { path: string; timeoutMs?: number | string }
 ): Response<PathInfoResult>;
 
-export declare const filesystemFileRead: typeof fileRead;
-export declare const filesystemFileWrite: typeof fileWrite;
-export declare const filesystemFileDelete: typeof fileDelete;
-export declare const filesystemDirList: typeof dirList;
-export declare const filesystemDirMake: typeof dirMake;
-export declare const filesystemDirRemove: typeof dirRemove;
-export declare const filesystemPathInfoQuery: typeof pathInfo;
+export declare function uploadPortfolio(
+  connectId: string,
+  params: {
+    operationId?: string;
+    packageBytes: ArrayBuffer | Uint8Array | Blob;
+    timeoutMs?: number | string;
+  }
+): Response<FileInfo & { portfolioUpdated: true }>;
 
 export declare function filesystemFormat(connectId: string): Response<Success>;
-
-export declare function filesystemDiskControl(
-  connectId: string,
-  // enable 收紧为 boolean | 0 | 1（兼容历史的 '0' / '1' 字符串输入，内部归一化为 0/1）
-  params: CommonParams & { enable: boolean | 0 | 1; timeoutMs?: number | string }
-): Response<Success>;

package/src/types/api/sessionCache.ts

@@ -0,0 +1,14 @@
+import type { Response } from '../params';
+
+export type ClearSessionCacheParams = {
+  deviceId?: string;
+  passphraseState?: string;
+};
+
+export type ClearSessionCachePayload = {
+  cleared: true;
+};
+
+export declare function clearSessionCache(
+  params?: ClearSessionCacheParams
+): Response<ClearSessionCachePayload>;