Skip to content

QBitcoin Desktop Wallet - A quantum-resistant cryptocurrency wallet using Falcon-512 post-quantum signatures. Secure, cross-platform GUI wallet for QBitcoin blockchain.

Notifications You must be signed in to change notification settings

Hamza1s34/Qdesktop_wallet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

QBitcoin Desktop Wallet

QBitcoin Logo

A Quantum-Resistant Desktop Wallet for QBitcoin

Python PyQt6 License Platform

Website | Download | Documentation


๐ŸŒŸ Features

  • โœ… Quantum-Resistant Security - Uses Falcon-512 post-quantum signatures
  • โœ… Multi-Wallet Support - Create and manage multiple wallets
  • โœ… Encrypted Storage - AES-256 encryption for private keys
  • โœ… Transaction Management - Send and receive QBitcoin with ease
  • โœ… QR Code Support - Generate and scan wallet addresses
  • โœ… Real-time Balance - Track your QBitcoin balance
  • โœ… Transaction History - View all your transactions
  • โœ… Network Stats - Monitor blockchain network status
  • โœ… Cross-Platform - Available for Linux and Windows
  • โœ… Standalone Builds - No Python or dependencies needed!

๐Ÿ–ผ๏ธ Screenshots

Main Wallet Interface

Wallet Tab

Send Transaction

Send Tab

Receive QBitcoin

Receive Tab


๐Ÿ“ฅ Download

Pre-built Binaries (Recommended)

Download the latest standalone executables - no installation or dependencies required:

Platform Download Size Requirements
Linux (AppImage) qbitcoin_wallet_v1.0.0-x86_64.AppImage ~150MB Any Linux distribution
Windows (EXE) qbitcoin_wallet_v1.0.0.exe ~100MB Windows 10/11 (64-bit)

Linux Quick Start

chmod +x qbitcoin_wallet_v1.0.0-x86_64.AppImage
./qbitcoin_wallet_v1.0.0-x86_64.AppImage

Windows Quick Start

Just double-click qbitcoin_wallet_v1.0.0.exe


๐Ÿš€ Running from Source

Prerequisites

  • Python 3.8 or higher
  • pip (Python package installer)

Installation

  1. Clone the repository
git clone https://github.com/Hamza1s34/Qdesktop_wallet.git
cd Qdesktop_wallet
  1. Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies
pip install -r requirements.txt
  1. Run the wallet
python qbitcoin_wallet.py

๐Ÿ”ง Building from Source

Linux AppImage

cd appimage
chmod +x build_appimage.sh
./build_appimage.sh

Output: qbitcoin_wallet_v1.0.0-x86_64.AppImage in project root

Windows EXE

On Windows:

python build_windows.py

Output: dist/qbitcoin_wallet_v1.0.0.exe

For detailed build instructions, see BUILD.md


๐Ÿ“š Documentation


๐Ÿ›ก๏ธ Security Features

Quantum-Resistant Cryptography

  • Falcon-512 - NIST-approved post-quantum signature scheme
  • Protects against both classical and quantum computer attacks

Wallet Security

  • AES-256 Encryption - Military-grade encryption for private keys
  • Password Protection - All wallets require strong passwords
  • Secure Key Storage - Private keys never leave your device
  • Local Signing - Transactions signed locally on your computer

Network Security

  • gRPC Communication - Encrypted communication with blockchain nodes
  • Address Validation - Prevents sending to invalid addresses
  • Transaction Verification - All transactions verified before broadcast

๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚         QBitcoin Desktop Wallet         โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  GUI Layer (PyQt6)                      โ”‚
โ”‚  โ”œโ”€โ”€ Wallet Management                  โ”‚
โ”‚  โ”œโ”€โ”€ Transaction Interface              โ”‚
โ”‚  โ””โ”€โ”€ Settings & Configuration           โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Core Layer                             โ”‚
โ”‚  โ”œโ”€โ”€ Falcon-512 Signatures              โ”‚
โ”‚  โ”œโ”€โ”€ Wallet Encryption (AES-256)        โ”‚
โ”‚  โ”œโ”€โ”€ Key Management                     โ”‚
โ”‚  โ””โ”€โ”€ Transaction Building               โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Network Layer                          โ”‚
โ”‚  โ”œโ”€โ”€ gRPC API Client                    โ”‚
โ”‚  โ”œโ”€โ”€ Node Communication                 โ”‚
โ”‚  โ””โ”€โ”€ Blockchain Queries                 โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“‹ Requirements

Runtime (Standalone Builds)

  • Linux: Any modern distribution with kernel 2.6.32+
  • Windows: Windows 10 or 11 (64-bit)
  • No Python or libraries required!

Development

  • Python 3.8+
  • PyQt6 >= 6.5.0
  • grpcio >= 1.60.0
  • cryptography >= 41.0.0
  • qrcode >= 7.4.2
  • Pillow >= 10.0.0

See requirements.txt for complete list.


๐Ÿ—‚๏ธ Project Structure

Qdesktop_wallet/
โ”œโ”€โ”€ qbitcoin_wallet.py       # Main application
โ”œโ”€โ”€ wallet_creator.py        # Wallet creation logic
โ”œโ”€โ”€ wallet_encryption.py     # Encryption/decryption
โ”œโ”€โ”€ wallet_storage.py        # Wallet storage management
โ”œโ”€โ”€ api_client.py            # QBitcoin API client
โ”œโ”€โ”€ falcon.py                # Falcon-512 implementation
โ”œโ”€โ”€ generated/               # gRPC generated code
โ”œโ”€โ”€ asessts/                 # Icons and images
โ”œโ”€โ”€ appimage/                # Linux AppImage build
โ”œโ”€โ”€ build_windows.py         # Windows build script
โ””โ”€โ”€ requirements.txt         # Python dependencies

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ› Bug Reports

Found a bug? Please open an issue with:

  • Description of the problem
  • Steps to reproduce
  • Expected behavior
  • Screenshots (if applicable)
  • System information (OS, version, etc.)

๐Ÿ“ž Support


๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


โš ๏ธ Disclaimer

This software is provided "as is", without warranty of any kind. Always backup your wallet files and never share your private keys or passwords.


๐Ÿ™ Acknowledgments

  • QBitcoin Team - For the quantum-resistant blockchain
  • PyQt6 - For the excellent GUI framework
  • Falcon Team - For the post-quantum cryptography
  • Community - For testing and feedback

๐Ÿ”ฎ Future Roadmap

  • Multi-signature wallet support
  • Hardware wallet integration
  • Mobile app (Android/iOS)
  • Built-in exchange integration
  • Advanced transaction features
  • Staking interface
  • Multi-language support

Made with โค๏ธ for the QBitcoin Community

โฌ† Back to Top

About

QBitcoin Desktop Wallet - A quantum-resistant cryptocurrency wallet using Falcon-512 post-quantum signatures. Secure, cross-platform GUI wallet for QBitcoin blockchain.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages