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.mjsbuilds the wallet's files intodist/mobile(the extension build without the background, the website provider and the manifest);npx cap sync androidcopies them intoandroid/- 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.
MASKED