EYDII Verify SDK for Python

EYDII is the trustless verification layer for autonomous AI agents. Check every action before execution — without ever seeing the underlying data. Mathematical attestation. Sub-15ms latency. Content-blind.

Install

pip install veritera

Complete Flow: Zero to Verified in 60 Seconds

from veritera import Eydii

eydii = Eydii(api_key="vt_live_...")  # Get your key at id.veritera.ai

# 1. Create a policy (do this once)
policy = eydii.create_policy_sync(
    name="finance-controls",
    description="Block high-value transactions and dangerous operations",
    rules=[
        {"type": "action_whitelist", "params": {"allowed": ["payment.read", "payment.create", "balance.check"]}},
        {"type": "amount_limit", "params": {"max": 10000, "currency": "USD"}},
        {"type": "action_blacklist", "params": {"blocked": ["database.drop", "admin.override"]}},
    ],
)
print(f"Policy created: {policy.name} (ID: {policy.id})")

# 2. Verify an action
result = eydii.verify_sync(
    action="payment.create",
    agent_id="finance-bot",
    params={"amount": 500, "currency": "USD", "recipient": "vendor@acme.com"},
    policy="finance-controls",
)

if result.verified:
    print(f"Approved — proof: {result.proof_id}")
    # Safe to execute the action
else:
    print(f"Blocked — reason: {result.reason}")
    # Do NOT execute

# 3. List your policies
for p in eydii.list_policies_sync():
    print(f"  {p.name} (v{p.version}) — {len(p.rules)} rules")

# 4. Test a policy without executing
test = eydii.test_policy_sync(
    policy_id=policy.id,
    action="database.drop",
    params={"table": "users"},
)
print(f"Test: {test.verdict}")  # "denied"

That's it. No GUI needed. No dashboard required. Everything from code.

Async Usage

import asyncio
from veritera import Eydii

async def main():
    async with EYDII(api_key="vt_live_...") as eydii:
        policy = await eydii.create_policy(
            name="email-controls",
            rules=[{"type": "rate_limit", "params": {"max_per_hour": 50}}],
        )

        result = await eydii.verify_decision(
            agent_id="support-bot",
            action="send_email",
            params={"to": "customer@example.com", "subject": "Your refund"},
            policy="email-controls",
        )
        print("Approved" if result.verified else f"Blocked: {result.reason}")

asyncio.run(main())

Generate Policies from Natural Language

Don't want to write JSON rules? Describe what you want in plain English:

result = eydii.generate_policy_sync(
    "Only allow my agent to read files, send emails (max 50 per hour), "
    "and check balances. Block all deletions and admin operations.",
    save=True,  # save it immediately
)
print(f"Created: {result['name']}")
print(f"Rules: {result['rules']}")

Use with Framework Integrations

The policy you create here works with all Eydii framework packages:

# Create the policy once
eydii.create_policy_sync("finance-controls", rules=[...])

# Then use it in any framework:
# OpenAI Agents SDK:  eydii_protect(tools, policy="finance-controls")
# LangGraph:          EydiiVerifyMiddleware(policy="finance-controls")
# CrewAI:             EydiiVerifyTool(policy="finance-controls")
# LlamaIndex:         EydiiVerifyToolSpec(policy="finance-controls")

API Reference

Eydii(api_key, **options)

Verification

Policies

Policy Rule Types

Delegations

Account

Error Handling

from veritera import EydiiError, RateLimitError

try:
    result = await eydii.verify_decision(...)
except RateLimitError as e:
    print(f"Rate limited — retry in {e.retry_after_ms}ms")
except EydiiError as e:
    print(f"Error: {e.code} ({e.status}): {e}")

Fail-Closed (Default)

When fail_closed=True, network/server errors return a denied result instead of raising. Your agent is blocked, not crashed. This is the safe default.

Circuit Breaker

After 5 consecutive failures, the SDK opens a circuit breaker for 30 seconds. After 30s, one request is allowed through (half-open). On success, the circuit closes.

Requirements

• Python >= 3.9
• Dependencies: httpx, cryptography

Get Your API Key

1. Go to veritera.ai
2. Sign up (free tier: 250 verifications)
3. Copy your API key from the dashboard
4. Set it: export VERITERA_API_KEY=vt_live_...

License

MIT — EYDII by Veritera