multipaz/org.multipaz.presentment/mdocPresentment

mdocPresentment

suspend fun mdocPresentment(deviceRequest: DeviceRequest, eReaderKey: EcPublicKey?, sessionTranscript: DataItem, source: PresentmentSource, keyAgreementPossible: List<EcCurve>, requesterAppId: String?, requesterOrigin: String?, preselectedDocuments: List<Document> = emptyList(), onWaitingForUserInput: () -> Unit = {}, onDocumentsInFocus: (documents: List<Document>) -> Unit): MdocResponse

Present ISO mdoc credentials according to ISO/IEC 18013-5:2021.

Return

a MdocResponse containing DeviceResponse and EventPresentmentData.

Parameters

deviceRequest

The device request.

eReaderKey

The ephemeral reader key, if available.

sessionTranscript

the session transcript.

source

the source of truth used for presentment.

keyAgreementPossible

the list of curves for which key agreement is possible.

requesterAppId

the appId if an app is making the request or null.

requesterOrigin

the origin or null.

preselectedDocuments

the list of documents the user may have preselected earlier (for example an OS-provided credential picker like Android's Credential Manager) or the empty list if the user didn't preselect.

onWaitingForUserInput

called when waiting for input from the user (consent or authentication)

onDocumentsInFocus

called with the documents currently selected for the user, including when first shown. If the user selects a different set of documents in the prompt, this will be called again.

Throws

PresentmentCanceledException

if the user canceled in a consent prompt.

PresentmentCannotSatisfyRequestException

if it's not possible to satisfy the request.