trustprotocol 1.0.0

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}"

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('approvals', []))}")

Links

• Dashboard
• Documentation
• Trust Center