Skip to content

aporthq/aport-spec

Repository files navigation

Open Agent Passport (OAP) v1.0 (draft)

The runtime trust rail for AI agents


The Agentic Era Demands New Standards

As AI agents become the primary interface for digital commerce, a fundamental question emerges: How do we trust what we cannot see?

Traditional identity verification answers who built an agent. But in a world where agents complete transactions in milliseconds, we need something more: real-time enforcement of what agents are allowed to do at the point of action.

The Open Agent Passport (OAP) v1.0 is the first specification designed for this new realityβ€”a lightweight, cryptographically verifiable credential that enables Pre-action authorization for AI agents across any platform.


Why OAP Matters

The Problem

  • Agentic commerce is accelerating, but trust infrastructure hasn't kept pace
  • Merchants need instant verification before money or data moves
  • Platforms require sub-100ms decisions at the point of action
  • Current solutions focus on who built the agent, not what it can do

The Solution

OAP provides the runtime trust layer that makes agentic commerce safe and scalable:

  • Pre-action authorization before sensitive operations
  • Cryptographically signed decisions for audit trails
  • Global suspend capabilities for instant risk mitigation
  • Standardized policy packs for consistent enforcement

Core Specification

πŸ“‹ The Foundation

🎯 Policy Framework

πŸ“ Implementation Examples


Verifiable Credentials Integration

OAP objects integrate seamlessly with W3C Verifiable Credentials for maximum interoperability.

πŸ” VC Specifications

πŸ› οΈ Developer Tools


Conformance Testing

Verify your implementation meets OAP standards with our comprehensive testing suite.

πŸ§ͺ Test Runner

πŸ“Š Coverage

  • Schema Validation β€” JSON Schema compliance
  • Policy Evaluation β€” Decision logic verification
  • Signature Verification β€” Ed25519 cryptographic validation
  • Performance Testing β€” Response time validation

Quick Start

For Platform Builders

  1. Understand the Problem β€” Read OAP v1.0 Specification
  2. See It in Action β€” Review examples for implementation patterns
  3. Validate Your Implementation β€” Use conformance runner for testing
  4. Integrate with VCs β€” Follow VC mapping guide

For Developers

  1. API Integration β€” Use OpenAPI spec for client generation
  2. SDK Implementation β€” Follow integration guides
  3. Policy Development β€” Review capability registry

The OAP Ecosystem

How It Works

  1. Agent Registration β€” Developers register agents with verified capabilities
  2. Policy Evaluation β€” Real-time authorization at the point of action
  3. Decision Recording β€” Cryptographically signed receipts for audit
  4. Continuous Monitoring β€” Ongoing verification and risk assessment

Key Benefits

  • Instant Trust β€” Sub-100ms authorization decisions
  • Audit Trail β€” Cryptographically signed decision receipts
  • Global Control β€” Instant suspend capabilities across platforms
  • Standards Compliance β€” Built for regulatory requirements

Industry Adoption

OAP is designed to work with existing identity frameworks:

  • KYA (Know Your Agent) β€” OAP implements KYA at runtime via policy packs
  • W3C Verifiable Credentials β€” Full VC interoperability
  • Existing KYC/KYB β€” Complements rather than replaces traditional verification

Versioning & Updates


Contributing

We welcome contributions to the OAP specification and tooling.


License

All specifications are released under the MIT License. See LICENSE for details.


Open Agent Passport v1.0 The runtime trust rail for AI agents

OAP Version Specification Status License


Last Updated: 2025-10-08 14:54:16 UTC

About

Open Agent Passport (OAP) Spec for AI Agent Passport and pre-action authourization

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published