From 34af58548fffaf30725792dd337a09f125551af1 Mon Sep 17 00:00:00 2001 From: Rein Krul Date: Thu, 5 Nov 2026 08:57:25 +0100 Subject: [PATCH 1/3] docs: move JSON-LD background page to the wiki Assisted by AI --- docs/pages/integrating/vc.rst | 2 +- docs/pages/technology/jsonld.rst | 15 --------------- 2 files changed, 1 insertion(+), 16 deletions(-) delete mode 100644 docs/pages/technology/jsonld.rst diff --git a/docs/pages/integrating/vc.rst b/docs/pages/integrating/vc.rst index 9cc1dc7f33..d028d3bdb5 100644 --- a/docs/pages/integrating/vc.rst +++ b/docs/pages/integrating/vc.rst @@ -17,7 +17,7 @@ The node will add sensible defaults for: You are required to provide the ``credentialSubject``, the ``issuer``, the ``type`` and an optional ``@context`` and ``expirationDate``. If you do not pass a `@context`, it'll be set: ``["https://www.w3.org/2018/credentials/v1", "https://nuts.nl/credentials/v1"]``. Note that this default does not include the latest version of the Nuts JSON-LD context. -The latest Nuts JSON-LD context can be found :ref:`here `. +The Nuts JSON-LD contexts are listed on the `wiki `_. Calling `/internal/vcr/v2/issuer/vc` with diff --git a/docs/pages/technology/jsonld.rst b/docs/pages/technology/jsonld.rst deleted file mode 100644 index ce821b0b76..0000000000 --- a/docs/pages/technology/jsonld.rst +++ /dev/null @@ -1,15 +0,0 @@ -.. _jsonld: - -JSON-LD -####### - -`JSON Linked Data (JSON-LD) `_ is a lightweight Linked Data format. It is easy for humans to read and write. -It is based on the already successful JSON format and provides a way to help JSON data interoperate at Web-scale. -JSON-LD is an ideal data format for programming environments, REST Web services, and unstructured databases. - -Within Verifiable Credentials, JSON-LD is used to convert it to a normalized document. Normalization is required for proof generation and validation. - -Nuts Context V1 -*************** - -https://nuts.nl/credentials/v1 \ No newline at end of file From c80a06727a80c9eeb5e706bb65ef409203ddb699 Mon Sep 17 00:00:00 2001 From: Rein Krul Date: Thu, 5 Nov 2026 09:53:35 +0100 Subject: [PATCH 2/3] docs: use permanent wiki link for the JSON-LD page Assisted by AI --- docs/pages/integrating/vc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pages/integrating/vc.rst b/docs/pages/integrating/vc.rst index d028d3bdb5..92a447e035 100644 --- a/docs/pages/integrating/vc.rst +++ b/docs/pages/integrating/vc.rst @@ -17,7 +17,7 @@ The node will add sensible defaults for: You are required to provide the ``credentialSubject``, the ``issuer``, the ``type`` and an optional ``@context`` and ``expirationDate``. If you do not pass a `@context`, it'll be set: ``["https://www.w3.org/2018/credentials/v1", "https://nuts.nl/credentials/v1"]``. Note that this default does not include the latest version of the Nuts JSON-LD context. -The Nuts JSON-LD contexts are listed on the `wiki `_. +The Nuts JSON-LD contexts are listed on the `wiki `_. Calling `/internal/vcr/v2/issuer/vc` with From 47513a6003b9161bb32aac155f1a31719d81ad42 Mon Sep 17 00:00:00 2001 From: Rein Krul Date: Fri, 6 Nov 2026 14:06:47 +0100 Subject: [PATCH 3/3] docs: explain how the node uses JSON-LD contexts and list the built-in ones Assisted by AI --- docs/pages/deployment/verifiable-credentials.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/pages/deployment/verifiable-credentials.rst b/docs/pages/deployment/verifiable-credentials.rst index 866962550c..4d547af7b8 100644 --- a/docs/pages/deployment/verifiable-credentials.rst +++ b/docs/pages/deployment/verifiable-credentials.rst @@ -28,6 +28,22 @@ Or it can fetch the context definition from disk, using a mapping from url to pa The default contexts can be accessed using the embedded file system `assets/contexts`. The contents of this directory can be found on Github: The default loaded contexts can be downloaded from the `Github repo `_. +The node uses JSON-LD contexts to normalize a credential when it creates or verifies a JSON-LD proof (``ldp_vc``, ``ldp_vp``), and to search credentials (``POST /internal/vcr/v2/search``). +So the node must know every context a credential uses; otherwise it can't verify or search it. +Credentials in JWT format (``jwt_vc``) are verified without the contexts. +Context URLs are identifiers: they don't have to resolve, as long as the node has a local mapping for them. + +Built-in contexts (mapped to local files by default, see ``jsonld.contexts.localmapping``): + +- ``https://www.w3.org/2018/credentials/v1``: W3C Verifiable Credentials +- ``https://w3c-ccg.github.io/lds-jws2020/contexts/lds-jws2020-v1.json``: ``JsonWebSignature2020`` proofs +- ``https://w3id.org/vc/status-list/2021/v1``: StatusList2021 revocation +- ``https://schema.org`` +- ``https://nuts.nl/credentials/v1``: Nuts credentials such as ``NutsOrganizationCredential`` and ``NutsAuthorizationCredential`` +- ``https://nuts.nl/credentials/2024``: ``NutsUraCredential`` + +Background on JSON-LD in Nuts is on the `wiki `_. + Example configuration ^^^^^^^^^^^^^^^^^^^^^