Find a credential schema or DCQL query
When to use
Use this skill when you must issue or verify a credential type and no
igrantio-credential-schema-* or igrantio-dcql-query-* skill covers it.
The steps below tell you where to look, in order.
Step 1: the iGrant.io verifiable data registry
The registry is the source for the template skills in this collection:
- Credential schemas (claim path pointer documents): https://github.com/decentralised-dataexchange/verifiable-data-registry/tree/main/credentialSchemas/claimPathPointer
- DCQL query templates: https://github.com/decentralised-dataexchange/verifiable-data-registry/tree/main/presentationDefinitions/dcqlQuery
Each template holds one directory per version. Take the latest version directory. It holds one schema file and one metadata file per credential format. The registry can hold templates that are newer than the skills in this collection, so check it even when a skill exists.
Step 2: the WE BUILD attestation rulebooks catalog
If the credential type is not in the iGrant.io registry, check the WE BUILD attestation rulebooks catalog:
https://github.com/webuild-consortium/webuild-attestation-rulebooks-catalog
The catalog collects attestation rulebooks for the European Business Wallet ecosystem. A rulebook defines the attestation: its attribute names, formats, and namespaces. When you find a rulebook for your credential type, build the claim path pointer document from its attribute definitions:
- One
claims[]entry per attribute. - For
mso_mdoc, the first element of eachpatharray is the namespace from the rulebook; the second is the attribute name. - For
dc+sd-jwt, thepatharray holds the claim name path and the rulebook gives thevctvalue. - Set
mandatoryandlimitDisclosureper attribute as the rulebook requires.
Then create the credential definition with the credentialDefinitions[]
approach and version: version_01. Read igrantio-api-issuer for the
operation, or igrantio-api-verifier to build the matching DCQL query.
Step 3: no rulebook exists
If neither source covers the credential type, define your own claim path pointer document with the fields above, and propose it to the registry with a pull request.
Sources are the truth
Both catalogs move faster than this skill. Always fetch the linked repositories to check for new or updated templates and rulebooks before you conclude that a schema does not exist.