@bcts/provenance-mark 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _bcts_dcbor = require("@bcts/dcbor");
 let _noble_hashes_sha2_js = require("@noble/hashes/sha2.js");
 let _noble_hashes_hkdf_js = require("@noble/hashes/hkdf.js");
@@ -7,7 +7,6 @@ let _bcts_rand = require("@bcts/rand");
 let _bcts_tags = require("@bcts/tags");
 let _bcts_uniform_resources = require("@bcts/uniform-resources");
 let _bcts_envelope = require("@bcts/envelope");
-
 //#region src/error.ts
 /**
 * Copyright © 2023-2026 Blockchain Commons, LLC
@@ -87,34 +86,33 @@ var ProvenanceMarkError = class ProvenanceMarkError extends Error {
 			return JSON.stringify(value);
 		};
 		switch (type) {
-			case ProvenanceMarkErrorType.InvalidSeedLength: return `invalid seed length: expected 32 bytes, got ${d("actual")} bytes`;
-			case ProvenanceMarkErrorType.DuplicateKey: return `duplicate key: ${d("key")}`;
-			case ProvenanceMarkErrorType.MissingKey: return `missing key: ${d("key")}`;
-			case ProvenanceMarkErrorType.InvalidKey: return `invalid key: ${d("key")}`;
-			case ProvenanceMarkErrorType.ExtraKeys: return `wrong number of keys: expected ${d("expected")}, got ${d("actual")}`;
-			case ProvenanceMarkErrorType.InvalidKeyLength: return `invalid key length: expected ${d("expected")}, got ${d("actual")}`;
-			case ProvenanceMarkErrorType.InvalidNextKeyLength: return `invalid next key length: expected ${d("expected")}, got ${d("actual")}`;
-			case ProvenanceMarkErrorType.InvalidChainIdLength: return `invalid chain ID length: expected ${d("expected")}, got ${d("actual")}`;
-			case ProvenanceMarkErrorType.InvalidMessageLength: return `invalid message length: expected at least ${d("expected")}, got ${d("actual")}`;
-			case ProvenanceMarkErrorType.InvalidInfoCbor: return "invalid CBOR data in info field";
-			case ProvenanceMarkErrorType.DateOutOfRange: return `date out of range: ${d("details")}`;
-			case ProvenanceMarkErrorType.InvalidDate: return `invalid date: ${d("details")}`;
-			case ProvenanceMarkErrorType.MissingUrlParameter: return `missing required URL parameter: ${d("parameter")}`;
-			case ProvenanceMarkErrorType.YearOutOfRange: return `year out of range for 2-byte serialization: must be between 2023-2150, got ${d("year")}`;
-			case ProvenanceMarkErrorType.InvalidMonthOrDay: return `invalid month (${d("month")}) or day (${d("day")}) for year ${d("year")}`;
-			case ProvenanceMarkErrorType.ResolutionError: return `resolution serialization error: ${d("details")}`;
-			case ProvenanceMarkErrorType.BytewordsError: return `bytewords error: ${d("message")}`;
-			case ProvenanceMarkErrorType.CborError: return `CBOR error: ${d("message")}`;
-			case ProvenanceMarkErrorType.UrlError: return `URL parsing error: ${d("message")}`;
-			case ProvenanceMarkErrorType.Base64Error: return `base64 decoding error: ${d("message")}`;
-			case ProvenanceMarkErrorType.JsonError: return `JSON error: ${d("message")}`;
-			case ProvenanceMarkErrorType.IntegerConversionError: return `integer conversion error: ${d("message")}`;
-			case ProvenanceMarkErrorType.ValidationError: return `validation error: ${d("message")}`;
+			case "InvalidSeedLength": return `invalid seed length: expected 32 bytes, got ${d("actual")} bytes`;
+			case "DuplicateKey": return `duplicate key: ${d("key")}`;
+			case "MissingKey": return `missing key: ${d("key")}`;
+			case "InvalidKey": return `invalid key: ${d("key")}`;
+			case "ExtraKeys": return `wrong number of keys: expected ${d("expected")}, got ${d("actual")}`;
+			case "InvalidKeyLength": return `invalid key length: expected ${d("expected")}, got ${d("actual")}`;
+			case "InvalidNextKeyLength": return `invalid next key length: expected ${d("expected")}, got ${d("actual")}`;
+			case "InvalidChainIdLength": return `invalid chain ID length: expected ${d("expected")}, got ${d("actual")}`;
+			case "InvalidMessageLength": return `invalid message length: expected at least ${d("expected")}, got ${d("actual")}`;
+			case "InvalidInfoCbor": return "invalid CBOR data in info field";
+			case "DateOutOfRange": return `date out of range: ${d("details")}`;
+			case "InvalidDate": return `invalid date: ${d("details")}`;
+			case "MissingUrlParameter": return `missing required URL parameter: ${d("parameter")}`;
+			case "YearOutOfRange": return `year out of range for 2-byte serialization: must be between 2023-2150, got ${d("year")}`;
+			case "InvalidMonthOrDay": return `invalid month (${d("month")}) or day (${d("day")}) for year ${d("year")}`;
+			case "ResolutionError": return `resolution serialization error: ${d("details")}`;
+			case "BytewordsError": return `bytewords error: ${d("message")}`;
+			case "CborError": return `CBOR error: ${d("message")}`;
+			case "UrlError": return `URL parsing error: ${d("message")}`;
+			case "Base64Error": return `base64 decoding error: ${d("message")}`;
+			case "JsonError": return `JSON error: ${d("message")}`;
+			case "IntegerConversionError": return `integer conversion error: ${d("message")}`;
+			case "ValidationError": return `validation error: ${d("message")}`;
 			default: return type;
 		}
 	}
 };
-
 //#endregion
 //#region src/date.ts
 /**
@@ -153,8 +151,8 @@ function serialize2Bytes(date) {
 	const month = date.getUTCMonth() + 1;
 	const day = date.getUTCDate();
 	const yy = year - 2023;
-	if (yy < 0 || yy >= 128) throw new ProvenanceMarkError(ProvenanceMarkErrorType.YearOutOfRange, void 0, { year });
-	if (month < 1 || month > 12 || day < 1 || day > 31) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidMonthOrDay, void 0, {
+	if (yy < 0 || yy >= 128) throw new ProvenanceMarkError("YearOutOfRange", void 0, { year });
+	if (month < 1 || month > 12 || day < 1 || day > 31) throw new ProvenanceMarkError("InvalidMonthOrDay", void 0, {
 		year,
 		month,
 		day
@@ -169,12 +167,12 @@ function serialize2Bytes(date) {
 * Deserialize 2 bytes to a date.
 */
 function deserialize2Bytes(bytes) {
-	if (bytes.length !== 2) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidDate, void 0, { details: `expected 2 bytes, got ${bytes.length}` });
+	if (bytes.length !== 2) throw new ProvenanceMarkError("InvalidDate", void 0, { details: `expected 2 bytes, got ${bytes.length}` });
 	const value = bytes[0] << 8 | bytes[1];
 	const day = value & 31;
 	const month = value >> 5 & 15;
 	const year = (value >> 9 & 127) + 2023;
-	if (month < 1 || month > 12 || !isValidDay(year, month, day)) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidMonthOrDay, void 0, {
+	if (month < 1 || month > 12 || !isValidDay(year, month, day)) throw new ProvenanceMarkError("InvalidMonthOrDay", void 0, {
 		year,
 		month,
 		day
@@ -187,7 +185,7 @@ function deserialize2Bytes(bytes) {
 function serialize4Bytes(date) {
 	const duration = date.getTime() - REFERENCE_DATE;
 	const seconds = Math.floor(duration / 1e3);
-	if (seconds < 0 || seconds > 4294967295) throw new ProvenanceMarkError(ProvenanceMarkErrorType.DateOutOfRange, void 0, { details: "seconds value out of range for u32" });
+	if (seconds < 0 || seconds > 4294967295) throw new ProvenanceMarkError("DateOutOfRange", void 0, { details: "seconds value out of range for u32" });
 	const buf = new Uint8Array(4);
 	buf[0] = seconds >> 24 & 255;
 	buf[1] = seconds >> 16 & 255;
@@ -199,7 +197,7 @@ function serialize4Bytes(date) {
 * Deserialize 4 bytes to a date.
 */
 function deserialize4Bytes(bytes) {
-	if (bytes.length !== 4) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidDate, void 0, { details: `expected 4 bytes, got ${bytes.length}` });
+	if (bytes.length !== 4) throw new ProvenanceMarkError("InvalidDate", void 0, { details: `expected 4 bytes, got ${bytes.length}` });
 	const seconds = (bytes[0] << 24 | bytes[1] << 16 | bytes[2] << 8 | bytes[3]) >>> 0;
 	return new Date(REFERENCE_DATE + seconds * 1e3);
 }
@@ -209,7 +207,7 @@ function deserialize4Bytes(bytes) {
 function serialize6Bytes(date) {
 	const duration = date.getTime() - REFERENCE_DATE;
 	const milliseconds = BigInt(duration);
-	if (milliseconds < 0n || milliseconds > BigInt(MAX_6_BYTE_VALUE)) throw new ProvenanceMarkError(ProvenanceMarkErrorType.DateOutOfRange, void 0, { details: "date exceeds maximum representable value" });
+	if (milliseconds < 0n || milliseconds > BigInt(MAX_6_BYTE_VALUE)) throw new ProvenanceMarkError("DateOutOfRange", void 0, { details: "date exceeds maximum representable value" });
 	const buf = new Uint8Array(6);
 	buf[0] = Number(milliseconds >> 40n & 255n);
 	buf[1] = Number(milliseconds >> 32n & 255n);
@@ -223,9 +221,9 @@ function serialize6Bytes(date) {
 * Deserialize 6 bytes to a date.
 */
 function deserialize6Bytes(bytes) {
-	if (bytes.length !== 6) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidDate, void 0, { details: `expected 6 bytes, got ${bytes.length}` });
+	if (bytes.length !== 6) throw new ProvenanceMarkError("InvalidDate", void 0, { details: `expected 6 bytes, got ${bytes.length}` });
 	const milliseconds = BigInt(bytes[0]) << 40n | BigInt(bytes[1]) << 32n | BigInt(bytes[2]) << 24n | BigInt(bytes[3]) << 16n | BigInt(bytes[4]) << 8n | BigInt(bytes[5]);
-	if (milliseconds > BigInt(MAX_6_BYTE_VALUE)) throw new ProvenanceMarkError(ProvenanceMarkErrorType.DateOutOfRange, void 0, { details: "date exceeds maximum representable value" });
+	if (milliseconds > BigInt(MAX_6_BYTE_VALUE)) throw new ProvenanceMarkError("DateOutOfRange", void 0, { details: "date exceeds maximum representable value" });
 	return new Date(REFERENCE_DATE + Number(milliseconds));
 }
 /**
@@ -248,7 +246,7 @@ function dateToIso8601(date) {
 */
 function dateFromIso8601(str) {
 	const date = new Date(str);
-	if (isNaN(date.getTime())) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidDate, void 0, { details: `cannot parse date: ${str}` });
+	if (isNaN(date.getTime())) throw new ProvenanceMarkError("InvalidDate", void 0, { details: `cannot parse date: ${str}` });
 	return date;
 }
 /**
@@ -257,7 +255,6 @@ function dateFromIso8601(str) {
 function dateToDateString(date) {
 	return `${date.getUTCFullYear()}-${(date.getUTCMonth() + 1).toString().padStart(2, "0")}-${date.getUTCDate().toString().padStart(2, "0")}`;
 }
-
 //#endregion
 //#region src/resolution.ts
 /**
@@ -287,11 +284,11 @@ function resolutionToNumber(res) {
 */
 function resolutionFromNumber(value) {
 	switch (value) {
-		case 0: return ProvenanceMarkResolution.Low;
-		case 1: return ProvenanceMarkResolution.Medium;
-		case 2: return ProvenanceMarkResolution.Quartile;
-		case 3: return ProvenanceMarkResolution.High;
-		default: throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `invalid provenance mark resolution value: ${value}` });
+		case 0: return 0;
+		case 1: return 1;
+		case 2: return 2;
+		case 3: return 3;
+		default: throw new ProvenanceMarkError("ResolutionError", void 0, { details: `invalid provenance mark resolution value: ${value}` });
 	}
 }
 /**
@@ -299,10 +296,10 @@ function resolutionFromNumber(value) {
 */
 function linkLength(res) {
 	switch (res) {
-		case ProvenanceMarkResolution.Low: return 4;
-		case ProvenanceMarkResolution.Medium: return 8;
-		case ProvenanceMarkResolution.Quartile: return 16;
-		case ProvenanceMarkResolution.High: return 32;
+		case 0: return 4;
+		case 1: return 8;
+		case 2: return 16;
+		case 3: return 32;
 	}
 }
 /**
@@ -310,10 +307,10 @@ function linkLength(res) {
 */
 function seqBytesLength(res) {
 	switch (res) {
-		case ProvenanceMarkResolution.Low: return 2;
-		case ProvenanceMarkResolution.Medium:
-		case ProvenanceMarkResolution.Quartile:
-		case ProvenanceMarkResolution.High: return 4;
+		case 0: return 2;
+		case 1:
+		case 2:
+		case 3: return 4;
 	}
 }
 /**
@@ -321,10 +318,10 @@ function seqBytesLength(res) {
 */
 function dateBytesLength(res) {
 	switch (res) {
-		case ProvenanceMarkResolution.Low: return 2;
-		case ProvenanceMarkResolution.Medium: return 4;
-		case ProvenanceMarkResolution.Quartile:
-		case ProvenanceMarkResolution.High: return 6;
+		case 0: return 2;
+		case 1: return 4;
+		case 2:
+		case 3: return 6;
 	}
 }
 /**
@@ -392,10 +389,10 @@ function infoRangeStart(res) {
 */
 function serializeDate(res, date) {
 	switch (res) {
-		case ProvenanceMarkResolution.Low: return serialize2Bytes(date);
-		case ProvenanceMarkResolution.Medium: return serialize4Bytes(date);
-		case ProvenanceMarkResolution.Quartile:
-		case ProvenanceMarkResolution.High: return serialize6Bytes(date);
+		case 0: return serialize2Bytes(date);
+		case 1: return serialize4Bytes(date);
+		case 2:
+		case 3: return serialize6Bytes(date);
 	}
 }
 /**
@@ -403,15 +400,15 @@ function serializeDate(res, date) {
 */
 function deserializeDate(res, data) {
 	switch (res) {
-		case ProvenanceMarkResolution.Low:
-			if (data.length !== 2) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `invalid date length: expected 2 bytes, got ${data.length}` });
+		case 0:
+			if (data.length !== 2) throw new ProvenanceMarkError("ResolutionError", void 0, { details: `invalid date length: expected 2 bytes, got ${data.length}` });
 			return deserialize2Bytes(data);
-		case ProvenanceMarkResolution.Medium:
-			if (data.length !== 4) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `invalid date length: expected 4 bytes, got ${data.length}` });
+		case 1:
+			if (data.length !== 4) throw new ProvenanceMarkError("ResolutionError", void 0, { details: `invalid date length: expected 4 bytes, got ${data.length}` });
 			return deserialize4Bytes(data);
-		case ProvenanceMarkResolution.Quartile:
-		case ProvenanceMarkResolution.High:
-			if (data.length !== 6) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `invalid date length: expected 6 bytes, got ${data.length}` });
+		case 2:
+		case 3:
+			if (data.length !== 6) throw new ProvenanceMarkError("ResolutionError", void 0, { details: `invalid date length: expected 6 bytes, got ${data.length}` });
 			return deserialize6Bytes(data);
 	}
 }
@@ -420,7 +417,7 @@ function deserializeDate(res, data) {
 */
 function serializeSeq(res, seq) {
 	if (seqBytesLength(res) === 2) {
-		if (seq > 65535) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `sequence number ${seq} out of range for 2-byte format (max 65535)` });
+		if (seq > 65535) throw new ProvenanceMarkError("ResolutionError", void 0, { details: `sequence number ${seq} out of range for 2-byte format (max 65535)` });
 		const buf = new Uint8Array(2);
 		buf[0] = seq >> 8 & 255;
 		buf[1] = seq & 255;
@@ -439,10 +436,10 @@ function serializeSeq(res, seq) {
 */
 function deserializeSeq(res, data) {
 	if (seqBytesLength(res) === 2) {
-		if (data.length !== 2) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `invalid sequence number length: expected 2 bytes, got ${data.length}` });
+		if (data.length !== 2) throw new ProvenanceMarkError("ResolutionError", void 0, { details: `invalid sequence number length: expected 2 bytes, got ${data.length}` });
 		return data[0] << 8 | data[1];
 	} else {
-		if (data.length !== 4) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ResolutionError, void 0, { details: `invalid sequence number length: expected 4 bytes, got ${data.length}` });
+		if (data.length !== 4) throw new ProvenanceMarkError("ResolutionError", void 0, { details: `invalid sequence number length: expected 4 bytes, got ${data.length}` });
 		return (data[0] << 24 | data[1] << 16 | data[2] << 8 | data[3]) >>> 0;
 	}
 }
@@ -451,10 +448,10 @@ function deserializeSeq(res, data) {
 */
 function resolutionToString(res) {
 	switch (res) {
-		case ProvenanceMarkResolution.Low: return "low";
-		case ProvenanceMarkResolution.Medium: return "medium";
-		case ProvenanceMarkResolution.Quartile: return "quartile";
-		case ProvenanceMarkResolution.High: return "high";
+		case 0: return "low";
+		case 1: return "medium";
+		case 2: return "quartile";
+		case 3: return "high";
 	}
 }
 /**
@@ -470,7 +467,6 @@ function resolutionFromCbor(cborValue) {
 	const value = (0, _bcts_dcbor.expectUnsigned)(cborValue);
 	return resolutionFromNumber(Number(value));
 }
-
 //#endregion
 //#region src/crypto-utils.ts
 /**
@@ -514,7 +510,6 @@ function obfuscate(key, message) {
 	for (let i = 0; i < 12; i++) iv[i] = extendedKey[31 - i];
 	return (0, _noble_ciphers_chacha_js.chacha20)(extendedKey, iv, message instanceof Uint8Array ? message : new Uint8Array(message));
 }
-
 //#endregion
 //#region src/xoshiro256starstar.ts
 /**
@@ -642,7 +637,6 @@ var Xoshiro256StarStar = class Xoshiro256StarStar {
 		this.s[3] = this.rotateLeft64(this.s[3], 45n);
 	}
 };
-
 //#endregion
 //#region src/rng-state.ts
 /**
@@ -669,7 +663,7 @@ var RngState = class RngState {
 	* Create from a 32-byte array.
 	*/
 	static fromBytes(bytes) {
-		if (bytes.length !== RNG_STATE_LENGTH) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidSeedLength, void 0, { actual: bytes.length });
+		if (bytes.length !== 32) throw new ProvenanceMarkError("InvalidSeedLength", void 0, { actual: bytes.length });
 		return new RngState(new Uint8Array(bytes));
 	}
 	/**
@@ -698,7 +692,6 @@ var RngState = class RngState {
 		return RngState.fromBytes(bytes);
 	}
 };
-
 //#endregion
 //#region src/seed.ts
 /**
@@ -719,15 +712,15 @@ var ProvenanceSeed = class ProvenanceSeed {
 	* Create a new random seed using secure random number generation.
 	*/
 	static new() {
-		const data = (0, _bcts_rand.randomData)(PROVENANCE_SEED_LENGTH);
+		const data = (0, _bcts_rand.randomData)(32);
 		return ProvenanceSeed.fromBytes(data);
 	}
 	/**
 	* Create a new seed using custom random data.
 	*/
 	static newUsing(randomData) {
-		if (randomData.length < PROVENANCE_SEED_LENGTH) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidSeedLength, void 0, { actual: randomData.length });
-		return ProvenanceSeed.fromBytes(randomData.slice(0, PROVENANCE_SEED_LENGTH));
+		if (randomData.length < 32) throw new ProvenanceMarkError("InvalidSeedLength", void 0, { actual: randomData.length });
+		return ProvenanceSeed.fromBytes(randomData.slice(0, 32));
 	}
 	/**
 	* Create a new seed from a passphrase.
@@ -746,7 +739,7 @@ var ProvenanceSeed = class ProvenanceSeed {
 	* Create from a 32-byte array.
 	*/
 	static fromBytes(bytes) {
-		if (bytes.length !== PROVENANCE_SEED_LENGTH) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidSeedLength, void 0, { actual: bytes.length });
+		if (bytes.length !== 32) throw new ProvenanceMarkError("InvalidSeedLength", void 0, { actual: bytes.length });
 		return new ProvenanceSeed(new Uint8Array(bytes));
 	}
 	/**
@@ -775,7 +768,6 @@ var ProvenanceSeed = class ProvenanceSeed {
 		return ProvenanceSeed.fromBytes(bytes);
 	}
 };
-
 //#endregion
 //#region src/utils.ts
 /**
@@ -824,7 +816,6 @@ function fromBase64(base64) {
 	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
 	return bytes;
 }
-
 //#endregion
 //#region src/validate.ts
 /**
@@ -899,7 +890,7 @@ function formatText(report) {
 		if (!chain.hasGenesis) lines.push("  Warning: No genesis mark found");
 		for (const seq of chain.sequences) for (const flaggedMark of seq.marks) {
 			const mark = flaggedMark.mark;
-			const shortId = mark.identifier();
+			const shortId = mark.idHex().slice(0, 8);
 			const seqNum = mark.seq();
 			const annotations = [];
 			if (mark.isGenesis()) annotations.push("genesis mark");
@@ -939,9 +930,9 @@ function formatText(report) {
 */
 function formatReport(report, format) {
 	switch (format) {
-		case ValidationReportFormat.Text: return formatText(report);
-		case ValidationReportFormat.JsonCompact: return JSON.stringify(reportToJSON(report));
-		case ValidationReportFormat.JsonPretty: return JSON.stringify(reportToJSON(report), null, 2);
+		case "text": return formatText(report);
+		case "json-compact": return JSON.stringify(reportToJSON(report));
+		case "json-pretty": return JSON.stringify(reportToJSON(report), null, 2);
 	}
 }
 /**
@@ -1097,7 +1088,6 @@ function hexDecode(hex) {
 	for (let i = 0; i < hex.length; i += 2) bytes[i / 2] = parseInt(hex.slice(i, i + 2), 16);
 	return bytes;
 }
-
 //#endregion
 //#region src/mark.ts
 /**
@@ -1179,15 +1169,15 @@ var ProvenanceMark = class ProvenanceMark {
 	*/
 	static new(res, key, nextKey, chainId, seq, date, info) {
 		const linkLen = linkLength(res);
-		if (key.length !== linkLen) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidKeyLength, void 0, {
+		if (key.length !== linkLen) throw new ProvenanceMarkError("InvalidKeyLength", void 0, {
 			expected: linkLen,
 			actual: key.length
 		});
-		if (nextKey.length !== linkLen) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidNextKeyLength, void 0, {
+		if (nextKey.length !== linkLen) throw new ProvenanceMarkError("InvalidNextKeyLength", void 0, {
 			expected: linkLen,
 			actual: nextKey.length
 		});
-		if (chainId.length !== linkLen) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidChainIdLength, void 0, {
+		if (chainId.length !== linkLen) throw new ProvenanceMarkError("InvalidChainIdLength", void 0, {
 			expected: linkLen,
 			actual: chainId.length
 		});
@@ -1203,7 +1193,7 @@ var ProvenanceMark = class ProvenanceMark {
 	*/
 	static fromMessage(res, message) {
 		const minLen = fixedLength(res);
-		if (message.length < minLen) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidMessageLength, void 0, {
+		if (message.length < minLen) throw new ProvenanceMarkError("InvalidMessageLength", void 0, {
 			expected: minLen,
 			actual: message.length
 		});
@@ -1226,7 +1216,7 @@ var ProvenanceMark = class ProvenanceMark {
 		if (infoBytes.length > 0) try {
 			(0, _bcts_dcbor.decodeCbor)(infoBytes);
 		} catch {
-			throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidInfoCbor);
+			throw new ProvenanceMarkError("InvalidInfoCbor");
 		}
 		return new ProvenanceMark(res, new Uint8Array(key), new Uint8Array(hash), new Uint8Array(chainId), new Uint8Array(seqBytes), new Uint8Array(dateBytes), new Uint8Array(infoBytes), seq, date);
 	}
@@ -1241,51 +1231,174 @@ var ProvenanceMark = class ProvenanceMark {
 		]), linkLength(res));
 	}
 	/**
-	* Get the first four bytes of the hash as a hex string identifier.
+	* The 32-byte Mark ID.
+	*
+	* The first `linkLength` bytes are the mark's stored hash. The remaining
+	* bytes come from the mark's fingerprint (SHA-256 of CBOR encoding),
+	* ensuring a full 32-byte value is always available regardless of
+	* resolution.
+	*/
+	id() {
+		const result = new Uint8Array(32);
+		const n = this._hash.length;
+		result.set(this._hash, 0);
+		if (n < 32) {
+			const fp = this.fingerprint();
+			result.set(fp.subarray(0, 32 - n), n);
+		}
+		return result;
+	}
+	/**
+	* The full 32-byte Mark ID as a 64-character hex string.
+	*/
+	idHex() {
+		return bytesToHex(this.id());
+	}
+	/**
+	* The first `wordCount` bytes of the Mark ID as upper-case ByteWords.
+	*
+	* @param wordCount Number of bytes to encode, must be in `4..=32`.
+	* @param prefix If `true`, prepends the provenance-mark prefix character.
+	* @throws if `wordCount` is not in the range `4..=32`.
+	*/
+	idBytewords(wordCount, prefix) {
+		if (!Number.isInteger(wordCount) || wordCount < 4 || wordCount > 32) throw new Error(`word_count must be 4..=32, got ${wordCount}`);
+		const s = (0, _bcts_uniform_resources.encodeToWords)(this.id().subarray(0, wordCount)).toUpperCase();
+		return prefix ? `\u{1F151} ${s}` : s;
+	}
+	/**
+	* The first `wordCount` bytes of the Mark ID as Bytemoji.
+	*
+	* @param wordCount Number of bytes to encode, must be in `4..=32`.
+	* @param prefix If `true`, prepends the provenance-mark prefix character.
+	* @throws if `wordCount` is not in the range `4..=32`.
+	*/
+	idBytemoji(wordCount, prefix) {
+		if (!Number.isInteger(wordCount) || wordCount < 4 || wordCount > 32) throw new Error(`word_count must be 4..=32, got ${wordCount}`);
+		const s = (0, _bcts_uniform_resources.encodeToBytemojis)(this.id().subarray(0, wordCount)).toUpperCase();
+		return prefix ? `\u{1F151} ${s}` : s;
+	}
+	/**
+	* The first `wordCount` bytes of the Mark ID as upper-case minimal
+	* ByteWords (2 letters per byte, concatenated without separator).
+	*
+	* @param wordCount Number of bytes to encode, must be in `4..=32`.
+	* @param prefix If `true`, prepends the provenance-mark prefix character.
+	* @throws if `wordCount` is not in the range `4..=32`.
+	*/
+	idBytewordsMinimal(wordCount, prefix) {
+		if (!Number.isInteger(wordCount) || wordCount < 4 || wordCount > 32) throw new Error(`word_count must be 4..=32, got ${wordCount}`);
+		const s = (0, _bcts_uniform_resources.encodeToMinimalBytewords)(this.id().subarray(0, wordCount)).toUpperCase();
+		return prefix ? `\u{1F151} ${s}` : s;
+	}
+	/**
+	* Legacy 8-character hex identifier — the first 4 bytes of the Mark ID.
+	*
+	* @deprecated Use {@link idHex} for the full 64-char hex, or
+	*   `idHex().slice(0, 8)` for this legacy short form. Retained for
+	*   backwards compatibility; will be removed in a future alpha.
 	*/
 	identifier() {
-		return Array.from(this._hash.slice(0, 4)).map((b) => b.toString(16).padStart(2, "0")).join("");
+		return this.idHex().slice(0, 8);
 	}
 	/**
-	* Get the first four bytes of the hash as upper-case ByteWords.
+	* Legacy 4-byte upper-case ByteWords identifier.
+	*
+	* @deprecated Equivalent to `idBytewords(4, prefix)`. Retained for
+	*   backwards compatibility; will be removed in a future alpha.
 	*/
 	bytewordsIdentifier(prefix) {
-		const s = (0, _bcts_uniform_resources.encodeBytewordsIdentifier)(this._hash.slice(0, 4)).toUpperCase();
-		return prefix ? `\u{1F151} ${s}` : s;
+		return this.idBytewords(4, prefix);
 	}
 	/**
-	* A compact 8-letter identifier derived from the upper-case ByteWords
-	* identifier by taking the first and last letter of each ByteWords word
-	* (4 words x 2 letters = 8 letters).
+	* Legacy 8-letter minimal ByteWords identifier (first+last letter of each
+	* of the 4 ByteWords). Example: "ABLE ACID ALSO APEX" -> "AEADAOAX".
 	*
-	* Example: "ABLE ACID ALSO APEX" -> "AEADAOAX"
-	* If prefix is true, prepends the provenance mark prefix character.
+	* @deprecated Equivalent to `idBytewordsMinimal(4, prefix)`. Retained
+	*   for backwards compatibility; will be removed in a future alpha.
 	*/
 	bytewordsMinimalIdentifier(prefix) {
-		const full = (0, _bcts_uniform_resources.encodeBytewordsIdentifier)(this._hash.slice(0, 4));
-		const words = full.split(/\s+/);
-		let out = "";
-		if (words.length === 4) for (const w of words) {
-			if (w.length === 0) continue;
-			out += w[0].toUpperCase();
-			out += w[w.length - 1].toUpperCase();
+		return this.idBytewordsMinimal(4, prefix);
+	}
+	/**
+	* Legacy 4-byte upper-case Bytemoji identifier.
+	*
+	* @deprecated Equivalent to `idBytemoji(4, prefix)`. Retained for
+	*   backwards compatibility; will be removed in a future alpha.
+	*/
+	bytemojiIdentifier(prefix) {
+		return this.idBytemoji(4, prefix);
+	}
+	/**
+	* Computes the minimum prefix length (in bytes, `4..=32`) each mark needs
+	* so that every mark in the set has a unique Mark ID prefix.
+	*
+	* Non-colliding marks get the minimum of 4. Only marks whose 4-byte
+	* prefixes collide are extended.
+	*/
+	static minimalNoncollidingPrefixLengths(ids) {
+		const n = ids.length;
+		const lengths = new Array(n).fill(4);
+		const groups = /* @__PURE__ */ new Map();
+		for (let i = 0; i < n; i++) {
+			const key = bytesToHex(ids[i].subarray(0, 4));
+			const g = groups.get(key);
+			if (g !== void 0) g.push(i);
+			else groups.set(key, [i]);
+		}
+		for (const indices of groups.values()) {
+			if (indices.length <= 1) continue;
+			ProvenanceMark.resolveCollisionGroup(ids, indices, lengths);
 		}
-		if (out.length !== 8) {
-			out = "";
-			const compact = full.replace(/[^a-zA-Z]/g, "").toUpperCase();
-			for (let i = 0; i + 3 < compact.length; i += 4) {
-				out += compact[i];
-				out += compact[i + 3];
+		return lengths;
+	}
+	static resolveCollisionGroup(ids, initialIndices, lengths) {
+		let unresolved = [...initialIndices];
+		for (let prefixLen = 5; prefixLen <= 32; prefixLen++) {
+			const subGroups = /* @__PURE__ */ new Map();
+			for (const i of unresolved) {
+				const key = bytesToHex(ids[i].subarray(0, prefixLen));
+				const g = subGroups.get(key);
+				if (g !== void 0) g.push(i);
+				else subGroups.set(key, [i]);
 			}
+			const nextUnresolved = [];
+			for (const subIndices of subGroups.values()) if (subIndices.length === 1) lengths[subIndices[0]] = prefixLen;
+			else nextUnresolved.push(...subIndices);
+			if (nextUnresolved.length === 0) return;
+			unresolved = nextUnresolved;
 		}
-		return prefix ? `\u{1F151} ${out}` : out;
+		for (const i of unresolved) lengths[i] = 32;
 	}
 	/**
-	* Get the first four bytes of the hash as Bytemoji.
-	*/
-	bytemojiIdentifier(prefix) {
-		const s = (0, _bcts_uniform_resources.encodeBytemojisIdentifier)(this._hash.slice(0, 4)).toUpperCase();
-		return prefix ? `\u{1F151} ${s}` : s;
+	* Returns disambiguated upper-case ByteWords Mark IDs for a set of marks.
+	*
+	* Non-colliding marks get 4-word identifiers. Only marks whose 4-byte
+	* prefixes collide are extended with additional words (up to 32 bytes
+	* per identifier).
+	*/
+	static disambiguatedIdBytewords(marks, prefix) {
+		const ids = marks.map((m) => m.id());
+		const lengths = ProvenanceMark.minimalNoncollidingPrefixLengths(ids);
+		return ids.map((id, i) => {
+			const s = (0, _bcts_uniform_resources.encodeToWords)(id.subarray(0, lengths[i])).toUpperCase();
+			return prefix ? `\u{1F151} ${s}` : s;
+		});
+	}
+	/**
+	* Returns disambiguated Bytemoji Mark IDs for a set of marks.
+	*
+	* Non-colliding marks get 4-emoji identifiers. Only marks whose 4-byte
+	* prefixes collide are extended with additional emojis (up to 32 bytes
+	* per identifier).
+	*/
+	static disambiguatedIdBytemoji(marks, prefix) {
+		const ids = marks.map((m) => m.id());
+		const lengths = ProvenanceMark.minimalNoncollidingPrefixLengths(ids);
+		return ids.map((id, i) => {
+			const s = (0, _bcts_uniform_resources.encodeToBytemojis)(id.subarray(0, lengths[i])).toUpperCase();
+			return prefix ? `\u{1F151} ${s}` : s;
+		});
 	}
 	/**
 	* Check if this mark precedes another mark in the chain.
@@ -1304,15 +1417,15 @@ var ProvenanceMark = class ProvenanceMark {
 	* `Error::Validation(ValidationIssue)` pattern.
 	*/
 	precedesOpt(next) {
-		if (next._seq === 0) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ValidationError, "non-genesis mark at sequence 0", { validationIssue: { type: "NonGenesisAtZero" } });
-		if (arraysEqual(next._key, next._chainId)) throw new ProvenanceMarkError(ProvenanceMarkErrorType.ValidationError, "genesis mark must have key equal to chain_id", { validationIssue: { type: "InvalidGenesisKey" } });
+		if (next._seq === 0) throw new ProvenanceMarkError("ValidationError", "non-genesis mark at sequence 0", { validationIssue: { type: "NonGenesisAtZero" } });
+		if (arraysEqual(next._key, next._chainId)) throw new ProvenanceMarkError("ValidationError", "genesis mark must have key equal to chain_id", { validationIssue: { type: "InvalidGenesisKey" } });
 		if (this._seq !== next._seq - 1) {
 			const issue = {
 				type: "SequenceGap",
 				expected: this._seq + 1,
 				actual: next._seq
 			};
-			throw new ProvenanceMarkError(ProvenanceMarkErrorType.ValidationError, `sequence gap: expected ${this._seq + 1}, got ${next._seq}`, { validationIssue: issue });
+			throw new ProvenanceMarkError("ValidationError", `sequence gap: expected ${this._seq + 1}, got ${next._seq}`, { validationIssue: issue });
 		}
 		if (this._date > next._date) {
 			const dateStr = this._date.toISOString().replace(".000Z", "Z");
@@ -1322,7 +1435,7 @@ var ProvenanceMark = class ProvenanceMark {
 				previous: dateStr,
 				next: nextDateStr
 			};
-			throw new ProvenanceMarkError(ProvenanceMarkErrorType.ValidationError, `date ordering: ${dateStr} > ${nextDateStr}`, { validationIssue: issue });
+			throw new ProvenanceMarkError("ValidationError", `date ordering: ${dateStr} > ${nextDateStr}`, { validationIssue: issue });
 		}
 		const expectedHash = ProvenanceMark.makeHash(this._res, this._key, next._key, this._chainId, this._seqBytes, this._dateBytes, this._infoBytes);
 		if (!arraysEqual(this._hash, expectedHash)) {
@@ -1331,7 +1444,7 @@ var ProvenanceMark = class ProvenanceMark {
 				expected: bytesToHex(expectedHash),
 				actual: bytesToHex(this._hash)
 			};
-			throw new ProvenanceMarkError(ProvenanceMarkErrorType.ValidationError, `hash mismatch: expected ${bytesToHex(expectedHash)}, got ${bytesToHex(this._hash)}`, { validationIssue: issue });
+			throw new ProvenanceMarkError("ValidationError", `hash mismatch: expected ${bytesToHex(expectedHash)}, got ${bytesToHex(this._hash)}`, { validationIssue: issue });
 		}
 	}
 	/**
@@ -1392,7 +1505,7 @@ var ProvenanceMark = class ProvenanceMark {
 	*/
 	static fromURString(urString) {
 		const ur = _bcts_uniform_resources.UR.fromURString(urString);
-		if (ur.urTypeStr() !== "provenance") throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: `Expected UR type 'provenance', got '${ur.urTypeStr()}'` });
+		if (ur.urTypeStr() !== "provenance") throw new ProvenanceMarkError("CborError", void 0, { message: `Expected UR type 'provenance', got '${ur.urTypeStr()}'` });
 		return ProvenanceMark.fromUntaggedCbor(ur.cbor());
 	}
 	/**
@@ -1408,7 +1521,7 @@ var ProvenanceMark = class ProvenanceMark {
 	*/
 	static fromUrl(url) {
 		const param = url.searchParams.get("provenance");
-		if (param === null || param === "") throw new ProvenanceMarkError(ProvenanceMarkErrorType.MissingUrlParameter, void 0, { parameter: "provenance" });
+		if (param === null || param === "") throw new ProvenanceMarkError("MissingUrlParameter", void 0, { parameter: "provenance" });
 		return ProvenanceMark.fromUrlEncoding(param);
 	}
 	/**
@@ -1437,7 +1550,7 @@ var ProvenanceMark = class ProvenanceMark {
 	*/
 	static fromUntaggedCbor(cborValue) {
 		const arr = (0, _bcts_dcbor.expectArray)(cborValue);
-		if (arr.length !== 2) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Invalid provenance mark length" });
+		if (arr.length !== 2) throw new ProvenanceMarkError("CborError", void 0, { message: "Invalid provenance mark length" });
 		const res = resolutionFromCbor(arr[0]);
 		const message = (0, _bcts_dcbor.expectBytes)(arr[1]);
 		return ProvenanceMark.fromMessage(res, message);
@@ -1447,8 +1560,8 @@ var ProvenanceMark = class ProvenanceMark {
 	*/
 	static fromTaggedCbor(cborValue) {
 		const cborObj = cborValue;
-		if (cborObj.tag !== _bcts_tags.PROVENANCE_MARK.value) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: `Expected tag ${_bcts_tags.PROVENANCE_MARK.value}, got ${String(cborObj.tag)}` });
-		if (cborObj.value === void 0) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Tagged CBOR value is missing" });
+		if (cborObj.tag !== _bcts_tags.PROVENANCE_MARK.value) throw new ProvenanceMarkError("CborError", void 0, { message: `Expected tag ${_bcts_tags.PROVENANCE_MARK.value}, got ${String(cborObj.tag)}` });
+		if (cborObj.value === void 0) throw new ProvenanceMarkError("CborError", void 0, { message: "Tagged CBOR value is missing" });
 		return ProvenanceMark.fromUntaggedCbor(cborObj.value);
 	}
 	/**
@@ -1466,9 +1579,13 @@ var ProvenanceMark = class ProvenanceMark {
 	}
 	/**
 	* Debug string representation.
+	*
+	* As of provenance-mark v0.24, this includes the full 64-character Mark ID
+	* hex (matching rust's `Display` impl). Pre-v0.24 callers that depended on
+	* the 8-character prefix should use `idHex().slice(0, 8)` directly.
 	*/
 	toString() {
-		return `ProvenanceMark(${this.identifier()})`;
+		return `ProvenanceMark(${this.idHex()})`;
 	}
 	/**
 	* Detailed debug representation.
@@ -1559,7 +1676,7 @@ var ProvenanceMark = class ProvenanceMark {
 	static fromEnvelope(envelope) {
 		const leaf = envelope.subject().asLeaf();
 		if (leaf !== void 0) return ProvenanceMark.fromTaggedCbor(leaf);
-		throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Could not extract ProvenanceMark from envelope" });
+		throw new ProvenanceMarkError("CborError", void 0, { message: "Could not extract ProvenanceMark from envelope" });
 	}
 };
 /**
@@ -1570,7 +1687,6 @@ function arraysEqual(a, b) {
 	for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
 	return true;
 }
-
 //#endregion
 //#region src/generator.ts
 /**
@@ -1644,7 +1760,7 @@ var ProvenanceMarkGenerator = class ProvenanceMarkGenerator {
 	*/
 	static new(res, seed, chainId, nextSeq, rngState) {
 		const linkLen = linkLength(res);
-		if (chainId.length !== linkLen) throw new ProvenanceMarkError(ProvenanceMarkErrorType.InvalidChainIdLength, void 0, {
+		if (chainId.length !== linkLen) throw new ProvenanceMarkError("InvalidChainIdLength", void 0, {
 			expected: linkLen,
 			actual: chainId.length
 		});
@@ -1727,35 +1843,34 @@ var ProvenanceMarkGenerator = class ProvenanceMarkGenerator {
 	*/
 	static fromEnvelope(envelope) {
 		const env = envelope;
-		if (!env.hasType("provenance-generator")) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Envelope is not a provenance-generator" });
+		if (!env.hasType("provenance-generator")) throw new ProvenanceMarkError("CborError", void 0, { message: "Envelope is not a provenance-generator" });
 		const chainId = env.subject().asByteString();
-		if (chainId === void 0) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Could not extract chain ID" });
+		if (chainId === void 0) throw new ProvenanceMarkError("CborError", void 0, { message: "Could not extract chain ID" });
 		const extractAssertion = (predicate) => {
 			const assertions = env.assertionsWithPredicate(predicate);
-			if (assertions.length === 0) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: `Missing ${predicate} assertion` });
+			if (assertions.length === 0) throw new ProvenanceMarkError("CborError", void 0, { message: `Missing ${predicate} assertion` });
 			const assertionCase = assertions[0].case();
-			if (assertionCase.type !== "assertion") throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: `Invalid ${predicate} assertion` });
+			if (assertionCase.type !== "assertion") throw new ProvenanceMarkError("CborError", void 0, { message: `Invalid ${predicate} assertion` });
 			const obj = assertionCase.assertion.object();
 			const objCase = obj.case();
 			if (objCase.type === "leaf") return {
 				cbor: objCase.cbor,
 				bytes: obj.asByteString()
 			};
-			throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: `Invalid ${predicate} value` });
+			throw new ProvenanceMarkError("CborError", void 0, { message: `Invalid ${predicate} value` });
 		};
 		const res = resolutionFromCbor(extractAssertion("res").cbor);
 		const seedValue = extractAssertion("seed");
-		if (seedValue.bytes === void 0) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Invalid seed data" });
+		if (seedValue.bytes === void 0) throw new ProvenanceMarkError("CborError", void 0, { message: "Invalid seed data" });
 		const seed = ProvenanceSeed.fromBytes(seedValue.bytes);
 		const seqValue = extractAssertion("next-seq");
 		const nextSeq = Number(seqValue.cbor);
 		const rngValue = extractAssertion("rng-state");
-		if (rngValue.bytes === void 0) throw new ProvenanceMarkError(ProvenanceMarkErrorType.CborError, void 0, { message: "Invalid rng-state data" });
+		if (rngValue.bytes === void 0) throw new ProvenanceMarkError("CborError", void 0, { message: "Invalid rng-state data" });
 		const rngState = RngState.fromBytes(rngValue.bytes);
 		return ProvenanceMarkGenerator.new(res, seed, chainId, nextSeq, rngState);
 	}
 };
-
 //#endregion
 //#region src/mark-info.ts
 /**
@@ -1786,7 +1901,7 @@ var ProvenanceMarkInfo = class ProvenanceMarkInfo {
 		const tagName = _bcts_tags.PROVENANCE_MARK.name;
 		if (tagName === void 0) throw new Error("PROVENANCE_MARK tag has no name");
 		const cborValue = (0, _bcts_dcbor.decodeCbor)(mark.toCborData());
-		return new ProvenanceMarkInfo(mark, _bcts_uniform_resources.UR.new(tagName, cborValue), mark.bytewordsIdentifier(true), mark.bytemojiIdentifier(true), comment);
+		return new ProvenanceMarkInfo(mark, _bcts_uniform_resources.UR.new(tagName, cborValue), mark.idBytewords(4, true), mark.idBytemoji(4, true), comment);
 	}
 	mark() {
 		return this._mark;
@@ -1850,7 +1965,6 @@ var ProvenanceMarkInfo = class ProvenanceMarkInfo {
 		return new ProvenanceMarkInfo(mark, ur, bytewords, bytemoji, typeof json["comment"] === "string" ? json["comment"] : "");
 	}
 };
-
 //#endregion
 //#region src/envelope.ts
 /**
@@ -1948,13 +2062,12 @@ function provenanceMarkGeneratorToEnvelope(generator) {
 function provenanceMarkGeneratorFromEnvelope(envelope) {
 	return ProvenanceMarkGenerator.fromEnvelope(envelope);
 }
-
 //#endregion
-Object.defineProperty(exports, 'FormatContext', {
-  enumerable: true,
-  get: function () {
-    return _bcts_envelope.FormatContext;
-  }
+Object.defineProperty(exports, "FormatContext", {
+	enumerable: true,
+	get: function() {
+		return _bcts_envelope.FormatContext;
+	}
 });
 exports.PROVENANCE_SEED_LENGTH = PROVENANCE_SEED_LENGTH;
 exports.ProvenanceMark = ProvenanceMark;
@@ -2014,4 +2127,5 @@ exports.serializeSeq = serializeSeq;
 exports.sha256 = sha256;
 exports.sha256Prefix = sha256Prefix;
 exports.validate = validate;
+
 //# sourceMappingURL=index.cjs.map