animo / paradym-wallet

With Paradym Wallet, you can seamlessly manage and present your digital credentials
https://paradym.id
Apache License 2.0
31 stars 12 forks source link
android anoncreds aries-framework-javascript cheqd credo credo-ts did didcomm hyperledger-aries ios mobile oid4vc oid4vci oid4vp react-native siopv2 verifiable-credentials w3c-vc wallet
Animo Logo

Paradym Wallet

This repository contains an implementation of a mobile Paradym SSI wallet.

With Paradym Wallet, you can seamlessly manage and present your digital credentials, allowing for a secure and private digital existence. Your data is stored locally on your device, meaning that you retain full control over your information and decide who you want to share it with.

Impression of Paradym Wallet

Note: To read more about the Animo EasyPID EUDI wallet prototype, look in the EasyPID app directory.

Try it out

You can download Paradym Wallet from the Google Play Store or Apple App Store.

The wallet can be used with existing demo's in these environments:

Project Structure

The project is a monorepo managed using pnpm, which contains an Expo React Native application. The UI is built using Tamagui, and navigation is handled using Expo Router, React Navigation and Solito. For the Agent and SSI capabilities Aries Framework JavaScript (AFJ) is used.

The folder structure is as follows

You can add other folders inside of packages/ if you know what you're doing and have a good reason to.

🏁 Start a wallet

First, start by installing all dependencies by running pnpm install.

Once all dependencies are installed, you need to make sure you have a development build of the app on your mobile device. You can install this using the following commands:

cd apps/paradym # or apps/easypid
pnpm prebuild
pnpm ios # or android

You only need to install the development build when native dependencies change. If you're only working on JS, you can skip this step if you already have the development build installed.

Once installed you can run pnpm start from the root of the project to start your development server.

📦 Releasing

🚧 Soon documentation will be added on how to publish a new release to the Apple App Store and Google Play Stores. 🚧

🆕 Add new dependencies

Pure JS dependencies

If you're installing a JavaScript-only dependency that will be used across platforms, install it in packages/app:

cd packages/app
pnpm add date-fns
cd ../..
pnpm

Native dependencies

If you're installing a library with any native code, you must install it in expo:

cd apps/paradym
pnpm add react-native-reanimated
cd ..
pnpm

You can also install the native library inside of packages/app if you want to get autoimport for that package inside of the app folder. However, you need to be careful and install the exact same version in both packages. If the versions mismatch at all, you'll potentially get terrible bugs. This is a classic monorepo issue. You can use lerna-update-wizard to help with this (you don't need to use Lerna to use that lib).