Iso18013ReaderQrPresentment
Performs holder-side proximity presentment using ISO/IEC 18013-5 Second Edition Reader QR engagement (clauses 9.7 and 12.2.4).
This parses the scanned mdoc:<base64url(ReaderEngagement)> uri, validates that the reader's ephemeral key curve is in supportedCurves, selects a BLE connection method according to preferredConnectionMethodOrder and bleDirectL2capEnabled, opens the BLE transport, transmits the initial unencrypted {"deviceEngagementBytes": #6.24(bstr .cbor DeviceEngagement)} message, and completes the encrypted presentment session.
Parameters
the scanned Reader QR URI ("mdoc:" followed by base64url-without-padding ReaderEngagement CBOR).
the source of truth for documents to present.
factory used to construct the selected BLE MdocTransport.
options passed to transportFactory.
optional list of connection method string prefixes (for example, "ble:direct_l2cap_central:", "ble:gatt_central:", "ble:gatt_peripheral:") specifying preference order when the reader advertises multiple BLE modes. When empty or unmatched, defaults to the first eligible method decoded from ReaderEngagement (DirectL2capCentral, GattCentral, GattPeripheral).
whether DirectL2capCentral methods offered by the reader may be selected.
ECDH curves supported for session encryption (EDeviceKey is generated on the same curve as EReaderKey).
mdoc capabilities included in DeviceEngagement.
documents preselected by the user, if any.
timeout for establishing the BLE connection to the reader, or null for no timeout.
timeout for receiving the initial encrypted DeviceRequest message after connecting.
timeout for receiving subsequent messages in multi-request sessions.
callback invoked right before opening the BLE transport connection.
callback invoked when waiting for a request message from the reader.
callback invoked when waiting for user consent, authentication, or face matching.
callback invoked with the documents currently in focus for consent.
callback invoked right before sending the encrypted DeviceResponse.
callback invoked when a verified DeviceRequest is received.
callback invoked with the final PresentmentTelemetry before returning or throwing.
Throws
if uri or ReaderEngagement is malformed or uses an unsupported curve.
if establishing the BLE connection exceeds connectionTimeout.
if user authentication failed or was canceled.
if face matching failed or was canceled.
if the user canceled in a consent prompt.
if it's not possible to satisfy the request.