Abrham Bunaro

Fairway ID Wallet

PrototypeTeamPublic code2025

An open-source, mobile-first wallet for holding and presenting verifiable credentials on Hyperledger Identus, with a companion portal for the organisations that verify them.

The problem

Organisations need credentials people can reuse and a simple way to check them. A paper certificate or an emailed PDF cannot be verified, and every new verifier usually means a new integration.

How it works

The wallet is a Next.js app that runs an Identus edge agent in the browser. Credentials stay encrypted on the device in IndexedDB, keys come from a BIP-39 mnemonic, and exchange runs peer to peer over DIDComm v2 through a mediator.

In the companion portal, a verifier sets up a proof request and shows it as a QR code. The holder scans it with the wallet, and the portal reports whether the presentation passed.

How a verifier checks a credential
  1. Verifier portal: Set up a proof request and show it as a QR code
  2. Holder's wallet to Verifier portal: Scan it and open the request over DIDComm v2
  3. Holder's wallet to Verifier portal: Send a presentation of the chosen credential
  4. Verifier portal: Verify it and show pass or fail

What I worked on

  • Fayda national-ID sign-in: the OIDC callback page and the token and user-info API routes, authenticated with a signed client-assertion JWT instead of a shared secret.
  • A Jest suite covering the API routes, the Fayda flow, wallet core and UI components, with a written testing report.
  • Build fixes across the credential, QR scan and setup screens, and the project README.

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

Security notes

  • Credentials and keys stay on the holder's device, encrypted at rest. There is no central credential store to breach.
  • The Fayda token exchange runs on the server, so the key that signs the client assertion never reaches the browser.
  • The testing report states what the suite covers and what it does not.

Where it stands

Both repositories are public under the Fairway organisation. I rebuilt the same Fayda sign-in for FairWallet a few months later.

Next project

Fayda identity integration

Back to all work