SD-JWT .NET Documentation¶

A .NET ecosystem for Selective Disclosure JSON Web Tokens, verifiable credentials, wallet interoperability, and delegated agent trust. 21 NuGet packages plus an ASP.NET Core issuer reference server. 2,500+ xUnit tests. RFC 9901, OpenID4VC, SIOPv2, W3C VCDM 2.0, ISO 18013-5, eIDAS 2.0, and preview Agent Trust extensions.

The Big Picture¶

Digital credential systems have five common jobs:

1. Issue a credential into a wallet.
2. Store it safely.
3. Present only the required claims.
4. Verify the credential and holder binding.
5. Check trust, status, and policy.

SD-JWT .NET provides .NET packages for each part of that lifecycle.

flowchart LR
    Issuer["Issuer<br/>Creates credential"]
    Wallet["Wallet / Holder<br/>Stores credential"]
    Verifier["Verifier<br/>Requests proof"]
    Status["Status List<br/>Revocation / suspension"]
    Trust["Trust Layer<br/>Federation / HAIP / EUDIW"]
    Agent["Agent Runtime<br/>Preview Agent Trust"]
    Tool["Tool / API<br/>Verifies capability"]

    Issuer -->|"OID4VCI<br/>Issue"| Wallet
    Wallet -->|"OID4VP / DC API<br/>Present"| Verifier
    Verifier -->|"Check"| Status
    Verifier -->|"Resolve"| Trust
    Agent -->|"Capability SD-JWT"| Tool

Each concept page in this documentation focuses on one part of that lifecycle. If you are new to digital credentials, read the concept pages in order before diving into code.

Who this is for¶

Choose Your Path¶

I need core SD-JWT¶

• 15-Minute Quickstart
• SD-JWT
• Core Package README

I am building issuer, verifier, or wallet infrastructure¶

• Ecosystem Architecture
• OpenID4VCI
• OpenID4VP
• Presentation Exchange
• mdoc
• HAIP
• EUDIW / ARF Reference Infrastructure

I am securing AI agents or enterprise tool calls¶

• Agent Trust Profile
• Agent Trust Kits
• Agent Trust Integration Guide
• MCP Trust Demo

Why SD-JWT .NET?¶

Learning path¶

flowchart LR
    QS[Quickstart<br/>15 min] --> Tutorials[Tutorials<br/>3 weeks]
    Tutorials --> Concepts[Concepts<br/>Architecture]
    Concepts --> Guides[How-To Guides<br/>Task-oriented]
    Guides --> Reference[Reference<br/>Lookup]
    Reference --> UseCases[Use Cases<br/>Industry]

Week 1: Fundamentals¶

1. 15-Minute Quickstart - Build Issuer + Wallet + Verifier
2. Running the Samples - Explore the interactive CLI
3. SD-JWT - How selective disclosure works

Week 2: Standards & protocols¶

1. Beginner → Advanced Tutorials - 19 hands-on tutorials
2. Ecosystem Architecture - Package map and deployment patterns
3. OpenID4VCI + OpenID4VP - Issuance and presentation protocols

Week 3: Production¶

1. HAIP Profile Validation - HAIP Final flows, credential profiles, and policy enforcement
2. How-To Guides - Task-oriented implementation guides
3. Reference Patterns - Industry reference patterns and trust workflows

Documentation map¶

Ecosystem packages¶

Core¶

Protocols¶

Profiles and formats¶

Reference infrastructure¶

Agent trust¶

Enterprise planning¶

• Capability Matrix - Full feature assessment
• Enterprise Roadmap - Strategic phases and timeline
• Proposals - Design proposals for planned features

Source repository¶

This documentation is part of the SD-JWT .NET open source project, maintained under the OpenWallet Foundation Labs umbrella.

• GitHub: openwallet-foundation-labs/sd-jwt-dotnet
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• NuGet: SdJwt.Net