agent-passport-system 3.0.0 → 3.2.0

package/dist/src/v2/word_handles/__tests__/word_handles.test.js

@@ -0,0 +1,312 @@
+// Copyright 2024-2026 Tymofii Pidlisnyi. Apache-2.0 license. See LICENSE.
+// ══════════════════════════════════════════════════════════════════
+// word_handles codec (v2): tests
+// ══════════════════════════════════════════════════════════════════
+// Deterministic throughout: every derived digest, substituted
+// position, replacement word, and transposition site comes from
+// sha256 over a fixed label plus a counter. No wall clock, no
+// randomness.
+// ══════════════════════════════════════════════════════════════════
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { encode, decode, encodeProfile, decodeProfile, minUniquePrefixBits, PROFILES, LEXICON_PROFILE, LEXICON_ID, LEXICON_NAME, WORDS, canonicalWordlistText, } from '../index.js';
+function sha256Hex(s) {
+    return createHash('sha256').update(s, 'utf8').digest('hex');
+}
+/** First 4 bytes of sha256(label) as a big-endian uint32 seed. */
+function seedUint32(label) {
+    return createHash('sha256').update(label, 'utf8').digest().readUInt32BE(0);
+}
+const WORD_TO_INDEX = (() => {
+    const m = new Map();
+    for (let i = 0; i < WORDS.length; i++)
+        m.set(WORDS[i], i);
+    return m;
+})();
+/** Expected prefixHex: first ceil(prefixBits/8) bytes, pad bits zeroed. */
+function expectedPrefixHex(digestHex, prefixBits) {
+    const byteLen = Math.ceil(prefixBits / 8);
+    const bytes = Buffer.from(digestHex.slice(0, byteLen * 2), 'hex');
+    const rem = prefixBits % 8;
+    if (rem !== 0) {
+        bytes[byteLen - 1] &= (0xff << (8 - rem)) & 0xff;
+    }
+    return bytes.toString('hex');
+}
+const PROFILE_NAMES = [
+    'compact',
+    'default',
+    'high_assurance',
+];
+describe('lexicon integrity', () => {
+    it('has exactly 2048 words', () => {
+        assert.equal(WORDS.length, 2048);
+    });
+    it('is strictly sorted ascending (implies unique words)', () => {
+        for (let i = 1; i < WORDS.length; i++) {
+            assert.ok(WORDS[i - 1] < WORDS[i], `words not strictly sorted at index ${i}: ${WORDS[i - 1]} vs ${WORDS[i]}`);
+        }
+    });
+    it('has unique 4-character prefixes', () => {
+        const prefixes = new Set(WORDS.map((w) => w.slice(0, 4)));
+        assert.equal(prefixes.size, WORDS.length);
+    });
+    it('canonical wordlist text hashes to LEXICON_ID', () => {
+        assert.equal(LEXICON_NAME, 'aps-handle-en-v1');
+        const hex = createHash('sha256')
+            .update(canonicalWordlistText(), 'utf8')
+            .digest('hex');
+        assert.equal(`sha256:${hex}`, LEXICON_ID);
+    });
+    it('has zero overlap with the bip39_english.txt disjointness input', () => {
+        // lexicon-source/bip39_english.txt is a pinned DISJOINTNESS input to
+        // the lexicon generator; no lexicon word may appear in it.
+        const raw = readFileSync(new URL('../lexicon-source/bip39_english.txt', import.meta.url), 'utf8');
+        const banned = new Set(raw
+            .split('\n')
+            .map((w) => w.trim())
+            .filter((w) => w.length > 0));
+        assert.equal(banned.size, 2048);
+        const overlap = WORDS.filter((w) => banned.has(w));
+        assert.deepEqual(overlap, []);
+    });
+});
+describe('round-trip across all three profiles', () => {
+    it('round-trips 200 derived digests per profile', () => {
+        for (let t = 0; t < 200; t++) {
+            const digest = sha256Hex(`wh-roundtrip:${t}`);
+            for (const name of PROFILE_NAMES) {
+                const p = PROFILES[name];
+                const words = encodeProfile(digest, name);
+                assert.equal(words.length, p.dataWords + p.checksumWords);
+                const res = decodeProfile(words, name);
+                assert.equal(res.checksumOk, true);
+                assert.equal(res.prefixBits, p.prefixBits);
+                assert.equal(res.prefixHex, expectedPrefixHex(digest, p.prefixBits));
+                assert.equal(res.failedWordIndex, null);
+                assert.deepEqual(res.outOfLexicon, []);
+            }
+        }
+    });
+    it('accepts a sha256: prefix and raw bytes as equivalent inputs', () => {
+        const digest = sha256Hex('wh-input-forms:0');
+        const fromHex = encode(digest);
+        const fromPrefixed = encode(`sha256:${digest}`);
+        const fromBytes = encode(new Uint8Array(Buffer.from(digest, 'hex')));
+        assert.deepEqual(fromPrefixed, fromHex);
+        assert.deepEqual(fromBytes, fromHex);
+    });
+    it('exposes the profile table and lexicon profile id', () => {
+        assert.equal(LEXICON_PROFILE, 'single-list-v1');
+        assert.deepEqual(PROFILES.compact, {
+            name: 'compact',
+            dataWords: 4,
+            checksumWords: 1,
+            prefixBits: 44,
+        });
+        assert.deepEqual(PROFILES.default, {
+            name: 'default',
+            dataWords: 6,
+            checksumWords: 1,
+            prefixBits: 66,
+        });
+        assert.deepEqual(PROFILES.high_assurance, {
+            name: 'high_assurance',
+            dataWords: 8,
+            checksumWords: 2,
+            prefixBits: 88,
+        });
+    });
+});
+describe('substitution detection (default profile, 600 trials)', () => {
+    it('detects >= 597 of 600 single data word substitutions', () => {
+        const dataWords = PROFILES.default.dataWords;
+        let detected = 0;
+        for (let t = 0; t < 600; t++) {
+            const digest = sha256Hex(`wh-substitute:${t}`);
+            const words = encode(digest);
+            const pos = seedUint32(`wh-substitute-pos:${t}`) % dataWords;
+            const origIdx = WORD_TO_INDEX.get(words[pos]);
+            const delta = 1 + (seedUint32(`wh-substitute-word:${t}`) % (WORDS.length - 1));
+            const mutated = words.slice();
+            mutated[pos] = WORDS[(origIdx + delta) % WORDS.length];
+            const res = decode(mutated);
+            if (!res.checksumOk)
+                detected++;
+            if (res.failedWordIndex !== null) {
+                assert.equal(res.failedWordIndex, pos, `trial ${t}: localized ${res.failedWordIndex}, substituted ${pos}`);
+            }
+        }
+        assert.ok(detected >= 597, `detected ${detected} of 600, expected >= 597`);
+    });
+});
+describe('transposition detection (default profile, 300 trials)', () => {
+    it('detects >= 297 of 300 adjacent differing data word swaps', () => {
+        const dataWords = PROFILES.default.dataWords;
+        let detected = 0;
+        for (let t = 0; t < 300; t++) {
+            const digest = sha256Hex(`wh-transpose:${t}`);
+            const words = encode(digest);
+            const start = seedUint32(`wh-transpose-pos:${t}`) % (dataWords - 1);
+            let pair = -1;
+            for (let k = 0; k < dataWords - 1; k++) {
+                const i = (start + k) % (dataWords - 1);
+                if (words[i] !== words[i + 1]) {
+                    pair = i;
+                    break;
+                }
+            }
+            assert.ok(pair >= 0, `trial ${t}: no adjacent differing data words`);
+            const mutated = words.slice();
+            const tmp = mutated[pair];
+            mutated[pair] = mutated[pair + 1];
+            mutated[pair + 1] = tmp;
+            const res = decode(mutated);
+            if (!res.checksumOk)
+                detected++;
+        }
+        assert.ok(detected >= 297, `detected ${detected} of 300, expected >= 297`);
+    });
+});
+describe('high_assurance profile (2 checksum words)', () => {
+    it('round-trips and reports both checksum words through decode', () => {
+        const digest = sha256Hex('wh-high-assurance:0');
+        const words = encodeProfile(digest, 'high_assurance');
+        assert.equal(words.length, 10);
+        const res = decode(words, 2);
+        assert.equal(res.checksumOk, true);
+        assert.equal(res.prefixBits, 88);
+        assert.equal(res.prefixHex, expectedPrefixHex(digest, 88));
+    });
+    it('detects data word substitutions and localizes them precisely', () => {
+        const dataWords = PROFILES.high_assurance.dataWords;
+        let localized = 0;
+        for (let t = 0; t < 40; t++) {
+            const digest = sha256Hex(`wh-ha-substitute:${t}`);
+            const words = encodeProfile(digest, 'high_assurance');
+            const pos = seedUint32(`wh-ha-substitute-pos:${t}`) % dataWords;
+            const origIdx = WORD_TO_INDEX.get(words[pos]);
+            const delta = 1 + (seedUint32(`wh-ha-substitute-word:${t}`) % (WORDS.length - 1));
+            const mutated = words.slice();
+            mutated[pos] = WORDS[(origIdx + delta) % WORDS.length];
+            const res = decodeProfile(mutated, 'high_assurance');
+            assert.equal(res.checksumOk, false, `trial ${t}: substitution not detected`);
+            if (res.failedWordIndex !== null) {
+                assert.equal(res.failedWordIndex, pos);
+                localized++;
+            }
+        }
+        // With two checksum words a wrong position is coincidentally fixable
+        // with probability about 2047 * 2^-22, so localization is almost
+        // always unique.
+        assert.ok(localized >= 35, `localized ${localized} of 40, expected >= 35`);
+    });
+});
+describe('out-of-lexicon words', () => {
+    it('reports indices and suppresses decoding', () => {
+        const digest = sha256Hex('wh-out-of-lexicon:0');
+        const words = encode(digest);
+        const mutated = words.slice();
+        mutated[2] = 'notaword';
+        mutated[4] = 'Abacus'; // case-sensitive: 'abacus' is in the lexicon, this is not
+        const res = decode(mutated);
+        assert.deepEqual(res.outOfLexicon, [2, 4]);
+        assert.equal(res.prefixHex, null);
+        assert.equal(res.prefixBits, null);
+        assert.equal(res.checksumOk, false);
+        assert.equal(res.failedWordIndex, null);
+    });
+    it('does not trim whitespace (exact code-unit equality)', () => {
+        const digest = sha256Hex('wh-out-of-lexicon:1');
+        const words = encode(digest);
+        const mutated = words.slice();
+        mutated[0] = `${mutated[0]} `;
+        const res = decode(mutated);
+        assert.deepEqual(res.outOfLexicon, [0]);
+        assert.equal(res.checksumOk, false);
+    });
+});
+describe('prefixHex padding semantics', () => {
+    it('66-bit decode returns 18 hex chars with pad bits zero and prefixBits 66', () => {
+        const allOnes = 'ff'.repeat(32);
+        const res = decode(encode(allOnes, 66, 1));
+        assert.equal(res.prefixBits, 66);
+        assert.equal(res.prefixHex?.length, 18);
+        // 66 data bits into 9 bytes: the final byte keeps its top 2 bits and
+        // pads the low 6 with zeros, so an all-ones input ends in "c0".
+        assert.equal(res.prefixHex, 'ffffffffffffffffc0');
+    });
+    it('44-bit and 88-bit cases pad to the byte boundary', () => {
+        const allOnes = 'ff'.repeat(32);
+        const compact = decode(encode(allOnes, 44, 1));
+        assert.equal(compact.prefixBits, 44);
+        assert.equal(compact.prefixHex, 'fffffffffff0');
+        const high = decode(encode(allOnes, 88, 2), 2);
+        assert.equal(high.prefixBits, 88);
+        assert.equal(high.prefixHex, 'ff'.repeat(11));
+    });
+});
+describe('minUniquePrefixBits', () => {
+    it('returns 44 when 44-bit prefixes are already pairwise distinct', () => {
+        const digests = [0, 1, 2, 3].map((i) => sha256Hex(`wh-unique:${i}`));
+        assert.equal(minUniquePrefixBits(digests), 44);
+    });
+    it('moves to the next multiple of 11 that separates shared 44-bit prefixes', () => {
+        // Shared first 48 bits (12 hex chars), differing at bit 48: 44-bit
+        // prefixes collide, 55-bit prefixes differ.
+        const shared = '0123456789ab';
+        const digests = [`${shared}0${'0'.repeat(19)}`, `${shared}f${'0'.repeat(19)}`];
+        assert.equal(minUniquePrefixBits(digests), 55);
+        // Shared first 56 bits (14 hex chars), differing at bit 56: 55-bit
+        // prefixes collide too, 66-bit prefixes differ.
+        const shared56 = '0123456789abcd';
+        const digests56 = [`${shared56}0${'0'.repeat(17)}`, `${shared56}f${'0'.repeat(17)}`];
+        assert.equal(minUniquePrefixBits(digests56), 66);
+    });
+    it('rounds startBits up to a multiple of 11', () => {
+        const digests = [0, 1].map((i) => sha256Hex(`wh-startbits:${i}`));
+        assert.equal(minUniquePrefixBits(digests, 50), 55);
+    });
+    it('strips sha256: prefixes and returns 44 for a single digest', () => {
+        const digest = sha256Hex('wh-single:0');
+        assert.equal(minUniquePrefixBits([`sha256:${digest}`]), 44);
+    });
+    it('throws on duplicates and on empty input', () => {
+        const digest = sha256Hex('wh-duplicate:0');
+        assert.throws(() => minUniquePrefixBits([`sha256:${digest}`, digest]), /duplicate digests/);
+        assert.throws(() => minUniquePrefixBits([]), /at least one digest/);
+    });
+});
+describe('encode and decode validation errors', () => {
+    const digest = sha256Hex('wh-validate:0');
+    it('rejects prefixBits that is not a positive multiple of 11', () => {
+        assert.throws(() => encode(digest, 12), /positive multiple of 11/);
+        assert.throws(() => encode(digest, 0), /positive multiple of 11/);
+        assert.throws(() => encode(digest, -11), /positive multiple of 11/);
+        assert.throws(() => encode(digest, 11.5), /positive multiple of 11/);
+    });
+    it('rejects input shorter than prefixBits bits', () => {
+        assert.throws(() => encode('abcd', 66), /supplies 16 bits/);
+        assert.throws(() => encode(new Uint8Array(8), 88, 2), /supplies 64 bits/);
+    });
+    it('rejects checksumWords outside {1, 2}', () => {
+        assert.throws(() => encode(digest, 66, 0), /checksumWords must be 1 or 2/);
+        assert.throws(() => encode(digest, 66, 3), /checksumWords must be 1 or 2/);
+        assert.throws(() => encode(digest, 66, 1.5), /checksumWords must be 1 or 2/);
+        assert.throws(() => decode(encode(digest), 3), /checksumWords must be 1 or 2/);
+    });
+    it('rejects non-hex string input', () => {
+        assert.throws(() => encode('xyz'), /non-hex characters/);
+    });
+    it('rejects word counts that leave no data words', () => {
+        assert.throws(() => decode([WORDS[0]], 1), /leaves no data words/);
+        assert.throws(() => decode([WORDS[0], WORDS[1]], 2), /leaves no data words/);
+    });
+    it('rejects profile word count mismatches', () => {
+        const words = encodeProfile(digest, 'default');
+        assert.throws(() => decodeProfile(words.slice(0, 5), 'default'), /expects 7 words, got 5/);
+    });
+});
+//# sourceMappingURL=word_handles.test.js.map

package/dist/src/v2/word_handles/__tests__/word_handles.test.js.map

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

package/dist/src/v2/word_handles/codec.d.ts

@@ -0,0 +1,54 @@
+import type { DecodeResult, WordHandleProfile, WordHandleProfileName } from './types.js';
+/** Identifier of the lexicon layout profile used by this codec. */
+export declare const LEXICON_PROFILE = "single-list-v1";
+/**
+ * Built-in word handle profiles. Word count = dataWords + checksumWords;
+ * prefixBits = 11 * dataWords.
+ *
+ *   compact:        4+1 (44 bits). Set-scoped display ONLY; render-time
+ *                   uniqueness plus lengthening is mandatory
+ *                   (minUniquePrefixBits is the tool).
+ *   default:        6+1 (66 bits). Minimum for any cross-set reference.
+ *   high_assurance: 8+2 (88 bits). Archival and adversarial contexts.
+ */
+export declare const PROFILES: Readonly<Record<WordHandleProfileName, WordHandleProfile>>;
+/**
+ * Encode the first `prefixBits` bits of `input` as a word_digest_handle:
+ * prefixBits/11 data words followed by `checksumWords` checksum words.
+ *
+ * `input` is raw bytes or a hex string; a leading "sha256:" prefix on
+ * hex input is stripped. Throws when prefixBits is not a positive
+ * multiple of 11, when the input supplies fewer than prefixBits bits,
+ * or when checksumWords is not 1 or 2.
+ */
+export declare function encode(input: Uint8Array | string, prefixBits?: number, checksumWords?: number): string[];
+/** Encode with a named profile (prefixBits and checksumWords from the table). */
+export declare function encodeProfile(input: Uint8Array | string, profile: WordHandleProfileName): string[];
+/**
+ * Decode a word_digest_handle. Never throws on unknown words (reported
+ * via `outOfLexicon`); throws when checksumWords is not 1 or 2 or when
+ * the word count leaves no data words.
+ *
+ * `prefixHex` is the full packed prefix, 2*ceil(prefixBits/8) lowercase
+ * hex characters with trailing pad bits zero; `prefixBits` is returned
+ * so consumers compare BIT-scoped, never by raw string beyond
+ * prefixBits. Localization (`failedWordIndex`) is best effort and only
+ * attempted when the checksum fails and every word is in the lexicon.
+ * See DecodeResult for the exact rules.
+ */
+export declare function decode(words: readonly string[], checksumWords?: number): DecodeResult;
+/**
+ * Decode with a named profile. Throws when the word count does not
+ * match the profile shape (dataWords + checksumWords).
+ */
+export declare function decodeProfile(words: readonly string[], profile: WordHandleProfileName): DecodeResult;
+/**
+ * Smallest multiple of 11 that is >= startBits such that the leading
+ * prefixes of all digests are pairwise BIT-distinct at that length.
+ *
+ * Hex inputs may carry "sha256:" prefixes (stripped) and are compared
+ * case-insensitively. Throws on empty input or duplicate full digests
+ * (no prefix length can separate identical digests).
+ */
+export declare function minUniquePrefixBits(digestsHex: readonly string[], startBits?: number): number;
+//# sourceMappingURL=codec.d.ts.map

package/dist/src/v2/word_handles/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../../src/v2/word_handles/codec.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAKxF,mEAAmE;AACnE,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAI/E,CAAA;AAyGD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,UAAU,GAAG,MAAM,EAC1B,UAAU,SAAK,EACf,aAAa,SAAI,GAChB,MAAM,EAAE,CAuBV;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,GAAG,MAAM,EAC1B,OAAO,EAAE,qBAAqB,GAC7B,MAAM,EAAE,CAMV;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,aAAa,SAAI,GAAG,YAAY,CAsEhF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,qBAAqB,GAC7B,YAAY,CAYd;AAsBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,SAAK,GAAG,MAAM,CAuBzF"}