{"id":31762299,"url":"https://github.com/hamza1s34/qdesktop_wallet","last_synced_at":"2026-05-04T11:34:09.741Z","repository":{"id":318284333,"uuid":"1070618743","full_name":"Hamza1s34/Qdesktop_wallet","owner":"Hamza1s34","description":"QBitcoin Desktop Wallet - A quantum-resistant cryptocurrency wallet using Falcon-512 post-quantum signatures. Secure, cross-platform GUI wallet for QBitcoin blockchain.","archived":false,"fork":false,"pushed_at":"2025-10-06T08:13:15.000Z","size":1801,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-06T10:16:37.775Z","etag":null,"topics":["blockchain","cryptocurrency","cryptocurrency-wallet","desktop-wallet","falcon-512","linux","post-quantum-cryptography","pyqt6","qbitcoin","quantum-resistant","wallet","windows"],"latest_commit_sha":null,"homepage":"https://qbitcoin.live","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hamza1s34.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-06T07:53:01.000Z","updated_at":"2025-10-06T08:03:37.000Z","dependencies_parsed_at":"2025-10-06T10:18:30.414Z","dependency_job_id":"f4e2deb5-0efe-416b-acc2-34576056c397","html_url":"https://github.com/Hamza1s34/Qdesktop_wallet","commit_stats":null,"previous_names":["hamza1s34/qdesktop_wallet"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Hamza1s34/Qdesktop_wallet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza1s34%2FQdesktop_wallet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza1s34%2FQdesktop_wallet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza1s34%2FQdesktop_wallet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza1s34%2FQdesktop_wallet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hamza1s34","download_url":"https://codeload.github.com/Hamza1s34/Qdesktop_wallet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamza1s34%2FQdesktop_wallet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002122,"owners_count":26083307,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","cryptocurrency","cryptocurrency-wallet","desktop-wallet","falcon-512","linux","post-quantum-cryptography","pyqt6","qbitcoin","quantum-resistant","wallet","windows"],"created_at":"2025-10-09T22:17:55.238Z","updated_at":"2025-10-09T22:17:58.935Z","avatar_url":"https://github.com/Hamza1s34.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QBitcoin Desktop Wallet\n\n\u003cdiv align=\"center\"\u003e\n\n![QBitcoin Logo](https://www.qbitcoin.live/qbitcoin_logo)\n\n**A Quantum-Resistant Desktop Wallet for QBitcoin**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/downloads/)\n[![PyQt6](https://img.shields.io/badge/PyQt6-6.5+-green.svg)](https://www.riverbankcomputing.com/software/pyqt/)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20Windows-lightgrey.svg)](https://github.com/Hamza1s34/Qdesktop_wallet)\n\n[Website](https://qbitcoin.live) | [Download](https://github.com/Hamza1s34/Qdesktop_wallet/releases) | [Documentation](BUILD.md)\n\n\u003c/div\u003e\n\n---\n\n## 🌟 Features\n\n- ✅ **Quantum-Resistant Security** - Uses Falcon-512 post-quantum signatures\n- ✅ **Multi-Wallet Support** - Create and manage multiple wallets\n- ✅ **Encrypted Storage** - AES-256 encryption for private keys\n- ✅ **Transaction Management** - Send and receive QBitcoin with ease\n- ✅ **QR Code Support** - Generate and scan wallet addresses\n- ✅ **Real-time Balance** - Track your QBitcoin balance\n- ✅ **Transaction History** - View all your transactions\n- ✅ **Network Stats** - Monitor blockchain network status\n- ✅ **Cross-Platform** - Available for Linux and Windows\n- ✅ **Standalone Builds** - No Python or dependencies needed!\n\n---\n\n## 🖼️ Screenshots\n\n### Main Wallet Interface\n![Wallet Tab](docs/screenshots/wallet.png)\n\n### Send Transaction\n![Send Tab](docs/screenshots/send.png)\n\n### Receive QBitcoin\n![Receive Tab](docs/screenshots/receive.png)\n\n---\n\n## 📥 Download\n\n### Pre-built Binaries (Recommended)\n\nDownload the latest standalone executables - **no installation or dependencies required**:\n\n| Platform | Download | Size | Requirements |\n|----------|----------|------|--------------|\n| **Linux (AppImage)** | [qbitcoin_wallet_v1.0.0-x86_64.AppImage](https://github.com/Hamza1s34/Qdesktop_wallet/releases) | ~150MB | Any Linux distribution |\n| **Windows (EXE)** | [qbitcoin_wallet_v1.0.0.exe](https://github.com/Hamza1s34/Qdesktop_wallet/releases) | ~100MB | Windows 10/11 (64-bit) |\n\n#### Linux Quick Start\n```bash\nchmod +x qbitcoin_wallet_v1.0.0-x86_64.AppImage\n./qbitcoin_wallet_v1.0.0-x86_64.AppImage\n```\n\n#### Windows Quick Start\nJust double-click `qbitcoin_wallet_v1.0.0.exe`\n\n---\n\n## 🚀 Running from Source\n\n### Prerequisites\n- Python 3.8 or higher\n- pip (Python package installer)\n\n### Installation\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/Hamza1s34/Qdesktop_wallet.git\ncd Qdesktop_wallet\n```\n\n2. **Create virtual environment**\n```bash\npython3 -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n```\n\n3. **Install dependencies**\n```bash\npip install -r requirements.txt\n```\n\n4. **Run the wallet**\n```bash\npython qbitcoin_wallet.py\n```\n\n---\n\n## 🔧 Building from Source\n\n### Linux AppImage\n\n```bash\ncd appimage\nchmod +x build_appimage.sh\n./build_appimage.sh\n```\n\nOutput: `qbitcoin_wallet_v1.0.0-x86_64.AppImage` in project root\n\n### Windows EXE\n\nOn Windows:\n```bash\npython build_windows.py\n```\n\nOutput: `dist/qbitcoin_wallet_v1.0.0.exe`\n\nFor detailed build instructions, see [BUILD.md](BUILD.md)\n\n---\n\n## 📚 Documentation\n\n- **[Build Instructions](BUILD.md)** - How to build AppImage and Windows EXE\n- **[Distribution Guide](DISTRIBUTION.md)** - Standalone builds explained\n- **[API Documentation](docs/API.md)** - QBitcoin API reference\n- **[Security](docs/SECURITY.md)** - Security features and best practices\n\n---\n\n## 🛡️ Security Features\n\n### Quantum-Resistant Cryptography\n- **Falcon-512** - NIST-approved post-quantum signature scheme\n- Protects against both classical and quantum computer attacks\n\n### Wallet Security\n- **AES-256 Encryption** - Military-grade encryption for private keys\n- **Password Protection** - All wallets require strong passwords\n- **Secure Key Storage** - Private keys never leave your device\n- **Local Signing** - Transactions signed locally on your computer\n\n### Network Security\n- **gRPC Communication** - Encrypted communication with blockchain nodes\n- **Address Validation** - Prevents sending to invalid addresses\n- **Transaction Verification** - All transactions verified before broadcast\n\n---\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────┐\n│         QBitcoin Desktop Wallet         │\n├─────────────────────────────────────────┤\n│  GUI Layer (PyQt6)                      │\n│  ├── Wallet Management                  │\n│  ├── Transaction Interface              │\n│  └── Settings \u0026 Configuration           │\n├─────────────────────────────────────────┤\n│  Core Layer                             │\n│  ├── Falcon-512 Signatures              │\n│  ├── Wallet Encryption (AES-256)        │\n│  ├── Key Management                     │\n│  └── Transaction Building               │\n├─────────────────────────────────────────┤\n│  Network Layer                          │\n│  ├── gRPC API Client                    │\n│  ├── Node Communication                 │\n│  └── Blockchain Queries                 │\n└─────────────────────────────────────────┘\n```\n\n---\n\n## 📋 Requirements\n\n### Runtime (Standalone Builds)\n- **Linux**: Any modern distribution with kernel 2.6.32+\n- **Windows**: Windows 10 or 11 (64-bit)\n- **No Python or libraries required!**\n\n### Development\n- Python 3.8+\n- PyQt6 \u003e= 6.5.0\n- grpcio \u003e= 1.60.0\n- cryptography \u003e= 41.0.0\n- qrcode \u003e= 7.4.2\n- Pillow \u003e= 10.0.0\n\nSee [requirements.txt](requirements.txt) for complete list.\n\n---\n\n## 🗂️ Project Structure\n\n```\nQdesktop_wallet/\n├── qbitcoin_wallet.py       # Main application\n├── wallet_creator.py        # Wallet creation logic\n├── wallet_encryption.py     # Encryption/decryption\n├── wallet_storage.py        # Wallet storage management\n├── api_client.py            # QBitcoin API client\n├── falcon.py                # Falcon-512 implementation\n├── generated/               # gRPC generated code\n├── asessts/                 # Icons and images\n├── appimage/                # Linux AppImage build\n├── build_windows.py         # Windows build script\n└── requirements.txt         # Python dependencies\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## 🐛 Bug Reports\n\nFound a bug? Please open an issue with:\n- Description of the problem\n- Steps to reproduce\n- Expected behavior\n- Screenshots (if applicable)\n- System information (OS, version, etc.)\n\n---\n\n## 📞 Support\n\n- **Website**: [https://qbitcoin.live](https://qbitcoin.live)\n- **Issues**: [GitHub Issues](https://github.com/Hamza1s34/Qdesktop_wallet/issues)\n- **Email**: support@qbitcoin.live\n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## ⚠️ Disclaimer\n\nThis software is provided \"as is\", without warranty of any kind. Always backup your wallet files and never share your private keys or passwords.\n\n---\n\n## 🙏 Acknowledgments\n\n- **QBitcoin Team** - For the quantum-resistant blockchain\n- **PyQt6** - For the excellent GUI framework\n- **Falcon Team** - For the post-quantum cryptography\n- **Community** - For testing and feedback\n\n---\n\n## 🔮 Future Roadmap\n\n- [ ] Multi-signature wallet support\n- [ ] Hardware wallet integration\n- [ ] Mobile app (Android/iOS)\n- [ ] Built-in exchange integration\n- [ ] Advanced transaction features\n- [ ] Staking interface\n- [ ] Multi-language support\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ for the QBitcoin Community**\n\n[⬆ Back to Top](#qbitcoin-desktop-wallet)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamza1s34%2Fqdesktop_wallet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhamza1s34%2Fqdesktop_wallet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhamza1s34%2Fqdesktop_wallet/lists"}