# Mango wallet extension on Windows

Current build: **Mango wallet 0.9.4**. Extension id: `pfeojhejabjihflngblcidnjpicekigb`.

Everything below is at **https://namid.net/mango/** — a plain web page, no login, no GitHub
account.

## First: the extension needs the Mango wallet app, open, on the same computer

The extension holds no keys. Your keys are in the **Mango wallet desktop app**, and the
extension talks to that app on this computer (at `127.0.0.1:9000`). So on Windows:

- Install the Mango wallet desktop app, **version 0.13.3 or newer** — it is the
  `Mango wallet_…_x64-setup.exe` at https://namid.net/mango/ when one is listed there.
  Older desktop builds do not answer the extension at all.
- **Open it** (Start menu → Mango wallet) before you use the extension. If the popup says
  *"The Mango wallet isn't open"*, that is exactly what it means: open the app, then press
  **Try again**. There is no command to run on Windows.

If https://namid.net/mango/ lists no setup `.exe` yet, the Windows desktop app has not been
published, and until it is the extension has nothing to talk to on Windows.

Then install the extension. There are two ways. Pick one.

- **Way A — hands-off.** The browser installs the wallet from our update server and keeps
  it up to date by itself. Needs one administrator step, once. After that you never touch
  it again.
- **Way B — simple.** Download a folder and load it. Updating later is one command plus one
  click. No administrator rights needed.

Way A is the one to pick if you are tired of doing this by hand.

---

## Way A — install once, updates itself

1. Open **https://namid.net/mango/install-mango-autoupdate.ps1** and save the file (Ctrl+S)
   to your Downloads folder.
2. Click **Start**, type `powershell`, right-click **Windows PowerShell** and choose
   **Run as administrator**. Click **Yes** on the prompt.
3. Paste this line and press Enter:

   ```
   powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\install-mango-autoupdate.ps1"
   ```

4. It prints a line for Chrome, Brave and Edge. That is all it does: it tells the browser
   to install extension `pfeojhejabjihflngblcidnjpicekigb` from
   `https://namid.net/mango/updates.xml`.
5. Open `chrome://extensions` (or `brave://extensions`). If an **old card** is still there
   for this wallet (under any earlier name) with a **Remove** button, click **Remove**. It
   has the same id as the new one, so your password, approved sites and sign-ins stay.
6. **Quit the browser completely** (close every window) and open it again.
7. Check it worked — see **Did it work?** below.

From now on the browser checks `https://namid.net/mango/updates.xml` about every five hours
and installs new versions on its own. Nothing for you to do.

**The one catch, so it is not a surprise:** the card will say *"Installed by enterprise
policy"* and you will not be able to remove or disable it from the browser. That is the only
way Chrome and Brave on Windows allow an extension that is not in the Chrome Web Store. To
undo it, run the same file with `-Uninstall` on the end, from an administrator PowerShell.

---

## Way B — download a folder, load it

1. Open **https://namid.net/mango/mango-wallet-extension-0.9.4.zip** and save it.
2. Right-click the downloaded zip → **Extract All…** → extract to your Downloads folder.
   You get a folder called `mango-wallet-extension`. **Do not rename it.**
3. Open `chrome://extensions` (or `brave://extensions`).
4. Turn on **Developer mode** — the switch at the top right.
5. Click **Load unpacked** and select the `mango-wallet-extension` folder.
6. Check it worked — see **Did it work?** below.

### Updating, Way B

Save **https://namid.net/mango/update-mango-extension.ps1** once, then whenever you want the
newest build, open PowerShell (no administrator needed) and run:

```
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\update-mango-extension.ps1"
```

It checks the published version, says "Already on 0.9.4. Nothing to do." if there is nothing
new, and otherwise downloads it, checks the file is the real one, and swaps the folder — the
old folder is kept beside it, nothing is deleted. Then:

- Open `chrome://extensions` and click the **circular Reload arrow** on the Mango wallet
  card. Chromium only re-reads a loaded folder when you ask it to; that click is the whole
  reason Way A exists.

Note: the first run puts the folder in `%LOCALAPPDATA%\MangoWallet\mango-wallet-extension`,
so load it from there rather than from Downloads if you want the updater to manage it.

---

## Did it work?

On `chrome://extensions`, the Mango wallet card must show:

- the name **Mango wallet**
- the version **0.9.4** (anything starting 0.8 is the old build)
- the id **`pfeojhejabjihflngblcidnjpicekigb`**

If the id is different, stop — a different id is a different extension and your approvals
and sign-ins will not be there. Remove it and install again from
**https://namid.net/mango/**.

You can also check the version from a web page: press F12, go to **Console**, type
`window.mango.version` and press Enter. It should print `0.9.4`.

## Checking the download is the real file

`https://namid.net/mango/SHA256SUMS.txt` lists the sha256 of the zip and of the .crx. In
PowerShell:

```
Get-FileHash .\mango-wallet-extension-0.9.4.zip
```

Compare the hash with the one in that file. (Way B's updater script does this for you and
refuses to install a file that does not match.)

## Names that stay the same on purpose

The extension's id (`pfeojhejabjihflngblcidnjpicekigb`) and its Firefox id never change: a new
id would be a second, separate extension without your password, approved sites or sign-ins.
Web pages find the wallet as `window.mango`; the older name they used is still answered too, so
no site breaks while sites move over. Everything you see — the extension name, the toolbar
tooltip, every message in the popup — says **Mango wallet**.