trustprotocol 1.0.1

Python SDK for TrustProtocol — AI agent governance and audit trail

TrustProtocol Python SDK

Governance and cryptographic audit trail for AI agents.

Installation

pip install trustprotocol

Quick Start

from trustprotocol import TrustProtocol

tp = TrustProtocol("your-api-key")

result = tp.intercept(
    agent_id="finance-agent-01",
    action="Transfer 5000 EUR to supplier ACME",
    cost_eur=5000.0,
    user_id="[e-mail]"
)

if result.authorized:
    print(f"✓ Authorized — Risk score: {result.risk_score}/100")
    # Execute the action
else:
    print(f"✗ Blocked — {result.block_reason}")

Raise on block

from trustprotocol import TrustProtocol, TrustProtocolError

tp = TrustProtocol("your-api-key")

try:
    result = tp.intercept(
        agent_id="finance-agent-01",
        action="Transfer 150000 EUR to new beneficiary",
        cost_eur=150000.0,
        user_id="[e-mail]",
        raise_on_block=True
    )
    # Execute action
except TrustProtocolError as e:
    print(f"Blocked: {e.block_reason}")
    print(f"Risk score: {e.risk_score}/100")
    print(f"Reasons: {e.reasons}")

With LangChain

from trustprotocol import TrustProtocol
from langchain.tools import tool

tp = TrustProtocol("your-api-key")

@tool
def governed_payment(amount: float, recipient: str, user_id: str) -> str:
    """Execute a payment with TrustProtocol governance."""
    result = tp.intercept(
        agent_id="payment-agent",
        action=f"Transfer {amount} EUR to {recipient}",
        cost_eur=amount,
        user_id=user_id,
        raise_on_block=True
    )
    return f"Payment authorized. Attestation: {result.attestation_id}"

With the OpenAI Agents SDK

Requires the optional openai-agents extra: pip install "trustprotocol[openai-agents]"

from agents import Agent
from trustprotocol import TrustProtocol
from trustprotocol.openai_agents import protect_tools

tp = TrustProtocol("your-api-key")

agent = Agent(
    name="finance-agent",
    tools=protect_tools([transfer_funds, send_email], tp, user_id="[e-mail]"),
)

Every call to a protected tool is intercepted via /intercept before it runs. If TrustProtocol blocks the action, the tool call is rejected and the model is told why instead of the run crashing.

Audit & Verification

# Get audit ledger
ledger = tp.ledger(agent_id="finance-agent-01")
print(f"Total actions: {ledger['total']}")

# Verify chain integrity
verification = tp.verify_chain()
print(f"Chain valid: {verification['chain_valid']}")

# Pending approvals
approvals = tp.approvals()
print(f"Pending: {len(approvals.get('pending', []))}")

Links

• Dashboard
• Documentation
• Trust Center