Fairway ID Wallet
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.
- Verifier portal: Set up a proof request and show it as a QR code
- Holder's wallet to Verifier portal: Scan it and open the request over DIDComm v2
- Holder's wallet to Verifier portal: Send a presentation of the chosen credential
- 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.