walletsdk/com.dewa.walletsdk.api.oidc.oidc4vci/ReceiveDocument

ReceiveDocument

class ReceiveDocument @Inject constructor(wallet: WalletHandle, openId4VciManagerHandle: OpenId4VciManagerHandle)

High-level helper for receiving and accepting OpenID4VCI credential offers.

Public API surface:

Uses only SDK types: WalletHandle, OpenId4VciManagerHandle, IssuedCredentialSummary, and ReceiveDocumentError.
All eu.europa.ec.eudi.* types are kept internal to the SDK implementation.

This class wraps the underlying OpenId4VciManager and wallet into two main operations:

receiveOffer – resolve a credential offer URI and return the Offer so the UI can inspect issuer, types, etc.
acceptOffer – given the same offer URI, try to issue one of the offered document types and return an IssuedCredentialSummary for the first success.

Error conditions are modeled via ReceiveDocumentError so host apps can provide stable UX without depending on EUDI error types.

Constructors

ReceiveDocument

@Inject

constructor(wallet: WalletHandle, openId4VciManagerHandle: OpenId4VciManagerHandle)

Functions

acceptOffer

suspend fun acceptOffer(uriOffer: String, txCode: String? = null): IssuedCredentialSummary

Accept a previously received offer and issue a credential.

getSupportedCredentials

suspend fun getSupportedCredentials(): List<SupportedCredential>

Fetch the issuer's advertised credential configurations (credential_configurations_supported) as SDK-native SupportedCredentials.

issueByConfigurationId

suspend fun issueByConfigurationId(configurationId: String, txCode: String? = null): IssuedCredentialSummary

Issue a credential directly by its credential configuration identifier, without a credential offer.

issueByConfigurationIds

suspend fun issueByConfigurationIds(configurationIds: List<String>, txCode: String? = null): List<IssuedCredentialSummary>

Issue several credential configurations in a single authorization-code flow (one browser round-trip). Use this to issue the PID in both formats at once (e.g. an mso_mdoc and a vc+sd-jwt configuration).

makeSummaryFromSdJwtCompat

fun makeSummaryFromSdJwtCompat(sdJwt: String, fallbackId: String): IssuedCredentialSummary

Build an IssuedCredentialSummary from an SD-JWT VC string.

receive

suspend fun receive(uriOffer: String, txCode: String? = null): IssuedCredentialSummary

Legacy combined operation: resolve + issue.

receiveOffer

suspend fun receiveOffer(uriOffer: String): Offer

Resolve a credential offer URI into an Offer.

resolveTxCodeSpec

suspend fun resolveTxCodeSpec(uriOffer: String): OfferTxCodeSpec?

Resolve an offer URI and report whether it requires a transaction code.