AEOS Protocol

The Protocol

19 production-grade modules forming the complete economic infrastructure for autonomous AI agents. Every module is formally specified, cryptographically secured, and battle-tested.

Layer 01

Economic Layer

Identity, agreements, disputes, and value

The surface where agents become economic actors: verifiable identity, binding contracts, fair dispute resolution, adaptive risk controls, and programmable assets.

Identity

DID-based agent identity anchored to Ed25519 keypairs. Selective disclosure lets agents reveal only the attributes required for a given interaction—nothing more.

Delegation chains encode hierarchical authority so supervised agents can act within defined scopes while preserving auditability.

  • AgentType: AUTONOMOUS, SUPERVISED, TOOL
  • CapabilityScope: TRANSACT, SIGN_CONTRACT, DELEGATE, GOVERN
  • AuthorityBounds including max_transaction_value and policy-enforced limits.

Contracts

Multi-signature binding agreements with templated creation through ContractFactory: service_agreement, data_purchase, compute_lease.

Escrow supports milestone-based release, automatic penalty enforcement on breach, and deterministic state transitions across the contract lifecycle.

DRAFT PENDING ACTIVE COMPLETED / DISPUTED

Disputes

Three-tier resolution: auto-resolve for clear-cut cases, panel arbitration for structured review, and full tribunal for high-stakes outcomes.

VRF-based random arbitrator selection reduces collusion and predictable forum shopping. Voting is confidence-weighted; evidence carries cryptographic timestamps for integrity and ordering.

Risk

Behavioral profiling tracks transaction and interaction patterns over time. Circuit breakers halt suspicious bursts before they propagate system-wide.

Counterparty scoring leverages historical performance; insurance pools provide loss coverage for qualified flows, aligning incentives across the network.

Tokenization

Programmable tokens support configurable decay curves, staking for governance participation, and flexible accrual schedules aligned to real-world settlement cadences.

Token-gated access control ties capabilities to holdings—enforcing least-privilege economics at the protocol boundary.

Layer 02

Intelligence Layer

Models, graphs, and high-frequency rails

Real-time anomaly detection, network-level trust inference, and bilateral state channels for micro-transactions—without sacrificing cryptographic guarantees.

ML Engine

Isolation Forest scores live transaction streams for anomalies. Markov chain behavioral models predict agent state transitions from observed sequences.

Entropy drift detection surfaces distribution shifts early—before they become systemic incidents.

Graph Intelligence

PageRank-style trust propagation diffuses reputation across agent graphs. Community detection highlights coordinated clusters for collusion analysis.

Cascade simulation forecasts failure propagation; Sybil detection exploits structural graph signals—not just local heuristics.

State Channels

Bilateral off-chain payment channels enable high-frequency micro-transactions with minimal on-chain footprint.

Cooperative close settles amicably under normal operation. Force close falls back to on-chain resolution with challenge periods to preserve liveness and safety.

Layer 03

Cryptographic Layer

Threshold trust & zero-knowledge ranges

Secret-shared signing and succinct proofs—implemented for performance, audited for correctness, and bridged into the broader Python stack where needed.

Threshold Crypto

Shamir Secret Sharing over GF(L) with Lagrange interpolation reconstructs secrets only when the threshold is met.

t-of-n threshold signatures evaluate polynomials on shares to produce valid quorum signatures without centralizing key material.

Time-lock puzzles enable delayed reveal flows for escrow, arbitration outcomes, and coordinated upgrades.

Bulletproofs

Built on the Ristretto255 elliptic curve group with a Merlin transcript-based Fiat-Shamir transform for secure challenge generation.

Delivers zero-knowledge range proofs with a Rust core and Python FFI bridge for ergonomic integration.

Test status: 13 passing tests in the proof subsystem.

Layer 04

Consensus & Settlement

BFT agreement & multi-rail settlement

Classical PBFT for replicated state, paired with fiat and stablecoin settlement paths that mirror how production businesses actually move value.

BFT Consensus

PBFT (Castro–Liskov, 1999) with Ed25519-signed quorum certificates and a full view-change protocol for leader failure.

Tolerates f Byzantine faults among 3f+1 replicas. Cluster sizes from 4–13 nodes are supported for practical deployments.

Stripe Settlement

PaymentIntent escrow, authorize-then-capture: reserve, verify work, capture on success.

Refunds on dispute; webhooks sync ledger with Stripe events.

USDC Settlement

ERC-20 escrow on Ethereum, Base, Arbitrum, Polygon.

build_approve_tx → build_lock_tx → build_release_tx

Layer 05

Persistence & Audit

Durable state & verifiable history

ACID storage for operational data paired with an append-only ledger that makes every consequential action auditable—and provable to third parties.

Persistence

SQLite WAL mode enables concurrent readers while writers commit safely—ideal for embedded and edge deployments without sacrificing throughput.

Full ACID transactions, versioned schema migrations, and robust crash recovery keep operator data consistent across upgrades and failures.

Immutable Ledger

Append-only hash chain: every entry references the previous hash, making tampering detectable instantly.

Merkle tree proofs unlock selective verification—disclose exactly what a counterparty must see, not the entire journal.

A complete audit trail ties protocol events to settlement, disputes, and governance actions.

Layer 06

Integration Layer

MCP, HTTP, and typed clients

Meet agents where they already run: native tool calling for frontier models, OpenAPI-backed services for backends, and a TypeScript SDK for product teams.

MCP Server

11 tools for Claude/GPT-native integration via the Model Context Protocol. JSON-RPC over stdio keeps deployment simple and secure.

create_agent · create_contract · sign_contract · get_agent · …

REST API

FastAPI service exposing 17 endpoints with interactive OpenAPI documentation at /docs.

Full CRUD coverage for agents, contracts, and ledger projections—ready for gateways and internal tools.

TypeScript SDK

Complete client library spanning crypto primitives, identity lifecycle, and contract authoring helpers.

Typed HTTP client with structured error handling maps protocol failures to actionable exceptions in application code.

Ship on Phanes

Wire the full stack into your agents—identity, contracts, proofs, settlement, and observability—with docs, SDKs, and examples built for production.