Revvyn SDK

Python client for the Revvyn Governance API. Send a payment intent, receive an Ed25519-signed verdict (ALLOW / BLOCK / ESCALATE), verify it offline, and report the outcome back. Revvyn governs the decision; you settle on your own rail.

This SDK is licensed under the MIT License. The Revvyn service it connects to is proprietary and is not covered by this licence.

Install

pip install revvyn-sdk

Offline verdict verification needs cryptography; install it with the extra:

pip install "revvyn-sdk[verify]"

You do not need this package to verify a verdict — two widely used libraries are enough: pip install cryptography httpx. The integration guide shows the few lines of code.

Quick start

import httpx
from revvyn_sdk import RevvynClient, verify_verdict

client = RevvynClient(api_key="rvn_live_...")

# Governance-only: returns an Ed25519-signed verdict. Revvyn governs; you settle on your own rail.
signed = client.evaluate(amount=4500, currency="USD", agent_id="agt_your_agent")

jwks = httpx.get("https://api.revvyn.com/.well-known/jwks.json").json()
if verify_verdict(signed, jwks) == "ALLOW":
    ...  # execute on your own rail, then report the real outcome with client.observe(...)

evaluate() sends a reference number (Idempotency-Key) with every call and reuses it when it retries, so a retry never creates a second decision.

What it does

• Typed responses (dataclasses)
• Automatic retry with exponential backoff
• Rate-limit tracking (client.last_rate_limit)
• Error hierarchy: AuthenticationError, NotFoundError, RateLimitError, ValidationError
• Offline verdict verification (verify_verdict) and inbound-webhook HMAC verification (verify_webhook)
• Context-manager support (with RevvynClient(...) as client:)