@onekeyfe/hd-core 1.2.0-alpha.99 → 1.2.0

package/src/protocols/protocol-v2/walletSession.ts

@@ -83,15 +83,21 @@ const buildDeviceSessionGetRequest = ({
         ],
 });
 
-const askDevicePassphrase = async (device: Device, requestPayload: DeviceSessionAskPassphrase) => {
+const askDevicePassphrase = async (
+  device: Device,
+  requestPayload: DeviceSessionAskPassphrase,
+  onStatusRefreshed?: () => void
+) => {
   await device.commands.typedCall('DeviceSessionAskPassphrase', 'Success', requestPayload);
   await refreshProtocolV2DeviceStatus(device);
+  onStatusRefreshed?.();
 };
 
 const selectDeviceSession = async (
   device: Device,
   expectedPassphraseState?: string,
-  deriveCardano?: boolean
+  deriveCardano?: boolean,
+  onStatusRefreshed?: () => void
 ) => {
   const existsAttachPinUser = device.features?.attachToPinEnabled === true;
   const metadata = {
@@ -153,14 +159,19 @@ const selectDeviceSession = async (
       emitUiEvent: false,
       interaction: attachPinInteraction,
     });
+    onStatusRefreshed?.();
     return getDeviceSession(device, buildDeviceSessionGetRequest({ deriveCardano }));
   }
 
   if (hasHostPassphrase) {
-    await askDevicePassphrase(device, {
-      passphrase: hostPassphrase,
-      on_device: false,
-    });
+    await askDevicePassphrase(
+      device,
+      {
+        passphrase: hostPassphrase,
+        on_device: false,
+      },
+      onStatusRefreshed
+    );
     return getDeviceSession(device, buildDeviceSessionGetRequest({ deriveCardano }));
   }
 
@@ -172,7 +183,7 @@ const selectDeviceSession = async (
     ...metadata,
     ...(passphraseOnDeviceInteraction ? { interaction: passphraseOnDeviceInteraction } : {}),
   });
-  await askDevicePassphrase(device, { on_device: true });
+  await askDevicePassphrase(device, { on_device: true }, onStatusRefreshed);
   return getDeviceSession(device, buildDeviceSessionGetRequest({ deriveCardano }));
 };
 
@@ -191,6 +202,8 @@ export async function getProtocolV2WalletSession(
     deriveCardano?: boolean;
     /** Read the wallet already selected by Attach PIN without reopening wallet selection. */
     readCurrentAttachPinSession?: boolean;
+    /** The current call already selected the Main PIN during its unlock preflight. */
+    mainPinSelected?: boolean;
   }
 ) {
   const forceWalletSelection =
@@ -227,10 +240,16 @@ export async function getProtocolV2WalletSession(
       : undefined;
   let response;
   let resumed = false;
-  let mainPinSelected =
-    options?.onlyMainPin === true &&
-    device.features?.unlocked === true &&
-    device.features?.unlockedAttachPin === false;
+  let walletStatusRefreshed = false;
+  const markWalletStatusRefreshed = () => {
+    walletStatusRefreshed = true;
+  };
+  let mainPinAuthenticated =
+    options?.mainPinSelected === true ||
+    (options?.onlyMainPin === true &&
+      device.features?.unlocked === true &&
+      device.features?.unlockedAttachPin === false);
+  let standardWalletSelected = options?.mainPinSelected === true;
 
   const clearCurrentWalletSession = () => {
     if (options?.onlyMainPin) {
@@ -242,6 +261,7 @@ export async function getProtocolV2WalletSession(
 
   const rejectMismatchedAttachPinWallet = async () => {
     const features = await refreshProtocolV2DeviceStatus(device);
+    markWalletStatusRefreshed();
     if (features.unlockedAttachPin !== true) {
       return;
     }
@@ -265,30 +285,42 @@ export async function getProtocolV2WalletSession(
   }
 
   const selectMainPin = async (force = false) => {
-    if (force || !mainPinSelected) {
+    if (force || !mainPinAuthenticated) {
       await device.unlockDevice(DeviceSessionPinType.Main, {
         source: 'wallet-session-coordinator',
         reason: expectedPassphraseState ? 'session-recovery' : 'open-wallet',
         deviceOnly: true,
       });
-      mainPinSelected = true;
+      markWalletStatusRefreshed();
+      mainPinAuthenticated = true;
+      standardWalletSelected = true;
     }
   };
 
   const selectStandardWallet = async () => {
-    // Main PIN authenticates the device; an empty host passphrase selects the standard derivation.
-    await selectMainPin();
     if (device.features?.passphraseProtection === true) {
-      await askDevicePassphrase(device, {
-        passphrase: '',
-        on_device: false,
-      });
+      // Main PIN authenticates the device; an empty host passphrase selects the standard derivation.
+      await selectMainPin();
+      await askDevicePassphrase(
+        device,
+        {
+          passphrase: '',
+          on_device: false,
+        },
+        markWalletStatusRefreshed
+      );
+      standardWalletSelected = true;
+    } else if (!standardWalletSelected) {
+      // Without passphrase protection there is no empty-passphrase selector.
+      // Main PIN selection is the only authoritative switch back to the standard wallet.
+      await selectMainPin(true);
     }
   };
 
   if (readCurrentAttachPinSession) {
     const status = await requestProtocolV2DeviceStatus(device);
     device.updateProtocolV2Status(status);
+    markWalletStatusRefreshed();
     if (
       status.unlocked !== true ||
       status.passphrase_enabled !== true ||
@@ -372,7 +404,12 @@ export async function getProtocolV2WalletSession(
       device.clearInternalState();
       throw ERRORS.TypedError(HardwareErrorCode.WalletSessionInvalid);
     }
-    response = await selectDeviceSession(device, expectedPassphraseState, options?.deriveCardano);
+    response = await selectDeviceSession(
+      device,
+      expectedPassphraseState,
+      options?.deriveCardano,
+      markWalletStatusRefreshed
+    );
   }
 
   let { message } = response;
@@ -402,7 +439,12 @@ export async function getProtocolV2WalletSession(
       );
     } else {
       device.clearInternalState();
-      response = await selectDeviceSession(device, expectedPassphraseState, options?.deriveCardano);
+      response = await selectDeviceSession(
+        device,
+        expectedPassphraseState,
+        options?.deriveCardano,
+        markWalletStatusRefreshed
+      );
     }
     message = response.message;
     try {
@@ -438,7 +480,7 @@ export async function getProtocolV2WalletSession(
   let unlockedAttachPin: boolean | undefined;
   if (readCurrentAttachPinSession) {
     unlockedAttachPin = true;
-  } else if (mainPinSelected) {
+  } else if (mainPinAuthenticated) {
     unlockedAttachPin = false;
   }
 
@@ -447,6 +489,7 @@ export async function getProtocolV2WalletSession(
     newSession: message.session_id,
     unlockedAttachPin,
     resumed,
+    walletStatusRefreshed,
   };
 }
 

package/src/types/api/firmwareUpdate.ts

@@ -158,7 +158,7 @@ export interface FirmwareUpdateV4Params {
   se02Binary?: ArrayBuffer;
   se03Binary?: ArrayBuffer;
   se04Binary?: ArrayBuffer;
-  /** Complete Protocol V2 resource ZIP for local development; Core converts it to a local PreparedPlan. */
+  /** Complete Protocol V2 resource ZIP. Core parses RESC packages and writes only changed files. */
   resourceArchiveBinary?: ArrayBuffer;
   forcedUpdateRes?: boolean;
   artifactReader?: FirmwareArtifactReader;

package/src/types/api/firmwareUpdatePlan.ts

@@ -20,8 +20,8 @@ export interface FirmwareUpdatePlanArtifact {
   url: string;
   container: 'raw' | 'zip';
   logicalName?: string;
-  expectedSize: number;
-  expectedSha256: string;
+  expectedSize?: number;
+  expectedSha256?: string;
   targetVersion?: string;
 }
 

package/src/types/api/protocolV2.ts

@@ -68,7 +68,7 @@ export declare function deviceUploadNft(
 export declare function uploadPortfolio(
   connectId: string,
   params: {
-    packageBytes: ArrayBuffer | Uint8Array | Blob;
+    packageBase64: string;
     timeoutMs?: number | string;
   }
 ): Response<FileInfo & { portfolioUpdated: true }>;

package/src/types/device.ts

@@ -75,7 +75,8 @@ export type SearchDevice = {
   serialNo?: string | null;
   /**
    * @deprecated Ambiguous legacy identifier. Use serialNo for hardware identity
-   * and connectId for transport routing.
+   * and connectId for transport routing. Empty during BLE discovery until the
+   * physical serial number is available after initialization.
    */
   uuid: string;
   deviceId: string | null;

package/src/types/settings.ts

@@ -74,40 +74,11 @@ export type IProtocolV2Resources = {
   source: IProtocolV2ResourceSource;
 };
 
-export type IProtocolV2ResourceManifestFile = {
-  archive_path: string;
-  original_name: string;
-  device_path: string;
-  size: number;
-  sha256: string;
-  signed: true;
-  sig_algo: 'ed25519' | 'mldsa65';
-  payload_version: string | null;
-};
-
-export type IProtocolV2ResourceManifest = {
-  schema: 1;
-  artifact_name: string;
-  release_name: string;
-  variant: 'resource';
-  commit: string;
-  short_sha: string;
-  timestamp_utc: string;
-  core_version: string;
-  key_set: string;
-  device_root: 'vol0:';
-  restore_mode: 'bootloader_update';
-  trees: Array<{
-    path: string;
-    device: string;
-  }>;
-  files: IProtocolV2ResourceManifestFile[];
-};
-
 /** STM32 firmware config */
 export type IFirmwareReleaseInfo = {
   required: boolean;
-  url: string;
+  /** Legacy release artifact URL. Protocol V2 releases use component URLs. */
+  url?: string;
   /**
    * Firmware type (bitcoinonly or universal)
    * This field is not present in the remote config, but will be inferred from the firmware field name
@@ -131,10 +102,13 @@ export type IFirmwareReleaseInfo = {
   upgradeType?: 'payload-package-set' | string;
   components?: Record<string, IProtocolV2FirmwareComponent>;
   installOrder?: string[];
+  /** Protocol V2 resources matched to this firmware release. */
+  resources?: IProtocolV2Resources;
   bootloaderChangelog?: {
     [k in ILocale]: string;
   };
-  fingerprint: string;
+  /** Legacy release artifact SHA-256. Protocol V2 releases use component fingerprints. */
+  fingerprint?: string;
   expectedSize?: number;
   version: IVersionArray;
   changelog: {
@@ -167,8 +141,6 @@ type IDeviceReleaseInfo = {
   'firmware-v8'?: IFirmwareReleaseInfo[];
   'firmware-btc-v8'?: IFirmwareReleaseInfo[];
   ble?: IBLEFirmwareReleaseInfo[];
-  /** Independent Protocol V2 resource release configuration. */
-  resources?: IProtocolV2Resources;
 };
 
 export type DeviceTypeMap = {

package/src/utils/deviceFeaturesCompat.ts

@@ -1,4 +1,8 @@
-import { EDeviceType, EFirmwareType } from '@onekeyfe/hd-shared';
+import {
+  EDeviceType,
+  EFirmwareType,
+  canonicalizePro2BleAdvertisementName,
+} from '@onekeyfe/hd-shared';
 import { Enum_Capability } from '@onekeyfe/hd-transport';
 
 import type { PROTO } from '../constants';
@@ -125,9 +129,10 @@ export const resolveDeviceFirmwareType = (features?: DeviceFeaturesInput): EFirm
 export const resolveDeviceBleName = (features?: DeviceFeaturesInput): string | null => {
   if (!features) return null;
   const compatible = asCompatibleFeatures(features);
-  return (
-    firstNonEmptyString(compatible.bleName, compatible.onekey_ble_name, compatible.ble_name) ?? null
-  );
+  const bleName =
+    firstNonEmptyString(compatible.bleName, compatible.onekey_ble_name, compatible.ble_name) ??
+    null;
+  return bleName ? canonicalizePro2BleAdvertisementName(bleName) : null;
 };
 
 export const resolveDeviceFirmwareVersion = (features?: DeviceFeaturesInput): string | null => {

package/src/utils/deviceFeaturesUtils.ts

@@ -110,6 +110,7 @@ export const getPassphraseStateWithRefreshDeviceInfo = async (
     initSession?: boolean;
     deriveCardano?: boolean;
     rejectAttachPinForMainWallet?: boolean;
+    mainPinSelected?: boolean;
   }
 ) => {
   if (device.isProtocolV2()) {
@@ -127,6 +128,7 @@ export const getPassphraseStateWithRefreshDeviceInfo = async (
       onlyMainPin: options?.onlyMainPin,
       deriveCardano: options?.deriveCardano,
       rejectAttachPinForMainWallet: options?.rejectAttachPinForMainWallet,
+      mainPinSelected: options?.mainPinSelected,
     });
   }
 
@@ -194,6 +196,7 @@ export const getPassphraseState = async (
     initSession?: boolean;
     deriveCardano?: boolean;
     rejectAttachPinForMainWallet?: boolean;
+    mainPinSelected?: boolean;
   }
 ): Promise<{
   passphraseState: string | undefined;
@@ -216,6 +219,7 @@ export const getPassphraseState = async (
       onlyMainPin: options?.onlyMainPin,
       deriveCardano: options?.deriveCardano,
       rejectAttachPinForMainWallet: options?.rejectAttachPinForMainWallet,
+      mainPinSelected: options?.mainPinSelected,
     });
   }
 

package/src/utils/deviceInfoUtils.ts

@@ -30,8 +30,15 @@ export const getDeviceTypeByBleName = (name?: string): IDeviceType => {
   if (/^T/i.test(name)) return EDeviceType.Touch;
   if (/^Touch/i.test(name)) return EDeviceType.Touch;
 
-  if (/\bPro\s*2\b/i.test(name) || /^Pro2/i.test(name)) return EDeviceType.Pro2;
-  if (/\bNeo\b/i.test(name) || /^Neo/i.test(name)) return EDeviceType.Neo;
+  const compactName = name.replace(/[\s-]/g, '');
+  // Require a 4-hex Pro2 suffix in the compact form. A bare `^Pro2` prefix
+  // would also match OneKey Pro names such as "Pro 22D8" / "Pro 2D8F".
+  if (/\bPro\s*2\b/i.test(name) || /^(?:OneKey)?Pro2[a-f0-9]{4}$/i.test(compactName)) {
+    return EDeviceType.Pro2;
+  }
+  if (/\bNeo\b/i.test(name) || /^Neo/i.test(name) || /^(?:OneKey)?Neo/i.test(compactName)) {
+    return EDeviceType.Neo;
+  }
   if (/\bPro\b/i.test(name) || /^Pro/i.test(name)) return EDeviceType.Pro;
 
   return EDeviceType.Unknown;

package/src/utils/deviceSettings.ts

@@ -39,7 +39,14 @@ export const DEVICE_SETTINGS_V2_ONLY_FIELDS = [
   'randomKeypad',
 ] as const satisfies readonly DeviceSettingsField[];
 
-export const PROTOCOL_V2_NEVER_TIMEOUT_MS = 0x10000000;
+export const DEVICE_SETTINGS_NEVER_TIMEOUT_MS = 0x10000000;
+// Keep the protocol-specific name for compatibility with existing SDK consumers.
+export const PROTOCOL_V2_NEVER_TIMEOUT_MS = DEVICE_SETTINGS_NEVER_TIMEOUT_MS;
+
+const NEVER_TIMEOUT_MS_BY_PROTOCOL: Record<DeviceSettingsProtocol, number> = {
+  V1: DEVICE_SETTINGS_NEVER_TIMEOUT_MS,
+  V2: PROTOCOL_V2_NEVER_TIMEOUT_MS,
+};
 
 export const normalizeSafetyCheckLevel = (
   value: SafetyCheckLevel | null | undefined
@@ -148,7 +155,7 @@ export type DeviceSettingsValueOption<T> = {
 };
 
 const durationOption = (valueMs: number): DeviceSettingsDurationOption => {
-  if (valueMs === 0 || valueMs === PROTOCOL_V2_NEVER_TIMEOUT_MS) {
+  if (valueMs === DEVICE_SETTINGS_NEVER_TIMEOUT_MS) {
     return { label: 'Never', valueMs };
   }
   if (valueMs < 60_000) {
@@ -162,7 +169,7 @@ const withNever = (
   values: readonly number[],
   protocol: DeviceSettingsProtocol
 ): DeviceSettingsDurationOption[] =>
-  [...values, protocol === 'V2' ? PROTOCOL_V2_NEVER_TIMEOUT_MS : 0].map(durationOption);
+  [...values, NEVER_TIMEOUT_MS_BY_PROTOCOL[protocol]].map(durationOption);
 
 export const getAutoLockOptions = (
   deviceType: IDeviceType,
@@ -200,7 +207,7 @@ export const getAutoShutDownOptions = (
       return withNever([60_000, 120_000, 300_000, 600_000], protocol);
     case EDeviceType.Pro2:
     case EDeviceType.Neo:
-      return withNever([60_000, 120_000, 300_000, 600_000, 1_800_000], protocol);
+      return withNever([60_000, 120_000, 300_000, 600_000], protocol);
     default:
       return [];
   }

package/src/utils/index.ts

@@ -30,6 +30,7 @@ export {
   checkNeedUpdateBootForClassicAndMini,
 } from '../api/firmware/updateBootloader';
 export {
+  DEVICE_SETTINGS_NEVER_TIMEOUT_MS,
   DEVICE_SETTINGS_SHARED_FIELDS,
   DEVICE_SETTINGS_V1_ONLY_FIELDS,
   DEVICE_SETTINGS_V2_ONLY_FIELDS,

package/src/utils/pro2Nft.ts

@@ -109,6 +109,34 @@ export function buildPro2NftBundle(options: {
   const { image, thumbnail, title, subtitle, timestampMs } = options;
   assertImage('image', image, PRO2_NFT_IMAGE_WIDTH, PRO2_NFT_IMAGE_HEIGHT);
   assertImage('thumbnail', thumbnail, PRO2_NFT_THUMBNAIL_WIDTH, PRO2_NFT_THUMBNAIL_HEIGHT);
+  const encodedImage = encodePro2Image({ ...image, alphaMode: 'black-background' }).data;
+  const encodedThumbnail = encodePro2Image({
+    ...thumbnail,
+    alphaMode: 'black-background',
+  }).data;
+  return buildPro2NftBundleFromEncodedImages({
+    image: encodedImage,
+    thumbnail: encodedThumbnail,
+    title,
+    subtitle,
+    timestampMs,
+  });
+}
+
+export function buildPro2NftBundleFromEncodedImages(options: {
+  image: Uint8Array;
+  thumbnail: Uint8Array;
+  title: string;
+  subtitle: string;
+  timestampMs: number;
+}): Pro2NftBundle {
+  const { image, thumbnail, title, subtitle, timestampMs } = options;
+  if (!(image instanceof Uint8Array) || image.byteLength === 0) {
+    throw invalidParameter('Parameter [image] must contain encoded NFT image data.');
+  }
+  if (!(thumbnail instanceof Uint8Array) || thumbnail.byteLength === 0) {
+    throw invalidParameter('Parameter [thumbnail] must contain encoded NFT thumbnail data.');
+  }
   const titleLength = typeof title === 'string' ? utf8Length(title) : 0;
   const subtitleLength =
     typeof subtitle === 'string' ? utf8Length(subtitle) : Number.POSITIVE_INFINITY;
@@ -122,21 +150,16 @@ export function buildPro2NftBundle(options: {
     throw invalidParameter('Parameter [timestampMs] must be a positive safe integer.');
   }
 
-  const encodedImage = encodePro2Image({ ...image, alphaMode: 'black-background' }).data;
-  const encodedThumbnail = encodePro2Image({
-    ...thumbnail,
-    alphaMode: 'black-background',
-  }).data;
   const metadata = new TextEncoder().encode(JSON.stringify({ title, subtitle }));
   if (metadata.byteLength === 0 || metadata.byteLength > 512) {
     throw invalidParameter('Pro2 NFT metadata must contain 1 to 512 UTF-8 bytes.');
   }
 
-  const hash8 = bytesToHex(blake2s(encodedImage)).slice(0, 8);
+  const hash8 = bytesToHex(blake2s(image)).slice(0, 8);
   return {
     basename: `nft-${hash8}-${timestampMs}`,
-    image: encodedImage,
-    thumbnail: encodedThumbnail,
+    image,
+    thumbnail,
     metadata,
   };
 }

package/__tests__/firmware-memory-host.test.ts

@@ -1,126 +0,0 @@
-import { prepareFirmwareUpdateV4MemoryHost } from '../src/api/firmware/FirmwareMemoryHost';
-
-import type { CoreApi } from '../src/types/api';
-import type { FirmwareUpdatePlan } from '../src/types/api/firmwareUpdatePlan';
-
-describe('prepareFirmwareUpdateV4MemoryHost', () => {
-  test('registers artifact-backed component and resource readers', async () => {
-    const componentBinary = new Uint8Array([1, 2, 3, 4]).buffer;
-    const archiveBinary = new Uint8Array([5, 6]).buffer;
-    const manifestBinary = new TextEncoder().encode('{"schema":1}').buffer;
-    let artifactReader: Parameters<
-      CoreApi['registerFirmwareUpdateHostBinding']
-    >[0]['artifactReader'];
-    const unregisterFirmwareUpdateHostBinding = jest.fn();
-    const sdk = {
-      prepareFirmwareUpdatePlan: jest.fn(({ plan, artifacts }) => ({
-        schemaVersion: 2,
-        preparedPlanDigest: 'b'.repeat(64),
-        planDigest: plan.planDigest,
-        networkPolicy: 'forbid',
-        executor: plan.executor,
-        deviceIdentity: plan.deviceIdentity,
-        deviceModel: plan.deviceModel,
-        firmwareType: plan.firmwareType,
-        platform: plan.platform,
-        leaseRef: 'test-lease',
-        targetsToUpdate: plan.targetsToUpdate,
-        artifacts: plan.artifacts.map(planArtifact => {
-          const input = artifacts.find(item => item.artifactId === planArtifact.artifactId);
-          return {
-            ...planArtifact,
-            artifact: input?.artifact,
-            materializedEntries: input?.materializedEntries,
-          };
-        }),
-      })),
-      registerFirmwareUpdateHostBinding: jest.fn(binding => {
-        artifactReader = binding.artifactReader;
-        return 7;
-      }),
-      unregisterFirmwareUpdateHostBinding,
-    } as unknown as Pick<
-      CoreApi,
-      | 'prepareFirmwareUpdatePlan'
-      | 'registerFirmwareUpdateHostBinding'
-      | 'unregisterFirmwareUpdateHostBinding'
-    >;
-    const plan = {
-      schemaVersion: 2,
-      planDigest: 'a'.repeat(64),
-      executor: 'v4',
-      deviceIdentity: 'device-id',
-      deviceModel: 'pro2',
-      firmwareType: 0,
-      platform: 'web',
-      targetsToUpdate: ['boot', 'resource'],
-      artifacts: [
-        {
-          artifactId: 'component:boot',
-          role: 'component',
-          target: 'boot',
-          url: 'https://example.com/boot.okpkg',
-          container: 'raw',
-        },
-        {
-          artifactId: 'resource:archive',
-          role: 'resourceBundle',
-          target: 'resource',
-          url: 'https://example.com/resource.zip',
-          container: 'zip',
-          logicalName: 'resource-archive',
-        },
-      ],
-    } as FirmwareUpdatePlan;
-
-    const host = prepareFirmwareUpdateV4MemoryHost({
-      sdk,
-      plan,
-      artifacts: [
-        { artifactId: 'component:boot', binary: componentBinary },
-        {
-          artifactId: 'resource:archive',
-          binary: archiveBinary,
-          materializedEntries: [{ entryName: 'manifest.json', binary: manifestBinary }],
-        },
-      ],
-    });
-
-    expect(host.hostBindingGeneration).toBe(7);
-    expect(sdk.registerFirmwareUpdateHostBinding).toHaveBeenCalledWith(
-      expect.objectContaining({ preparedPlanDigest: host.preparedPlan.preparedPlanDigest })
-    );
-    const componentArtifact = host.preparedPlan.artifacts.find(
-      artifact => artifact.target === 'boot'
-    )?.artifact;
-    const resourceEntryArtifact = host.preparedPlan.artifacts.find(
-      artifact => artifact.target === 'resource'
-    )?.materializedEntries?.[0]?.artifact;
-    expect(componentArtifact?.size).toBe(componentBinary.byteLength);
-    expect(resourceEntryArtifact?.size).toBe(manifestBinary.byteLength);
-    if (!artifactReader || !componentArtifact || !resourceEntryArtifact) {
-      throw new Error('Firmware memory host test setup is incomplete');
-    }
-    new Uint8Array(componentBinary).fill(9);
-    const opened = await artifactReader.open({
-      artifactRef: componentArtifact.artifactRef,
-    });
-    const chunk = await artifactReader.read({
-      readerId: opened.readerId,
-      offset: 1,
-      length: 2,
-    });
-    expect(Array.from(new Uint8Array(chunk.data))).toEqual([2, 3]);
-    await artifactReader.close({ readerId: opened.readerId });
-
-    // Materialized ZIP entries are receipts only. Execution opens the approved
-    // archive and re-derives these bytes, so the memory host must not retain a
-    // second readable copy of every expanded resource file.
-    expect(() => artifactReader.open({ artifactRef: resourceEntryArtifact.artifactRef })).toThrow(
-      'Firmware memory artifact is unavailable'
-    );
-
-    host.release();
-    expect(unregisterFirmwareUpdateHostBinding).toHaveBeenCalledWith(7);
-  });
-});

package/dist/api/firmware/FirmwareMemoryHost.d.ts

@@ -1,22 +0,0 @@
-import type { CoreApi } from '../../types/api';
-import type { FirmwareUpdatePlan } from '../../types/api/firmwareUpdatePlan';
-export type FirmwareMemoryArtifactEntry = {
-    entryName: string;
-    binary: ArrayBuffer;
-};
-export type FirmwareMemoryArtifact = {
-    artifactId: string;
-    binary: ArrayBuffer;
-    materializedEntries?: FirmwareMemoryArtifactEntry[];
-};
-export type FirmwareUpdateV4MemoryHost = {
-    preparedPlan: ReturnType<CoreApi['prepareFirmwareUpdatePlan']>;
-    hostBindingGeneration: number;
-    release: () => void;
-};
-export declare function prepareFirmwareUpdateV4MemoryHost({ sdk, plan, artifacts, }: {
-    sdk: Pick<CoreApi, 'prepareFirmwareUpdatePlan' | 'registerFirmwareUpdateHostBinding' | 'unregisterFirmwareUpdateHostBinding'>;
-    plan: FirmwareUpdatePlan;
-    artifacts: FirmwareMemoryArtifact[];
-}): FirmwareUpdateV4MemoryHost;
-//# sourceMappingURL=FirmwareMemoryHost.d.ts.map

package/dist/api/firmware/FirmwareMemoryHost.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FirmwareMemoryHost.d.ts","sourceRoot":"","sources":["../../../src/api/firmware/FirmwareMemoryHost.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,mBAAmB,CAAC,EAAE,2BAA2B,EAAE,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAC/D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAaF,wBAAgB,iCAAiC,CAAC,EAChD,GAAG,EACH,IAAI,EACJ,SAAS,GACV,EAAE;IACD,GAAG,EAAE,IAAI,CACP,OAAO,EACL,2BAA2B,GAC3B,mCAAmC,GACnC,qCAAqC,CACxC,CAAC;IACF,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC,GAAG,0BAA0B,CA0F7B"}