Catalog PyPI
PACKAGE EXPLORERView in registry

agent-passport-agl

PyPI

Python SDK for Agent Passport - AI Agent compliance proof system for EU AI Act Art.50

agentaiart50basecomplianceeu-ai-actweb3
Versions collected1
Direct dependencies2From release 0.4.0
Last observed20 Oct, 22:50 UTC

README

Version 0.4.0 documentation

Agent Passport SDK

5-minute EU AI Act Art.50 compliance for AI Agents on Base.

Agent Passport is a compliance proof system that helps platforms ensure every AI agent they interact with carries verifiable proof of regulatory compliance — starting with Art.50 disclosure obligations.

Install

pip install agent-passport-agl

Quick Start

from agent_passport import AgentPassportClient, passport_guard, set_default_client

# Initialize (read-only)
client = AgentPassportClient(rpc_url="https://mainnet.base.org")
set_default_client(client)

# Protect your agent handler with one decorator
@passport_guard(required_scope=1)  # attribute_type=1 for Art.50
def handle(agent_id, query):
    return f"Compliant response to: {query}"

Register an Agent

client = AgentPassportClient(
    rpc_url="https://mainnet.base.org",
    private_key="0xYOUR_KEY"
)
agent_id = client.register_agent(
    name="MyAgent",
    operator="0xYourAddress",
    metadata_uri="https://example.com/metadata.json"
)
print(f"Registered agent with ID: {agent_id}")  # uint256, starts at 1

Art.50 Disclosure

from agent_passport import Art50ComplianceChecker

checker = Art50ComplianceChecker(client)
header = checker.generate_disclosure_header(agent_id, interaction_type="chat")
# => X-AI-Disclosure: agent=1; compliant=true; compliance_level=2; type=chat

Deployed Contracts (Base Mainnet)

ContractAddress
AgentRegistry0xbeeFd54855e133055c6C5be8fD6549c3Fd92e0D9
AgentPassport0x5eBD4fCE45754c34557a237dd59cecec7A410c87
AccessGateway0xC46C3538Ea1Ea3dc41b762A2b298DD3C4cc65594
CompliancePassport0x1A086e034C7020CFE12d1ff8082Fc6aeD5787680

Features

  • @passport_guard — Decorator to enforce compliance checks on any handler
  • Art50ComplianceChecker — Check compliance status and generate disclosure headers
  • DelegationManager — Create and verify agent delegation proofs via EIP-712
  • Read-only mode — No private key needed for verification and queries
  • V2 Contracts — All ABIs matched to actual on-chain deployments on Base Mainnet

API Overview

AgentPassportClient

MethodDescription
register_agent(name, operator, metadata_uri)Register a new agent, returns int agentId
get_agent(agent_id)Get agent info → AgentInfo(owner, agent_wallet, agent_uri, registered_at, active)
issue_attestation(agent_id, attribute_type, attribute_value, schema_uri, valid_until)Issue attestation (requires VERIFIER_ROLE)
get_attestation(attestation_id)Get attestation details → AttestationInfo
get_agent_attestation_ids(agent_id)List attestation IDs for an agent
verify_agent(agent_wallet, message, signature)Verify proof of agent → (is_valid, agent_id)
get_certificate(cert_id)Get compliance certificate → CertificateInfo
get_agent_certificate_ids(agent_id)List certificate IDs for an agent
get_compliance_status(agent_id)Get all certificates for an agent
issue_certificate(...)Issue certificate (requires SCORER_ROLE)
record_risk_score(...)Record risk score (requires SCORER_ROLE)

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.4.011 Jul 20262

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
hbhqq9/agent-passport

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 22:50 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:0d6e26c8ebe80378d79563c591ef25413435505d043b7811dbf9ab67e7da973c