Skip to content

Add selective disclosure example and conversion pseudo code#624

Open
PatStLouis wants to merge 2 commits into
mainfrom
add-selective-disclosure-example
Open

Add selective disclosure example and conversion pseudo code#624
PatStLouis wants to merge 2 commits into
mainfrom
add-selective-disclosure-example

Conversation

@PatStLouis

@PatStLouis PatStLouis commented Apr 14, 2026

Copy link
Copy Markdown
Collaborator

What changes

Under Query by example, this adds a subsection (Converting QueryByExample to JSON Pointers) that explains how to turn a QueryByExample example into a list of JSON pointers for selective disclosure. It spells out the intended steps (including handling @context, mandatory VCDM pointers, credentialSubject, pruning to deepest pointers, and normalizing type pointers) and includes reference pseudo-code for the conversion and pruning logic.

Context

Review feedback already incorporated (from #572)

  • Prose: “it is necessary to …” (not “often necessary”).
  • Pseudo-code in <pre>: use &lt; for the less-than comparison so the line is not parsed as HTML in viewers that syntax-highlight the file.

Closes #545

Refs #572

Add normative-style algorithm prose and pseudo-code for converting a
QueryByExample example into JSON pointers (incl. prune and type handling).

Incorporates review feedback from #572 (msporny wording; TallTed &lt; escape).

Addresses #545
Refs #572

Signed-off-by: Patrick St-Louis <patrick.st-louis@opsecid.ca>
Made-with: Cursor
Comment thread index.html Outdated
standardized way to perform this conversion:
</p>

<ol>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be classed algorithm and use the algorithm-specific CSS used elsewhere?

@TallTed TallTed left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

Apply spec algorithm list styling (TallTed review on PR).

Signed-off-by: Patrick St-Louis <patrick.st-louis@opsecid.ca>
Made-with: Cursor
@w3cbot

w3cbot commented Apr 14, 2026

Copy link
Copy Markdown

msporny marked as non substantive for IPR from ash-nazg.

@w3cbot

w3cbot commented Apr 14, 2026

Copy link
Copy Markdown

msporny marked as substantive for IPR from ash-nazg.

Comment thread index.html
The following is a reference implementation of this algorithm:
</p>

<pre class="example" title="Algorithm to convert QueryByExample example to JSON pointers">

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

convert to an actual algorithm (normative), using the algorithm class. Avoid pseudo code in favor of a normative algorithm.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

review: https://w3c.github.io/vc-data-integrity/#add-proof for example of existing algorithms in respec

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.

Add selective disclosure example to spec w/ conversion of QueryByExample to JSON pointers

3 participants