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

If you are using an Intel Mac, update core and run just generate-stone to build the additional x86_64 Gemstone artifacts.

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 and android/reproducible/README.md for Android release verification details.

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.