Paradym

Paradym Wallet lets people receive, store and share digital credentials such as an ID card, a driving licence or a bank account. Credentials stay on the phone, and the user decides what to share and with whom. You can use the wallet as it is from the app stores, or use this repository as the starting point for your own wallet.

Features

• OpenID4VC: receive credentials with OpenID4VCI and share them with OpenID4VP 1.0, including DCQL, signed requests and deferred and batch issuance.
• All major credential formats: SD-JWT VC, mdoc (ISO 18013-5, mDL), W3C Verifiable Credentials and AnonCreds.
• EUDI ready: the EU PID, mDL, age verification and photo ID, and relying party registration certificates.
• Digital Credentials API: share credentials from the browser on both iOS and Android, over OpenID4VP or ISO 18013-7.
• In-person sharing: present an mdoc offline over Bluetooth, started from a QR code or NFC tap.
• Payments and signing: confirm payments with strong customer authentication (EUDI SCA and PaSO) and authorize qualified electronic signatures.
• DIDComm: connect to issuers and verifiers, and receive and present AnonCreds credentials.
• Trust: see who you're dealing with, based on X.509 certificates, DIDs and trusted issuer and verifier lists.
• Security: PIN and biometric unlock, encrypted storage and hardware-backed keys in the Secure Enclave or StrongBox.
• Available in 7 languages: English, German, Dutch, Finnish, Swedish, Portuguese and Albanian.

The wallet is also available as a white-label solution, and the credential and protocol logic is published as the @paradym/wallet-sdk package to build your own wallet.

Issue and verify with Paradym

Paradym is our platform to issue and verify digital credentials. It integrates with any digital identity wallet, including the EUDI wallets of the member states, and works out of the box with Paradym Wallet. Sign up for free at paradym.id.

Try it out

Install Paradym Wallet from the App Store or Google Play, then open one of the playgrounds.

Paradym Playground

The Paradym Playground is the quickest way to get started. Issue a PID or mDL to your wallet and verify it again in a few clicks, powered by Paradym.

Animo Playground

The Animo Playground is our experimental playground, where we try out the latest specifications first. You can configure almost everything: issuers, credential formats, attributes, authorization flows, the Digital Credentials API and your own certificates. Use it for experimentation, and expect things to break now and then. The code is on GitHub.

Development

The repository is a pnpm monorepo with an Expo (React Native) app. The UI is built with Tamagui, and Credo powers the credential and protocol logic.

• apps/wallet: the Paradym Wallet app for iOS and Android
• packages/sdk: @paradym/wallet-sdk, with the OpenID4VC, DIDComm, Digital Credentials API, proximity and payment flows
• packages/app: shared components, hooks and providers
• packages/ui: the Tamagui UI kit
• packages/scanner: QR code scanning
• packages/translations: Lingui setup and translation scripts
• packages/utils: shared helpers

Run the wallet

You need Node.js 22 and pnpm. Install the dependencies, then build and install a development build on a simulator or device:

pnpm install
cd apps/wallet
pnpm prebuild
pnpm ios # or: pnpm android

Then start Metro with pnpm start from apps/wallet. You only need a new development build when native code changes. For JavaScript changes, Metro is enough.

Add dependencies

Dependency versions are pinned in the pnpm catalog in pnpm-workspace.yaml.

• JavaScript-only dependencies go in the package that uses them.
• Dependencies with native code go in apps/wallet. If another package also needs to import it, install the exact same version there, or you'll end up with two copies at runtime.

Run pnpm install from the root after any dependency change.

Release

The Continuous Deployment workflow builds the app with EAS. Bump the version in apps/wallet/package.json, then run the workflow with the production channel. The builds are submitted to TestFlight and the Google Play alpha track, and released to users from App Store Connect and the Google Play Console.

SDK changes need a changeset (pnpm changeset). Merging the chore(release): new version pull request publishes a new version of @paradym/wallet-sdk.

License

Paradym Wallet is licensed under the Apache 2.0 license.