agentscore 0.1.0

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

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

Method	Description	Tier
basic_score(wallet)	Basic reputation score	Free
full_score(wallet)	Full score with dimensions	Paid (x402)
refresh_score(wallet)	Force refresh from chain	Paid (x402)
should_transact(wallet)	Quick yes/no check	Free
gate_transaction(wallet)	Full gating decision	Free
report_fraud(wallet, reason)	Submit fraud report	Free
check_blacklist(wallet)	Check fraud reports	Paid (x402)
get_badge(wallet)	SVG trust badge	Free
get_leaderboard(limit)	Top scored agents	Free
register_agent(wallet, ...)	Register agent wallet	Free
health_check()	API health status	Free

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