Issuer service

by walt.id

Credential issuance using the OpenID for Verifiable Credentials protocol.

Refer to the walt.id documentation for a detailed view on using the issuer service.

What it provides

• OID4VC service provider for Verifiable Credential issuance
• credential raw signing without using a credential exchange mechanism
• credential signing using an OID4VC credential exchange flow:
  • W3C format (jwt, sdjwt)
  • IEC / ISO18013-5 mdoc / mDL format

A summary of the available issuance flows and credential formats can be found in the table below:

Format		Flow
		OID4VC		raw	DIDcomm
		single	batch
w3c	jwt	✓	✓	✓	✗
	sd-jwt	✓	✗	✗	✗
mdoc		‐	‐	✗	‐

Issuer service relies on the following walt.id libraries:

• waltid-sd-jwt library for sd-jwt related processing
• waltid-openid4vc library for OID4VC interactions
• waltid-verifiable-credentials library for performing verifiable credential related tasks
• waltid-did library for DID related operations
• waltid-crypto library for key related operations

How to use it

Endpoints

• /.well-known/openid-configuration - service provider configuration
• /.well-known/openid-credential-issuer - issuer service configuration
• /raw/jwt/sign - sign a jwt-formatted w3c credential without involving an exchange flow
• /openid4vc/jwt/issue - sign a jwt-formatted w3c credential and initiate an OID4VC exchange
• /openid4vc/jwt/issueBatch - sign a list jwt-formatted w3c credentials and initiate an OID4VC exchange
• /openid4vc/sdjwt/issue- sign an sd-jwt-formatted w3c credential and initiate an OID4VC exchange
• /openid4vc/mdoc/issue - sign an IEC / ISO18013-5 mdoc / mDL credential and initiate an OID4VC exchange

Running from source

1. run the id.walt.issuer.Mainkt file
2. the issuer backend is available at: http://localhost:7002

Using docker

Run the following commands from the waltid-identity root path:

docker build -t waltid/issuer-api -f waltid-issuer-api/Dockerfile .
docker run -p 7002:7002 waltid/issuer-api --webHost=0.0.0.0 --webPort=7002 --baseUrl=http://localhost:7002