sovseal-sdk (Python)

Official Python SDK for sovseal — client-side zero-knowledge state continuity and replication.

Installation

pip install sovseal-sdk

Quickstart

import os
from sovseal import AgentStateClient

# 1. Initialize client and 256-bit AES encryption key
client = AgentStateClient(
    endpoint="https://api.sovseal.com",
    api_key="your-api-key"
)

# 32-byte (256-bit) raw key bytes derived or generated locally
key_bytes = os.urandom(32)

# 2. Encrypt & Submit Zero-Knowledge State Snapshot
receipt = client.snapshot(
    agent_id="agent-007",
    sequence_number=1,
    active_context={
        "patient_id": "P-99482",
        "notes": "Telehealth appointment scheduled for Tuesday."
    },
    key_bytes=key_bytes
)

print("Committed snapshot sequence:", receipt["sequence_number"])

# 3. Retrieve Latest Receipt
latest = client.restore(agent_id="agent-007")
print("Latest receipt:", latest)

Features

• Client-Side Zero-Knowledge Encryption: Uses AES-256-GCM (cryptography) to encrypt payloads before transmission.
• Canonical Serialization & Integrity: Computes SHA-256 canonical hash digests for snapshot verification.
• Python 3.9+ Compatibility: Fully typed async and synchronous support via httpx.

License

Apache-2.0 © sovseal Protocol Contributors