feat: add utopia-agency-employee-badge IdentificationDocument credential by applesnort · Pull Request #144 · credential-handler/vc-examples

applesnort · 2026-06-30T22:27:52Z

Summary

Adds a Utopia Agency Employee Badge credential — a generic example of an identification document issued to a government agency's own employee.

Type: IdentificationDocumentCredential from the Identification Document vocabulary
Fields: givenName + familyName (vocab Person type), plus agency as an inline schema.org/memberOf term
Issuer: Utopia Central Records Office (a central authority issuing badges on behalf of named agencies)
Subject: Jordan Casey, Utopia Department of Parks and Recreation — deliberately a mundane, arbitrary department to keep the example generic rather than modeled on any specific real-world agency

Open questions for reviewers

Is schema.org/memberOf the right mapping for agency, or should we use schema.org/worksFor with an Organization object?
Should we add a renderMethod now or defer to a follow-up?

Test plan

Issue this credential from vc-playground
Verify it renders in Veres Wallet via the generic IdentificationDocumentCredential card design
node test/safe-mode-check.js passes (previously failed on issuer.type: ["Profile"], now removed — identification-vocab doesn't define Profile as a term, and VCDM 2.0 doesn't require issuer.type)

Simple employee badge using the identification vocab (v1rc1): givenName + familyName from the Person type, agency as an inline schema.org/memberOf term. Issued by Utopia DMV for demo purposes; ports to CHP and other CA agencies in follow-up work (DB-181). Depends on DB-724 (identification-vocab context registration in vc-playground) before this credential can be issued via the playground.

…suer.type. Was still CA/CHP-flavored despite the "Utopia" swap: issuer named "Utopia Department of Motor Vehicles" issuing a badge for "Utopia Highway Patrol" is just DMV/CHP with a fictional prefix. Replaced with a clearly generic central-issuer + arbitrary-department pattern (Utopia Central Records Office / Utopia Department of Parks and Recreation) that preserves the same field structure (a central authority issuing badges on behalf of a named agency, demonstrating the `agency`/`memberOf` mapping) without evoking any specific real-world agency. Also drops issuer.type: ["Profile"] -- fails safe-mode JSON-LD validation under the identification-vocab context (which, unlike OBv3, doesn't define Profile as a term), and VCDM 2.0 doesn't require issuer.type at all. Verified via `node test/safe-mode-check.js`.

bparth24 · 2026-07-21T17:23:10Z

@@ -0,0 +1,19 @@
+{


@applesnort cc: @BigBlueHat @jameseaster

I would suggest to follow the structure for queries.json file from existing examples in the repo

an example:

{ "default": { "type": "QueryByExample", "credentialQuery": [ { "reason": "Please present your IdentificationDocumentCredential Verifiable Credential(s) to complete the verification process.", "example": { "@context": [ "https://www.w3.org/ns/credentials/v2", "https://w3id.org/identification/v1rc1" ], "type": [ "IdentificationDocumentCredential" ] }, "acceptedCryptosuites": [ "Ed25519Signature2020", "eddsa-rdfc-2022", "ecdsa-rdfc-2019", "bbs-2023", "ecdsa-sd-2023" ] } ] } }

Add this, because you're looking for a very specific type of identification badge that specifies that the individual works for a particular agency.

"worksFor": { "id": "https://parks.utopia.example/" }

msporny · 2026-07-21T18:18:02Z

+    "type": "Person",
+    "givenName": "Jordan",
+    "familyName": "Casey",
+    "agency": "Utopia Department of Parks and Recreation"


Suggested change

"agency": "Utopia Department of Parks and Recreation"

"worksFor": {

"id": "https://parks.utopia.example/",

"name": "Utopia Department of Parks and Recreation"

}

msporny · 2026-07-21T18:18:29Z

+    {
+      "agency": "https://schema.org/memberOf"
+    }


We should not be inlining context values in long-lived examples.

msporny · 2026-07-21T18:19:12Z

+  "validFrom": "2026-01-15T00:00:00Z",
+  "validUntil": "2028-01-14T23:59:59Z",
+  "credentialSubject": {
+    "id": "urn:uuid:d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",


Suggested change

"id": "urn:uuid:d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",

Don't use unique identifiers for people unless absolutely necessary, it creates a tracking vector for the person.

msporny · 2026-07-21T18:19:51Z

+      "agency": "https://schema.org/memberOf"
+    }
+  ],
+  "id": "urn:uuid:b3d7c2e1-4f5a-6b7c-8d9e-0a1b2c3d4e5f",


Suggested change

"id": "urn:uuid:b3d7c2e1-4f5a-6b7c-8d9e-0a1b2c3d4e5f",

Not needed, either.

msporny · 2026-07-21T18:20:31Z

+  "type": ["VerifiableCredential", "IdentificationDocumentCredential"],
+  "name": "Utopia Agency Employee Badge",
+  "issuer": {
+    "id": "https://www.utopia-records.example",


Suggested change

"id": "https://www.utopia-records.example",

"id": "https://employment.utopia.example",

msporny · 2026-07-21T18:20:53Z

+  "name": "Utopia Agency Employee Badge",
+  "issuer": {
+    "id": "https://www.utopia-records.example",
+    "name": "Utopia Central Records Office"


Suggested change

"name": "Utopia Central Records Office"

"name": "Utopia Employment Agency"

Per Manu Sporny's review: replaces the inline-context `agency` term (mapped to schema.org/memberOf) with `worksFor` (an Organization-typed object with id + name) -- avoids inlining context values in a long-lived example, and models the relationship correctly per schema.org. Also drops the credential and credentialSubject unique identifiers (tracking vector for a person, not needed for this example) and renames the issuer to reflect it's specifically an employment-badge issuer, not a general records office. Restructures queries.json to match the repo's existing convention (top-level "default" key, acceptedCryptosuites list) per Parth Bhatt's review, and adds a worksFor filter to the query example so it specifically requests a badge for this agency. Depends on a companion identification-vocab PR adding worksFor to the Person context -- this repo's safe-mode-check fetches that context live, so it will show a failing check until that PR merges.

applesnort · 2026-07-21T18:50:25Z

@bparth24 @msporny pushed a commit addressing both sets of feedback:

worksFor (Organization-typed, id+name) replacing the ad-hoc inline-context agency term
Dropped the credential + credentialSubject ids (tracking vector, not needed)
Issuer renamed to reflect it's specifically an employment-badge issuer
queries.json restructured to match the repo's existing convention (default key, acceptedCryptosuites), plus a worksFor filter on the query itself

Companion PR adding worksFor to identification-vocab's Person context: digitalbazaar/identification-vocab#1 — this repo's safe-mode check fetches that context live, so it'll show red here until that one merges. Requesting review there too.

bparth24 requested review from BigBlueHat, bparth24 and jameseaster July 21, 2026 15:45

bparth24 requested changes Jul 21, 2026

View reviewed changes

msporny reviewed Jul 21, 2026

View reviewed changes

msporny approved these changes Jul 21, 2026

View reviewed changes

bparth24 approved these changes Jul 21, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add utopia-agency-employee-badge IdentificationDocument credential#144

feat: add utopia-agency-employee-badge IdentificationDocument credential#144
applesnort wants to merge 3 commits into
credential-handler:mainfrom
applesnort:feat/utopia-agency-employee-badge

applesnort commented Jun 30, 2026 •

edited

Loading

Uh oh!

bparth24 Jul 21, 2026 •

edited

Loading

Uh oh!

msporny Jul 21, 2026

Uh oh!

msporny Jul 21, 2026

Uh oh!

msporny Jul 21, 2026 •

edited

Loading

Uh oh!

msporny Jul 21, 2026 •

edited

Loading

Uh oh!

msporny Jul 21, 2026

Uh oh!

msporny Jul 21, 2026 •

edited

Loading

Uh oh!

msporny Jul 21, 2026

Uh oh!

applesnort commented Jul 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

-    "agency": "Utopia Department of Parks and Recreation"
+    "worksFor": {
+      "id": "https://parks.utopia.example/",
+      "name": "Utopia Department of Parks and Recreation"
+    }

	"id": "https://www.utopia-records.example",
	"id": "https://employment.utopia.example",

	"name": "Utopia Central Records Office"
	"name": "Utopia Employment Agency"

Uh oh!

Conversation

applesnort commented Jun 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Open questions for reviewers

Test plan

Uh oh!

bparth24 Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

msporny Jul 21, 2026

Choose a reason for hiding this comment

Uh oh!

applesnort commented Jul 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

applesnort commented Jun 30, 2026 •

edited

Loading

bparth24 Jul 21, 2026 •

edited

Loading

msporny Jul 21, 2026 •

edited

Loading

msporny Jul 21, 2026 •

edited

Loading

msporny Jul 21, 2026 •

edited

Loading