parmana.api.caller_api - Parmana

Parmana Caller and Key API.

CallerApi Objects

class CallerApi()

Caller and Key API.

Responsibilities

Report who the API key belongs to and what it may do
Fetch a signing public key, for offline verification

me

def me() -> CallerIdentity

Who this API key belongs to and what it may do. Maps to GET /callers/me. Useful to check a key before sending requests: which principal IDs it may act for and which capabilities it may request.

public_key

def public_key(key_id: str = "default") -> PublicKeyInfo

A signing public key of the deployment. Maps to GET /keys/{keyId}. Records are signed with the key “default”. Fetch it once, keep the PEM, and pass it to parmana.crypto.verify_execution_trust_record_offline() or verify_execution_intent_offline(). Needs no API key.