Qubic.NET Wallet

Cross-platform desktop wallet for the Qubic network. Runs as a native desktop window via Photino.Blazor, or as a Blazor Server app in the browser with --server.

Important

Seed Safety — The Wallet never shares or sends your seed to the network. Your seed is only held locally in memory while the application is running. Close the app when you are not actively using it. Qubic will never contact you to ask for your seed — DO NOT SHARE your seed with anyone.

Features

• Dashboard — identity, QU balance, network status, owned assets, and open orders at a glance
• Networks — switch between Mainnet, a local AIO Dev Kit and your own networks from the header; each network uses Bob, RPC and/or direct node connections, with a per-operation choice and no silent fallback to other servers (guide)
• Network check — identifies the connected chain (Mainnet, core-lite devnet) and warns when it does not match the settings; detects chain resets on test networks
• Signing review — every signature, from the wallet, a dApp or a script, goes through one review showing the network, decoded contract call, target tick and warnings (guide)
• Replay protection warnings — warns when a seed signs on both Mainnet and a test network, and when public dev keys meet Mainnet
• Target tick by time — schedule transactions "in ~N seconds" besides the fixed tick offset
• Send / Receive — single transfers with QR code support, qubic: payment requests with amount and message, batch "Send to Many" with reusable templates
• Encrypted Vault — password-protected vault stores multiple seeds and an address book, encrypted with AES-256-GCM; any vault works on any network
• Vault switching — pick a recently used vault file (or browse to another one) straight from the header bar, without going through settings
• Address Book — save contacts and quickly select them from any address input with autocomplete
• Assets — view and transfer QX-listed tokens
• QX Trading — place and cancel asset orders on the Qubic DEX
• Qearn Staking — lock/unlock QU for staking rewards
• Qswap DEX — decentralized token swap interface
• MSVault — multi-signature vault management (create, deposit, release, approve/deny)
• Community Voting — view active proposals and cast votes
• SC Auction — bid on smart contract slots
• Transaction History — full history with local encrypted storage and sync, kept per network
• Sign / Verify — sign messages with your seed and verify signatures
• Settings — networks, optional features, peer management, label sources, theme toggle, database import/export

Optional features, all off until you turn them on (guide):

• Developer tools — public dev accounts, faucet, asset issuance and a Contract Console that calls any contract, including your own imported from its C++ header (guide)
• Sign-In with Qubic — structured website logins, checked field by field
• WalletConnect — connect to dApps with the official Qubic method set (guide)
• Local signing endpoint — JSON-RPC on 127.0.0.1 for scripts and contract tests (guide)
• Remote labels — names and fees from the public Qubic data bundle

New to local development? The AIO tutorial sets up a private Qubic testnet and walks through funding, transfers, assets and calling your own contract with the wallet.

Running Pre-Built Releases

Download the latest release for your platform from the Releases page.

Important

Always verify the SHA-256 hashes to ensure files have not been tampered with.

Verify the zip download against the .zip.sha256 file published alongside each release:

# Windows (PowerShell)
Get-FileHash Qubic.Net.Wallet-win-x64.zip -Algorithm SHA256

# macOS / Linux
sha256sum -c Qubic.Net.Wallet-linux-x64.zip.sha256

Verify the binary after extracting — each zip contains a .sha256 file for the binary:

# Windows (PowerShell)
Get-FileHash Qubic.Net.Wallet.exe -Algorithm SHA256

# macOS / Linux
sha256sum -c Qubic.Net.Wallet.sha256

Windows

1. Download and extract Qubic.Net.Wallet-win-x64.zip
2. Open the Qubic.Net.Wallet-win-x64 folder and run Qubic.Net.Wallet.exe

To run in server mode (opens in browser instead of native window):

Qubic.Net.Wallet.exe --server

macOS

Requires macOS 12 (Monterey) or later.

1. Download the zip for your architecture:
   • Apple Silicon (M1/M2/M3/M4): Qubic.Net.Wallet-osx-arm64.zip
   • Intel: Qubic.Net.Wallet-osx-x64.zip
2. Extract and run:

unzip Qubic.Net.Wallet-osx-arm64.zip
cd Qubic.Net.Wallet-osx-arm64
chmod +x Qubic.Net.Wallet
codesign --force --deep -s - Qubic.Net.Wallet
xattr -d com.apple.quarantine Qubic.Net.Wallet
./Qubic.Net.Wallet

Tip: If macOS Gatekeeper blocks the app, you can also right-click (or Control-click) the binary in Finder and select Open to bypass the warning.

Linux

Desktop mode requires GLIBC 2.38+ and WebKitGTK:

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.1-0

1. Download and extract Qubic.Net.Wallet-linux-x64.zip
2. Run:

cd Qubic.Net.Wallet-linux-x64
chmod +x Qubic.Net.Wallet
./Qubic.Net.Wallet

If desktop mode is not supported on your system, the app automatically falls back to server mode. To run in server mode directly:

./Qubic.Net.Wallet --server

Running From Source

Requires .NET 8.0 SDK.

git clone --recursive https://github.com/qubic/Qubic.Net.Wallet.git
cd Qubic.Net.Wallet

# Desktop mode (native window)
dotnet run

# Server mode (opens in browser)
dotnet run -- --server

Note: The --recursive flag is required to fetch the Qubic.Net submodule under deps/.

Release Builds

./publish.sh

Produces zip archives with SHA-256 hashes for:

• win-x64
• osx-x64
• osx-arm64
• linux-x64

Security

• Your 55-character seed is held in memory only for the current session — it is never written to disk unencrypted
• Vault encryption: Seeds and contacts are stored in an AES-256-GCM encrypted vault file, protected by a user-chosen password with Argon2id key derivation (m=64 MiB, t=3, p=1). Vaults written by older versions of this wallet used PBKDF2-HMAC-SHA256 (600 000 iterations) and are read transparently — they re-encrypt to Argon2id automatically on the next save
• The local database is encrypted with SQLCipher using a key derived from your seed
• In server mode, access is protected by a one-time session token (HttpOnly cookie, localhost only)
• The database and vault files are useless without the respective passwords/seeds

Warning

Server mode uses unencrypted HTTP on localhost. A local proxy or other software on the same machine could intercept the communication between your browser and the app, including your seed. Prefer desktop mode when possible. Only use --server on machines you fully trust.

Architecture

• UI: Blazor components with Bootstrap 5 dark theme
• Desktop: Photino.Blazor (WebView2 on Windows, WebKit on macOS/Linux)
• Server fallback: Blazor Server with auto-launched browser (--server flag, or automatic fallback if native libraries are unavailable)
• Storage: SQLCipher-encrypted SQLite per identity
• Backends: network profiles combining RPC, Bob and direct TCP to Qubic nodes; every request stays inside the active network
• Libraries: Qubic.Net included as a git submodule under deps/

Documentation

The user guide covers networks, signing, optional features, developer tools, WalletConnect and the local signing endpoint. See RELEASE_NOTES.md for changes per version.

Screenshots

Network settings and method per operation	Signing review with a decoded contract call
Developer tools on an AIO devnet	Contract Console with an imported header
Payment request	WalletConnect