lyhna 0.1.0

Python SDK for the Lyhna governance API

Lyhna Python SDK

Governance infrastructure for autonomous systems. Every action gets a cryptographic receipt — APPROVED, REFUSED, or ESCALATED — before it executes.

Install

pip install lyhna

Quick start

import os
from lyhna import bind

os.environ["LYHNA_API_KEY"] = "lyhna_..."

receipt = bind(
    action_type="deploy_production",
    intent="release_v3",
    authority_tier="tier_2",
    payload={"service": "api"},
)

if receipt.outcome == "APPROVED":
    deploy()
elif receipt.outcome == "ESCALATED":
    notify(receipt.escalate_to)
else:
    log(receipt.outcome_reason)

Explicit client

from lyhna import LyhnaClient

client = LyhnaClient(api_key="lyhna_...", base_url="https://www.lyhna.com")

receipt = client.bind(
    action_type="deploy_production",
    intent="release_v3",
    authority_tier="tier_2",
)

Async

from lyhna import AsyncLyhnaClient

async with AsyncLyhnaClient(api_key="lyhna_...") as client:
    receipt = await client.bind(
        action_type="deploy_production",
        intent="release_v3",
        authority_tier="tier_2",
    )

Verify a receipt

from lyhna import verify_receipt

result = verify_receipt(receipt)
assert result["valid"] is True

Outcomes

Outcome	Meaning
APPROVED	Action is authorized — proceed.
REFUSED	Action is denied — do not proceed. outcome_reason explains why.
ESCALATED	Action requires higher authority. escalate_to names who.

Errors

Exception	When
LyhnaAuthError	401 or 403 — bad or missing API key.
LyhnaTimeoutError	Request exceeded timeout.
LyhnaError	Any other API error.

Links

• Documentation
• Dashboard