Skip to content

agentnameservice/ans-registry

Repository files navigation

Agent Name Service (ANS)

My company's payment agent receives an instruction to wire $50,000 to a supplier's invoicing agent. The payment agent must decide: does this agent actually belong to the supplier, or has someone stood up a convincing fake? And if the site is legitimate, has the supplier's code changed since my last transaction?

ANS answers both questions. It anchors every agent's identity to a domain name whose ownership has been verified, issues a version-bound certificate that records which code is running, and seals every lifecycle event into a Transparency Log where entries cannot be altered after the fact. The standard is open and the services are federated, but the identity always anchors to a domain name.

Specifications

The ANS protocol is split across six layered specifications under spec/:

Layer File Topic
ANS-0 spec/ans-0-identity-anchor.md The proof-of-control gate, Verified Identities, identity profiles
ANS-1 spec/ans-1-registration.md Registration aggregate, lifecycle, event set
ANS-2 spec/ans-2-versioned-naming.md ANSName URI form, Identity Certificate URI SAN binding, mTLS
ANS-3 spec/ans-3-dns-publication.md DNS publication, record styles, DANE, anchor-conditional emission
ANS-4 spec/ans-4-transparency.md SCITT statements and receipts, Transparency Log, checkpoints and tiles, HCS anchoring
ANS-5 spec/ans-5-integrity-monitoring.md VerificationWorker, integrity reporting

Worked examples for ANS-1 live at spec/examples/ans-1-examples.md. DESIGN.md is a pointer to the layered specs and to the IETF draft.

TRUST_INDEX_SPEC.md — Trust evaluation. How a Trust Index crawls sealed data from federated Registration Authorities, combines it with external signals, and scores agents across five dimensions: integrity, identity, solvency, behavior, and safety. Trust Manifest schema, credential formats, identity grades, federation, and security considerations.

MAESTRO.md — Security analysis. Applies the CSA MAESTRO threat modeling framework to the ANS architecture. Maps threats and mitigations across all seven layers, from foundation models through the agent ecosystem, using a concrete multi-agent travel-booking scenario.

Related

SENDER_VERIFICATION_SPEC.md — Per-sender email verification. JWS header-only signing with key bindings sealed in a SCITT transparency log, discoverable via DNS. Targets business email compromise where domain-level authentication (DKIM/SPF/DMARC) passes but the sender is not who they claim. Not an ANS protocol feature.

API

SDKs

Origin

This architecture builds on "Agent Name Service for Secure AI Agent Discovery" by Narajala, Huang, Habler, and Sheriff (OWASP), contributed to the IETF as an internet-draft (draft-narajala-ans).

License

Apache 2.0. See LICENSE.

Releases

Packages

Used by

Contributors