agentscore

Python SDK for the DJD Agent Score API — trust scoring for AI agent wallets on Base.

Install

pip install agentscore

With framework integrations

pip install agentscore[langchain]   # LangChain tools
pip install agentscore[crewai]      # CrewAI tools
pip install agentscore[all]         # Everything

Quick Start

from agentscore import AgentScoreClient

client = AgentScoreClient()
result = client.basic_score("0xABC...")

print(result.score)           # 72
print(result.tier)            # "Trusted"
print(result.recommendation)  # "proceed"

Async

from agentscore import AsyncAgentScoreClient

async with AsyncAgentScoreClient() as client:
    result = await client.basic_score("0xABC...")

Trust Gate Decorator

Guard any function with a trust check:

from agentscore import trust_gate

@trust_gate(min_score=50)
def send_payment(wallet: str, amount: float):
    # Only runs if wallet scores >= 50
    ...

LangChain

from agentscore.langchain import AgentScoreTool, TrustGatedTool

# Add trust checking as a tool
tools = [AgentScoreTool(), ...other_tools]

# Wrap an existing tool with trust gating
safe_transfer = TrustGatedTool(
    tool=transfer_tool,
    min_score=50,
    wallet_param="recipient",
)

CrewAI

from agentscore.crewai import check_agent_trust

agent = Agent(
    role="Transaction Validator",
    tools=[check_agent_trust],
)

API Methods

Error Handling

from agentscore import PaymentRequiredError, NetworkError

try:
    result = client.full_score("0xABC...")
except PaymentRequiredError as e:
    print(f"Payment needed: {e.accepts[0].max_amount_required} {e.accepts[0].asset}")
    print(f"Pay to: {e.accepts[0].pay_to}")
except NetworkError as e:
    print(f"API error: {e} (status: {e.status_code})")

License

MIT