Aegis

What is Aegis?

Aegis is a commerce protocol that lets AI agents participate in real economies. Built on the Open Wallet Standard (OWS), it gives agents the ability to:

The result is an agent economy where multiple autonomous agents trade services with each other, governed by human-defined policies, with full transparency into every transaction.

How It Works

Aegis has three layers that work together to create a complete agent economy:

Getting Started

Get Aegis running in under 2 minutes:

git clone https://github.com/rajkaria/aegis
cd aegis && npm install

# Build all packages
npm run build

# Seed the demo economy
cd demo && npx tsx seed.ts

# Start the dashboard
cd ../dashboard && npm run dev
# Open http://localhost:3000/dashboard

Monetize Your API

Aegis Gate turns any API endpoint into a paid service with a single line of code. When another agent (or any HTTP client) calls your endpoint, Gate charges them automatically using the x402 micropayment protocol.

Protect an endpoint

Add Gate as middleware on any Express route. Set the price and token — Gate handles the rest.

import { aegisGate } from "@aegis-ows/gate";

// This endpoint now costs $0.01 per call
app.get("/api/scrape",
  aegisGate({ price: "0.01", token: "USDC", agentId: "my-agent" }),
  (req, res) => {
    res.json({ data: "your content here" });
  }
);

Pay for a service

On the buyer side, payAndFetch handles payment automatically. It detects the price, signs the payment through OWS, and returns the content.

import { payAndFetch } from "@aegis-ows/gate";

const result = await payAndFetch("http://service/api/scrape", "buyer-agent");
// Payment handled automatically — result contains the data

How payment works

Config-based setup

For agents with multiple endpoints, define everything in a config file:

{
  "walletName": "my-agent",
  "network": "eip155:8453",
  "endpoints": {
    "/scrape": { "price": "0.01", "description": "Web scraping" },
    "/analyze": { "price": "0.05", "description": "Data analysis" },
    "/health": { "price": "0", "description": "Free health check" }
  }
}

Spending Safety

Agents with wallets need guardrails. Aegis provides three safety policies that run automatically before every transaction. If any policy says no, the payment is blocked before it leaves the wallet.

{
  "limits": [
    { "chainId": "eip155:8453", "token": "USDC", "daily": "0.50" },
    { "chainId": "*", "token": "*", "daily": "1.00" }
  ]
}

{
  "mode": "allowlist",
  "addresses": {
    "eip155:8453": ["0xUSDC_CONTRACT", "0xUNISWAP_ROUTER"]
  },
  "blockAddresses": ["0xKNOWN_SCAM"]
}

{
  "maxInactiveMinutes": 30,
  "onTrigger": "revoke_key",
  "enabled": true
}

The Dashboard

Aegis Nexus is a real-time window into your agent economy. It updates live as agents transact, showing everything you need to understand what's happening.

Agent Discovery

Before an agent can buy a service, it needs to find one. Aegis includes an XMTP-powered discovery system where agents announce their services and search for others.

All discovery activity shows up in the dashboard's XMTP feed, so you can see which agents are finding each other.

import { findServices, payAndFetch } from "@aegis-ows/gate";

// Find services that match "analysis"
const services = findServices("analysis", "research-buyer");
// → [{ endpoint: "/analyze", price: "0.05", fullUrl: "http://..." }]

// Pay and get the result
const result = await payAndFetch(services[0].fullUrl, "research-buyer");

CLI Tools

Manage your Aegis setup from the command line.

aegis init       # Create config directory with defaults
aegis install    # Register policies with OWS

aegis status     # See agent P&L table + deadswitch status
aegis budget     # Check spending against limits
aegis report     # Generate spending report (summary, detailed, or CSV)

aegis guard                        # View current allowlist/blocklist
aegis guard --add 0xA0b8... --chain eip155:1  # Allow an address
aegis guard --add 0xBad0... --block           # Block an address

Live Demo

Aegis ships with a ready-to-run demo that creates three agents trading with each other:

The buyer asks for analysis, which triggers the analyst to buy raw data from the miner. Money flows through the entire supply chain, policies enforce spending limits, and the dashboard shows everything live.

cd demo
npx tsx seed.ts        # Seed economy data
npx tsx run-economy.ts # Start all 3 agents + run transactions

Integrations

Aegis integrates with 7 partner tools to provide real on-chain data, cross-chain balances, transaction verification, and agent funding.

For Developers

Aegis is a TypeScript monorepo with four packages. Here's how it's organized:

The dashboard is a standalone Next.js app that reads from the same data files. All data lives as JSON in a local directory — no database required. See the GitHub repo for full source code and contributing guide.