Abrham Bunaro

FairWallet

PilotTeamPublic code2026

A mobile credential wallet for Ethiopia, built on the Cardano Foundation's open-source Veridian wallet and piloted in Addis Ababa in May 2026.

Issuer dashboard showing the Graduate Trainee Program credential template: template and schema IDs, auto-issue after Fayda enabled, ten credentials issued.
A credential template in the issuer dashboard, from Fairway's published pilot evidence.

The problem

A national ID proves who someone is, not what they have earned. Students and IT workers in Ethiopia had no portable, checkable way to show a certificate to an employer, and institutions had no simple way to issue or verify one.

How it works

Fairway forked Veridian, a KERI wallet, instead of writing wallet cryptography from scratch. Holders sign in with Fayda, the national digital ID, receive ACDC credentials over the IPEX protocol and present them by scanning a QR code.

Issuers and verifiers work from a web dashboard. Behind it, a credential server built on Signify-TS creates and signs credentials against a KERIA cloud agent backed by six KERI witnesses.

How a credential is issued and later presented
  1. Holder's wallet to Credential server: Scan a QR code and connect
  2. Credential server to KERIA and witnesses: Create and sign the credential
  3. Credential server to Holder's wallet: Issue it to the wallet over IPEX
  4. Holder's wallet to Credential server: Later: present it to a verifier
  5. Credential server to KERIA and witnesses: Check signatures and key state

What I worked on

  • Fayda sign-in inside the wallet: the sign-in modal, the callback page and storing the provider's response.
  • The deep-link return from the browser to the app on Android and iOS, through the manifest, Info.plist and app routing.
  • The issuer and verifier dashboard: connections, credential templates saved to KERIA, presentation requests, credential detail views, and the move from one tenant to several KERIA identifiers.
  • The rebrand from Veridian to FairWallet across app config, icons and both mobile shells, plus language-switching fixes.
  • The public milestone evidence repository: architecture, issuing and verification flows, credential schemas and the anonymised issuance register.

A team project. This list is limited to what the public commit history shows under my name.

The verifier workspace of the FairWallet dashboard: navigation for activities, connections and presentation requests, and an activity summary for a test workspace.
The verifier workspace on a test account, from Fairway's published pilot evidence.

Security notes

  • Identifiers are KERI AIDs created on the holder's device. The pilot stored no credentials, personal data or credential hashes on any chain.
  • Everything published about the pilot is anonymised: participant codes instead of names, and no keys, tokens or full identifiers.
  • Upstream Veridian reports a security audit; Fairway's changes were not audited separately. Key rotation, recovery and revocation procedures were outside the pilot and are listed as scaling requirements.

Where it stands

Piloted on 22 May 2026 in Addis Ababa under Project Catalyst Fund 12. Fairway's public milestone evidence records 23 credentials issued across two schemas that day. The pilot ran on KERI witnesses; anchoring to Cardano is supported by the architecture but was not switched on.

Next project

Fairway ID Wallet

Back to all work