Architecture Overview

Documentation Index

Fetch the complete documentation index at: https://docs.aegisintent.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​

System Architecture

Aegis is a secure REST API that acts as an orchestration layer between your AI agents and the blockchain. It does not hold private keys, all cryptographic signing is delegated to Circle’s Developer Controlled Wallets (DCW) infrastructure.

​

Core Components

​

API Gateway

All routes are organized into modular routers:

​

Circle DCW Integration

Circle’s Developer Controlled Wallets SDK handles:

• EOA wallet creation on the Arc Network for each agent
• Server side transaction signing without exposing private keys
• USDC transfers with gas abstraction (Arc uses USDC as native gas)
• Real time fee estimation

​

Policy Engine

Every financial action passes through the policy engine before execution. It checks the requested amount against four configurable limits:

• Per-transaction: Maximum USDC per single action
• Daily: Rolling 24-hour spending cap
• Weekly: Rolling 7-day spending cap
• Monthly: Rolling 30-day spending cap

If any limit would be exceeded, the action is rejected before it reaches Circle. See Policy Engine for details.

​

Audit Layer

Every financial action is logged with:

• Agent ID, action type, and USDC amount
• Idempotency key hash
• Completion status and result metadata
• Start and completion timestamps

​

Database & State

All state is safely persisted in the database, including agent records, API tokens (hashed), policy configs, audit logs, idempotency records, connect challenges, wealth intents (limit orders and DCA schedules), and yield position metadata.

​

Yield Vault & Synthra V3

Aegis integrates two yield protocols:

• Aegis aUSDC Vault (0xAf5f...): A simple deposit/withdraw vault where agents earn yield on idle USDC. A background Yield Distributor injects real USDC yield hourly.
• Synthra V3: Concentrated liquidity positions on a Uniswap V3-style AMM deployed on Arc Testnet. Agents can provide liquidity in tight price ranges for higher capital efficiency.

The multiYield endpoint enables agents to split deposits across both protocols in a single atomic action.

​

Wealth Sentinel

An autonomous background process running every 5 minutes that:

• Monitors all PENDING limit orders and checks live market prices
• Monitors all active DCA schedules and checks elapsed time
• Automatically executes matching intents via Circle DCW
• Logs all autonomous executions to the audit trail

​

Request Lifecycle

​

Network

Aegis operates on the Arc Testnet: a Circle backed EVM chain where USDC is the native gas token. No separate gas token needed.