MRGWallet

MRGWallet is the official MergeOS MRG wallet surface for Android, Chrome, and Firefox: local vault address, public token/ledger discovery, claim receipts bound to ledger tips, and Solana program anchors — without auto-releasing payouts.

Product: mergeos-bounties/MRGWallet · App: mergeos.shop · Scan: scan.mergeos.shop · Contracts: mergeos-contracts

---

Highlights

Surface	Description
Core	packages/core — vault, economy/proof/market discovery, claim receipts
Web UI	packages/web — dark wallet UI (shared by extensions + Android)
Chrome / Firefox	MV3 popup extensions (npm run build:extensions)
Android	WebView shell loading bundled assets/www
Safety	Mock vault by default; live only hits public MergeOS APIs

---

Quick start

cd MRGWallet
npm test
npm run demo
npm run serve
# open http://127.0.0.1:8787/

npm run build
npm run package:release   # zips under dist/release/

Chrome extension

See the full walkthrough: docs/CHROME_INSTALL.md

1. npm run build:extensions (or unpack a release zip)
2. Chrome → Extensions → Developer mode → Load unpacked → dist/extensions/chrome

See Install screenshots for a visual step-by-step walkthrough.

Firefox extension

1. npm run build:extensions
2. about:debugging → This Firefox → Load Temporary Add-on → dist/extensions/firefox/manifest.json

See Firefox install walkthrough for details, troubleshooting, and Android Nightly setup.
See Install screenshots for a visual step-by-step walkthrough.

Android

npm run sync:android
cd android
# Android Studio → open this folder → Run app
# or: .\gradlew.bat :app:assembleDebug

See Install screenshots for a visual step-by-step walkthrough.

Release artifacts

GitHub Releases attach:

Asset	Use
MRGWallet-chrome-vX.Y.Z.zip	Load unpacked in Chrome
MRGWallet-firefox-vX.Y.Z.zip	Temporary add-on in Firefox
MRGWallet-web-vX.Y.Z.zip	Static host / Android assets source
*.sha256	Checksums

Tag vX.Y.Z (or run Release workflow) builds these automatically.

---

Wallet model

local vault address (mock seed → base58)
        +
public token economy + ledger proof + marketplace
        +
Solana mergeos_mrg program_id / releasePayout
        ↓
claim receipt (address ↔ task ↔ ledger_reference)
        ↓
owner/admin accept  →  optional Solana releasePayout

API (public)	Used for
/api/public/token-economy	Supply / reserves
/api/public/ledger/proof	Hash tip + validity
/api/public/marketplace	Open bounties (title MRG)
/contracts/solana/…proof-manifest…	Program binding

---

CLI / scripts

Command	Purpose
npm test	Core wallet unit tests
npm run demo	Mock snapshot smoke
npm run build:web	Browser bundle + UI
npm run build:extensions	Chrome + Firefox packages
node scripts/sync-android-assets.mjs	Copy web into Android assets

---

Repository layout

MRGWallet/
  packages/
    core/           # Node + browser wallet logic
    web/            # HTML/CSS/JS UI
    extension/      # Chrome/Firefox manifests + icons
  android/          # Kotlin WebView host
  scripts/          # build + demo
  test/             # node:test
  docs/

---

Development

npm test
npm run demo
npm run build

CI: .github/workflows/ci.yml

---

MergeOS bounties

Star → claim issue → PR to master → MRG 25–200.
See docs/BOUNTY.md · mergeos.

---

License

MIT · MergeOS / ThanhTrucSolutions