@me2em/core 1.0.0-rc.3 → 1.0.0-rc.7

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 CHANGED
@@ -3,10 +3,16 @@
3
3
  Core primitives for the Me2eM authorization protocol: hierarchical
4
4
  deterministic identities (`Identity` → `Handle` → `SubHandle`), stateless
5
5
  signed sessions, and parent-signed **attestation chains** for delegatable,
6
- externally verifiable authorization — all on Ed25519.
6
+ externally verifiable authorization — all on Ed25519. Since 1.0.0-rc.3 the
7
+ package also hosts the **payment-layer contracts** — chain-agnostic
8
+ `PaymentRequest`/`PaymentResult`, `WalletAdapter`/`PaymentAdapter` with a
9
+ CAIP-2 registry, wallet binding, and the x402 v2 wire types (`payment.ts` /
10
+ `payment-x402.ts` / `wallet-binding.ts`) — while execution lives in chain
11
+ packages ([`@me2em/solana`](https://www.npmjs.com/package/@me2em/solana)) and
12
+ transport in [`@me2em/x402`](https://www.npmjs.com/package/@me2em/x402).
7
13
 
8
14
  [![npm version](https://img.shields.io/npm/v/@me2em/core.svg)](https://www.npmjs.com/package/@me2em/core)
9
- [![License](https://img.shields.io/npm/l/@me2em/core.svg)](./LICENSE)
15
+ [![License](https://img.shields.io/npm/l/@me2em/core.svg)](https://github.com/me2em-org/me2em-protocol/blob/main/LICENSE)
10
16
  [![Docs](https://img.shields.io/badge/docs-core.me2em.com-blue)](https://core.me2em.com)
11
17
 
12
18
  ## 🎯 Overview
@@ -28,6 +34,12 @@ externally verifiable authorization — all on Ed25519.
28
34
  - **UKS-Safe ECDH** — `deriveSharedSecret` binds both peers'
29
35
  public keys into the KDF (`p2p-channel/v2`), preventing
30
36
  unknown key-share attacks.
37
+ - **Payment-Layer Base** — `PaymentRequest`/`PaymentResult` with a
38
+ fail-closed reason model, `WalletAdapter`/`PaymentAdapter` contracts
39
+ and a process-wide CAIP-2 adapter registry, the default
40
+ `verifyWalletBinding` check, and the x402 v2 wire types with
41
+ structural guards (`isX402*`, `X402_VERSION = 2`). No network, no
42
+ chain code — adapters and transport are separate packages.
31
43
 
32
44
  ---
33
45
 
@@ -57,7 +69,7 @@ different lenses:
57
69
  | **E2EE Messaging** (UC-6) | The user's messaging identity | An optional device identity |
58
70
 
59
71
  Full glossary (including Channel and material-class terms):
60
- see the root [GLOSSARY.md](../../GLOSSARY.md).
72
+ see `GLOSSARY.md` in the repository.
61
73
 
62
74
  ---
63
75
 
@@ -73,11 +85,14 @@ pnpm add @me2em/core
73
85
  `@noble/hashes` (HKDF, SHA-256), `@scure/bip39` (mnemonic handling).
74
86
 
75
87
  > 💡 This package is self-contained. For E2EE channels, X3DH key
76
- > agreement, and Argon2id use [`@me2em/crypto`](../crypto/README.md).
88
+ > agreement, and Argon2id use [`@me2em/crypto`](https://www.npmjs.com/package/@me2em/crypto).
77
89
  > For React hooks and seed phrase UX components use
78
- > [`@me2em/react`](../react/README.md). The three packages are
79
- > designed to work together — see the root
80
- > [README](../../README.md) for the full package map.
90
+ > [`@me2em/react`](https://www.npmjs.com/package/@me2em/react). For the x402 v2 payment
91
+ > transport use [`@me2em/x402`](https://www.npmjs.com/package/@me2em/x402); for the Solana
92
+ > chain adapter (wallet trees, verification, pay, the x402 signer) use
93
+ > [`@me2em/solana`](https://www.npmjs.com/package/@me2em/solana). The five packages are
94
+ > designed to work together — see the
95
+ > [repository README](https://github.com/me2em-org/me2em-protocol) for the full package map.
81
96
 
82
97
  ## 🚀 Quick Start
83
98
 
@@ -283,6 +298,8 @@ class Identity {
283
298
  attestHandle(name: string, grant: AttestationGrant,
284
299
  opts?: { ttlSeconds?, expiresAt?, jti?, now? }): Promise<Attestation>;
285
300
  getPublicKey(): Uint8Array;
301
+ bindWallet(descriptor: WalletDescriptor): void; // attach a chain wallet (rc.3)
302
+ getWallet(chain: string): WalletDescriptor | null;
286
303
  dispose(): void; // zeroize key; capability methods throw DisposedError
287
304
  }
288
305
  ```
@@ -305,6 +322,8 @@ class Handle {
305
322
  attestSubHandle(subName: string, grant: AttestationGrant,
306
323
  opts?: { ttlSeconds?, expiresAt?, jti?, now? }): Promise<Attestation>;
307
324
  validateSessionOptions(options: { audience: string; scopes: string[]; ttl: number }): void;
325
+ bindWallet(descriptor: WalletDescriptor): void; // attach a chain wallet (rc.3)
326
+ getWallet(chain: string): WalletDescriptor | null; // SubHandle inherits both
308
327
  dispose(): void; // zeroize key; capability methods throw DisposedError
309
328
  }
310
329
  ```
@@ -408,6 +427,90 @@ class AttestationError extends Error {
408
427
  }
409
428
  ```
410
429
 
430
+ ### Payment layer (`payment.ts` / `payment-x402.ts` / `wallet-binding.ts`)
431
+
432
+ The chain-agnostic payment surface (landed rc.3–rc.7; execution lives in
433
+ [`@me2em/solana`](https://www.npmjs.com/package/@me2em/solana), transport in
434
+ [`@me2em/x402`](https://www.npmjs.com/package/@me2em/x402)):
435
+
436
+ ```typescript
437
+ interface PaymentRequest { // what the buyer must execute (v1.2 §3)
438
+ chain: string; // exact CAIP-2 chain id
439
+ payTo: string; // recipient address on that chain
440
+ amount: string; // decimal string in WHOLE token units
441
+ asset: string; // chain-native sentinel or token id (Solana native: 'sol')
442
+ reference: string; // 32-byte correlation key — chain-level REPLAYED detection
443
+ expiresAt: number; // unix seconds — observations after this are EXPIRED
444
+ extra?: Me2emExtra; // sellerId?, buyerId?, memo?, reference?, agreementProof?
445
+ }
446
+
447
+ type PaymentResult =
448
+ | { status: 'success'; observedAt: number }
449
+ | { status: 'failure'; reason: PaymentFailureReason; observedAt: number };
450
+
451
+ type PaymentFailureReason =
452
+ | 'NOT_FOUND' | 'UNDERPAID' | 'WRONG_RECIPIENT' | 'WRONG_ASSET'
453
+ | 'EXPIRED' | 'REPLAYED' | 'CHAIN_UNAVAILABLE' | 'REJECTED'
454
+ | 'REFERENCE_MISMATCH' // the tx exists but is not an execution of THIS request
455
+ | 'PACT_INVALID' | 'BUYER_NOT_ATTESTED' | 'SELLER_NOT_ATTESTED';
456
+ // fail-safe rule for consumers: unknown runtime values MUST be treated as 'REJECTED'
457
+
458
+ interface WalletDescriptor { // a wallet bound to an entity — never carries key material
459
+ chain: string; address: string; derivationPath?: string; label?: string;
460
+ }
461
+
462
+ interface WalletAdapter { // registered per exact CAIP-2 chain (registry key = chain)
463
+ readonly chain: string;
464
+ resolveWallet(entity: WalletEntityRef, opts?: { seed?: Uint8Array; index?: number }):
465
+ Promise<WalletDescriptor>; // deterministic adapters require opts.seed → else TypeError
466
+ isValidAddress(address: string): boolean; // structural format check only
467
+ nextIndex?(usedPaths: string[]): number; // chain-scoped allocation; core has no fallback
468
+ }
469
+
470
+ interface PaymentAdapter extends WalletAdapter {
471
+ pay(from: WalletDescriptor, request: PaymentRequest,
472
+ opts?: { seed?: Uint8Array; memo?: string }): Promise<string>; // → txRef; throws on failure
473
+ verifyPayment(txRef: string, request: PaymentRequest): Promise<PaymentResult>;
474
+ verifyWalletBinding?(wallet: WalletDescriptor, entity: WalletEntityRef,
475
+ attestation: Attestation): Promise<boolean>; // chain-specific strength
476
+ }
477
+
478
+ registerWalletAdapter(adapter: WalletAdapter): () => void; // last-wins per chain; idempotent disposer
479
+ getWalletAdapter(chain: string): WalletAdapter | null;
480
+ parseChain(chain: string): { namespace: string; reference: string } | null; // CAIP-2 grammar
481
+ isValidChain(chain: string): boolean;
482
+ ```
483
+
484
+ The x402 v2 wire types (`payment-x402.ts` — types + structural guards
485
+ only, no network; `X402_VERSION = 2`):
486
+
487
+ ```typescript
488
+ interface X402PaymentRequirements { // one payable option inside a 402 response
489
+ scheme: string; // 'exact', 'eip3009', 'permit2-exact', …
490
+ network: string; // exact CAIP-2 chain id
491
+ amount: string; // ATOMIC units — decimal string, /^[0-9]+$/
492
+ asset: string; // contract address or ISO 4217 code
493
+ payTo: string; // recipient address on network
494
+ maxTimeoutSeconds: number; // integer ≥ 1
495
+ extra?: Readonly<Record<string, unknown>>;
496
+ }
497
+ interface X402ResourceInfo { url: string; description?; mimeType?; serviceName?; tags? }
498
+ // + X402PaymentRequired / X402PaymentPayload / X402SettleResponse / X402VerifyResponse / X402Supported
499
+ isX402PaymentRequired(v) / isX402PaymentRequirements(v) / isX402PaymentPayload(v) /
500
+ isX402SettleResponse(v) / isX402VerifyResponse(v) / isX402Supported(v) // never throw
501
+ ```
502
+
503
+ Wallet binding (`wallet-binding.ts` — the default Mode-1/Mode-2 check,
504
+ v1.2 §6): three fail-closed checks, `false` on any miss, never throws:
505
+
506
+ ```typescript
507
+ verifyWalletBinding(wallet, entity, attestation, { issuerPublicKey }): Promise<boolean>
508
+ // 1. attestation signature verifies under the issuer's public key
509
+ // 2. attestation.subjectId === entity.id (subject agreement)
510
+ // 3. attestation.subjectWallet === wallet.address
511
+ // Chain adapters may add strength (Solana: on-curve check) — see @me2em/solana.
512
+ ```
513
+
411
514
  ### Name normalization
412
515
 
413
516
  All string derivation inputs are canonicalized: `NFKC → lowercase →
@@ -515,7 +618,7 @@ Redis `RevocationChecker`.
515
618
 
516
619
  **Runtimes**
517
620
 
518
- - **Node.js ≥ 22** (`engines.node`, A2 — Node 18/20 are EOL; CI pins
621
+ - **Node.js ≥ 22.6** (`engines.node`, A2 — Node 18/20 are EOL; CI pins
519
622
  Node 22).
520
623
  - Modern browsers and edge runtimes. Portability is pinned by tests:
521
624
  base64url comes from `@scure/base` — `btoa`/`atob` are banned from
@@ -540,8 +643,7 @@ Redis `RevocationChecker`.
540
643
  **Key lifecycle:** `dispose()` zeroizes the private key (`fill(0)`) and
541
644
  permanently revokes all capability methods (`DisposedError`); it is
542
645
  idempotent. Hard zeroization cannot be guaranteed in a JS runtime —
543
- GC/JIT may retain copies ([BACKLOG](../../BACKLOG.md) BL-07,
544
- [THREAT_MODEL.md](../../THREAT_MODEL.md) §5.2).
646
+ GC/JIT may retain copies (see `THREAT_MODEL.md` §5.2 in the repository).
545
647
 
546
648
  ## 🛡️ Security Best Practices
547
649
 
@@ -561,7 +663,7 @@ GC/JIT may retain copies ([BACKLOG](../../BACKLOG.md) BL-07,
561
663
  - Don't reuse Handles across unrelated contexts.
562
664
  - Don't log private keys or seed phrases.
563
665
  - Don't rely on zeroing buffers as a hard guarantee — GC/JIT may retain
564
- copies (tracked in [BACKLOG](../../BACKLOG.md) BL-07).
666
+ copies; zeroization hardening is tracked in the repository backlog.
565
667
 
566
668
  ## 🧪 Testing
567
669
 
@@ -569,31 +671,42 @@ GC/JIT may retain copies ([BACKLOG](../../BACKLOG.md) BL-07,
569
671
  cd packages/core && pnpm test
570
672
  ```
571
673
 
572
- 350 tests cover: deterministic derivation and cross-entry-point key
573
- consistency, name canonicalization, derivation revisions (r1 byte-parity,
574
- r2 independence, NFKC contexts), session lifecycle (create, verify,
575
- tamper, expiry, iat), revocation, SubHandle constraint enforcement,
576
- MAX_DEPTH leaf enforcement, attestation issue/decode/signature
577
- determinism and validation, the full `verifyAttested` chain
578
- (28 cases including nesting, wildcard permitting, revocation at every
579
- level, signature robustness, BIP39 passphrase derivation, and wordlist
580
- validation), module-structure and crypto-boundary pins, and parser fuzz
581
- (~1 050 rounds).
674
+ The test suite (447 tests) covers: deterministic derivation and
675
+ cross-entry-point key consistency, name canonicalization, derivation
676
+ revisions (r1 byte-parity, r2 independence, NFKC contexts), session
677
+ lifecycle (create, verify, tamper, expiry, iat), revocation, SubHandle
678
+ constraint enforcement, MAX_DEPTH leaf enforcement, attestation
679
+ issue/decode/signature determinism and validation, the full
680
+ `verifyAttested` chain (28 cases including nesting, wildcard permitting,
681
+ revocation at every level, signature robustness, BIP39 passphrase
682
+ derivation, and wordlist validation), module-structure and
683
+ crypto-boundary pins, and parser fuzz (~1 050 rounds) — plus the
684
+ payment surface: `PaymentRequest`/`PaymentResult` semantics, the
685
+ adapter-registry last-wins contract, CAIP-2 grammar, the `isX402*`
686
+ guards against upstream spec vectors, the `verifyWalletBinding`
687
+ fail-closed order, and `bindWallet`/`getWallet` on entities.
582
688
 
583
689
  ## 🗺️ Roadmap
584
690
 
585
- Passphrase support and `dispose()` zeroization have shipped. Remaining
586
- recommendations — session lineage (`sid`), zeroization hardening
587
- (BL-07), attestation reference compression,
588
- and the full package strategy (`@me2em/crypto`, `@me2em/messenger`,
589
- `@me2em/iot`) — live in [BACKLOG.md](../../BACKLOG.md). The backlog is
590
- advisory and not part of the shipped API contract.
591
-
592
- The public API is **frozen** as of `1.0.0-rc.1` — see
593
- [specs/v1.0.md §12](../../specs/v1.0.md) for the evolution rules.
691
+ Passphrase support and `dispose()` zeroization have shipped, and the
692
+ payment-layer surface landed additively in rc.3–rc.7 (contracts +
693
+ registry + wallet binding in rc.3, x402 wire types in rc.5, the `pay`
694
+ `opts` parameter in rc.6, the settle-response guard fix in rc.7) under
695
+ the payment-layer specification (`specs/tz-x402.md` in the repository).
696
+ Remaining recommendations — session lineage (`sid`), zeroization
697
+ hardening, attestation reference compression, and the vertical
698
+ packages (`@me2em/messenger`, `@me2em/iot`) — are tracked in the
699
+ repository backlog, which is advisory and not part of the shipped API
700
+ contract.
701
+
702
+ The identity/session public API is **frozen** as of `1.0.0-rc.1` — see
703
+ `specs/v1.0.md` §12 in the repository for the evolution rules; the
704
+ payment surface follows the same freeze discipline per its own spec
705
+ (the only post-freeze breaking change, `PaymentFailureReason` growth in
706
+ rc.5, is recorded in the CHANGELOG).
594
707
 
595
708
  ## 📜 License
596
709
 
597
- Apache License 2.0 — see [LICENSE](../../LICENSE).
710
+ Apache License 2.0.
598
711
 
599
712
  © 2026 Me2eM Organization. Built for privacy, openness, and user sovereignty.
@@ -34,6 +34,17 @@ export interface AttestationPayload {
34
34
  iat: number;
35
35
  exp: number;
36
36
  jti: string;
37
+ /**
38
+ * v1 optional extensions (specs/v1.0.md §5.1) — the canonical tail of
39
+ * the serialization order: `…, jti, subjectWallet, subjectWalletChain,
40
+ * subjectWalletPath`. Absent fields are omitted entirely (never
41
+ * `null`, never `""`); tokens without them are byte-identical to the
42
+ * pre-extension format. Pairing (address ⇔ chain, path ⇒ address) is
43
+ * enforced at issue time; decode tolerates any string values.
44
+ */
45
+ subjectWallet?: string;
46
+ subjectWalletChain?: string;
47
+ subjectWalletPath?: string;
37
48
  }
38
49
  /**
39
50
  * A parent-signed statement binding a derived child key to a name and a
@@ -134,7 +145,17 @@ export declare class Attestation {
134
145
  * @param grant - Constraints enforced by verifiers (Mode 2).
135
146
  * @param opts - Lifetime control: `ttlSeconds` (default one year),
136
147
  * `expiresAt` (overrides `ttlSeconds`), `jti` (default random UUID),
137
- * `now` (fixed clock for deterministic tests).
148
+ * `now` (fixed clock for deterministic tests). Optional wallet
149
+ * extensions (specs/v1.0.md §5.1): `subjectWallet`,
150
+ * `subjectWalletChain` (exact CAIP-2) and `subjectWalletPath` —
151
+ * emitted in that canonical order after `jti`; absent fields are
152
+ * omitted (byte-identity for tokens without them). Pairing and
153
+ * structural rules are enforced at issue time; when an adapter is
154
+ * registered for the chain, the address must pass
155
+ * `adapter.isValidAddress()` (fail-closed). `subjectWallet` is a
156
+ * property of the attested entity, not of the grant; rules 1–5 are
157
+ * enforced by `validateWalletOpts` in this module. x402 metadata
158
+ * belongs to `PaymentRequest.extra`, not here.
138
159
  * @returns The attestation with `payload`, `token` and `jti` accessors.
139
160
  * @throws {AttestationError} `MALFORMED`/`FORMAT` if the grant is
140
161
  * structurally invalid (bad scopes/TTL/audiences or a wildcard
@@ -155,6 +176,9 @@ export declare class Attestation {
155
176
  expiresAt?: number;
156
177
  jti?: string;
157
178
  now?: number;
179
+ subjectWallet?: string;
180
+ subjectWalletChain?: string;
181
+ subjectWalletPath?: string;
158
182
  }): Promise<Attestation>;
159
183
  }
160
184
  //# sourceMappingURL=attestation.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../src/attestation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjG,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAK5C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,gBAAgB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AA8DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;IAKP,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAkEhD;;;;;;;;;;;QAWI;WACU,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAc3F;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IAYlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;WACU,KAAK,CAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,UAAU,EAC5B,WAAW,EAAE,MAAM,EACnB,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;CA2ExB"}
1
+ {"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../src/attestation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjG,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAK5C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,gBAAgB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAgKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;IAKP,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAiFhD;;;;;;;;;;;QAWI;WACU,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAc3F;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO;IAYlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;WACU,KAAK,CAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,UAAU,EAC5B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACpE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACjF,GACA,OAAO,CAAC,WAAW,CAAC;CA4FxB"}
@@ -6,6 +6,7 @@ import { normalizeName } from './canonical-name.js';
6
6
  import { base64urlEncode, base64urlDecode, randomUUID, safeJsonParse } from './util.js';
7
7
  import { ed } from './crypto/init.js';
8
8
  import { AttestationError } from './errors.js';
9
+ import { getWalletAdapter, isValidChain } from './payment.js';
9
10
  export { AttestationError } from './errors.js';
10
11
  export const ATTESTATION_TYPE = 'me2em/attestation/v1';
11
12
  export const ATTESTATION_MAX_PAYLOAD = 2048;
@@ -56,6 +57,79 @@ function parseToken(token) {
56
57
  }
57
58
  return { payloadBytes, signatureBytes, payload };
58
59
  }
60
+ /**
61
+ * Validates the v1 optional wallet extensions (§5.1) passed in
62
+ * `Attestation.issue` opts. No-op when all three are absent. Order is
63
+ * normative:
64
+ *
65
+ * 1. Pairing (§5.1 rule 2) — `subjectWallet` and `subjectWalletChain`
66
+ * together or not at all (a chain without an address is invalid);
67
+ * `subjectWalletPath` only with an address. These checks PRECEDE any
68
+ * adapter lookup.
69
+ * 2. Structural (rule 4) — every present field is a non-empty string
70
+ * without any whitespace character (the full `\s` class: space, tab,
71
+ * newline, vertical tab, form feed, carriage return, NBSP and other
72
+ * Unicode space separators).
73
+ * 3. CAIP-2 grammar (rule 4) — `subjectWalletChain` via
74
+ * `isValidChain` (namespace `[-a-z0-9]{3,8}`, reference
75
+ * `[-a-zA-Z0-9]{1,64}`).
76
+ * 4. Adapter-aware, fail-closed (rule 5) — when an adapter is
77
+ * registered for the exact chain value, the address MUST pass
78
+ * `adapter.isValidAddress()`; otherwise issuance applies rules 1–3
79
+ * only (identity-only context). On-curve is deliberately not checked
80
+ * here — it belongs to wallet-binding verification.
81
+ */
82
+ function validateWalletOpts(opts) {
83
+ const { subjectWallet, subjectWalletChain, subjectWalletPath } = opts ?? {};
84
+ // 1. Pairing — before any adapter lookup: the wallet fields are issued
85
+ // in pairs (both or none), and a derivation path requires an address.
86
+ // The nested guards keep every failure message distinct and let the
87
+ // compiler narrow `subjectWallet` / `subjectWalletChain` to `string`
88
+ // for steps 2–4 (no casts).
89
+ if (subjectWallet === undefined) {
90
+ if (subjectWalletChain !== undefined) {
91
+ throwFormat('MALFORMED', 'subjectWalletChain without subjectWallet — the wallet fields are issued in pairs (both or none)');
92
+ }
93
+ if (subjectWalletPath !== undefined) {
94
+ throwFormat('MALFORMED', 'subjectWalletPath without subjectWallet — a derivation path requires an address');
95
+ }
96
+ return {};
97
+ }
98
+ if (subjectWalletChain === undefined) {
99
+ throwFormat('MALFORMED', 'subjectWallet without subjectWalletChain — the wallet fields are issued in pairs (both or none)');
100
+ }
101
+ // 2. Structural: string type, non-empty, no whitespace (full \s class).
102
+ // The wallet and chain are both present here (pairing above); the typeof
103
+ // checks stay as a fail-closed runtime defense for untyped JS callers.
104
+ const present = [
105
+ ['subjectWallet', subjectWallet],
106
+ ['subjectWalletChain', subjectWalletChain],
107
+ ];
108
+ if (subjectWalletPath !== undefined)
109
+ present.push(['subjectWalletPath', subjectWalletPath]);
110
+ for (const [field, value] of present) {
111
+ if (typeof value !== 'string') {
112
+ throwFormat('MALFORMED', `${field} must be a string`);
113
+ }
114
+ if (value.length === 0) {
115
+ throwFormat('MALFORMED', `${field} must not be empty`);
116
+ }
117
+ if (/\s/.test(value)) {
118
+ throwFormat('MALFORMED', `${field} must not contain whitespace (space, tab, newline, NBSP or any other \\s character)`);
119
+ }
120
+ }
121
+ // 3. CAIP-2 grammar for the chain (grammar lives in core — v1.2 §0.3).
122
+ if (!isValidChain(subjectWalletChain)) {
123
+ throwFormat('MALFORMED', `subjectWalletChain is not a valid CAIP-2 chain id: ${JSON.stringify(subjectWalletChain)}`);
124
+ }
125
+ // 4. Adapter-aware validation, fail-closed (§5.1 rule 5). Exact-CAIP-2
126
+ // registry lookup; without a registered adapter only rules 1–3 apply.
127
+ const adapter = getWalletAdapter(subjectWalletChain);
128
+ if (adapter !== null && !adapter.isValidAddress(subjectWallet)) {
129
+ throwFormat('MALFORMED', `subjectWallet failed adapter address validation for ${adapter.chain}`);
130
+ }
131
+ return { subjectWallet, subjectWalletChain, subjectWalletPath };
132
+ }
59
133
  /**
60
134
  * A parent-signed statement binding a derived child key to a name and a
61
135
  * grant. Chains of attestations (`Identity → Handle → SubHandle`) allow
@@ -165,6 +239,20 @@ export class Attestation {
165
239
  if (payload.jti.length > MAX_JTI_LENGTH) {
166
240
  throwFormat('MALFORMED', `jti exceeds the maximum length of ${MAX_JTI_LENGTH} characters`);
167
241
  }
242
+ // v1 optional extensions (§5.1) — decode tolerance: when present,
243
+ // the fields must be strings; pairing, grammar and on-curve checks
244
+ // are deliberately NOT repeated at decode. A verifier that does not
245
+ // implement the extension MUST NOT reject tokens carrying it — the
246
+ // fields are payload bytes covered by the signature (§4).
247
+ if (payload.subjectWallet !== undefined && typeof payload.subjectWallet !== 'string') {
248
+ throwFormat('MALFORMED', 'Invalid field: subjectWallet');
249
+ }
250
+ if (payload.subjectWalletChain !== undefined && typeof payload.subjectWalletChain !== 'string') {
251
+ throwFormat('MALFORMED', 'Invalid field: subjectWalletChain');
252
+ }
253
+ if (payload.subjectWalletPath !== undefined && typeof payload.subjectWalletPath !== 'string') {
254
+ throwFormat('MALFORMED', 'Invalid field: subjectWalletPath');
255
+ }
168
256
  return payload;
169
257
  }
170
258
  /**
@@ -244,7 +332,17 @@ export class Attestation {
244
332
  * @param grant - Constraints enforced by verifiers (Mode 2).
245
333
  * @param opts - Lifetime control: `ttlSeconds` (default one year),
246
334
  * `expiresAt` (overrides `ttlSeconds`), `jti` (default random UUID),
247
- * `now` (fixed clock for deterministic tests).
335
+ * `now` (fixed clock for deterministic tests). Optional wallet
336
+ * extensions (specs/v1.0.md §5.1): `subjectWallet`,
337
+ * `subjectWalletChain` (exact CAIP-2) and `subjectWalletPath` —
338
+ * emitted in that canonical order after `jti`; absent fields are
339
+ * omitted (byte-identity for tokens without them). Pairing and
340
+ * structural rules are enforced at issue time; when an adapter is
341
+ * registered for the chain, the address must pass
342
+ * `adapter.isValidAddress()` (fail-closed). `subjectWallet` is a
343
+ * property of the attested entity, not of the grant; rules 1–5 are
344
+ * enforced by `validateWalletOpts` in this module. x402 metadata
345
+ * belongs to `PaymentRequest.extra`, not here.
248
346
  * @returns The attestation with `payload`, `token` and `jti` accessors.
249
347
  * @throws {AttestationError} `MALFORMED`/`FORMAT` if the grant is
250
348
  * structurally invalid (bad scopes/TTL/audiences or a wildcard
@@ -296,6 +394,11 @@ export class Attestation {
296
394
  }
297
395
  }
298
396
  }
397
+ // Validate the v1 optional wallet extensions (§5.1): pairing first
398
+ // (precedes any adapter lookup), then structural checks, CAIP-2
399
+ // grammar and the fail-closed adapter check. Runs only when at
400
+ // least one wallet field is present.
401
+ const walletFields = validateWalletOpts(opts);
299
402
  const now = opts?.now ?? Math.floor(Date.now() / 1000);
300
403
  const exp = opts?.expiresAt ?? (now + (opts?.ttlSeconds ?? 31536000));
301
404
  const jti = opts?.jti ?? randomUUID();
@@ -315,6 +418,16 @@ export class Attestation {
315
418
  exp,
316
419
  jti,
317
420
  };
421
+ // Canonical tail order (§5.1 rule 1): wallet fields follow jti in
422
+ // exactly this order; absent fields are omitted entirely — tokens
423
+ // without them stay byte-identical to the pre-extension format.
424
+ if (walletFields.subjectWallet !== undefined) {
425
+ payload.subjectWallet = walletFields.subjectWallet;
426
+ payload.subjectWalletChain = walletFields.subjectWalletChain;
427
+ if (walletFields.subjectWalletPath !== undefined) {
428
+ payload.subjectWalletPath = walletFields.subjectWalletPath;
429
+ }
430
+ }
318
431
  const payloadBytes = new TextEncoder().encode(JSON.stringify(payload));
319
432
  const signature = await signer.sign(payloadBytes);
320
433
  const payloadB64 = base64urlEncode(payloadBytes);
@@ -1 +1 @@
1
- {"version":3,"file":"attestation.js","sourceRoot":"","sources":["../src/attestation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"attestation.js","sourceRoot":"","sources":["../src/attestation.ts"],"names":[],"mappings":"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"}
package/dist/handle.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { Attestation, type AttestationGrant } from './attestation.js';
2
+ import { type WalletDescriptor } from './payment.js';
2
3
  import type { Signer } from './types.js';
3
4
  import { INSPECT_SYMBOL } from './util.js';
4
5
  /**
@@ -154,6 +155,26 @@ export declare class Handle implements Signer {
154
155
  getPublicKey(): Uint8Array;
155
156
  /** @returns The derivation path, or undefined for Handle (only SubHandle has a path). */
156
157
  getPath(): string[] | undefined;
158
+ /**
159
+ * Binds a wallet to this Handle (payment layer, Документ 2 v1.2 §3).
160
+ *
161
+ * The descriptor is copied — later caller-side mutation does not
162
+ * change what was bound. Storage is in-memory (WeakMap keyed by the
163
+ * instance) and non-persistent: after a restart the binding is gone
164
+ * and the application re-binds. SubHandles inherit this method.
165
+ * Entities hold no seed and cannot derive — they only read back what
166
+ * was bound via {@link getWallet}.
167
+ *
168
+ * @throws {TypeError} If `descriptor` lacks a non-empty string
169
+ * `chain`/`address`.
170
+ */
171
+ bindWallet(descriptor: WalletDescriptor): void;
172
+ /**
173
+ * Returns the wallet bound to this Handle for the exact CAIP-2
174
+ * `chain`, or `null`. The adapter registry is not consulted — this
175
+ * reads the binding only. SubHandles inherit this method.
176
+ */
177
+ getWallet(chain: string): WalletDescriptor | null;
157
178
  /**
158
179
  * Validates session options against this Handle's constraints.
159
180
  * Handle has no constraints.
@@ -1 +1 @@
1
- {"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"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"}
package/dist/handle.js CHANGED
@@ -26,6 +26,7 @@ import { DERIVATION_PATHS } from './crypto/derivation-paths.js';
26
26
  import { Attestation } from './attestation.js';
27
27
  import { DisposedError } from './disposed-error.js';
28
28
  import { AttestationError } from './errors.js';
29
+ import { bindEntityWallet, getEntityWallet } from './payment.js';
29
30
  import { base64urlEncode, INSPECT_SYMBOL } from './util.js';
30
31
  /** Default {@link Handle.derivePassword} output length (bytes). */
31
32
  const DEFAULT_PASSWORD_BYTES = 16;
@@ -169,6 +170,30 @@ export class Handle {
169
170
  getPath() {
170
171
  return undefined;
171
172
  }
173
+ /**
174
+ * Binds a wallet to this Handle (payment layer, Документ 2 v1.2 §3).
175
+ *
176
+ * The descriptor is copied — later caller-side mutation does not
177
+ * change what was bound. Storage is in-memory (WeakMap keyed by the
178
+ * instance) and non-persistent: after a restart the binding is gone
179
+ * and the application re-binds. SubHandles inherit this method.
180
+ * Entities hold no seed and cannot derive — they only read back what
181
+ * was bound via {@link getWallet}.
182
+ *
183
+ * @throws {TypeError} If `descriptor` lacks a non-empty string
184
+ * `chain`/`address`.
185
+ */
186
+ bindWallet(descriptor) {
187
+ bindEntityWallet(this, descriptor);
188
+ }
189
+ /**
190
+ * Returns the wallet bound to this Handle for the exact CAIP-2
191
+ * `chain`, or `null`. The adapter registry is not consulted — this
192
+ * reads the binding only. SubHandles inherit this method.
193
+ */
194
+ getWallet(chain) {
195
+ return getEntityWallet(this, chain);
196
+ }
172
197
  /**
173
198
  * Validates session options against this Handle's constraints.
174
199
  * Handle has no constraints.