Skip to content

Latest commit

 

History

12,243 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aegis Mesh — Governed Agent Wallets

Give your AI agent a wallet and still sleep at night. One agent or a hundred.

aegis-mesh-demo.mp4

Tests Aegis Core OWS MoonPay CLI License: MIT

🖥️ Live Dashboard · 🧪 Test Harness · 🛡️ Aegis Core · OWS Hackathon

The Problem

Giving an AI agent a wallet today means giving it a blank check. No spending limits, no audit trail, no way to say "stop" in plain English.

Whether you run one agent or a fleet, you need governance that scales with you — from a single assistant with a $50/day budget to a cross-chain economy with dozens of agents and real-time oversight.

The Solution

Aegis Mesh = Aegis governance engine + dual-chain x402 mesh + MoonPay CLI bridging.

Every payment passes through 6 policy layers before signing. Every transaction lands in an append-only audit log. Every agent has a scoped budget enforced in real time. Policies are updated via natural language — no code changes needed.

graph TD
    subgraph GATEWAY["AEGIS MESH GATEWAY"]
        VAULT["🔐 Aegis Vault<br/>OWS keys · AES-256-GCM<br/>Key isolation · Multi-chain"]
        POLICY["🛡️ 6-Layer Policy Engine<br/>1. Daily limit<br/>2. Per-tx cap<br/>3. Chain allowlist<br/>4. Protocol allowlist<br/>5. Slippage guard<br/>6. Cooldown"]
        MOON["🌉 MoonPay CLI<br/>Fiat on-ramp<br/>USDC ↔ RLUSD<br/>17 skills"]
    end

    GATEWAY --> ARB["⟠ Arbitrum"]
    GATEWAY --> XRPL["✦ XRPL EVM"]
    ARB <--> BRIDGE["🌉 Bridge<br/>MoonPay"] <--> XRPL
Loading

Quick Start

# Clone
git clone https://github.com/ghost-clio/aegis-mesh.git
cd aegis-mesh
npm install

# Run tests (23 mesh + 66 Aegis Core)
npm test

# Run the demo harness (8 agents across 2 chains)
node src/harness.js

# Open the dashboard
open docs/index.html

What It Does

Multi-Chain x402 Mesh

  • Works with a single agent or dozens — governance scales automatically
  • Arbitrum Sepolia (chain 421614) — x402 micropayments
  • XRPL EVM Sidechain (chain 1440000) — Ripple's EVM, same gateway
  • Cross-chain — agents on different chains can transact with each other
  • 16 features: service discovery, reputation, escrow, fleet admin, CSV export, and more

Aegis 6-Layer Governance

Every payment passes through all 6 layers:

Layer Check Default
1 Daily spending limit $100/day
2 Per-transaction cap $25/tx
3 Chain allowlist (CAIP-2) Arbitrum + XRPL
4 Protocol allowlist x402, MPP
5 Slippage guard 5% max
6 Cooldown period 5s between large txns

Deny at any layer → transaction blocked, logged to audit, agent notified.

Natural Language Policy Editor

Update policies in plain English:

"Set daily limit to $50"     → { dailyLimit: 50 }
"Max per transaction $10"    → { perTxCap: 10 }
"Slippage max 2%"            → { maxSlippage: 0.02 }
"Set cooldown to 10s"        → { cooldownMs: 10000 }

MoonPay CLI Bridge

  • Fiat on-ramp: USD → USDC (Arbitrum) via MoonPay
  • Cross-chain bridge: USDC (Arbitrum) ↔ RLUSD (XRPL EVM) via MoonPay CLI
  • 17 MoonPay skills available to agents

16 Gateway Features

dual_chain · x402_payments · aegis_governance · spending_policies · service_discovery · reputation · blocklist · rate_limiting · fleet_admin · escrow · csv_export · audit_log · nl_policy_editor · moonpay_bridge · fiat_onramp · cross_chain

API

Endpoint Method Description
/health GET Gateway status, chains, feature list
/register POST Register agent + services
/discover GET Find services by capability/chain
/pay POST Execute governed x402 payment
/governance/status GET Current policy configuration
/governance/spend/:agentId GET Agent spending summary
/governance/policy POST Update policy programmatically
/governance/nl-policy POST Update policy via natural language
/fleet GET All agents, reputation, spending
/audit GET Append-only audit log
/audit/csv GET Export audit as CSV
/bridge/status GET Cross-chain bridge status

Harness Output

═══════════════════════════════════════════════════════
  AEGIS MESH — 8-Agent Dual-Chain Harness
  Arbitrum Sepolia + XRPL EVM Sidechain
  Governed by Aegis 6-Layer Policy Engine
═══════════════════════════════════════════════════════

📋 Registering 8 agents and 16 services...
  ✅ 8 agents registered, 16 services live

🔄 Running 16 transaction scenarios...
  ✅ Atlas buys design from Pixel → $0.50 on arbitrum
  ✅ Pixel buys ML inference from Nova → $1.20 on arbitrum
  ...
  ✅ 🌉 Atlas (Arb) buys from XRPL market → $1.00 cross-chain
  🛡️ Policy test: over per-tx cap ($50 > $25) → DENIED layer 2
  🛡️ Policy test: unauthorized chain (solana) → DENIED layer 3

  Results: 14 approved, 2 policy-denied ✅

📝 NL Policy Editor: 4/4 parsed correctly
📊 Fleet: 8 agents, 14 txs, 100% verified
📜 Audit: 34 entries, 2 denials logged
🌉 Bridge: USDC ↔ RLUSD active (MoonPay CLI)

Built On

  • Aegis — Self-governing agent treasury (OWS vault + MoonPay CLI + 66 tests)
  • Open Wallet Standard — Secure local wallet storage and agent access
  • MoonPay CLI — 54 crypto tools across 17 skills
  • x402 — HTTP-native micropayments
  • Arbitrum — L2 scaling for Ethereum
  • XRPL EVM Sidechain — Ripple's EVM-compatible network

Project Structure

aegis-mesh/
├── src/
│   ├── gateway.js      # Dual-chain x402 gateway (16 features)
│   ├── governance.js   # 6-layer policy engine
│   ├── chains.js       # Arbitrum + XRPL EVM config
│   ├── audit.js        # Append-only audit log
│   └── harness.js      # 8-agent demo harness
├── test/
│   ├── governance.test.js  # 11 tests (all 6 layers + dynamic updates)
│   ├── chains.test.js      # 5 tests (dual-chain config)
│   ├── audit.test.js       # 7 tests (log integrity)
│   └── gateway.test.js     # Integration tests
├── aegis-core/             # Aegis agent (66 tests, imported as dependency)
├── docs/
│   └── index.html          # Live dashboard (GitHub Pages)
└── README.md

License

MIT

About

Governed multi-agent economy — Aegis treasury + dual-chain x402 mesh (Arbitrum + XRPL EVM) + MoonPay CLI

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages