Metadata-Version: 2.4
Name: qids
Version: 1.3.2
Summary: Official Python SDK for Quantum Digital Signatures (QDS) & Post-Quantum Information-Theoretic Security
License: Proprietary
Keywords: quantum-cryptography,quantum-digital-signature,post-quantum,threat-detection,quantum-teleportation,information-theoretic-security
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Information Technology
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24
Requires-Dist: scipy>=1.10
Requires-Dist: matplotlib>=3.7
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: pyflakes>=3.0; extra == "dev"
Provides-Extra: hardware
Requires-Dist: quantum-debugger>=0.9.0; extra == "hardware"
Dynamic: license-file

# QIDS — Quantum Digital Signatures Python SDK

[![PyPI version](https://img.shields.io/pypi/v/qids.svg)](https://pypi.org/project/qids/)
[![Python versions](https://img.shields.io/pypi/pyversions/qids.svg)](https://pypi.org/project/qids/)
[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)

**Quantum Digital Signatures (QDS) & Post-Quantum Security Platform**

`qids` is the official Python SDK for integrating Quantum Digital Signatures into banking transactions, enterprise document signing, and post-quantum zero-trust infrastructure.

---

## What is QIDS?

QIDS provides **Information-Theoretic Security (ITS)** for digital signatures. Unlike traditional public-key cryptography (RSA, ECDSA) which can be broken by quantum computers running Shor's algorithm, QIDS guarantees that signature tags cannot be forged, repudiated, or intercepted—even by an adversary with unlimited quantum computing power.

---

## How It Works (High-Level Architecture)

QIDS operates via a secure 3-stage pipeline:

```
[ ETSI GS QKD 014 Key Stream / KMS ]
                 │
                 ▼
     ┌───────────────────────┐
     │ 1. Quantum Key Ingest │
     └───────────┬───────────┘
                 │
                 ▼
     ┌───────────────────────┐         Payload + One-Time Tag
     │ 2. Signature Creation ├─────────────────────────────────────────┐
     └───────────────────────┘                                         │
                                                                       ▼
                                                           ┌───────────────────────┐
                                                           │ 3. Fast Verification  │
                                                           │    (Sub-millisecond)  │
                                                           └───────────┬───────────┘
                                                                       │
                                                                       ▼
                                                             [ ACCEPT / REJECT ]
```

1. **Entropy Ingestion**: Syncs quantum key material from carrier-grade QKD links or local secure modules via ETSI GS QKD 014 standards.
2. **One-Time Signature Tagging**: Creates cryptographic tags binding document payloads to quantum key states.
3. **Deterministic Verification**: Verifiers independently confirm authenticity and non-repudiation in sub-millisecond speed using closed-form statistical verification (100% deterministic, zero ML hallucinations).

---

## Installation

```bash
pip install qids
```

*Requirements: Python 3.10 or higher.*

---

## Quickstart

### High-Level Enterprise Client

```python
from qids import QIDSClient

# Initialize client for your node
client = QIDSClient(node_id="bank_node_alpha")

# 1. Sign a transaction or document payload
payload = b"TRANSFER 1,000,000 USD TO ACCT-48910"
signature = client.sign(
    document_id="DOC-98104",
    payload=payload,
    recipient_ids=["bank_node_beta"],
)

print(f"Signed document {signature.document_id}")
print(f"Generated {len(signature.signature_tags)} recipient tag(s)")

# 2. Designated recipient verifies signature
verification = client.verify(
    document_id=signature.document_id,
    payload=payload,
    sender_id="bank_node_alpha",
    signature_tag=signature.signature_tags[0],
)

print(f"Verification Verdict: {verification.reason}")
# Output: Verification Verdict: ACCEPTED
```

### Low-Level Session Execution

```python
from qids import QdsSession, ProtocolParams

# Initialize session with default secure parameters
session = QdsSession(params=ProtocolParams(key_length=1200))
result = session.run_benign()

print(f"Protocol Verdict: {result.verifier_charlie.verdict}")
# Output: Protocol Verdict: ACCEPT
```

---

## Core Capabilities

- **Unconditional Non-Repudiation**: Eliminates dispute risks between multiple transaction parties.
- **Sub-Millisecond Latency**: Optimized verification pipeline suitable for high-frequency trading and low-latency API gateways.
- **Carrier Standards Compliant**: Native support for ETSI GS QKD 014 REST APIs.
- **Auditable & Deterministic**: Zero black-box AI/ML models in the verification path.
- **Multi-Language Ecosystem**: Interoperable SDKs available for Python, Go, Rust, Julia, and TypeScript.

---

## Documentation & Support

- **Website**: [https://qids.io](https://qids.io)
- **Interactive Sandbox**: [https://qids.io/#sandbox](https://qids.io/#sandbox)
- **License**: Proprietary. All rights reserved. See [LICENSE](LICENSE) for terms.

