v1.4.1

  ┌─────────────────────────────────────────────────────────────┐
  │  ▄▄ GoVault ▄▄   S T R A T U M   T E R M I N A L   //  v1.4.1 │
  │  ── an ASICpool transmission ── 0% custody · 0% bunker ──     │
  └─────────────────────────────────────────────────────────────┘

INCOMING TRANSMISSION — GoVault v1.4.1
A small, sharp follow-up to v1.4.0: tidier block detection and a knob for the
ZMQ fallback poll.

---

🎛️ NEW — set your ZMQ fallback poll interval

With ZMQ enabled, GoVault hears new blocks instantly; the RPC poll is only a
safety net for the rare case a ZMQ message is missed. You can now set how often
that fallback runs, right in Setup → ZMQ Block Endpoint → Fallback Poll Interval
(seconds). Leave it at 30s, or dial it up to 60s+ for a lighter touch on
your node — ZMQ still catches blocks the instant they land either way.

🧹 FIX — no more double work-restart on a new block

When ZMQ and the fallback poll noticed the same block at almost the same moment,
they could each broadcast a fresh job for it — a harmless but wasteful extra
work-restart. Block detection now records the new tip atomically, so whichever
path sees it first wins and the other stays quiet. One block, one clean job.

(Everything from v1.4.0 still applies — including the critical CashAddr
(BCH/XEC/BCH2) payout fix. If you skipped it, grab this build.)

---

💾 GET IT

Windows

• Installer (recommended): download GoVault-amd64-installer.exe, run it, launch from the Start Menu.
• Portable: download GoVault-windows-amd64.exe and double-click — no install.
• Windows 10/11 ships WebView2. If you hit a WebView2 error, grab the runtime from Microsoft.

macOS

• Apple Silicon: GoVault-macos-arm64.zip · Intel: GoVault-macos-amd64.zip
• Unzip, then right-click GoVault.app → Open (bypasses Gatekeeper; the app is unsigned). Opens normally after the first launch.

Linux

• x64: GoVault-linux-amd64 · ARM64 / Raspberry Pi: GoVault-linux-arm64

# Ubuntu 24.04+ / Pi OS Bookworm+
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0   # (…-4.0-37 on 22.04 / older)
chmod +x GoVault-linux-* && ./GoVault-linux-*

Headless (edge node / relay)

Prefer a screenless box? The govault-headless-* binaries run the same core with an HTTP + SSE dashboard — pure Go, every platform, no GUI libs required.

---

Requirements: GoVault talks to a Bitcoin Core (or compatible) node over RPC. Make sure your node is up and RPC is enabled before you start. For ZMQ instant-block mode, add -zmqpubhashblock to your node too.

  // end transmission ── mine like it's yours, because it is ──

v1.4.0

  ┌─────────────────────────────────────────────────────────────┐
  │  ▄▄ GoVault ▄▄   S T R A T U M   T E R M I N A L   //  v1.4.0 │
  │  ── an ASICpool transmission ── 0% custody · 0% bunker ──     │
  └─────────────────────────────────────────────────────────────┘

INCOMING TRANSMISSION — GoVault v1.4.0
A correctness release. If you solo-mine Bitcoin Cash (BCH), eCash (XEC),
or Bitcoin Cash II (BCH2) with a bitcoincash: / ecash: (CashAddr) payout
address, update before you mine another block.

---

🛠️ CRITICAL FIX — CashAddr payout addresses were mis-decoded (BCH / XEC / BCH2)

GoVault's CashAddr decoder read the address version byte from the wrong bit
boundary, which shifted the decoded hash by 3 bits — so a bitcoincash: /
ecash: payout address was turned into a different, valid-looking address
when the coinbase was built. The address still passed validation (its checksum
was fine), so nothing looked wrong up front — but a block found while solo-mining
BCH/XEC/BCH2 to a CashAddr would have paid the wrong destination.

• Who's affected: solo mode, coin = BCH / XEC / BCH2, payout entered as a
  CashAddr (bitcoincash:…, ecash:…, bitcoincashii:…, with or without the
  prefix). Legacy 1…/3… addresses were never affected.
• BTC, DGB, LTC, BC2 were never affected — their base58 / bech32 decoding was
  always correct. This bug was CashAddr-only.
• The fix: the version byte + hash are now decoded together from the full
  payload, so CashAddr → scriptPubKey is exact. Verified against canonical BCH
  vectors and an eCash round-trip; regression tests added so it can't drift again.

What to do: update to v1.4.0, then re-check Settings → Payout Address shows
the address you expect. If you'd been solo-mining BCH/XEC to a CashAddr, switch to
this build before continuing.

---

🛰️ ALSO IN THIS BUILD — payout-address mismatch warning

Rigs moved over from public-pool / solo.ckpool often send their wallet address
as the Stratum username — but in GoVault solo mode the coinbase pays the single
configured Payout Address, and the username is just a worker label. To stop that
mismatch from being silent, GoVault now logs a clear warning at authorize time when
a miner connects with a username that's a valid address different from your
configured payout — so "why isn't my address in the coinbase?" answers itself.

---

💾 GET IT

Windows

• Installer (recommended): download GoVault-amd64-installer.exe, run it, launch from the Start Menu.
• Portable: download GoVault-windows-amd64.exe and double-click — no install.
• Windows 10/11 ships WebView2. If you hit a WebView2 error, grab the runtime from Microsoft.

macOS

• Apple Silicon: GoVault-macos-arm64.zip · Intel: GoVault-macos-amd64.zip
• Unzip, then right-click GoVault.app → Open (bypasses Gatekeeper; the app is unsigned). Opens normally after the first launch.

Linux

• x64: GoVault-linux-amd64 · ARM64 / Raspberry Pi: GoVault-linux-arm64

# Ubuntu 24.04+ / Pi OS Bookworm+
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0   # (…-4.0-37 on 22.04 / older)
chmod +x GoVault-linux-* && ./GoVault-linux-*

Headless (edge node / relay)

Prefer a screenless box? The govault-headless-* binaries run the same core with an HTTP + SSE dashboard — pure Go, every platform, no GUI libs required.

---

Requirements: GoVault talks to a Bitcoin Core (or compatible) node over RPC. Make sure your node is up and RPC is enabled before you start. For ZMQ instant-block mode, add -zmqpubhashblock to your node too.

  // end transmission ── mine like it's yours, because it is ──

v1.3.0

  ┌─────────────────────────────────────────────────────────────┐
  │  ▄▄ GoVault ▄▄   S T R A T U M   T E R M I N A L   //  v1.3.0 │
  │  ── an ASICpool transmission ── 0% custody · 0% bunker ──     │
  └─────────────────────────────────────────────────────────────┘

INCOMING TRANSMISSION — GoVault v1.3.0
Point your machinery at your own node. Keep the block. Keep the reward.
This build tightens the loop between your node and your miners to milliseconds.

---

⚡ FEATURE SPOTLIGHT — ZMQ Instant Block Detection

GoVault no longer waits around asking your node "any new blocks yet?" on a timer. In solo mode it can now plug straight into your node's ZMQ hashblock broadcast and react the instant a new block lands on the network.

• Instant new-work broadcast. The moment your node hears a new block, GoVault pushes fresh work to every connected miner — cutting the window where your rigs waste hashes on a dead tip (fewer stale shares, less orphaned effort).
• Pure-Go ZMQ. No libzmq, no cgo, no extra install — it's baked into the single portable binary. Nothing new to deploy.
• Self-healing. ZMQ is the fast path; an RPC poll runs underneath as a heartbeat. If the ZMQ link ever hiccups, GoVault keeps mining on the poll fallback and reconnects automatically.
• Tunable. Fallback Poll interval defaults to 30s and can be dropped for fast-block coins or remote nodes so an outage can never strand you on a stale tip for long.

Switch it on: Node → ZMQ Block Endpoint → e.g. tcp://127.0.0.1:28332
Node side: run your daemon with -zmqpubhashblock=tcp://127.0.0.1:28332
Leave the field blank to stay in classic poll-only mode — no node changes required.

---

🛰️ ALSO IN THIS BUILD

• FIXED — the app now launches, everywhere. Squashed a WebView2 startup crash ("We couldn't create the data directory") that could leave the window refusing to open. GoVault now keeps its WebView2 data local to the executable, so it's fully portable and never trips over a stale %APPDATA% path again.
• NEW — ASICpool is built into the proxy. The Upstream Pool presets now lead with ASICpool endpoints for BTC, BTC (low-diff), BCH, and DGB — one click to relay your fleet to the 0% Canadian solo pool. CKPool and Public Pool remain as alternatives.
• NEW — Windows installer. Prefer Start-Menu shortcuts over a loose .exe? Grab GoVault-amd64-installer.exe below. The standalone GoVault-windows-amd64.exe is still here for portable / no-install use.

---

📥 GET IT RUNNING

Windows

• Installer (recommended): download GoVault-amd64-installer.exe, run it, launch from the Start Menu.
• Portable: download GoVault-windows-amd64.exe and double-click — no install.
• Windows 10/11 ships WebView2. If you hit a WebView2 error, grab the runtime from Microsoft.

macOS

• Apple Silicon: GoVault-macos-arm64.zip · Intel: GoVault-macos-amd64.zip
• Unzip, then right-click GoVault.app → Open (bypasses Gatekeeper; the app is unsigned). Opens normally after the first launch.

Linux

• x64: GoVault-linux-amd64 · ARM64 / Raspberry Pi: GoVault-linux-arm64

# Ubuntu 24.04+ / Pi OS Bookworm+
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0   # (…-4.0-37 on 22.04 / older)
chmod +x GoVault-linux-* && ./GoVault-linux-*

Headless (edge node / relay)

Prefer a screenless box? The govault-headless-* binaries run the same core with an HTTP + SSE dashboard — pure Go, every platform, no GUI libs required.

---

Requirements: GoVault talks to a Bitcoin Core (or compatible) node over RPC. Make sure your node is up and RPC is enabled before you start. For ZMQ instant-block mode, add -zmqpubhashblock to your node too.

  // end transmission ── mine like it's yours, because it is ──

v1.2.0

Setup Instructions

Windows (GoVault-windows-amd64.exe)

1. Download GoVault-windows-amd64.exe
2. Double-click to run — no installation needed
3. Windows 10/11 includes WebView2 by default. If you get a WebView2 error, install it from Microsoft

macOS — Apple Silicon (GoVault-macos-arm64.zip)

For M1/M2/M3/M4 Macs.

1. Download and unzip GoVault-macos-arm64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

macOS — Intel (GoVault-macos-amd64.zip)

For older Intel-based Macs.

1. Download and unzip GoVault-macos-amd64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

Linux x64 (GoVault-linux-amd64)

1. Install required dependencies:

   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-amd64
   ./GoVault-linux-amd64

Linux ARM64 / Raspberry Pi (GoVault-linux-arm64)

For Raspberry Pi 4, Pi 5, and other ARM64 boards running 64-bit OS.

1. Install required dependencies:

   # Ubuntu 24.04+ / Raspberry Pi OS Bookworm+
   sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0
   # Ubuntu 22.04 / older Raspberry Pi OS
   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-arm64
   ./GoVault-linux-arm64

---

Requirements: GoVault connects to a Bitcoin Core (or compatible) node via RPC. Make sure your node is running and RPC is enabled before starting.

v1.1.0

Setup Instructions

Windows (GoVault-windows-amd64.exe)

1. Download GoVault-windows-amd64.exe
2. Double-click to run — no installation needed
3. Windows 10/11 includes WebView2 by default. If you get a WebView2 error, install it from Microsoft

macOS — Apple Silicon (GoVault-macos-arm64.zip)

For M1/M2/M3/M4 Macs.

1. Download and unzip GoVault-macos-arm64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

macOS — Intel (GoVault-macos-amd64.zip)

For older Intel-based Macs.

1. Download and unzip GoVault-macos-amd64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

Linux x64 (GoVault-linux-amd64)

1. Install required dependencies:

   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-amd64
   ./GoVault-linux-amd64

Linux ARM64 / Raspberry Pi (GoVault-linux-arm64)

For Raspberry Pi 4, Pi 5, and other ARM64 boards running 64-bit OS.

1. Install required dependencies:

   # Ubuntu 24.04+ / Raspberry Pi OS Bookworm+
   sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0
   # Ubuntu 22.04 / older Raspberry Pi OS
   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-arm64
   ./GoVault-linux-arm64

---

Requirements: GoVault connects to a Bitcoin Core (or compatible) node via RPC. Make sure your node is running and RPC is enabled before starting.

GoVault v1.0.0 — Your Private Mining Vault

Setup Instructions

Windows (GoVault-windows-amd64.exe)

1. Download GoVault-windows-amd64.exe
2. Double-click to run — no installation needed
3. Windows 10/11 includes WebView2 by default. If you get a WebView2 error, install it from Microsoft

macOS — Apple Silicon (GoVault-macos-arm64.zip)

For M1/M2/M3/M4 Macs.

1. Download and unzip GoVault-macos-arm64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

macOS — Intel (GoVault-macos-amd64.zip)

For older Intel-based Macs.

1. Download and unzip GoVault-macos-amd64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

Linux x64 (GoVault-linux-amd64)

1. Install required dependencies:

   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-amd64
   ./GoVault-linux-amd64

Linux ARM64 / Raspberry Pi (GoVault-linux-arm64)

For Raspberry Pi 4, Pi 5, and other ARM64 boards running 64-bit OS.

1. Install required dependencies:

   # Ubuntu 24.04+ / Raspberry Pi OS Bookworm+
   sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0
   # Ubuntu 22.04 / older Raspberry Pi OS
   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-arm64
   ./GoVault-linux-arm64

---

Requirements: GoVault connects to a Bitcoin Core (or compatible) node via RPC. Make sure your node is running and RPC is enabled before starting.

v0.2.0-beta.5

What's Changed

Comprehensive code audit and stability fixes across the entire backend.

Bug Fixes — Data Races (HIGH)

• Fix data races on stratum/upstream/monitor pointers with svcMu RWMutex
• Fix data races on networkDiff/networkHashrate/blockHeight with netMu RWMutex
• Fix data race on session diff fields (currentDiff, oldDiff, diffChangeJobID) with per-session diffMu
• Fix data race on upstream pending map during reconnect (write without lock)
• Fix upstream call() stopCh path leaking pending map entries
• Reset versionRolling/versionMask before re-negotiation on upstream reconnect

Bug Fixes — Medium Priority

• GetNodeStatus(): switch to QuickClient (8s/1 retry) to avoid blocking UI up to 180s
• shutdown(): guard stopStats channel close with sync.Once to prevent double-close panic
• StatsAggregator: fix slice backing array memory leak — use in-place copy instead of [1:] trimming
• upstream.Client: add WaitGroup for readLoop/reconnectLoop goroutine tracking; Stop() now waits
• acceptLoop: retry on transient Accept errors (e.g. too many open files) instead of exiting permanently

Bug Fixes — Low Priority

• TestUpstreamConnection: replace fixed 2s sleep with channel-based job wait (returns instantly when job arrives)
• startSolo: use QuickClient for initial GBT fetch to avoid ~90s UI blocking on manual start
• SubmitShare: return "upstream disconnected" instead of empty error on nil response from closed channel
• node.Client: add Close() method for HTTP transport cleanup; called when replacing client in config update

Full Changelog: v0.2.0-beta.4...v0.2.0-beta.5

GoVault v1-beta1

Setup Instructions

Windows (GoVault-windows-amd64.exe)

1. Download GoVault-windows-amd64.exe
2. Double-click to run — no installation needed
3. Windows 10/11 includes WebView2 by default. If you get a WebView2 error, install it from Microsoft

macOS — Apple Silicon (GoVault-macos-arm64.zip)

For M1/M2/M3/M4 Macs.

1. Download and unzip GoVault-macos-arm64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

macOS — Intel (GoVault-macos-amd64.zip)

For older Intel-based Macs.

1. Download and unzip GoVault-macos-amd64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

Linux x64 (GoVault-linux-amd64)

1. Install required dependencies:

   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-amd64
   ./GoVault-linux-amd64

Linux ARM64 / Raspberry Pi (GoVault-linux-arm64)

For Raspberry Pi 4, Pi 5, and other ARM64 boards running 64-bit OS.

1. Install required dependencies:

   # Ubuntu 24.04+ / Raspberry Pi OS Bookworm+
   sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0
   # Ubuntu 22.04 / older Raspberry Pi OS
   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-arm64
   ./GoVault-linux-arm64

---

Requirements: GoVault connects to a Bitcoin Core (or compatible) node via RPC. Make sure your node is running and RPC is enabled before starting.

v0.2.0-beta.4

Setup Instructions

Windows (GoVault-windows-amd64.exe)

1. Download GoVault-windows-amd64.exe
2. Double-click to run — no installation needed
3. Windows 10/11 includes WebView2 by default. If you get a WebView2 error, install it from Microsoft

macOS — Apple Silicon (GoVault-macos-arm64.zip)

For M1/M2/M3/M4 Macs.

1. Download and unzip GoVault-macos-arm64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

macOS — Intel (GoVault-macos-amd64.zip)

For older Intel-based Macs.

1. Download and unzip GoVault-macos-amd64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

Linux x64 (GoVault-linux-amd64)

1. Install required dependencies:

   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-amd64
   ./GoVault-linux-amd64

Linux ARM64 / Raspberry Pi (GoVault-linux-arm64)

For Raspberry Pi 4, Pi 5, and other ARM64 boards running 64-bit OS.

1. Install required dependencies:

   # Ubuntu 24.04+ / Raspberry Pi OS Bookworm+
   sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0
   # Ubuntu 22.04 / older Raspberry Pi OS
   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-arm64
   ./GoVault-linux-arm64

---

Requirements: GoVault connects to a Bitcoin Core (or compatible) node via RPC. Make sure your node is running and RPC is enabled before starting.

v0.2.0-beta.2

Setup Instructions

Windows (GoVault-windows-amd64.exe)

1. Download GoVault-windows-amd64.exe
2. Double-click to run — no installation needed
3. Windows 10/11 includes WebView2 by default. If you get a WebView2 error, install it from Microsoft

macOS — Apple Silicon (GoVault-macos-arm64.zip)

For M1/M2/M3/M4 Macs.

1. Download and unzip GoVault-macos-arm64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

macOS — Intel (GoVault-macos-amd64.zip)

For older Intel-based Macs.

1. Download and unzip GoVault-macos-amd64.zip
2. Right-click GoVault.app → Open (bypasses Gatekeeper since the app is unsigned)
3. After the first launch, you can open it normally

Linux x64 (GoVault-linux-amd64)

1. Install required dependencies:

   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-amd64
   ./GoVault-linux-amd64

Linux ARM64 / Raspberry Pi (GoVault-linux-arm64)

For Raspberry Pi 4, Pi 5, and other ARM64 boards running 64-bit OS.

1. Install required dependencies:

   # Ubuntu 24.04+ / Raspberry Pi OS Bookworm+
   sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0
   # Ubuntu 22.04 / older Raspberry Pi OS
   sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37

2. Download and make executable:

   chmod +x GoVault-linux-arm64
   ./GoVault-linux-arm64

---

Requirements: GoVault connects to a Bitcoin Core (or compatible) node via RPC. Make sure your node is running and RPC is enabled before starting.