Aries Framework Kotlin is an Android framework for Aries protocol.
Aries Framework Kotlin supports most of AIP 1.0 features for mobile agents.
Aries Framework Kotlin requires Android 7.0+. It is distributed as a Maven package hosted by GitHub Packages.
You can add a dependency to your app's build.gradle file:
dependencies {
implementation("org.hyperledger:aries-framework-kotlin:2.0.0")
}
You need to add the following to your project's build.gradle file to use GitHub Packages:
allprojects {
repositories {
maven {
setUrl("https://maven.pkg.github.com/hyperledger/aries-framework-kotlin")
credentials {
// You should put these in the local.properties file
username = "your github username"
password = "your github token for read:packages"
}
}
maven { url 'https://jitpack.io' }
}
}
App development using Aries Framework Kotlin is done in following steps:
val config = AgentConfig(
walletKey = key,
genesisPath = File(applicationContext.filesDir.absolutePath, genesisPath).absolutePath,
mediatorConnectionsInvite = invitationUrl,
mediatorPickupStrategy = MediatorPickupStrategy.Implicit,
label = "SampleApp",
autoAcceptCredential = AutoAcceptCredential.Never,
autoAcceptProof = AutoAcceptProof.Never,
)
val agent = Agent(applicationContext, config)
agent.initialize()
To create an agent, first create a key to encrypt the wallet and save it in the EncryptedSharedPreferences.
val key = Agent.generateWalletKey()
A genesis file for the indy pool should be included as a resource in the app bundle and should be copied to the file system before initializing the agent.
val genesisPath = "genesis.txn"
val inputStream = applicationContext.assets.open(genesisPath)
val file = File(applicationContext.filesDir.absolutePath, genesisPath)
if (!file.exists()) {
file.outputStream().use { inputStream.copyTo(it) }
}
If you want to use a mediator, set the mediatorConnectionsInvite
in the config.
mediatorConnectionsInvite
is a url containing either a connection invitation or an out-of-band invitation.
mediatorPickupStrategy
need to be MediatorPickupStrategy.Implicit
to connect to an ACA-Py mediator.
You can use WebSocket transport without a mediator, but you will need a mediator if the counterparty agent only supports http transport.
Create a connection by receiving a connection invitation.
val (_, connection) = agent.oob.receiveInvitationFromUrl(url)
You will generally get the invitation url by QR code scanning. Once the connection is created, it is stored in the wallet and your counterparty agent can send you a credential or a proof request using the connection at any time. The connection record contains keys to encrypt or decrypt messages exchanged through the connection.
Subscribe to agent.eventBus to receive events from the agent and use agent.credentials
or agent.proofs
commands to handle the requests.
private fun subscribeEvents() {
val app = application as WalletApp
app.agent.eventBus.subscribe<AgentEvents.CredentialEvent> {
lifecycleScope.launch(Dispatchers.Main) {
if (it.record.state == CredentialState.OfferReceived) {
getCredential(it.record.id)
} else if (it.record.state == CredentialState.Done) {
showAlert("Credential received")
}
}
}
app.agent.eventBus.subscribe<AgentEvents.ProofEvent> {
lifecycleScope.launch(Dispatchers.Main) {
if (it.record.state == ProofState.RequestReceived) {
sendProof(it.record.id)
} else if (it.record.state == ProofState.Done) {
showAlert("Proof done")
}
}
}
}
private fun getCredential(id: String) {
val app = application as WalletApp
lifecycleScope.launch(Dispatchers.IO) {
try {
app.agent.credentials.acceptOffer(
AcceptOfferOptions(credentialRecordId = id, autoAcceptCredential = AutoAcceptCredential.Always),
)
} catch (e: Exception) {
lifecycleScope.launch(Dispatchers.Main) {
showAlert("Failed to receive a credential.")
}
}
}
}
private fun sendProof(id: String) {
val app = application as WalletApp
lifecycleScope.launch(Dispatchers.IO) {
try {
val retrievedCredentials = app.agent.proofs.getRequestedCredentialsForProofRequest(id)
val requestedCredentials = app.agent.proofService.autoSelectCredentialsForProofRequest(retrievedCredentials)
app.agent.proofs.acceptRequest(id, requestedCredentials)
} catch (e: Exception) {
lifecycleScope.launch(Dispatchers.Main) {
showAlert("Failed to present proof.")
}
}
}
}
If you set autoAcceptCredential
and autoAcceptProof
to Always
in the config, it will be done automatically and you don't need to subscribe to the events and handle the requests.
Another way to handle those requests is to implement your own MessageHandler
class and register it to the agent.
val messageHandler = MyOfferCredentialHandler()
agent.dispatcher.registerHandler(messageHandler)
For your information, Aries Framework Kotlin refers to Aries Framework Swift a lot, so the class name and API are almost the same.
app
directory contains an Android sample app that demonstrates how to use Aries Framework Kotlin. The app receives a connection invitation from a QR code or from a URL input and handles credential offers and proof requests.
The agent is created in the WalletApp.kt
file and you can set a mediator connection invitation url there, if you want.
There is a genesis files in the app/src/main/assets
directory.
bcovrin-genesis.txn
is for the GreenLight Dev LedgerWe welcome contributions to Aries Framework Kotlin. Please see our Developer Guide for more information.
Aries Framework Kotlin is licensed under the Apache License 2.0.