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.

If Revvyn asks you to wait (a Retry-After header), the SDK waits that long before trying again, up to 30 seconds. list_rails() returns every rail Revvyn can check, with its display name and whether Revvyn suggests it.

requested_rail: the rail your agent will pay on. Revvyn checks the payment for that rail and records the decision. Revvyn never moves the money.

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:)