Skip to content

blocknetprivacy/blocknet-gui

Repository files navigation

Blocknet

Blocknet Wallet

A private, self-contained desktop wallet for the Blocknet blockchain.
Built with Tauri v2. No CDNs. No telemetry. No remote calls.

image

Download

Grab the latest release for your platform from Releases.

Platform File Architecture
macOS .dmg Apple Silicon (arm64)
Linux .deb, .AppImage x86_64
Windows .exe (NSIS installer) x86_64

Verify checksums

Every release includes a SHA256SUMS.txt. After downloading, verify your file:

# macOS / Linux
sha256sum -c SHA256SUMS.txt

# or check a single file
sha256sum blocknet-arm64-darwin-blocknet_0.3.1_aarch64.dmg

On Windows (PowerShell):

Get-FileHash .\blocknet-amd64-windows-blocknet_0.3.1_x64-setup.exe -Algorithm SHA256

Compare the output against the hash in SHA256SUMS.txt.


Platform Notes

macOS ; "damaged" or unidentified developer warning

This app is not notarized with Apple. macOS will quarantine it on first launch. To fix this, open Terminal and run:

xattr -cr /Applications/blocknet.app

Then open the app normally. You only need to do this once.

Windows ; antivirus false positives

Windows Defender, Bitdefender, and other antivirus software may flag the installer or the bundled blockchain daemon as suspicious. This is a false positive ; it happens because:

  • The binaries are not signed with an EV code signing certificate
  • The bundled daemon (blocknet-amd64-windows.exe) is a cryptocurrency node, which heuristic scanners often flag by default
  • NSIS installers from unsigned publishers are commonly flagged

To proceed:

  • Windows Defender: Click "More info" then "Run anyway"
  • Bitdefender: Add an exception for the install directory, or temporarily disable Advanced Threat Defense during installation
  • Other AV: Add the Blocknet install folder to your exclusions list

The source code is public and the binaries are built in CI from this repo ; you can verify the build yourself.

Linux

No special steps. Install the .deb or run the .AppImage directly:

# Debian/Ubuntu
sudo dpkg -i blocknet-amd64-linux-blocknet_0.3.1_amd64.deb

# AppImage
chmod +x blocknet-amd64-linux-blocknet_0.3.1_amd64.AppImage
./blocknet-amd64-linux-blocknet_0.3.1_amd64.AppImage

Payment Links (blocknet://)

The wallet registers itself as a handler for blocknet:// URIs. Clicking a blocknet:// link in a browser or anywhere on the system opens the wallet and pre-fills the Send form.

Format:

blocknet://ADDRESS?amount=AMOUNT&memo=MEMO

All query parameters are optional. A bare blocknet://ADDRESS works too.

Try it: blocknet://$rock?amount=100&memo=i love blocknet

Generating links:

Use case URI
Address only blocknet://BaJFy1VnFSKEo5wMn2CAhKhqariEnMDsFg
With amount blocknet://BaJFy1VnFSKEo5wMn2CAhKhqariEnMDsFg?amount=50
With memo blocknet://$rock?amount=100&memo=i%20love%20blocknet

Services can generate these links for invoices, donation buttons, or payment requests. The user always reviews and manually confirms before anything is sent.


Privacy

This wallet makes zero network requests to external services. There are no analytics, no CDNs, no Google Fonts, no remote scripts.

The only network activity is local HTTP JSON API communication between the wallet UI and the bundled Blocknet daemon on 127.0.0.1. The daemon itself communicates with the Blocknet peer-to-peer network, that's it.


Build from Source

Requires Node.js 20+, Rust, and platform-specific dependencies.

macOS

npm install
npx tauri build --config '{"bundle":{"targets":["app"],"resources":["binaries/blocknet-aarch64-apple-darwin"]}}'

Linux

sudo apt-get install -y libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev patchelf
npm install
npx tauri build --config '{"bundle":{"targets":["deb","appimage"],"resources":["binaries/blocknet-amd64-linux"]}}'

Windows

Requires Build Tools for Visual Studio with the C++ workload.

npm install
npx tauri build --config '{"bundle":{"targets":["nsis"],"resources":["binaries/blocknet-amd64-windows.exe"]}}'

Development

npm install
npm run dev

License

BSD-3-Clause ; Copyright 2026 Blocknet Privacy