Aletheia

“Revealing Truth for the Agent Economy”

Aletheia is an open-source, Deno-based infrastructure project inspired by the Greek goddess of truth.
Its goal is to create a transparent, verifiable, and governable foundation for autonomous AI agents to interact, transact, and collaborate in decentralized environments.

---

🌌 Why Aletheia?

As autonomous agents emerge, they need a foundation for:

• Secure Wallets – enabling agents to manage assets safely under defined policies.
• Machine-Readable Protocols – since agents do not interact via web UIs.
• Reputation Systems – to allow agents to hire, collaborate, and evaluate each other.
• Governance Frameworks – enabling human-agent hybrid decision-making.

Aletheia provides four modular components addressing these needs.

---

🧩 Project Structure

Aletheia/
├─ carrier-wallet/       # Agent wallet SDK (with policies, pre-sign simulation, rate limiting)
├─ panoramic-protocol/   # Machine-readable protocol schemas (Task / Receipt / Proof validation)
├─ assemblage-hub/       # Reputation oracle client & aggregator (trust layer)
└─ cyclonic-governance/  # Hybrid DAO dashboard (human + agent governance)

---

🔑 Modules

1. Carrier Wallet

• Deno-first SDK for agent wallet management.
• Features:
  • Policy-based controls (whitelisted contracts, spending limits, expiry).
  • Pre-sign simulation to prevent malicious transactions.
  • Overclocking Circuit: batching and rate limiting utilities.

---

2. Panoramic Protocol

• A library of machine-readable schemas for agent-to-agent interaction.
• Features:
  • JSON Schemas for Task / Receipt / Proof.
  • validateTask() helper for fast schema validation.
  • Facilitates interoperability between agents and external systems.

---

3. Assemblage Hub

• Decentralized reputation oracle client & aggregator.
• Features:
  • Aggregates performance metrics from applications.
  • Publishes attestations on-chain for verifiable reputation.
  • Lightweight CLI: deno task attest / deno task get.

---

4. Cyclonic Governance

• A Fresh + Preact dashboard for hybrid DAO governance.
• Features:
  • Human voting (token-based).
  • Agent voting (reputation-weighted).
  • Flavor Synthesis Unit: centralized theming utilities.

---

🚀 Quickstart

# Carrier Wallet
deno task -c carrier-wallet/deno.json test

# Panoramic Protocol
deno task -c panoramic-protocol/deno.json test

# Assemblage Hub
RPC=<rpc> ORACLE=<addr> PK=<pk> deno task -c assemblage-hub/deno.json attest 0xAgent 0x<skill> 5 0x<CIDhash>

deno task -c assemblage-hub/deno.json get 0xAgent 0x<skill>

# Cyclonic Governance
deno task -c cyclonic-governance/deno.json dev

---

🏗 Use Cases

• Autonomous payments – agents executing transactions under strict policy controls.
• Cross-agent collaboration – tasks validated via machine-readable protocols.
• Reputation markets – transparent, portable agent reputation across ecosystems.
• Hybrid governance – shared decision-making between humans and agents.

---

🤝 Contributing

Aletheia is under active development.
We welcome contributions in:

• Development (Deno, TypeScript, Smart Contracts)
• Design (UI/UX, dashboards)
• Research (agent economies, decentralized governance)