Metadata-Version: 2.4
Name: qbitcoin
Version: 1.0.9
Summary: A Python-based cryptocurrency implementation with quantum-resistant features
Home-page: https://github.com/Hamza1s34/Qbitcoin
Author: Hamza
Author-email: Hamza <hamza@qbitcoin.dev>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Hamza1s34/Qbitcoin
Project-URL: Repository, https://github.com/Hamza1s34/Qbitcoin
Project-URL: Issues, https://github.com/Hamza1s34/Qbitcoin/issues
Project-URL: Documentation, https://github.com/Hamza1s34/Qbitcoin
Keywords: cryptocurrency,blockchain,quantum-resistant,falcon,post-quantum
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: plyvel>=1.5.0
Requires-Dist: ntplib>=0.4.0
Requires-Dist: Twisted>=22.0.0
Requires-Dist: colorlog>=6.0.0
Requires-Dist: simplejson>=3.17.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: grpcio-tools>=1.50.0
Requires-Dist: grpcio>=1.50.0
Requires-Dist: google-api-python-client>=2.70.0
Requires-Dist: google-auth>=2.0.0
Requires-Dist: httplib2>=0.20.0
Requires-Dist: service_identity>=21.0.0
Requires-Dist: protobuf>=4.0.0
Requires-Dist: pyopenssl>=23.0.0
Requires-Dist: six>=1.16.0
Requires-Dist: click>=8.0.0
Requires-Dist: pqcrypto>=0.3.0
Requires-Dist: Flask>=2.0.0
Requires-Dist: json-rpc>=1.13.0
Requires-Dist: idna>=3.0
Requires-Dist: cryptography>=40.0.0
Requires-Dist: base58>=2.1.0
Requires-Dist: mock>=4.0.0
Requires-Dist: daemonize>=2.5.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# 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.
