@me2em/core 0.7.0-alpha.1 → 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.
- package/README.md +242 -47
- package/dist/attestation.d.ts +26 -17
- package/dist/attestation.d.ts.map +1 -1
- package/dist/attestation.js +76 -29
- package/dist/attestation.js.map +1 -1
- package/dist/canonical-name.d.ts +18 -0
- package/dist/canonical-name.d.ts.map +1 -1
- package/dist/canonical-name.js +28 -1
- package/dist/canonical-name.js.map +1 -1
- package/dist/crypto/derivation-paths.d.ts +33 -2
- package/dist/crypto/derivation-paths.d.ts.map +1 -1
- package/dist/crypto/derivation-paths.js +33 -2
- package/dist/crypto/derivation-paths.js.map +1 -1
- package/dist/crypto/derivation.d.ts +47 -0
- package/dist/crypto/derivation.d.ts.map +1 -0
- package/dist/crypto/derivation.js +68 -0
- package/dist/crypto/derivation.js.map +1 -0
- package/dist/crypto/ecdh.d.ts +19 -0
- package/dist/crypto/ecdh.d.ts.map +1 -0
- package/dist/crypto/ecdh.js +33 -0
- package/dist/crypto/ecdh.js.map +1 -0
- package/dist/crypto/ed25519.d.ts +24 -3
- package/dist/crypto/ed25519.d.ts.map +1 -1
- package/dist/crypto/ed25519.js +39 -6
- package/dist/crypto/ed25519.js.map +1 -1
- package/dist/crypto/hkdf.d.ts +11 -2
- package/dist/crypto/hkdf.d.ts.map +1 -1
- package/dist/crypto/hkdf.js +13 -1
- package/dist/crypto/hkdf.js.map +1 -1
- package/dist/crypto/index.d.ts +25 -0
- package/dist/crypto/index.d.ts.map +1 -1
- package/dist/crypto/index.js +25 -0
- package/dist/crypto/index.js.map +1 -1
- package/dist/disposed-error.d.ts +24 -0
- package/dist/disposed-error.d.ts.map +1 -0
- package/dist/disposed-error.js +39 -0
- package/dist/disposed-error.js.map +1 -0
- package/dist/errors.d.ts +67 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +54 -0
- package/dist/errors.js.map +1 -0
- package/dist/handle.d.ts +300 -14
- package/dist/handle.d.ts.map +1 -1
- package/dist/handle.js +463 -54
- package/dist/handle.js.map +1 -1
- package/dist/identity.d.ts +55 -11
- package/dist/identity.d.ts.map +1 -1
- package/dist/identity.js +105 -35
- package/dist/identity.js.map +1 -1
- package/dist/index.d.ts +10 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -4
- package/dist/index.js.map +1 -1
- package/dist/seed.d.ts +33 -22
- package/dist/seed.d.ts.map +1 -1
- package/dist/seed.js +59 -31
- package/dist/seed.js.map +1 -1
- package/dist/session.d.ts +42 -5
- package/dist/session.d.ts.map +1 -1
- package/dist/session.js +248 -117
- package/dist/session.js.map +1 -1
- package/dist/subhandle.d.ts +1 -125
- package/dist/subhandle.d.ts.map +1 -1
- package/dist/subhandle.js +12 -179
- package/dist/subhandle.js.map +1 -1
- package/dist/types.d.ts +22 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +6 -0
- package/dist/types.js.map +1 -0
- package/dist/util.d.ts +47 -0
- package/dist/util.d.ts.map +1 -1
- package/dist/util.js +72 -20
- package/dist/util.js.map +1 -1
- package/package.json +12 -5
- package/src/attestation.ts +88 -38
- package/src/canonical-name.ts +33 -1
- package/src/crypto/derivation-paths.ts +37 -2
- package/src/crypto/derivation.ts +90 -0
- package/src/crypto/ecdh.ts +37 -0
- package/src/crypto/ed25519.ts +39 -6
- package/src/crypto/hkdf.ts +13 -1
- package/src/crypto/index.ts +28 -1
- package/src/disposed-error.ts +45 -0
- package/src/errors.ts +88 -0
- package/src/handle.ts +630 -65
- package/src/identity.ts +111 -64
- package/src/index.ts +13 -7
- package/src/seed.ts +75 -32
- package/src/session.ts +336 -132
- package/src/subhandle.ts +12 -251
- package/src/types.ts +26 -0
- package/src/util.ts +78 -20
package/dist/handle.js.map
CHANGED
|
@@ -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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"}
|
package/dist/identity.d.ts
CHANGED
|
@@ -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
|
|
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
|
|
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
|
-
*
|
|
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 {
|
|
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
|
|
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
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
* @throws {AttestationError}
|
|
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
|
package/dist/identity.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"
|
|
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 {
|
|
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]{
|
|
12
|
-
throw new
|
|
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(
|
|
15
|
-
for (let i = 0; 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
|
|
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
|
-
|
|
40
|
-
this
|
|
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
|
-
*
|
|
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 {
|
|
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
|
|
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 !==
|
|
60
|
-
throw new
|
|
67
|
+
if (seedBytes.length !== 64) {
|
|
68
|
+
throw new AttestationError('MALFORMED', 'FORMAT', 'Invalid seed: must be 64 bytes');
|
|
61
69
|
}
|
|
62
|
-
|
|
63
|
-
|
|
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
|
-
|
|
86
|
-
|
|
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
|
-
//
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
//
|
|
124
|
-
|
|
125
|
-
const
|
|
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
|
|
139
|
-
*
|
|
140
|
-
*
|
|
141
|
-
* @throws {AttestationError}
|
|
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
|
-
|
|
155
|
-
|
|
156
|
-
|
|
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
|
|
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
|
package/dist/identity.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,
|
|
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
|
|
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,12 +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
|
|
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,
|
|
36
|
+
export { generateSeedPhrase, normalizeSeedPhrase, validateSeedPhrase, get64ByteSeedFromMnemonic, type SeedStrength, type SeedValidationResult } from './seed.js';
|
|
37
|
+
export { wordlist } from '@scure/bip39/wordlists/english';
|
|
33
38
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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;
|
|
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
|
|
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,12 +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
|
|
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,
|
|
35
|
+
export { generateSeedPhrase, normalizeSeedPhrase, validateSeedPhrase, get64ByteSeedFromMnemonic } from './seed.js';
|
|
36
|
+
export { wordlist } from '@scure/bip39/wordlists/english';
|
|
33
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,
|
|
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
|
@@ -45,51 +45,62 @@ export declare function generateSeedPhrase(strength?: SeedStrength): string[];
|
|
|
45
45
|
* ```
|
|
46
46
|
*/
|
|
47
47
|
export declare function normalizeSeedPhrase(seedPhrase: string | string[]): string[];
|
|
48
|
+
export interface SeedValidationResult {
|
|
49
|
+
isValid: boolean;
|
|
50
|
+
error?: string;
|
|
51
|
+
wordCount: number;
|
|
52
|
+
invalidWords: string[];
|
|
53
|
+
}
|
|
48
54
|
/**
|
|
49
|
-
* Validates a mnemonic seed phrase against the BIP39 standard
|
|
55
|
+
* Validates a mnemonic seed phrase against the BIP39 standard with
|
|
56
|
+
* detailed feedback.
|
|
50
57
|
*
|
|
51
|
-
* Checks:
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
58
|
+
* Checks (in order):
|
|
59
|
+
* 1. Word count must be 12 or 24.
|
|
60
|
+
* 2. Each word must exist in the BIP39 English wordlist.
|
|
61
|
+
* 3. Checksum must be valid.
|
|
55
62
|
*
|
|
56
63
|
* @param words - The mnemonic phrase to validate.
|
|
57
|
-
* @returns
|
|
64
|
+
* @returns A result object with isValid, error, wordCount, and invalidWords.
|
|
58
65
|
*
|
|
59
66
|
* @example
|
|
60
67
|
* ```ts
|
|
61
68
|
* const result = validateSeedPhrase(['abandon', 'abandon', ..., 'art']);
|
|
62
|
-
* if (!result.isValid)
|
|
69
|
+
* if (!result.isValid) {
|
|
70
|
+
* console.error(result.error);
|
|
71
|
+
* console.log('Invalid words:', result.invalidWords);
|
|
72
|
+
* }
|
|
63
73
|
* ```
|
|
64
74
|
*/
|
|
65
|
-
export declare function validateSeedPhrase(words: string[]):
|
|
66
|
-
isValid: boolean;
|
|
67
|
-
error?: string;
|
|
68
|
-
};
|
|
75
|
+
export declare function validateSeedPhrase(words: string[]): SeedValidationResult;
|
|
69
76
|
/**
|
|
70
|
-
* Derives
|
|
71
|
-
*
|
|
72
|
-
*
|
|
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).
|
|
73
82
|
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
83
|
+
* Both 12-word (128-bit) and 24-word (256-bit) mnemonics produce the same
|
|
84
|
+
* 64-byte seed length, per the BIP39 standard.
|
|
76
85
|
*
|
|
77
86
|
* @param seedPhrase - The BIP39 mnemonic phrase (string or array of words).
|
|
78
87
|
* @param passphrase - Optional BIP39 passphrase ("25th word").
|
|
79
|
-
*
|
|
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)
|
|
80
91
|
* matches phrases without a passphrase. WARNING: the passphrase
|
|
81
92
|
* is NOT recoverable — a different passphrase silently derives a
|
|
82
93
|
* completely different seed with no error indication. Store it
|
|
83
94
|
* as carefully as the mnemonic itself.
|
|
84
|
-
* @returns A Promise resolving to
|
|
95
|
+
* @returns A Promise resolving to the 64-byte Uint8Array BIP39 seed.
|
|
85
96
|
*
|
|
86
97
|
* @example
|
|
87
98
|
* ```ts
|
|
88
|
-
* const seed = await
|
|
89
|
-
* // Uint8Array(
|
|
99
|
+
* const seed = await get64ByteSeedFromMnemonic('abandon abandon ... art');
|
|
100
|
+
* // Uint8Array(64) [94, 176, 187, ...]
|
|
90
101
|
*
|
|
91
|
-
* const seedWithPassphrase = await
|
|
102
|
+
* const seedWithPassphrase = await get64ByteSeedFromMnemonic(words, 'my secret 25th word');
|
|
92
103
|
* ```
|
|
93
104
|
*/
|
|
94
|
-
export declare function
|
|
105
|
+
export declare function get64ByteSeedFromMnemonic(seedPhrase: string | string[], passphrase?: string): Promise<Uint8Array>;
|
|
95
106
|
//# sourceMappingURL=seed.d.ts.map
|
package/dist/seed.d.ts.map
CHANGED
|
@@ -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,
|
|
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"}
|