Skip to content

docs: bring LWS / CID v1 page up to date with shipped Phase A / B / 3 + NIP-98 VM upgrade #401

@melvincarvalho

Description

@melvincarvalho

docs/lws.md and the Docusaurus mirror at JavaScriptSolidServer/docs#features/lws.md are still framed around "Phase A landed, Phase B and Phase 3 forthcoming." Reality has moved on — all three are shipped, and there's a bonus path beyond the original roadmap.

Current state vs what the docs say

Level What docs say Reality
1. Profile shape ✅ since v0.0.174 unchanged
2. Profile carries keys ❌ "out of server scope, separate doctor app" ✅ doctor B.2 (Multikey/Nostr) and B.3 (JsonWebKey/ES256K) shipped at https://jss.live/doctor/
3. Server LWS-CID JWT verifier ❌ "Phase 3, JSS only knows OIDC/DPoP/NIP-98" ✅ shipped in v0.0.177 (#398), strict FPWD §4 conformance, ES256K + ES256/EdDSA/RS256
Bonus: NIP-98 → WebID via VM lookup not mentioned (didn't exist) ✅ shipped in v0.0.178 (#400) — Nostr-signed requests upgrade to the pod owner's WebID when the pubkey is declared as a CID verificationMethod

What needs updating

  • Flip the three-levels-of-compatibility table to all ✅ with the right version refs
  • Replace "Status: stub / evolving" with a confirmation block
  • Add a section on the actual auth flows users can drive today:
    • LWS10-CID JWT (ES256K with a secp256k1 / Nostr key)
    • NIP-98 (Schnorr) — automatically upgrades to WebID when the key is in the profile
    • Solid-OIDC (unchanged)
  • Add a section on the doctor (read-only diagnostic + B.2/B.3 add-keys)
  • Keep spec references and the JSS-side issue back-links

Both repos need the same update. Will be paired PRs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions