@ledgerhq/hw-app-canton 0.2.0-nightly.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ledgerhq/hw-app-canton@0.1.0 build /home/runner/work/ledger-live/ledger-live/libs/ledgerjs/packages/hw-app-canton
+> tsc && tsc -m esnext --moduleResolution bundler --outDir lib-es
+

package/.unimportedrc.json

@@ -0,0 +1,5 @@
+{
+  "entry": ["src/Canton.ts"],
+  "ignoreUnused": ["jest-sonar"],
+  "ignoreUnimported": ["**/__tests__/**"]
+}

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @ledgerhq/hw-app-canton
+
+## 0.2.0-nightly.0
+
+### Minor Changes
+
+- [#11200](https://github.com/LedgerHQ/ledger-live/pull/11200) [`6398e5f`](https://github.com/LedgerHQ/ledger-live/commit/6398e5f90bd6ca5c1c4d850da731d4e7f020ea3a) Thanks [@ishaba](https://github.com/ishaba)! - Canton signer init
+
+### Patch Changes
+
+- [#11216](https://github.com/LedgerHQ/ledger-live/pull/11216) [`4d14752`](https://github.com/LedgerHQ/ledger-live/commit/4d14752360435f27f07768302a715cd2f39f59ac) Thanks [@hedi-edelbloute](https://github.com/hedi-edelbloute)! - Fix CI checks issue
+
+- Updated dependencies [[`6398e5f`](https://github.com/LedgerHQ/ledger-live/commit/6398e5f90bd6ca5c1c4d850da731d4e7f020ea3a)]:
+  - @ledgerhq/coin-canton@0.2.0-nightly.2

package/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2017-present Ledger https://www.ledger.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+<img src="https://user-images.githubusercontent.com/4631227/191834116-59cf590e-25cc-4956-ae5c-812ea464f324.png" height="100" />
+
+[GitHub](https://github.com/LedgerHQ/ledger-live/),
+[Ledger Devs Discord](https://developers.ledger.com/discord-pro),
+[Developer Portal](https://developers.ledger.com/)
+
+## @ledgerhq/hw-app-canton
+
+Ledger Hardware Wallet Canton JavaScript bindings.
+
+***
+
+## Are you adding Ledger support to your software wallet?
+
+You may be using this package to communicate with the Canton Nano App.
+
+For a smooth and quick integration:
+
+*   See the developers’ documentation on the [Developer Portal](https://developers.ledger.com/docs/transport/overview/) and
+*   Go on [Discord](https://developers.ledger.com/discord-pro/) to chat with developer support and the developer community.
+
+## API
+
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+#### Table of Contents
+
+*   [Canton](#canton)
+    *   [Parameters](#parameters)
+    *   [getAddress](#getaddress)
+        *   [Parameters](#parameters-1)
+    *   [signTransaction](#signtransaction)
+        *   [Parameters](#parameters-2)
+    *   [getAppConfiguration](#getappconfiguration)
+*   [MockCantonDevice](#mockcantondevice)
+
+### Canton
+
+Canton BOLOS API
+
+#### Parameters
+
+*   `transport` **Transport**&#x20;
+*   `scrambleKey`   (optional, default `"canton_default_scramble_key"`)
+
+#### getAddress
+
+Get a Canton address for a given BIP-32 path.
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP-32 format
+*   `display` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** whether to display the address on the device (optional, default `false`)
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<CantonAddress>** the address and public key
+
+#### signTransaction
+
+Sign a Canton transaction.
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP-32 format
+*   `rawTx` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** the raw transaction to sign
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<CantonSignature>** the signature
+
+#### getAppConfiguration
+
+Get the app configuration.
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<AppConfig>** the app configuration including version
+
+### MockCantonDevice
+
+Mock Canton "@ledgerhq/hw-app-canton" device implementation for development and testing

package/__tests__/Canton.test.ts

@@ -0,0 +1,122 @@
+import { openTransportReplayer, RecordStore } from "@ledgerhq/hw-transport-mocker";
+import Canton from "../src/Canton";
+
+describe("Canton", () => {
+  describe("decorateAppAPIMethods", () => {
+    it("should properly decorate transport methods", async () => {
+      const transport = await openTransportReplayer(new RecordStore());
+      const canton = new Canton(transport);
+
+      expect(canton.transport).toBeDefined();
+      expect(typeof canton.getAddress).toBe("function");
+      expect(typeof canton.signTransaction).toBe("function");
+      expect(typeof canton.getAppConfiguration).toBe("function");
+    });
+  });
+
+  describe("getAddress", () => {
+    it("should get address without display", async () => {
+      const transport = await openTransportReplayer(
+        RecordStore.fromString(`
+          => e005000015058000002c80001a6f800000008000000080000000
+          <= 4d65a10662b9759d62bb59048366705454654cf4f9b4b3525cf314429e46c6919000
+        `)
+      );
+
+      const canton = new Canton(transport);
+      const result = await canton.getAddress("44'/6767'/0'/0'/0'");
+
+      expect(result).toBeDefined();
+      expect(result.address).toBeDefined();
+      expect(result.publicKey).toBeDefined();
+    });
+
+    it("should get address with display", async () => {
+      const transport = await openTransportReplayer(
+        RecordStore.fromString(`
+          => e005010015058000002c80001a6f800000008000000080000000
+          <= 4d65a10662b9759d62bb59048366705454654cf4f9b4b3525cf314429e46c6919000
+        `)
+      );
+
+      const canton = new Canton(transport);
+      const result = await canton.getAddress("44'/6767'/0'/0'/0'", true);
+
+      expect(result).toBeDefined();
+      expect(result.address).toBeDefined();
+      expect(result.publicKey).toBeDefined();
+    });
+
+    it("should throw on invalid derivation path", async () => {
+      const transport = await openTransportReplayer(new RecordStore());
+      const canton = new Canton(transport);
+
+      return expect(
+        canton.getAddress("invalid path")
+      ).rejects.toThrow();
+    });
+
+    it("should handle various derivation paths", async () => {
+      const transport = await openTransportReplayer(
+        RecordStore.fromString(`
+          => e005000015058000002c80001a6f800000008000000080000001
+          <= 5e66a10773c0860e73bb6015947806555765df5f9b5b4636df4255a57c57d7029000
+        `)
+      );
+
+      const canton = new Canton(transport);
+      const result = await canton.getAddress("44'/6767'/0'/0'/1'");
+
+      expect(result).toBeDefined();
+      expect(result.address).toBeDefined();
+      expect(result.publicKey).toBeDefined();
+    });
+
+    // should handle user refused address
+  });
+
+  describe("signTransaction", () => {
+    // should sign transaction
+
+    // should handle large transaction payloads
+
+    // should handle empty transaction
+
+    // should request blind signature when required
+
+    it("should handle user refused transaction", async () => {
+      const transport = await openTransportReplayer(
+        RecordStore.fromString(`
+          => e006010015058000002c80001a6f800000008000000080000000
+          <= 6985
+        `)
+      );
+
+      const canton = new Canton(transport);
+
+      return expect(
+        canton.signTransaction("44'/6767'/0'/0'/0'", "test")
+      ).rejects.toThrow();
+    });
+  });
+
+  describe("getAppConfiguration", () => {
+    it("should get app configuration", async () => {
+      const transport = await openTransportReplayer(
+        RecordStore.fromString(`
+          => e004000000
+          <= 00000100069000
+        `)
+      );
+
+      const canton = new Canton(transport);
+      const result = await canton.getAppConfiguration();
+
+      expect(result).toBeDefined();
+      expect(result).toHaveProperty("version");
+      expect(typeof result.version).toBe("string");
+    });
+
+    // should handle configuration error
+  });
+}); 

package/jest.config.ts

@@ -0,0 +1,24 @@
+import baseConfig from "../../jest.config";
+
+export default {
+  ...baseConfig,
+  rootDir: __dirname,
+  collectCoverageFrom: [
+    "src/**/*.ts",
+    "!src/**/*.test.{ts,tsx}",
+    "!src/**/*.spec.{ts,tsx}",
+    "!src/**/__tests__/**",
+    "!tests/**",
+  ],
+  coverageReporters: ["json", ["lcov", { projectRoot: "../../../../" }], "json-summary", "text"],
+  reporters: [
+    "default",
+    [
+      "jest-sonar",
+      {
+        outputName: "sonar-executionTests-report.xml",
+        reportedFilePath: "absolute",
+      },
+    ],
+  ],
+};

package/lib/Canton.d.ts

@@ -0,0 +1,48 @@
+import type Transport from "@ledgerhq/hw-transport";
+import { CantonAddress, CantonSignature } from "@ledgerhq/coin-canton";
+import { MockCantonDevice, AppConfig } from "./MockDevice";
+/**
+ * Canton BOLOS API
+ */
+export default class Canton {
+    transport: Transport;
+    transportMock: MockCantonDevice;
+    constructor(transport: Transport, scrambleKey?: string);
+    /**
+     * Get a Canton address for a given BIP-32 path.
+     *
+     * @param path a path in BIP-32 format
+     * @param display whether to display the address on the device
+     * @return the address and public key
+     */
+    getAddress(path: string, display?: boolean): Promise<CantonAddress>;
+    /**
+     * Sign a Canton transaction.
+     *
+     * @param path a path in BIP-32 format
+     * @param rawTx the raw transaction to sign
+     * @return the signature
+     */
+    signTransaction(path: string, rawTx: string): Promise<CantonSignature>;
+    /**
+     * Get the app configuration.
+     * @return the app configuration including version
+     */
+    getAppConfiguration(): Promise<AppConfig>;
+    /**
+     * Helper method to handle transport response and check for errors
+     * @private
+     */
+    private handleTransportResponse;
+    /**
+     * Serialize a BIP path to a data buffer for Canton BOLOS
+     * @private
+     */
+    private serializePath;
+    /**
+     * Simple deterministic hash function for generating mock addresses
+     * @private
+     */
+    private hashString;
+}
+//# sourceMappingURL=Canton.d.ts.map

package/lib/Canton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canton.d.ts","sourceRoot":"","sources":["../src/Canton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAoB3D;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,gBAAgB,CAAC;gBAEpB,SAAS,EAAE,SAAS,EAAE,WAAW,SAAgC;IAO7E;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBhF;;;;;;OAMG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAa5E;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC;IAc/C;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAWrB;;;OAGG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/lib/Canton.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const errors_1 = require("@ledgerhq/errors");
+const bip32_path_1 = __importDefault(require("bip32-path"));
+const MockDevice_1 = require("./MockDevice");
+const CLA = 0xe0;
+const P1_NON_CONFIRM = 0x00;
+const P1_CONFIRM = 0x01;
+const P2 = 0x00;
+const INS = {
+    GET_VERSION: 0x04,
+    GET_ADDR: 0x05,
+    SIGN: 0x06,
+};
+const STATUS = {
+    OK: 0x9000,
+    USER_CANCEL: 0x6985,
+};
+/**
+ * Canton BOLOS API
+ */
+class Canton {
+    transport;
+    transportMock;
+    constructor(transport, scrambleKey = "canton_default_scramble_key") {
+        this.transport = transport;
+        this.transportMock = new MockDevice_1.MockCantonDevice();
+        transport.decorateAppAPIMethods(this, ["getAddress", "signTransaction"], scrambleKey);
+    }
+    /**
+     * Get a Canton address for a given BIP-32 path.
+     *
+     * @param path a path in BIP-32 format
+     * @param display whether to display the address on the device
+     * @return the address and public key
+     */
+    async getAddress(path, display = false) {
+        const bipPath = bip32_path_1.default.fromString(path).toPathArray();
+        const serializedPath = this.serializePath(bipPath);
+        const p1 = display ? P1_CONFIRM : P1_NON_CONFIRM;
+        const response = await this.transportMock.send(CLA, INS.GET_ADDR, p1, P2, serializedPath);
+        const responseData = this.handleTransportResponse(response, "address");
+        // Handle 65-byte uncompressed SECP256R1 public key
+        const publicKey = "0x" + responseData.toString("hex");
+        const addressHash = this.hashString(publicKey);
+        const address = "canton_" + addressHash.substring(0, 36);
+        return {
+            publicKey,
+            address,
+        };
+    }
+    /**
+     * Sign a Canton transaction.
+     *
+     * @param path a path in BIP-32 format
+     * @param rawTx the raw transaction to sign
+     * @return the signature
+     */
+    async signTransaction(path, rawTx) {
+        const bipPath = bip32_path_1.default.fromString(path).toPathArray();
+        const serializedPath = this.serializePath(bipPath);
+        const payload = Buffer.concat([serializedPath, Buffer.from(rawTx, "hex")]);
+        const response = await this.transportMock.send(CLA, INS.SIGN, P1_CONFIRM, P2, payload);
+        const responseData = this.handleTransportResponse(response, "transaction");
+        const signature = "0x" + responseData.toString("hex");
+        return signature;
+    }
+    /**
+     * Get the app configuration.
+     * @return the app configuration including version
+     */
+    async getAppConfiguration() {
+        const [major, minor, patch] = await this.transportMock.send(CLA, INS.GET_VERSION, P1_NON_CONFIRM, P2, Buffer.alloc(0));
+        return {
+            version: `${major}.${minor}.${patch}`,
+        };
+    }
+    /**
+     * Helper method to handle transport response and check for errors
+     * @private
+     */
+    handleTransportResponse(response, errorType) {
+        const statusCode = response.readUInt16BE(response.length - 2);
+        const responseData = response.slice(0, response.length - 2);
+        if (statusCode === STATUS.USER_CANCEL) {
+            if (errorType === "address") {
+                throw new errors_1.UserRefusedAddress();
+            }
+            else {
+                throw new errors_1.UserRefusedOnDevice();
+            }
+        }
+        return responseData;
+    }
+    /**
+     * Serialize a BIP path to a data buffer for Canton BOLOS
+     * @private
+     */
+    serializePath(path) {
+        const data = Buffer.alloc(1 + path.length * 4);
+        data.writeUInt8(path.length, 0); // Write path length as first byte
+        path.forEach((segment, index) => {
+            data.writeUInt32BE(segment, 1 + index * 4); // Write each segment as 32-bit integer
+        });
+        return data;
+    }
+    /**
+     * Simple deterministic hash function for generating mock addresses
+     * @private
+     */
+    hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(16);
+    }
+}
+exports.default = Canton;
+//# sourceMappingURL=Canton.js.map

package/lib/Canton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canton.js","sourceRoot":"","sources":["../src/Canton.ts"],"names":[],"mappings":"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"}

package/lib/MockDevice.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+/// <reference types="node" />
+export type AppConfig = {
+    version: string;
+};
+/**
+ * Mock Canton "@ledgerhq/hw-app-canton" device implementation for development and testing
+ */
+export declare class MockCantonDevice {
+    private mockAddresses;
+    private mockSignatures;
+    constructor();
+    send(cla: number, ins: number, p1: number, p2: number, data: Buffer): Promise<Buffer>;
+    private getAddressResponse;
+    private signTransactionResponse;
+    private getAppConfigurationResponse;
+    private parsePathFromData;
+    private simulateDeviceDelay;
+    /**
+     * Simple deterministic hash function for generating mock data
+     */
+    private hashString;
+}
+//# sourceMappingURL=MockDevice.d.ts.map

package/lib/MockDevice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockDevice.d.ts","sourceRoot":"","sources":["../src/MockDevice.ts"],"names":[],"mappings":";;AAaA,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAsBF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,cAAc,CAA2C;;IAS3D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAa7E,kBAAkB;YAiClB,uBAAuB;YA0BvB,2BAA2B;IAYzC,OAAO,CAAC,iBAAiB;YAkBX,mBAAmB;IAIjC;;OAEG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/lib/MockDevice.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockCantonDevice = void 0;
+const INS = {
+    GET_VERSION: 0x04,
+    GET_ADDR: 0x05,
+    SIGN: 0x06,
+};
+const STATUS = {
+    OK: 0x9000,
+    USER_CANCEL: 0x6985,
+};
+// SECP256R1-compatible mock addresses
+const SECP256R1_MOCK_ADDRESSES = {
+    "44'/6767'/0'/0'/0'": {
+        // Uncompressed SECP256R1 public key (65 bytes: 0x04 + 32-byte X + 32-byte Y)
+        publicKey: "0x04" +
+            "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" +
+            "abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+        address: "canton_1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z",
+    },
+    "44'/6767'/0'/0'/1'": {
+        // Another valid SECP256R1 public key
+        publicKey: "0x04" +
+            "abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890" +
+            "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcd",
+        address: "canton_2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7a",
+    },
+};
+/**
+ * Mock Canton "@ledgerhq/hw-app-canton" device implementation for development and testing
+ */
+class MockCantonDevice {
+    mockAddresses = new Map();
+    mockSignatures = new Map();
+    constructor() {
+        // Initialize with SECP256R1-compatible addresses
+        Object.entries(SECP256R1_MOCK_ADDRESSES).forEach(([path, address]) => {
+            this.mockAddresses.set(path, address);
+        });
+    }
+    async send(cla, ins, p1, p2, data) {
+        switch (ins) {
+            case INS.GET_ADDR:
+                return this.getAddressResponse(data);
+            case INS.SIGN:
+                return this.signTransactionResponse(data);
+            case INS.GET_VERSION:
+                return this.getAppConfigurationResponse();
+            default:
+                throw new Error(`Unsupported instruction: ${ins}`);
+        }
+    }
+    async getAddressResponse(data) {
+        await this.simulateDeviceDelay();
+        // Parse the path from the data
+        const pathData = data.slice(1); // Skip length byte
+        const path = this.parsePathFromData(pathData);
+        const mockAddress = this.mockAddresses.get(path);
+        if (!mockAddress) {
+            // Generate SECP256R1-compatible mock address
+            const pathHash = this.hashString(path);
+            const newAddress = {
+                // Create valid uncompressed SECP256R1 public key format
+                publicKey: "0x04" +
+                    pathHash.substring(0, 64).padEnd(64, "0") +
+                    pathHash.substring(64, 128).padEnd(64, "0"),
+                address: `canton_${pathHash.substring(0, 36)}`,
+            };
+            this.mockAddresses.set(path, newAddress);
+        }
+        const address = this.mockAddresses.get(path);
+        // Return 65-byte uncompressed public key (0x04 + 32-byte X + 32-byte Y)
+        const publicKeyBytes = Buffer.from(address.publicKey.slice(2), "hex");
+        const response = Buffer.alloc(65 + 2);
+        publicKeyBytes.copy(response, 0);
+        response.writeUInt16BE(STATUS.OK, 65);
+        return response;
+    }
+    async signTransactionResponse(data) {
+        await this.simulateDeviceDelay();
+        // Parse the path and transaction from the data
+        const pathData = data.slice(0, 21); // First 21 bytes are path
+        const txData = data.slice(21); // Rest is transaction data
+        const path = this.parsePathFromData(pathData);
+        const signatureKey = `${path}:${txData.toString("hex")}`;
+        let signature = this.mockSignatures.get(signatureKey);
+        if (!signature) {
+            // Generate SECP256R1-compatible mock signature (64 bytes: r + s)
+            const combinedHash = this.hashString(signatureKey);
+            signature = `0x${combinedHash.substring(0, 64).padEnd(64, "0")}`;
+            this.mockSignatures.set(signatureKey, signature);
+        }
+        // Return 64-byte signature (r + s components)
+        const response = Buffer.alloc(64 + 2);
+        Buffer.from(signature.slice(2), "hex").copy(response, 0); // Remove '0x' prefix
+        response.writeUInt16BE(STATUS.OK, 64);
+        return response;
+    }
+    async getAppConfigurationResponse() {
+        await this.simulateDeviceDelay();
+        // Create response buffer: version data + status code
+        const versionData = Buffer.from([0x00, 0x01, 0x00, 0x06]); // Version 0.1.0
+        const response = Buffer.alloc(versionData.length + 2);
+        versionData.copy(response, 0);
+        response.writeUInt16BE(STATUS.OK, versionData.length);
+        return response;
+    }
+    parsePathFromData(data) {
+        // Convert the path data back to a BIP32 path string
+        const segments = [];
+        for (let i = 0; i < data.length; i += 4) {
+            const segment = data.readUInt32BE(i);
+            segments.push(segment);
+        }
+        // Convert to BIP32 path string
+        const pathParts = segments.map(seg => {
+            const isHardened = (seg & 0x80000000) !== 0;
+            const value = seg & 0x7fffffff;
+            return isHardened ? `${value}'` : `${value}`;
+        });
+        return pathParts.join("/");
+    }
+    async simulateDeviceDelay() {
+        await new Promise(resolve => setTimeout(resolve, 50));
+    }
+    /**
+     * Simple deterministic hash function for generating mock data
+     */
+    hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32-bit integer
+        }
+        return Math.abs(hash).toString(16);
+    }
+}
+exports.MockCantonDevice = MockCantonDevice;
+//# sourceMappingURL=MockDevice.js.map

package/lib/MockDevice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockDevice.js","sourceRoot":"","sources":["../src/MockDevice.ts"],"names":[],"mappings":"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"}