multipaz/org.multipaz.mpzpass/MpzPass

MpzPass

data class MpzPass(val uniqueId: String = UUID.randomUUID().toString(), val version: Long = 0, val updateUrl: String? = null, val name: String? = null, val typeName: String? = null, val cardArt: ByteString? = null, val isoMdoc: List<MpzPassIsoMdoc> = emptyList(), val sdJwtVc: List<MpzPassSdJwtVc> = emptyList())

Represents a Multipaz .mpzpass credential container.

This format provides a highly portable, lightweight mechanism to exchange low-assurance verifiable credentials (such as transit passes or movie tickets) where strict hardware device-binding is unnecessary.

See this page for the definition of the Multipaz Pass file format.

Throws

IllegalArgumentException

if both isoMdoc and sdJwtVc are empty.

Constructors

MpzPass

constructor(uniqueId: String = UUID.randomUUID().toString(), version: Long = 0, updateUrl: String? = null, name: String? = null, typeName: String? = null, cardArt: ByteString? = null, isoMdoc: List<MpzPassIsoMdoc> = emptyList(), sdJwtVc: List<MpzPassSdJwtVc> = emptyList())

Types

Companion

object Companion

Properties

cardArt

val cardArt: ByteString?

The card art for the pass as a PNG ByteString.

isoMdoc

val isoMdoc: List<MpzPassIsoMdoc>

The ISO mDoc credentials in the payload.

name

val name: String?

The display name of the credential (e.g., "Erika's Driving License").

sdJwtVc

val sdJwtVc: List<MpzPassSdJwtVc>

The SD-JWT VC credentials in the payload.

typeName

val typeName: String?

The display type of the credential (e.g., "Utopia Driving License").

uniqueId

val uniqueId: String

A unique identifier for this pass, as assigned by the issuer. This should contain at least 128 bits of entropy and should only contain alphanumeric characters, hyphens, and underscores.

updateUrl

val updateUrl: String?

Optional URL which can be used to check for an update.

version

val version: Long

the version of the pass.

Functions

toDataItem

suspend fun toDataItem(compressionLevel: Int = 5): DataItem

Serializes and compresses this MpzPass into a DataItem.