Components

Ready-to-use React components for mDL verification.

MDLVerifier

A complete verification component that handles the entire flow including QR code display, status updates, and result handling.

AgeVerification.tsxtsx
Loading...

Props

PropTypeRequiredDescription
requestedClaimsClaimSet | string[]YesClaims to request
purposestringYesVerification purpose shown to user
mode'in_person' | 'online'NoVerification mode (default: 'in_person')
timeoutnumberNoSession timeout in ms (default: 120000)
autoStartbooleanNoAuto-start verification (default: true)
showStatusbooleanNoShow status text (default: true)
onSuccess(result) => voidYesSuccess callback
onError(error) => voidNoError callback
onCancel() => voidNoCancel callback
onStatusChange(status) => voidNoStatus change callback
classNamestringNoAdditional CSS class

MDLQRCode

A standalone QR code component for custom verification UIs. Use this when you want full control over the verification flow.

CustomQRVerification.tsxtsx
Loading...

Props

PropTypeDefaultDescription
sessionMDLSessionRequiredActive verification session
sizenumber256QR code size in pixels
errorCorrection'L' | 'M' | 'Q' | 'H''M'Error correction level
styleQRStyleOptions-QR code styling
classNamestring-Additional CSS class
altstring'Verification QR Code'Alt text for accessibility

MDLStatus

Displays the current verification session status with appropriate icons and messages.

VerificationStatus.tsxtsx
Loading...

Props

PropTypeDefaultDescription
statusSessionStatusRequiredCurrent session status
showIconbooleantrueShow status icon
showSpinnerbooleantrueShow loading spinner
messagesStatusMessagesDefault messagesCustom status messages
classNamestring-Additional CSS class

MDLResult

Displays verification results including verified claims.

VerificationResult.tsxtsx
Loading...

Props

PropTypeDefaultDescription
resultVerificationResultRequiredVerification result object
showClaimsbooleantrueShow verified claims
showIssuerInfobooleanfalseShow issuer information
showTrustScorebooleanfalseShow trust score
claimsToShowstring[]All claimsFilter which claims to display
formattersRecord<string, Function>-Custom value formatters

Complete Custom Example

FullCustomVerification.tsxtsx
Loading...