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 submodule they build against.

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

📲 iOS on the App Store

🤖 Android on Google Play

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

Getting Started

1. Clone the repository with submodules:

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

2. If needed, initialize submodules later:

just setup-git

iOS

Note

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

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

just bootstrap 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 bootstrap
just build-test

Add GitHub Packages credentials to android/local.properties before Android builds that need private package access:

gpr.username=<your-github-username>
gpr.token=<your-github-token>

Developer Shortcuts

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

just build
just generate
just localize
just bump patch
just ios bootstrap
just ios build
just ios build-for-testing
just ios test-without-building
just android bootstrap
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.

• Bug Bounty Program — report vulnerabilities and earn rewards for responsible disclosure
• CertiK Security Audit (April 2026) — latest third-party audit report

Contributing

• Browse GitHub Issues
• Track work on the GitHub Project Board
• See the public Roadmap

See CONTRIBUTING.md for contribution guidelines.

Community

• Install the app at gemwallet.com or Join Discord, X, Telegram

License

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