asqav 0.2.3

Quantum-safe identity and cryptographic audit trails for AI agents.

asqav

Thin API client for asqav.com. All cryptographic operations (ML-DSA signing, key generation) happen server-side. No native dependencies required.

Installation

pip install asqav

Usage

import asqav

# Initialize with your API key (get one at asqav.com)
asqav.init(api_key="sk_...")

# Create an agent
agent = asqav.Agent.create("my-agent")

# Sign an action
sig = agent.sign("api:call", {"model": "gpt-4"})

# Issue a token
token = agent.issue_token(scope=["read", "write"])

What this SDK does

This SDK	asqav Cloud (server-side)
API calls	ML-DSA key generation
Response parsing	Cryptographic signing
Error handling	Token issuance
OTEL export	Signature verification

The SDK is intentionally minimal (~900 lines). All quantum-safe cryptography runs on asqav's servers.

API Reference

Initialization

asqav.init(api_key="sk_...")  # or set ASQAV_API_KEY env var

Agent

agent = asqav.Agent.create("name", algorithm="ml-dsa-65")
agent = asqav.Agent.get("agt_xxx")

agent.sign("action", {"key": "value"})
agent.issue_token(scope=["read"], ttl=3600)
agent.issue_sd_token(claims={...}, disclosable=[...])  # Business tier
agent.suspend(reason="investigation", note="...")  # Temporary disable
agent.unsuspend()  # Re-enable suspended agent
agent.revoke(reason="manual")  # Permanent revoke

Tracing

with asqav.span("api:openai", {"model": "gpt-4"}) as s:
    response = openai.chat.completions.create(...)
    s.set_attribute("tokens", response.usage.total_tokens)

Requirements

• Python 3.10+

Get your API key

Sign up at asqav.com

License

MIT