@me2em/core 0.7.0-alpha.2 → 1.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/README.md +179 -32
  2. package/dist/attestation.d.ts +26 -17
  3. package/dist/attestation.d.ts.map +1 -1
  4. package/dist/attestation.js +76 -29
  5. package/dist/attestation.js.map +1 -1
  6. package/dist/canonical-name.d.ts +18 -0
  7. package/dist/canonical-name.d.ts.map +1 -1
  8. package/dist/canonical-name.js +28 -1
  9. package/dist/canonical-name.js.map +1 -1
  10. package/dist/crypto/derivation-paths.d.ts +33 -2
  11. package/dist/crypto/derivation-paths.d.ts.map +1 -1
  12. package/dist/crypto/derivation-paths.js +33 -2
  13. package/dist/crypto/derivation-paths.js.map +1 -1
  14. package/dist/crypto/derivation.d.ts +47 -0
  15. package/dist/crypto/derivation.d.ts.map +1 -0
  16. package/dist/crypto/derivation.js +68 -0
  17. package/dist/crypto/derivation.js.map +1 -0
  18. package/dist/crypto/ecdh.d.ts +19 -0
  19. package/dist/crypto/ecdh.d.ts.map +1 -0
  20. package/dist/crypto/ecdh.js +33 -0
  21. package/dist/crypto/ecdh.js.map +1 -0
  22. package/dist/crypto/ed25519.d.ts +24 -3
  23. package/dist/crypto/ed25519.d.ts.map +1 -1
  24. package/dist/crypto/ed25519.js +39 -6
  25. package/dist/crypto/ed25519.js.map +1 -1
  26. package/dist/crypto/hkdf.d.ts +10 -1
  27. package/dist/crypto/hkdf.d.ts.map +1 -1
  28. package/dist/crypto/hkdf.js +10 -1
  29. package/dist/crypto/hkdf.js.map +1 -1
  30. package/dist/crypto/index.d.ts +25 -0
  31. package/dist/crypto/index.d.ts.map +1 -1
  32. package/dist/crypto/index.js +25 -0
  33. package/dist/crypto/index.js.map +1 -1
  34. package/dist/disposed-error.d.ts +24 -0
  35. package/dist/disposed-error.d.ts.map +1 -0
  36. package/dist/disposed-error.js +39 -0
  37. package/dist/disposed-error.js.map +1 -0
  38. package/dist/errors.d.ts +67 -0
  39. package/dist/errors.d.ts.map +1 -0
  40. package/dist/errors.js +54 -0
  41. package/dist/errors.js.map +1 -0
  42. package/dist/handle.d.ts +300 -14
  43. package/dist/handle.d.ts.map +1 -1
  44. package/dist/handle.js +463 -54
  45. package/dist/handle.js.map +1 -1
  46. package/dist/identity.d.ts +55 -11
  47. package/dist/identity.d.ts.map +1 -1
  48. package/dist/identity.js +105 -35
  49. package/dist/identity.js.map +1 -1
  50. package/dist/index.d.ts +9 -5
  51. package/dist/index.d.ts.map +1 -1
  52. package/dist/index.js +7 -4
  53. package/dist/index.js.map +1 -1
  54. package/dist/seed.d.ts +15 -11
  55. package/dist/seed.d.ts.map +1 -1
  56. package/dist/seed.js +23 -17
  57. package/dist/seed.js.map +1 -1
  58. package/dist/session.d.ts +42 -5
  59. package/dist/session.d.ts.map +1 -1
  60. package/dist/session.js +248 -117
  61. package/dist/session.js.map +1 -1
  62. package/dist/subhandle.d.ts +1 -125
  63. package/dist/subhandle.d.ts.map +1 -1
  64. package/dist/subhandle.js +12 -179
  65. package/dist/subhandle.js.map +1 -1
  66. package/dist/types.d.ts +22 -0
  67. package/dist/types.d.ts.map +1 -0
  68. package/dist/types.js +6 -0
  69. package/dist/types.js.map +1 -0
  70. package/dist/util.d.ts +47 -0
  71. package/dist/util.d.ts.map +1 -1
  72. package/dist/util.js +72 -20
  73. package/dist/util.js.map +1 -1
  74. package/package.json +10 -4
  75. package/src/attestation.ts +88 -38
  76. package/src/canonical-name.ts +33 -1
  77. package/src/crypto/derivation-paths.ts +37 -2
  78. package/src/crypto/derivation.ts +90 -0
  79. package/src/crypto/ecdh.ts +37 -0
  80. package/src/crypto/ed25519.ts +39 -6
  81. package/src/crypto/hkdf.ts +10 -1
  82. package/src/crypto/index.ts +28 -1
  83. package/src/disposed-error.ts +45 -0
  84. package/src/errors.ts +88 -0
  85. package/src/handle.ts +630 -65
  86. package/src/identity.ts +111 -64
  87. package/src/index.ts +10 -6
  88. package/src/seed.ts +27 -17
  89. package/src/session.ts +336 -132
  90. package/src/subhandle.ts +12 -251
  91. package/src/types.ts +26 -0
  92. package/src/util.ts +78 -20
@@ -1 +1 @@
1
- {"version":3,"file":"handle.js","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"handle.js","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,12 @@
1
1
  import { Handle, type HandleMetadata } from './handle.js';
2
2
  import { SubHandle, type SubHandleMetadata } from './subhandle.js';
3
3
  import { Attestation, type AttestationGrant } from './attestation.js';
4
+ import type { Signer } from './types.js';
5
+ import { INSPECT_SYMBOL } from './util.js';
4
6
  /**
5
7
  * Represents the root cryptographic identity derived from a seed phrase.
6
8
  *
7
- * An Identity is the foundation of the Me2em protocol. It allows for the
9
+ * An Identity is the foundation of the Me2eM protocol. It allows for the
8
10
  * hierarchical derivation of isolated {@link Handle}s and {@link SubHandle}s
9
11
  * for different contexts (e.g., email, social, specific devices) from a
10
12
  * single master seed, ensuring zero cross-contamination of cryptographic material.
@@ -17,20 +19,24 @@ import { Attestation, type AttestationGrant } from './attestation.js';
17
19
  *
18
20
  * @category Core Primitives
19
21
  */
20
- export declare class Identity {
21
- private readonly privateKey;
22
- private readonly publicKey;
22
+ export declare class Identity implements Signer {
23
+ #private;
23
24
  private constructor();
24
25
  /**
25
26
  * Initializes a new Identity from a BIP39 mnemonic seed phrase or raw seed bytes.
26
27
  *
27
- * @param seed - A 32-byte raw Uint8Array seed, or a hex-encoded string of 32 bytes.
28
+ * The seed is the full 64-byte BIP39 seed (PBKDF2-HMAC-SHA512 output,
29
+ * as produced by {@link get64ByteSeedFromMnemonic}). It is used as the
30
+ * HKDF-SHA256 input key material; HKDF info strings are unchanged.
31
+ *
32
+ * @param seed - A 64-byte raw Uint8Array seed, or a hex-encoded string of 64 bytes.
28
33
  * @returns A Promise resolving to a new Identity instance.
29
- * @throws {Error} If the provided seed is not exactly 32 bytes.
34
+ * @throws {AttestationError} `MALFORMED`/`FORMAT` if the provided seed
35
+ * is not exactly 64 bytes (or the hex string is not 128 characters).
30
36
  *
31
37
  * @example
32
38
  * ```ts
33
- * const seed = await get32ByteSeedFromMnemonic('abandon abandon ... art');
39
+ * const seed = await get64ByteSeedFromMnemonic('abandon abandon ... art');
34
40
  * const identity = await Identity.fromSeed(seed);
35
41
  * ```
36
42
  */
@@ -83,6 +89,19 @@ export declare class Identity {
83
89
  * ```
84
90
  */
85
91
  deriveSubHandle(handleName: string, subName: string, metadata?: SubHandleMetadata): Promise<SubHandle>;
92
+ /**
93
+ * Signs arbitrary data with the root private key (implements
94
+ * {@link Signer}).
95
+ *
96
+ * This is what makes an `Identity` acceptable as the `signer` argument
97
+ * of {@link Attestation.issue} — the raw private key never leaves the
98
+ * Identity.
99
+ *
100
+ * @param data - The data to be signed, as a Uint8Array.
101
+ * @returns A Promise resolving to the 64-byte Ed25519 signature.
102
+ * @throws {DisposedError} If the Identity has been disposed.
103
+ */
104
+ sign(data: Uint8Array): Promise<Uint8Array>;
86
105
  /**
87
106
  * Issues an attestation binding a derived Handle key to its name
88
107
  * and grant. The subject public key is always derived internally —
@@ -92,10 +111,11 @@ export declare class Identity {
92
111
  *
93
112
  * @param grant - Constraints verifiers will enforce for this handle
94
113
  * and (via `subNamePatterns`) for the SubHandles it may attest.
95
- * @returns An attestation signed by the Identity root key. Store it
96
- * with the Handle — it is a public artifact, not a secret.
97
- * @throws {Error} If the name is not canonicalizable.
98
- * @throws {AttestationError} If the grant is invalid.
114
+ * @returns An attestation signed by the Identity root key (the
115
+ * Identity passes itself to `Attestation.issue` as the {@link Signer}).
116
+ * Store it with the Handle — it is a public artifact, not a secret.
117
+ * @throws {AttestationError} `MALFORMED`/`FORMAT` if the name is not
118
+ * canonicalizable or the grant is invalid.
99
119
  *
100
120
  * @example
101
121
  * ```ts
@@ -116,8 +136,32 @@ export declare class Identity {
116
136
  /**
117
137
  * Retrieves the public key of the root Identity.
118
138
  *
139
+ * The returned array is a defensive copy — mutating it does not affect
140
+ * the Identity.
141
+ *
119
142
  * @returns A Uint8Array containing the 32-byte Ed25519 public key.
120
143
  */
121
144
  getPublicKey(): Uint8Array;
145
+ /**
146
+ * Permanently destroys this Identity's key material.
147
+ *
148
+ * The private key bytes are zeroized; afterwards every capability method
149
+ * ({@link sign}, {@link deriveHandle}, {@link deriveSubHandle},
150
+ * {@link attestHandle}) throws a {@link DisposedError}. Informational getters
151
+ * ({@link getPublicKey}) keep working — public keys are not secrets.
152
+ *
153
+ * Calling `dispose()` more than once is a no-op (idempotent).
154
+ */
155
+ dispose(): void;
156
+ /**
157
+ * Redacted serialization contract: `JSON.stringify(identity)` exposes
158
+ * only the object kind and the public identifier — never key material
159
+ * or seed-derived state.
160
+ */
161
+ toJSON(): {
162
+ kind: string;
163
+ id: string;
164
+ };
165
+ [INSPECT_SYMBOL](): string;
122
166
  }
123
167
  //# sourceMappingURL=identity.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAWtE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IAEvC,OAAO;IAKP;;;;;;;;;;;;OAYG;WACU,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBnE;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAa5E;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,SAAS,CAAC;IA8BrB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7E,OAAO,CAAC,WAAW,CAAC;IAYvB;;;;OAIG;IACH,YAAY,IAAI,UAAU;CAG3B"}
1
+ {"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAmB,cAAc,EAAE,MAAM,WAAW,CAAC;AAW5D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,YAAW,MAAM;;IAKrC,OAAO;IAMP;;;;;;;;;;;;;;;;;OAiBG;WACU,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcnE;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5E;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,SAAS,CAAC;IAiBrB;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAKjD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7E,OAAO,CAAC,WAAW,CAAC;IAiBvB;;;;;;;OAOG;IACH,YAAY,IAAI,UAAU;IAI1B;;;;;;;;;OASG;IACH,OAAO,IAAI,IAAI;IAWf;;;;OAIG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAItC,CAAC,cAAc,CAAC,IAAI,MAAM;CAG3B"}
package/dist/identity.js CHANGED
@@ -1,25 +1,26 @@
1
1
  // identity.ts
2
2
  import { ed } from './crypto/init.js';
3
- import { hkdf } from '@noble/hashes/hkdf.js';
4
- import { sha256 } from '@noble/hashes/sha2.js';
3
+ import { deriveRootKey, deriveHandleKey, deriveSubHandleKey } from './crypto/derivation.js';
5
4
  import { Handle } from './handle.js';
6
5
  import { SubHandle } from './subhandle.js';
7
- import { DERIVATION_PATHS } from './crypto/derivation-paths.js';
8
6
  import { normalizeName } from './canonical-name.js';
9
7
  import { Attestation } from './attestation.js';
8
+ import { DisposedError } from './disposed-error.js';
9
+ import { AttestationError } from './errors.js';
10
+ import { base64urlEncode, INSPECT_SYMBOL } from './util.js';
10
11
  function parseHexSeed(hex) {
11
- if (!/^[0-9a-fA-F]{64}$/.test(hex)) {
12
- throw new Error('Seed string must be 64 hex characters');
12
+ if (!/^[0-9a-fA-F]{128}$/.test(hex)) {
13
+ throw new AttestationError('MALFORMED', 'FORMAT', 'Seed string must be 128 hex characters');
13
14
  }
14
- const out = new Uint8Array(32);
15
- for (let i = 0; i < 32; i++)
15
+ const out = new Uint8Array(64);
16
+ for (let i = 0; i < 64; i++)
16
17
  out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
17
18
  return out;
18
19
  }
19
20
  /**
20
21
  * Represents the root cryptographic identity derived from a seed phrase.
21
22
  *
22
- * An Identity is the foundation of the Me2em protocol. It allows for the
23
+ * An Identity is the foundation of the Me2eM protocol. It allows for the
23
24
  * hierarchical derivation of isolated {@link Handle}s and {@link SubHandle}s
24
25
  * for different contexts (e.g., email, social, specific devices) from a
25
26
  * single master seed, ensuring zero cross-contamination of cryptographic material.
@@ -33,22 +34,29 @@ function parseHexSeed(hex) {
33
34
  * @category Core Primitives
34
35
  */
35
36
  export class Identity {
36
- privateKey;
37
- publicKey;
37
+ #privateKey;
38
+ #publicKey;
39
+ #disposed = false;
38
40
  constructor(privateKey) {
39
- this.privateKey = privateKey;
40
- this.publicKey = ed.getPublicKey(privateKey);
41
+ // Defensive copy: the caller keeps no reference to the stored bytes.
42
+ this.#privateKey = new Uint8Array(privateKey);
43
+ this.#publicKey = ed.getPublicKey(this.#privateKey);
41
44
  }
42
45
  /**
43
46
  * Initializes a new Identity from a BIP39 mnemonic seed phrase or raw seed bytes.
44
47
  *
45
- * @param seed - A 32-byte raw Uint8Array seed, or a hex-encoded string of 32 bytes.
48
+ * The seed is the full 64-byte BIP39 seed (PBKDF2-HMAC-SHA512 output,
49
+ * as produced by {@link get64ByteSeedFromMnemonic}). It is used as the
50
+ * HKDF-SHA256 input key material; HKDF info strings are unchanged.
51
+ *
52
+ * @param seed - A 64-byte raw Uint8Array seed, or a hex-encoded string of 64 bytes.
46
53
  * @returns A Promise resolving to a new Identity instance.
47
- * @throws {Error} If the provided seed is not exactly 32 bytes.
54
+ * @throws {AttestationError} `MALFORMED`/`FORMAT` if the provided seed
55
+ * is not exactly 64 bytes (or the hex string is not 128 characters).
48
56
  *
49
57
  * @example
50
58
  * ```ts
51
- * const seed = await get32ByteSeedFromMnemonic('abandon abandon ... art');
59
+ * const seed = await get64ByteSeedFromMnemonic('abandon abandon ... art');
52
60
  * const identity = await Identity.fromSeed(seed);
53
61
  * ```
54
62
  */
@@ -56,11 +64,12 @@ export class Identity {
56
64
  const seedBytes = typeof seed === 'string'
57
65
  ? parseHexSeed(seed)
58
66
  : seed;
59
- if (seedBytes.length !== 32) {
60
- throw new Error('Invalid seed: must be 32 bytes');
67
+ if (seedBytes.length !== 64) {
68
+ throw new AttestationError('MALFORMED', 'FORMAT', 'Invalid seed: must be 64 bytes');
61
69
  }
62
- const key = hkdf(sha256, seedBytes, new Uint8Array(0), new TextEncoder().encode(DERIVATION_PATHS.identity), 32);
63
- return new Identity(key);
70
+ // Single shared derivation (PR-10): crypto/derivation.ts is the only
71
+ // place the root key formula lives.
72
+ return new Identity(deriveRootKey(seedBytes));
64
73
  }
65
74
  /**
66
75
  * Derives a new, cryptographically isolated {@link Handle} for a specific context.
@@ -81,9 +90,11 @@ export class Identity {
81
90
  * ```
82
91
  */
83
92
  async deriveHandle(name, metadata) {
93
+ this.#assertNotDisposed();
84
94
  name = normalizeName(name);
85
- const info = new TextEncoder().encode(DERIVATION_PATHS.handle(name));
86
- const handleKey = hkdf(sha256, this.privateKey, new Uint8Array(0), info, 32);
95
+ // Single shared derivation (PR-10): same formula as fromSeed's step,
96
+ // centralized in crypto/derivation.ts.
97
+ const handleKey = deriveHandleKey(this.#privateKey, name);
87
98
  return new Handle(handleKey, name, metadata);
88
99
  }
89
100
  /**
@@ -115,17 +126,35 @@ export class Identity {
115
126
  * ```
116
127
  */
117
128
  async deriveSubHandle(handleName, subName, metadata) {
129
+ this.#assertNotDisposed();
118
130
  handleName = normalizeName(handleName);
119
131
  const subNameNorm = normalizeName(subName);
120
- // Step 1: derive the intermediate Handle key (never exposed)
121
- const handleInfo = new TextEncoder().encode(DERIVATION_PATHS.handle(handleName));
122
- const handleKey = hkdf(sha256, this.privateKey, new Uint8Array(0), handleInfo, 32);
123
- // Step 2: derive the SubHandle key from the Handle key
124
- const subInfo = new TextEncoder().encode(DERIVATION_PATHS.subhandle(handleName, subNameNorm));
125
- const subKey = hkdf(sha256, handleKey, new Uint8Array(0), subInfo, 32);
132
+ // Single shared derivations (PR-10, 5.3.3): the intermediate Handle
133
+ // key and the SubHandle key come from crypto/derivation.ts — the
134
+ // exact functions Handle.deriveSubHandle uses, so both entry points
135
+ // are byte-identical by construction (pinned by test 5.3.3 and the
136
+ // golden vectors).
137
+ const handleKey = deriveHandleKey(this.#privateKey, handleName);
138
+ const subKey = deriveSubHandleKey(handleKey, handleName, subNameNorm);
126
139
  const path = [handleName, subNameNorm];
127
140
  return new SubHandle(subKey, subNameNorm, path, metadata);
128
141
  }
142
+ /**
143
+ * Signs arbitrary data with the root private key (implements
144
+ * {@link Signer}).
145
+ *
146
+ * This is what makes an `Identity` acceptable as the `signer` argument
147
+ * of {@link Attestation.issue} — the raw private key never leaves the
148
+ * Identity.
149
+ *
150
+ * @param data - The data to be signed, as a Uint8Array.
151
+ * @returns A Promise resolving to the 64-byte Ed25519 signature.
152
+ * @throws {DisposedError} If the Identity has been disposed.
153
+ */
154
+ async sign(data) {
155
+ this.#assertNotDisposed();
156
+ return ed.sign(data, this.#privateKey);
157
+ }
129
158
  /**
130
159
  * Issues an attestation binding a derived Handle key to its name
131
160
  * and grant. The subject public key is always derived internally —
@@ -135,10 +164,11 @@ export class Identity {
135
164
  *
136
165
  * @param grant - Constraints verifiers will enforce for this handle
137
166
  * and (via `subNamePatterns`) for the SubHandles it may attest.
138
- * @returns An attestation signed by the Identity root key. Store it
139
- * with the Handle — it is a public artifact, not a secret.
140
- * @throws {Error} If the name is not canonicalizable.
141
- * @throws {AttestationError} If the grant is invalid.
167
+ * @returns An attestation signed by the Identity root key (the
168
+ * Identity passes itself to `Attestation.issue` as the {@link Signer}).
169
+ * Store it with the Handle — it is a public artifact, not a secret.
170
+ * @throws {AttestationError} `MALFORMED`/`FORMAT` if the name is not
171
+ * canonicalizable or the grant is invalid.
142
172
  *
143
173
  * @example
144
174
  * ```ts
@@ -151,17 +181,57 @@ export class Identity {
151
181
  * ```
152
182
  */
153
183
  async attestHandle(name, grant, opts) {
154
- const normalized = normalizeName(name);
155
- const handle = await this.deriveHandle(normalized);
156
- return Attestation.issue(this.privateKey, handle.getPublicKey(), normalized, grant, opts ?? {});
184
+ this.#assertNotDisposed();
185
+ // Single normalization (PR-11, 3.6): deriveHandle canonicalizes the
186
+ // name (NFKC → lowercase → trim) and the returned Handle carries the
187
+ // canonical name — pre-normalizing here ran the same name through
188
+ // normalizeName twice. Attestation.issue applies its own defensive
189
+ // canonicalization on top (its public contract).
190
+ const handle = await this.deriveHandle(name);
191
+ return Attestation.issue(this, handle.getPublicKey(), handle.getName(), grant, opts ?? {});
157
192
  }
158
193
  /**
159
194
  * Retrieves the public key of the root Identity.
160
195
  *
196
+ * The returned array is a defensive copy — mutating it does not affect
197
+ * the Identity.
198
+ *
161
199
  * @returns A Uint8Array containing the 32-byte Ed25519 public key.
162
200
  */
163
201
  getPublicKey() {
164
- return this.publicKey;
202
+ return new Uint8Array(this.#publicKey);
203
+ }
204
+ /**
205
+ * Permanently destroys this Identity's key material.
206
+ *
207
+ * The private key bytes are zeroized; afterwards every capability method
208
+ * ({@link sign}, {@link deriveHandle}, {@link deriveSubHandle},
209
+ * {@link attestHandle}) throws a {@link DisposedError}. Informational getters
210
+ * ({@link getPublicKey}) keep working — public keys are not secrets.
211
+ *
212
+ * Calling `dispose()` more than once is a no-op (idempotent).
213
+ */
214
+ dispose() {
215
+ if (this.#disposed)
216
+ return;
217
+ this.#privateKey.fill(0);
218
+ this.#privateKey = new Uint8Array(0);
219
+ this.#disposed = true;
220
+ }
221
+ #assertNotDisposed() {
222
+ if (this.#disposed)
223
+ throw new DisposedError('Identity');
224
+ }
225
+ /**
226
+ * Redacted serialization contract: `JSON.stringify(identity)` exposes
227
+ * only the object kind and the public identifier — never key material
228
+ * or seed-derived state.
229
+ */
230
+ toJSON() {
231
+ return { kind: 'Identity', id: base64urlEncode(this.#publicKey) };
232
+ }
233
+ [INSPECT_SYMBOL]() {
234
+ return `Identity(id=${base64urlEncode(this.#publicKey).slice(0, 8)}…)`;
165
235
  }
166
236
  }
167
237
  //# sourceMappingURL=identity.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,6 +1,8 @@
1
1
  export { Identity } from './identity.js';
2
- export { Handle, type HandleMetadata } from './handle.js';
2
+ export { Handle, type HandleMetadata, type DerivePasswordOptions, type DeriveChannelKeyOptions } from './handle.js';
3
3
  export { SubHandle, type SubHandleMetadata } from './subhandle.js';
4
+ export { DisposedError } from './disposed-error.js';
5
+ export type { Signer } from './types.js';
4
6
  export { Session, type SessionOptions, type SessionPayload, type RevocationChecker } from './session.js';
5
7
  export { Attestation, AttestationError, ATTESTATION_TYPE, ATTESTATION_MAX_PAYLOAD, type AttestationGrant, type AttestationPayload, type AttestationErrorCode, type AttestationLevel } from './attestation.js';
6
8
  export * as crypto from './crypto/index.js';
@@ -8,7 +10,7 @@ export * as crypto from './crypto/index.js';
8
10
  * @module @me2em/core
9
11
  * @packageDocumentation
10
12
  *
11
- * Core cryptographic primitives for the Me2em authorization protocol.
13
+ * Core cryptographic primitives for the Me2eM authorization protocol.
12
14
  *
13
15
  * This package provides the foundation for decentralized, multi-context
14
16
  * identity management and secure, stateless authentication.
@@ -22,13 +24,15 @@ export * as crypto from './crypto/index.js';
22
24
  *
23
25
  * @example Basic usage
24
26
  * ```typescript
25
- * import { Identity } from '@me2em/core';
27
+ * import { Identity, generateSeedPhrase, get64ByteSeedFromMnemonic } from '@me2em/core';
26
28
  *
27
- * const identity = await Identity.fromSeed('your twelve word mnemonic phrase here...');
29
+ * const phrase = generateSeedPhrase(128); // 12 words (256 → 24 words)
30
+ * const seed = await get64ByteSeedFromMnemonic(phrase); // 64-byte BIP39 seed
31
+ * const identity = await Identity.fromSeed(seed);
28
32
  * const handle = await identity.deriveHandle('user@example.com');
29
33
  * const signature = await handle.sign(new TextEncoder().encode('data'));
30
34
  * ```
31
35
  */
32
- export { generateSeedPhrase, normalizeSeedPhrase, validateSeedPhrase, get32ByteSeedFromMnemonic, type SeedStrength, type SeedValidationResult } from './seed.js';
36
+ export { generateSeedPhrase, normalizeSeedPhrase, validateSeedPhrase, get64ByteSeedFromMnemonic, type SeedStrength, type SeedValidationResult } from './seed.js';
33
37
  export { wordlist } from '@scure/bip39/wordlists/english';
34
38
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9M,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACpH,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9M,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC"}
package/dist/index.js CHANGED
@@ -1,6 +1,7 @@
1
1
  export { Identity } from './identity.js';
2
2
  export { Handle } from './handle.js';
3
3
  export { SubHandle } from './subhandle.js';
4
+ export { DisposedError } from './disposed-error.js';
4
5
  export { Session } from './session.js';
5
6
  export { Attestation, AttestationError, ATTESTATION_TYPE, ATTESTATION_MAX_PAYLOAD } from './attestation.js';
6
7
  export * as crypto from './crypto/index.js';
@@ -8,7 +9,7 @@ export * as crypto from './crypto/index.js';
8
9
  * @module @me2em/core
9
10
  * @packageDocumentation
10
11
  *
11
- * Core cryptographic primitives for the Me2em authorization protocol.
12
+ * Core cryptographic primitives for the Me2eM authorization protocol.
12
13
  *
13
14
  * This package provides the foundation for decentralized, multi-context
14
15
  * identity management and secure, stateless authentication.
@@ -22,13 +23,15 @@ export * as crypto from './crypto/index.js';
22
23
  *
23
24
  * @example Basic usage
24
25
  * ```typescript
25
- * import { Identity } from '@me2em/core';
26
+ * import { Identity, generateSeedPhrase, get64ByteSeedFromMnemonic } from '@me2em/core';
26
27
  *
27
- * const identity = await Identity.fromSeed('your twelve word mnemonic phrase here...');
28
+ * const phrase = generateSeedPhrase(128); // 12 words (256 → 24 words)
29
+ * const seed = await get64ByteSeedFromMnemonic(phrase); // 64-byte BIP39 seed
30
+ * const identity = await Identity.fromSeed(seed);
28
31
  * const handle = await identity.deriveHandle('user@example.com');
29
32
  * const signature = await handle.sign(new TextEncoder().encode('data'));
30
33
  * ```
31
34
  */
32
- export { generateSeedPhrase, normalizeSeedPhrase, validateSeedPhrase, get32ByteSeedFromMnemonic } from './seed.js';
35
+ export { generateSeedPhrase, normalizeSeedPhrase, validateSeedPhrase, get64ByteSeedFromMnemonic } from './seed.js';
33
36
  export { wordlist } from '@scure/bip39/wordlists/english';
34
37
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAA0B,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAoE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAoG,MAAM,kBAAkB,CAAC;AAC9M,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAiF,MAAM,aAAa,CAAC;AACpH,OAAO,EAAE,SAAS,EAA0B,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAoE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAoG,MAAM,kBAAkB,CAAC;AAC9M,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC"}
package/dist/seed.d.ts CHANGED
@@ -74,29 +74,33 @@ export interface SeedValidationResult {
74
74
  */
75
75
  export declare function validateSeedPhrase(words: string[]): SeedValidationResult;
76
76
  /**
77
- * Derives a 32-byte cryptographic seed from a BIP39 mnemonic phrase using PBKDF2.
78
- * This is the standard BIP39 derivation function that converts a human-readable
79
- * mnemonic into a binary seed suitable for Ed25519 key generation.
77
+ * Derives the 64-byte BIP39 seed from a mnemonic phrase using PBKDF2
78
+ * (PBKDF2-HMAC-SHA512, 2048 iterations, salt `"mnemonic" + passphrase`).
79
+ * This is the standard BIP39 derivation: the full 512-bit seed is returned
80
+ * unmodified and serves as the input key material for identity derivation
81
+ * ({@link Identity.fromSeed} applies HKDF-SHA256 on top).
80
82
  *
81
- * The resulting 64-byte BIP39 seed is hashed with SHA-256 to produce a
82
- * deterministic 32-byte seed, as required by Ed25519.
83
+ * Both 12-word (128-bit) and 24-word (256-bit) mnemonics produce the same
84
+ * 64-byte seed length, per the BIP39 standard.
83
85
  *
84
86
  * @param seedPhrase - The BIP39 mnemonic phrase (string or array of words).
85
87
  * @param passphrase - Optional BIP39 passphrase ("25th word").
86
- * Normalized via NFKC before use. An empty string (default)
88
+ * BIP39 NFKD normalization (mnemonic and passphrase) is performed by
89
+ * `@scure/bip39`; this function passes the passphrase through
90
+ * unchanged. An empty string (default)
87
91
  * matches phrases without a passphrase. WARNING: the passphrase
88
92
  * is NOT recoverable — a different passphrase silently derives a
89
93
  * completely different seed with no error indication. Store it
90
94
  * as carefully as the mnemonic itself.
91
- * @returns A Promise resolving to a 32-byte Uint8Array seed.
95
+ * @returns A Promise resolving to the 64-byte Uint8Array BIP39 seed.
92
96
  *
93
97
  * @example
94
98
  * ```ts
95
- * const seed = await get32ByteSeedFromMnemonic('abandon abandon ... art');
96
- * // Uint8Array(32) [123, 45, 67, ...]
99
+ * const seed = await get64ByteSeedFromMnemonic('abandon abandon ... art');
100
+ * // Uint8Array(64) [94, 176, 187, ...]
97
101
  *
98
- * const seedWithPassphrase = await get32ByteSeedFromMnemonic(words, 'my secret 25th word');
102
+ * const seedWithPassphrase = await get64ByteSeedFromMnemonic(words, 'my secret 25th word');
99
103
  * ```
100
104
  */
101
- export declare function get32ByteSeedFromMnemonic(seedPhrase: string | string[], passphrase?: string): Promise<Uint8Array>;
105
+ export declare function get64ByteSeedFromMnemonic(seedPhrase: string | string[], passphrase?: string): Promise<Uint8Array>;
102
106
  //# sourceMappingURL=seed.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,CAAC;AAErC;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,YAAkB,GAAG,MAAM,EAAE,CAMzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAK3E;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAmCxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,UAAU,CAAC,CAUrB"}
1
+ {"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,CAAC;AAErC;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,YAAkB,GAAG,MAAM,EAAE,CAUzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAK3E;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAmCxE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,UAAU,CAAC,CAYrB"}