Metadata-Version: 2.4
Name: qbitcoin
Version: 1.1.2
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 Logo](https://q-bit.live/qbitcoin_logo)

# QBitcoin

[![PyPI](https://img.shields.io/pypi/v/qbitcoin.svg)](https://pypi.org/project/qbitcoin/)
[![License](https://img.shields.io/github/license/Hamza1s34/Qbitcoin)](LICENSE)
[![Website](https://img.shields.io/badge/website-qbitcoin.live-blue)](https://qbitcoin.live/)
[![Whitepaper](https://img.shields.io/badge/whitepaper-PDF-green)](https://qbitcoin.live/whitepaper)

A professional-grade, quantum-resistant blockchain built from scratch in Python using Falcon-512. QBitcoin secures digital assets in the post-quantum era, featuring a robust wallet, transaction system, mining capabilities, and a modern web-based GUI.

---

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

### Install via PyPI

```bash
pip install qbitcoin
```

Install build dependencies:
```bash
sudo apt install -y build-essential cmake swig python3-dev libssl-dev libboost-all-dev libuv1-dev
```

Run the smart installer:
```bash
python3 -m qbitcoin.smart_installer
```

Start the node:
```bash
qbitcoin
```

For mining:
```bash
qbitcoin --miningAddress <your qbitcoin address>
```

### Manual Installation

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

### CLI Mode

Use the command-line interface:

```bash
python -m qbitcoin.cli
```

### Utility Scripts

Handy scripts are available in the `scripts/` directory for:
- Creating transactions
- Token management
- Multi-signature operations
- Address debugging

---

## Testing

Run the test suite to ensure stability and correctness:

```bash
pytest tests/
```

---

## Contributing

We welcome contributions from the community!

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

[![License](https://img.shields.io/github/license/Hamza1s34/Qbitcoin)](LICENSE)

This project is open source. Please see the [LICENSE](LICENSE) file for details.
