BAL - Bitcoin After Life Electrum plugin (v0.2.8)

Behavior-preserving refactor of the original BAL plugin with clean separation
of business logic from the PyQt GUI.

Layout:
  bal/core/   GUI-free logic (util, plugin_base, heirs, will, willexecutors)
  bal/gui/qt/ PyQt6 presentation (theme, common, widgets, calendar, dialogs,
              lists, window, plugin)
  bal/qt.py   Qt entry-point shim (works as internal and external zip plugin)
  bal/manifest.json  standard-conforming metadata

Tooling:
  build_zip.py            deterministic, zipimport-friendly archive builder
  tests/smoke_test.py     imports + behavior regression test
  tests/external_zip_test.py  reproduces Electrum's external-zip loading

Targets Electrum 4.7.2 + PyQt6. Logic kept byte-identical where possible.

README.md

@@ -0,0 +1,91 @@
+# BAL — Bitcoin After Life (Electrum plugin)
+
+Free and decentralized **Bitcoin inheritance** support for the
+[Electrum](https://electrum.org) wallet. Build time-locked "will" transactions
+that transfer your funds to your heirs if you stop refreshing them
+(dead-man's switch), optionally relayed by will-executor servers.
+
+This repository contains a **behavior-preserving refactor** of the original
+plugin. The logic was kept byte-identical wherever possible; only the file
+layout was reorganized to cleanly separate **business logic** from the
+**PyQt GUI**.
+
+## Repository layout
+
+```
+bal/                     the installable Electrum plugin package
+├── manifest.json        plugin metadata (Electrum reads this)
+├── qt.py                Qt entry-point shim (re-exports Plugin)
+├── core/                GUI-free logic (importable without Qt)
+│   ├── util.py
+│   ├── plugin_base.py
+│   ├── heirs.py
+│   ├── will.py
+│   └── willexecutors.py
+├── gui/qt/              PyQt6 presentation layer
+│   ├── theme.py         status → color mapping
+│   ├── common.py        shared imports / helpers
+│   ├── widgets.py       leaf widgets
+│   ├── calendar.py      calendar widget
+│   ├── dialogs.py       dialog windows
+│   ├── lists.py         tree/list views
+│   ├── window.py        per-wallet GUI controller
+│   └── plugin.py        Plugin (Electrum @hooks → GUI)
+├── icons/  wallet_util/  LICENSE  VERSION  README.md
+build_zip.py             builds a clean, zipimport-friendly distribution zip
+tests/                   smoke + external-zip regression tests
+```
+
+## Requirements
+
+- **Electrum 4.7.2** — the last stable release exposing `json_db.register_dict`,
+  which this plugin relies on. Newer versions removed it.
+- **PyQt6** (bundled with the Electrum desktop GUI).
+
+## Installation
+
+### Build the distribution archive
+
+```bash
+python3 build_zip.py
+# -> bal-electrum-plugin.zip  (prints size + SHA-256 for integrity checks)
+```
+
+The builder writes a `zipimport`-friendly archive (files only, standard
+DEFLATE, deterministic order) to avoid loader errors seen on some Electrum
+portable builds.
+
+### Install as an external plugin (zip)
+
+1. Electrum → **Tools → Plugins** → install from file → pick the built zip.
+2. Enable **Bitcoin After Life** and restart Electrum.
+3. (Recommended) verify the downloaded zip's SHA-256 matches the value printed
+   by `build_zip.py`.
+
+### Install as an internal plugin
+
+Copy the `bal/` directory into your Electrum installation's
+`electrum/plugins/` directory, so that `electrum/plugins/bal/manifest.json`
+exists, then enable it from **Tools → Plugins**.
+
+## Testing
+
+```bash
+# imports + behavior
+QT_QPA_PLATFORM=offscreen PYTHONPATH=<electrum-src> \
+    python3 tests/smoke_test.py electrum.plugins.bal
+
+# external-zip loading regression
+QT_QPA_PLATFORM=offscreen PYTHONPATH=<electrum-src> \
+    python3 tests/external_zip_test.py bal-electrum-plugin.zip
+```
+
+## ⚠️ Safety
+
+This plugin builds real Bitcoin inheritance transactions with time-locks. Test
+on **testnet** or a fund-less wallet first, and review the generated
+transactions before broadcasting.
+
+## License
+
+MIT — see [`bal/LICENSE`](bal/LICENSE).