Skip to content

docs: update stale spec links and add interaction URL flow doc#13

Open
djscruggs wants to merge 9 commits into
mainfrom
docs/interaction-url-flow
Open

docs: update stale spec links and add interaction URL flow doc#13
djscruggs wants to merge 9 commits into
mainfrom
docs/interaction-url-flow

Conversation

@djscruggs
Copy link
Copy Markdown

@djscruggs djscruggs commented May 22, 2026

What

  • Update all VC Data Model links from v1/v1.1 to v2.0 (W3C Rec, May 2025)
  • Replace stale VC API links with VCALM (W3C Working Draft, May 2026), preserving section-level anchors
  • Replace standalone VPR spec links with VCALM equivalents; add superseded notice to `vpr.md`
  • Update OID4VCI and OID4VP from draft references to Final Specification 1.0
  • Fix `vc-data-integrity` editor's draft URL to W3C TR (Rec, May 2025)
  • Update BBS cryptosuite label to note Candidate Recommendation status
  • Remove stale "subject to change" warning from OID4* Integration page
  • Add `chapi/wallets/interaction-url.md`: new doc covering the QR code / interaction URL flow for native and non-browser wallets
  • Fix `iuv=1` placement per VCALM spec (it is part of the QR-encoded URL, not appended by the wallet)

Why

Several referenced specifications have advanced significantly since these docs were written. VC API has been superseded by VCALM, VPR has been folded into VCALM, and OID4VCI/OID4VP have both reached Final Specification 1.0.

Testing

  • All updated spec links resolve to the correct sections
  • Verifiable Presentation Requests (`/n/vpr/`) shows superseded notice after opening paragraph
  • OID4* Integration (`/playground/oid4/`) no longer shows the warning callout
  • Web Standards (`/standards/`) shows VCALM and updated BBS label
  • QR Code / Interaction URL Flow (`/chapi/wallets/interaction-url/`) renders correctly and appears in sidebar
  • CHAPI for Web Wallets (`/chapi/wallets/`) DID Auth resources section links to VCALM
  • CHAPI for Native Wallet (`/n/chapi/wallets/native/`) example exchange links point to VCALM
  • Handling a VC API Exchange (`/chapi/wallets/exchanges/`) links point to VCALM
  • Issue a Credential (`/playground/issue/`) OID4VCI link points to Final Spec 1.0
  • Integration Guide (`/playground/`) VC API and VPR links point to VCALM

🤖 Generated with Claude Code
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com

djscruggs and others added 3 commits May 22, 2026 14:30
- vc-data-model v1/v1.1 -> vc-data-model-2.0 (W3C Rec, May 2025)
- VC API -> VCALM W3C Working Draft with section-level anchors
- vp-request-spec -> VCALM (standalone VPR spec is superseded)
- OID4VCI ID-1/draft-13 -> Final Specification 1.0 (Sept 2025)
- OID4VP ID-2/draft-18 -> Final Specification 1.0 (July 2025)
- vc-data-integrity editor's draft -> W3C TR URL (Rec, May 2025)
- vc-di-bbs label updated to note Candidate Recommendation status
- interaction-url.md: fix iuv=1 placement per VCALM spec

Affects: index.md, chapi/index.md, chapi/issuers/index.md,
chapi/verifiers/index.md, chapi/wallets/index.md,
chapi/wallets/exchanges/index.md, chapi/wallets/native/index.md,
chapi/wallets/interaction-url.md, standards.md, vpr.md,
playground/index.md, playground/issue.md, playground/oid4.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
OID4VCI and OID4VP are now Final Specifications 1.0; the
'subject to change' notice is no longer accurate.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add ANALYSIS.md, REVIEW.md, and PLAN.md to .eleventyignore
so they do not appear in the site navigation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 22, 2026

Deploying vc-playground-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 57cb806
Status: ✅  Deploy successful!
Preview URL: https://39f2c44a.vc-playground-docs.pages.dev
Branch Preview URL: https://docs-interaction-url-flow.vc-playground-docs.pages.dev

View logs

@djscruggs djscruggs requested a review from BigBlueHat May 22, 2026 20:29
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
Comment thread chapi/wallets/interaction-url.md Outdated
djscruggs and others added 6 commits May 24, 2026 14:11
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Co-authored-by: Dave Longley <dlongley@digitalbazaar.com>
Note that if redirectUrl contains `?iuv=1` it can be treated
as another interaction URL and processed as a new exchange.

Addresses PR review comment.
@djscruggs djscruggs dismissed dlongley’s stale review May 24, 2026 19:22

All changes incorporated verbatim

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants