Miden Wallet

A secure, cross-platform wallet for the Miden blockchain. Available as a browser extension, desktop application, and mobile app.

Platforms

Platform	Technology	Status
Chrome Extension	WebExtension APIs	Production
Firefox Extension	WebExtension APIs	Production
Desktop (macOS, Windows, Linux)	Tauri v2	Production
iOS	Capacitor	Production
Android	Capacitor	Production

Features

Core Wallet Features

• Create and manage multiple Miden accounts
• Send and receive tokens
• View transaction history
• Import/export wallet via seed phrase or encrypted file
• Address book for saved contacts

Security

• Browser Extension: Secure vault with password encryption
• Desktop: Hardware-backed key storage via macOS Keychain / Windows Credential Manager
• Mobile: Biometric authentication (Face ID, Touch ID, Fingerprint)
• Client-side transaction signing (keys never leave your device)

Platform-Specific Features

Feature	Extension	Desktop	Mobile
dApp Browser	N/A (uses tabs)	Built-in browser window	In-app WebView
System Tray	N/A	Yes	N/A
Biometric Unlock	N/A	Touch ID (macOS)	Face ID / Touch ID / Fingerprint
QR Code Scanning	N/A	N/A	Yes
Haptic Feedback	N/A	N/A	Yes

Install

Download the latest release: https://miden.fi/

Development

Prerequisites

• Node.js 22 or later
• Yarn v1
• Rust toolchain (for desktop app)
• Xcode (for iOS development)
• Android Studio (for Android development)

Setup

# Clone the repository
git clone https://github.com/0xMiden/miden-wallet.git
cd miden-wallet

# Copy environment file
cp .env.example .env

# Install dependencies
yarn install

Browser Extension

# Development (Chrome)
yarn dev

# Production build
yarn build:chrome    # Chrome
yarn build:firefox   # Firefox
yarn build-all       # All browsers

Load the unpacked extension from dist/chrome_unpacked/ in Chrome's extension settings.

Desktop App

# Development
yarn desktop:dev

# Production build
yarn desktop:build

See Tauri prerequisites for platform-specific requirements.

Mobile App

# iOS
yarn mobile:ios           # Build and open in Xcode
yarn mobile:ios:run       # Build and run on Simulator

# Android
yarn mobile:android       # Build and open in Android Studio

Release Builds

# Android
yarn mobile:android:keystore     # Generate keystore (one-time)
yarn mobile:android:release      # Build AAB for Play Store
yarn mobile:android:release:apk  # Build APK for direct install

# iOS
yarn mobile:ios:release          # Build release archive
yarn mobile:ios:export           # Export IPA for App Store

Architecture

┌─────────────────────────────────────────────────────────────────────────┐
│                            Miden Wallet                                 │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐                 │
│   │  Extension  │    │   Desktop   │    │   Mobile    │                 │
│   │  (Chrome/   │    │   (Tauri)   │    │ (Capacitor) │                 │
│   │  Firefox)   │    │             │    │             │                 │
│   └──────┬──────┘    └──────┬──────┘    └──────┬──────┘                 │
│          │                  │                  │                        │
│          └──────────────────┼──────────────────┘                        │
│                             │                                           │
│                    ┌────────▼────────┐                                  │
│                    │   React + TS    │                                  │
│                    │   (Shared UI)   │                                  │
│                    └────────┬────────┘                                  │
│                             │                                           │
│                    ┌────────▼────────┐                                  │
│                    │   Miden SDK     │                                  │
│                    │     (WASM)      │                                  │
│                    └─────────────────┘                                  │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Key Directories

src/
├── app/                 # React app, pages, layouts
├── components/          # Shared UI components
├── screens/             # Screen components (onboarding, send flow, etc.)
├── lib/
│   ├── miden/           # Miden SDK integration
│   │   ├── back/        # Backend: wallet operations, vault
│   │   ├── front/       # Frontend: hooks, providers
│   │   └── sdk/         # WASM client wrapper
│   ├── store/           # Zustand state management
│   ├── desktop/         # Desktop-specific (Tauri) code
│   ├── mobile/          # Mobile-specific (Capacitor) code
│   ├── dapp-browser/    # dApp connectivity
│   └── woozie/          # Custom router
├── workers/             # Background workers
└── public/              # Static assets, locales

src-tauri/               # Tauri (Rust) backend
├── src/
│   ├── lib.rs           # Main entry, command registration
│   ├── secure_storage/  # OS keychain integration
│   ├── dapp_browser.rs  # dApp browser window management
│   └── tray.rs          # System tray
└── scripts/             # Injected JavaScript

ios/                     # iOS native project
android/                 # Android native project

State Management

• Frontend: Zustand store (src/lib/store/)
• Backend (Extension): Effector store (src/lib/miden/back/)
• Sync: Intercom messaging between frontend and service worker

Platform Detection

import { isExtension, isDesktop, isMobile, isIOS, isAndroid } from 'lib/platform';

if (isDesktop()) {
  // Tauri-specific code
} else if (isMobile()) {
  // Capacitor-specific code
} else if (isExtension()) {
  // Browser extension code
}

Testing

# Unit tests
yarn test

# E2E tests (Playwright)
yarn playwright:install   # First time only
yarn test:e2e

# Linting and formatting
yarn lint
yarn format

Internationalization

The wallet supports multiple languages. Translation files are in public/_locales/.

# Generate translation files
yarn createTranslationFile

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests and linting (yarn test && yarn lint)
5. Commit your changes
6. Push to your branch
7. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links

• Miden Documentation
• Polygon Miden
• Report Issues