Gem Wallet

Gem Wallet is an open-source mobile wallet for iOS and Android. This repository is the monorepo for both apps and the shared Rust core they build against.

Install

• App Store
• Google Play
• F-Droid
• Android APK releases

Features

• Open source, self-custodial wallet with multi-chain support
• Native iOS and Android apps with shared Rust-based blockchain functionality
• Swaps, staking, WalletConnect, fiat on/off ramp, alerts, and market data

Repository

• ios/: SwiftUI application, packages, tests, and iOS-only submodules
• android/: Kotlin/Compose application and Android build tooling
• core/: shared Rust source used by both mobile apps

Getting Started

1. Clone the repository with iOS submodules:

git clone --recursive https://github.com/gemwalletcom/wallet.git
cd wallet

2. If needed, initialize iOS submodules later:

just setup-git

To install dependencies for both apps on macOS, with Homebrew, Xcode, and Android Studio's SDK command-line tools available:

just install

This installs shared Rust and TypeShare tools once, then iOS tools and targets, followed by Android's JDK, targets, and NDK. The JDK installer may prompt for a password. For a single platform, run just core install-rust and just core install-typeshare, followed by its install command below.

iOS

Note

iOS builds require macOS. Apple silicon is the default supported environment for Gemstone builds.

cd ios
just install
just spm-resolve
just build-for-testing

just install also creates the local Gemstone UniFFI Swift/header sources that SwiftPM needs for package resolution. Xcode builds the Gemstone Rust static library automatically after that. Intel Macs are not supported for iOS Gemstone builds.

Android

cd android
just install
just build-test

Developer Shortcuts

The repo root exposes monorepo commands plus module access to each platform:

just install
just build
just generate
just localize
just bump patch
just bump minor
just bump major
just ios install
just ios build
just ios build-for-testing
just ios test-without-building
just android install
just android build
just android build-test
just android test

Platform-specific commands remain available through the ios and android just modules.

Security

Gem Wallet is self-custodial, and keeping user funds safe is our highest priority. See the Security Overview for our practices around key material, signing, and secure storage.

• Responsible Disclosure — report security vulnerabilities responsibly
• CertiK Security Audit (April 2026) — latest third-party audit report

Contributing

• Browse GitHub Issues
• Follow the public Roadmap

See CONTRIBUTING.md for contribution guidelines.

Community

• Website: gemwallet.com
• Chat: Discord, Telegram
• Updates: X

License

Gem Wallet is open-sourced software licensed under the GPL-3.0.