@onekeyfe/hd-core 1.1.28 → 1.2.0-alpha.1

package/src/api/evm/latest/signTypedHash.ts

@@ -1,8 +1,6 @@
 import semver from 'semver';
 import { EDeviceType, ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
 
-import { getDeviceFirmwareVersion, getDeviceType } from '../../../utils';
-
 import type { Device } from '../../../device/Device';
 import type { MessageResponse, TypedCall } from '@onekeyfe/hd-transport';
 
@@ -21,10 +19,10 @@ export const signTypedHash = async ({
   domainHash: string;
   messageHash: string | undefined;
 }): Promise<MessageResponse<'EthereumTypedDataSignatureOneKey'>> => {
-  const deviceType = getDeviceType(device.features);
+  const deviceType = device.getCurrentDeviceType();
   if (deviceType === EDeviceType.Touch || deviceType === EDeviceType.Pro) {
     // Touch Pro Sign NestedArrays
-    const currentVersion = getDeviceFirmwareVersion(device.features).join('.');
+    const currentVersion = device.getCurrentFirmwareVersionString() ?? '0.0.0';
     const supportNestedArraysSignVersion = '4.2.0';
 
     // 4.2.0 is the first version that supports nested arrays in signTypedData

package/src/api/evm/legacyV1/getAddress.ts

@@ -7,10 +7,12 @@ export default async function ({
   typedCall: TypedCall;
   param: EthereumGetAddressOneKey;
 }): Promise<MessageResponse<'EthereumAddress'>> {
-  return typedCall('EthereumGetAddress', 'EthereumAddress', {
+  // legacy EthereumGetAddress 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
+  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  const message = {
     address_n: param.address_n,
     show_display: param.show_display,
-    // @ts-ignore
     chain_id: param.chain_id,
-  });
+  };
+  return typedCall('EthereumGetAddress', 'EthereumAddress', message);
 }

package/src/api/evm/legacyV1/getPublicKey.ts

@@ -11,10 +11,12 @@ export default async function ({
   typedCall: TypedCall;
   param: EthereumGetPublicKeyOneKey;
 }): Promise<MessageResponse<'EthereumPublicKey'>> {
-  return typedCall('EthereumGetPublicKey', 'EthereumPublicKey', {
+  // legacy EthereumGetPublicKey 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
+  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  const message = {
     address_n: param.address_n,
     show_display: param.show_display,
-    // @ts-ignore
     chain_id: param.chain_id,
-  });
+  };
+  return typedCall('EthereumGetPublicKey', 'EthereumPublicKey', message);
 }

package/src/api/evm/legacyV1/signMessage.ts

@@ -11,12 +11,14 @@ export default async function ({
   typedCall: TypedCall;
   params: EthereumSignMessageOneKey;
 }): Promise<EthereumMessageSignature> {
-  const res = await typedCall('EthereumSignMessage', 'EthereumMessageSignature', {
+  // legacy EthereumSignMessage 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
+  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  const message = {
     address_n: params.address_n,
     message: params.message,
-    // @ts-ignore
     chain_id: params.chain_id,
-  });
+  };
+  const res = await typedCall('EthereumSignMessage', 'EthereumMessageSignature', message);
 
   return Promise.resolve(res.message);
 }

package/src/api/evm/legacyV1/signTypedData.ts

@@ -16,22 +16,23 @@ export const signTypedData = async ({
 }) => {
   const { primaryType }: EthereumSignTypedDataMessage<EthereumSignTypedDataTypes> = data;
 
+  // legacy EthereumSignTypedData 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
+  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  const message = {
+    address_n: addressN,
+    primary_type: primaryType as string,
+    metamask_v4_compat: metamaskV4Compat,
+    chain_id: chainId,
+  };
   const response = await typedCall(
     'EthereumSignTypedData',
-    // @ts-ignore
     [
       'EthereumTypedDataStructRequest',
       'EthereumTypedDataValueRequest',
       'EthereumTypedDataSignature',
       'EthereumGnosisSafeTxRequest',
     ],
-    {
-      address_n: addressN,
-      primary_type: primaryType as string,
-      metamask_v4_compat: metamaskV4Compat,
-      // @ts-ignore
-      chain_id: chainId,
-    }
+    message
   );
   return response;
 };

package/src/api/evm/legacyV1/signTypedHash.ts

@@ -1,8 +1,6 @@
 import semver from 'semver';
 import { EDeviceType, ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
 
-import { getDeviceFirmwareVersion, getDeviceType } from '../../../utils';
-
 import type { Device } from '../../../device/Device';
 import type { MessageResponse, TypedCall } from '@onekeyfe/hd-transport';
 
@@ -24,10 +22,10 @@ export const signTypedHash = async ({
   | MessageResponse<'EthereumTypedDataSignature'>
   | MessageResponse<'EthereumTypedDataSignatureOneKey'>
 > => {
-  const deviceType = getDeviceType(device.features);
+  const deviceType = device.getCurrentDeviceType();
   if (deviceType === EDeviceType.Touch || deviceType === EDeviceType.Pro) {
     // Touch Pro Sign NestedArrays
-    const currentVersion = getDeviceFirmwareVersion(device.features).join('.');
+    const currentVersion = device.getCurrentFirmwareVersionString() ?? '0.0.0';
     const supportNestedArraysSignVersion = '4.2.0';
 
     // 4.2.0 is the first version that supports nested arrays in signTypedData
@@ -40,11 +38,13 @@ export const signTypedHash = async ({
     }
   }
 
-  return typedCall('EthereumSignTypedHash', 'EthereumTypedDataSignature', {
+  // legacy EthereumSignTypedHash 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
+  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  const message = {
     address_n: addressN,
     domain_separator_hash: domainHash ?? '',
     message_hash: messageHash,
-    // @ts-ignore
     chain_id: chainId,
-  });
+  };
+  return typedCall('EthereumSignTypedHash', 'EthereumTypedDataSignature', message);
 };

package/src/api/evm/legacyV1/verifyMessage.ts

@@ -7,13 +7,15 @@ export default async function ({
   typedCall: TypedCall;
   params: EthereumVerifyMessageOneKey;
 }): Promise<Success> {
-  const res = await typedCall('EthereumVerifyMessage', 'Success', {
+  // legacy EthereumVerifyMessage 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
+  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  const message = {
     signature: params.signature,
     message: params.message,
     address: params.address,
-    // @ts-ignore
     chain_id: params.chain_id,
-  });
+  };
+  const res = await typedCall('EthereumVerifyMessage', 'Success', message);
 
   return Promise.resolve(res.message);
 }

package/src/api/firmware/FirmwareUpdateBaseMethod.ts

@@ -8,7 +8,7 @@ import {
 
 import { FirmwareUpdateTipMessage, UI_REQUEST, createUiMessage } from '../../events/ui-request';
 import { DevicePool } from '../../device/DevicePool';
-import { LoggerNames, getDeviceType, getDeviceUUID, getLogger, wait } from '../../utils';
+import { LoggerNames, getDeviceUUID, getLogger, wait } from '../../utils';
 import { DeviceModelToTypes } from '../../types';
 import { DataManager } from '../../data-manager';
 import { BaseMethod } from '../BaseMethod';
@@ -142,8 +142,8 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
     let timeoutTimer: ReturnType<typeof setTimeout> | undefined;
 
     const isTouchOrProDevice =
-      getDeviceType(this?.device?.features) === EDeviceType.Touch ||
-      getDeviceType(this?.device?.features) === EDeviceType.Pro;
+      this?.device?.getCurrentDeviceType() === EDeviceType.Touch ||
+      this?.device?.getCurrentDeviceType() === EDeviceType.Pro;
 
     const intervalTimer: ReturnType<typeof setInterval> | undefined = setInterval(
       async () => {
@@ -187,7 +187,7 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
               true
             );
             await this.device.initialize();
-            if (this.device.features?.bootloader_mode) {
+            if (this.device.isBootloader()) {
               clearInterval(intervalTimer);
               this.checkPromise?.resolve(true);
             }
@@ -220,7 +220,7 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
     const devicesDescriptor = deviceDiff?.descriptors ?? [];
     const { deviceList } = await DevicePool.getDevices(devicesDescriptor, connectId);
 
-    if (deviceList.length === 1 && deviceList[0]?.features?.bootloader_mode) {
+    if (deviceList.length === 1 && deviceList[0]?.isBootloader()) {
       // should update current device from cache
       // because device was reboot and had some new requests
       this.device.updateFromCache(deviceList[0]);
@@ -236,9 +236,9 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
 
   async enterBootloaderMode() {
     const typedCall = this.device.getCommands().typedCall.bind(this.device.getCommands());
-    if (this.device.features && !this.device.features.bootloader_mode) {
+    if (this.device.features && !this.device.isBootloader()) {
       const uuid = getDeviceUUID(this.device.features);
-      const deviceType = getDeviceType(this.device.features);
+      const deviceType = this.device.getCurrentDeviceType();
       // auto go to bootloader mode
       try {
         this.postTipMessage(FirmwareUpdateTipMessage.AutoRebootToBootloader);
@@ -436,7 +436,7 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
           const deviceDiff = await this.device.deviceConnector?.enumerate();
           const devicesDescriptor = deviceDiff?.descriptors ?? [];
           const { deviceList } = await DevicePool.getDevices(devicesDescriptor, undefined);
-          if (deviceList.length === 1 && deviceList[0]?.features?.bootloader_mode) {
+          if (deviceList.length === 1 && deviceList[0]?.isBootloader()) {
             this.device.updateFromCache(deviceList[0]);
             await this.device.acquire();
             this.device.getCommands().mainId = this.device.mainId ?? '';

package/src/api/firmware/bootloaderHelper.ts

@@ -1,7 +1,7 @@
 import semver from 'semver';
 import { EDeviceType } from '@onekeyfe/hd-shared';
 
-import { getDeviceType } from '../../utils';
+import { getDeviceBootloaderVersion, getDeviceType } from '../../utils';
 
 import type { Features, IVersionArray } from '../../types';
 
@@ -38,9 +38,10 @@ export function shouldUpdateBootloaderForClassicAndMini({
 export function isEnteredManuallyBoot(features: Features, updateType: string) {
   const deviceType = getDeviceType(features);
   const isMini = deviceType === EDeviceType.Mini;
+  const bootloaderVersion = getDeviceBootloaderVersion(features).join('.');
   const isBoot183ClassicUpBle =
     updateType === 'firmware' &&
     deviceType === EDeviceType.Classic &&
-    features.bootloader_version === '1.8.3';
+    bootloaderVersion === '1.8.3';
   return isMini || isBoot183ClassicUpBle;
 }

package/src/api/firmware/getBinary.ts

@@ -41,7 +41,7 @@ export const getBinary = async ({
   }
 
   if (version && !semver.eq(releaseInfo.version.join('.'), version.join('.'))) {
-    const touchWithoutVersion = getDeviceType(features) === 'touch' && !features.onekey_version;
+    const touchWithoutVersion = getDeviceType(features) === 'touch' && !features.firmwareVersion;
     if (!touchWithoutVersion) {
       throw ERRORS.TypedError(HardwareErrorCode.RuntimeError, 'firmware version mismatch');
     }

package/src/api/firmware/releaseHelper.ts

@@ -12,7 +12,7 @@ export const getFirmwareReleaseInfo = (features: Features, firmwareType: EFirmwa
   const firmwareStatus = DataManager.getFirmwareStatus(features, firmwareType);
   const changelog = DataManager.getFirmwareChangelog(features, firmwareType);
   const release = DataManager.getFirmwareLatestRelease(features, firmwareType);
-  const bootloaderMode = !!features.bootloader_mode;
+  const bootloaderMode = !!features.bootloaderMode;
   return {
     status: firmwareStatus,
     changelog,
@@ -25,7 +25,7 @@ export const getBleFirmwareReleaseInfo = (features: Features) => {
   const firmwareStatus = DataManager.getBLEFirmwareStatus(features);
   const changelog = DataManager.getBleFirmwareChangelog(features);
   const release = DataManager.getBleFirmwareLatestRelease(features);
-  const bootloaderMode = !!features.bootloader_mode;
+  const bootloaderMode = !!features.bootloaderMode;
   return {
     status: firmwareStatus,
     changelog,
@@ -52,7 +52,7 @@ export const getBootloaderReleaseInfo = ({
       Object.prototype.hasOwnProperty.call(item, 'en-US')
   );
 
-  const bootloaderMode = !!features.bootloader_mode;
+  const bootloaderMode = !!features.bootloaderMode;
 
   let shouldUpdate = false;
 

package/src/api/firmware/uploadFirmware.ts

@@ -3,19 +3,13 @@ import { blake2s } from '@noble/hashes/blake2s';
 import JSZip from 'jszip';
 import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
 
-import { getDeviceFirmwareVersion } from '../../utils/deviceVersionUtils';
-import {
-  LoggerNames,
-  getDeviceBootloaderVersion,
-  getDeviceType,
-  getLogger,
-  wait,
-} from '../../utils';
+import { LoggerNames, getDeviceBootloaderVersion, getLogger, wait } from '../../utils';
 import { DEVICE, UI_REQUEST, createUiMessage } from '../../events';
 import { DeviceModelToTypes } from '../../types';
 import { bytesToHex } from '../helpers/hexUtils';
 import { DataManager } from '../../data-manager';
 import { DevicePool } from '../../device/DevicePool';
+import { buildProtocolV1FeaturesPayload } from '../../deviceProfile';
 
 import type { KnownDevice } from '../../types';
 import type { TypedCall, TypedResponseMessage } from '../../device/DeviceCommands';
@@ -41,7 +35,7 @@ const isDeviceDisconnectedError = (error: unknown) => {
 
 const postConfirmationMessage = (device: Device) => {
   // only if firmware is already installed. fresh device does not require button confirmation
-  if (device.features?.firmware_present) {
+  if (device.features?.firmwarePresent) {
     device.emit(DEVICE.BUTTON, device, { code: 'ButtonRequest_FirmwareUpdate' });
   }
 };
@@ -107,7 +101,7 @@ export const uploadFirmware = async (
   },
   isUpdateBootloader?: boolean
 ) => {
-  const deviceType = getDeviceType(device.features);
+  const deviceType = device.getCurrentDeviceType();
   if (DeviceModelToTypes.model_mini.includes(deviceType)) {
     postConfirmationMessage(device);
     postProgressTip(device, 'ConfirmOnDevice', postMessage);
@@ -116,7 +110,9 @@ export const uploadFirmware = async (
 
     if (isFirmware && !isUpdateBootloader) {
       const newFeatures = await typedCall('GetFeatures', 'Features', {});
-      const deviceBootloaderVersion = getDeviceBootloaderVersion(newFeatures.message).join('.');
+      const deviceBootloaderVersion = getDeviceBootloaderVersion(
+        buildProtocolV1FeaturesPayload(newFeatures.message, device.features)
+      ).join('.');
       const supportUpgradeFileHeader = semver.gte(deviceBootloaderVersion, '2.1.0');
       Log.debug('supportUpgradeFileHeader:', supportUpgradeFileHeader);
 
@@ -429,7 +425,7 @@ const emmcFileWriteWithRetry = async (
         const deviceDiff = await device.deviceConnector?.enumerate();
         const devicesDescriptor = deviceDiff?.descriptors ?? [];
         const { deviceList } = await DevicePool.getDevices(devicesDescriptor, undefined);
-        if (deviceList.length === 1 && deviceList[0]?.features?.bootloader_mode) {
+        if (deviceList.length === 1 && deviceList[0]?.isBootloader()) {
           device.updateFromCache(deviceList[0]);
           await device.acquire();
           device.getCommands().mainId = device.mainId ?? '';

package/src/api/helpers/batchGetPublickeys.ts

@@ -1,18 +1,63 @@
+import semver from 'semver';
 import {
+  EDeviceType,
   HardwareErrorCode,
   TypedError,
   createDeviceNotSupportMethodError,
 } from '@onekeyfe/hd-shared';
 
-import { supportBatchPublicKey } from '../../utils/deviceFeaturesUtils';
 import { isEqualBip44CoinType } from './pathUtils';
 import { splitArray } from '../../utils/arrayUtils';
-import { getDeviceType, getFirmwareType } from '../../utils';
 import { DeviceModelToTypes } from '../../types';
 
 import type { EcdsaPublicKeys, Path } from '@onekeyfe/hd-transport';
 import type { Device } from '../../device/Device';
 
+/**
+ * Protocol-agnostic version of `supportBatchPublicKey` (utils/deviceFeaturesUtils):
+ * derives device type and firmware version through Device accessors so that
+ * Protocol V2 devices (features === undefined, profile set) resolve correctly.
+ */
+export function supportBatchPublicKeyByDevice(
+  device: Device,
+  options?: {
+    includeNode?: boolean;
+  }
+): boolean {
+  const currentVersion = device.getCurrentFirmwareVersionString() ?? '0.0.0';
+  const deviceType = device.getCurrentDeviceType();
+
+  // Pro2 (Protocol V2) 版本线独立于 Pro 系列，固件从首个版本即支持 batch / include_node，
+  // 不能套用下面 Pro 系列的 4.x 门槛。
+  if (device.isProtocolV2() || deviceType === EDeviceType.Pro2) {
+    return true;
+  }
+
+  // btc batch get public key
+  if (!!options?.includeNode && deviceType === EDeviceType.Pro) {
+    return semver.gte(currentVersion, '4.14.0');
+  }
+  if (!!options?.includeNode && deviceType === EDeviceType.Touch) {
+    return semver.gte(currentVersion, '4.11.0');
+  }
+  if (!!options?.includeNode && DeviceModelToTypes.model_classic1s.includes(deviceType)) {
+    return semver.gte(currentVersion, '3.12.0');
+  }
+  if (!!options?.includeNode && DeviceModelToTypes.model_mini.includes(deviceType)) {
+    return semver.gte(currentVersion, '3.10.0');
+  }
+  if (options?.includeNode) {
+    return false;
+  }
+
+  // support batch get public key
+  if (deviceType === EDeviceType.Touch || deviceType === EDeviceType.Pro) {
+    return semver.gte(currentVersion, '3.1.0');
+  }
+
+  return semver.gte(currentVersion, '2.6.0');
+}
+
 export async function batchGetPublickeys(
   device: Device,
   paths: Path[],
@@ -28,9 +73,9 @@ export async function batchGetPublickeys(
     throw TypedError(HardwareErrorCode.ForbiddenKeyPath, 'Path length must be greater than 3');
   }
 
-  const supportsBatchPublicKey = supportBatchPublicKey(device.features, options);
+  const supportsBatchPublicKey = supportBatchPublicKeyByDevice(device, options);
   if (!supportsBatchPublicKey) {
-    throw createDeviceNotSupportMethodError('BatchGetPublickeys', getFirmwareType(device.features));
+    throw createDeviceNotSupportMethodError('BatchGetPublickeys', device.getCurrentFirmwareType());
   }
 
   const existsPathNotEqualCoinType = paths.find(p => !isEqualBip44CoinType(p.address_n, coinType));
@@ -39,7 +84,7 @@ export async function batchGetPublickeys(
   }
 
   let batchSize = 10;
-  const deviceType = getDeviceType(device.features);
+  const deviceType = device.getCurrentDeviceType();
   if (DeviceModelToTypes.model_mini.includes(deviceType)) {
     batchSize = 10;
   } else if (DeviceModelToTypes.model_touch.includes(deviceType)) {
@@ -60,7 +105,7 @@ export async function batchGetPublickeys(
     if (res.type !== 'EcdsaPublicKeys') {
       throw createDeviceNotSupportMethodError(
         'BatchGetPublickeys',
-        getFirmwareType(device.features)
+        device.getCurrentFirmwareType()
       );
     } else {
       result.root_fingerprint = res.message.root_fingerprint;

package/src/api/helpers/filesystemValidation.ts

@@ -0,0 +1,51 @@
+import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
+
+export const invalidParameter = (message: string) =>
+  ERRORS.TypedError(HardwareErrorCode.CallMethodInvalidParameter, message);
+
+export function validateNonEmptyString(value: unknown, name: string): string {
+  if (typeof value !== 'string' || value.trim().length === 0) {
+    throw invalidParameter(`Parameter [${name}] is required and must be a non-empty string.`);
+  }
+  return value;
+}
+
+export function validateNonNegativeInteger(
+  value: unknown,
+  name: string,
+  defaultValue?: number
+): number {
+  if (value === undefined || value === null) {
+    if (defaultValue !== undefined) return defaultValue;
+    throw invalidParameter(`Missing required parameter: ${name}`);
+  }
+
+  const numeric = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+  if (typeof numeric !== 'number' || !Number.isSafeInteger(numeric) || numeric < 0) {
+    throw invalidParameter(`Parameter [${name}] must be a non-negative integer.`);
+  }
+  return numeric;
+}
+
+export function validateOptionalNonNegativeInteger(
+  value: unknown,
+  name: string
+): number | undefined {
+  if (value === undefined || value === null) return undefined;
+  return validateNonNegativeInteger(value, name);
+}
+
+export function validateOptionalPercentage(value: unknown, name: string): number | undefined {
+  const numeric = validateOptionalNonNegativeInteger(value, name);
+  if (numeric === undefined) return undefined;
+  if (numeric > 100) {
+    throw invalidParameter(`Parameter [${name}] must be between 0 and 100.`);
+  }
+  return numeric;
+}
+
+export function validateRequiredData(value: unknown, name: string): void {
+  if (value === undefined || value === null) {
+    throw invalidParameter(`Missing required parameter: ${name}`);
+  }
+}

package/src/api/index.ts

@@ -3,6 +3,7 @@ export { default as preInitialize } from './device/PreInitialize';
 
 export { default as searchDevices } from './SearchDevices';
 export { default as getFeatures } from './GetFeatures';
+export { default as getDeviceInfo } from './GetDeviceInfo';
 export { default as getOnekeyFeatures } from './GetOnekeyFeatures';
 export { default as getPassphraseState } from './GetPassphraseState';
 export { default as getLogs } from './GetLogs';
@@ -38,8 +39,41 @@ export { default as getNextU2FCounter } from './u2f/GetNextU2FCounter';
 export { default as firmwareUpdate } from './FirmwareUpdate';
 export { default as firmwareUpdateV2 } from './FirmwareUpdateV2';
 export { default as firmwareUpdateV3 } from './FirmwareUpdateV3';
+export { default as firmwareUpdateV4 } from './FirmwareUpdateV4';
 export { default as promptWebDeviceAccess } from './PromptWebDeviceAccess';
 
+// File system & device control API (Protocol V2 only)
+export { default as getProtoVersion } from './protocol-v2/GetProtoVersion';
+export { default as ping } from './protocol-v2/Ping';
+export { default as deviceReboot } from './protocol-v2/DeviceReboot';
+export { default as deviceGetDeviceInfo } from './protocol-v2/DeviceGetDeviceInfo';
+export { default as deviceGetOnboardingStatus } from './protocol-v2/DeviceGetOnboardingStatus';
+export { default as deviceFirmwareUpdate } from './protocol-v2/DeviceFirmwareUpdate';
+export { default as deviceGetFirmwareUpdateStatus } from './protocol-v2/DeviceGetFirmwareUpdateStatus';
+export { default as devReboot } from './protocol-v2/DevReboot';
+export { default as devGetDeviceInfo } from './protocol-v2/DeviceGetDeviceInfo';
+export { default as devFirmwareUpdate } from './protocol-v2/DeviceFirmwareUpdate';
+export { default as devGetFirmwareUpdateStatus } from './protocol-v2/DeviceGetFirmwareUpdateStatus';
+export { default as factoryDeviceInfoSettings } from './protocol-v2/FactoryDeviceInfoSettings';
+export { default as factoryGetDeviceInfo } from './protocol-v2/FactoryGetDeviceInfo';
+export { default as filesystemFixPermission } from './protocol-v2/FilesystemFixPermission';
+export { default as filesystemFormat } from './protocol-v2/FilesystemFormat';
+export { default as filesystemDiskControl } from './protocol-v2/FilesystemDiskControl';
+export { default as fileRead } from './FileRead';
+export { default as fileWrite } from './FileWrite';
+export { default as fileDelete } from './FileDelete';
+export { default as dirList } from './DirList';
+export { default as dirMake } from './DirMake';
+export { default as dirRemove } from './DirRemove';
+export { default as pathInfo } from './PathInfo';
+export { default as filesystemFileRead } from './FileRead';
+export { default as filesystemFileWrite } from './FileWrite';
+export { default as filesystemFileDelete } from './FileDelete';
+export { default as filesystemDirList } from './DirList';
+export { default as filesystemDirMake } from './DirMake';
+export { default as filesystemDirRemove } from './DirRemove';
+export { default as filesystemPathInfoQuery } from './PathInfo';
+
 export { default as cipherKeyValue } from './CipherKeyValue';
 
 export { default as allNetworkGetAddress } from './allnetwork/AllNetworkGetAddress';

package/src/api/kaspa/KaspaSignTransaction.ts

@@ -134,15 +134,14 @@ export default class KaspaSignTransaction extends BaseMethod<KaspaSignTransactio
 
       const response = await typedCall(
         'KaspaTxInputAck',
-        // @ts-expect-error
         ['KaspaTxInputRequest', 'KaspaSignedTx'],
         {
-          address_n: input.path,
+          // params.inputs 的 path 可能是字符串或已解析数组，统一归一为 address_n 数组
+          address_n: validatePath(input.path, 3),
           raw_message: bytesToHex(rawMessage),
         }
       );
 
-      // @ts-expect-error
       return this.processTxRequest(typedCall, response, nextIndex, signature);
     }
 
@@ -164,12 +163,12 @@ export default class KaspaSignTransaction extends BaseMethod<KaspaSignTransactio
 
     const { device, params } = this;
 
-    // @ts-expect-error
     const response = await device.commands.typedCall(
       'KaspaSignTx',
       ['KaspaTxInputRequest', 'KaspaSignedTx'],
       {
-        address_n: input.path,
+        // init() 已把 path 归一为数组，这里再过一遍 validatePath 收窄类型
+        address_n: validatePath(input.path, 3),
         raw_message: bytesToHex(rawMessage),
         scheme: params.scheme,
         prefix: params.prefix,

package/src/api/lightning/LnurlAuth.ts

@@ -32,6 +32,10 @@ export default class LnurlAuth1 extends BaseMethod<ILnurlAuth> {
       model_touch: {
         min: '4.8.0',
       },
+      pro2: {
+        min: '0.0.0',
+        unsupported: true,
+      },
     };
   }
 

package/src/api/neo/NeoGetAddress.ts

@@ -5,6 +5,7 @@ import { UI_REQUEST } from '../../constants/ui-request';
 
 import type { NeoGetAddress as HardwareNeoGetAddress } from '@onekeyfe/hd-transport';
 import type { NeoAddress, NeoGetAddressParams } from '../../types/api/neoGetAddress';
+import type { DeviceFirmwareRange } from '../../types';
 
 export default class NeoGetAddress extends BaseMethod<HardwareNeoGetAddress[]> {
   hasBundle = false;
@@ -37,8 +38,12 @@ export default class NeoGetAddress extends BaseMethod<HardwareNeoGetAddress[]> {
     });
   }
 
-  getVersionRange() {
+  getVersionRange(): DeviceFirmwareRange {
     return {
+      pro2: {
+        min: '0.0.0',
+        unsupported: true,
+      },
       pro: {
         min: '4.12.0',
       },

package/src/api/neo/NeoSignTransaction.ts

@@ -5,6 +5,7 @@ import { validateParams } from '../helpers/paramsValidator';
 import { formatAnyHex } from '../helpers/hexUtils';
 
 import type { NeoSignTx } from '@onekeyfe/hd-transport';
+import type { DeviceFirmwareRange } from '../../types';
 
 export default class NeoSignTransaction extends BaseMethod<NeoSignTx> {
   init() {
@@ -29,8 +30,12 @@ export default class NeoSignTransaction extends BaseMethod<NeoSignTx> {
     };
   }
 
-  getVersionRange() {
+  getVersionRange(): DeviceFirmwareRange {
     return {
+      pro2: {
+        min: '0.0.0',
+        unsupported: true,
+      },
       pro: {
         min: '4.12.0',
       },

package/src/api/nervos/NervosGetAddress.ts

@@ -4,7 +4,7 @@ import { BaseMethod } from '../BaseMethod';
 import { validateParams, validateResult } from '../helpers/paramsValidator';
 
 import type { NervosGetAddress as HardwareNervosGetAddress } from '@onekeyfe/hd-transport';
-import type { NervosAddress, NervosGetAddressParams } from '../../types';
+import type { DeviceFirmwareRange, NervosAddress, NervosGetAddressParams } from '../../types';
 
 export default class NervosGetAddress extends BaseMethod<HardwareNervosGetAddress[]> {
   hasBundle = false;
@@ -40,8 +40,12 @@ export default class NervosGetAddress extends BaseMethod<HardwareNervosGetAddres
     });
   }
 
-  getVersionRange() {
+  getVersionRange(): DeviceFirmwareRange {
     return {
+      pro2: {
+        min: '0.0.0',
+        unsupported: true,
+      },
       model_mini: {
         min: '3.7.0',
       },