Quickstart

You need Android Studio or Xcode, the SDK zip, a phone to run your app on, and a second phone with the demo wallet. About an hour.

1. Add the SDK to your project, as in Install & versions:

   Android (Kotlin)

   In Android Studio, point Gradle at the Maven folder from the zip, add the two libraries to app/build.gradle.kts, and click Sync Now:

   dependencies {
       implementation("com.wallet.sdk:sdk-core:0.7.0")
       implementation("com.wallet.sdk:sdk-ui-compose:0.7.0")
       implementation("androidx.activity:activity-compose:1.12.0")
       implementation("androidx.fragment:fragment-ktx:1.8.5")   // the screen is hosted in a FragmentActivity
   }

   iOS (Swift)

   In Xcode, drag ios/Wallet.xcframework into the project (Embed & Sign), add -lsqlite3 to Other Linker Flags, drag in ios/compose-resources as a folder reference, and add the camera and Bluetooth usage descriptions to the Info tab.

2. Create the SDK object once, with the issuers you trust and the certificate you sign requests with.

   Android (Kotlin)

   VerifierSetup.kt

   package samples
   
   import com.wallet.Wallet
   import com.wallet.WalletSdk
   import com.wallet.config.IssuerDisplayName
   import com.wallet.config.ReaderIdentityConfig
   import com.wallet.config.TrustedIssuers
   
   /** The SDK object for a verifier app. Create it once, when the app starts, and keep it. */
   object VerifierSetup {
       fun create(
           signedIssuerList: ByteArray,          // the signed list of issuers you accept, from your trust provider
           issuerRootPem: String,                // one issuer's root certificate, to name it on the result
           readerKeyBase64: String,              // your reader key (we issue it for pilots)
           readerCertChainPem: List<String>,     // your reader certificate chain, leaf first
       ): WalletSdk = Wallet.createVerifier(
           // Accept credentials from the issuers on the list, and show "Issued by Road Transport Authority".
           trustedIssuers = TrustedIssuers(
               signedList = signedIssuerList,
               displayNames = listOf(IssuerDisplayName(issuerRootPem, "Road Transport Authority")),
           ),
           // Sign every request, so wallets show your name instead of "unknown verifier".
           readerIdentity = ReaderIdentityConfig(privateKeyBase64 = readerKeyBase64, certChainPem = readerCertChainPem),
           // Document types you check besides the built-in driving licence.
           credentialTypes = listOf(EmiratesIdType.type),
       )
   }

   iOS (Swift)

   Verifier.swift

   import Foundation
   import Wallet
   
   /// The SDK object for a verifier app. Created once, when the app starts, and kept.
   enum Verifier {
       static let sdk: WalletSdk = Wallet.shared.createVerifier(
           // Accept credentials from the issuers on the list, and show "Issued by Road Transport Authority".
           trustedIssuers: TrustedIssuers(
               signedList: Trust.signedIssuerList,
               displayNames: [IssuerDisplayName(certificatePem: Trust.issuerRootPem, displayName: "Road Transport Authority")]
           ),
           // Sign every request, so wallets show your name instead of "unknown verifier".
           readerIdentity: ReaderIdentityConfig(privateKeyBase64: Trust.readerKeyBase64, certChainPem: Trust.readerCertChainPem),
           // Document types you check besides the built-in driving licence.
           credentialTypes: [EmiratesIdType.type]
       )
   }
   
   /// Your trust material, from your app's resources or your server.
   enum Trust {
       static let signedIssuerList = KotlinByteArray(size: 0)   // the signed list of issuers you accept
       static let issuerRootPem = ""                             // one issuer's root certificate (PEM)
       static let readerKeyBase64 = ""                           // your reader key (we issue it for pilots)
       static let readerCertChainPem: [String] = []              // your reader certificate chain, leaf first
   }

   Your reader identity

   The wallet shows “Verify is asking for…” only because it trusts the certificate in readerIdentity. For pilots we issue a reader certificate and add it to the demo wallet’s trust list. Without it, wallets show the verifier as unknown; the holder can still approve. See Trust.

3. Show the screen. It handles the camera and Bluetooth permissions (with an explanation page before the system dialogs), the scanner, the connection and the result view.

   Android (Kotlin)

   VerifierActivity.kt

   package samples
   
   import android.os.Bundle
   import androidx.activity.compose.setContent
   import androidx.fragment.app.FragmentActivity
   import com.wallet.model.RequestPresets
   import com.wallet.ui.WalletVerifyScreen
   
   /** The whole in-person verifier: pick a check, scan, read the result. Permissions are handled inside. */
   class VerifierActivity : FragmentActivity() {
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
           setContent {
               WalletVerifyScreen(
                   sdk = App.sdk,
                   presets = RequestPresets.mdl + Checks.emiratesId,   // in this order: driving licence, Emirates ID
                   title = "Verify",
               )
           }
       }
   }

   Host it in a FragmentActivity.

   iOS (Swift)

   VerifierApp.swift

   import SwiftUI
   import Wallet
   
   /// The whole in-person verifier: pick a check, scan, read the result. Permissions are handled inside.
   @main
   struct VerifierApp: App {
       var body: some Scene {
           WindowGroup { VerifyScreen().ignoresSafeArea() }
       }
   }
   
   /// The SDK's verify screen, hosted in SwiftUI.
   struct VerifyScreen: UIViewControllerRepresentable {
       func makeUIViewController(context: Context) -> UIViewController {
           WalletViewControllersKt.WalletVerifyViewController(
               sdk: Verifier.sdk,
               presets: RequestPresets.shared.mdl + Checks.emiratesId,   // in this order: driving licence, Emirates ID
               title: "Verify"
           )
       }
       func updateUIViewController(_ controller: UIViewController, context: Context) {}
   }

   The screen is a UIViewController; in SwiftUI, wrap it in a UIViewControllerRepresentable.

4. Run it on a phone (Android Studio: pick the phone and press Run ▶; Xcode: pick the iPhone and press ⌘R). Bluetooth and the camera don’t work in emulators or simulators. With the demo wallet on the second phone: pick “Licence check”, scan the wallet’s QR (its Present button shows it), approve on the wallet, and read the result.

Next: Define your checks.