@ledgerhq/concordium-core 0.2.0-nightly.20260220030210

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ledgerhq/concordium-core@0.1.0 build /home/runner/work/ledger-live/ledger-live/libs/concordium-core
+> tsc && tsc -m esnext --moduleResolution bundler --outDir lib-es
+

package/.unimportedrc.json

@@ -0,0 +1,14 @@
+{
+  "entry": [
+    "src/index.ts"
+  ],
+  "ignorePatterns": [
+    "**/node_modules/**",
+    "**/*.test.{js,jsx,ts,tsx}"
+  ],
+  "ignoreUnimported": [
+    "src/bip32-path.d.ts"
+  ],
+  "ignoreUnresolved": [],
+  "ignoreUnused": []
+}

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @ledgerhq/concordium-core
+
+## 0.2.0-nightly.20260220030210
+
+### Minor Changes
+
+- [#14258](https://github.com/LedgerHQ/ledger-live/pull/14258) [`5f1c644`](https://github.com/LedgerHQ/ledger-live/commit/5f1c644fd5f757f48618b62e976faac274ced40d) Thanks [@lysyi3m](https://github.com/lysyi3m)! - added concordium proxy & grpc client and core functionality implementation; extracted shared concordium-core package with types, serialization, CBOR and address utilities; simplified hw-app-concordium API to single signTransaction method with type-based routing

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,74 @@
+# @ledgerhq/concordium-core
+
+Shared Concordium protocol types, serialization, and utilities used by both `@ledgerhq/hw-app-concordium` and `@ledgerhq/coin-concordium`.
+
+## Purpose
+
+This package extracts shared protocol-level logic so that the hardware wallet app and the coin module can depend on it independently, without the coin module depending on the hardware wallet app.
+
+```
+hw-app-concordium ←── @ledgerhq/concordium-core ──→ coin-concordium
+```
+
+## Exported APIs
+
+### Types (`src/types.ts`)
+
+- `SchemeId` — Ed25519 cryptographic scheme identifier
+- `TransactionType` — Transaction type discriminators (Transfer, TransferWithMemo)
+- `Transaction` — Transaction structure for signing
+- `TransferPayload` — Simple transfer payload
+- `TransferWithMemoPayload` — Transfer with memo payload
+- `TransactionPayload` — Union of transfer payload types
+- `CredentialDeploymentTransaction` — Credential deployment in hw-app format
+- `IdOwnershipProofs` — ID ownership proofs from Concordium ID App
+- `Address` — Address response from device
+- `VerifyAddressResponse` — Verify address response from device
+- `SigningResult` — Signing result with signature and serialized transaction
+
+### Address (`src/address.ts`)
+
+- `AccountAddress` — Concordium account address with Base58 ↔ Buffer conversion
+  - `AccountAddress.fromBase58(address: string): AccountAddress` — Parse Base58Check address
+  - `AccountAddress.isValid(address: string): boolean` — Check if a string is a valid Concordium address
+  - `toBase58(): string` — Convert to Base58Check string
+  - `toBuffer(): Buffer` — Get raw 32-byte address buffer
+
+### CBOR (`src/cbor.ts`)
+
+- `encodeMemoToCbor(memo: string): Buffer` — Encode memo string to CBOR text string
+- `memoEncodedSize(memo: string): number` — CBOR-encoded byte length without allocating (useful for size checks before encoding)
+- `decodeMemoFromCbor(cborEncoded: Buffer): string` — Decode CBOR-encoded memo
+- `MAX_MEMO_LENGTH` — Maximum memo length before CBOR encoding (254 bytes)
+- `MAX_CBOR_SIZE` — Maximum CBOR-encoded memo size (256 bytes)
+
+### Utils (`src/utils.ts`)
+
+- `encodeWord8/16/32/64` — Encode integers to Buffer (big/little endian)
+- `decodeWord16/32/64` — Decode integers from Buffer
+- `encodeWord8FromString` — Encode a string-represented number as Word8
+- `serializeMap` — Serialize a Record to binary format
+- `serializeVerifyKey` — Serialize a public key with scheme prefix
+- `serializeYearMonth` — Serialize YYYYMM date string
+- `serializePath` — Serialize BIP32 path array to Buffer
+- `pathToBuffer` — Convert BIP32 path string to device-compatible Buffer
+- `chunkBuffer` — Split a buffer into fixed-size chunks
+
+### Serialization (`src/serialization.ts`)
+
+- `serializeTransfer(tx): Buffer` — Serialize a Transfer transaction
+- `serializeTransferWithMemo(tx): Buffer` — Serialize a TransferWithMemo transaction
+- `serializeTransaction(tx): Buffer` — Serialize any supported transaction type
+- `deserializeTransfer(buffer): Transaction` — Deserialize Transfer from buffer
+- `deserializeTransferWithMemo(buffer): Transaction` — Deserialize TransferWithMemo from buffer
+- `deserializeTransaction(buffer): Transaction` — Deserialize any transaction by auto-detecting type
+- `getTransactionType(buffer): TransactionType` — Get transaction type from serialized buffer
+- `serializeCredentialDeploymentValues(payload): Buffer` — Serialize credential deployment values
+- `serializeIdOwnershipProofs(proofs): Buffer` — Serialize ID ownership proofs
+- `serializeAccountOwnershipProofs(signatures): Buffer` — Serialize account ownership proofs
+- `insertAccountOwnershipProofs(idProofs, accountSig): string` — Combine ID + account proofs
+
+## Related Packages
+
+- `@ledgerhq/hw-app-concordium` — Ledger device communication for Concordium (depends on this package for shared types/serialization; adds APDU-specific functions)
+- `@ledgerhq/coin-concordium` — Ledger Live coin module for Concordium (depends on this package for shared types/serialization)

package/jest.config.js

@@ -0,0 +1,37 @@
+module.exports = {
+  testEnvironment: "node",
+  transform: {
+    "^.+\\.(t|j)sx?$": [
+      "@swc/jest",
+      {
+        jsc: {
+          target: "es2022",
+          parser: {
+            syntax: "typescript",
+            tsx: false,
+            decorators: false,
+            dynamicImport: true,
+          },
+        },
+      },
+    ],
+  },
+  collectCoverage: true,
+  collectCoverageFrom: [
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts",
+    "!src/**/*.d.ts",
+    "!src/index.ts",
+  ],
+  coverageReporters: [
+    "json",
+    ["lcov", { file: "lcov.info", projectRoot: "../../" }],
+    "text",
+  ],
+  testPathIgnorePatterns: ["lib/", "lib-es/"],
+  reporters: [
+    "default",
+    ["jest-sonar", { outputName: "sonar-executionTests-report.xml", reportedFilePath: "absolute" }],
+  ],
+};

package/lib/address.d.ts

@@ -0,0 +1,73 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/**
+ * Concordium account address with Base58 ↔ Buffer conversion.
+ *
+ * Handles Concordium-specific Base58Check encoding:
+ * - Version byte: 1 (prepended before Base58 encoding)
+ * - Raw address: 32 bytes
+ * - Base58 encoded: exactly 50 characters
+ *
+ * This class provides a type-safe wrapper for Concordium addresses,
+ * ensuring correct encoding/decoding and validation.
+ */
+export declare class AccountAddress {
+    private readonly buffer;
+    /** Base58-encoded address string (50 characters) */
+    readonly address: string;
+    /**
+     * Private constructor - use fromBase58() or fromBuffer() to create instances.
+     * @param buffer - Raw 32-byte address
+     */
+    private constructor();
+    /**
+     * Parse a Base58-encoded Concordium address.
+     *
+     * @param address - Base58 address string (must be exactly 50 characters)
+     * @returns AccountAddress instance
+     * @throws Error if address is not 50 characters or has invalid version byte
+     *
+     * @example
+     * const addr = AccountAddress.fromBase58("3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSYLwK1G");
+     */
+    static fromBase58(address: string): AccountAddress;
+    /**
+     * Create an AccountAddress from raw 32-byte buffer.
+     *
+     * @param buffer - Raw address bytes (must be exactly 32 bytes)
+     * @returns AccountAddress instance
+     * @throws Error if buffer is not 32 bytes
+     *
+     * @example
+     * const addr = AccountAddress.fromBuffer(Buffer.from("...", "hex"));
+     */
+    static fromBuffer(buffer: Buffer): AccountAddress;
+    /**
+     * Convert address to Base58-encoded string.
+     *
+     * @returns Base58-encoded address (50 characters)
+     *
+     * @example
+     * const base58 = addr.toBase58();
+     * // "3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSYLwK1G"
+     */
+    toBase58(): string;
+    /**
+     * Get raw 32-byte address buffer.
+     *
+     * @returns Raw address bytes (32 bytes)
+     *
+     * @example
+     * const raw = addr.toBuffer();
+     * // Buffer of 32 bytes
+     */
+    toBuffer(): Buffer;
+    /**
+     * Check if a string is a valid Concordium account address.
+     *
+     * @param address - String to validate
+     * @returns true if the address is valid, false otherwise
+     */
+    static isValid(address: string): boolean;
+}
+//# sourceMappingURL=address.d.ts.map

package/lib/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IAQL,OAAO,CAAC,QAAQ,CAAC,MAAM;IAP3C,oDAAoD;IACpD,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,OAAO;IAOP;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAgBlD;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;IAOjD;;;;;;;;OAQG;IACH,QAAQ,IAAI,MAAM;IAKlB;;;;;;;;OAQG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAQzC"}

package/lib/address.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountAddress = void 0;
+const bs58check_1 = __importDefault(require("bs58check"));
+/**
+ * Concordium account address with Base58 ↔ Buffer conversion.
+ *
+ * Handles Concordium-specific Base58Check encoding:
+ * - Version byte: 1 (prepended before Base58 encoding)
+ * - Raw address: 32 bytes
+ * - Base58 encoded: exactly 50 characters
+ *
+ * This class provides a type-safe wrapper for Concordium addresses,
+ * ensuring correct encoding/decoding and validation.
+ */
+class AccountAddress {
+    buffer;
+    /** Base58-encoded address string (50 characters) */
+    address;
+    /**
+     * Private constructor - use fromBase58() or fromBuffer() to create instances.
+     * @param buffer - Raw 32-byte address
+     */
+    constructor(buffer) {
+        this.buffer = buffer;
+        if (buffer.length !== 32) {
+            throw new Error("Address must be 32 bytes");
+        }
+        this.address = this.toBase58();
+    }
+    /**
+     * Parse a Base58-encoded Concordium address.
+     *
+     * @param address - Base58 address string (must be exactly 50 characters)
+     * @returns AccountAddress instance
+     * @throws Error if address is not 50 characters or has invalid version byte
+     *
+     * @example
+     * const addr = AccountAddress.fromBase58("3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSYLwK1G");
+     */
+    static fromBase58(address) {
+        if (address.length !== 50) {
+            throw new Error("Address must be 50 characters");
+        }
+        const decoded = bs58check_1.default.decode(address);
+        if (decoded[0] !== 1) {
+            throw new Error("Invalid address version");
+        }
+        const addressBytes = Buffer.from(decoded.subarray(1));
+        return new AccountAddress(addressBytes);
+    }
+    /**
+     * Create an AccountAddress from raw 32-byte buffer.
+     *
+     * @param buffer - Raw address bytes (must be exactly 32 bytes)
+     * @returns AccountAddress instance
+     * @throws Error if buffer is not 32 bytes
+     *
+     * @example
+     * const addr = AccountAddress.fromBuffer(Buffer.from("...", "hex"));
+     */
+    static fromBuffer(buffer) {
+        if (buffer.length !== 32) {
+            throw new Error("Address buffer must be 32 bytes");
+        }
+        return new AccountAddress(buffer);
+    }
+    /**
+     * Convert address to Base58-encoded string.
+     *
+     * @returns Base58-encoded address (50 characters)
+     *
+     * @example
+     * const base58 = addr.toBase58();
+     * // "3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSYLwK1G"
+     */
+    toBase58() {
+        const withVersion = Buffer.concat([Buffer.from([1]), this.buffer]);
+        return bs58check_1.default.encode(withVersion);
+    }
+    /**
+     * Get raw 32-byte address buffer.
+     *
+     * @returns Raw address bytes (32 bytes)
+     *
+     * @example
+     * const raw = addr.toBuffer();
+     * // Buffer of 32 bytes
+     */
+    toBuffer() {
+        return Buffer.from(this.buffer);
+    }
+    /**
+     * Check if a string is a valid Concordium account address.
+     *
+     * @param address - String to validate
+     * @returns true if the address is valid, false otherwise
+     */
+    static isValid(address) {
+        try {
+            AccountAddress.fromBase58(address);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.AccountAddress = AccountAddress;
+//# sourceMappingURL=address.js.map

package/lib/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAkC;AAElC;;;;;;;;;;GAUG;AACH,MAAa,cAAc;IAQY;IAPrC,oDAAoD;IACpC,OAAO,CAAS;IAEhC;;;OAGG;IACH,YAAqC,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CAAC,OAAe;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,mBAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1C,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,OAAO,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CAAC,MAAc;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;QACN,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,OAAO,mBAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;QACN,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,IAAI,CAAC;YACH,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAnGD,wCAmGC"}

package/lib/cbor.d.ts

@@ -0,0 +1,73 @@
+/**
+ * CBOR encoding/decoding utilities for Concordium memos.
+ *
+ * Concordium memos must be CBOR-encoded text strings before transmission to the device.
+ * The device firmware expects CBOR and decodes it for display during signing.
+ *
+ * This is a minimal CBOR implementation supporting only text strings (major type 3),
+ * which is all that's needed for Concordium memos.
+ * @private
+ */
+/// <reference types="node" />
+/// <reference types="node" />
+/**
+ * Maximum memo length in bytes (UTF-8 encoded) before CBOR encoding.
+ * The device firmware enforces a 256-byte limit on CBOR-encoded data.
+ * CBOR text string encoding adds 2 bytes overhead for lengths 24-254,
+ * so the maximum UTF-8 text is 254 bytes.
+ */
+export declare const MAX_MEMO_LENGTH = 254;
+/**
+ * Maximum CBOR-encoded memo size (including CBOR overhead).
+ * This is the device firmware limit.
+ */
+export declare const MAX_CBOR_SIZE = 256;
+/**
+ * Encodes a memo string to CBOR text string format.
+ *
+ * Concordium memos must be CBOR-encoded before transmission to the device.
+ * The device expects CBOR text strings and will decode them for display.
+ *
+ * CBOR text string encoding (major type 3):
+ * - 0x60-0x77: lengths 0-23 (direct encoding, 1 byte overhead)
+ * - 0x78 + length byte: lengths 24-254 (2 bytes overhead)
+ * - 0x79 + 2 length bytes: lengths 255-65535 (3 bytes overhead, not supported for memos)
+ *
+ * @param memo - The memo string to encode (max 254 bytes UTF-8)
+ * @returns Buffer containing CBOR-encoded text string
+ * @throws Error if memo exceeds 254 bytes UTF-8
+ */
+export declare function encodeMemoToCbor(memo: string): Buffer;
+/**
+ * Returns the CBOR-encoded byte length of a memo string without allocating.
+ *
+ * Equivalent to `encodeMemoToCbor(memo).length` but without the Buffer allocation,
+ * useful for size checks before encoding.
+ *
+ * @param memo - The memo string (UTF-8)
+ * @returns Total byte length after CBOR encoding
+ */
+export declare function memoEncodedSize(memo: string): number;
+/**
+ * Decodes a CBOR-encoded memo string.
+ *
+ * The wallet-proxy and device return memos in CBOR-encoded format.
+ * This function decodes them back to plain UTF-8 strings for display.
+ *
+ * Supports CBOR text string decoding:
+ * - 0x60-0x77: lengths 0-23
+ * - 0x78 + 1 byte: lengths 24-255
+ * - 0x79 + 2 bytes: lengths 256-65535
+ *
+ * Note: While we only encode up to 254 bytes, we support decoding larger memos
+ * that may come from wallet-proxy or other sources.
+ *
+ * If you have a hex or base64 encoded string, convert it to Buffer first:
+ * - From hex: `Buffer.from(hexString, "hex")`
+ * - From base64: `Buffer.from(base64String, "base64")`
+ *
+ * @param cborEncoded - CBOR-encoded memo as Buffer
+ * @returns Decoded UTF-8 string
+ */
+export declare function decodeMemoFromCbor(cborEncoded: Buffer): string;
+//# sourceMappingURL=cbor.d.ts.map

package/lib/cbor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbor.d.ts","sourceRoot":"","sources":["../src/cbor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;;AAWH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA4C9D"}

package/lib/cbor.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * CBOR encoding/decoding utilities for Concordium memos.
+ *
+ * Concordium memos must be CBOR-encoded text strings before transmission to the device.
+ * The device firmware expects CBOR and decodes it for display during signing.
+ *
+ * This is a minimal CBOR implementation supporting only text strings (major type 3),
+ * which is all that's needed for Concordium memos.
+ * @private
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeMemoFromCbor = exports.memoEncodedSize = exports.encodeMemoToCbor = exports.MAX_CBOR_SIZE = exports.MAX_MEMO_LENGTH = void 0;
+/** @private */
+const CBOR_TEXT_STRING_BASE = 0x60;
+/** @private */
+const CBOR_MAX_SHORT_LENGTH = 24;
+/** @private */
+const CBOR_TEXT_STRING_1BYTE = 0x78;
+/** @private */
+const CBOR_TEXT_STRING_2BYTE = 0x79;
+/**
+ * Maximum memo length in bytes (UTF-8 encoded) before CBOR encoding.
+ * The device firmware enforces a 256-byte limit on CBOR-encoded data.
+ * CBOR text string encoding adds 2 bytes overhead for lengths 24-254,
+ * so the maximum UTF-8 text is 254 bytes.
+ */
+exports.MAX_MEMO_LENGTH = 254;
+/**
+ * Maximum CBOR-encoded memo size (including CBOR overhead).
+ * This is the device firmware limit.
+ */
+exports.MAX_CBOR_SIZE = 256;
+/**
+ * Encodes a memo string to CBOR text string format.
+ *
+ * Concordium memos must be CBOR-encoded before transmission to the device.
+ * The device expects CBOR text strings and will decode them for display.
+ *
+ * CBOR text string encoding (major type 3):
+ * - 0x60-0x77: lengths 0-23 (direct encoding, 1 byte overhead)
+ * - 0x78 + length byte: lengths 24-254 (2 bytes overhead)
+ * - 0x79 + 2 length bytes: lengths 255-65535 (3 bytes overhead, not supported for memos)
+ *
+ * @param memo - The memo string to encode (max 254 bytes UTF-8)
+ * @returns Buffer containing CBOR-encoded text string
+ * @throws Error if memo exceeds 254 bytes UTF-8
+ */
+function encodeMemoToCbor(memo) {
+    const memoBytes = Buffer.from(memo, "utf-8");
+    const memoLength = memoBytes.length;
+    if (memoLength > exports.MAX_MEMO_LENGTH) {
+        throw new Error(`Memo length ${memoLength} exceeds maximum of ${exports.MAX_MEMO_LENGTH} bytes (UTF-8)`);
+    }
+    let cborHeader;
+    if (memoLength < CBOR_MAX_SHORT_LENGTH) {
+        // Short form: 0x60-0x77 (length 0-23)
+        cborHeader = Buffer.from([CBOR_TEXT_STRING_BASE + memoLength]);
+    }
+    else {
+        // 1-byte length form: 0x78 + 1 byte length (length 24-254)
+        cborHeader = Buffer.from([CBOR_TEXT_STRING_1BYTE, memoLength]);
+    }
+    return Buffer.concat([cborHeader, memoBytes]);
+}
+exports.encodeMemoToCbor = encodeMemoToCbor;
+/**
+ * Returns the CBOR-encoded byte length of a memo string without allocating.
+ *
+ * Equivalent to `encodeMemoToCbor(memo).length` but without the Buffer allocation,
+ * useful for size checks before encoding.
+ *
+ * @param memo - The memo string (UTF-8)
+ * @returns Total byte length after CBOR encoding
+ */
+function memoEncodedSize(memo) {
+    const memoBytes = Buffer.byteLength(memo, "utf-8");
+    const cborOverhead = memoBytes < CBOR_MAX_SHORT_LENGTH ? 1 : 2;
+    return memoBytes + cborOverhead;
+}
+exports.memoEncodedSize = memoEncodedSize;
+/**
+ * Decodes a CBOR-encoded memo string.
+ *
+ * The wallet-proxy and device return memos in CBOR-encoded format.
+ * This function decodes them back to plain UTF-8 strings for display.
+ *
+ * Supports CBOR text string decoding:
+ * - 0x60-0x77: lengths 0-23
+ * - 0x78 + 1 byte: lengths 24-255
+ * - 0x79 + 2 bytes: lengths 256-65535
+ *
+ * Note: While we only encode up to 254 bytes, we support decoding larger memos
+ * that may come from wallet-proxy or other sources.
+ *
+ * If you have a hex or base64 encoded string, convert it to Buffer first:
+ * - From hex: `Buffer.from(hexString, "hex")`
+ * - From base64: `Buffer.from(base64String, "base64")`
+ *
+ * @param cborEncoded - CBOR-encoded memo as Buffer
+ * @returns Decoded UTF-8 string
+ */
+function decodeMemoFromCbor(cborEncoded) {
+    if (cborEncoded.length === 0) {
+        return "";
+    }
+    // Read CBOR header (first byte)
+    const header = cborEncoded[0];
+    let length;
+    let dataStart;
+    if (header >= CBOR_TEXT_STRING_BASE && header < CBOR_TEXT_STRING_BASE + CBOR_MAX_SHORT_LENGTH) {
+        // Short form: 0x60-0x77 (length 0-23)
+        length = header - CBOR_TEXT_STRING_BASE;
+        dataStart = 1;
+    }
+    else if (header === CBOR_TEXT_STRING_1BYTE) {
+        // 1-byte length form: 0x78 + 1 byte length
+        if (cborEncoded.length < 2) {
+            throw new Error("Invalid CBOR: insufficient data for 1-byte length");
+        }
+        length = cborEncoded[1];
+        dataStart = 2;
+    }
+    else if (header === CBOR_TEXT_STRING_2BYTE) {
+        // 2-byte length form: 0x79 + 2 bytes length (big-endian)
+        if (cborEncoded.length < 3) {
+            throw new Error("Invalid CBOR: insufficient data for 2-byte length");
+        }
+        length = cborEncoded.readUInt16BE(1);
+        dataStart = 3;
+    }
+    else {
+        throw new Error(`Invalid CBOR: expected text string (major type 3), got header byte 0x${header.toString(16)}`);
+    }
+    // Validate we have enough data
+    if (cborEncoded.length < dataStart + length) {
+        throw new Error(`Invalid CBOR: insufficient data (expected ${dataStart + length} bytes, got ${cborEncoded.length})`);
+    }
+    // Extract and decode the text data
+    const textData = cborEncoded.subarray(dataStart, dataStart + length);
+    return textData.toString("utf-8");
+}
+exports.decodeMemoFromCbor = decodeMemoFromCbor;
+//# sourceMappingURL=cbor.js.map

package/lib/cbor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbor.js","sourceRoot":"","sources":["../src/cbor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,eAAe;AACf,MAAM,qBAAqB,GAAG,IAAI,CAAC;AACnC,eAAe;AACf,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,eAAe;AACf,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,eAAe;AACf,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC;;;;;GAKG;AACU,QAAA,eAAe,GAAG,GAAG,CAAC;AAEnC;;;GAGG;AACU,QAAA,aAAa,GAAG,GAAG,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC;IAEpC,IAAI,UAAU,GAAG,uBAAe,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,eAAe,UAAU,uBAAuB,uBAAe,gBAAgB,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,UAAkB,CAAC;IAEvB,IAAI,UAAU,GAAG,qBAAqB,EAAE,CAAC;QACvC,sCAAsC;QACtC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,qBAAqB,GAAG,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,2DAA2D;QAC3D,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC;AArBD,4CAqBC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,SAAS,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,SAAS,GAAG,YAAY,CAAC;AAClC,CAAC;AAJD,0CAIC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,kBAAkB,CAAC,WAAmB;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,MAAc,CAAC;IACnB,IAAI,SAAiB,CAAC;IAEtB,IAAI,MAAM,IAAI,qBAAqB,IAAI,MAAM,GAAG,qBAAqB,GAAG,qBAAqB,EAAE,CAAC;QAC9F,sCAAsC;QACtC,MAAM,GAAG,MAAM,GAAG,qBAAqB,CAAC;QACxC,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC;SAAM,IAAI,MAAM,KAAK,sBAAsB,EAAE,CAAC;QAC7C,2CAA2C;QAC3C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACxB,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC;SAAM,IAAI,MAAM,KAAK,sBAAsB,EAAE,CAAC;QAC7C,yDAAyD;QACzD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrC,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,wEAAwE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,WAAW,CAAC,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,6CAA6C,SAAS,GAAG,MAAM,eAAe,WAAW,CAAC,MAAM,GAAG,CACpG,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AA5CD,gDA4CC"}

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./address";
+export * from "./cbor";
+export * from "./utils";
+export * from "./serialization";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/lib/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./address"), exports);
+__exportStar(require("./cbor"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./serialization"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB;AACxB,kDAAgC"}