Metadata-Version: 2.4
Name: epochcore-app-primitives
Version: 0.1.0
Summary: Official Python SDK for EpochCore Application Primitives (Archive, Attest, Vault, Ledger, Rotate, ApiGuard, Molecule, Portfolio, CodeReview). Sealed receipts via ML-DSA-65 + Ed25519 + ML-KEM-768.
Author-email: EpochCore LLC <licensing@epochcoreqcs.com>
License: EpochCore Proprietary License — epochcore-app-primitives SDK
        
        Copyright (c) 2026 EpochCore LLC. All Rights Reserved. Patent Pending.
        
        This SDK is licensed for use SOLELY in connection with calls to the EpochCore
        Application Primitives API at app.epochcoreqcs.com (or any successor URL) by
        parties holding a valid EpochCore API key.
        
        No license is granted for: forking, vendoring, redistributing, modifying, or
        embedding the SDK in a product that does not connect to the EpochCore API.
        Use of this SDK constitutes acceptance of the EpochCore Terms of Service.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED. EpochCore makes no warranty of fitness for any particular purpose
        and disclaims all liability for damages arising from use of the SDK.
        
        Contact: licensing@epochcoreqcs.com
        
Project-URL: Homepage, https://app.epochcoreqcs.com
Project-URL: Source, https://github.com/QuantumSwarms/app-primitives-worker
Project-URL: Docs, https://app.epochcoreqcs.com/openapi.json
Project-URL: Changelog, https://github.com/QuantumSwarms/app-primitives-worker/blob/main/CHANGELOG.md
Keywords: epochcore,pqc,post-quantum,ml-dsa-65,ml-kem-768,sealed,attestation,merkle,vault
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Requires-Dist: cryptography>=42.0.0
Provides-Extra: pqc-verify
Requires-Dist: pqcrypto>=0.1.3; extra == "pqc-verify"
Dynamic: license-file

# epochcore-app-primitives

Official Python SDK for the [EpochCore Application Primitives API](https://app.epochcoreqcs.com).

9 sealed primitives: Archive, Attest, Vault, Ledger, Rotate, ApiGuard, Molecule, Portfolio, CodeReview. Every response is dual-signed (Ed25519 + ML-DSA-65) and anchored to RAS `40668c787c463ca5`.

## Install

```bash
pip install epochcore-app-primitives
# Optional: enable ML-DSA-65 offline verification
pip install 'epochcore-app-primitives[pqc-verify]'
```

## Quick start

```python
from epochcore_app_primitives import Client

with Client(api_key="...") as client:
    sealed = client.archive.seal(payload="hello world", content_type="text/plain")
    print(sealed["archive_id"], sealed["cert_pdf_url"])

    verify = client.verify(sealed["archive_id"])
    assert verify["verified"]
    assert verify["ml_dsa_65_ok"] and verify["ed25519_ok"]
```

## Offline verification

```python
from epochcore_app_primitives import load_offline_verifier_keys, verify_offline, SealMeta

keys = load_offline_verifier_keys()                         # fetches pubkeys once
result = verify_offline(
    keys,
    SealMeta(ts=1700000000000, primitive="archive",
             primitive_id="arc_...", tenant_id="acme-corp",
             payload_hash="<sha256-hex>"),
    ed25519_sig_hex="...",
    pqc_sig_hex="...",
)
assert result.verified
```

## Sub-clients

- `client.archive`     — seal / get / payload / cert_pdf
- `client.attest`      — attest / get / verify / cert_pdf
- `client.vault`       — generate_key / sign / verify / create_envelope / unwrap
- `client.ledger`      — verify_chain / list / get_entry / set_cadence / transparency
- `client.rotate`      — run / get / history
- `client.apiguard`    — register / get / stats / rotate_keys
- `client.molecule`    — register / simulate_vqe / binding_affinity / screen / backends
- `client.portfolio`   — register / optimize / get / jobs
- `client.code_review` — review / get / findings
- `client.health()`, `client.status()`, `client.well_known()` — cross-cutting

## Anchor canon

Every response carries `X-RAS-Root: 40668c787c463ca5` + `X-Watermark: epoch26matrix2025`. The frequency `1210 Hz` is the EpochCore quantum tunnels' unique oscillation signature — non-negotiable canonical.

## License

Proprietary. See [LICENSE](LICENSE).
