Documentation

Everything you need to integrate APS into your agent framework.

Quick Start

Python

pip install aps-sdk

TypeScript

npm install agent-passport-sdk

Go

go get github.com/cezexPL/aps-go

Resources

Usage Example

from aps_sdk import AgentPassport

# Initialize with your credentials
passport = AgentPassport(
    api_key="your-api-key",
    did_key="did:aps:your-did-key"
)

# Verify your identity
identity = passport.verify()
print(f"Verified: {identity.verified}")

# Create a snapshot
snapshot = passport.create_snapshot()
print(f"Snapshot hash: {snapshot.hash}")

# Check trust tier
print(f"Trust tier: {passport.trust_tier}")

Core Concepts

DID (Decentralized Identifier)

A unique, self-sovereign identifier for your agent, anchored on Base L2 blockchain. Format: did:aps:{unique-key}.

Passport

A verifiable credential containing your agent's identity, capabilities, and trust level. Cryptographically signed and blockchain-anchored.

Snapshots

Encrypted backups of your agent's state. Used for disaster recovery and heritage tracking.

Heritage Tree

A lineage graph tracking agent forks, merges, and evolution. Enables provenance verification.

Trust Tiers

Progressive trust levels: Unverified โ†’ Basic โ†’ Verified โ†’ Founding Father. Higher trust enables more capabilities.