miEUDIverifier.Core 1.3.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package miEUDIverifier.Core --version 1.3.0
                    
NuGet\Install-Package miEUDIverifier.Core -Version 1.3.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="miEUDIverifier.Core" Version="1.3.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="miEUDIverifier.Core" Version="1.3.0" />
                    
Directory.Packages.props
<PackageReference Include="miEUDIverifier.Core" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add miEUDIverifier.Core --version 1.3.0
                    
#r "nuget: miEUDIverifier.Core, 1.3.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package miEUDIverifier.Core@1.3.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=miEUDIverifier.Core&version=1.3.0
                    
Install as a Cake Addin
#tool nuget:?package=miEUDIverifier.Core&version=1.3.0
                    
Install as a Cake Tool

miEUDIverifier.Core

Reusable .NET 8 library to read EUDI Wallet PID identity data (family name, given name, date of birth) via the EUDI Verifier Backend REST API (OpenID4VP). It builds the DCQL request, polls for the wallet response and extracts the identity data — for both mso_mdoc (ISO/IEC 18013-5) and SD-JWT VC (dc+sd-jwt) credential formats, including SD-JWT disclosure parsing.

Part of the miEUDIverifier project (Apache-2.0), which also ships a ready-to-run web app with a browser UI, REST API and Docker image.

Install

dotnet add package miEUDIverifier.Core

Usage

// Program.cs — register via DI (reads the "VerifierSettings" configuration section)
builder.Services.AddMiEUDIverifier(builder.Configuration);

// Resolve the service and run a verification
var verifier = app.Services.GetRequiredService<VerifierApiService>();

var tx       = await verifier.InitializeTransactionAsync();
var deepLink = tx.BuildWalletDeepLink();          // openid4vp:// deep link for the wallet
var qrPng    = QrCodeService.GeneratePng(deepLink); // QR code as PNG bytes

var envelope = await verifier.WaitForWalletResponseAsync(tx.TransactionId);
var identity = await verifier.ExtractIdentityDataAsync(envelope);
// identity.FamilyName, identity.GivenName, identity.BirthDate, identity.CredentialFormat

Configuration (VerifierSettings section)

{
  "VerifierSettings": {
    "BackendUrl": "https://verifier-backend.eudiw.dev"
  }
}
Key Default Description
BackendUrl https://verifier-backend.eudiw.dev Base URL of the EUDI verifier backend (the REST API — not verifier.eudiw.dev, which serves the demo UI)
IntendedUseId TEST-01 Wallet-RP Intended Use id sent as intended_use_id. eudiw.dev requires one since August 2026; TEST-01 is its public test entry
PollIntervalSeconds 3 Polling interval for the wallet response
PollTimeoutSeconds 120 Maximum wait time for the wallet response
Profile openid4vp OpenID4VP profile (openid4vp or haip)
JarMode by_reference How the authorization request JWT is passed
RequestUriMethod post HTTP method for request_uri
ResponseMode direct_post Wallet response mode
AuthorizationRequestScheme openid4vp URI scheme for the QR-code deep link
IssuerChain (none) PEM certificate chain of the trusted PID issuer
SdJwtFormat dc+sd-jwt DCQL format id for the SD-JWT VC option
SdJwtVctValues urn:eudi:pid:1, urn:eu.europa.ec.eudi:pid:1 Accepted vct values for the SD-JWT VC PID
SessionTtlMinutes 30 Time-to-live for verification sessions in hosting apps that manage parallel sessions (e.g. the miEUDIverifier web app / REST API)

All values can be overridden via environment variables (e.g. VerifierSettings__BackendUrl=…) or CLI arguments, following standard .NET configuration binding.

What it requests

Only the PID credential with three attributes — family_name, given_name, birth_date — offered to the wallet as either mso_mdoc or dc+sd-jwt (DCQL credential_sets options). The DCQL query is built in VerifierApiService.InitializeTransactionAsync and can easily be extended with more attributes or credential types.

License

Apache-2.0 — Copyright © Wolfgang Mitterbucher.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.0 72 11/11/2026
2.0.1 77 11/11/2026
2.0.0 82 11/11/2026
1.4.3 89 11/9/2026
1.4.2 118 10/21/2026
1.4.0 102 10/19/2026
1.3.0 125 9/22/2026
1.2.0 143 8/24/2026
1.1.0 150 7/31/2026
1.0.0 155 7/2/2026

1.3.0 — Request a wider PID attribute set, and scope a request to what a Registration
Certificate covers.
New VerifierSettings.PidClaims / PidClaimsByBackend select the PID attributes to request, given in
mso_mdoc spelling; the SD-JWT VC options translate the two names that differ there (birth_date →
birthdate, nationality → nationalities). The default stays at family name, given name and birth
date, so existing configuration is unaffected.
New SdJwtOnlyBackends and TransactionOptions.SdJwtOnly mirror MdocOnly / MdocOnlyBackends for a
backend scoped to an SD-JWT VC certificate; setting both at once throws. New
SdJwtVctValuesByBackend and GermanPidVctValuesByBackend give per-backend vct lists, mirroring how
IntendedUseIds backs IntendedUseId. A blank entry drops that credential option, since .NET
configuration cannot express an empty collection through environment variables.
GermanPidVctValues now also lists urn:eudi:pid:de:1, the identifier the German developer guide
documents for the German PID; the Bundesdruckerei prototype value is kept alongside it.
IdentityData gained PlaceOfBirth, Nationality, IssuingAuthority and IssuingCountry.
SD-JWT VC disclosures are now resolved properly: an object hiding properties behind its own _sd
and an array hiding elements as {"...": digest} are both resolved recursively, matched by the
disclosure digest and honouring _sd_alg. Earlier versions only applied flat [salt, name, value]
disclosures, so a nested place of birth and the nationalities array came through as raw
placeholders. A disclosure the payload never references is still applied by name, as before.
Behaviour change worth noting: claim values that are arrays or objects are no longer dropped
silently — arrays are joined with ", " and objects kept as raw JSON, so AdditionalClaims can now
contain entries that earlier versions discarded.

1.2.0 — Fixes two defaults that made the library unusable out of the box.
BackendUrl now points at https://verifier-backend.eudiw.dev/ (the REST API). It previously
defaulted to https://verifier.eudiw.dev/, which serves the Angular demo UI and answers the API
paths with 405.
New VerifierSettings.IntendedUseId (scalar, default "TEST-01") is sent as intended_use_id when a
transaction carries none of its own — mirroring how ResponseMode backs ResponseModes. Since August
2026 eudiw.dev rejects any request without one (MissingRegistrationCertificate); TEST-01 is the
public test intended use it publishes at GET /ui/intended-uses. A per-backend IntendedUseIds entry
still wins; set IntendedUseId to "" when pointing at a backend of your own.
Both defaults only apply where nothing is configured, so existing configuration is unaffected.

1.1.0 — Multi-backend support: serve several trust ecosystems from one app.
Added VerifierSettings.Backends / DefaultBackend / MdocOnlyBackends / IntendedUseIds /
ResponseModes, the TransactionOptions type, intended_use_id on the init request, and the
German EUDI Wallet (Bundesdruckerei prototype) PID as a further SD-JWT VC option.
Note: InitializeTransactionAsync gained an optional TransactionOptions parameter ahead of
the CancellationToken. Calls passing the token by name or omitting it are unaffected;
positional InitializeTransactionAsync(ct) calls must be updated to (null, ct).