# Qbitcoin
A Python-based cryptocurrency implementation with quantum-resistant features.
## Features
- Quantum-resistant cryptography using Falcon signatures
- Proof-of-Work consensus mechanism
- Multi-signature support
- Token transactions
- Web-based GUI interface
- gRPC API services
- Comprehensive testing suite
## Project Structure
- `qbitcoin/` - Core blockchain implementation
- `core/` - Blockchain core components (blocks, transactions, miners)
- `crypto/` - Cryptographic functions and quantum-resistant algorithms
- `daemon/` - Wallet daemon services
- `services/` - Network and API services
- `generated/` - Protocol buffer generated files
- `gui/` - Web-based graphical user interface
- `scripts/` - Utility scripts for various operations
- `tests/` - Comprehensive test suite
## Installation
## 1 using pip
```bash
pip install qbitcoin
```
## then run the smart installer
install build dependcies
```bash
sudo apt install -y build-essential cmake swig python3-dev libssl-dev libboost-all-dev libuv1-dev
```
after this run smart installer
```bash
python3 -m qbitcoin.smart_installer
```
after installing type 'qbitcoin' in terminal to start node
For mining
```bash
qbitcoin --miningAddress <your qbitcoin address>
```
if you want to run directly
1. Clone the repository:
```bash
git clone https://github.com/Hamza1s34/Qbitcoin.git
cd Qbitcoin
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the node:
```bash
python start_qbitcoin.py
```
## Usage
### GUI Mode
Launch the graphical interface:
```bash
python gui/qbitcoin_gui.py
```
### CLI Mode
Use the command-line interface:
```bash
python -m qbitcoin.cli
```
### Scripts
Various utility scripts are available in the `scripts/` directory for operations like:
- Creating transactions
- Token management
- Multi-signature operations
- Address debugging
## Testing
Run the test suite:
```bash
pytest tests/
```
## Note
Please note that this project is in the final development phase, so some files and features may be incomplete. If you observe any issues, kindly provide feedback or open an issue on the repository. Your input is greatly appreciated!
## Credits
This project is based on the [QRL (Quantum Resistant Ledger)](https://github.com/theQRL/QRL) source code. We have modified and adapted the original QRL implementation to create Qbitcoin with enhanced features and improvements.
**Original Source Code:** [QRL - Quantum Resistant Ledger](https://github.com/theQRL/QRL.git)
We acknowledge and appreciate the foundational work done by the QRL development team in creating a quantum-resistant blockchain platform. This project builds upon their innovative approach to post-quantum cryptography in blockchain technology.
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request
## License
This project is open source. Please see the LICENSE file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/Hamza1s34/Qbitcoin",
"name": "qbitcoin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cryptocurrency, blockchain, quantum-resistant, falcon, post-quantum",
"author": "Hamza",
"author_email": "Hamza <hamza@qbitcoin.dev>",
"download_url": "https://files.pythonhosted.org/packages/9e/1f/7393d7bbcc2aedd7e939f13e7724f24d3bb5ba8dd81aa8a1a027f2186ee8/qbitcoin-1.1.1.tar.gz",
"platform": null,
"description": "# Qbitcoin\n\nA Python-based cryptocurrency implementation with quantum-resistant features.\n\n## Features\n\n- Quantum-resistant cryptography using Falcon signatures\n- Proof-of-Work consensus mechanism\n- Multi-signature support\n- Token transactions\n- Web-based GUI interface\n- gRPC API services\n- Comprehensive testing suite\n\n## Project Structure\n\n- `qbitcoin/` - Core blockchain implementation\n - `core/` - Blockchain core components (blocks, transactions, miners)\n - `crypto/` - Cryptographic functions and quantum-resistant algorithms\n - `daemon/` - Wallet daemon services\n - `services/` - Network and API services\n - `generated/` - Protocol buffer generated files\n- `gui/` - Web-based graphical user interface\n- `scripts/` - Utility scripts for various operations\n- `tests/` - Comprehensive test suite\n\n## Installation\n\n## 1 using pip \n\n```bash\npip install qbitcoin\n```\n## then run the smart installer \ninstall build dependcies\n```bash\n sudo apt install -y build-essential cmake swig python3-dev libssl-dev libboost-all-dev libuv1-dev\n```\nafter this run smart installer \n```bash\npython3 -m qbitcoin.smart_installer \n```\nafter installing type 'qbitcoin' in terminal to start node \n\n\nFor mining \n ```bash\nqbitcoin --miningAddress <your qbitcoin address>\n```\n\nif you want to run directly \n\n1. Clone the repository:\n```bash\ngit clone https://github.com/Hamza1s34/Qbitcoin.git\ncd Qbitcoin\n```\n\n2. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n3. Run the node:\n```bash\npython start_qbitcoin.py\n```\n\n## Usage\n\n### GUI Mode\nLaunch the graphical interface:\n```bash\npython gui/qbitcoin_gui.py\n```\n\n### CLI Mode\nUse the command-line interface:\n```bash\npython -m qbitcoin.cli\n```\n\n### Scripts\nVarious utility scripts are available in the `scripts/` directory for operations like:\n- Creating transactions\n- Token management\n- Multi-signature operations\n- Address debugging\n\n## Testing\n\nRun the test suite:\n```bash\npytest tests/\n```\n## Note \nPlease note that this project is in the final development phase, so some files and features may be incomplete. If you observe any issues, kindly provide feedback or open an issue on the repository. Your input is greatly appreciated!\n\n## Credits\n\nThis project is based on the [QRL (Quantum Resistant Ledger)](https://github.com/theQRL/QRL) source code. We have modified and adapted the original QRL implementation to create Qbitcoin with enhanced features and improvements.\n\n**Original Source Code:** [QRL - Quantum Resistant Ledger](https://github.com/theQRL/QRL.git)\n\nWe acknowledge and appreciate the foundational work done by the QRL development team in creating a quantum-resistant blockchain platform. This project builds upon their innovative approach to post-quantum cryptography in blockchain technology.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests for new functionality\n5. Submit a pull request\n\n## License\n\nThis project is open source. Please see the LICENSE file for details.\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python-based cryptocurrency implementation with quantum-resistant features",
"version": "1.1.1",
"project_urls": {
"Documentation": "https://github.com/Hamza1s34/Qbitcoin",
"Homepage": "https://github.com/Hamza1s34/Qbitcoin",
"Issues": "https://github.com/Hamza1s34/Qbitcoin/issues",
"Repository": "https://github.com/Hamza1s34/Qbitcoin"
},
"split_keywords": [
"cryptocurrency",
" blockchain",
" quantum-resistant",
" falcon",
" post-quantum"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d0bf52e0709b3675c239f65accf9d08e3850a1c2fe08ff7d413f4af8b56bdc82",
"md5": "bde162f2e88d25a8658c350bb74d8bda",
"sha256": "54fdb6c92b5a71a199b5f962732f188a534a6becb5c8065e70c54d00d6e9887b"
},
"downloads": -1,
"filename": "qbitcoin-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bde162f2e88d25a8658c350bb74d8bda",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 265377,
"upload_time": "2025-07-19T11:28:53",
"upload_time_iso_8601": "2025-07-19T11:28:53.869498Z",
"url": "https://files.pythonhosted.org/packages/d0/bf/52e0709b3675c239f65accf9d08e3850a1c2fe08ff7d413f4af8b56bdc82/qbitcoin-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9e1f7393d7bbcc2aedd7e939f13e7724f24d3bb5ba8dd81aa8a1a027f2186ee8",
"md5": "7132e247e6fc61922d6b2d094ae583ab",
"sha256": "3a9aeace9a837af9fc96c0808f69a33727890da9a0de27ffa3d30c27668861bd"
},
"downloads": -1,
"filename": "qbitcoin-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "7132e247e6fc61922d6b2d094ae583ab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 285901,
"upload_time": "2025-07-19T11:28:55",
"upload_time_iso_8601": "2025-07-19T11:28:55.321011Z",
"url": "https://files.pythonhosted.org/packages/9e/1f/7393d7bbcc2aedd7e939f13e7724f24d3bb5ba8dd81aa8a1a027f2186ee8/qbitcoin-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-19 11:28:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Hamza1s34",
"github_project": "Qbitcoin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "plyvel",
"specs": [
[
">=",
"1.5.0"
]
]
},
{
"name": "ntplib",
"specs": [
[
">=",
"0.4.0"
]
]
},
{
"name": "Twisted",
"specs": [
[
">=",
"22.0.0"
]
]
},
{
"name": "colorlog",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "simplejson",
"specs": [
[
">=",
"3.17.0"
]
]
},
{
"name": "PyYAML",
"specs": [
[
">=",
"6.0"
]
]
},
{
"name": "grpcio-tools",
"specs": [
[
">=",
"1.50.0"
]
]
},
{
"name": "grpcio",
"specs": [
[
">=",
"1.50.0"
]
]
},
{
"name": "google-api-python-client",
"specs": [
[
">=",
"2.70.0"
]
]
},
{
"name": "google-auth",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "httplib2",
"specs": [
[
">=",
"0.20.0"
]
]
},
{
"name": "service_identity",
"specs": [
[
">=",
"21.0.0"
]
]
},
{
"name": "protobuf",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "pyopenssl",
"specs": [
[
">=",
"23.0.0"
]
]
},
{
"name": "six",
"specs": [
[
">=",
"1.16.0"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "pqcrypto",
"specs": [
[
">=",
"0.3.0"
]
]
},
{
"name": "Flask",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "json-rpc",
"specs": [
[
">=",
"1.13.0"
]
]
},
{
"name": "idna",
"specs": [
[
">=",
"3.0"
]
]
},
{
"name": "cryptography",
"specs": [
[
">=",
"40.0.0"
]
]
},
{
"name": "base58",
"specs": [
[
">=",
"2.1.0"
]
]
},
{
"name": "mock",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "daemonize",
"specs": [
[
">=",
"2.5.0"
]
]
}
],
"lcname": "qbitcoin"
}
JSON
