How eu-digital-identity-wallet/eudi-lib-jvm-sdjwt-kt works
EUDI SD-JWT is a Kotlin library for RFC 9901 selective-disclosure credentials and SD-JWT VC verification. Its main workflow defines selectively disclosable claims, issues and serializes a signed SD-JWT, then lets a holder verify it and create a claim-path-based presentation for a verifier. The library also supports claim reconstruction, definition-based credential validation, VC metadata and status checks, and issuer-key resolution. The graph uses README-described flows and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled implementation details are not inferred as certain calls.
Main entry points: SdJwtFactory.kt SD-JWT factory · NimbusSdJwtVcVerifierFactory.kt VC verifier factory · Disclosure.kt Disclosure encoding · SdJwtIssuer.kt Issuance operations
Components 26
Claim definitions
- Claim DSL
src/main/kotlin/eu/europa/ec/eudi/sdjwt/dsl/values/SdJwtElement.kt - Disclosure model
src/main/kotlin/eu/europa/ec/eudi/sdjwt/dsl/Disclosable.kt - Credential definition
src/main/kotlin/eu/europa/ec/eudi/sdjwt/dsl/def/SdJwtDefinition.kt - Definition validator
src/main/kotlin/eu/europa/ec/eudi/sdjwt/dsl/def/DefinitionBasedSdJwtVcValidator.kt
SD-JWT lifecycle
- SD-JWT factory
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtFactory.kt - Issuance operations
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtIssuer.kt - Disclosure encoding
src/main/kotlin/eu/europa/ec/eudi/sdjwt/Disclosure.kt - Disclosure digest
src/main/kotlin/eu/europa/ec/eudi/sdjwt/DisclosureDigest.kt - Decoy digests
src/main/kotlin/eu/europa/ec/eudi/sdjwt/DecoyGen.kt - Compact serialization
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtSerialization.kt - SD-JWT verification
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtVerifier.kt - Presentation selection
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtPresentationOps.kt - Claim reconstruction
src/main/kotlin/eu/europa/ec/eudi/sdjwt/RecreateClaims.kt
SD-JWT VC
- Claim paths
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/ClaimPath.kt - VC verifier factory
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/NimbusSdJwtVcVerifierFactory.kt - VC verifier
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/SdJwtVcVerifier.kt - VC JWT processor
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/SdJwtVcJwtProcessor.kt - Type metadata resolution
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/ResolveTypeMetadata.kt - Issuer metadata
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/SdJwtVcIssuerMetadata.kt - Credential status
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/Status.kt
Encoding and crypto
- Nimbus integration
src/main/kotlin/eu/europa/ec/eudi/sdjwt/NimbusIntegration.kt - Base64url codec
src/main/kotlin/eu/europa/ec/eudi/sdjwt/Base64UrlNoPadding.kt - Salt provider
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SaltProvider.kt
Other components
- Issuer
- Holder
- Verifier
Connections 33
- Issuer → Claim DSL: defines claims
README.md - Claim DSL → Issuance operations: supplies specification
README.md - Issuer → Issuance operations: issues credential
README.md - Issuance operations → SD-JWT factory: creates SD-JWT
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtIssuer.kt - SD-JWT factory → Disclosure model: folds claim model
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtFactory.kt - SD-JWT factory → Disclosure encoding: creates disclosures
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtFactory.kt - SD-JWT factory → Decoy digests: generates decoys
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtFactory.kt - Decoy digests → Salt provider: uses salt source
src/main/kotlin/eu/europa/ec/eudi/sdjwt/DecoyGen.kt - Disclosure encoding → Base64url codec: encodes payload
src/main/kotlin/eu/europa/ec/eudi/sdjwt/Disclosure.kt - Disclosure encoding → Salt provider: adds salt
src/main/kotlin/eu/europa/ec/eudi/sdjwt/Disclosure.kt - SD-JWT factory → Disclosure digest: uses digests
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtFactory.kt - Disclosure digest → Disclosure encoding: hashes disclosure
src/main/kotlin/eu/europa/ec/eudi/sdjwt/DisclosureDigest.kt - Holder → SD-JWT verification: verifies issuance
README.md - SD-JWT verification → Disclosure encoding: decodes disclosures
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtVerifier.kt - SD-JWT verification → Disclosure digest: checks digests
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtVerifier.kt - Issuance operations → Compact serialization: serializes credential
README.md - Holder → Presentation selection: selects claims
README.md - Presentation selection → Claim paths: uses paths
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtPresentationOps.kt - Presentation selection → Verifier: provides presentation
README.md - Holder → Claim reconstruction: recreates claims
README.md - Credential definition → Definition validator: validates against
src/main/kotlin/eu/europa/ec/eudi/sdjwt/dsl/def/DefinitionBasedSdJwtVcValidator.kt - Disclosure model → Credential definition: models disclosure rules
- Verifier → VC verifier factory: requests VC check
- VC verifier factory → VC verifier: constructs verifier
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/NimbusSdJwtVcVerifierFactory.kt - VC verifier factory → VC JWT processor: processes JWT
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/NimbusSdJwtVcVerifierFactory.kt - VC verifier factory → Credential status: checks status
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/NimbusSdJwtVcVerifierFactory.kt - VC verifier factory → Type metadata resolution: resolves metadata
- Type metadata resolution → Issuer metadata: reads metadata
- VC verifier → Credential status: ensures valid status
src/main/kotlin/eu/europa/ec/eudi/sdjwt/vc/SdJwtVcVerifier.kt - VC verifier → Definition validator: validates definition
- Nimbus integration → SD-JWT factory: integrates issuance
src/main/kotlin/eu/europa/ec/eudi/sdjwt/NimbusIntegration.kt - Nimbus integration → SD-JWT verification: integrates verification
src/main/kotlin/eu/europa/ec/eudi/sdjwt/NimbusIntegration.kt - Compact serialization → Disclosure digest: uses SD-JWT digest
src/main/kotlin/eu/europa/ec/eudi/sdjwt/SdJwtSerialization.kt