bitcoinpqc 0.1.0

Python bindings for libbitcoinpqc

Python Bindings for libbitcoinpqc

This package provides Python bindings for the libbitcoinpqc library, which implements post-quantum cryptographic signature algorithms for use with BIP-360 and the Bitcoin QuBit soft fork.

Supported Algorithms

• ML-DSA-44 (CRYSTALS-Dilithium): A structured lattice-based digital signature scheme
• SLH-DSA-Shake-128s (SPHINCS+): A stateless hash-based signature scheme
• FN-DSA-512 (FALCON): A lattice-based signature scheme designed for efficiency

Installation

# Install the package
pip install bitcoinpqc

or from source:

# Clone the repository
git clone https://github.com/bitcoin/libbitcoinpqc.git
cd libbitcoinpqc

# Build the C library
mkdir build && cd build
cmake ..
make
cd ..

# Install the Python package
cd python
pip install -e .

Requirements

• Python 3.7 or higher
• The libbitcoinpqc C library must be built and installed

Example Usage

import secrets
from bitcoinpqc import Algorithm, keygen, sign, verify

# Generate random data for key generation
random_data = secrets.token_bytes(128)

# Generate a key pair
algorithm = Algorithm.ML_DSA_44  # CRYSTALS-Dilithium
keypair = keygen(algorithm, random_data)

# Create a message to sign
message = b"Hello, Bitcoin PQC!"

# Sign the message
signature = sign(algorithm, keypair.secret_key, message)

# Verify the signature
is_valid = verify(algorithm, keypair.public_key, message, signature)
print(f"Signature valid: {is_valid}")  # Should print True

Running Tests

# Run the tests
./run_tests.sh

# Or using unittest directly
python -m unittest discover -s tests

License

This project is licensed under the MIT License.