@onekeyfe/hd-core 1.1.34-alpha.2 → 1.1.34-alpha.3

package/src/utils/deviceInfoUtils.ts

@@ -1,65 +1,22 @@
 import { isEmpty } from 'lodash';
-import { EDeviceType, EFirmwareType } from '@onekeyfe/hd-shared';
-import { Enum_Capability } from '@onekeyfe/hd-transport';
+import { EDeviceType } from '@onekeyfe/hd-shared';
 
 import { DeviceModelToTypes } from '../types';
-import { existCapability } from './capabilitieUtils';
+import {
+  resolveDeviceBleName,
+  resolveDeviceFirmwareType,
+  resolveDeviceSerialNo,
+  resolveDeviceType,
+} from './deviceFeaturesCompat';
 
-import type { Features, IDeviceModel, IDeviceType, IVersionRange } from '../types';
+import type { IDeviceModel, IDeviceType, IVersionRange } from '../types';
+import type { DeviceFeaturesInput } from './deviceFeaturesCompat';
 
 /**
  * get device type by features
  */
-export const getDeviceType = (features?: Features): IDeviceType => {
-  if (!features || typeof features !== 'object') {
-    return EDeviceType.Unknown;
-  }
-
-  // classic1s 3.5.0 pro 4.6.0
-  switch (features.onekey_device_type) {
-    case 'CLASSIC':
-      return EDeviceType.Classic;
-    case 'CLASSIC1S':
-      return EDeviceType.Classic1s;
-    case 'MINI':
-      return EDeviceType.Mini;
-    case 'TOUCH':
-      return EDeviceType.Touch;
-    case 'PRO':
-      return EDeviceType.Pro;
-    case 'PURE':
-      return EDeviceType.ClassicPure;
-    default:
-      // future And old device onekey_device_type is empty
-      if (!isEmpty(features.onekey_serial_no)) {
-        return EDeviceType.Unknown;
-      }
-    // old device type
-  }
-
-  // low version hardware
-  // onekey_serial_no > onekey_serial > serial_no
-  const serialNo = getDeviceUUID(features);
-
-  // not exist serialNo, bootloader mode, model 1 is classic
-  if (isEmpty(serialNo) && features.bootloader_mode === true && features.model === '1') {
-    return EDeviceType.Classic;
-  }
-
-  if (isEmpty(serialNo)) return EDeviceType.Unknown;
-
-  const miniFlag = serialNo.slice(0, 2);
-  // By May 2021, the miniFlag is 'bixin' for all classic devices
-  if (miniFlag.toLowerCase() === 'bi') return EDeviceType.Classic;
-  if (miniFlag.toLowerCase() === 'cl') return EDeviceType.Classic;
-  if (miniFlag.toLowerCase() === 'cp') return EDeviceType.ClassicPure;
-  if (miniFlag.toLowerCase() === 'mi') return EDeviceType.Mini;
-  if (miniFlag.toLowerCase() === 'tc') return EDeviceType.Touch;
-  if (miniFlag.toLowerCase() === 'pr') return EDeviceType.Pro;
-
-  // unknown device
-  return EDeviceType.Unknown;
-};
+export const getDeviceType = (features?: DeviceFeaturesInput): IDeviceType =>
+  resolveDeviceType(features);
 
 /**
  * get device type by ble name
@@ -68,13 +25,14 @@ export const getDeviceType = (features?: Features): IDeviceType => {
 export const getDeviceTypeByBleName = (name?: string): IDeviceType => {
   if (!name) return EDeviceType.Unknown;
 
-  if (name.startsWith('BixinKey')) return EDeviceType.Classic;
-  if (name.startsWith('K')) return EDeviceType.Classic;
+  if (/^BixinKey/i.test(name)) return EDeviceType.Classic;
+  if (/^K/i.test(name)) return EDeviceType.Classic;
 
-  if (name.startsWith('T')) return EDeviceType.Touch;
-  if (name.startsWith('Touch')) return EDeviceType.Touch;
+  if (/^T/i.test(name)) return EDeviceType.Touch;
+  if (/^Touch/i.test(name)) return EDeviceType.Touch;
 
-  if (name.startsWith('Pro')) return EDeviceType.Pro;
+  if (/\bPro\s*2\b/i.test(name) || /^Pro2/i.test(name)) return EDeviceType.Pro2;
+  if (/\bPro\b/i.test(name) || /^Pro/i.test(name)) return EDeviceType.Pro;
 
   return EDeviceType.Unknown;
 };
@@ -83,29 +41,30 @@ export const getDeviceTypeByBleName = (name?: string): IDeviceType => {
  * Get Connected Device ble name by features
  * @returns
  */
-export const getDeviceBleName = (features?: Features): string | null => {
-  if (features == null) return null;
-  return features.onekey_ble_name || features.ble_name || null;
-};
+export const getDeviceBleName = (features?: DeviceFeaturesInput): string | null =>
+  resolveDeviceBleName(features);
 
 /**
- * Get Connected Device UUID by features
+ * Get Connected Device serial number by features
  */
-export const getDeviceUUID = (features: Features) => {
-  const serialNo = features.onekey_serial_no || features.onekey_serial || features.serial_no;
-  return serialNo ?? '';
-};
+export const getDeviceSerialNo = (features?: DeviceFeaturesInput): string =>
+  resolveDeviceSerialNo(features);
+
+/**
+ * @deprecated Use getDeviceSerialNo instead.
+ */
+export const getDeviceUUID = getDeviceSerialNo;
 
 /**
  * Get Connected Device label by features
  */
-export const getDeviceLabel = (features?: Features) => {
+export const getDeviceLabel = (features?: DeviceFeaturesInput) => {
   if (!features) return null;
 
   const deviceType = getDeviceType(features);
   if (deviceType == null) return null;
 
-  if (typeof features.label === 'string' && !isEmpty(features.label)) {
+  if ('label' in features && typeof features.label === 'string' && !isEmpty(features.label)) {
     return features.label;
   }
 
@@ -124,12 +83,12 @@ export const getDeviceLabel = (features?: Features) => {
  * Type has a higher priority than Model
  */
 export const getMethodVersionRange = (
-  features: Features | undefined,
+  features: DeviceFeaturesInput | undefined,
   getVersionRange: (deviceModel: IDeviceType | IDeviceModel) => IVersionRange | undefined
 ): IVersionRange | undefined => {
   const deviceType = getDeviceType(features);
-  let versionRange: IVersionRange | undefined = getVersionRange(deviceType);
 
+  const versionRange = getVersionRange(deviceType);
   if (versionRange) {
     return versionRange;
   }
@@ -142,26 +101,18 @@ export const getMethodVersionRange = (
   ];
   for (const model of modelFallbacks) {
     if (DeviceModelToTypes[model].includes(deviceType)) {
-      versionRange = getVersionRange(model);
+      const versionRange = getVersionRange(model);
       if (versionRange) {
         return versionRange;
       }
     }
   }
 
-  return versionRange;
+  return undefined;
 };
 
-export const getFirmwareType = (features: Features | undefined) => {
-  if (!features) {
-    return EFirmwareType.Universal;
-  }
-  if (features.fw_vendor === 'OneKey Bitcoin-only') {
-    return EFirmwareType.BitcoinOnly;
-  }
-  // old firmware
-  return features?.capabilities?.length > 0 &&
-    !existCapability(features, Enum_Capability.Capability_Bitcoin_like)
-    ? EFirmwareType.BitcoinOnly
-    : EFirmwareType.Universal;
-};
+export const isMethodVersionRangeUnsupported = (versionRange?: IVersionRange): boolean =>
+  versionRange?.unsupported === true;
+
+export const getFirmwareType = (features?: DeviceFeaturesInput) =>
+  resolveDeviceFirmwareType(features);

package/src/utils/deviceSettings.ts

@@ -19,6 +19,33 @@ export const LANGUAGE_LABELS = {
 export type LanguageKey = keyof typeof LANGUAGE_LABELS;
 export type LanguageOption = { code: LanguageKey; label: (typeof LANGUAGE_LABELS)[LanguageKey] };
 
+export const PROTOCOL_V2_LANGUAGE_BY_KEY: Record<LanguageKey, string> = {
+  en: 'en-Latn-US',
+  zh_cn: 'zh-Hans-CN',
+  zh_hk: 'zh-Hant-HK',
+  ja: 'ja-Jpan-JP',
+  ko: 'ko-Kore-KR',
+  fr: 'fr-Latn-FR',
+  de: 'de-Latn-DE',
+  ru: 'ru-Cyrl-RU',
+  es: 'es-Latn-ES',
+  it: 'it-Latn-IT',
+  pt_br: 'pt-Latn-BR',
+};
+
+export const mapLanguageToProtocolV2 = (language?: string) =>
+  language ? PROTOCOL_V2_LANGUAGE_BY_KEY[language as LanguageKey] ?? language : undefined;
+
+const PRO2_LANGUAGE_OPTIONS = [
+  ...Object.entries(LANGUAGE_LABELS).map(([code, label]) => ({ code, label })),
+  { code: 'zh-Hant-TW', label: '繁體中文（台灣）' },
+  { code: 'vi-Latn-VN', label: 'Tiếng Việt' },
+  { code: 'tr-Latn-TR', label: 'Türkçe' },
+  { code: 'id-Latn-ID', label: 'Bahasa Indonesia' },
+  { code: 'fil-Latn-PH', label: 'Filipino' },
+  { code: 'uk-Cyrl-UA', label: 'Українська' },
+] as const;
+
 export const getLanguageConfig = (deviceType: IDeviceType): Record<string, string>[] => {
   let keys: LanguageKey[] = [];
 
@@ -36,6 +63,8 @@ export const getLanguageConfig = (deviceType: IDeviceType): Record<string, strin
     case EDeviceType.Pro:
       keys = Object.keys(LANGUAGE_LABELS) as LanguageKey[];
       break;
+    case EDeviceType.Pro2:
+      return PRO2_LANGUAGE_OPTIONS.map(option => ({ ...option }));
     default:
       keys = [];
       break;
@@ -75,6 +104,16 @@ export const getAutoLockOptions = (_deviceType: IDeviceType): DurationParts[] =>
         { seconds: 0, minute: 30, hour: 0, day: 0 },
         { seconds: 0, minute: 0, hour: 0, day: 0 },
       ];
+    case EDeviceType.Pro2:
+      return [
+        { seconds: 30, minute: 0, hour: 0, day: 0 },
+        { seconds: 0, minute: 1, hour: 0, day: 0 },
+        { seconds: 0, minute: 2, hour: 0, day: 0 },
+        { seconds: 0, minute: 5, hour: 0, day: 0 },
+        { seconds: 0, minute: 10, hour: 0, day: 0 },
+        { seconds: 0, minute: 30, hour: 0, day: 0 },
+        { seconds: 0, minute: 0, hour: 0, day: 0 },
+      ];
     default:
       return [];
   }
@@ -103,6 +142,15 @@ export const getAutoShutDownOptions = (_deviceType: IDeviceType): DurationParts[
         { seconds: 0, minute: 10, hour: 0, day: 0 },
         { seconds: 0, minute: 0, hour: 0, day: 0 },
       ];
+    case EDeviceType.Pro2:
+      return [
+        { seconds: 0, minute: 1, hour: 0, day: 0 },
+        { seconds: 0, minute: 2, hour: 0, day: 0 },
+        { seconds: 0, minute: 5, hour: 0, day: 0 },
+        { seconds: 0, minute: 10, hour: 0, day: 0 },
+        { seconds: 0, minute: 30, hour: 0, day: 0 },
+        { seconds: 0, minute: 0, hour: 0, day: 0 },
+      ];
     default:
       return [];
   }

package/src/utils/deviceVersionUtils.ts

@@ -1,79 +1,42 @@
 import semver from 'semver';
 
-import type { Features, IVersionArray } from '../types';
+import {
+  resolveDeviceBleFirmwareVersion,
+  resolveDeviceBoardVersion,
+  resolveDeviceBootloaderVersion,
+  resolveDeviceFirmwareVersion,
+} from './deviceFeaturesCompat';
 
-/**
- * Get Connected Device version by features
- */
-export const getDeviceFirmwareVersion = (features: Features | undefined): IVersionArray => {
-  if (!features) return [0, 0, 0];
+import type { IVersionArray } from '../types';
+import type { DeviceFeaturesInput } from './deviceFeaturesCompat';
 
-  if (semver.valid(features.onekey_firmware_version)) {
-    return features.onekey_firmware_version?.split('.') as unknown as IVersionArray;
-  }
+const EMPTY_VERSION: IVersionArray = [0, 0, 0];
 
-  if (semver.valid(features.onekey_version)) {
-    return features.onekey_version?.split('.') as unknown as IVersionArray;
-  }
-
-  return [0, 0, 0];
+const parseDeviceVersion = (version?: string | null): IVersionArray => {
+  const parsed = version ? semver.parse(version) : null;
+  return parsed ? [parsed.major, parsed.minor, parsed.patch] : [...EMPTY_VERSION];
 };
 
 /**
- * Get Connected Device bluetooth firmware version by features
+ * Get Connected Device version by features
  */
-export const getDeviceBLEFirmwareVersion = (features: Features): IVersionArray => {
-  const bleVer = features?.onekey_ble_version || features?.ble_ver;
-
-  if (!bleVer) {
-    return [0, 0, 0];
-  }
-
-  if (!semver.valid(bleVer)) {
-    return [0, 0, 0];
-  }
-
-  if (bleVer) {
-    return bleVer.split('.').map(Number) as IVersionArray;
-  }
-  return [0, 0, 0];
-};
+export const getDeviceFirmwareVersion = (features?: DeviceFeaturesInput): IVersionArray =>
+  parseDeviceVersion(resolveDeviceFirmwareVersion(features));
 
 /**
  * Get Connected Device bootloader version by features
  */
-export const getDeviceBootloaderVersion = (features: Features | undefined): IVersionArray => {
-  if (!features) return [0, 0, 0];
-
-  // classic1s 3.5.0 pro 4.6.0
-  if (semver.valid(features.onekey_boot_version)) {
-    return features.onekey_boot_version?.split('.') as unknown as IVersionArray;
-  }
-
-  // low version hardware
-  if (!features.bootloader_version) {
-    if (features.bootloader_mode) {
-      return [
-        features?.major_version ?? 0,
-        features?.minor_version ?? 0,
-        features?.patch_version ?? 0,
-      ];
-    }
-    return [0, 0, 0];
-  }
-  if (semver.valid(features.bootloader_version)) {
-    return features.bootloader_version?.split('.') as unknown as IVersionArray;
-  }
-  return [0, 0, 0];
-};
+export const getDeviceBootloaderVersion = (features?: DeviceFeaturesInput): IVersionArray =>
+  parseDeviceVersion(resolveDeviceBootloaderVersion(features));
 
 /**
- * Get Connected Device boardloader version by features
+ * Get Connected Device boardloader/romloader version by features
  */
-export const getDeviceBoardloaderVersion = (features: Features): IVersionArray => {
-  if (semver.valid(features?.onekey_board_version)) {
-    return features?.onekey_board_version?.split('.') as unknown as IVersionArray;
-  }
+export const getDeviceBoardloaderVersion = (features?: DeviceFeaturesInput): IVersionArray =>
+  parseDeviceVersion(resolveDeviceBoardVersion(features));
 
-  return [0, 0, 0];
-};
+/**
+ * Get Connected Device bluetooth firmware version by features
+ */
+export const getDeviceBLEFirmwareVersion = (features?: DeviceFeaturesInput): IVersionArray =>
+  parseDeviceVersion(resolveDeviceBleFirmwareVersion(features));

package/src/utils/findDefectiveBatchDevice.ts

@@ -1,11 +1,11 @@
-import { getDeviceType, getDeviceUUID } from './deviceInfoUtils';
+import { getDeviceSerialNo, getDeviceType } from './deviceInfoUtils';
 
 import type { Features } from '../types';
 
 /**
  * 检测故障固件设备
  * 检测规则：
- * - 序列号范围：21032200001 到 21032201500 (从 onekey_serial 字段提取)
+ * - Serial number range: 21032200001 through 21032201500
  * - SE版本为 1.1.0.2
  *
  * 对齐之前版本的检测逻辑
@@ -13,13 +13,13 @@ import type { Features } from '../types';
 export const findDefectiveBatchDevice = (features: Features) => {
   if (!features) return;
 
-  const { onekey_serial: onekeySerial, se_ver: seVer } = features;
-  if (!onekeySerial) return;
+  const { serialNo, seVersion } = features;
+  if (!serialNo) return;
 
-  const versionNum = +onekeySerial.slice(5);
+  const versionNum = +serialNo.slice(5);
   if (Number.isNaN(versionNum)) return;
 
-  return versionNum >= 21032200001 && versionNum <= 21032201500 && seVer === '1.1.0.2';
+  return versionNum >= 21032200001 && versionNum <= 21032201500 && seVersion === '1.1.0.2';
 };
 
 /**
@@ -27,9 +27,9 @@ export const findDefectiveBatchDevice = (features: Features) => {
  */
 export const getDefectiveDeviceInfo = (features: Features) => {
   if (!findDefectiveBatchDevice(features)) return null;
-  const serialNo = getDeviceUUID(features);
+  const serialNo = getDeviceSerialNo(features);
   const deviceType = getDeviceType(features);
-  const seVersion = features.se_ver;
+  const { seVersion } = features;
 
   return {
     serialNo,

package/src/utils/homescreen.ts

@@ -3,6 +3,7 @@ import { EDeviceType } from '@onekeyfe/hd-shared';
 
 import { getDeviceType } from './deviceInfoUtils';
 import { getDeviceFirmwareVersion } from './deviceVersionUtils';
+import { PRO2_WALLPAPER_HEIGHT, PRO2_WALLPAPER_WIDTH } from './pro2Wallpaper';
 
 import type { Features, IDeviceType } from '../types';
 
@@ -310,6 +311,15 @@ export const getHomeScreenSize = ({
   homeScreenType: 'WallPaper' | 'Nft';
   thumbnail?: boolean;
 }) => {
+  if (deviceType === EDeviceType.Pro2) {
+    return thumbnail
+      ? undefined
+      : {
+          width: PRO2_WALLPAPER_WIDTH,
+          height: PRO2_WALLPAPER_HEIGHT,
+        };
+  }
+
   const sizes: Partial<
     Record<
       IDeviceType,

package/src/utils/index.ts

@@ -8,9 +8,11 @@ export {
   getDeviceTypeByBleName,
   getDeviceType,
   getDeviceBleName,
+  getDeviceSerialNo,
   getDeviceUUID,
   getDeviceLabel,
   getMethodVersionRange,
+  isMethodVersionRangeUnsupported,
   getFirmwareType,
 } from './deviceInfoUtils';
 export {
@@ -37,6 +39,8 @@ export { getHDPath, getScriptType, getOutputScriptType } from '../api/helpers/pa
 export const isBleConnect = (env: string) => env === 'react-native' || env === 'lowlevel';
 
 export { getHomeScreenHex, getHomeScreenDefaultList, getHomeScreenSize } from './homescreen';
+export { encodePro2Wallpaper, PRO2_WALLPAPER_HEIGHT, PRO2_WALLPAPER_WIDTH } from './pro2Wallpaper';
+export type { Pro2WallpaperColorFormat } from './pro2Wallpaper';
 
 export const wait = (ms: number) =>
   new Promise(resolve => {

package/src/utils/pro2Wallpaper.ts

@@ -0,0 +1,109 @@
+import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
+
+// RGB565 像素打包和抖动索引必须使用位运算。
+/* eslint-disable no-bitwise */
+
+export const PRO2_WALLPAPER_WIDTH = 604;
+export const PRO2_WALLPAPER_HEIGHT = 1024;
+
+export type Pro2WallpaperColorFormat = 'RGB565' | 'RGB565A8';
+
+const COLOR_FORMAT_RGB565 = 0x12;
+const COLOR_FORMAT_RGB565A8 = 0x14;
+
+const RED_THRESHOLD = [
+  1, 7, 3, 5, 0, 8, 2, 6, 7, 1, 5, 3, 8, 0, 6, 2, 3, 5, 0, 8, 2, 6, 1, 7, 5, 3, 8, 0, 6, 2, 7, 1, 0,
+  8, 2, 6, 1, 7, 3, 5, 8, 0, 6, 2, 7, 1, 5, 3, 2, 6, 1, 7, 3, 5, 0, 8, 6, 2, 7, 1, 5, 3, 8, 0,
+];
+const GREEN_THRESHOLD = [
+  1, 3, 2, 2, 3, 1, 2, 2, 2, 2, 0, 4, 2, 2, 4, 0, 3, 1, 2, 2, 1, 3, 2, 2, 2, 2, 4, 0, 2, 2, 0, 4, 1,
+  3, 2, 2, 3, 1, 2, 2, 2, 2, 0, 4, 2, 2, 4, 0, 3, 1, 2, 2, 1, 3, 2, 2, 2, 2, 4, 0, 2, 2, 0, 4,
+];
+const BLUE_THRESHOLD = [
+  5, 3, 8, 0, 6, 2, 7, 1, 3, 5, 0, 8, 2, 6, 1, 7, 8, 0, 6, 2, 7, 1, 5, 3, 0, 8, 2, 6, 1, 7, 3, 5, 6,
+  2, 7, 1, 5, 3, 8, 0, 2, 6, 1, 7, 3, 5, 0, 8, 7, 1, 5, 3, 8, 0, 6, 2, 1, 7, 3, 5, 0, 8, 2, 6,
+];
+
+function invalidParameter(message: string): Error {
+  return ERRORS.TypedError(HardwareErrorCode.CallMethodInvalidParameter, message);
+}
+
+function asBytes(rgba: Uint8Array | ArrayBuffer): Uint8Array {
+  return rgba instanceof Uint8Array ? rgba : new Uint8Array(rgba);
+}
+
+function align(value: number, boundary: number): number {
+  return Math.ceil(value / boundary) * boundary;
+}
+
+export function encodePro2Wallpaper(options: {
+  width: number;
+  height: number;
+  rgba: Uint8Array | ArrayBuffer;
+}): { data: Uint8Array; colorFormat: Pro2WallpaperColorFormat } {
+  const { width, height } = options;
+  if (!Number.isInteger(width) || width <= 0 || width > 0xffff) {
+    throw invalidParameter('Wallpaper width must be an integer between 1 and 65535.');
+  }
+  if (!Number.isInteger(height) || height <= 0 || height > 0xffff) {
+    throw invalidParameter('Wallpaper height must be an integer between 1 and 65535.');
+  }
+
+  const rgba = asBytes(options.rgba);
+  const expectedLength = width * height * 4;
+  if (rgba.byteLength !== expectedLength) {
+    throw invalidParameter(
+      `Wallpaper RGBA data length must be ${expectedLength} bytes, received ${rgba.byteLength}.`
+    );
+  }
+
+  let hasTransparency = false;
+  for (let index = 3; index < rgba.length; index += 4) {
+    if (rgba[index] !== 0xff) {
+      hasTransparency = true;
+      break;
+    }
+  }
+
+  const colorFormat: Pro2WallpaperColorFormat = hasTransparency ? 'RGB565A8' : 'RGB565';
+  const stride = align(width * 2, 4);
+  const alphaStride = stride / 2;
+  const rgbSize = stride * height;
+  const alphaSize = hasTransparency ? alphaStride * height : 0;
+  const data = new Uint8Array(12 + rgbSize + alphaSize);
+  const view = new DataView(data.buffer);
+
+  data[0] = 0x19;
+  data[1] = hasTransparency ? COLOR_FORMAT_RGB565A8 : COLOR_FORMAT_RGB565;
+  view.setUint16(2, 0, true);
+  view.setUint16(4, width, true);
+  view.setUint16(6, height, true);
+  view.setUint16(8, stride, true);
+  view.setUint16(10, 0, true);
+
+  for (let y = 0; y < height; y += 1) {
+    for (let x = 0; x < width; x += 1) {
+      const sourceOffset = (y * width + x) * 4;
+      const thresholdIndex = ((y & 7) << 3) + (x & 7);
+      let red = Math.min(rgba[sourceOffset] + RED_THRESHOLD[thresholdIndex], 0xff) & 0xf8;
+      let green = Math.min(rgba[sourceOffset + 1] + GREEN_THRESHOLD[thresholdIndex], 0xff) & 0xfc;
+      let blue = Math.min(rgba[sourceOffset + 2] + BLUE_THRESHOLD[thresholdIndex], 0xff) & 0xf8;
+      if (!hasTransparency) {
+        const alpha = rgba[sourceOffset + 3];
+        red = (red * alpha) >> 8;
+        green = (green * alpha) >> 8;
+        blue = (blue * alpha) >> 8;
+      }
+      const rgb565 = ((red >> 3) << 11) | ((green >> 2) << 5) | (blue >> 3);
+      const rgbOffset = 12 + y * stride + x * 2;
+      data[rgbOffset] = rgb565 & 0xff;
+      data[rgbOffset + 1] = rgb565 >> 8;
+
+      if (hasTransparency) {
+        data[12 + rgbSize + y * alphaStride + x] = rgba[sourceOffset + 3];
+      }
+    }
+  }
+
+  return { data, colorFormat };
+}

package/src/utils/tracing.ts

@@ -164,7 +164,9 @@ export function completeRequestContext(responseID: number, error?: Error): void
     context.status = error ? 'error' : 'success';
     if (error) {
       context.error = error.message;
-      Log.error(
+      // Method errors already reach callers through the standard API response.
+      // Request tracing is diagnostic and must not emit a second user-facing error.
+      Log.debug(
         `[RequestContext] [completeRequestContext] Error: ${formatRequestContext(context)}`
       );
     }