light-mode-image
Learn
MATTR Pi SDKs

MATTR Pi mDocs Holder SDKs Overview

Overview

The mDocs Holder SDKs are based on the ISO/IEC 18013-5 standard which establishes an interoperable digital representation of mobile-based credentials such as mobile drivers licenses (mDL). However, these SDKs can extend the same technology and architecture to more than just mDLs, but rather any conforming mobile document (mDoc) - a term defined in ISO/IEC 18013-5.

The mDocs Holder SDKs are available for React Native, iOS, and Android. They help developers add mDocs holding features to their apps, allowing users to securely claim and present mDocs in various interoperable workflows.

To get started with any of our mDocs Holder SDKs, please contact us.

SDK Capabilities

The mDocs Holder SDKs offer tools to assist developers integrating the following capabilities into their applications:

Supported features

ISO/IEC 18013-5

Below is a summary of ISO/IEC 18013-5:2021 features supported by the mDocs Holder SDKs:

FeatureSupported optionsDefault
Device engagementQR codeQR code
Device retrieval data transportBLE with either mDocPeripheralServer or mDocCentralClient modeBLE with mDocPeripheralServer
Ephemeral session key curveAny NIST P-* keysP-256 key using secure enclave
Device authentication modeDigital Signature or ECDH-agreed MACDigital Signature with a P-256 key using secure enclave
FeatureSupported optionsDefault
Device engagementQR codeQR code
Device retrieval data transportBLE with either mDocPeripheralServer or mDocCentralClient modeBLE with mDocPeripheralServer
Ephemeral session key curveAny NIST P-* keysP-256 key using secure enclave
Device authentication modeDigital Signature or ECDH-agreed MACDigital Signature with a P-256 key using secure enclave
FeatureSupported optionsDefault
Device engagementQR codeQR code
Device retrieval data transportBLE with either mDocPeripheralServer or mDocCentralClient modeBLE with mDocPeripheralServer
Ephemeral session key curveAny NIST P-* keysP-256 key using secure enclave
Device authentication modeDigital Signature or ECDH-agreed MACDigital Signature with a P-256 key using secure enclave

ISO/IEC 18013-7

Below is a summary of ISO/IEC 18013-7:2025 features supported by the mDocs Holder SDKs:

FeatureOptions SupportedDefault Option Selected
Data Retrieval methodsOID4VPOID4VP
Wallet InvocationCustom URL and QR Code-basedBoth
MDoc Reader validationStored verifier certificates, client Metadata retrievalBoth
Authorization Response EncryptionECDH in Direct Key Agreement modeECDH in Direct Key Agreement mode
FeatureOptions SupportedDefault Option Selected
Data Retrieval methodsOID4VPOID4VP
Wallet InvocationCustom URL and QR Code-basedBoth
MDoc Reader validationStored verifier certificates, client Metadata retrievalBoth
Authorization Response EncryptionECDH in Direct Key Agreement modeECDH in Direct Key Agreement mode
FeatureOptions SupportedDefault Option Selected
Data Retrieval methodsOID4VPOID4VP
Wallet InvocationCustom URL and QR Code-basedBoth
MDoc Reader validationStored verifier certificates, client Metadata retrievalBoth
Authorization Response EncryptionECDH in Direct Key Agreement modeECDH in Direct Key Agreement mode

System requirements

The iOS mDocs Holder SDK is developed in the Swift programming language and is meant for integration into iOS applications developed in Swift and/or Objective-C. Specifically it currently only supports applications developed in iOS 15 and above.

While the SDK functionalities are only available for devices from iOS 15 and onwards, the minimum deployment target is currently set to iOS 13. This enables clients to support users up to iOS 13, as long as the SDK is not initialized.

This SDK is developed in the Kotlin programming language and is meant for integration into Android applications. It currently supports Android 7 (API level 24) and above.

This SDK is meant for integration into React Native applications using React Native 0.73 and above. Supported operating systems are:

  • iOS 15 or higher.
  • Android 7 or higher.

While the SDK functionalities are only available for devices from iOS 15 and onwards, the minimum deployment target is currently set to iOS 13. This enables clients to support users up to iOS 13, as long as the SDK is not initialized.

Dependencies

This section lists all dependencies for using mDocs Holder SDKs.

Third party dependencies

Apple Frameworks

  • Security Framework.
  • CryptoKit Framework.
  • LocalAuthentication Framework.
  • AuthenticationServices Framework.
  • CoreBluetooth Framework.
  • Combine Framework.
  • OSLog Framework.
  • UIKit Framework.
  • AppKit Framework (on macOS).

Toolchain dependencies

  • Swift 5.10.
  • iOS support:
    • The SDK functionality is only available for devices from iOS 15 onwards.
    • The minimum deployment target is set to iOS 13 so that clients can continue support end users up to iOS 13 without initializing the SDK.
  • Xcode: The SDK was built with the latest stable Xcode available in GitHub Actions (setup-xcode action with latest-stable label), and the current version is Xcode Xcode 16.3.0 (16E140).
  • macOS 15.

Standard libraries

  • androidx.core:core-ktx:1.13.1
  • androidx.appcompat:appcompat:1.7.0
  • androidx.activity:activity-ktx:1.9.0
  • androidx.fragment:fragment:1.5.4
  • androidx.annotation:annotation:1.8.0
  • androidx.biometric:biometric-ktx:1.2.0-alpha05
  • androidx.browser:browser:1.8.0
  • org.jetbrains.kotlin:kotlin-reflect:1.9.22
  • org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3
  • org.jetbrains.kotlinx:kotlinx-datetime:0.4.0
  • org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3

Third-party libraries

  • com.upokecenter:cbor:4.2.0
  • com.jakewharton.timber:timber:5.0.1
  • None.

Versions

Below are the available versions of the mDocs Holder SDKs, including the current active version, supported versions, and those that have reached end-of-life (EOL).

Major versionStatusLatest releaseEnd of Life dateDocumentation
v4Active4.2.0-rc.1-SDK Docs
v3End of Life3.0.07-10-2025-
v2End of Life2.0.026-08-2025-
v1End of Life1.0.005-05-2025-
Major versionStatusLatest releaseEnd of Life dateDocumentation
v5Active5.0.0-SDK Docs
v4Maintenance4.1.130-12-2025SDK Docs
v3End of Life3.0.07-10-2025-
v2End of Life2.0.026-08-2025-
v1End of Life1.1.005-05-2025-
Major versionStatusLatest releaseEnd of Life dateDocumentation
v8Active8.0.0-SDK Docs
v7Maintenance7.0.012-12-2025SDK Docs
v6Maintenance6.0.019-11-2025SDK Docs

Release candidates (RC) are pre-release versions that may contain new features or changes that are not yet fully tested. They are intended for testing purposes, are not subject to our SLA and should not be used in production environments.

How would you rate this page?