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

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

@@ -16,8 +16,8 @@ export const signTypedData = async ({
 }) => {
   const { primaryType }: EthereumSignTypedDataMessage<EthereumSignTypedDataTypes> = data;
 
-  // legacy EthereumSignTypedData 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
-  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  // The generated legacy type omits chain_id, but old firmware accepts the OneKey
+  // extension. A non-fresh object preserves that runtime field without a type cast.
   const message = {
     address_n: addressN,
     primary_type: primaryType as string,

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

@@ -38,8 +38,8 @@ export const signTypedHash = async ({
     }
   }
 
-  // legacy EthereumSignTypedHash 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
-  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  // The generated legacy type omits chain_id, but old firmware accepts the OneKey
+  // extension. A non-fresh object preserves that runtime field without a type cast.
   const message = {
     address_n: addressN,
     domain_separator_hash: domainHash ?? '',

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

@@ -7,8 +7,8 @@ export default async function ({
   typedCall: TypedCall;
   params: EthereumVerifyMessageOneKey;
 }): Promise<Success> {
-  // legacy EthereumVerifyMessage 的生成类型没有 chain_id 字段，但旧固件按 OneKey 扩展
-  // 接受该字段；通过预先声明的对象（非 fresh literal）携带额外字段，保持原有运行时行为。
+  // The generated legacy type omits chain_id, but old firmware accepts the OneKey
+  // extension. A non-fresh object preserves that runtime field without a type cast.
   const message = {
     signature: params.signature,
     message: params.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, getDeviceUUID, getLogger, wait } from '../../utils';
+import { LoggerNames, getLogger, wait } from '../../utils';
 import { DeviceModelToTypes } from '../../types';
 import { DataManager } from '../../data-manager';
 import { BaseMethod } from '../BaseMethod';
@@ -251,7 +251,7 @@ 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.isBootloader()) {
-      const uuid = getDeviceUUID(this.device.features);
+      const serialNo = this.device.getCurrentSerialNo();
       const deviceType = this.device.getCurrentDeviceType();
       // auto go to bootloader mode
       try {
@@ -266,7 +266,7 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
 
         // force clean classic device cache so that the device can initialize again
         if (DeviceModelToTypes.model_classic.includes(deviceType)) {
-          DevicePool.clearDeviceCache(uuid);
+          DevicePool.clearDeviceCache(serialNo);
         }
         delete DevicePool.devicesCache[''];
         await this.checkPromise?.promise;

package/src/api/firmware/getBinary.ts

@@ -7,9 +7,12 @@ import { findLatestRelease } from '../../utils/release';
 import { getFirmwareUpdateField } from '../../utils/deviceFeaturesUtils';
 
 import type { Features } from '../../types';
+import type { HttpRequestOptions } from '../../utils/networkUtils';
 import type { EFirmwareType } from '@onekeyfe/hd-shared';
 import type { IFirmwareField } from '../../data-manager/DataManager';
 
+export type FirmwareBinary = ArrayBuffer | Buffer;
+
 export interface GetInfoProps {
   features: Features;
   updateType: 'firmware' | 'ble';
@@ -20,6 +23,7 @@ export interface GetInfoProps {
 
 interface GetBinaryProps extends GetInfoProps {
   version?: number[];
+  requestOptions?: HttpRequestOptions;
 }
 
 export const getBinary = async ({
@@ -28,6 +32,7 @@ export const getBinary = async ({
   version,
   isUpdateBootloader,
   firmwareType,
+  requestOptions,
 }: GetBinaryProps) => {
   const releaseInfo = getInfo({
     features,
@@ -55,9 +60,9 @@ export const getBinary = async ({
       : isUpdateBootloader
       ? releaseInfo.bootloaderResource
       : releaseInfo.url;
-  let fw;
+  let fw: FirmwareBinary;
   try {
-    fw = await httpRequest(url, 'binary');
+    fw = await httpRequest(url, 'binary', requestOptions);
   } catch {
     throw ERRORS.TypedError(HardwareErrorCode.RuntimeError, 'Method_FirmwareUpdate_DownloadFailed');
   }
@@ -69,7 +74,7 @@ export const getBinary = async ({
 };
 
 export const getSysResourceBinary = async (url: string) => {
-  let fw;
+  let fw: FirmwareBinary;
   try {
     fw = await httpRequest(url, 'binary');
   } catch {

package/src/api/helpers/batchGetPublickeys.ts

@@ -27,8 +27,8 @@ export function supportBatchPublicKeyByDevice(
   const currentVersion = device.getCurrentFirmwareVersionString() ?? '0.0.0';
   const deviceType = device.getCurrentDeviceType();
 
-  // Pro2 (Protocol V2) 版本线独立于 Pro 系列，固件从首个版本即支持 batch / include_node，
-  // 不能套用下面 Pro 系列的 4.x 门槛。
+  // Pro2 has an independent version line and supports batch/include_node from its first
+  // firmware version, so the Protocol V1 Pro 4.x threshold does not apply.
   if (device.isProtocolV2() || deviceType === EDeviceType.Pro2) {
     return true;
   }

package/src/api/helpers/filesystemValidation.ts

@@ -10,6 +10,67 @@ export function validateNonEmptyString(value: unknown, name: string): string {
   return value;
 }
 
+const PROTOCOL_V2_FILESYSTEM_VOLUMES = new Set(['vol0', 'vol1']);
+// Bootloader and romloader reserve 128 bytes including the terminating NUL.
+const MAX_PROTOCOL_V2_FILESYSTEM_PATH_BYTES = 127;
+
+function getUtf8ByteLength(value: string) {
+  return Array.from(value).reduce((length, character) => {
+    const codePoint = character.codePointAt(0) ?? 0;
+    if (codePoint <= 0x7f) return length + 1;
+    if (codePoint <= 0x7ff) return length + 2;
+    if (codePoint <= 0xffff) return length + 3;
+    return length + 4;
+  }, 0);
+}
+
+export function validateProtocolV2FilesystemPath(
+  value: unknown,
+  name: string,
+  options: { allowVolumeRoot?: boolean } = {}
+): string {
+  const rawPath = validateNonEmptyString(value, name).trim();
+  const containsUnsupportedCharacter = Array.from(rawPath).some(character => {
+    const codePoint = character.charCodeAt(0);
+    return codePoint <= 0x1f || codePoint === 0x7f || character === '\\';
+  });
+
+  if (containsUnsupportedCharacter) {
+    throw invalidParameter(`Parameter [${name}] contains unsupported path characters.`);
+  }
+
+  const match = /^([a-zA-Z0-9]+):(.*)$/.exec(rawPath);
+  if (!match) {
+    throw invalidParameter(
+      `Parameter [${name}] must use a supported Protocol V2 filesystem volume.`
+    );
+  }
+
+  const volume = match[1].toLowerCase();
+  if (!PROTOCOL_V2_FILESYSTEM_VOLUMES.has(volume)) {
+    throw invalidParameter(`Parameter [${name}] uses an unsupported filesystem volume.`);
+  }
+
+  const rawSuffix = match[2];
+  if (rawSuffix.length === 0) {
+    if (options.allowVolumeRoot) return `${volume}:`;
+    throw invalidParameter(`Parameter [${name}] must identify a filesystem entry.`);
+  }
+
+  const suffix = rawSuffix.startsWith('/') ? rawSuffix : `/${rawSuffix}`;
+  const segments = suffix.slice(1).split('/');
+  if (segments.some(segment => segment.length === 0 || segment === '.' || segment === '..')) {
+    throw invalidParameter(`Parameter [${name}] contains an invalid path segment.`);
+  }
+
+  const canonicalPath = `${volume}:${rawSuffix.startsWith('/') ? '/' : ''}${segments.join('/')}`;
+  if (getUtf8ByteLength(canonicalPath) > MAX_PROTOCOL_V2_FILESYSTEM_PATH_BYTES) {
+    throw invalidParameter(`Parameter [${name}] exceeds the maximum filesystem path length.`);
+  }
+
+  return canonicalPath;
+}
+
 export function validateNonNegativeInteger(
   value: unknown,
   name: string,

package/src/api/helpers/paramsValidator.ts

@@ -20,7 +20,7 @@ export type SchemaParam = {
   allowNegative?: boolean;
 };
 
-const invalidParameter = (message: string) =>
+export const invalidParameter = (message: string) =>
   ERRORS.TypedError(HardwareErrorCode.CallMethodInvalidParameter, message);
 
 const invalidResponse = (message: string) =>

package/src/api/helpers/protocolV2FileWrite.ts

@@ -136,7 +136,8 @@ export async function writeProtocolV2File(options: ProtocolV2FileWriteOptions) {
     const maxChunkRetries = Math.max(Math.floor(options.maxChunkRetries ?? 0), 0);
     let retryCount = 0;
     let response;
-    while (true) {
+    let isWritePending = true;
+    while (isWritePending) {
       try {
         response = await options.commands.typedCall(
           'FilesystemFileWrite',
@@ -144,7 +145,7 @@ export async function writeProtocolV2File(options: ProtocolV2FileWriteOptions) {
           request,
           { timeoutMs: options.timeoutMs }
         );
-        break;
+        isWritePending = false;
       } catch (error) {
         if (retryCount >= maxChunkRetries || !isRetryableFileWriteTimeout(error)) throw error;
         retryCount += 1;

package/src/api/index.ts

@@ -6,6 +6,7 @@ export { default as getFeatures } from './GetFeatures';
 export { default as getDeviceState } from './GetDeviceState';
 export { default as getOnekeyFeatures } from './GetOnekeyFeatures';
 export { default as getPassphraseState } from './GetPassphraseState';
+export { default as openWalletSession } from './OpenWalletSession';
 export { default as getLogs } from './GetLogs';
 export { default as clearSessionCache } from './ClearSessionCache';
 export { default as checkFirmwareRelease } from './CheckFirmwareRelease';
@@ -43,19 +44,22 @@ 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 protocolInfoRequest } from './protocol-v2/ProtocolInfoRequest';
-export { default as ping } from './protocol-v2/Ping';
+// Pro2 business API
 export { default as deviceReboot } from './protocol-v2/DeviceReboot';
 export { default as deviceGetOnboardingStatus } from './protocol-v2/DeviceGetOnboardingStatus';
-export { default as deviceSessionOpen } from './protocol-v2/DeviceSessionOpen';
+export { default as deviceUploadWallpaper } from './protocol-v2/DeviceUploadWallpaper';
+// Protocol V2 development APIs. These remain public while Pro2 integration is in development.
+export { default as deviceInfoGet } from './protocol-v2/DeviceInfoGet';
+export { default as deviceStatusGet } from './protocol-v2/DeviceStatusGet';
+export { default as deviceSettingsGet } from './protocol-v2/DeviceSettingsGet';
+export { default as protocolInfoRequest } from './protocol-v2/ProtocolInfoRequest';
+export { default as ping } from './protocol-v2/Ping';
 export { default as deviceFirmwareUpdate } from './protocol-v2/DeviceFirmwareUpdate';
 export { default as deviceGetFirmwareUpdateStatus } from './protocol-v2/DeviceGetFirmwareUpdateStatus';
 export { default as deviceFactoryInfoSet } from './protocol-v2/DeviceFactoryInfoSet';
 export { default as deviceFactoryInfoGet } from './protocol-v2/DeviceFactoryInfoGet';
 export { default as deviceSettingsSet } from './protocol-v2/DeviceSettingsSet';
 export { default as deviceSettingsPageShow } from './protocol-v2/DeviceSettingsPageShow';
-export { default as deviceUploadWallpaper } from './protocol-v2/DeviceUploadWallpaper';
 export { default as filesystemPermissionFix } from './protocol-v2/FilesystemPermissionFix';
 export { default as filesystemFormat } from './protocol-v2/FilesystemFormat';
 export { default as fileRead } from './FileRead';
@@ -65,14 +69,7 @@ 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 uploadPortfolio } from './UploadPortfolio';
-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';
 

package/src/api/nervos/NervosSignTransaction.ts

@@ -67,8 +67,8 @@ export default class NervosSignTransaction extends BaseMethod<NervosSignTx> {
     res: TypedResponseMessage<'NervosSignedTx'> | TypedResponseMessage<'NervosTxRequest'>,
     data: Buffer,
     offset = 0
-    // 设备可能在最后一个 NervosTxRequest（无 data_length）里返回签名，
-    // 该消息没有 address 字段，返回类型如实声明为联合类型
+    // The final NervosTxRequest may return a signature without data_length or address,
+    // so the result accurately uses a union type.
   ): Promise<NervosSignedTx | (NervosTxRequest & { path: string })> => {
     if (res.type === 'NervosSignedTx') {
       if (!res?.message?.signature) {

package/src/api/nexa/NexaSignTransaction.ts

@@ -73,7 +73,7 @@ export default class NexaSignTransaction extends BaseMethod<NexaSignTransactionP
       const nextIndex = res.message.request_index;
       const input = this.params.inputs[nextIndex];
       const response = await typedCall('NexaTxInputAck', ['NexaTxInputRequest', 'NexaSignedTx'], {
-        // path 为字符串形式，归一为 address_n 数组（与 run() 中首个 input 的处理一致）
+        // Normalize a string path to address_n, matching the first input handled by run().
         address_n: validatePath(input.path, 3),
         raw_message: input.message,
       });

package/src/api/protocol-v2/DeviceFactoryInfoGet.ts

@@ -2,7 +2,7 @@ import { BaseMethod } from '../BaseMethod';
 
 export default class DeviceFactoryInfoGet extends BaseMethod {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/DeviceFactoryInfoSet.ts

@@ -4,7 +4,7 @@ import type { DeviceFactoryInfoSetParams } from './helpers';
 
 export default class DeviceFactoryInfoSet extends BaseMethod<DeviceFactoryInfoSetParams> {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/DeviceFirmwareUpdate.ts

@@ -13,7 +13,7 @@ import type { DeviceFirmwareUpdateParams } from './helpers';
 
 export default class DeviceFirmwareUpdate extends BaseMethod<DeviceFirmwareUpdateParams> {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;
@@ -48,12 +48,12 @@ export default class DeviceFirmwareUpdate extends BaseMethod<DeviceFirmwareUpdat
           },
         }
       );
-      return Promise.resolve(res.message);
+      return res.message;
     } catch (error) {
       if (isProtocolV2DeviceDisconnectedError(error)) {
-        return Promise.resolve({
+        return {
           message: 'Device firmware update started',
-        });
+        };
       }
       throw error;
     }

package/src/api/protocol-v2/DeviceGetFirmwareUpdateStatus.ts

@@ -24,18 +24,19 @@ function normalizeStatusFields(
   const normalized: DeviceFirmwareUpdateRecordFields = {};
   for (const field of DEVICE_FIRMWARE_UPDATE_STATUS_FIELDS) {
     const value = fields[field];
-    if (value === undefined) continue;
-    if (typeof value !== 'boolean') {
-      throw invalidParameter(`Parameter [fields.${field}] must be a boolean.`);
+    if (value !== undefined) {
+      if (typeof value !== 'boolean') {
+        throw invalidParameter(`Parameter [fields.${field}] must be a boolean.`);
+      }
+      normalized[field] = value;
     }
-    normalized[field] = value;
   }
   return normalized;
 }
 
 export default class DeviceGetFirmwareUpdateStatus extends BaseMethod<DeviceFirmwareUpdateStatusGetParams> {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/DeviceInfoGet.ts

@@ -100,17 +100,17 @@ function normalizeTypes(value: unknown): DeviceInfoGetTypes | undefined {
 }
 
 /**
- * 原生 DeviceInfoGet（Protocol V2 only）。
+ * Raw DeviceInfoGet command for Protocol V2 only.
  *
- * SDK 内部按需构造 targets/types，并返回未加工的 DeviceInfo 消息。
- * 该 command 不属于公共 CoreApi；业务接入统一使用 getDeviceState。
+ * The SDK builds targets/types on demand and returns the raw DeviceInfo message.
+ * This command is internal; integrations should use getDeviceState.
  */
 export default class DeviceInfoGet extends BaseMethod<{
   targets: DeviceInfoGetTargets;
   types: DeviceInfoGetTypes;
 }> {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.unlockPolicy = 'none';
     this.allowDeviceMode = [

package/src/api/protocol-v2/DeviceReboot.ts

@@ -5,7 +5,7 @@ import type { DeviceRebootParams } from './helpers';
 
 export default class DeviceReboot extends BaseMethod<DeviceRebootParams> {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/DeviceSettingsPageShow.ts

@@ -2,6 +2,7 @@ import { DeviceSettingsPage } from '@onekeyfe/hd-transport';
 
 import { BaseMethod } from '../BaseMethod';
 import { invalidParameter } from '../helpers/filesystemValidation';
+import { getProtocolV2SettingsBehavior } from '../../protocols/protocol-v2/settingsUnlockPolicy';
 
 export type SupportedDeviceSettingsPage = DeviceSettingsPage;
 
@@ -39,21 +40,18 @@ export default class DeviceSettingsPageShow extends BaseMethod<{
 }> {
   init() {
     this.requireProtocolV2 = true;
-    this.unlockPolicy = 'retry-on-locked';
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;
     this.params = {
       page: normalizePage(this.payload.page),
       field_name: this.payload.field_name ?? this.payload.fieldName,
     };
-    this.protocolV2UiInteraction = {
-      request: 'button',
-      source: 'method-lifecycle',
-      reason: 'settings-page',
-      completion: 'operation-completed',
-      deviceOnly: true,
+    const behavior = getProtocolV2SettingsBehavior({
+      kind: 'page',
       page: this.params.page,
-    };
+    });
+    this.unlockPolicy = behavior.unlockPolicy;
+    this.protocolV2UiInteraction = behavior.uiInteraction;
   }
 
   async run() {
@@ -62,6 +60,11 @@ export default class DeviceSettingsPageShow extends BaseMethod<{
       'Success',
       this.params
     );
+    if (this.params.page === DeviceSettingsPage.DevicePassphrase) {
+      await this.device.getDeviceState({ refreshSections: ['status'] });
+    } else if (this.params.page === DeviceSettingsPage.DeviceAirgap) {
+      await this.device.getDeviceState({ refreshSections: ['settings'] });
+    }
     return Promise.resolve(res.message);
   }
 }

package/src/api/protocol-v2/DeviceSettingsSet.ts

@@ -1,5 +1,6 @@
 import { BaseMethod } from '../BaseMethod';
 import { mapDeviceSettingsToState } from '../../device/DeviceStateMapper';
+import { getProtocolV2SettingsBehavior } from '../../protocols/protocol-v2/settingsUnlockPolicy';
 import { invalidParameter } from '../helpers/filesystemValidation';
 
 import type { DeviceSettings } from '@onekeyfe/hd-transport';
@@ -27,20 +28,12 @@ export default class DeviceSettingsSet extends BaseMethod<{
     }
 
     this.requireProtocolV2 = true;
-    this.unlockPolicy = 'retry-on-locked';
+    const behavior = getProtocolV2SettingsBehavior({ kind: 'direct', settings: supported });
+    this.unlockPolicy = behavior.unlockPolicy;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;
     this.params = { settings: supported };
-    if (typeof supported.label === 'string') {
-      this.protocolV2UiInteraction = {
-        request: 'button',
-        source: 'method-lifecycle',
-        reason: 'device-management',
-        completion: 'operation-completed',
-        deviceOnly: true,
-        operation: 'change-label',
-      };
-    }
+    this.protocolV2UiInteraction = behavior.uiInteraction;
   }
 
   async run() {

package/src/api/protocol-v2/FilesystemFormat.ts

@@ -2,7 +2,7 @@ import { BaseMethod } from '../BaseMethod';
 
 export default class FilesystemFormat extends BaseMethod {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/FilesystemPermissionFix.ts

@@ -2,7 +2,7 @@ import { BaseMethod } from '../BaseMethod';
 
 export default class FilesystemPermissionFix extends BaseMethod {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/Ping.ts

@@ -2,7 +2,7 @@ import { BaseMethod } from '../BaseMethod';
 
 export default class Ping extends BaseMethod<{ message?: string }> {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/protocol-v2/ProtocolInfoRequest.ts

@@ -2,7 +2,7 @@ import { BaseMethod } from '../BaseMethod';
 
 export default class ProtocolInfoRequest extends BaseMethod {
   init() {
-    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    // Protocol V2 (Pro2) only; Core rejects non-V2 devices.
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;

package/src/api/utils.ts

@@ -1,7 +1,6 @@
 import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
 
 import * as ApiMethods from './index';
-import * as InternalApiMethods from './internal';
 
 import type { BaseMethod } from './BaseMethod';
 import type { IFrameCallMessage } from '../events';
@@ -9,7 +8,6 @@ import type { IFrameCallMessage } from '../events';
 type MethodConstructor = new (message: IFrameCallMessage & { id?: number }) => BaseMethod<any>;
 
 const publicMethodRegistry = ApiMethods as unknown as Record<string, MethodConstructor>;
-const internalMethodRegistry = InternalApiMethods as unknown as Record<string, MethodConstructor>;
 
 export function findMethod(message: IFrameCallMessage & { id?: number }): BaseMethod<any> {
   const { method } = message.payload;
@@ -17,7 +15,7 @@ export function findMethod(message: IFrameCallMessage & { id?: number }): BaseMe
     throw ERRORS.TypedError(HardwareErrorCode.CallMethodInvalidParameter, 'Method is not set');
   }
 
-  const MethodConstructor = publicMethodRegistry[method] ?? internalMethodRegistry[method];
+  const MethodConstructor = publicMethodRegistry[method];
   if (MethodConstructor) {
     return new MethodConstructor(message);
   }