Skip to content
 
 

Repository files navigation

ZClassic Wallet

A private, single-file ZClassic wallet — with a full ZClassic node built right in. One download, no setup, no command line. For Windows, macOS, and Linux.

New here? Download the one file for your computer below, open it, and wait for the progress bar. That's the whole setup.

ZclWallet — your balance, shielded and transparent Friendly first-run setup

Download & run

Latest release: v2.1.2-beta6 — always grab whatever GitHub marks as Latest: https://github.com/ZclassicCommunity/zcl-qt-wallet/releases/latest

Download the one file for your computer and open it:

Your computer Download First-time open
Windows zclwallet-v2.1.2-beta6-win64.exe Double-click. If you see "Windows protected your PC", click More info → Run anyway.
macOS (Apple Silicon) zclwallet-v2.1.2-beta6-macos-arm64.dmg Open the .dmg and drag ZclWallet to Applications. On first launch macOS says "Apple could not verify … is free from malware" — that's expected (the app is signed but not yet notarized). See Opening on macOS just below.
Linux zclwallet-v2.1.2-beta6-linux-x86_64 chmod +x zclwallet-v2.1.2-beta6-linux-x86_64 && ./zclwallet-v2.1.2-beta6-linux-x86_64 — or right-click → Properties → Allow executing as program, then double-click. (glibc ≥ 2.29; no Qt install needed.)

Opening on macOS

The first time you open the wallet, macOS shows "Apple could not verify "ZclWallet" is free from malware that may harm your Mac." This is normal for a community app that isn't notarized by Apple — the download is fine. Do this once:

  • macOS 14 Sonoma / 15 Sequoia: double-click the app, click Done, then open System Settings → Privacy & Security, scroll down to Security, and click Open Anyway next to the ZclWallet message → confirm with Touch ID / password.
  • macOS 13 and earlier: right-click (Control-click) the app → Open → Open.
  • Any version (Terminal): xattr -dr com.apple.quarantine /Applications/ZclWallet.app, then open it normally.

After the first time, it opens like any other app. (A future build will be notarized so this prompt goes away.)

What happens on first launch

The wallet starts its built-in node, which automatically downloads its security files and a recent copy of the blockchain (a few GB) from the network — all checked for integrity, with a progress bar. Depending on your connection, this can take a little while. When it finishes, your wallet opens. That is the entire setup — there's nothing to download or configure by hand.

Your coins live in wallet.dat. The app only ever backs it up — it never modifies it.

Your privacy

ZClassic supports shielded z-addresses, which keep your balances and transfers private.

  • The Receive tab gives you a shielded z-Sapling address by default.
  • The Balance tab shows your Shielded and Transparent funds separately, plus the Total — so you always know what's private and what's public.

The tabs are: Balance · Send · Receive · Transactions · zclassicd.

Verify your download

Each release includes SHA256SUMS.txt. To check a file matches:

  • Linux: sha256sum <file>
  • macOS: shasum -a 256 <file>
  • Windows: certutil -hashfile <file> SHA256

Compare the result against the matching line in SHA256SUMS.txt.

Run a node only

The wallet runs its own embedded zclassicd automatically — most people never think about it. If you already run a ZClassic node, the wallet connects to that instead.

To run a node only (no GUI, e.g. on a server), download zclassicd from the zclassic release and run it — no flags or config needed. It fetches the params and a snapshot and syncs by itself.

(To run the wallet itself without the GUI, pass --headless.)

Build from source

This wallet is C++14 + Qt 5.15. Full, copy-pasteable instructions for all three platforms (native + cross-compile, single-file packaging, code-signing) are in:

  • docs/BUILDING.md — the wallet (GUI + single-file).
  • AGENTS.md — the cross-repo build quickstart (also in the zclassic node repo, alongside doc/building-daemon-from-source.md).

Quick Linux dev build:

git clone https://github.com/ZclassicCommunity/zcl-qt-wallet.git
cd zcl-qt-wallet
/path/to/qt5/bin/qmake zcl-qt-wallet.pro CONFIG+=release && make -j$(nproc)

Building from source produces the GUI without an embedded node by default — run an external zclassicd, or use contrib/make-allinone.sh to embed one. See docs/BUILDING.md.

Help

File an issue for support or bug reports.

ZclWallet is a community wallet and is not affiliated with the Electric Coin Company.

About

A z-Addr first full node and UI wallet for zcash

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages