@ledgerhq/device-core 0.2.1-next.2 → 0.3.0-nightly.0

package/lib-es/commands/use-cases/app-backup/restoreAppStorageCommit.js

@@ -0,0 +1,78 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { StatusCodes, TransportStatusError } from "@ledgerhq/hw-transport";
+import { LocalTracer } from "@ledgerhq/logs";
+import { GenerateAesKeyFailed, InternalComputeAesCmacFailed, InvalidChunkLength, InvalidContext, } from "../../../errors";
+/**
+ * Name in documentation: INS_APP_STORAGE_RESTORE_COMMIT
+ * cla: 0xe0
+ * ins: 0x6e
+ * p1: 0x00
+ * p2: 0x00
+ * lc: 0x00
+ */
+const RESTORE_APP_STORAGE_COMMIT = [0xe0, 0x6e, 0x00, 0x00];
+/**
+ * 0x9000: Success.
+ * 0x5123: Invalid context, Restore Init must be called first.
+ * 0x5419: Internal error, crypto operaiton failed.
+ * 0x541B: Failed to verify backup authenticity.
+ * 0x662F: Invalid device state, recovery mode.
+ * 0x6734: Invalid size of the restored app storage.
+ */
+const RESPONSE_STATUS_SET = [
+    StatusCodes.OK,
+    StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+    StatusCodes.GEN_AES_KEY_FAILED,
+    StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED,
+    StatusCodes.DEVICE_IN_RECOVERY_MODE,
+    StatusCodes.INVALID_CHUNK_LENGTH,
+];
+/**
+ * Restores the application storage commit.
+ *
+ * @param transport - The transport object used for communication with the device.
+ * @returns A promise that resolves to void.
+ */
+export function restoreAppStorageCommit(transport) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const tracer = new LocalTracer("hw", {
+            transport: transport.getTraceContext(),
+            function: "restoreAppStorageCommit",
+        });
+        tracer.trace("Start");
+        const apdu = [...RESTORE_APP_STORAGE_COMMIT, Buffer.from([0x00])];
+        const response = yield transport.send(...apdu, RESPONSE_STATUS_SET);
+        parseResponse(response);
+    });
+}
+export function parseResponse(data) {
+    const tracer = new LocalTracer("hw", {
+        function: "parseResponse@restoreAppStorageCommit",
+    });
+    const status = data.readUInt16BE(data.length - 2);
+    tracer.trace("Result status from 0xe06e0000", { status });
+    switch (status) {
+        case StatusCodes.OK:
+            return;
+        case StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT:
+            throw new InvalidContext("Invalid context, restoreAppStorageInit must be called first.");
+        case StatusCodes.GEN_AES_KEY_FAILED:
+            throw new GenerateAesKeyFailed("Internal error, crypto operation failed.");
+        case StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED:
+            throw new InternalComputeAesCmacFailed("Failed to verify backup authenticity.");
+        case StatusCodes.DEVICE_IN_RECOVERY_MODE:
+            break;
+        case StatusCodes.INVALID_CHUNK_LENGTH:
+            throw new InvalidChunkLength("Invalid size of the restored app storage.");
+    }
+    throw new TransportStatusError(status);
+}
+//# sourceMappingURL=restoreAppStorageCommit.js.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageCommit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageCommit.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageCommit.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAa;IACpC,WAAW,CAAC,EAAE;IACd,WAAW,CAAC,gCAAgC;IAC5C,WAAW,CAAC,kBAAkB;IAC9B,WAAW,CAAC,gCAAgC;IAC5C,WAAW,CAAC,uBAAuB;IACnC,WAAW,CAAC,oBAAoB;CACjC,CAAC;AAEF;;;;;GAKG;AAEH,MAAM,UAAgB,uBAAuB,CAAC,SAAoB;;QAChE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;YACnC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE;YACtC,QAAQ,EAAE,yBAAyB;SACpC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,IAAI,GAAmB,CAAC,GAAG,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAElF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAEpE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;CAAA;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,uCAAuC;KAClD,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW,CAAC,EAAE;YACjB,OAAO;QACT,KAAK,WAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,cAAc,CAAC,8DAA8D,CAAC,CAAC;QAC3F,KAAK,WAAW,CAAC,kBAAkB;YACjC,MAAM,IAAI,oBAAoB,CAAC,0CAA0C,CAAC,CAAC;QAC7E,KAAK,WAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,4BAA4B,CAAC,uCAAuC,CAAC,CAAC;QAClF,KAAK,WAAW,CAAC,uBAAuB;YACtC,MAAM;QACR,KAAK,WAAW,CAAC,oBAAoB;YACnC,MAAM,IAAI,kBAAkB,CAAC,2CAA2C,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/lib-es/commands/use-cases/app-backup/restoreAppStorageCommit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restoreAppStorageCommit.test.d.ts.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageCommit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageCommit.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageCommit.test.ts"],"names":[],"mappings":""}

package/lib-es/commands/use-cases/app-backup/restoreAppStorageCommit.test.js

@@ -0,0 +1,47 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { StatusCodes } from "@ledgerhq/hw-transport";
+import { restoreAppStorageCommit, parseResponse } from "./restoreAppStorageCommit";
+import { InvalidChunkLength } from "../../../errors";
+jest.mock("@ledgerhq/hw-transport");
+describe("restoreAppStorageCommit", () => {
+    let transport;
+    const response = Buffer.from([0x90, 0x00]);
+    beforeEach(() => {
+        transport = {
+            send: jest.fn().mockResolvedValue(response),
+            getTraceContext: jest.fn().mockResolvedValue(undefined),
+        };
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    it("should call the send function with correct parameters", () => __awaiter(void 0, void 0, void 0, function* () {
+        yield restoreAppStorageCommit(transport);
+        expect(transport.send).toHaveBeenCalledWith(0xe0, 0x6e, 0x00, 0x00, Buffer.from([0x00]), [
+            StatusCodes.OK,
+            StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+            StatusCodes.GEN_AES_KEY_FAILED,
+            StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED,
+            StatusCodes.DEVICE_IN_RECOVERY_MODE,
+            StatusCodes.INVALID_CHUNK_LENGTH,
+        ]);
+    }));
+    describe("parseResponse", () => {
+        it("should parse the response data correctly", () => {
+            expect(() => parseResponse(response)).not.toThrow();
+        });
+        it("should throw TransportStatusError if the response status is invalid", () => {
+            const data = Buffer.from([0x67, 0x34]);
+            expect(() => parseResponse(data)).toThrow(new InvalidChunkLength("Invalid size of the restored app storage."));
+        });
+    });
+});
+//# sourceMappingURL=restoreAppStorageCommit.test.js.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageCommit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageCommit.test.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageCommit.test.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAEpC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,SAAoB,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAE3C,UAAU,CAAC,GAAG,EAAE;QACd,SAAS,GAAG;YACV,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC3C,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAChC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAS,EAAE;QACrE,MAAM,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE;YACvF,WAAW,CAAC,EAAE;YACd,WAAW,CAAC,gCAAgC;YAC5C,WAAW,CAAC,kBAAkB;YAC9B,WAAW,CAAC,gCAAgC;YAC5C,WAAW,CAAC,uBAAuB;YACnC,WAAW,CAAC,oBAAoB;SACjC,CAAC,CAAC;IACL,CAAC,CAAA,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CACvC,IAAI,kBAAkB,CAAC,2CAA2C,CAAC,CACpE,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="node" />
+import Transport from "@ledgerhq/hw-transport";
+/**
+ * Restores the application storage initialization.
+ *
+ * @param transport - The transport object used for communication with the device.
+ * @param appName - The name of the application to restore the storage for.
+ * @param backupSize - The size of the backup to restore.
+ * @returns A promise that resolves to void.
+ */
+export declare function restoreAppStorageInit(transport: Transport, appName: string, backupSize: number): Promise<void>;
+export declare function parseResponse(data: Buffer): void;
+//# sourceMappingURL=restoreAppStorageInit.d.ts.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageInit.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageInit.ts"],"names":[],"mappings":";AAAA,OAAO,SAAgD,MAAM,wBAAwB,CAAC;AAwCtF;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAwBhD"}

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.js

@@ -0,0 +1,94 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { StatusCodes, TransportStatusError } from "@ledgerhq/hw-transport";
+import { LocalTracer } from "@ledgerhq/logs";
+import { AppNotFound, InvalidAppNameLength, InvalidBackupLength, PinNotSet } from "../../../errors";
+/**
+ * Name in documentation: INS_APP_STORAGE_RESTORE_INIT
+ * cla: 0xe0
+ * ins: 0x6c
+ * p1: 0x00
+ * p2: 0x00
+ * data:
+ *  - LC: BACKUP_LEN_LEN (=0x04) + APP_NAME_LEN (1 byte)
+ *  - DATA: BACKUP_LEN + APP_NAME
+ *
+ * For example, the 'bitcoin' app with backup of length 0x00007000:
+ *    1. LC is 0x0b
+ *    2. DATA is 0x00007000 0x626974636f696e
+ */
+const RESTORE_APP_STORAGE_INIT = [0xe0, 0x6c, 0x00, 0x00];
+/**
+ * 0x9000: Success.
+ * 0x5123: Application not found.
+ * 0x662F: Invalid device state, recovery mode.
+ * 0x5501: Invalid consent, user rejected.
+ * 0x5502: Invalid consent, pin is not set.
+ * 0x670A: Invalid application name length, two chars minimum.
+ * 0x6733: Invalid BACKUP_LEN value.
+ */
+const RESPONSE_STATUS_SET = [
+    StatusCodes.OK,
+    StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+    StatusCodes.DEVICE_IN_RECOVERY_MODE,
+    StatusCodes.USER_REFUSED_ON_DEVICE,
+    StatusCodes.PIN_NOT_SET,
+    StatusCodes.INVALID_APP_NAME_LENGTH,
+    StatusCodes.INVALID_BACKUP_LENGTH,
+];
+/**
+ * Restores the application storage initialization.
+ *
+ * @param transport - The transport object used for communication with the device.
+ * @param appName - The name of the application to restore the storage for.
+ * @param backupSize - The size of the backup to restore.
+ * @returns A promise that resolves to void.
+ */
+export function restoreAppStorageInit(transport, appName, backupSize) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const tracer = new LocalTracer("hw", {
+            transport: transport.getTraceContext(),
+            function: "restoreAppStorageInit",
+        });
+        tracer.trace("Start");
+        const params = Buffer.concat([
+            Buffer.from([appName.length + 4]), // LC
+            Buffer.from(backupSize.toString(16).padStart(8, "0"), "hex"), // BACKUP_LEN
+            Buffer.from(appName, "ascii"), // APP_NAME
+        ]);
+        const apdu = [...RESTORE_APP_STORAGE_INIT, params];
+        const response = yield transport.send(...apdu, RESPONSE_STATUS_SET);
+        parseResponse(response);
+    });
+}
+export function parseResponse(data) {
+    const tracer = new LocalTracer("hw", {
+        function: "parseResponse@restoreAppStorageInit",
+    });
+    const status = data.readUInt16BE(data.length - 2);
+    tracer.trace("Result status from 0xe06c0000", { status });
+    switch (status) {
+        case StatusCodes.OK:
+            return;
+        case StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT:
+            throw new AppNotFound("Application not found.");
+        case StatusCodes.DEVICE_IN_RECOVERY_MODE:
+        case StatusCodes.USER_REFUSED_ON_DEVICE:
+            break;
+        case StatusCodes.PIN_NOT_SET:
+            throw new PinNotSet("Invalid consent, PIN is not set.");
+        case StatusCodes.INVALID_APP_NAME_LENGTH:
+            throw new InvalidAppNameLength("Invalid application name length, two chars minimum.");
+        case StatusCodes.INVALID_BACKUP_LENGTH:
+            throw new InvalidBackupLength("Invalid backup length.");
+    }
+    throw new TransportStatusError(status);
+}
+//# sourceMappingURL=restoreAppStorageInit.js.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageInit.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageInit.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAkB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEpG;;;;;;;;;;;;;GAaG;AACH,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAa;IACpC,WAAW,CAAC,EAAE;IACd,WAAW,CAAC,gCAAgC;IAC5C,WAAW,CAAC,uBAAuB;IACnC,WAAW,CAAC,sBAAsB;IAClC,WAAW,CAAC,WAAW;IACvB,WAAW,CAAC,uBAAuB;IACnC,WAAW,CAAC,qBAAqB;CAClC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAgB,qBAAqB,CACzC,SAAoB,EACpB,OAAe,EACf,UAAkB;;QAElB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;YACnC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE;YACtC,QAAQ,EAAE,uBAAuB;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,MAAM,GAAW,MAAM,CAAC,MAAM,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK;YACxC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,aAAa;YAC3E,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW;SAC3C,CAAC,CAAC;QACH,MAAM,IAAI,GAAmB,CAAC,GAAG,wBAAwB,EAAE,MAAM,CAAC,CAAC;QAEnE,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAEpE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;CAAA;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,qCAAqC;KAChD,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW,CAAC,EAAE;YACjB,OAAO;QACT,KAAK,WAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC;QAClD,KAAK,WAAW,CAAC,uBAAuB,CAAC;QACzC,KAAK,WAAW,CAAC,sBAAsB;YACrC,MAAM;QACR,KAAK,WAAW,CAAC,WAAW;YAC1B,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC1D,KAAK,WAAW,CAAC,uBAAuB;YACtC,MAAM,IAAI,oBAAoB,CAAC,qDAAqD,CAAC,CAAC;QACxF,KAAK,WAAW,CAAC,qBAAqB;YACpC,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restoreAppStorageInit.test.d.ts.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageInit.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageInit.test.ts"],"names":[],"mappings":""}

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.test.js

@@ -0,0 +1,50 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { StatusCodes } from "@ledgerhq/hw-transport";
+import { restoreAppStorageInit, parseResponse } from "./restoreAppStorageInit";
+import { InvalidAppNameLength } from "../../../errors";
+jest.mock("@ledgerhq/hw-transport");
+describe("restoreAppStorageInit", () => {
+    let transport;
+    const response = Buffer.from([0x90, 0x00]);
+    beforeEach(() => {
+        transport = {
+            send: jest.fn().mockResolvedValue(response),
+            getTraceContext: jest.fn().mockResolvedValue(undefined),
+        };
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    it("should call the send function with correct parameters", () => __awaiter(void 0, void 0, void 0, function* () {
+        const appName = "MyApp";
+        const backupSize = 1234;
+        yield restoreAppStorageInit(transport, appName, backupSize);
+        expect(transport.send).toHaveBeenCalledWith(0xe0, 0x6c, 0x00, 0x00, Buffer.from([0x09, 0x00, 0x00, 0x04, 0xd2, 0x4d, 0x79, 0x41, 0x70, 0x70]), [
+            StatusCodes.OK,
+            StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+            StatusCodes.DEVICE_IN_RECOVERY_MODE,
+            StatusCodes.USER_REFUSED_ON_DEVICE,
+            StatusCodes.PIN_NOT_SET,
+            StatusCodes.INVALID_APP_NAME_LENGTH,
+            StatusCodes.INVALID_BACKUP_LENGTH,
+        ]);
+    }));
+    describe("parseResponse", () => {
+        it("should parse the response data correctly", () => {
+            expect(() => parseResponse(response)).not.toThrow();
+        });
+        it("should throw TransportStatusError if the response status is invalid", () => {
+            const data = Buffer.from([0x67, 0x0a]);
+            expect(() => parseResponse(data)).toThrow(new InvalidAppNameLength("Invalid application name length, two chars minimum."));
+        });
+    });
+});
+//# sourceMappingURL=restoreAppStorageInit.test.js.map

package/lib-es/commands/use-cases/app-backup/restoreAppStorageInit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorageInit.test.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorageInit.test.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAEpC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,IAAI,SAAoB,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAE3C,UAAU,CAAC,GAAG,EAAE;QACd,SAAS,GAAG;YACV,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC3C,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAChC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAS,EAAE;QACrE,MAAM,OAAO,GAAG,OAAO,CAAC;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC;QACxB,MAAM,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5D,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACzC,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EACzE;YACE,WAAW,CAAC,EAAE;YACd,WAAW,CAAC,gCAAgC;YAC5C,WAAW,CAAC,uBAAuB;YACnC,WAAW,CAAC,sBAAsB;YAClC,WAAW,CAAC,WAAW;YACvB,WAAW,CAAC,uBAAuB;YACnC,WAAW,CAAC,qBAAqB;SAClC,CACF,CAAC;IACJ,CAAC,CAAA,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CACvC,IAAI,oBAAoB,CAAC,qDAAqD,CAAC,CAChF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib-es/errors.d.ts

@@ -0,0 +1,40 @@
+export declare const AppNotFound: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidContext: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidAppNameLength: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const GenerateAesKeyFailed: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InternalCryptoOperationFailed: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InternalComputeAesCmacFailed: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const EncryptAppStorageFailed: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const PinNotSet: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidBackupHeader: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidBackupLength: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidBackupState: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidRestoreState: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+export declare const InvalidChunkLength: import("@ledgerhq/errors/lib/helpers").LedgerErrorConstructor<{
+    [key: string]: unknown;
+}>;
+//# sourceMappingURL=errors.d.ts.map

package/lib-es/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;EAAwC,CAAC;AACjE,eAAO,MAAM,cAAc;;EAA2C,CAAC;AAEvE,eAAO,MAAM,oBAAoB;;EAAiD,CAAC;AAEnF,eAAO,MAAM,oBAAoB;;EAAiD,CAAC;AAEnF,eAAO,MAAM,6BAA6B;;EAEzC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;EAAyD,CAAC;AAEnG,eAAO,MAAM,uBAAuB;;EAAoD,CAAC;AAEzF,eAAO,MAAM,SAAS;;EAAsC,CAAC;AAE7D,eAAO,MAAM,mBAAmB;;EAAgD,CAAC;AAEjF,eAAO,MAAM,mBAAmB;;EAAgD,CAAC;AAEjF,eAAO,MAAM,kBAAkB;;EAA+C,CAAC;AAE/E,eAAO,MAAM,mBAAmB;;EAAgD,CAAC;AAEjF,eAAO,MAAM,kBAAkB;;EAA+C,CAAC"}

package/lib-es/errors.js

@@ -0,0 +1,27 @@
+import { createCustomErrorClass } from "@ledgerhq/errors";
+// 0x5123
+export const AppNotFound = createCustomErrorClass("AppNotFound");
+export const InvalidContext = createCustomErrorClass("InvalidContext");
+// 0x670a
+export const InvalidAppNameLength = createCustomErrorClass("InvalidAppNameLength");
+// 0x5419
+export const GenerateAesKeyFailed = createCustomErrorClass("GenerateAesKeyFailed");
+// 0x541a
+export const InternalCryptoOperationFailed = createCustomErrorClass("InternalCryptoOperationFailed");
+// 0x541b
+export const InternalComputeAesCmacFailed = createCustomErrorClass("InternalComputeAesCmacFailed");
+// 0x541c
+export const EncryptAppStorageFailed = createCustomErrorClass("EncryptAppStorageFailed");
+// 0x5502
+export const PinNotSet = createCustomErrorClass("PinNotSet");
+// 0x684a
+export const InvalidBackupHeader = createCustomErrorClass("InvalidBackupHeader");
+// 0x6733
+export const InvalidBackupLength = createCustomErrorClass("InvalidBackupLength");
+// 0x6642
+export const InvalidBackupState = createCustomErrorClass("InvalidBackupState");
+// 0x6643
+export const InvalidRestoreState = createCustomErrorClass("InvalidRestoreState");
+// 0x6734
+export const InvalidChunkLength = createCustomErrorClass("InvalidChunkLength");
+//# sourceMappingURL=errors.js.map

package/lib-es/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,SAAS;AACT,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;AACvE,SAAS;AACT,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;AACnF,SAAS;AACT,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;AACnF,SAAS;AACT,MAAM,CAAC,MAAM,6BAA6B,GAAG,sBAAsB,CACjE,+BAA+B,CAChC,CAAC;AACF,SAAS;AACT,MAAM,CAAC,MAAM,4BAA4B,GAAG,sBAAsB,CAAC,8BAA8B,CAAC,CAAC;AACnG,SAAS;AACT,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,yBAAyB,CAAC,CAAC;AACzF,SAAS;AACT,MAAM,CAAC,MAAM,SAAS,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAC7D,SAAS;AACT,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;AACjF,SAAS;AACT,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;AACjF,SAAS;AACT,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;AAC/E,SAAS;AACT,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;AACjF,SAAS;AACT,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,oBAAoB,CAAC,CAAC"}

package/lib-es/index.d.ts

@@ -16,6 +16,12 @@ export { getDeviceName } from "./commands/use-cases/getDeviceName";
 export { isHardwareVersionSupported } from "./commands/use-cases/isHardwareVersionSupported";
 export { isBootloaderVersionSupported } from "./commands/use-cases/isBootloaderVersionSupported";
 export { getVersion } from "./commands/use-cases/getVersion";
+export type { AppStorageInfo } from "./commands/entities/AppStorageInfo";
+export { backupAppStorage } from "./commands/use-cases/app-backup/backupAppStorage";
+export { getAppStorageInfo } from "./commands/use-cases/app-backup/getAppStorageInfo";
+export { restoreAppStorage } from "./commands/use-cases/app-backup/restoreAppStorage";
+export { restoreAppStorageCommit } from "./commands/use-cases/app-backup/restoreAppStorageCommit";
+export { restoreAppStorageInit } from "./commands/use-cases/app-backup/restoreAppStorageInit";
 export { type CLSSupportedDeviceModelId, isCustomLockScreenSupported, } from "./capabilities/isCustomLockScreenSupported";
 export { isEditDeviceNameSupported } from "./capabilities/isEditDeviceNameSupported";
 export { isSyncOnboardingSupported } from "./capabilities/isSyncOnboardingSupported";

package/lib-es/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,2BAA2B,GAC5B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAEzF,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,2BAA2B,GAC5B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAEzF,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,uDAAuD,CAAC;AAE9F,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/lib-es/index.js

@@ -12,6 +12,11 @@ export { getDeviceName } from "./commands/use-cases/getDeviceName";
 export { isHardwareVersionSupported } from "./commands/use-cases/isHardwareVersionSupported";
 export { isBootloaderVersionSupported } from "./commands/use-cases/isBootloaderVersionSupported";
 export { getVersion } from "./commands/use-cases/getVersion";
+export { backupAppStorage } from "./commands/use-cases/app-backup/backupAppStorage";
+export { getAppStorageInfo } from "./commands/use-cases/app-backup/getAppStorageInfo";
+export { restoreAppStorage } from "./commands/use-cases/app-backup/restoreAppStorage";
+export { restoreAppStorageCommit } from "./commands/use-cases/app-backup/restoreAppStorageCommit";
+export { restoreAppStorageInit } from "./commands/use-cases/app-backup/restoreAppStorageInit";
 // src/capabilities/
 export { isCustomLockScreenSupported, } from "./capabilities/isCustomLockScreenSupported";
 export { isEditDeviceNameSupported } from "./capabilities/isEditDeviceNameSupported";

package/lib-es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,oBAAoB;AACpB,OAAO,EAEL,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,wBAAwB;AACxB,cAAc,gCAAgC,CAAC;AAC/C,sBAAsB;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,oBAAoB;AACpB,OAAO,EAEL,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,wBAAwB;AACxB,cAAc,gCAAgC,CAAC;AAC/C,sBAAsB;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/device-core",
-  "version": "0.2.1-next.2",
+  "version": "0.3.0-nightly.0",
   "description": "Ledger Live device core module",
   "license": "Apache-2.0",
   "keywords": [
@@ -20,12 +20,12 @@
   "dependencies": {
     "sha.js": "^2.4.11",
     "semver": "^7.3.5",
-    "@ledgerhq/errors": "^6.17.0",
-    "@ledgerhq/live-network": "^1.3.0",
-    "@ledgerhq/hw-transport": "^6.31.0",
+    "@ledgerhq/errors": "^6.18.0-nightly.0",
+    "@ledgerhq/live-network": "^1.3.1-nightly.0",
+    "@ledgerhq/hw-transport": "^6.31.1-nightly.0",
     "@ledgerhq/logs": "^6.12.0",
-    "@ledgerhq/devices": "^8.4.0",
-    "@ledgerhq/types-live": "^6.48.1-next.0"
+    "@ledgerhq/devices": "^8.4.1-nightly.0",
+    "@ledgerhq/types-live": "^6.48.1-nightly.0"
   },
   "devDependencies": {
     "@testing-library/react": "14",

package/src/commands/entities/AppStorageInfo.ts

@@ -0,0 +1,7 @@
+export type AppStorageInfo = {
+  size: number;
+  dataVersion: string;
+  hasSettings: boolean;
+  hasData: boolean;
+  hash: string;
+};

package/src/commands/use-cases/app-backup/backupAppStorage.test.ts

@@ -0,0 +1,52 @@
+import Transport, { StatusCodes } from "@ledgerhq/hw-transport";
+import { backupAppStorage, parseResponse } from "./backupAppStorage";
+import { InternalComputeAesCmacFailed } from "../../../errors";
+
+jest.mock("@ledgerhq/hw-transport");
+
+describe("backupAppStorage", () => {
+  let transport: Transport;
+  const response = Buffer.from([
+    0x31, 0x30, 0x36, 0x52, 0x75, 0x65, 0x64, 0x75, 0x54, 0x65, 0x6d, 0x70, 0x6c, 0x65, 0x90, 0x00,
+  ]);
+
+  beforeEach(() => {
+    transport = {
+      send: jest.fn().mockResolvedValue(response),
+      getTraceContext: jest.fn().mockResolvedValue(undefined),
+    } as unknown as Transport;
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("should call the send function with correct parameters", async () => {
+    await backupAppStorage(transport);
+    expect(transport.send).toHaveBeenCalledWith(0xe0, 0x6b, 0x00, 0x00, Buffer.from([0x00]), [
+      StatusCodes.OK,
+      StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+      StatusCodes.GEN_AES_KEY_FAILED,
+      StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED,
+      StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED,
+      StatusCodes.ENCRYPT_APP_STORAGE_FAILED,
+      StatusCodes.DEVICE_IN_RECOVERY_MODE,
+      StatusCodes.INVALID_BACKUP_STATE,
+    ]);
+  });
+
+  describe("parseResponse", () => {
+    it("should parse the response data correctly", () => {
+      const expected = Buffer.from([
+        0x31, 0x30, 0x36, 0x52, 0x75, 0x65, 0x64, 0x75, 0x54, 0x65, 0x6d, 0x70, 0x6c, 0x65,
+      ]);
+      expect(parseResponse(response)).toStrictEqual(expected);
+    });
+    it("should throw TransportStatusError if the response status is invalid", () => {
+      const data = Buffer.from([0x54, 0x1b]);
+      expect(() => parseResponse(data)).toThrow(
+        new InternalComputeAesCmacFailed("Internal error, failed to compute AES CMAC."),
+      );
+    });
+  });
+});

package/src/commands/use-cases/app-backup/backupAppStorage.ts

@@ -0,0 +1,97 @@
+import Transport, { StatusCodes, TransportStatusError } from "@ledgerhq/hw-transport";
+import { LocalTracer } from "@ledgerhq/logs";
+import type { APDU } from "../../entities/APDU";
+import {
+  GenerateAesKeyFailed,
+  InternalComputeAesCmacFailed,
+  InternalCryptoOperationFailed,
+  InvalidBackupState,
+  InvalidContext,
+} from "../../../errors";
+
+/**
+ * Name in documentation: INS_APP_STORAGE_BACKUP
+ * cla: 0xe0
+ * ins: 0x6b
+ * p1: 0x00
+ * p2: 0x00
+ * lc: 0x00
+ */
+const BACKUP_APP_STORAGE = [0xe0, 0x6b, 0x00, 0x00] as const;
+
+/**
+ * 0x9000: Success.
+ * 0x5123: Invalid context, Get Info must be called.
+ * 0x5419: Failed to generate AES key.
+ * 0x541A: Internal error, crypto operation failed.
+ * 0x541B: Internal error, failed to compute AES CMAC.
+ * 0x541C: Failed to encrypt the app storage backup.
+ * 0x662F: Invalid device state, recovery mode.
+ * 0x6642: Invalid backup state, backup already performed.
+ */
+const RESPONSE_STATUS_SET: number[] = [
+  StatusCodes.OK,
+  StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+  StatusCodes.GEN_AES_KEY_FAILED,
+  StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED,
+  StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED,
+  StatusCodes.ENCRYPT_APP_STORAGE_FAILED,
+  StatusCodes.DEVICE_IN_RECOVERY_MODE,
+  StatusCodes.INVALID_BACKUP_STATE,
+];
+
+/**
+ * Retrieves the app storage information (chunk) from the device and returns it
+ * as a buffer.
+ *
+ * @param transport - The transport object used to communicate with the device.
+ * @returns A promise that resolves to the app storage information as a buffer.
+ */
+export async function backupAppStorage(transport: Transport): Promise<Buffer> {
+  const tracer = new LocalTracer("hw", {
+    transport: transport.getTraceContext(),
+    function: "backupAppStorage",
+  });
+  tracer.trace("Start");
+
+  const apdu: Readonly<APDU> = [...BACKUP_APP_STORAGE, Buffer.from([0x00])];
+
+  const response = await transport.send(...apdu, RESPONSE_STATUS_SET);
+
+  return parseResponse(response);
+}
+
+/**
+ * Parses the response data buffer, check the status code and return the data.
+ *
+ * @param data - The response data buffer w/ status code.
+ * @returns The response data as a buffer w/o status code.
+ */
+export function parseResponse(data: Buffer): Buffer {
+  const tracer = new LocalTracer("hw", {
+    function: "parseResponse@backupAppStorage",
+  });
+  const status = data.readUInt16BE(data.length - 2);
+  tracer.trace("Result status from 0xe06b0000", { status });
+
+  switch (status) {
+    case StatusCodes.OK:
+      return data.subarray(0, data.length - 2);
+    case StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT:
+      throw new InvalidContext("Invalid context, getAppStorageInfo must be called.");
+    case StatusCodes.GEN_AES_KEY_FAILED:
+      throw new GenerateAesKeyFailed("Failed to generate AES key.");
+    case StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED:
+      throw new InternalCryptoOperationFailed("Internal error, crypto operation failed.");
+    case StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED:
+      throw new InternalComputeAesCmacFailed("Internal error, failed to compute AES CMAC.");
+    case StatusCodes.ENCRYPT_APP_STORAGE_FAILED:
+      throw new GenerateAesKeyFailed("Failed to encrypt the app storage backup.");
+    case StatusCodes.DEVICE_IN_RECOVERY_MODE:
+      break;
+    case StatusCodes.INVALID_BACKUP_STATE:
+      throw new InvalidBackupState("Invalid backup state, backup already performed.");
+  }
+
+  throw new TransportStatusError(status);
+}