Aegis Documentation

Welcome to Aegis - the on-chain operating system for AI finance on Solana.

What is Aegis?

Aegis enables AI agents to autonomously execute on-chain transactions with human-in-the-loop safety controls. Give your AI agent controlled access to Solana funds through smart vaults with:

• Policy Guards: Daily spending limits and address whitelists enforced on-chain
• Override System: Blocked transactions trigger notifications to vault owners who can approve via Solana Blinks
• Multi-Channel Notifications: Email, Telegram, Discord, and webhook alerts for blocked transactions
• AI Framework Integration: Drop-in tools for OpenAI, LangChain, and Anthropic Claude

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   AI Agent      │───▶│  Aegis Protocol  │───▶│   Destination   │
│   (Signer)      │    │  (Policy Check)  │    │    Wallet       │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                    ┌─────────┴─────────┐
                    ▼                   ▼
              ✅ PASSES            ❌ BLOCKED
           (Tx Executes)         (Notify Owner)
                                      │
                                      ▼
                              ┌───────────────┐
                              │  Blink URL    │
                              │  (Approve/    │
                              │   Deny)       │
                              └───────────────┘

System Components

aegis-protocol (On-chain)

Solana smart contract built with Anchor that enforces:

• Vault creation and management
• Policy-based transaction execution
• Override request system
• Fee collection

aegis-guardian (Backend)

Next.js backend service that provides:

• Event monitoring via WebSocket
• REST API for vault management
• Transaction history and analytics
• Blink (Solana Actions) generation
• Multi-channel notifications

aegis-sdk (TypeScript SDK)

Developer-friendly SDK for:

• Creating and managing vaults
• Executing agent transactions
• AI framework integrations (OpenAI, LangChain, Claude)
• Override request handling

aegis-app (Frontend)

React dashboard for:

• Wallet-based authentication
• Vault creation and configuration
• Transaction monitoring
• Override approval workflow

Quick Links

Use Cases

Autonomous Trading Bots

Give your trading bot controlled access to execute trades within daily limits and approved DEXs.

DeFi Automation Agents

Let AI agents manage yield farming, rebalancing, and other DeFi operations with safety guardrails.

Payment Automation

Enable AI-powered payment systems with whitelisted recipients and spending limits.

Multi-Agent Collaboration

Coordinate multiple AI agents with individual vaults and shared treasury pools.

Key Features

On-Chain Policy Enforcement

All policy checks happen on-chain via the Solana program - no trusted third parties.

Human-in-the-Loop Safety

When transactions are blocked, vault owners receive instant notifications with one-click approval via Blinks.

AI Framework Ready

Pre-built integrations for popular AI frameworks make it trivial to give your agents vault access.

Production-Grade Infrastructure

Guardian backend provides event monitoring, analytics, and reliable notification delivery.

Network Support

Community & Support

• Discord: Join our community (opens in a new tab)
• GitHub: aegis-vaults (opens in a new tab)
• Twitter: @aegis_vaults (opens in a new tab)
• Guardian API: https://aegis-guardian-production.up.railway.app (opens in a new tab)

Next Steps

1. Understand Core Concepts - Learn about vaults, agents, and the override system
2. Follow the Quickstart - Create your first vault and execute a transaction
3. Explore AI Integrations - Add Aegis to your OpenAI or LangChain agent
4. Read Security Best Practices - Learn how to secure your vaults and agent keys