pip install git+https://github.com/TOAAiV/proofrail

# .env
PROOFRAIL_API_KEY=prail_your_key_here

import asyncio
import os
from dotenv import load_dotenv

import proofrail

load_dotenv()
proofrail.init(api_key=os.environ["PROOFRAIL_API_KEY"])


async def main():
    async with proofrail.Chain("first-workflow") as chain:
        # A safe action — should resolve via the local fast-path
        decision = await chain.record_agent_action(
            agent_name="research-agent",
            action_type="tool_call",
            action_name="search_web",
            payload={"query": "vendor pricing for office chairs"},
        )
        print(f"Search action: {decision.policy_decision} (via {decision.decision_source})")

        # A small purchase — should be allowed
        decision = await chain.record_agent_action(
            agent_name="purchase-agent",
            action_type="tool_call",
            action_name="place_order",
            payload={"amount_usd": 150.00, "vendor": "office-supplies.com"},
        )
        print(f"Small purchase: {decision.policy_decision} (via {decision.decision_source})")


asyncio.run(main())

python first_chain.py

decision = await chain.record_agent_action(
    agent_name="purchase-agent",
    action_type="tool_call",
    action_name="place_order",
    payload={"amount_usd": 7500.00, "vendor": "office-supplies.com"},
)

Waiting for approval on chain abc-123... (timeout=24h)

Large purchase: allow (via human_approval)

import proofrail

proofrail.init(api_key=os.environ["PROOFRAIL_API_KEY"])

# Verify a specific receipt
result = await proofrail.client.verify_receipt("rcp_abc123...")
print(f"Valid: {result.valid}")
print(f"Receipt number: {result.receipt_number}")