@andamio/core 0.1.1 → 0.3.0

package/dist/utils/hashing/index.d.ts

@@ -69,37 +69,58 @@ declare function isValidSltHash(hash: string): boolean;
  * Computes the task token name (hash) from task data.
  * This hash is used as the task_hash on-chain (content-addressed identifier).
  *
- * The algorithm matches the on-chain Plutus validator serialization.
+ * The algorithm matches the on-chain Aiken/Haskell hash_project_data function:
+ * - Serialize task data as Plutus Data (CBOR with tag 121 for Constructor 0)
+ * - Use indefinite-length arrays for constructor fields
+ * - Hash with Blake2b-256
  *
  * @module @andamio/core/hashing
  */
 /**
- * Native asset in ListValue format: [policyId.tokenName, quantity]
+ * Native asset in Cardano format: [policyId, tokenName, quantity]
+ *
+ * @example
+ * ```typescript
+ * const asset: NativeAsset = [
+ *   "abc123def456...".repeat(4), // 56 hex chars (28 bytes) - policy ID
+ *   "746f6b656e",                // hex-encoded token name
+ *   1000n                        // quantity as bigint
+ * ];
+ * ```
  */
-type NativeAsset = [string, number];
+type NativeAsset = [
+    policyId: string,
+    tokenName: string,
+    quantity: bigint
+];
 /**
- * Task data structure matching the Atlas TX API ManageTasksTxRequest
+ * Task data structure matching the Aiken ProjectData type.
  *
- * Fields must be arranged in this specific order for hashing:
- * 1. project_content (string, max 140 chars)
- * 2. expiration_time (number, Unix timestamp in milliseconds)
- * 3. lovelace_amount (number)
- * 4. native_assets (array of [asset_class, quantity] tuples)
+ * Serialized as Plutus Data Constructor 0 (CBOR tag 121) with fields:
+ * 1. project_content (ByteArray - UTF-8 encoded, NFC normalized)
+ * 2. deadline (Int - milliseconds)
+ * 3. lovelace_am (Int - micro-ADA)
+ * 4. tokens (List<FlatValue> - native assets)
  */
 interface TaskData {
+    /** Task description (max 140 characters) */
     project_content: string;
-    expiration_time: number;
-    lovelace_amount: number;
-    native_assets: NativeAsset[];
+    /** Unix timestamp in milliseconds */
+    expiration_time: bigint;
+    /** Lovelace amount (micro-ADA) */
+    lovelace_amount: bigint;
+    /** Native assets attached to task */
+    native_assets: readonly NativeAsset[];
 }
 /**
  * Compute the task hash (token name / task_hash) from task data.
  *
- * This produces the same hash as the on-chain Plutus validator, allowing
- * clients to pre-compute or verify task hashes.
+ * This produces the same hash as the on-chain Aiken hash_project_data function,
+ * allowing clients to pre-compute or verify task hashes.
  *
  * @param task - Task data object
  * @returns 64-character hex string (256-bit Blake2b hash)
+ * @throws Error if task data validation fails
  *
  * @example
  * ```typescript
@@ -107,8 +128,8 @@ interface TaskData {
  *
  * const task = {
  *   project_content: "Open Task #1",
- *   expiration_time: 1769027280000,
- *   lovelace_amount: 15000000,
+ *   expiration_time: 1769027280000n,
+ *   lovelace_amount: 15000000n,
  *   native_assets: []
  * };
  *
@@ -136,9 +157,9 @@ declare function isValidTaskHash(hash: string): boolean;
  * Useful for comparing against on-chain data.
  *
  * @param task - Task data object
- * @returns Hex string of the CBOR-encoded data (before hashing)
+ * @returns Hex string of the CBOR-encoded Plutus Data (before hashing)
  */
-declare function debugTaskCBOR(task: TaskData): string;
+declare function debugTaskBytes(task: TaskData): string;
 
 /**
  * Commitment Hash Utility
@@ -273,4 +294,4 @@ declare const verifyAssignmentInfoHash: typeof verifyCommitmentHash;
  */
 declare const isValidAssignmentInfoHash: typeof isValidCommitmentHash;
 
-export { type EvidenceVerificationResult, type TaskData, type TiptapDoc, type TiptapMark, type TiptapNode, computeAssignmentInfoHash, computeCommitmentHash, computeSltHash, computeSltHashDefinite, computeTaskHash, debugTaskCBOR, isValidAssignmentInfoHash, isValidCommitmentHash, isValidSltHash, isValidTaskHash, normalizeForHashing, verifyAssignmentInfoHash, verifyCommitmentHash, verifyEvidenceDetailed, verifySltHash, verifyTaskHash };
+export { type EvidenceVerificationResult, type NativeAsset, type TaskData, type TiptapDoc, type TiptapMark, type TiptapNode, computeAssignmentInfoHash, computeCommitmentHash, computeSltHash, computeSltHashDefinite, computeTaskHash, debugTaskBytes, isValidAssignmentInfoHash, isValidCommitmentHash, isValidSltHash, isValidTaskHash, normalizeForHashing, verifyAssignmentInfoHash, verifyCommitmentHash, verifyEvidenceDetailed, verifySltHash, verifyTaskHash };

package/dist/utils/hashing/index.js

@@ -79,10 +79,10 @@ function concatUint8Arrays(arrays) {
   }
   return result;
 }
-var PLUTUS_CHUNK_SIZE2 = 64;
 function computeTaskHash(task) {
-  const cborData = encodeTaskAsPlutusData(task);
-  return blake__default.default.blake2bHex(cborData, void 0, 32);
+  validateTaskData(task);
+  const bytes = encodeTaskAsPlutusData(task);
+  return blake__default.default.blake2bHex(bytes, void 0, 32);
 }
 function verifyTaskHash(task, expectedHash) {
   const computedHash = computeTaskHash(task);
@@ -94,108 +94,148 @@ function isValidTaskHash(hash) {
   }
   return /^[0-9a-fA-F]{64}$/.test(hash);
 }
-function debugTaskCBOR(task) {
-  const cborData = encodeTaskAsPlutusData(task);
-  return uint8ArrayToHex(cborData);
+function debugTaskBytes(task) {
+  validateTaskData(task);
+  const bytes = encodeTaskAsPlutusData(task);
+  return uint8ArrayToHex(bytes);
 }
 function encodeTaskAsPlutusData(task) {
-  const chunks = [];
-  chunks.push(new Uint8Array([216, 121]));
-  chunks.push(new Uint8Array([159]));
-  chunks.push(encodePlutusBuiltinByteString2(new TextEncoder().encode(task.project_content)));
-  chunks.push(encodePlutusInteger(task.expiration_time));
-  chunks.push(encodePlutusInteger(task.lovelace_amount));
-  chunks.push(encodeNativeAssets(task.native_assets));
-  chunks.push(new Uint8Array([255]));
-  return concatUint8Arrays2(chunks);
+  const normalizedContent = task.project_content.normalize("NFC");
+  const contentBytes = new TextEncoder().encode(normalizedContent);
+  return concatUint8Arrays2([
+    // Tag 121 (Plutus Data Constructor 0) + indefinite array start
+    new Uint8Array([216, 121, 159]),
+    // Field 1: project_content (ByteArray)
+    encodeCborBytes(contentBytes),
+    // Field 2: deadline (Int)
+    encodeCborUint(task.expiration_time),
+    // Field 3: lovelace_am (Int)
+    encodeCborUint(task.lovelace_amount),
+    // Field 4: tokens (List<FlatValue>)
+    encodeTokensList(task.native_assets),
+    // Break (end of indefinite array)
+    new Uint8Array([255])
+  ]);
 }
-function encodeNativeAssets(assets) {
+function encodeTokensList(assets) {
   if (assets.length === 0) {
     return new Uint8Array([128]);
   }
-  const chunks = [];
-  chunks.push(new Uint8Array([159]));
-  for (const [assetClass, quantity] of assets) {
-    chunks.push(new Uint8Array([130]));
-    chunks.push(encodePlutusBuiltinByteString2(new TextEncoder().encode(assetClass)));
-    chunks.push(encodePlutusInteger(quantity));
+  const parts = [new Uint8Array([159])];
+  for (const [policyId, tokenName, quantity] of assets) {
+    parts.push(new Uint8Array([216, 121, 159]));
+    parts.push(encodeCborBytes(hexToBytes(policyId)));
+    parts.push(encodeCborBytes(hexToBytes(tokenName)));
+    parts.push(encodeCborUint(quantity));
+    parts.push(new Uint8Array([255]));
   }
-  chunks.push(new Uint8Array([255]));
-  return concatUint8Arrays2(chunks);
+  parts.push(new Uint8Array([255]));
+  return concatUint8Arrays2(parts);
 }
-function encodePlutusBuiltinByteString2(buffer) {
-  if (buffer.length <= PLUTUS_CHUNK_SIZE2) {
-    return encodeCBORByteString2(buffer);
+var MAX_UINT64 = 18446744073709551615n;
+function encodeCborUint(n) {
+  if (n < 0n) {
+    throw new Error("Negative integers not supported");
   }
-  const chunks = [];
-  chunks.push(new Uint8Array([95]));
-  for (let i = 0; i < buffer.length; i += PLUTUS_CHUNK_SIZE2) {
-    const chunk = buffer.subarray(i, Math.min(i + PLUTUS_CHUNK_SIZE2, buffer.length));
-    chunks.push(encodeCBORByteString2(chunk));
+  if (n > MAX_UINT64) {
+    throw new Error(
+      `Integer exceeds maximum CBOR uint64 value (got ${n}, max ${MAX_UINT64})`
+    );
+  }
+  if (n < 24n) {
+    return new Uint8Array([Number(n)]);
+  } else if (n < 256n) {
+    return new Uint8Array([24, Number(n)]);
+  } else if (n < 65536n) {
+    return new Uint8Array([25, Number(n >> 8n) & 255, Number(n) & 255]);
+  } else if (n < 4294967296n) {
+    return new Uint8Array([
+      26,
+      Number(n >> 24n & 0xffn),
+      Number(n >> 16n & 0xffn),
+      Number(n >> 8n & 0xffn),
+      Number(n & 0xffn)
+    ]);
+  } else {
+    return new Uint8Array([
+      27,
+      Number(n >> 56n & 0xffn),
+      Number(n >> 48n & 0xffn),
+      Number(n >> 40n & 0xffn),
+      Number(n >> 32n & 0xffn),
+      Number(n >> 24n & 0xffn),
+      Number(n >> 16n & 0xffn),
+      Number(n >> 8n & 0xffn),
+      Number(n & 0xffn)
+    ]);
   }
-  chunks.push(new Uint8Array([255]));
-  return concatUint8Arrays2(chunks);
 }
-function encodePlutusInteger(n) {
-  if (n >= 0) {
-    if (n <= 23) {
-      return new Uint8Array([n]);
-    } else if (n <= 255) {
-      return new Uint8Array([24, n]);
-    } else if (n <= 65535) {
-      return new Uint8Array([25, n >> 8, n & 255]);
-    } else if (n <= 4294967295) {
-      return new Uint8Array([26, n >> 24 & 255, n >> 16 & 255, n >> 8 & 255, n & 255]);
-    } else {
-      const buf = new Uint8Array(9);
-      buf[0] = 27;
-      const big = BigInt(n);
-      const view = new DataView(buf.buffer);
-      view.setBigUint64(1, big, false);
-      return buf;
-    }
+function encodeCborBytes(bytes) {
+  const len = bytes.length;
+  let header;
+  if (len < 24) {
+    header = new Uint8Array([64 + len]);
+  } else if (len < 256) {
+    header = new Uint8Array([88, len]);
+  } else if (len < 65536) {
+    header = new Uint8Array([89, len >> 8 & 255, len & 255]);
   } else {
-    const absVal = -1 - n;
-    if (absVal <= 23) {
-      return new Uint8Array([32 + absVal]);
-    } else if (absVal <= 255) {
-      return new Uint8Array([56, absVal]);
-    } else if (absVal <= 65535) {
-      return new Uint8Array([57, absVal >> 8, absVal & 255]);
-    } else if (absVal <= 4294967295) {
-      return new Uint8Array([58, absVal >> 24 & 255, absVal >> 16 & 255, absVal >> 8 & 255, absVal & 255]);
-    } else {
-      const buf = new Uint8Array(9);
-      buf[0] = 59;
-      const big = BigInt(absVal);
-      const view = new DataView(buf.buffer);
-      view.setBigUint64(1, big, false);
-      return buf;
+    throw new Error("Byte string too long for CBOR encoding");
+  }
+  return concatUint8Arrays2([header, bytes]);
+}
+function validateTaskData(task) {
+  if (task.project_content.length > 140) {
+    throw new Error(
+      `project_content exceeds 140 characters (got ${task.project_content.length})`
+    );
+  }
+  if (task.expiration_time < 0n) {
+    throw new Error("expiration_time must be non-negative");
+  }
+  if (task.lovelace_amount < 0n) {
+    throw new Error("lovelace_amount must be non-negative");
+  }
+  for (const [policyId, tokenName, quantity] of task.native_assets) {
+    if (policyId.length !== 56) {
+      throw new Error(
+        `policyId must be 56 hex chars (got ${policyId.length})`
+      );
+    }
+    if (!/^[0-9a-fA-F]*$/.test(policyId)) {
+      throw new Error("policyId contains invalid hex characters");
+    }
+    if (tokenName.length > 64 || tokenName.length % 2 !== 0) {
+      throw new Error(
+        `tokenName must be 0-64 hex chars with even length (got ${tokenName.length})`
+      );
+    }
+    if (tokenName.length > 0 && !/^[0-9a-fA-F]*$/.test(tokenName)) {
+      throw new Error("tokenName contains invalid hex characters");
+    }
+    if (quantity < 0n) {
+      throw new Error("asset quantity must be non-negative");
     }
   }
 }
-function encodeCBORByteString2(buffer) {
-  const len = buffer.length;
-  if (len <= 23) {
-    const result = new Uint8Array(1 + len);
-    result[0] = 64 + len;
-    result.set(buffer, 1);
-    return result;
-  } else if (len <= 255) {
-    const result = new Uint8Array(2 + len);
-    result[0] = 88;
-    result[1] = len;
-    result.set(buffer, 2);
-    return result;
-  } else if (len <= 65535) {
-    const result = new Uint8Array(3 + len);
-    result[0] = 89;
-    result[1] = len >> 8;
-    result[2] = len & 255;
-    result.set(buffer, 3);
-    return result;
+function hexToBytes(hex) {
+  if (hex.length === 0) {
+    return new Uint8Array([]);
   }
-  throw new Error("Byte string too long for CBOR encoding");
+  if (hex.length % 2 !== 0) {
+    throw new Error(`Invalid hex string: odd length (${hex.length})`);
+  }
+  const bytes = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < bytes.length; i++) {
+    const byte = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    if (Number.isNaN(byte)) {
+      throw new Error(
+        `Invalid hex character at position ${i * 2}: "${hex.slice(i * 2, i * 2 + 2)}"`
+      );
+    }
+    bytes[i] = byte;
+  }
+  return bytes;
 }
 function concatUint8Arrays2(arrays) {
   const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
@@ -282,7 +322,7 @@ exports.computeCommitmentHash = computeCommitmentHash;
 exports.computeSltHash = computeSltHash;
 exports.computeSltHashDefinite = computeSltHashDefinite;
 exports.computeTaskHash = computeTaskHash;
-exports.debugTaskCBOR = debugTaskCBOR;
+exports.debugTaskBytes = debugTaskBytes;
 exports.isValidAssignmentInfoHash = isValidAssignmentInfoHash;
 exports.isValidCommitmentHash = isValidCommitmentHash;
 exports.isValidSltHash = isValidSltHash;

package/dist/utils/hashing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/hashing/slt-hash.ts","../../../src/utils/hashing/task-hash.ts","../../../src/utils/hashing/commitment-hash.ts"],"names":["blake","PLUTUS_CHUNK_SIZE","encodePlutusBuiltinByteString","concatUint8Arrays","encodeCBORByteString"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * SLT Hash Utility\n *\n * Computes the module token name (hash) from a list of Student Learning Targets (SLTs).\n * This hash is used as the token name when minting module tokens on-chain.\n *\n * The algorithm matches the on-chain Plutus validator:\n * ```haskell\n * sltsToBbs MintModuleV2{slts} = blake2b_256 $ serialiseData $ toBuiltinData $ map stringToBuiltinByteString slts\n * ```\n *\n * Serialization format:\n * 1. Convert each SLT string to UTF-8 bytes\n * 2. Encode as CBOR indefinite-length array of byte strings\n * 3. Hash with Blake2b-256 (32 bytes / 256 bits)\n *\n * @module @andamio/core/hashing\n */\n\nimport blake from \"blakejs\";\n\n/**\n * Plutus chunk size for byte strings.\n * Strings longer than this are encoded as indefinite-length chunked byte strings.\n */\nconst PLUTUS_CHUNK_SIZE = 64;\n\n/**\n * Compute the module hash matching Plutus on-chain encoding.\n *\n * Plutus's `stringToBuiltinByteString` chunks byte strings at 64 bytes.\n * This function replicates that behavior:\n * - Strings <= 64 bytes: encoded as regular CBOR byte strings\n * - Strings > 64 bytes: encoded as indefinite-length chunked byte strings\n *\n * @param slts - Array of Student Learning Target strings\n * @returns 64-character hex string (256-bit Blake2b hash)\n *\n * @example\n * ```typescript\n * import { computeSltHash } from \"@andamio/core/hashing\";\n *\n * const slts = [\n *   \"I can mint an access token.\",\n *   \"I can complete an assignment to earn a credential.\"\n * ];\n *\n * const moduleHash = computeSltHash(slts);\n * // Returns: \"8dcbe1b925d87e6c547bbd8071c23a712db4c32751454b0948f8c846e9246b5c\"\n * ```\n */\nexport function computeSltHash(slts: string[]): string {\n  const sltBytes = slts.map((slt) => new TextEncoder().encode(slt));\n  const cborData = encodeAsPlutusArray(sltBytes);\n  return blake.blake2bHex(cborData, undefined, 32);\n}\n\n/**\n * @deprecated Use `computeSltHash` instead. This alias is kept for backwards compatibility.\n */\nexport const computeSltHashDefinite = computeSltHash;\n\n/**\n * Verify that a given hash matches the computed hash for SLTs.\n *\n * @param slts - Array of Student Learning Target strings\n * @param expectedHash - The hash to verify (64-character hex string)\n * @returns true if the computed hash matches the expected hash\n */\nexport function verifySltHash(slts: string[], expectedHash: string): boolean {\n  const computedHash = computeSltHash(slts);\n  return computedHash.toLowerCase() === expectedHash.toLowerCase();\n}\n\n/**\n * Validate that a string is a valid SLT hash format.\n *\n * SLT hashes are 64-character hexadecimal strings (256-bit Blake2b hash).\n *\n * @param hash - String to validate\n * @returns true if the string is a valid SLT hash format\n */\nexport function isValidSltHash(hash: string): boolean {\n  if (hash.length !== 64) {\n    return false;\n  }\n  return /^[0-9a-fA-F]{64}$/.test(hash);\n}\n\n// =============================================================================\n// Plutus-Compatible Encoding (Internal)\n// =============================================================================\n\n/**\n * Encode an array of byte buffers matching Plutus serialization.\n *\n * Uses indefinite-length array with chunked byte strings for long values.\n *\n * @internal\n */\nfunction encodeAsPlutusArray(items: Uint8Array[]): Uint8Array {\n  const chunks: Uint8Array[] = [];\n\n  // Start indefinite array\n  chunks.push(new Uint8Array([0x9f]));\n\n  // Encode each item (with chunking for long strings)\n  for (const item of items) {\n    chunks.push(encodePlutusBuiltinByteString(item));\n  }\n\n  // End indefinite array\n  chunks.push(new Uint8Array([0xff]));\n\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode a byte buffer matching Plutus's stringToBuiltinByteString.\n *\n * - Strings <= 64 bytes: regular CBOR byte string\n * - Strings > 64 bytes: indefinite-length chunked byte string (64-byte chunks)\n *\n * @internal\n */\nfunction encodePlutusBuiltinByteString(buffer: Uint8Array): Uint8Array {\n  if (buffer.length <= PLUTUS_CHUNK_SIZE) {\n    // Short string: encode normally\n    return encodeCBORByteString(buffer);\n  }\n\n  // Long string: use indefinite-length chunked encoding\n  const chunks: Uint8Array[] = [];\n  chunks.push(new Uint8Array([0x5f])); // Start indefinite byte string\n\n  for (let i = 0; i < buffer.length; i += PLUTUS_CHUNK_SIZE) {\n    const chunk = buffer.subarray(i, Math.min(i + PLUTUS_CHUNK_SIZE, buffer.length));\n    chunks.push(encodeCBORByteString(chunk));\n  }\n\n  chunks.push(new Uint8Array([0xff])); // Break\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode a byte buffer as a CBOR byte string (definite length).\n *\n * @internal\n */\nfunction encodeCBORByteString(buffer: Uint8Array): Uint8Array {\n  const len = buffer.length;\n\n  // CBOR byte string encoding (major type 2 = 0x40):\n  // - 0-23 bytes: length inline (0x40 + len)\n  // - 24-255 bytes: 0x58 + 1-byte length\n  // - 256-65535 bytes: 0x59 + 2-byte length (big-endian)\n  if (len <= 23) {\n    const result = new Uint8Array(1 + len);\n    result[0] = 0x40 + len;\n    result.set(buffer, 1);\n    return result;\n  } else if (len <= 255) {\n    const result = new Uint8Array(2 + len);\n    result[0] = 0x58;\n    result[1] = len;\n    result.set(buffer, 2);\n    return result;\n  } else if (len <= 65535) {\n    const result = new Uint8Array(3 + len);\n    result[0] = 0x59;\n    result[1] = len >> 8;\n    result[2] = len & 0xff;\n    result.set(buffer, 3);\n    return result;\n  }\n  throw new Error(\"Byte string too long for CBOR encoding\");\n}\n\n/**\n * Concatenate multiple Uint8Arrays into one\n *\n * @internal\n */\nfunction concatUint8Arrays(arrays: Uint8Array[]): Uint8Array {\n  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const arr of arrays) {\n    result.set(arr, offset);\n    offset += arr.length;\n  }\n  return result;\n}\n","/**\n * Task Hash Utility\n *\n * Computes the task token name (hash) from task data.\n * This hash is used as the task_hash on-chain (content-addressed identifier).\n *\n * The algorithm matches the on-chain Plutus validator serialization.\n *\n * @module @andamio/core/hashing\n */\n\nimport blake from \"blakejs\";\n\n/**\n * Native asset in ListValue format: [policyId.tokenName, quantity]\n */\ntype NativeAsset = [string, number];\n\n/**\n * Task data structure matching the Atlas TX API ManageTasksTxRequest\n *\n * Fields must be arranged in this specific order for hashing:\n * 1. project_content (string, max 140 chars)\n * 2. expiration_time (number, Unix timestamp in milliseconds)\n * 3. lovelace_amount (number)\n * 4. native_assets (array of [asset_class, quantity] tuples)\n */\nexport interface TaskData {\n  project_content: string;\n  expiration_time: number;\n  lovelace_amount: number;\n  native_assets: NativeAsset[];\n}\n\n/**\n * Plutus chunk size for byte strings.\n */\nconst PLUTUS_CHUNK_SIZE = 64;\n\n/**\n * Compute the task hash (token name / task_hash) from task data.\n *\n * This produces the same hash as the on-chain Plutus validator, allowing\n * clients to pre-compute or verify task hashes.\n *\n * @param task - Task data object\n * @returns 64-character hex string (256-bit Blake2b hash)\n *\n * @example\n * ```typescript\n * import { computeTaskHash } from \"@andamio/core/hashing\";\n *\n * const task = {\n *   project_content: \"Open Task #1\",\n *   expiration_time: 1769027280000,\n *   lovelace_amount: 15000000,\n *   native_assets: []\n * };\n *\n * const taskHash = computeTaskHash(task);\n * // Returns the on-chain task_hash\n * ```\n */\nexport function computeTaskHash(task: TaskData): string {\n  // Serialize task data matching Plutus format\n  const cborData = encodeTaskAsPlutusData(task);\n\n  // Hash with Blake2b-256\n  return blake.blake2bHex(cborData, undefined, 32);\n}\n\n/**\n * Verify that a given hash matches the computed hash for a task.\n *\n * @param task - Task data object\n * @param expectedHash - The hash to verify (64-character hex string)\n * @returns true if the computed hash matches the expected hash\n */\nexport function verifyTaskHash(task: TaskData, expectedHash: string): boolean {\n  const computedHash = computeTaskHash(task);\n  return computedHash.toLowerCase() === expectedHash.toLowerCase();\n}\n\n/**\n * Validate that a string is a valid task hash format.\n *\n * Task hashes are 64-character hexadecimal strings (256-bit Blake2b hash).\n */\nexport function isValidTaskHash(hash: string): boolean {\n  if (hash.length !== 64) {\n    return false;\n  }\n  return /^[0-9a-fA-F]{64}$/.test(hash);\n}\n\n/**\n * Debug function to show the CBOR encoding of a task.\n * Useful for comparing against on-chain data.\n *\n * @param task - Task data object\n * @returns Hex string of the CBOR-encoded data (before hashing)\n */\nexport function debugTaskCBOR(task: TaskData): string {\n  const cborData = encodeTaskAsPlutusData(task);\n  return uint8ArrayToHex(cborData);\n}\n\n// =============================================================================\n// Plutus Data Encoding (Internal)\n// =============================================================================\n\n/**\n * Encode task data matching Plutus serialiseData $ toBuiltinData format.\n *\n * Plutus represents this as a constructor with fields in an INDEFINITE array:\n * Constr 0 [project_content, expiration_time, lovelace_amount, native_assets]\n *\n * IMPORTANT: Plutus uses indefinite-length arrays (0x9f...0xff) not definite (0x84).\n *\n * @internal\n */\nfunction encodeTaskAsPlutusData(task: TaskData): Uint8Array {\n  const chunks: Uint8Array[] = [];\n\n  // Plutus Constr 0 with indefinite array\n  // CBOR tag 121 (0xd879) = Constr 0 in Plutus Data\n  chunks.push(new Uint8Array([0xd8, 0x79])); // Tag 121 (Constr 0)\n  chunks.push(new Uint8Array([0x9f])); // Start indefinite array\n\n  // Field 1: project_content as BuiltinByteString\n  chunks.push(encodePlutusBuiltinByteString(new TextEncoder().encode(task.project_content)));\n\n  // Field 2: expiration_time as Integer\n  chunks.push(encodePlutusInteger(task.expiration_time));\n\n  // Field 3: lovelace_amount as Integer\n  chunks.push(encodePlutusInteger(task.lovelace_amount));\n\n  // Field 4: native_assets as List of pairs\n  chunks.push(encodeNativeAssets(task.native_assets));\n\n  // End indefinite array\n  chunks.push(new Uint8Array([0xff])); // Break\n\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode native assets as Plutus List of (AssetClass, Integer) pairs.\n *\n * Each asset is a pair: (policyId.tokenName, quantity)\n * In Plutus, this is: List [(ByteString, Integer)]\n *\n * @internal\n */\nfunction encodeNativeAssets(assets: NativeAsset[]): Uint8Array {\n  if (assets.length === 0) {\n    // Empty list: definite-length array of 0 elements\n    return new Uint8Array([0x80]); // Array(0)\n  }\n\n  const chunks: Uint8Array[] = [];\n\n  // Start indefinite array\n  chunks.push(new Uint8Array([0x9f]));\n\n  for (const [assetClass, quantity] of assets) {\n    // Each asset is a 2-element array: [bytestring, integer]\n    chunks.push(new Uint8Array([0x82])); // Array of 2 elements\n    chunks.push(encodePlutusBuiltinByteString(new TextEncoder().encode(assetClass)));\n    chunks.push(encodePlutusInteger(quantity));\n  }\n\n  // End indefinite array\n  chunks.push(new Uint8Array([0xff]));\n\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode a byte buffer matching Plutus's stringToBuiltinByteString.\n *\n * - Strings <= 64 bytes: regular CBOR byte string\n * - Strings > 64 bytes: indefinite-length chunked byte string (64-byte chunks)\n *\n * @internal\n */\nfunction encodePlutusBuiltinByteString(buffer: Uint8Array): Uint8Array {\n  if (buffer.length <= PLUTUS_CHUNK_SIZE) {\n    return encodeCBORByteString(buffer);\n  }\n\n  // Long string: use indefinite-length chunked encoding\n  const chunks: Uint8Array[] = [];\n  chunks.push(new Uint8Array([0x5f])); // Start indefinite byte string\n\n  for (let i = 0; i < buffer.length; i += PLUTUS_CHUNK_SIZE) {\n    const chunk = buffer.subarray(i, Math.min(i + PLUTUS_CHUNK_SIZE, buffer.length));\n    chunks.push(encodeCBORByteString(chunk));\n  }\n\n  chunks.push(new Uint8Array([0xff])); // Break\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode a number as a CBOR integer (Plutus Integer).\n *\n * @internal\n */\nfunction encodePlutusInteger(n: number): Uint8Array {\n  // CBOR integer encoding (major type 0 for positive, 1 for negative)\n  if (n >= 0) {\n    if (n <= 23) {\n      return new Uint8Array([n]);\n    } else if (n <= 0xff) {\n      return new Uint8Array([0x18, n]);\n    } else if (n <= 0xffff) {\n      return new Uint8Array([0x19, n >> 8, n & 0xff]);\n    } else if (n <= 0xffffffff) {\n      return new Uint8Array([0x1a, (n >> 24) & 0xff, (n >> 16) & 0xff, (n >> 8) & 0xff, n & 0xff]);\n    } else {\n      // 64-bit integer - use BigInt for precision\n      const buf = new Uint8Array(9);\n      buf[0] = 0x1b;\n      const big = BigInt(n);\n      const view = new DataView(buf.buffer);\n      view.setBigUint64(1, big, false); // false = big-endian\n      return buf;\n    }\n  } else {\n    // Negative integers: major type 1, encode (-1 - n)\n    const absVal = -1 - n;\n    if (absVal <= 23) {\n      return new Uint8Array([0x20 + absVal]);\n    } else if (absVal <= 0xff) {\n      return new Uint8Array([0x38, absVal]);\n    } else if (absVal <= 0xffff) {\n      return new Uint8Array([0x39, absVal >> 8, absVal & 0xff]);\n    } else if (absVal <= 0xffffffff) {\n      return new Uint8Array([0x3a, (absVal >> 24) & 0xff, (absVal >> 16) & 0xff, (absVal >> 8) & 0xff, absVal & 0xff]);\n    } else {\n      const buf = new Uint8Array(9);\n      buf[0] = 0x3b;\n      const big = BigInt(absVal);\n      const view = new DataView(buf.buffer);\n      view.setBigUint64(1, big, false);\n      return buf;\n    }\n  }\n}\n\n/**\n * Encode a byte buffer as a CBOR byte string (definite length).\n *\n * @internal\n */\nfunction encodeCBORByteString(buffer: Uint8Array): Uint8Array {\n  const len = buffer.length;\n\n  if (len <= 23) {\n    const result = new Uint8Array(1 + len);\n    result[0] = 0x40 + len;\n    result.set(buffer, 1);\n    return result;\n  } else if (len <= 255) {\n    const result = new Uint8Array(2 + len);\n    result[0] = 0x58;\n    result[1] = len;\n    result.set(buffer, 2);\n    return result;\n  } else if (len <= 65535) {\n    const result = new Uint8Array(3 + len);\n    result[0] = 0x59;\n    result[1] = len >> 8;\n    result[2] = len & 0xff;\n    result.set(buffer, 3);\n    return result;\n  }\n  throw new Error(\"Byte string too long for CBOR encoding\");\n}\n\n/**\n * Concatenate multiple Uint8Arrays into one\n *\n * @internal\n */\nfunction concatUint8Arrays(arrays: Uint8Array[]): Uint8Array {\n  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const arr of arrays) {\n    result.set(arr, offset);\n    offset += arr.length;\n  }\n  return result;\n}\n\n/**\n * Convert Uint8Array to hex string\n *\n * @internal\n */\nfunction uint8ArrayToHex(arr: Uint8Array): string {\n  return Array.from(arr)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n}\n","/**\n * Commitment Hash Utility\n *\n * Functions for computing and verifying hashes of commitment evidence.\n * The hash is stored on-chain as `commitment_hash` in the course state datum,\n * while the full evidence (Tiptap JSON document) is stored in the database.\n *\n * This provides:\n * - Compact on-chain storage (64-char hex hash vs full JSON)\n * - Tamper-evidence (can verify DB content matches on-chain commitment)\n * - Privacy (evidence details not exposed on-chain)\n *\n * @module @andamio/core/hashing\n */\n\nimport blake from \"blakejs\";\n\n/**\n * Tiptap document structure (simplified)\n * The actual structure can be more complex with nested content\n */\nexport type TiptapDoc = {\n  type: \"doc\";\n  content?: TiptapNode[];\n  [key: string]: unknown;\n};\n\nexport type TiptapNode = {\n  type: string;\n  content?: TiptapNode[];\n  text?: string;\n  marks?: TiptapMark[];\n  attrs?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nexport type TiptapMark = {\n  type: string;\n  attrs?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\n/**\n * Normalizes a value for consistent hashing.\n *\n * Normalization rules:\n * - Objects: Sort keys alphabetically, recursively normalize values\n * - Arrays: Preserve order, recursively normalize items\n * - Strings: Trim whitespace\n * - Numbers/Booleans/null: Keep as-is\n * - undefined: Convert to null\n *\n * @param value - Any JSON-serializable value\n * @returns Normalized value\n */\nexport function normalizeForHashing(value: unknown): unknown {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  if (typeof value === \"string\") {\n    return value.trim();\n  }\n\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return value;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(normalizeForHashing);\n  }\n\n  if (typeof value === \"object\") {\n    const sorted: Record<string, unknown> = {};\n    const keys = Object.keys(value as Record<string, unknown>).sort();\n    for (const key of keys) {\n      const val = (value as Record<string, unknown>)[key];\n      if (val !== undefined) {\n        sorted[key] = normalizeForHashing(val);\n      }\n    }\n    return sorted;\n  }\n\n  return value;\n}\n\n/**\n * Computes the commitment hash from evidence content.\n *\n * The hash is computed as:\n * 1. Normalize the evidence (sort keys, trim strings, etc.)\n * 2. Serialize to JSON string (deterministic due to normalization)\n * 3. Apply Blake2b-256 hash\n *\n * @param evidence - The evidence content (Tiptap JSON document or any JSON-serializable data)\n * @returns 64-character lowercase hex string (Blake2b-256 hash)\n *\n * @example\n * ```typescript\n * import { computeCommitmentHash } from \"@andamio/core/hashing\";\n *\n * const evidence = {\n *   type: \"doc\",\n *   content: [\n *     { type: \"paragraph\", content: [{ type: \"text\", text: \"My submission\" }] }\n *   ]\n * };\n *\n * const hash = computeCommitmentHash(evidence);\n * // Use this hash as commitment_hash in the transaction\n * ```\n */\nexport function computeCommitmentHash(evidence: unknown): string {\n  const normalized = normalizeForHashing(evidence);\n  const jsonString = JSON.stringify(normalized);\n  const bytes = new TextEncoder().encode(jsonString);\n  return blake.blake2bHex(bytes, undefined, 32);\n}\n\n/**\n * Verifies that evidence content matches an expected hash.\n *\n * Use this to verify that database evidence matches the on-chain commitment.\n *\n * @param evidence - The evidence content to verify\n * @param expectedHash - The expected hash (from on-chain data)\n * @returns True if the evidence produces the expected hash\n */\nexport function verifyCommitmentHash(\n  evidence: unknown,\n  expectedHash: string\n): boolean {\n  const computedHash = computeCommitmentHash(evidence);\n  return computedHash.toLowerCase() === expectedHash.toLowerCase();\n}\n\n/**\n * Validates that a string is a valid commitment hash format.\n *\n * A valid hash is a 64-character hexadecimal string (Blake2b-256 output).\n *\n * @param hash - The string to validate\n * @returns True if the string is a valid hash format\n */\nexport function isValidCommitmentHash(hash: string): boolean {\n  if (typeof hash !== \"string\") {\n    return false;\n  }\n  if (hash.length !== 64) {\n    return false;\n  }\n  return /^[0-9a-fA-F]{64}$/.test(hash);\n}\n\n/**\n * Result of comparing evidence with an on-chain hash\n */\nexport type EvidenceVerificationResult = {\n  /** Whether the evidence matches the on-chain hash */\n  isValid: boolean;\n  /** The hash computed from the evidence */\n  computedHash: string;\n  /** The expected hash (from on-chain) */\n  expectedHash: string;\n  /** Human-readable status message */\n  message: string;\n};\n\n/**\n * Performs a detailed verification of evidence against an on-chain hash.\n *\n * Returns a detailed result object with both hashes and a status message,\n * useful for debugging and user feedback.\n *\n * @param evidence - The evidence content to verify\n * @param onChainHash - The hash from on-chain data\n * @returns Detailed verification result\n */\nexport function verifyEvidenceDetailed(\n  evidence: unknown,\n  onChainHash: string\n): EvidenceVerificationResult {\n  if (!isValidCommitmentHash(onChainHash)) {\n    return {\n      isValid: false,\n      computedHash: \"\",\n      expectedHash: onChainHash,\n      message: `Invalid on-chain hash format: expected 64 hex characters, got \"${onChainHash}\"`,\n    };\n  }\n\n  const computedHash = computeCommitmentHash(evidence);\n  const isValid = computedHash.toLowerCase() === onChainHash.toLowerCase();\n\n  return {\n    isValid,\n    computedHash,\n    expectedHash: onChainHash.toLowerCase(),\n    message: isValid\n      ? \"Evidence matches on-chain commitment\"\n      : \"Evidence does not match on-chain commitment - content may have been modified\",\n  };\n}\n\n// =============================================================================\n// Backwards Compatibility Aliases (deprecated)\n// =============================================================================\n\n/**\n * @deprecated Use `computeCommitmentHash` instead.\n */\nexport const computeAssignmentInfoHash = computeCommitmentHash;\n\n/**\n * @deprecated Use `verifyCommitmentHash` instead.\n */\nexport const verifyAssignmentInfoHash = verifyCommitmentHash;\n\n/**\n * @deprecated Use `isValidCommitmentHash` instead.\n */\nexport const isValidAssignmentInfoHash = isValidCommitmentHash;\n"]}
+{"version":3,"sources":["../../../src/utils/hashing/slt-hash.ts","../../../src/utils/hashing/task-hash.ts","../../../src/utils/hashing/commitment-hash.ts"],"names":["blake","concatUint8Arrays"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * SLT Hash Utility\n *\n * Computes the module token name (hash) from a list of Student Learning Targets (SLTs).\n * This hash is used as the token name when minting module tokens on-chain.\n *\n * The algorithm matches the on-chain Plutus validator:\n * ```haskell\n * sltsToBbs MintModuleV2{slts} = blake2b_256 $ serialiseData $ toBuiltinData $ map stringToBuiltinByteString slts\n * ```\n *\n * Serialization format:\n * 1. Convert each SLT string to UTF-8 bytes\n * 2. Encode as CBOR indefinite-length array of byte strings\n * 3. Hash with Blake2b-256 (32 bytes / 256 bits)\n *\n * @module @andamio/core/hashing\n */\n\nimport blake from \"blakejs\";\n\n/**\n * Plutus chunk size for byte strings.\n * Strings longer than this are encoded as indefinite-length chunked byte strings.\n */\nconst PLUTUS_CHUNK_SIZE = 64;\n\n/**\n * Compute the module hash matching Plutus on-chain encoding.\n *\n * Plutus's `stringToBuiltinByteString` chunks byte strings at 64 bytes.\n * This function replicates that behavior:\n * - Strings <= 64 bytes: encoded as regular CBOR byte strings\n * - Strings > 64 bytes: encoded as indefinite-length chunked byte strings\n *\n * @param slts - Array of Student Learning Target strings\n * @returns 64-character hex string (256-bit Blake2b hash)\n *\n * @example\n * ```typescript\n * import { computeSltHash } from \"@andamio/core/hashing\";\n *\n * const slts = [\n *   \"I can mint an access token.\",\n *   \"I can complete an assignment to earn a credential.\"\n * ];\n *\n * const moduleHash = computeSltHash(slts);\n * // Returns: \"8dcbe1b925d87e6c547bbd8071c23a712db4c32751454b0948f8c846e9246b5c\"\n * ```\n */\nexport function computeSltHash(slts: string[]): string {\n  const sltBytes = slts.map((slt) => new TextEncoder().encode(slt));\n  const cborData = encodeAsPlutusArray(sltBytes);\n  return blake.blake2bHex(cborData, undefined, 32);\n}\n\n/**\n * @deprecated Use `computeSltHash` instead. This alias is kept for backwards compatibility.\n */\nexport const computeSltHashDefinite = computeSltHash;\n\n/**\n * Verify that a given hash matches the computed hash for SLTs.\n *\n * @param slts - Array of Student Learning Target strings\n * @param expectedHash - The hash to verify (64-character hex string)\n * @returns true if the computed hash matches the expected hash\n */\nexport function verifySltHash(slts: string[], expectedHash: string): boolean {\n  const computedHash = computeSltHash(slts);\n  return computedHash.toLowerCase() === expectedHash.toLowerCase();\n}\n\n/**\n * Validate that a string is a valid SLT hash format.\n *\n * SLT hashes are 64-character hexadecimal strings (256-bit Blake2b hash).\n *\n * @param hash - String to validate\n * @returns true if the string is a valid SLT hash format\n */\nexport function isValidSltHash(hash: string): boolean {\n  if (hash.length !== 64) {\n    return false;\n  }\n  return /^[0-9a-fA-F]{64}$/.test(hash);\n}\n\n// =============================================================================\n// Plutus-Compatible Encoding (Internal)\n// =============================================================================\n\n/**\n * Encode an array of byte buffers matching Plutus serialization.\n *\n * Uses indefinite-length array with chunked byte strings for long values.\n *\n * @internal\n */\nfunction encodeAsPlutusArray(items: Uint8Array[]): Uint8Array {\n  const chunks: Uint8Array[] = [];\n\n  // Start indefinite array\n  chunks.push(new Uint8Array([0x9f]));\n\n  // Encode each item (with chunking for long strings)\n  for (const item of items) {\n    chunks.push(encodePlutusBuiltinByteString(item));\n  }\n\n  // End indefinite array\n  chunks.push(new Uint8Array([0xff]));\n\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode a byte buffer matching Plutus's stringToBuiltinByteString.\n *\n * - Strings <= 64 bytes: regular CBOR byte string\n * - Strings > 64 bytes: indefinite-length chunked byte string (64-byte chunks)\n *\n * @internal\n */\nfunction encodePlutusBuiltinByteString(buffer: Uint8Array): Uint8Array {\n  if (buffer.length <= PLUTUS_CHUNK_SIZE) {\n    // Short string: encode normally\n    return encodeCBORByteString(buffer);\n  }\n\n  // Long string: use indefinite-length chunked encoding\n  const chunks: Uint8Array[] = [];\n  chunks.push(new Uint8Array([0x5f])); // Start indefinite byte string\n\n  for (let i = 0; i < buffer.length; i += PLUTUS_CHUNK_SIZE) {\n    const chunk = buffer.subarray(i, Math.min(i + PLUTUS_CHUNK_SIZE, buffer.length));\n    chunks.push(encodeCBORByteString(chunk));\n  }\n\n  chunks.push(new Uint8Array([0xff])); // Break\n  return concatUint8Arrays(chunks);\n}\n\n/**\n * Encode a byte buffer as a CBOR byte string (definite length).\n *\n * @internal\n */\nfunction encodeCBORByteString(buffer: Uint8Array): Uint8Array {\n  const len = buffer.length;\n\n  // CBOR byte string encoding (major type 2 = 0x40):\n  // - 0-23 bytes: length inline (0x40 + len)\n  // - 24-255 bytes: 0x58 + 1-byte length\n  // - 256-65535 bytes: 0x59 + 2-byte length (big-endian)\n  if (len <= 23) {\n    const result = new Uint8Array(1 + len);\n    result[0] = 0x40 + len;\n    result.set(buffer, 1);\n    return result;\n  } else if (len <= 255) {\n    const result = new Uint8Array(2 + len);\n    result[0] = 0x58;\n    result[1] = len;\n    result.set(buffer, 2);\n    return result;\n  } else if (len <= 65535) {\n    const result = new Uint8Array(3 + len);\n    result[0] = 0x59;\n    result[1] = len >> 8;\n    result[2] = len & 0xff;\n    result.set(buffer, 3);\n    return result;\n  }\n  throw new Error(\"Byte string too long for CBOR encoding\");\n}\n\n/**\n * Concatenate multiple Uint8Arrays into one\n *\n * @internal\n */\nfunction concatUint8Arrays(arrays: Uint8Array[]): Uint8Array {\n  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const arr of arrays) {\n    result.set(arr, offset);\n    offset += arr.length;\n  }\n  return result;\n}\n","/**\n * Task Hash Utility\n *\n * Computes the task token name (hash) from task data.\n * This hash is used as the task_hash on-chain (content-addressed identifier).\n *\n * The algorithm matches the on-chain Aiken/Haskell hash_project_data function:\n * - Serialize task data as Plutus Data (CBOR with tag 121 for Constructor 0)\n * - Use indefinite-length arrays for constructor fields\n * - Hash with Blake2b-256\n *\n * @module @andamio/core/hashing\n */\n\nimport blake from \"blakejs\";\n\n/**\n * Native asset in Cardano format: [policyId, tokenName, quantity]\n *\n * @example\n * ```typescript\n * const asset: NativeAsset = [\n *   \"abc123def456...\".repeat(4), // 56 hex chars (28 bytes) - policy ID\n *   \"746f6b656e\",                // hex-encoded token name\n *   1000n                        // quantity as bigint\n * ];\n * ```\n */\nexport type NativeAsset = [\n  policyId: string, // 56 hex chars (28 bytes)\n  tokenName: string, // hex encoded (0-64 chars / 0-32 bytes)\n  quantity: bigint, // arbitrary precision integer\n];\n\n/**\n * Task data structure matching the Aiken ProjectData type.\n *\n * Serialized as Plutus Data Constructor 0 (CBOR tag 121) with fields:\n * 1. project_content (ByteArray - UTF-8 encoded, NFC normalized)\n * 2. deadline (Int - milliseconds)\n * 3. lovelace_am (Int - micro-ADA)\n * 4. tokens (List<FlatValue> - native assets)\n */\nexport interface TaskData {\n  /** Task description (max 140 characters) */\n  project_content: string;\n  /** Unix timestamp in milliseconds */\n  expiration_time: bigint;\n  /** Lovelace amount (micro-ADA) */\n  lovelace_amount: bigint;\n  /** Native assets attached to task */\n  native_assets: readonly NativeAsset[];\n}\n\n/**\n * Compute the task hash (token name / task_hash) from task data.\n *\n * This produces the same hash as the on-chain Aiken hash_project_data function,\n * allowing clients to pre-compute or verify task hashes.\n *\n * @param task - Task data object\n * @returns 64-character hex string (256-bit Blake2b hash)\n * @throws Error if task data validation fails\n *\n * @example\n * ```typescript\n * import { computeTaskHash } from \"@andamio/core/hashing\";\n *\n * const task = {\n *   project_content: \"Open Task #1\",\n *   expiration_time: 1769027280000n,\n *   lovelace_amount: 15000000n,\n *   native_assets: []\n * };\n *\n * const taskHash = computeTaskHash(task);\n * // Returns the on-chain task_hash\n * ```\n */\nexport function computeTaskHash(task: TaskData): string {\n  validateTaskData(task);\n  const bytes = encodeTaskAsPlutusData(task);\n  return blake.blake2bHex(bytes, undefined, 32);\n}\n\n/**\n * Verify that a given hash matches the computed hash for a task.\n *\n * @param task - Task data object\n * @param expectedHash - The hash to verify (64-character hex string)\n * @returns true if the computed hash matches the expected hash\n */\nexport function verifyTaskHash(task: TaskData, expectedHash: string): boolean {\n  const computedHash = computeTaskHash(task);\n  return computedHash.toLowerCase() === expectedHash.toLowerCase();\n}\n\n/**\n * Validate that a string is a valid task hash format.\n *\n * Task hashes are 64-character hexadecimal strings (256-bit Blake2b hash).\n */\nexport function isValidTaskHash(hash: string): boolean {\n  if (hash.length !== 64) {\n    return false;\n  }\n  return /^[0-9a-fA-F]{64}$/.test(hash);\n}\n\n/**\n * Debug function to show the CBOR encoding of a task.\n * Useful for comparing against on-chain data.\n *\n * @param task - Task data object\n * @returns Hex string of the CBOR-encoded Plutus Data (before hashing)\n */\nexport function debugTaskBytes(task: TaskData): string {\n  validateTaskData(task);\n  const bytes = encodeTaskAsPlutusData(task);\n  return uint8ArrayToHex(bytes);\n}\n\n// =============================================================================\n// Plutus Data CBOR Encoding (Internal)\n// =============================================================================\n\n/**\n * Encode task data as Plutus Data matching Aiken/Haskell serialization.\n *\n * Format: tag(121) + indefinite-array + [content, deadline, lovelace, tokens] + break\n *\n * The key insight is that Haskell's `serialiseData . toBuiltinData` uses\n * indefinite-length CBOR arrays (0x9f ... 0xff) for Plutus Data constructors.\n *\n * @internal\n */\nfunction encodeTaskAsPlutusData(task: TaskData): Uint8Array {\n  const normalizedContent = task.project_content.normalize(\"NFC\");\n  const contentBytes = new TextEncoder().encode(normalizedContent);\n\n  return concatUint8Arrays([\n    // Tag 121 (Plutus Data Constructor 0) + indefinite array start\n    new Uint8Array([0xd8, 121, 0x9f]),\n    // Field 1: project_content (ByteArray)\n    encodeCborBytes(contentBytes),\n    // Field 2: deadline (Int)\n    encodeCborUint(task.expiration_time),\n    // Field 3: lovelace_am (Int)\n    encodeCborUint(task.lovelace_amount),\n    // Field 4: tokens (List<FlatValue>)\n    encodeTokensList(task.native_assets),\n    // Break (end of indefinite array)\n    new Uint8Array([0xff]),\n  ]);\n}\n\n/**\n * Encode a list of native assets as Plutus Data.\n *\n * Each FlatValue is encoded as a Plutus Data constructor with:\n * - PolicyId (ByteArray)\n * - AssetName (ByteArray)\n * - Quantity (Int)\n *\n * @internal\n */\nfunction encodeTokensList(assets: readonly NativeAsset[]): Uint8Array {\n  if (assets.length === 0) {\n    // Empty definite-length array\n    return new Uint8Array([0x80]);\n  }\n\n  // Encode as indefinite-length array of FlatValue constructors\n  const parts: Uint8Array[] = [new Uint8Array([0x9f])]; // indefinite array start\n\n  for (const [policyId, tokenName, quantity] of assets) {\n    // Each FlatValue is Constructor 0 with 3 fields\n    parts.push(new Uint8Array([0xd8, 121, 0x9f])); // tag 121, indefinite array\n    parts.push(encodeCborBytes(hexToBytes(policyId)));\n    parts.push(encodeCborBytes(hexToBytes(tokenName)));\n    parts.push(encodeCborUint(quantity));\n    parts.push(new Uint8Array([0xff])); // break\n  }\n\n  parts.push(new Uint8Array([0xff])); // break (end of list)\n  return concatUint8Arrays(parts);\n}\n\n/**\n * Maximum value for CBOR uint64 encoding.\n * @internal\n */\nconst MAX_UINT64 = 18446744073709551615n; // 2^64 - 1\n\n/**\n * Encode CBOR unsigned integer (major type 0).\n *\n * @internal\n */\nfunction encodeCborUint(n: bigint): Uint8Array {\n  if (n < 0n) {\n    throw new Error(\"Negative integers not supported\");\n  }\n  if (n > MAX_UINT64) {\n    throw new Error(\n      `Integer exceeds maximum CBOR uint64 value (got ${n}, max ${MAX_UINT64})`,\n    );\n  }\n\n  if (n < 24n) {\n    return new Uint8Array([Number(n)]);\n  } else if (n < 256n) {\n    return new Uint8Array([0x18, Number(n)]);\n  } else if (n < 65536n) {\n    return new Uint8Array([0x19, Number(n >> 8n) & 0xff, Number(n) & 0xff]);\n  } else if (n < 4294967296n) {\n    return new Uint8Array([\n      0x1a,\n      Number((n >> 24n) & 0xffn),\n      Number((n >> 16n) & 0xffn),\n      Number((n >> 8n) & 0xffn),\n      Number(n & 0xffn),\n    ]);\n  } else {\n    // 8-byte unsigned integer\n    return new Uint8Array([\n      0x1b,\n      Number((n >> 56n) & 0xffn),\n      Number((n >> 48n) & 0xffn),\n      Number((n >> 40n) & 0xffn),\n      Number((n >> 32n) & 0xffn),\n      Number((n >> 24n) & 0xffn),\n      Number((n >> 16n) & 0xffn),\n      Number((n >> 8n) & 0xffn),\n      Number(n & 0xffn),\n    ]);\n  }\n}\n\n/**\n * Encode CBOR byte string (major type 2).\n *\n * @internal\n */\nfunction encodeCborBytes(bytes: Uint8Array): Uint8Array {\n  const len = bytes.length;\n  let header: Uint8Array;\n\n  if (len < 24) {\n    header = new Uint8Array([0x40 + len]);\n  } else if (len < 256) {\n    header = new Uint8Array([0x58, len]);\n  } else if (len < 65536) {\n    header = new Uint8Array([0x59, (len >> 8) & 0xff, len & 0xff]);\n  } else {\n    throw new Error(\"Byte string too long for CBOR encoding\");\n  }\n\n  return concatUint8Arrays([header, bytes]);\n}\n\n/**\n * Validate TaskData before hashing.\n *\n * @throws Error if validation fails\n * @internal\n */\nfunction validateTaskData(task: TaskData): void {\n  if (task.project_content.length > 140) {\n    throw new Error(\n      `project_content exceeds 140 characters (got ${task.project_content.length})`,\n    );\n  }\n\n  if (task.expiration_time < 0n) {\n    throw new Error(\"expiration_time must be non-negative\");\n  }\n  if (task.lovelace_amount < 0n) {\n    throw new Error(\"lovelace_amount must be non-negative\");\n  }\n\n  for (const [policyId, tokenName, quantity] of task.native_assets) {\n    if (policyId.length !== 56) {\n      throw new Error(\n        `policyId must be 56 hex chars (got ${policyId.length})`,\n      );\n    }\n    if (!/^[0-9a-fA-F]*$/.test(policyId)) {\n      throw new Error(\"policyId contains invalid hex characters\");\n    }\n    if (tokenName.length > 64 || tokenName.length % 2 !== 0) {\n      throw new Error(\n        `tokenName must be 0-64 hex chars with even length (got ${tokenName.length})`,\n      );\n    }\n    if (tokenName.length > 0 && !/^[0-9a-fA-F]*$/.test(tokenName)) {\n      throw new Error(\"tokenName contains invalid hex characters\");\n    }\n    if (quantity < 0n) {\n      throw new Error(\"asset quantity must be non-negative\");\n    }\n  }\n}\n\n/**\n * Convert hex string to Uint8Array.\n *\n * @internal\n */\nfunction hexToBytes(hex: string): Uint8Array {\n  if (hex.length === 0) {\n    return new Uint8Array([]);\n  }\n\n  if (hex.length % 2 !== 0) {\n    throw new Error(`Invalid hex string: odd length (${hex.length})`);\n  }\n\n  const bytes = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < bytes.length; i++) {\n    const byte = parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n    if (Number.isNaN(byte)) {\n      throw new Error(\n        `Invalid hex character at position ${i * 2}: \"${hex.slice(i * 2, i * 2 + 2)}\"`,\n      );\n    }\n    bytes[i] = byte;\n  }\n  return bytes;\n}\n\n/**\n * Concatenate multiple Uint8Arrays into one.\n *\n * @internal\n */\nfunction concatUint8Arrays(arrays: Uint8Array[]): Uint8Array {\n  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const arr of arrays) {\n    result.set(arr, offset);\n    offset += arr.length;\n  }\n  return result;\n}\n\n/**\n * Convert Uint8Array to hex string.\n *\n * @internal\n */\nfunction uint8ArrayToHex(arr: Uint8Array): string {\n  return Array.from(arr)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n}\n","/**\n * Commitment Hash Utility\n *\n * Functions for computing and verifying hashes of commitment evidence.\n * The hash is stored on-chain as `commitment_hash` in the course state datum,\n * while the full evidence (Tiptap JSON document) is stored in the database.\n *\n * This provides:\n * - Compact on-chain storage (64-char hex hash vs full JSON)\n * - Tamper-evidence (can verify DB content matches on-chain commitment)\n * - Privacy (evidence details not exposed on-chain)\n *\n * @module @andamio/core/hashing\n */\n\nimport blake from \"blakejs\";\n\n/**\n * Tiptap document structure (simplified)\n * The actual structure can be more complex with nested content\n */\nexport type TiptapDoc = {\n  type: \"doc\";\n  content?: TiptapNode[];\n  [key: string]: unknown;\n};\n\nexport type TiptapNode = {\n  type: string;\n  content?: TiptapNode[];\n  text?: string;\n  marks?: TiptapMark[];\n  attrs?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nexport type TiptapMark = {\n  type: string;\n  attrs?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\n/**\n * Normalizes a value for consistent hashing.\n *\n * Normalization rules:\n * - Objects: Sort keys alphabetically, recursively normalize values\n * - Arrays: Preserve order, recursively normalize items\n * - Strings: Trim whitespace\n * - Numbers/Booleans/null: Keep as-is\n * - undefined: Convert to null\n *\n * @param value - Any JSON-serializable value\n * @returns Normalized value\n */\nexport function normalizeForHashing(value: unknown): unknown {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  if (typeof value === \"string\") {\n    return value.trim();\n  }\n\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return value;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map(normalizeForHashing);\n  }\n\n  if (typeof value === \"object\") {\n    const sorted: Record<string, unknown> = {};\n    const keys = Object.keys(value as Record<string, unknown>).sort();\n    for (const key of keys) {\n      const val = (value as Record<string, unknown>)[key];\n      if (val !== undefined) {\n        sorted[key] = normalizeForHashing(val);\n      }\n    }\n    return sorted;\n  }\n\n  return value;\n}\n\n/**\n * Computes the commitment hash from evidence content.\n *\n * The hash is computed as:\n * 1. Normalize the evidence (sort keys, trim strings, etc.)\n * 2. Serialize to JSON string (deterministic due to normalization)\n * 3. Apply Blake2b-256 hash\n *\n * @param evidence - The evidence content (Tiptap JSON document or any JSON-serializable data)\n * @returns 64-character lowercase hex string (Blake2b-256 hash)\n *\n * @example\n * ```typescript\n * import { computeCommitmentHash } from \"@andamio/core/hashing\";\n *\n * const evidence = {\n *   type: \"doc\",\n *   content: [\n *     { type: \"paragraph\", content: [{ type: \"text\", text: \"My submission\" }] }\n *   ]\n * };\n *\n * const hash = computeCommitmentHash(evidence);\n * // Use this hash as commitment_hash in the transaction\n * ```\n */\nexport function computeCommitmentHash(evidence: unknown): string {\n  const normalized = normalizeForHashing(evidence);\n  const jsonString = JSON.stringify(normalized);\n  const bytes = new TextEncoder().encode(jsonString);\n  return blake.blake2bHex(bytes, undefined, 32);\n}\n\n/**\n * Verifies that evidence content matches an expected hash.\n *\n * Use this to verify that database evidence matches the on-chain commitment.\n *\n * @param evidence - The evidence content to verify\n * @param expectedHash - The expected hash (from on-chain data)\n * @returns True if the evidence produces the expected hash\n */\nexport function verifyCommitmentHash(\n  evidence: unknown,\n  expectedHash: string\n): boolean {\n  const computedHash = computeCommitmentHash(evidence);\n  return computedHash.toLowerCase() === expectedHash.toLowerCase();\n}\n\n/**\n * Validates that a string is a valid commitment hash format.\n *\n * A valid hash is a 64-character hexadecimal string (Blake2b-256 output).\n *\n * @param hash - The string to validate\n * @returns True if the string is a valid hash format\n */\nexport function isValidCommitmentHash(hash: string): boolean {\n  if (typeof hash !== \"string\") {\n    return false;\n  }\n  if (hash.length !== 64) {\n    return false;\n  }\n  return /^[0-9a-fA-F]{64}$/.test(hash);\n}\n\n/**\n * Result of comparing evidence with an on-chain hash\n */\nexport type EvidenceVerificationResult = {\n  /** Whether the evidence matches the on-chain hash */\n  isValid: boolean;\n  /** The hash computed from the evidence */\n  computedHash: string;\n  /** The expected hash (from on-chain) */\n  expectedHash: string;\n  /** Human-readable status message */\n  message: string;\n};\n\n/**\n * Performs a detailed verification of evidence against an on-chain hash.\n *\n * Returns a detailed result object with both hashes and a status message,\n * useful for debugging and user feedback.\n *\n * @param evidence - The evidence content to verify\n * @param onChainHash - The hash from on-chain data\n * @returns Detailed verification result\n */\nexport function verifyEvidenceDetailed(\n  evidence: unknown,\n  onChainHash: string\n): EvidenceVerificationResult {\n  if (!isValidCommitmentHash(onChainHash)) {\n    return {\n      isValid: false,\n      computedHash: \"\",\n      expectedHash: onChainHash,\n      message: `Invalid on-chain hash format: expected 64 hex characters, got \"${onChainHash}\"`,\n    };\n  }\n\n  const computedHash = computeCommitmentHash(evidence);\n  const isValid = computedHash.toLowerCase() === onChainHash.toLowerCase();\n\n  return {\n    isValid,\n    computedHash,\n    expectedHash: onChainHash.toLowerCase(),\n    message: isValid\n      ? \"Evidence matches on-chain commitment\"\n      : \"Evidence does not match on-chain commitment - content may have been modified\",\n  };\n}\n\n// =============================================================================\n// Backwards Compatibility Aliases (deprecated)\n// =============================================================================\n\n/**\n * @deprecated Use `computeCommitmentHash` instead.\n */\nexport const computeAssignmentInfoHash = computeCommitmentHash;\n\n/**\n * @deprecated Use `verifyCommitmentHash` instead.\n */\nexport const verifyAssignmentInfoHash = verifyCommitmentHash;\n\n/**\n * @deprecated Use `isValidCommitmentHash` instead.\n */\nexport const isValidAssignmentInfoHash = isValidCommitmentHash;\n"]}