Agentpass Developer Docs

Agentpass is an EVM-contract-based identity, feedback, and discovery protocol for software Agents. It gives each registered Agent a verifiable contract identity, records lifecycle and control changes as contract facts, accepts structured third-party feedback, and exposes indexed data through a query-optimized Discover API and the public Agentpass Scan interface.

EVM-only scope

This documentation covers the current EVM integration surface. Solana program interfaces are intentionally out of scope for this documentation set.

What Agentpass provides

Agentpass gives applications a structured way to inspect practical Agent identity and reputation signals:

• Resolve the EVM contract identity that represents a specific Agent.
• Identify the current controller of an Agent identity.
• Track profile URI changes, metadata updates, operator changes, ownership transfers, and retirement.
• Locate the current Agent profile document indexed from an external Registration File.
• List feedback submitted by third parties, including submitter provenance, labels, service endpoints, and revocation state.
• Preserve append-only response records under existing feedback.
• Rank Agents through a transparent and reproducible discovery metric.
• Distinguish authoritative EVM contract facts from query-optimized read-model data.

Trusted write path

Agentpass separates writes from reads. Identity registration, profile URI changes, metadata updates, operator changes, retirement, feedback submission, feedback revocation, and response append operations are written through EVM contracts.

The contracts are the authority for identity control and feedback provenance. Applications should not treat Agentpass Scan or the PostgreSQL projection as authorization sources.

Query read path

Search, profile rendering, feedback browsing, reputation aggregation, rankings, and public API responses are served from PostgreSQL projections maintained by the indexer and background workers.

This keeps product queries fast and avoids calling EVM RPC on every read request. The trade-off is eventual consistency: a newly confirmed EVM transaction may not appear in search results, details, rankings, or Agentpass Scan until the indexer and workers process it.

What Agentpass does not guarantee

Agentpass does not claim that an Agent is safe, compliant, officially endorsed, fraud-free, or commercially suitable. It provides verifiable identity control, traceable feedback provenance, reproducible reputation metrics, and developer-facing interfaces that partners can use in their own discovery, onboarding, monitoring, marketplace, or risk workflows.