dirac-hashes 0.1.0

Quantum-resistant hash functions and post-quantum cryptography for blockchain

Dirac Hashes

A next-generation cryptographic hash library built for speed, security, and quantum resistance.

About

Dirac Hashes is a project aimed at developing and testing high-performance cryptographic hash functions that are resistant to quantum computing attacks. This repository contains a Python package implementing quantum-resistant hash functions, digital signature schemes, and key encapsulation mechanisms (KEM), plus tools for testing and comparing their performance.

Features

• Quantum-resistant hash algorithms:
  • Improved (default, recommended)
  • Grover
  • Shor
  • Hybrid
  • Improved Grover
  • Improved Shor
• Post-quantum signature schemes:
  • Dilithium (NIST standard)
  • SPHINCS+
  • Lamport
• Key Encapsulation Mechanisms (KEM):
  • Kyber (NIST standard)
• Web-based testing interface with performance visualization
• Simple Python API for integration into other projects

Installation

Python Package

Install the package from PyPI:

pip install dirac-hashes

Or install from source:

git clone https://github.com/your-username/dirac-hashes.git
cd dirac-hashes
pip install -e .

Web Interface

To run the web interface locally:

1. Clone this repository:

   git clone https://github.com/your-username/dirac-hashes.git
   cd dirac-hashes
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the server:

   python run_api.py
   

4. Open http://localhost:8000 in your browser

Quick Start

from quantum_hash.dirac import DiracHash
from quantum_hash.signatures.dilithium import DilithiumSignature

# Generate a hash
message = "Hello, quantum world!"
hash_value = DiracHash.hash(message)
print(f"Hash: {hash_value.hex()}")

# Generate a key pair
dilithium = DilithiumSignature()
private_key, public_key = dilithium.generate_keypair()

# Sign a message
signature = dilithium.sign(message.encode(), private_key)

# Verify the signature
is_valid = dilithium.verify(message.encode(), signature, public_key)
print(f"Signature valid: {is_valid}")

For more examples, see the examples directory.

Project Structure

dirac-hashes/
├── api/                     # FastAPI backend
├── examples/                # Example scripts
├── frontend/                # Web interface
├── src/                     # Python package source
│   └── quantum_hash/        # Main package
│       ├── core/            # Core algorithms
│       ├── signatures/      # Signature schemes
│       ├── kem/             # Key encapsulation
│       └── utils/           # Utility functions
├── tests/                   # Test suite
├── README.md                # This file
└── setup.py                 # Package setup

Documentation

For detailed documentation, see the frontend/documentation page or visit our online documentation.

Future Development

• Implementation of Dirac hash algorithms in Rust and WebAssembly
• Integration with Solana blockchain for high-performance verification
• Command-line tools for batch processing
• Integration tests for cryptographic properties

Contributing

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

License

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