How qwirlex/aegis-croo works
Aegis is a paid smart-contract auditing agent: a buyer submits a contract through CROO, the provider accepts and processes the order, the engine resolves source and analyzes it, and the provider delivers a report whose hash is committed on-chain. The engine also exposes asynchronous audit jobs and quick scans; the web app renders reports and supports short links. The graph combines README-documented product flows with sampled code and SOURCE INDEX references; unsampled internals are represented only where documented or indexed.
Main entry points: deep_audit.py Deep audit · app.py Audit API · listener.ts CAP event listener · audit.py Single-pass audit
Components 27
Audit engine
- Audit API
engine/aegis_engine/app.py - Single-pass audit
engine/aegis_engine/audit.py - Source resolver
engine/aegis_engine/source.py - Chain catalog
engine/aegis_engine/chains.py - Slither analysis
engine/aegis_engine/static_analysis.py - Deep audit
engine/aegis_engine/deep_audit.py - Contract inventory
engine/aegis_engine/inventory.py - Focused LLM lenses
engine/aegis_engine/lenses.py - LLM reasoning
engine/aegis_engine/llm.py - Finding merge
engine/aegis_engine/merge.py - Finding refutation
engine/aegis_engine/refute.py - Risk scoring
engine/aegis_engine/scoring.py - Report integrity
engine/aegis_engine/integrity.py - Report models
engine/aegis_engine/models.py - Audit job store
engine/aegis_engine/jobs.py
CAP provider
- CAP event listener
provider/src/listener.ts - Engine client
provider/src/engine.ts - Report link builder
provider/src/report-link.ts
Report web app
- Short-link API
web/src/app/api/r/route.ts - Report page
web/src/app/report/ReportPageClient.tsx - Report renderer
web/src/components/ReportView.tsx - Short-link store
web/src/lib/store.ts
External services
- CROO CAP
- Block explorer
- Vertex AI Gemini
- Base chain
Other components
- Buyer / agent
Connections 34
- Buyer / agent → CROO CAP: places order
README.md - CROO CAP → CAP event listener: sends events
README.md - CAP event listener → CROO CAP: accepts and delivers
provider/src/listener.ts - CAP event listener → Engine client: requests audit
provider/src/listener.ts - Engine client → Audit API: posts audit
provider/src/engine.ts - Audit API → Single-pass audit: runs single pass
engine/aegis_engine/app.py - Audit API → Deep audit: runs deep audit
engine/aegis_engine/app.py - Audit API → Audit job store: tracks jobs
engine/aegis_engine/app.py - Audit API → Slither analysis: runs quick scan
engine/aegis_engine/app.py - Single-pass audit → Source resolver: resolves source
engine/aegis_engine/audit.py - Single-pass audit → Slither analysis: analyzes source
engine/aegis_engine/audit.py - Single-pass audit → LLM reasoning: reasons findings
engine/aegis_engine/audit.py - Source resolver → Chain catalog: validates chain
engine/aegis_engine/source.py - Source resolver → Block explorer: fetches verified source
engine/aegis_engine/source.py - Slither analysis → Base chain: analyzes deployed target
- Deep audit → Source resolver: prepares target
engine/aegis_engine/deep_audit.py - Deep audit → Slither analysis: runs static analysis
engine/aegis_engine/deep_audit.py - Deep audit → Contract inventory: builds inventory
engine/aegis_engine/deep_audit.py - Deep audit → Focused LLM lenses: runs focused checks
engine/aegis_engine/deep_audit.py - Deep audit → LLM reasoning: generates summary
engine/aegis_engine/deep_audit.py - Deep audit → Finding merge: merges findings
engine/aegis_engine/deep_audit.py - Deep audit → Finding refutation: refutes findings
engine/aegis_engine/deep_audit.py - Deep audit → Risk scoring: scores risk
engine/aegis_engine/deep_audit.py - Deep audit → Report integrity: signs report
engine/aegis_engine/deep_audit.py - Deep audit → Report models: builds report
engine/aegis_engine/deep_audit.py - Focused LLM lenses → LLM reasoning: requests model output
engine/aegis_engine/lenses.py - LLM reasoning → Vertex AI Gemini: generates content
engine/aegis_engine/llm.py - CAP event listener → Report link builder: builds deliverable
provider/src/listener.ts - CAP event listener → CROO CAP: commits report hash
README.md - Report link builder → Short-link API: stores report
provider/src/report-link.ts - Report page → Report renderer: renders report
web/src/app/report/ReportPageClient.tsx - Buyer / agent → Report page: views report
README.md - Short-link API → Short-link store: stores short link
- Base chain → Buyer / agent: anchors proof
README.md