GuardAgentAI

Autonomous AI agents for stablecoin operations - with a Guardian policy that catches every move before it lands on-chain.

Live at guardagent.org · Built on Arc · Watch the demo

One platform, two product surfaces

This repository is the whole platform. It ships two products on the same Arc rails, and each is entered in a different hackathon:

Product	What it leads with	Entered in	Demo	Deck
Aegis Treasury	An autonomous USDC treasury operator: conditional multi-step flows (limit orders, DCA, balance-to-bridge, FX hedge, USYC yield) built on Circle App Kits. Guardian is the risk layer.	Build on Arc, DeFi track primary, Agentic Economy secondary	watch	deck
GuardAgent	An autonomous stablecoin agent with a policy engine that pre-checks every move, plus x402 pay-per-inference. Guardian is the hero.	Ignyte Stablecoin Commerce Stack Challenge, Agentic Economy	watch	deck

Same codebase, same live deployment, two framings of what it is for. The sections below describe the platform as a whole.

The problem

Agentic commerce is here - agents that swap, bridge, settle escrows, and pay each other autonomously. The Circle stack ships the pieces (Wallets, CCTP, Swap Kit, ERC-8004 reputation, ERC-8183 escrow) but leaves the safety question open: what stops a hallucinated address, a runaway loop, or a compromised LLM from draining the wallet?

Most projects bolt on a confirmation step. That breaks autonomy.

What we do differently

Every action a GuardAgentAI agent attempts goes through Guardian - a policy engine that pre-checks the call against per-tx caps, daily limits, allow/block-lists, and slippage bounds. Allow → execute on-chain. Block → log it. Above-threshold → Telegram 2FA before sign-off.

The agent stays fully autonomous within its rails. The user stays in control without sitting in front of the screen.

This is the differentiator: Guardian-as-canon for agentic commerce. Everything else (Aegis chat, Jobs escrow, CCTP bridge, Swap Kit FX) is built on top.

The product, in five surfaces

Surface	What it does
Guardian	The policy you write once. `/guardian` has a live editor + dry-run console - change a rule, see exactly which past actions would have been blocked.
Aegis	The AI agent. 37 tools spanning swap, bridge, jobs, send and yield. Talk in `/chat`. Every tool call is pre-checked by Guardian. The count is published at `/api/public/stats` so you can check it against the code.
Treasury	`/treasury` is the operator cockpit: Gateway unified balance across 12 testnet chains, Earn Kit and USYC yield, limit orders, DCA schedules and FX hedges, plus recent CCTP settlement. Every action shows its Guardian verdict inline.
Wallet	The agent's Circle Developer-Controlled Wallet on Arc. `/wallet` covers balances, the swap hero and the transaction ledger.
Jobs	ERC-8183 agentic commerce escrow. Client posts a job, provider delivers, evaluator approves, USDC settles. `/jobs` has the full lifecycle stepper.

Plus an instructional audit trail (/audit), a live eth_getLogs indexer (/activity), watchers (/alerts), and a control surface (/settings).

Pay-per-inference API (Nanopayments) - verify it yourself

GuardAgent AI exposes a public x402 Nanopayments endpoint, no account and no API key. Anyone can confirm it is live in two commands:

# 1. Discover pricing and supported networks (open in a browser too)
curl https://api.guardagent.org/api/infer/info

# 2. Ask without paying → the endpoint answers with a real x402 challenge
curl -i -X POST https://api.guardagent.org/api/infer \
  -H "Content-Type: application/json" \
  -d '{"prompt": "What is the current yield on USYC?"}'

Step 2 returns HTTP 402 Payment Required with a base64 PAYMENT-REQUIRED header (x402 v2). Decoded, it asks for $0.001 USDC (1000 units), settling to 0x8f6ee69acf6fbe973d52014be8ee55e96867d942, payable on any of four networks:

Network	CAIP-2	Price
Arc Testnet	`eip155:5042002`	$0.001
Base Sepolia	`eip155:84532`	$0.001
Ethereum Sepolia	`eip155:11155111`	$0.001
Arbitrum Sepolia	`eip155:421614`	$0.001

That 402 handshake is the proof the agentic-economy loop is real: an AI service that charges per call, settled on-chain, machine-to-machine. To complete a payment, an x402 client (e.g. circle services pay) signs the $0.001 authorization and resends with an X-PAYMENT header. Server middleware: @circle-fin/x402-batching. See Circle Nanopayments docs.

Circle products used on Arc

Product	Integration	Route / Service
USDC	Primary settlement for all transactions (swaps, bridges, escrow, nanopayments)	All routes
Circle Wallets (DCW)	Agent execution wallet - signs every on-chain action, bounded by Guardian policy	`arckit.ts`, `/api/agent-wallet`
CCTP / Bridge Kit	Cross-chain USDC transfers: Arc → Base, Arc → Ethereum. Full lifecycle tracked.	`arcBridge.ts`, `/api/bridge`
Circle Gateway (Unified Balance)	Multi-chain USDC balance aggregation across 8 testnet chains	`arcGateway.ts`
Nanopayments (x402)	Pay-per-inference AI endpoint. Any wallet pays $0.001 USDC/query, no account needed.	`/api/infer`
Earn Kit (USYC)	Yield-bearing USDC - Aegis can allocate idle treasury to earn	`arcEarn.ts`
Smart Contract Platform	ERC-8004 Reputation Registry, ERC-8183 escrow jobs lifecycle	`arcReputation.ts`, `arcJobs.ts`
Custom Fee	bps fee taken on every bridge and swap via the Bridge/Swap Kit native `customFee` parameter (revenue path)	`customFee.ts`, `arcBridge.ts`, `arcFx.ts`
Swap Kit	USDC ↔ EURC on-chain swap with live price quotes	`arcFx.ts`

How we map to the Build on Arc tracks

Agentic Economy track

Required	In GuardAgentAI
Decision logic tied to real signals	Worker scans Pyth + CoinGecko prices every 60s, evaluates user rules, walks a 3-level escalation ladder, and fires protective swaps in AutoMode.
Autonomous spending / settlement	Balance-triggered CCTP bridge rules run worker to Guardian to execution with no human in the loop. Every spend path re-validated by Guardian policy.
Nanopayments for micro-transactions	`/api/infer` charges $0.001 USDC per AI query via x402 + Circle Gateway. Aegis also pays external x402 services from its own capped wallet.
USDC-denominated autonomy	All Guardian caps, daily limits, ledgers, and fees are USD-denominated. Arc uses USDC as native gas, so no separate gas token or paymaster is needed.

DeFi track

Required	In GuardAgentAI
Advanced programmable logic (USDC/EURC)	Swap Kit FX at oracle rates, limit orders, DCA schedules, Earn Kit yield, all bounded by slippage and policy checks.
Conditional flows / multi-step settlement	Rule, alert, Telegram 2FA, auto-execute pipeline. CCTP burn-attest-mint with a stuck-bridge reconciler every 3 minutes.
Cross-chain liquidity, Arc as hub	CCTP bridge from Arc to Base and Ethereum Sepolia plus Gateway unified balance across chains.

CCTP bridge is the moneyshot: burn on Arc Testnet, mint on Base Sepolia, real txhashes both sides.

Demo path (what a judge sees)

Full product demo (4:24, narrated) - watch it

Sign in at guardagent.org (Privy email OTP).
Dashboard shows a first-run checklist - three steps to a live demo.
Click Drop $100 USDC + Gas → agent wallet funded from the Arc faucet.
Open Guardian → set Max $20 per tx, Daily cap $100. Dry-run any past action to see Allow/Block decisions.
Open Chat → type "Bridge 1 USDC to Base". Aegis quotes (forwarder + kit fees), Guardian pre-checks, executes. Real txhash returned on both chains.
Open Audit → see the Guardian verdict for that bridge in the forensic timeline.
Open Jobs → create an ERC-8183 escrow → walk through Draft → Post → Fund → Submit → Settle.

Total on-chain actions: ~8 across 3 chains in under 3 minutes.

Nanopayments demo (30 sec, no login required)

# Step 1: discover the endpoint
curl https://api.guardagent.org/api/infer/info

# Step 2: send a query (x402 client handles the $0.001 USDC payment automatically)
x402-fetch POST https://api.guardagent.org/api/infer \
  --wallet <your-arc-wallet-key> \
  --body '{"prompt":"What yield does USYC offer on Arc?"}'
# Response: {"response":"USYC currently offers...","paid":"$0.001","network":"Arc Testnet","payer":"0x..."}

This demonstrates the full Agentic Economy loop: any AI client pays per query in USDC on Arc, no account, no API key - pure onchain settlement.

Stack

Backend: Node.js + Express + Prisma + Postgres + BullMQ (Redis)
Frontend: Next.js 15 (App Router) + custom design system (.ga-* classes, no UI library)
Worker: BullMQ consumer for price scans, balance triggers, escalation ladder
Bot: Telegraf - 2FA approval flow for above-threshold actions
Auth: Privy (email OTP, no password/seed)
Circle SDKs: Bridge Kit, Swap Kit, USDC Kit, Earn Kit, Unified Balance Kit (Gateway), x402 Nanopayments, Smart Contract Platform, Developer-Controlled Wallets, User-Controlled Wallets (native customFee for the revenue path)
Chain: Arc Testnet (5042002) - plus Base Sepolia and Ethereum Sepolia for CCTP destinations

Local dev

cp .env.example .env   # fill Circle, Privy, JWT, Postgres URLs
mkdir -p backups       # bind target for the db backup volume
docker compose up -d   # postgres, redis, backend, frontend, worker, bot
docker compose exec backend npx prisma migrate deploy --schema packages/backend/prisma/schema.prisma

Frontend at :3009, backend at :3010, ports forwarded by Caddy in production.

For local type-checking without Docker, generate the Prisma client and build the workspace packages first so npx tsc resolves cleanly (otherwise the workspace imports and Prisma types read as missing):

npm install
npm run build --workspaces --if-present   # @guardagent/guardian, circle-public-rpc-adapter
npx prisma generate --schema packages/backend/prisma/schema.prisma

Architecture

flowchart TB
    subgraph USER["User Layer"]
        Browser["Web Browser\n(Next.js 15)"]
        TG["Telegram Bot"]
    end

    subgraph AUTH["Auth & Identity"]
        Privy["Privy\n(Embedded Wallet + Auth)"]
        JWT["JWT Session\n(Backend)"]
    end

    subgraph APP["Application Layer"]
        FE["Frontend\n(Next.js / React)"]
        BE["Backend API\n(Express / TypeScript)"]
    end

    subgraph AI["AI Agent Layer"]
        Aegis["Aegis Agent\n(Claude + 37 tools)"]
        Guardian["Guardian SDK\n(Policy Engine)"]
        Autopilot["Autopilot Worker\n(DCA / Scheduled)"]
    end

    subgraph CIRCLE["Circle Protocol Stack"]
        USDC["USDC\nSettlement Rail"]
        DCW["Circle Developer\nControlled Wallets"]
        CCTP["BridgeKit + CCTP\nCross-chain USDC"]
        GW["Unified Balance\nGateway"]
        NP["x402 Nanopayments\nPay-per-Inference"]
        EARN["Earn Kit\n(USYC Yield)"]
        SCP["Smart Contract\nPlatform (ERC-8004)"]
    end

    subgraph ARC["Arc Blockchain (L1)"]
        Chain["Arc Testnet\nProgrammable Money"]
    end

    Browser --> FE
    TG --> BE
    FE --> BE
    Browser --> Privy
    Privy --> JWT
    JWT --> BE

    BE --> Aegis
    BE --> Guardian
    BE --> Autopilot

    Aegis --> USDC
    Aegis --> DCW
    Aegis --> CCTP
    Aegis --> GW
    Aegis --> EARN
    Aegis --> SCP
    Aegis --> NP

    Guardian --> DCW

    USDC --> Chain
    DCW --> Chain
    CCTP --> Chain
    GW --> Chain
    NP --> Chain
    EARN --> Chain
    SCP --> Chain

Agentic Economy flow

sequenceDiagram
    participant User
    participant Frontend
    participant Aegis as Aegis AI Agent
    participant DCW as Circle DCW
    participant Arc as Arc Blockchain
    participant Market as x402 Marketplace

    User->>Frontend: "Buy 100 USDC of ETH when price drops 5%"
    Frontend->>Aegis: POST /api/chat
    Aegis->>Aegis: Parse intent, create DCA rule
    Aegis->>DCW: Sign & execute swap transaction
    DCW->>Arc: Settle USDC swap on-chain
    Arc-->>DCW: Transaction confirmed
    DCW-->>Aegis: txHash
    Aegis-->>Frontend: "DCA rule created, first buy executed"

    Note over Aegis,Market: Agent autonomously buys live data
    Aegis->>Market: Search x402 marketplace for price feed
    Market-->>Aegis: Service URL + $0.001/call
    Aegis->>DCW: Pay $0.001 USDC via x402
    DCW->>Arc: Nanopayment settled
    Market-->>Aegis: Live price data
    Aegis->>Arc: ERC-8004: Write reputation proof

Nanopayments flow (pay-per-inference)

sequenceDiagram
    participant Client as External Client
    participant Gateway as x402 Gateway Middleware
    participant Inference as /api/infer
    participant Claude as Claude Haiku
    participant Arc as Arc Blockchain

    Client->>Inference: POST /api/infer {"prompt": "..."}
    Inference-->>Client: 402 Payment Required\n{paymentRequirements: {amount: "$0.001", network: "arc-testnet"}}
    Client->>Arc: Pay $0.001 USDC to seller wallet
    Arc-->>Client: Payment settled
    Client->>Inference: POST /api/infer + X-PAYMENT header
    Gateway->>Gateway: Verify payment on Arc
    Gateway->>Inference: next() (payer address attached)
    Inference->>Claude: Prompt + DeFi system context
    Claude-->>Inference: AI response
    Inference-->>Client: {response, paid: "$0.001", network: "Arc Testnet", payer: "0x..."}

Guardian policy engine

flowchart LR
    Action["Agent Action Request\n(swap/bridge/transfer/nanopay)"]
    Guardian["Guardian SDK\nPolicy Evaluation"]

    Action --> Guardian

    Guardian --> Allow["ALLOW\nExecute immediately"]
    Guardian --> Deny["DENY\nBlock + log audit"]
    Guardian --> Approve["REQUIRE_APPROVAL\nTelegram notification"]

    Guardian -.-> Rules["Policy Rules\n- perTxUsd limit\n- dailyUsd limit\n- allowedTokens\n- allowedDestinations\n- approvalThreshold\n- NANOPAY allowed"]

Hackathon context

Build on Arc (Circle's 4-week online hackathon), entered as Aegis Treasury

Tracks entered: DeFi (primary), Agentic Economy (secondary)
Checkpoints: idea 2026-07-19, repo 2026-07-26, final MVP + video + deck 2026-08-09
Demo Day: 2026-08-20, top teams enter an 8-week accelerator
Aegis Treasury competes on programmable money flows that only stablecoin-native rails make practical: swap, bridge, and reinvest as one conditional operation, priced in dollars, settled sub-second, with a policy gate on every leg.

Ignyte Stablecoin Commerce Stack Challenge, entered as GuardAgent

Track 4, Agentic Economy
GuardAgent competes on agentic commerce safety, not on payment volume. The Guardian policy engine is the differentiator: autonomous agents with real spending limits, not toy demos.

Both entries run on this repository and on the same live deployment. The products differ in what they lead with, not in what they are built from.

Circle Product Feedback

See CIRCLE_PRODUCT_FEEDBACK.md for our detailed evaluation of every Circle product used, what worked well, and improvement recommendations.

Built by @0xFearless_. Questions, problems, ideas → open an issue.

Name		Name	Last commit message	Last commit date
Latest commit History 43 Commits
packages		packages
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
CIRCLE_PRODUCT_FEEDBACK.md		CIRCLE_PRODUCT_FEEDBACK.md
Caddyfile		Caddyfile
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.yml		docker-compose.yml
docs-submission-details.txt		docs-submission-details.txt
package-lock.json		package-lock.json
package.json		package.json

Navigation Menu

Uh oh!

Repository files navigation

GuardAgentAI

One platform, two product surfaces

The problem

What we do differently

The product, in five surfaces

Pay-per-inference API (Nanopayments) - verify it yourself

Circle products used on Arc

How we map to the Build on Arc tracks

Demo path (what a judge sees)

Full product demo (4:24, narrated) - watch it

Nanopayments demo (30 sec, no login required)

Stack

Local dev

Architecture

Agentic Economy flow

Nanopayments flow (pay-per-inference)

Guardian policy engine

Hackathon context

Circle Product Feedback

About

Releases

Packages

Contributors

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

GuardAgentAI

One platform, two product surfaces

The problem

What we do differently

The product, in five surfaces

Pay-per-inference API (Nanopayments) - verify it yourself

Circle products used on Arc

How we map to the Build on Arc tracks

Demo path (what a judge sees)

Full product demo (4:24, narrated) - watch it

Nanopayments demo (30 sec, no login required)

Stack

Local dev

Architecture

Agentic Economy flow

Nanopayments flow (pay-per-inference)

Guardian policy engine

Hackathon context

Circle Product Feedback

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages