Qubic.Toolkit

A cross-platform desktop application for interacting with the Qubic network. Runs as a native desktop window on Windows, macOS, and Linux — or as a local web app in your browser with --server mode.

Note

Beta Software — This tool is a playground and under active development. Errors may occur. Use it with caution.

Important

Seed Safety — The Toolkit 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

• Wallet management with seed-based identity
• Transaction building and broadcasting (via RPC, Bob, or direct TCP)
• Smart contract interaction (Qx, QUtil, and more)
• Real-time tick monitoring
• Transaction tracking
• Asset registry browsing
• Oracle machine queries

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.Toolkit-win-x64.zip -Algorithm SHA256

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

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

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

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

Windows

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

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

Qubic.Net.Toolkit.exe --server

macOS

Requires macOS 12 (Monterey) or later.

Note

Pre-built macOS binaries only support server mode (--server). Native desktop window mode requires compiling from source.

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

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

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. Supported distributions:

Distribution	Version	Desktop Mode	Server Mode
Ubuntu	24.04+ (Noble)	Yes	Yes
Debian	13+ (Trixie)	Yes	Yes
Fedora	39+	Yes	Yes
Arch Linux	Rolling	Yes	Yes
Ubuntu	22.04 (Jammy)	No	Yes
Debian	12 (Bookworm)	No	Yes

Install WebKitGTK for desktop mode:

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

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

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

If desktop mode is not supported on your system, the app automatically falls back to server mode.

To run in server mode directly (no GLIBC 2.38 or WebKitGTK required):

./Qubic.Net.Toolkit --server

Running From Source

Requires .NET 8.0 SDK.

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

# 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

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

• SDK: Microsoft.NET.Sdk.Razor with FrameworkReference to Microsoft.AspNetCore.App
• Desktop: Photino.Blazor 4.0.13 renders Blazor components in a native OS webview
• Server: Standard Blazor Server with interactive server-side rendering
• Static assets: Bootstrap 5.3.2 and Bootstrap Icons 1.11.3 bundled locally (no CDN)
• Single-file publish: wwwroot is embedded as a zip resource and extracted to %LOCALAPPDATA%/Qubic.Toolkit on first run (auto-refreshes when the build changes)
• Libraries: Qubic.Net included as a git submodule under deps/

Screenshots