Skip to main content

Data Wallet (UI) SDKs

The following steps outline how developers can integrate Data Wallet (UI) SDKs for Android and iOS into their existing Android or iOS applications.

Step 01: Installation​

Use the following code to add depedency:

settings.gradle
repositories {
    google()
    mavenCentral()
    jcenter()
    maven {
            name = "GitHubPackages"
            url 'https://maven.pkg.github.com/L3-iGrant/ama-android-sdk'
            credentials {
                username = "L3-iGrant"
                password = <Contact to get password>
            }
        }
    maven { url 'https://igrant.io/java-packages'}
    maven { url "https://jitpack.io" }
}
settings.gradle
dependencies {
    implementation 'com.github.L3-iGrant:data_wallet:2026.8.1'
}

Additional dependencies:

settings.gradle
dependencies {
    implementation 'com.github.L3-iGrant:wallet-store:2026.8.1'
    implementation platform('com.google.firebase:firebase-bom:28.0.1')
    implementation 'com.google.firebase:firebase-dynamic-links-ktx'
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.material:material:1.3.0'
    implementation 'org.hyperledger:indy:1.16.0'
    implementation 'net.java.dev.jna:jna:5.6.0'
    implementation 'org.apache.commons:commons-lang3:3.7'
    implementation 'commons-io:commons-io:2.8.0'
    implementation('com.squareup.retrofit2:retrofit:2.7.1') {
        exclude module: 'okhttp'
    }
    implementation 'com.squareup.retrofit2:converter-gson:2.7.1'
    implementation 'com.squareup.okhttp3:okhttp:4.3.1'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.3.1'
    implementation 'com.google.code.gson:gson:2.8.6'
    implementation 'com.github.bumptech.glide:glide:4.11.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.11.0'
    implementation 'com.airbnb.android:lottie:3.5.0'
    implementation 'org.greenrobot:eventbus:3.1.1'
    annotationProcessor "org.greenrobot:eventbus-annotation-processor:3.1.1"
    implementation 'com.github.koushikcse:LoadingButton:1.7'
    implementation 'com.github.mediapark-pk:Base58-android:0.1'
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2'
    implementation 'com.tbuonomo:dotsindicator:4.2'
    implementation 'com.nimbusds:nimbus-jose-jwt:9.21'
    implementation 'androidx.preference:preference-ktx:1.2.0'
    implementation("com.github.decentralised-dataexchange:presentation-exchange-sdk-android:2024.11.1")
    implementation("co.nstant.in:cbor:0.9")
    implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3"
    implementation 'org.jetbrains.kotlin:kotlin-reflect'
    implementation 'com.madgag.spongycastle:prov:1.58.0.0'
    implementation ("com.fasterxml.jackson.dataformat:jackson-dataformat-xml:2.15.4")
    implementation ("com.fasterxml.jackson.module:jackson-module-kotlin:2.15.4")
    implementation("com.fasterxml.woodstox:woodstox-core:7.1.0")
    implementation ("javax.xml.stream:stax-api:1.0-2")
    implementation ("com.hbb20:ccp:2.5.1")
    implementation("com.jayway.jsonpath:json-path:2.9.0")
    implementation 'com.github.decentralised-dataexchange:PassCodeText:2024.10.1'
    implementation "androidx.lifecycle:lifecycle-process:2.6.2"
    implementation 'com.github.decentralised-dataexchange:eudi-wallet-oid4vc-android:2025.10.1'
    implementation 'com.squareup.retrofit2:converter-scalars:2.9.0'
    implementation 'com.github.amoskorir:avatarimagegenerator:1.5.0'
}

If you encounter SLF4J version conflicts or Duplicate class org.slf4j errors during the build, add the following configuration block to your root-level build.gradle file:

configurations.all {
    exclude group: 'org.slf4j', module: 'slf4j-api'

    resolutionStrategy {
        force 'org.slf4j:slf4j-api:2.0.9'
    }
}

Step 02: Initialise Data Wallet​

MyActivity.kt
DataWallet.initializeSdk(
    this,
    object : InitializeWalletCallback {
        override fun progressUpdate(progress: Int) {
            when (progress) {
                InitializeWalletState.INITIALIZE_WALLET_STARTED -> {}
                InitializeWalletState.INITIALIZE_WALLET_EXTERNAL_FILES_LOADED -> {}
                InitializeWalletState.WALLET_OPENED -> {
                    // Wallet is ready. Register a notification listener here if needed —
                    // see "Subscribe To Notifications" below.
                }
            }
        }
    },
    viewMode = ViewMode.BottomSheet
)

Supported Wallet Functions​

Show Wallet UI​

This function presents the data wallet's home view. The wallet home provides a user interface for managing wallet contents, accessing shared data, and performing wallet-related operations.

MyActivity.kt
DataWallet.showWallet(this)

Show Connections UI​

This function presents the connections view of the data wallet. This view displays the list of established connections, allowing users to manage their connections, view connection details, and perform connection-related actions.

MyActivity.kt
DataWallet.showConnections(this)

Show Notifications UI​

This function presents the data wallet's notifications views. This view provides a user interface for managing wallet notifications, such as receiving and viewing notifications related to data sharing or wallet updates.

MyActivity.kt
DataWallet.showNotifications(this)

Show MySharedData UI​

This function presents the share data history view of the data wallet. The share data history view displays a log of all the shared data, allowing the user to view the details of each shared item and manage data-sharing permissions.

MyActivity.kt
DataWallet.showMySharedData(this)

Show DataAgreementPolicy UI​

This function enables your application, integrated with the wallet, to retrieve data agreements associated with a specific organisation. By passing the required parameters such as api_key, organization_id, and agreement_id, along with a context (this), the function securely fetches the details of the specified agreement. This capability is essential for managing data consents and agreements programmatically, ensuring that your application adheres to specified data use policies and user consents.

MyActivity.kt
DataAgreementUtils.fetchDataAgreement(
    "api_key",
    "organization_id",
    "agreement_id",
    this
)

Delete Data Wallet​

MyActivity.kt
DataWallet.deleteWallet(this) { result ->
    when (result) {
        is DeleteWalletResult.Success -> {
            // Show success message or perform any other action
            DataWallet.releaseSdk()
        }
        is DeleteWalletResult.Error -> {
            // Show error message
        }
    }
}

This function is used when scanning a QR code or generating a clickable link that opens the Data Wallet app, facilitating connections, as well as the issuance and verification of credentials. To integrate this functionality, add the specified intent filter to the activity where the SDK is initialised.

To register your app to open didcomm:// deeplinks, add the following:

AndroidManifest.xml
<intent-filter>
 <action android:name="android.intent.action.VIEW" />
 <category android:name="android.intent.category.DEFAULT" />
 <category android:name="android.intent.category.BROWSABLE" />
 <data android:scheme="didcomm" />
</intent-filter>

Then, add the code below to Wallet SDK and initialise the callback -> InitializeWalletState.WALLET_OPENED.

MyActivity.kt
if (intent.scheme == "didcomm"){
  DataWallet.processDeepLink(this, intent.data.toString())
}

Change Language​

This function allows you to change the language used by the SDK. Provide the language code (e.g., "en" for English) to switch the SDK's localization to the desired language.

MyActivity.kt
DataWallet.changeLanguage(context, languageCode)

Handle Notification​

This function handles push notifications sent from the dashboard. It processes incoming issuance and verification requests as they arrive.

MyActivity.kt
DataWallet.handlePushNotification(message =  Map<String, Any>)

The callbacks for this function are received through the registerForSubscription method.

Subscribe To Notifications​

This function enables your application, integrated with the wallet, to register for subscriptions using specific arguments such as api_key and organization_id. It sets up a listener to process incoming notifications by type, such as SHARE_REQUEST, OFFER_REQUEST, REQUEST_WITH_PIN_ENTRY or VERIFY_REQUEST. Upon notification receipt, it executes tailored logic and navigates to relevant screens based on the provided intent. This functionality is crucial for enabling dynamic, automatic responses to user interactions or system events.

MyActivity.kt
DataWallet.setNotificationListener(
    object : NotificationListener {
        override fun receivedNotification(
            notificationType: String,
            intent: Intent
        ) {
            when (notificationType) {
                MessageTypes.SHARE_REQUEST -> {
                    // your logic
                    // intent will contain the screen to redirect
                    // startActivity(intent)
                }
                MessageTypes.OFFER_REQUEST -> {
                    // Do your logic
                    // intent will contain the screen to redirect
                    // startActivity(intent)
                }
                MessageTypes.REQUEST_WITH_PIN_ENTRY -> {
                   // startActivity(intent)
                }
                MessageTypes.VERIFY_REQUEST -> {
                   // startActivity(intent)
                }
            }
        }
        override fun walletReadyToUse() {
            //Get notified when wallet is ready to use
        }
        override fun pushNotificationResponse(status: Boolean) {
            // response to the handle push notification 
        }

    }
)

Wallet Unit Attestation​

This function turns on Wallet Unit Attestation and points the SDK at the attestation service.

MyActivity.kt
DataWallet.showWallet(
    this,
    enableWUA = true,
    baseUrl = "https://your-attestation-service.example",
    cloudProjectNumber = 1234567890L
)

baseUrl and cloudProjectNumber are both required when enableWUA is true. If either is missing, the wallet is not shown.

Self Attested Credential​

The SDKs provide applications with the ability to save, update, retrieve, and delete self-attested credentials securely.

Add​

Allows the Applications can store self-attested credentials. When connectionID is not supplied, the connection name and location are required.

MyActivity.kt
val id = SelfAttestedOpenIDCredential().add(
    title = "Title",
    description = "Description",
    attributes = mapOf(
        "attribute1" to "value1",
        "attribute2" to "Value2"
    ),
    connectionName = "Connection name shown on the credential",
    location = "Location shown on the credential",
    vct = "credential_type",
    logo = "https://example.org/logo.png"
)

Update​

Allows the Applications can update self-attested credentials.

MyActivity.kt
SelfAttestedOpenIDCredential().update(
    id = id,
    title = "Title",
    description = "Description",
    attributes = mapOf(
        "attribute1" to "value1",
        "attribute2" to "Value2",
        "attribute3" to "Value3"       ),
)


Get​

Allows the Applications can read the self-attested credential.

MyActivity.kt
val credential = SelfAttestedOpenIDCredential().get(id)

Delete​

Allows the Applications can delete the self-attested credential.

MyActivity.kt
SelfAttestedOpenIDCredential().delete(id)

Backup and Restore​

The SDKs enable applications to backup and restore wallet data. Currently, backup and restore operations are supported only through Data Pods by igrant.io.

Before initiating backup or restore, users must have an account with Data Pods.

Backup​

To initiate the backup

MyActivity.kt
DataWallet.initiateBackUp(context)

Restore​

To initiate the restore the backup. Before restoring make sure to delete wallet.

MyActivity.kt
DataWallet.initiateRestore(context, object : RestoreCallback {
    override fun onRestoreSuccess() {
        // Handle successful restore here
    }

    override fun onRestoreFailed(error: String) {
        // Handle restore failure here
    }
})