aeterdum 1.0.1

Official Python client for Aeterdum

Aeterdum Python SDK

Official Python client for Aeterdum, the immutable audit log service.

Installation

pip install aeterdum

Usage

Initialization

import os
from aeterdum import Aeterdum

# Recommended: Use environment variable AETERDUM_API_KEY
client = Aeterdum() 

# For specific regions
# client = Aeterdum(base_url="https://eu.aeterdum.com")

# With signature verification
# client = Aeterdum(server_public_key="0be...")

# Or pass explicitly
# client = Aeterdum(api_key="sk_...")

Ingesting Logs

Ingest an event into the immutable ledger.

with Aeterdum() as client:
    log = client.logs.create(
        event="model.trained",
        actor="pipeline_worker_1",
        payload={
            "accuracy": 0.98,
            "dataset": "v2.1"
        },
        metadata={
            "env": "production"
        }
    )
    
    print(f"Log ID: {log['id']}")

Verifying Logs

Verify the cryptographic integrity of any log entry.

result = client.logs.verify("log_12345")

if result.get("client_verified"):
    print("Merkle Proof Valid")

if result.get("signature_verified"):
    print("Digital Signature Valid")

result = client.logs.verify("log_2023...")

if result["valid"]:
    print(f"Log verified! Merkle Root: {result['merkle_root']}")
else:
    print("Verification failed.")

Listing Logs

retrieve your audit trail for analysis.

logs = client.logs.list(limit=20)

for log in logs["data"]:
    print(f"{log['timestamp']}: {log['event']}")

Async/Sync

Currently, this SDK provides a synchronous interface using httpx.