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

package/lib-es/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-es/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-es/Canton.js

@@ -0,0 +1,119 @@
+import { UserRefusedAddress, UserRefusedOnDevice } from "@ledgerhq/errors";
+import BIPPath from "bip32-path";
+import { MockCantonDevice } from "./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
+ */
+export default class Canton {
+    transport;
+    transportMock;
+    constructor(transport, scrambleKey = "canton_default_scramble_key") {
+        this.transport = transport;
+        this.transportMock = new 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 = BIPPath.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 = BIPPath.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 UserRefusedAddress();
+            }
+            else {
+                throw new 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);
+    }
+}
+//# sourceMappingURL=Canton.js.map

package/lib-es/Canton.js.map

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

package/lib-es/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-es/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-es/MockDevice.js

@@ -0,0 +1,137 @@
+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
+ */
+export 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);
+    }
+}
+//# sourceMappingURL=MockDevice.js.map

package/lib-es/MockDevice.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@ledgerhq/hw-app-canton",
+  "version": "0.2.0-nightly.0",
+  "description": "Ledger Hardware Wallet Canton Application API",
+  "keywords": [
+    "Ledger",
+    "LedgerWallet",
+    "canton",
+    "Canton",
+    "Hardware Wallet"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LedgerHQ/ledger-live.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LedgerHQ/ledger-live/issues"
+  },
+  "homepage": "https://github.com/LedgerHQ/ledger-live/tree/develop/libs/ledgerjs/packages/hw-app-canton",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/Canton.js",
+  "module": "lib-es/Canton.js",
+  "types": "lib/Canton.d.ts",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "bip32-path": "^0.4.2",
+    "@ledgerhq/errors": "^6.23.0",
+    "@ledgerhq/hw-transport": "^6.31.8",
+    "@ledgerhq/coin-canton": "^0.2.0-nightly.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.10",
+    "@types/node": "^22.10.10",
+    "documentation": "14.0.2",
+    "jest": "^29.7.0",
+    "rimraf": "^4.4.1",
+    "source-map-support": "^0.5.21",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.4.0",
+    "@ledgerhq/hw-transport-mocker": "^6.29.8"
+  },
+  "scripts": {
+    "clean": "rimraf lib lib-es",
+    "build": "tsc && tsc -m esnext --moduleResolution bundler --outDir lib-es",
+    "coverage": "jest --coverage --passWithNoTests && mv coverage/coverage-final.json coverage/coverage-hw-app-canton.json",
+    "prewatch": "pnpm build",
+    "watch": "tsc --watch",
+    "watch:es": "tsc --watch -m esnext --moduleResolution bundler --outDir lib-es",
+    "doc": "documentation readme src/** --section=API --pe ts --re ts --re d.ts",
+    "lint": "eslint ./src --no-error-on-unmatched-pattern --ext .ts,.tsx --cache",
+    "lint:fix": "pnpm lint --fix",
+    "test": "jest",
+    "unimported": "unimported"
+  }
+}

package/src/Canton.ts

@@ -0,0 +1,153 @@
+import type Transport from "@ledgerhq/hw-transport";
+import { UserRefusedAddress, UserRefusedOnDevice } from "@ledgerhq/errors";
+import { CantonAddress, CantonSignature } from "@ledgerhq/coin-canton";
+import BIPPath from "bip32-path";
+
+import { MockCantonDevice, AppConfig } from "./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
+ */
+export default class Canton {
+  transport: Transport;
+  transportMock: MockCantonDevice;
+
+  constructor(transport: Transport, scrambleKey = "canton_default_scramble_key") {
+    this.transport = transport;
+    this.transportMock = new 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: string, display: boolean = false): Promise<CantonAddress> {
+    const bipPath = BIPPath.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: string, rawTx: string): Promise<CantonSignature> {
+    const bipPath = BIPPath.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(): Promise<AppConfig> {
+    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
+   */
+  private handleTransportResponse(response: Buffer, errorType: "address" | "transaction"): Buffer {
+    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 UserRefusedAddress();
+      } else {
+        throw new UserRefusedOnDevice();
+      }
+    }
+
+    return responseData;
+  }
+
+  /**
+   * Serialize a BIP path to a data buffer for Canton BOLOS
+   * @private
+   */
+  private serializePath(path: number[]): Buffer {
+    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
+   */
+  private hashString(str: string): string {
+    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);
+  }
+}