Repository navigation
ZClassic Wallet v2.1.2-beta12 — Windows, Linux and macOS
Pre-releaseBeta12 fixes the upgrade experience for existing wallets on Windows, Linux and macOS that continued syncing old blocks instead of using the compiled checkpoint.
Download the beta12 wallet for your platform, close the older wallet normally, and open the new one. Keep your existing wallet and data directory. No repair menu or extra fast-sync button is needed.
For the wallet's own mainnet node more than 100,000 blocks below checkpoint 3,126,937, when bootstrap was skipped because an existing chain is present, the GUI automatically:
- waits for its node to save the wallet and stop;
- makes a private, verified wallet backup and preserves the old chain through the existing recovery journal;
- restarts into the verified checkpoint download, then validates newer blocks and scans the wallet.
This requires at least 15 GiB of free space for the downloaded copy alongside the preserved chain. External nodes, test networks, explicit bootstrap opt-outs, active downloads, pending verification and nearly caught-up chains are left unchanged. A per-directory attempt marker prevents repeated chain replacement. Quitting or replacing the connection during shutdown cancels before file movement.
The update also fixes a crash when a replacement connection cleared the node process pointer during shutdown. Normal wallet exit remains bounded; automatic migration waits for its original node's flush and remains cancellable.
The embedded beta11 backend and consensus rules are unchanged. Snapshot download and verification, later-block validation and wallet scanning still take time. This does not promise instant synchronization or a universal speedup.
Available here: Windows x86_64 portable wallet, Linux x86_64 wallet, and macOS Apple Silicon DMG, all beta12. The three standalone node archives are the unchanged, previously verified beta11 binaries and retain beta11 filenames. Download a wallet for the GUI, or a node archive for command-line use. SHA256SUMS.txt covers all six packages; BUILDINFO.txt records source identity and verification.
Linux requires glibc 2.31+ and system X11/XCB/font libraries. Mac requires macOS 15+ on Apple Silicon; it was tested on macOS 26. Intel Mac builds are not supplied.
Validation: Windows logic 149 passed / 0 failed / 3 existing skips; UI 66 passed / 0 failed / 1 existing deferred skip. Automatic migration fixtures cover completion, quit, failed replacement and competing requests, checking wallet and chain preservation. Real isolated Windows regtest transactions passed transparent sends, shielding, shielded sends with memos, unshielding, confirmations, and exact balances/fees. No user funds or keys were used; no funded public-mainnet migration is claimed.
Linux release build 43918732284 passed at the release commit, including dependency, embedded daemon, cache and HTTPS checks. Native Mac logic passed 150 cases with 2 existing skips. Its initial UI run had one debounce timing failure; 20 unchanged focused repetitions and the full rerun passed (62 cases, 1 existing deferred skip). Mounted DMG metadata, permissions, signatures and bundled backend hash passed. See BUILDINFO.txt for details.
Windows binaries are unsigned; Mac apps are ad-hoc signed and not Apple-notarized. OS security/reputation prompts may still appear. Verify downloads against SHA256SUMS.txt. GUI source was merged in PR158, release commit 448f65b. Consensus and backend implementation remain unchanged.