The skill holder-present-credential as its source file smart-trust-tools/skills/wallet/holder-present-credential.md writes it, rendered by gen-processes-viz.ts because it has no instruction page on this site — do not edit here. All processes

Present a health credential

Skill holder-present-credential: The holder shows the one health credential a receiver asks for, as a QR: an HCERT (HC1:) on paper or in a wallet app, or a health link: the HCERT carrying a Verifiable Health Link, or a SMART Health Link (shlink:/). Input is what the holder holds and what is asked for; output is the QR shown. Performed by a person; the library has no holder-side operation.

Named by: J1 Issue the newborn’s birth-dose DVCs in Country A, J2 Discover and refer an unregistered infant in Country B, J3 Verify, import and schedule at the home clinic, J4.0 Issue the family’s records to one phone as VHLs, J4.1 Read a family member’s records at the point of care abroad

Performed by a person: the holder (IHE ITI VHL VHL Holder, smart-trust Holder), often a parent presenting a child’s records. Role vhl-holder.

Input and output

The contract is input.schema.json and output.schema.json.

  • In: the credentials held, each with the member it is about, its kind (hcert, vhl or shl), its medium (paper or wallet) and its qr text (HC1:… for an HCERT or VHL, shlink:/… for a SMART Health Link); and the request: which member, and which kind.
  • Out: the credential shown, and when it is a health link whose manifest needs a passcode (VHL, or an SHL with the P flag), that the holder must now say it (passcodeToSay).

Preconditions

The credential was issued to the holder (an HCERT by the issuing system, hcert-prefix-context; a VHL by the sharer, vhl-share; an SHL by its sharer, per the SMART Health Link specification).

What the holder does

  1. Pick the credential asked for, and only it: one member, one QR.
  2. Show the QR whole and steady (paper flat, screen bright); the receiver scans it (receiver-scan-credential).
  3. For a passcode-protected health link, say the passcode to the health worker; it is never printed beside the QR.

Success criteria

  • The receiver reads exactly the qr of the credential asked for.
  • Nothing about any other member is shown.

Input and output contracts

What this skill takes and gives, as a class diagram drawn from its JSON Schema contracts by the schemas viewer’s own renderer. Each box links to its definition; each type to its specification.

input [1..1]output [1..1]credentials [0..*]request [1..1]shown [1..1]holder-present-credential«skill»holder-present-credentialinput : HolderPresentCredentialInput [1..1]output : HolderPresentCredentialOutput [1..1]HolderPresentCredentialInput«json-schema»HolderPresentCredentialInputcredentials : HolderPresentCredentialInput.credentials[] [0..*]request : HolderPresentCredentialInput.request [1..1]HolderPresentCredentialInput.credentials«json-schema»HolderPresentCredentialInput.credentialsmember : string [1..1]kind : "hcert" | "vhl" | "shl" [1..1]medium : "paper" | "wallet" [1..1]qr : string [1..1]HolderPresentCredentialInput.request«json-schema»HolderPresentCredentialInput.requestmember : string [1..1]kind : "hcert" | "vhl" | "shl" [0..1]HolderPresentCredentialOutput«json-schema»HolderPresentCredentialOutputshown : HolderPresentCredentialOutput.shown [1..1]passcodeToSay : boolean [0..1]HolderPresentCredentialOutput.shown«json-schema»HolderPresentCredentialOutput.shownmember : string [1..1]kind : "hcert" | "vhl" | "shl" [1..1]medium : "paper" | "wallet" [1..1]qr : string [1..1]

SMART Trust demonstrator: journeys J1 to J4 — built with folio-assistant.

deployed dev