waltid-openid4vc-wallet-mobile/id.walt.wallet2.mobile.swiftinterop/WalletSdkBridge

WalletSdkBridge

iOS-facing bridge around MobileWallet operations.

The bridge keeps errors and results explicit for Swift callers while preserving the small cross-platform wallet API shape.

Constructors

WalletSdkBridge

constructor(wallet: MobileWallet)

Creates a bridge backed by the supplied MobileWallet.

Properties

events

val events: Flow<MobileWalletEvent>

Buffered stream of recent issuance and presentation events emitted by the bridged wallet.

Functions

beginAuthorizationIssuance

suspend fun beginAuthorizationIssuance(sessionId: String): WalletBridgeResult<WalletIssuanceAuthorization>

Starts the authorization-code browser request for an accepted issuance session.

bootstrap

suspend fun bootstrap(keyType: MobileWalletKeyType? = null, didMethod: String = "key", keyUseAuthorizationPolicy: WalletBridgeKeyUseAuthorizationPolicy? = null): WalletBridgeResult<MobileWalletBootstrapResult>

Initializes the bridged wallet and returns the persisted key and DID information.

cancelIssuance

suspend fun cancelIssuance(sessionId: String): WalletBridgeResult<WalletIssuanceOutcome>

Cancels one active issuance session and discards its continuation material.

continueAuthorizationIssuance

suspend fun continueAuthorizationIssuance(sessionId: String, callbackUri: String): WalletBridgeResult<WalletIssuanceOutcome>

Continues one authorization-code issuance session after its browser callback.

continuePreAuthorizedIssuance

suspend fun continuePreAuthorizedIssuance(sessionId: String, transactionCode: String? = null): WalletBridgeResult<WalletIssuanceOutcome>

Continues one reviewed pre-authorized issuance session.

credentials

suspend fun credentials(): WalletBridgeResult<List<MobileWalletCredential>>

Lists credential summaries stored in the bridged wallet.

deleteWallet

suspend fun deleteWallet(): WalletBridgeResult<Unit>

Deletes wallet-local state and managed persistence material.

digitalCredentialCapabilities

fun digitalCredentialCapabilities(): MobileWalletDigitalCredentialCapabilities

Returns the current iOS IdentityDocumentServices capability snapshot.

discardPresentationPreview

suspend fun discardPresentationPreview(previewHandle: MobileWalletPresentationPreviewHandle): WalletBridgeResult<Unit>

Discards one reviewed presentation locally.

keyUseAuthorizationPreflight

suspend fun keyUseAuthorizationPreflight(keyType: MobileWalletKeyType = MobileWalletKeyType.secp256r1, policy: WalletBridgeKeyUseAuthorizationPolicy = WalletBridgeKeyUseAuthorizationPolicy.BiometricCurrentSet): WalletBridgeResult<WalletBridgeKeyPreflight>

Checks whether a key-use authorization request is supported without creating a key.

present

suspend fun present(requestUrl: String, did: String? = null, runPolicies: Boolean? = null): WalletBridgeResult<MobileWalletPresentationResult>

Presents matching wallet credentials to an OpenID4VP verifier request.

previewAnnexCPresentation

suspend fun previewAnnexCPresentation(request: MobileWalletAnnexCRequest): WalletBridgeResult<MobileWalletAnnexCPreview>

Retains a parsed Annex C request for explicit native consent.

previewPresentation

suspend fun previewPresentation(requestUrl: String): WalletBridgeResult<MobileWalletPresentationPreviewResult>

Resolves and previews an OpenID4VP presentation request without submitting credentials.

rejectPresentation

suspend fun rejectPresentation(previewHandle: MobileWalletPresentationPreviewHandle, errorCode: MobileWalletPresentationErrorCode? = null, errorDescription: String? = null): WalletBridgeResult<MobileWalletPresentationResult>

Rejects one reviewed presentation and consumes its preview.

resumeDeferredIssuance

suspend fun resumeDeferredIssuance(deferredCredentialId: String): WalletBridgeResult<WalletIssuanceOutcome>

Resumes one deferred credential issuance result.

startIssuance

suspend fun startIssuance(request: MobileWalletIssuanceRequest): WalletBridgeResult<WalletIssuanceSession>

Resolves an offer and starts its bound OpenID4VCI issuance session.

submitAnnexCPresentation

suspend fun submitAnnexCPresentation(submission: MobileWalletAnnexCSubmission): WalletBridgeResult<MobileWalletDigitalCredentialResponse>

Verifies the post-consent raw request and builds the encrypted Annex C response.

submitPresentation

suspend fun submitPresentation(previewHandle: MobileWalletPresentationPreviewHandle, selectedCredentialOptions: List<MobileWalletPresentationCredentialSelection>, selectedDisclosureOptions: List<MobileWalletPresentationDisclosureSelection>? = null, did: String? = null, runPolicies: Boolean? = null): WalletBridgeResult<MobileWalletPresentationResult>

Submits a presentation using user-selected wallet credential options.