qpher 0.1.0__tar.gz

qpher-0.1.0/.gitignore

@@ -0,0 +1,82 @@
+# ============================================================
+# Qpher PQC Security Cloud — .gitignore
+# ============================================================
+
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# --- Virtual Environments ---
+venv/
+.venv/
+env/
+ENV/
+
+# --- IDE ---
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# --- Testing ---
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# --- Environment / Secrets ---
+.env
+.env.local
+.env.production
+.env.staging
+# NOTE: .env.example IS tracked (template only, no real secrets)
+
+# --- Database ---
+*.db
+*.sqlite3
+
+# --- Logs ---
+logs/
+*.log
+audit_logs/
+
+# --- Docker ---
+docker-compose.override.yml
+
+# --- Node.js (frontend apps) ---
+node_modules/
+.next/
+.docusaurus/
+out/
+.turbo/
+.vercel/
+
+# --- KMS Key Files (NEVER commit private keys) ---
+kms_keys/
+*.pem
+*.key
+
+# --- OS ---
+Desktop.ini
+
+# --- Build artifacts ---
+*.tar.gz
+*.whl
+
+# --- Jupyter ---
+.ipynb_checkpoints/
+
+# --- Claude Code ---
+.claude/

qpher-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Qpher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qpher-0.1.0/PKG-INFO

@@ -0,0 +1,265 @@
+Metadata-Version: 2.4
+Name: qpher
+Version: 0.1.0
+Summary: Official Python SDK for the Qpher Post-Quantum Cryptography API
+Project-URL: Homepage, https://qpher.ai
+Project-URL: Documentation, https://docs.qpher.ai/sdks/python
+Project-URL: Repository, https://github.com/qpher/qpher-python
+Project-URL: Issues, https://github.com/qpher/qpher-python/issues
+Author-email: Qpher <sdk@qpher.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cryptography,dilithium,encryption,kyber,post-quantum,pqc,signatures
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Security :: Cryptography
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: responses>=0.24.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Qpher Python SDK
+
+Official Python SDK for the [Qpher](https://qpher.ai) Post-Quantum Cryptography API.
+
+## Installation
+
+```bash
+pip install qpher
+```
+
+## Requirements
+
+- Python 3.9+
+
+## Quick Start
+
+```python
+from qpher import Qpher
+
+# Initialize the client
+client = Qpher(api_key="qph_live_your_api_key")
+
+# Encrypt data using Kyber768 KEM
+result = client.kem.encrypt(
+    plaintext=b"Hello, Quantum World!",
+    key_version=1,
+)
+print(f"Ciphertext: {result.ciphertext.hex()}")
+
+# Decrypt data
+decrypted = client.kem.decrypt(
+    ciphertext=result.ciphertext,
+    key_version=result.key_version,
+)
+print(f"Plaintext: {decrypted.plaintext}")
+
+# Sign a message using Dilithium3
+sig_result = client.signatures.sign(
+    message=b"Invoice #12345",
+    key_version=1,
+)
+print(f"Signature: {sig_result.signature.hex()}")
+
+# Verify a signature
+verify_result = client.signatures.verify(
+    message=b"Invoice #12345",
+    signature=sig_result.signature,
+    key_version=sig_result.key_version,
+)
+print(f"Valid: {verify_result.valid}")
+```
+
+## API Reference
+
+### Client Initialization
+
+```python
+from qpher import Qpher
+
+client = Qpher(
+    api_key="qph_live_your_api_key",  # Required
+    base_url="https://api.qpher.ai",  # Optional, default
+    timeout=30,                        # Optional, seconds
+    max_retries=3,                     # Optional
+)
+```
+
+### KEM Operations (Kyber768)
+
+#### Encrypt
+
+```python
+result = client.kem.encrypt(
+    plaintext=b"secret data",
+    key_version=1,
+    mode="standard",      # Optional: "standard" or "deterministic"
+    salt=b"...",          # Required if mode="deterministic" (min 32 bytes)
+)
+# result.ciphertext: bytes
+# result.key_version: int
+# result.algorithm: str ("Kyber768")
+# result.request_id: str
+```
+
+#### Decrypt
+
+```python
+result = client.kem.decrypt(
+    ciphertext=encrypted_data,
+    key_version=1,
+)
+# result.plaintext: bytes
+# result.key_version: int
+# result.algorithm: str
+# result.request_id: str
+```
+
+### Signature Operations (Dilithium3)
+
+#### Sign
+
+```python
+result = client.signatures.sign(
+    message=b"document to sign",
+    key_version=1,
+)
+# result.signature: bytes (3,293 bytes)
+# result.key_version: int
+# result.algorithm: str ("Dilithium3")
+# result.request_id: str
+```
+
+#### Verify
+
+```python
+result = client.signatures.verify(
+    message=b"document to sign",
+    signature=signature_bytes,
+    key_version=1,
+)
+# result.valid: bool
+# result.key_version: int
+# result.algorithm: str
+# result.request_id: str
+```
+
+### Key Management
+
+#### Generate Key
+
+```python
+result = client.keys.generate(algorithm="Kyber768")
+# result.key_version: int
+# result.algorithm: str
+# result.status: str ("active")
+# result.public_key: bytes
+# result.created_at: str
+```
+
+#### Rotate Key
+
+```python
+result = client.keys.rotate(algorithm="Kyber768")
+# result.key_version: int (new)
+# result.old_key_version: int
+# result.algorithm: str
+# result.public_key: bytes
+```
+
+#### Get Active Key
+
+```python
+key_info = client.keys.get_active(algorithm="Kyber768")
+# key_info.key_version: int
+# key_info.algorithm: str
+# key_info.status: str
+# key_info.public_key: bytes
+# key_info.created_at: str
+```
+
+#### List Keys
+
+```python
+result = client.keys.list(
+    algorithm="Kyber768",  # Optional filter
+    status="active",       # Optional filter: "active", "retired", "archived"
+)
+# result.keys: List[KeyInfo]
+# result.total: int
+```
+
+#### Retire Key
+
+```python
+result = client.keys.retire(algorithm="Kyber768", key_version=1)
+# result.key_version: int
+# result.status: str ("retired")
+```
+
+## Error Handling
+
+```python
+from qpher import (
+    Qpher,
+    QpherError,
+    AuthenticationError,
+    ValidationError,
+    NotFoundError,
+    RateLimitError,
+)
+
+try:
+    result = client.kem.encrypt(plaintext=b"data", key_version=99)
+except NotFoundError as e:
+    print(f"Key not found: {e.message}")
+    print(f"Error code: {e.error_code}")
+    print(f"Request ID: {e.request_id}")
+except RateLimitError as e:
+    print("Rate limit exceeded, please retry later")
+except AuthenticationError as e:
+    print("Invalid API key")
+except ValidationError as e:
+    print(f"Invalid input: {e.message}")
+except QpherError as e:
+    print(f"API error: {e.message}")
+```
+
+## Error Types
+
+| Exception | HTTP Status | Description |
+|-----------|-------------|-------------|
+| `AuthenticationError` | 401 | Invalid or missing API key |
+| `ValidationError` | 400 | Invalid request parameters |
+| `ForbiddenError` | 403 | Operation not allowed |
+| `NotFoundError` | 404 | Resource not found |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 500+ | Server-side errors |
+| `TimeoutError` | 504 | Request timed out |
+| `ConnectionError` | 503 | Connection failed |
+
+## Supported Algorithms
+
+| Algorithm | Type | Security Level |
+|-----------|------|----------------|
+| Kyber768 | KEM (Encryption) | NIST Level 3 |
+| Dilithium3 | Digital Signatures | NIST Level 3 |
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Qpher Website](https://qpher.ai)
+- [API Documentation](https://docs.qpher.ai)
+- [GitHub Repository](https://github.com/qpher/qpher-python)

qpher-0.1.0/README.md

@@ -0,0 +1,236 @@
+# Qpher Python SDK
+
+Official Python SDK for the [Qpher](https://qpher.ai) Post-Quantum Cryptography API.
+
+## Installation
+
+```bash
+pip install qpher
+```
+
+## Requirements
+
+- Python 3.9+
+
+## Quick Start
+
+```python
+from qpher import Qpher
+
+# Initialize the client
+client = Qpher(api_key="qph_live_your_api_key")
+
+# Encrypt data using Kyber768 KEM
+result = client.kem.encrypt(
+    plaintext=b"Hello, Quantum World!",
+    key_version=1,
+)
+print(f"Ciphertext: {result.ciphertext.hex()}")
+
+# Decrypt data
+decrypted = client.kem.decrypt(
+    ciphertext=result.ciphertext,
+    key_version=result.key_version,
+)
+print(f"Plaintext: {decrypted.plaintext}")
+
+# Sign a message using Dilithium3
+sig_result = client.signatures.sign(
+    message=b"Invoice #12345",
+    key_version=1,
+)
+print(f"Signature: {sig_result.signature.hex()}")
+
+# Verify a signature
+verify_result = client.signatures.verify(
+    message=b"Invoice #12345",
+    signature=sig_result.signature,
+    key_version=sig_result.key_version,
+)
+print(f"Valid: {verify_result.valid}")
+```
+
+## API Reference
+
+### Client Initialization
+
+```python
+from qpher import Qpher
+
+client = Qpher(
+    api_key="qph_live_your_api_key",  # Required
+    base_url="https://api.qpher.ai",  # Optional, default
+    timeout=30,                        # Optional, seconds
+    max_retries=3,                     # Optional
+)
+```
+
+### KEM Operations (Kyber768)
+
+#### Encrypt
+
+```python
+result = client.kem.encrypt(
+    plaintext=b"secret data",
+    key_version=1,
+    mode="standard",      # Optional: "standard" or "deterministic"
+    salt=b"...",          # Required if mode="deterministic" (min 32 bytes)
+)
+# result.ciphertext: bytes
+# result.key_version: int
+# result.algorithm: str ("Kyber768")
+# result.request_id: str
+```
+
+#### Decrypt
+
+```python
+result = client.kem.decrypt(
+    ciphertext=encrypted_data,
+    key_version=1,
+)
+# result.plaintext: bytes
+# result.key_version: int
+# result.algorithm: str
+# result.request_id: str
+```
+
+### Signature Operations (Dilithium3)
+
+#### Sign
+
+```python
+result = client.signatures.sign(
+    message=b"document to sign",
+    key_version=1,
+)
+# result.signature: bytes (3,293 bytes)
+# result.key_version: int
+# result.algorithm: str ("Dilithium3")
+# result.request_id: str
+```
+
+#### Verify
+
+```python
+result = client.signatures.verify(
+    message=b"document to sign",
+    signature=signature_bytes,
+    key_version=1,
+)
+# result.valid: bool
+# result.key_version: int
+# result.algorithm: str
+# result.request_id: str
+```
+
+### Key Management
+
+#### Generate Key
+
+```python
+result = client.keys.generate(algorithm="Kyber768")
+# result.key_version: int
+# result.algorithm: str
+# result.status: str ("active")
+# result.public_key: bytes
+# result.created_at: str
+```
+
+#### Rotate Key
+
+```python
+result = client.keys.rotate(algorithm="Kyber768")
+# result.key_version: int (new)
+# result.old_key_version: int
+# result.algorithm: str
+# result.public_key: bytes
+```
+
+#### Get Active Key
+
+```python
+key_info = client.keys.get_active(algorithm="Kyber768")
+# key_info.key_version: int
+# key_info.algorithm: str
+# key_info.status: str
+# key_info.public_key: bytes
+# key_info.created_at: str
+```
+
+#### List Keys
+
+```python
+result = client.keys.list(
+    algorithm="Kyber768",  # Optional filter
+    status="active",       # Optional filter: "active", "retired", "archived"
+)
+# result.keys: List[KeyInfo]
+# result.total: int
+```
+
+#### Retire Key
+
+```python
+result = client.keys.retire(algorithm="Kyber768", key_version=1)
+# result.key_version: int
+# result.status: str ("retired")
+```
+
+## Error Handling
+
+```python
+from qpher import (
+    Qpher,
+    QpherError,
+    AuthenticationError,
+    ValidationError,
+    NotFoundError,
+    RateLimitError,
+)
+
+try:
+    result = client.kem.encrypt(plaintext=b"data", key_version=99)
+except NotFoundError as e:
+    print(f"Key not found: {e.message}")
+    print(f"Error code: {e.error_code}")
+    print(f"Request ID: {e.request_id}")
+except RateLimitError as e:
+    print("Rate limit exceeded, please retry later")
+except AuthenticationError as e:
+    print("Invalid API key")
+except ValidationError as e:
+    print(f"Invalid input: {e.message}")
+except QpherError as e:
+    print(f"API error: {e.message}")
+```
+
+## Error Types
+
+| Exception | HTTP Status | Description |
+|-----------|-------------|-------------|
+| `AuthenticationError` | 401 | Invalid or missing API key |
+| `ValidationError` | 400 | Invalid request parameters |
+| `ForbiddenError` | 403 | Operation not allowed |
+| `NotFoundError` | 404 | Resource not found |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 500+ | Server-side errors |
+| `TimeoutError` | 504 | Request timed out |
+| `ConnectionError` | 503 | Connection failed |
+
+## Supported Algorithms
+
+| Algorithm | Type | Security Level |
+|-----------|------|----------------|
+| Kyber768 | KEM (Encryption) | NIST Level 3 |
+| Dilithium3 | Digital Signatures | NIST Level 3 |
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Qpher Website](https://qpher.ai)
+- [API Documentation](https://docs.qpher.ai)
+- [GitHub Repository](https://github.com/qpher/qpher-python)

qpher-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "qpher"
+version = "0.1.0"
+description = "Official Python SDK for the Qpher Post-Quantum Cryptography API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "Qpher", email = "sdk@qpher.ai" }]
+keywords = ["post-quantum", "cryptography", "pqc", "kyber", "dilithium", "encryption", "signatures"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Security :: Cryptography",
+]
+dependencies = ["requests>=2.31.0"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-cov>=4.1.0",
+    "responses>=0.24.0",
+]
+
+[project.urls]
+Homepage = "https://qpher.ai"
+Documentation = "https://docs.qpher.ai/sdks/python"
+Repository = "https://github.com/qpher/qpher-python"
+Issues = "https://github.com/qpher/qpher-python/issues"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.hatch.build.targets.wheel]
+packages = ["qpher"]

qpher-0.1.0/qpher/__init__.py

@@ -0,0 +1,53 @@
+"""Qpher Python SDK - Official client for the Qpher Post-Quantum Cryptography API."""
+
+from qpher.client import Qpher
+from qpher.errors import (
+    QpherError,
+    AuthenticationError,
+    RateLimitError,
+    NotFoundError,
+    ValidationError,
+    ForbiddenError,
+    ServerError,
+    TimeoutError,
+    ConnectionError,
+)
+from qpher.types import (
+    EncryptResult,
+    DecryptResult,
+    SignResult,
+    VerifyResult,
+    KeyInfo,
+    KeyListResult,
+    RotateResult,
+    GenerateResult,
+    RetireResult,
+)
+from qpher._version import __version__
+
+__all__ = [
+    # Main client
+    "Qpher",
+    # Errors
+    "QpherError",
+    "AuthenticationError",
+    "RateLimitError",
+    "NotFoundError",
+    "ValidationError",
+    "ForbiddenError",
+    "ServerError",
+    "TimeoutError",
+    "ConnectionError",
+    # Types
+    "EncryptResult",
+    "DecryptResult",
+    "SignResult",
+    "VerifyResult",
+    "KeyInfo",
+    "KeyListResult",
+    "RotateResult",
+    "GenerateResult",
+    "RetireResult",
+    # Version
+    "__version__",
+]

qpher-0.1.0/qpher/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"