soul-sdk 0.1.0

Identity, memory, trust, and verification layer for autonomous AI agents

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

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 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.