Free and open source. Built in public: every update lands on the dev's X first.

Guide menu

MASKED for Android

The Android app is the MASKED wallet itself (the same code as the Chrome extension) inside a Capacitor app: Public, Shielded, Ecash, Ordinals and RGB, with the RGB engine built with swaps.

The Market tab opens MASKED's website (RGB market and Launchpad) inside the app, connected to the wallet the way the extension connects it: the site runs in a frame and asks the app through postMessage (src/dapp/AppMarket.mjs; the site's side is web/lib/masked-app.mjs). The app answers only maskedwallet.com and signet.maskedwallet.com, only from its own frame; requests are checked by the same code as the extension's (src/dapp/requests.mjs), and every connection, signature and payment opens the usual approval screen. Other websites can't connect to the app.

  • App id com.maskedwallet.app, version = package.json (2.29.10 → versionCode 22910)
  • scripts/build-mobile.mjs builds the wallet's files into dist/mobile (the extension build without the background, the website provider and the manifest); npx cap sync android copies them into android/
  • Network calls go through Capacitor's native HTTP (CapacitorHttp), as the extension's host permissions did
  • Screens are kept out of screenshots and the recent-apps preview (FLAG_SECURE); app data isn't backed up to the cloud (allowBackup="false"). Your recovery phrase and the RGB backup are how you restore

Build on GitHub

Actions → Android app → Run workflow. About 20–30 minutes (it builds the RGB engine first). Download the masked-android artifact: masked-<version>-debug.apk installs on a phone for testing.

For Google Play, add four repository secrets (Settings → Secrets and variables → Actions): ANDROID_KEYSTORE_BASE64 (base64 -i masked.keystore), ANDROID_KEYSTORE_PASSWORD, ANDROID_KEY_ALIAS, ANDROID_KEY_PASSWORD. The run then also makes a signed masked-<version>.apk and masked-<version>.aab (the file Google Play takes). Keep the keystore safe: every update must be signed with the same key.

Build on a Mac

Android Studio (it brings the Android SDK), Node 20+, and the RGB engine in vendor/rgb-lib-wasm (bash engine/build.sh), then:

npm run build:android
npx cap open android   # Android Studio: Run ▶ on a phone or emulator

This guide lives in the open-source repository: edit this page on GitHub.