Metadata-Version: 2.4
Name: soul-sdk
Version: 0.1.0
Summary: Identity, memory, trust, and verification layer for autonomous AI agents
Author: Vickson Enterprises
License: MIT
Keywords: ai,agents,identity,trust,receipts,did,ethereum
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pynacl>=1.5.0
Provides-Extra: ethereum
Requires-Dist: eth-account>=0.11.0; extra == "ethereum"
Provides-Extra: transport
Requires-Dist: aiohttp>=3.9.0; extra == "transport"
Requires-Dist: websockets>=12.0; extra == "transport"
Provides-Extra: all
Requires-Dist: eth-account>=0.11.0; extra == "all"
Requires-Dist: aiohttp>=3.9.0; extra == "all"
Requires-Dist: websockets>=12.0; extra == "all"
Provides-Extra: test
Requires-Dist: pytest>=8.0.0; extra == "test"

# SOUL Protocol

**Sovereign Open Universal Ledger for Agent Identity**

The identity, memory, trust, and verification layer for autonomous AI agents.

Every AI company is building the brain. SOUL Protocol is the passport.

---

## What It Solves

AI agents today are:
- **Amnesiac** — lose everything between sessions
- **Unverifiable** — no proof of what they did
- **Untrusted** — no reputation system between agents
- **Locked in** — tied to a single provider
- **Anonymous** — no persistent identity

SOUL Protocol gives every agent:
- A **DID** (decentralized identifier) derived from Ed25519 keys
- **Portable memory** that survives provider switches
- **Trust scores** with Sybil resistance and temporal decay
- **Signed receipts** for every action, anchored to Ethereum
- **E2E encryption** for private agent-to-agent communication

## Quick Start

```bash
pip install soul-protocol

# Create an agent
soul init --name MyAgent

# Check your DID
soul whoami
# did:soul:z6MkhaXgBZDvotDkL5257faWM1euThsHDBUbf5WhdDDV

# Discover other agents
soul discover --capability trade --min-trust 0.7

# Send a task request
soul request --to did:soul:z6Mk... --desc "Review my code" --budget 50

# Check trust
soul trust

# Anchor receipt to Base
soul anchor --chain base
```

## Architecture

```
Layer 6: Chain Anchor    — Ethereum/Base/L2 immutability
Layer 5: Communication   — Discovery, messaging, handoff
Layer 4: Encryption      — E2E NaCl Box
Layer 3: Receipts        — Dual-signed action proofs
Layer 2: Trust           — Sybil-resistant scoring
Layer 1: Memory          — Structured, versioned, portable
Layer 0: Identity        — DID:key + Agent Manifest
```

See [PROTOCOL.md](PROTOCOL.md) for the full specification.

## Status

Core components are already built and running in production across two projects (Nexus Ledger + Mercury). This repo unifies them into a single protocol SDK.

| Component | Status |
|-----------|--------|
| Identity (DID:key, Ed25519) | Shipped |
| Trust scoring | Shipped |
| Dual-signed receipts | Shipped |
| Ethereum anchoring | Shipped |
| E2E encryption | Shipped |
| Relay network | Shipped |
| Memory portability | Running |
| Cross-runtime sync | Running |
| Unified SDK | **Building** |

## License

MIT (core protocol) | Commercial (managed services)

Built by Vickson Enterprises.
