# blockful/anticapture architecture

> Architecture diagram of the GitHub repository blockful/anticapture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blockful/anticapture
- Repository: https://github.com/blockful/anticapture

## Overview

Anticapture is a DAO governance-security platform. A community member uses the Dashboard to explore governance activity, token distribution, resilience, and attack profitability; the Dashboard’s data is served through Gateful and DAO APIs, with indexed on-chain and off-chain activity supporting analytics. The repository also includes address enrichment, authentication and user services, a relayer, and an MCP client. Several connections are documented at product level, but unsampled runtime wiring is not assumed; dashed, uncited edges indicate likely integrations that the excerpts do not verify.

Main entry points: [`apps/gateful/src/proxy/route.ts`](https://github.com/blockful/anticapture/blob/main/apps/gateful/src/proxy/route.ts) (DAO API gateway), [`apps/api/src/controllers/governance-activity/controller.ts`](https://github.com/blockful/anticapture/blob/main/apps/api/src/controllers/governance-activity/controller.ts) (Governance API), [`apps/dashboard/app/[daoId]/(main)/page.tsx`](https://github.com/blockful/anticapture/blob/main/apps/dashboard/app/%5BdaoId%5D/(main)/page.tsx) (DAO analytics dashboard), [`apps/api/src/services/revenue/dune-client.ts`](https://github.com/blockful/anticapture/blob/main/apps/api/src/services/revenue/dune-client.ts) (Revenue analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Dashboard experience"]
  node_dashboard["DAO analytics dashboard<br/>[page.tsx]"]
  node_attack["Attack profitability"]
  node_proposal["Proposal creation"]
  node_api_keys_ui["API key manager<br/>[ApiKeysManager.tsx]"]
end

subgraph group_data["Governance data and API"]
  node_api["Governance API<br/>[controller.ts]"]
  node_dao_clients["DAO chain clients<br/>[index.ts]"]
  node_revenue["Revenue analytics<br/>[dune-client.ts]"]
  node_treasury["Treasury analytics"]
  node_revenue_cache[("Revenue cache<br/>[cache.ts]")]
  node_treasury_providers["Treasury providers"]
  node_onchain_indexer["On-chain indexer<br/>[voting.ts]"]
  node_offchain_indexer["Off-chain indexer<br/>[indexer.ts]"]
  node_api_db[("API database<br/>[schema.ts]")]
end

subgraph group_gateway["Gateway and enrichment"]
  node_gateful["DAO API gateway<br/>[route.ts]"]
  node_dao_resolver["DAO discovery<br/>[route.ts]"]
  node_delegation_resolver["Delegation aggregation<br/>[route.ts]"]
  node_breaker["Circuit breakers"]
  node_enrichment["Address enrichment<br/>[enrichment.ts]"]
end

subgraph group_identity["Identity and access"]
  node_authful["API token service<br/>[app.ts]"]
  node_user_api["User API<br/>[app.ts]"]
  node_auth_db[("Authful database<br/>[schema.ts]")]
end

subgraph group_operations["Governance operations"]
  node_relayer["Proposal relayer<br/>[relay-webhook.ts]"]
  node_mcp["MCP client<br/>[client.ts]"]
end

node_community(("DAO community"))
node_external_data{{"External data providers"}}

node_community -->|"explores"| node_dashboard
node_dashboard -->|"assesses attacks"| node_attack
node_dashboard -.->|"requests DAO data"| node_gateful
node_gateful -.->|"routes DAO requests"| node_api
node_gateful -->|"guards proxy calls"| node_breaker
node_dao_resolver -.->|"provides DAO routes"| node_gateful
node_delegation_resolver -.->|"provides delegation route"| node_gateful
node_delegation_resolver -.->|"aggregates DAO data"| node_external_data
node_api -.->|"reads indexed activity"| node_onchain_indexer
node_api -.->|"queries data"| node_api_db
node_api -.->|"uses chain clients"| node_dao_clients
node_api -.->|"serves revenue analytics"| node_revenue
node_revenue -->|"caches results"| node_revenue_cache
node_revenue -.->|"fetches Dune data"| node_external_data
node_treasury -->|"selects providers"| node_treasury_providers
node_treasury_providers -.->|"fetches treasury data"| node_external_data
node_onchain_indexer -.->|"stores indexed events"| node_api_db
node_offchain_indexer -.->|"stores indexed proposals"| node_api_db
node_community -->|"drafts proposals"| node_proposal
node_community -.->|"manages API access"| node_api_keys_ui
node_api_keys_ui -.->|"uses account services"| node_user_api
node_user_api -.->|"provisions API keys"| node_authful
node_authful -.->|"stores tokens"| node_auth_db
node_mcp -->|"consumes API resources"| node_gateful
node_relayer -.->|"executes proposal actions"| node_external_data
node_enrichment -.->|"queries address sources"| node_external_data

click node_dashboard "https://github.com/blockful/anticapture/blob/main/apps/dashboard/app/%5BdaoId%5D/(main)/page.tsx"
click node_attack "https://github.com/blockful/anticapture/blob/main/apps/dashboard/features/attack-profitability/AttackProfitabilitySection.tsx"
click node_proposal "https://github.com/blockful/anticapture/blob/main/apps/dashboard/features/create-proposal/components/ProposalCreationForm.tsx"
click node_api_keys_ui "https://github.com/blockful/anticapture/blob/main/apps/dashboard/features/api-keys/ApiKeysManager.tsx"
click node_gateful "https://github.com/blockful/anticapture/blob/main/apps/gateful/src/proxy/route.ts"
click node_dao_resolver "https://github.com/blockful/anticapture/blob/main/apps/gateful/src/resolvers/daos/route.ts"
click node_delegation_resolver "https://github.com/blockful/anticapture/blob/main/apps/gateful/src/resolvers/delegation/route.ts"
click node_breaker "https://github.com/blockful/anticapture/blob/main/apps/gateful/src/shared/circuit-breaker-registry.ts"
click node_enrichment "https://github.com/blockful/anticapture/blob/main/apps/address-enrichment/src/services/enrichment.ts"
click node_api "https://github.com/blockful/anticapture/blob/main/apps/api/src/controllers/governance-activity/controller.ts"
click node_dao_clients "https://github.com/blockful/anticapture/blob/main/apps/api/src/clients/index.ts"
click node_revenue "https://github.com/blockful/anticapture/blob/main/apps/api/src/services/revenue/dune-client.ts"
click node_treasury "https://github.com/blockful/anticapture/blob/main/apps/api/src/services/treasury/treasury.service.ts"
click node_revenue_cache "https://github.com/blockful/anticapture/blob/main/apps/api/src/services/revenue/cache.ts"
click node_treasury_providers "https://github.com/blockful/anticapture/tree/main/apps/api/src/services/treasury/providers"
click node_onchain_indexer "https://github.com/blockful/anticapture/blob/main/apps/indexer/src/eventHandlers/voting.ts"
click node_offchain_indexer "https://github.com/blockful/anticapture/blob/main/apps/offchain-indexer/src/indexer.ts"
click node_api_db "https://github.com/blockful/anticapture/blob/main/apps/api/src/database/schema.ts"
click node_authful "https://github.com/blockful/anticapture/blob/main/apps/authful/src/app.ts"
click node_user_api "https://github.com/blockful/anticapture/blob/main/apps/user-api/src/app.ts"
click node_auth_db "https://github.com/blockful/anticapture/blob/main/apps/authful/src/database/schema.ts"
click node_relayer "https://github.com/blockful/anticapture/blob/main/apps/relayer/src/controllers/relay-webhook.ts"
click node_mcp "https://github.com/blockful/anticapture/blob/main/packages/anticapture-client/src/client.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_attack,node_proposal,node_api_keys_ui toneBlue
class node_api,node_dao_clients,node_revenue,node_treasury,node_revenue_cache,node_treasury_providers,node_onchain_indexer,node_offchain_indexer,node_api_db toneAmber
class node_gateful,node_dao_resolver,node_delegation_resolver,node_breaker,node_enrichment toneMint
class node_authful,node_user_api,node_auth_db toneRose
class node_relayer,node_mcp,node_community,node_external_data toneIndigo
```

## Components

### Dashboard experience

- [DAO analytics dashboard](https://github.com/blockful/anticapture/blob/main/apps/dashboard/app/%5BdaoId%5D/(main)/page.tsx): `apps/dashboard/app/[daoId]/(main)/page.tsx`
- [Attack profitability](https://github.com/blockful/anticapture/blob/main/apps/dashboard/features/attack-profitability/AttackProfitabilitySection.tsx): `apps/dashboard/features/attack-profitability/AttackProfitabilitySection.tsx`
- [Proposal creation](https://github.com/blockful/anticapture/blob/main/apps/dashboard/features/create-proposal/components/ProposalCreationForm.tsx): `apps/dashboard/features/create-proposal/components/ProposalCreationForm.tsx`
- [API key manager](https://github.com/blockful/anticapture/blob/main/apps/dashboard/features/api-keys/ApiKeysManager.tsx): `apps/dashboard/features/api-keys/ApiKeysManager.tsx`

### Governance data and API

- [Governance API](https://github.com/blockful/anticapture/blob/main/apps/api/src/controllers/governance-activity/controller.ts): `apps/api/src/controllers/governance-activity/controller.ts`
- [DAO chain clients](https://github.com/blockful/anticapture/blob/main/apps/api/src/clients/index.ts): `apps/api/src/clients/index.ts`
- [Revenue analytics](https://github.com/blockful/anticapture/blob/main/apps/api/src/services/revenue/dune-client.ts): `apps/api/src/services/revenue/dune-client.ts`
- [Treasury analytics](https://github.com/blockful/anticapture/blob/main/apps/api/src/services/treasury/treasury.service.ts): `apps/api/src/services/treasury/treasury.service.ts`
- [Revenue cache](https://github.com/blockful/anticapture/blob/main/apps/api/src/services/revenue/cache.ts): `apps/api/src/services/revenue/cache.ts`
- [Treasury providers](https://github.com/blockful/anticapture/tree/main/apps/api/src/services/treasury/providers): `apps/api/src/services/treasury/providers`
- [On-chain indexer](https://github.com/blockful/anticapture/blob/main/apps/indexer/src/eventHandlers/voting.ts): `apps/indexer/src/eventHandlers/voting.ts`
- [Off-chain indexer](https://github.com/blockful/anticapture/blob/main/apps/offchain-indexer/src/indexer.ts): `apps/offchain-indexer/src/indexer.ts`
- [API database](https://github.com/blockful/anticapture/blob/main/apps/api/src/database/schema.ts): `apps/api/src/database/schema.ts`

### Gateway and enrichment

- [DAO API gateway](https://github.com/blockful/anticapture/blob/main/apps/gateful/src/proxy/route.ts): `apps/gateful/src/proxy/route.ts`
- [DAO discovery](https://github.com/blockful/anticapture/blob/main/apps/gateful/src/resolvers/daos/route.ts): `apps/gateful/src/resolvers/daos/route.ts`
- [Delegation aggregation](https://github.com/blockful/anticapture/blob/main/apps/gateful/src/resolvers/delegation/route.ts): `apps/gateful/src/resolvers/delegation/route.ts`
- [Circuit breakers](https://github.com/blockful/anticapture/blob/main/apps/gateful/src/shared/circuit-breaker-registry.ts): `apps/gateful/src/shared/circuit-breaker-registry.ts`
- [Address enrichment](https://github.com/blockful/anticapture/blob/main/apps/address-enrichment/src/services/enrichment.ts): `apps/address-enrichment/src/services/enrichment.ts`

### Identity and access

- [API token service](https://github.com/blockful/anticapture/blob/main/apps/authful/src/app.ts): `apps/authful/src/app.ts`
- [User API](https://github.com/blockful/anticapture/blob/main/apps/user-api/src/app.ts): `apps/user-api/src/app.ts`
- [Authful database](https://github.com/blockful/anticapture/blob/main/apps/authful/src/database/schema.ts): `apps/authful/src/database/schema.ts`

### Governance operations

- [Proposal relayer](https://github.com/blockful/anticapture/blob/main/apps/relayer/src/controllers/relay-webhook.ts): `apps/relayer/src/controllers/relay-webhook.ts`
- [MCP client](https://github.com/blockful/anticapture/blob/main/packages/anticapture-client/src/client.ts): `packages/anticapture-client/src/client.ts`

### Other components

- **DAO community**
- **External data providers**

## Connections

- DAO community → DAO analytics dashboard: explores (evidence: `README.md`)
- DAO analytics dashboard → Attack profitability: assesses attacks (evidence: `README.md`)
- DAO analytics dashboard → DAO API gateway: requests DAO data
- DAO API gateway → Governance API: routes DAO requests
- DAO API gateway → Circuit breakers: guards proxy calls (evidence: `apps/gateful/src/proxy/route.ts`)
- DAO discovery → DAO API gateway: provides DAO routes
- Delegation aggregation → DAO API gateway: provides delegation route
- Delegation aggregation → External data providers: aggregates DAO data
- Governance API → On-chain indexer: reads indexed activity
- Governance API → API database: queries data
- Governance API → DAO chain clients: uses chain clients
- Governance API → Revenue analytics: serves revenue analytics
- Revenue analytics → Revenue cache: caches results (evidence: `apps/api/src/services/revenue/dune-client.ts`)
- Revenue analytics → External data providers: fetches Dune data
- Treasury analytics → Treasury providers: selects providers (evidence: `apps/api/src/services/treasury/treasury.service.ts`)
- Treasury providers → External data providers: fetches treasury data
- On-chain indexer → API database: stores indexed events
- Off-chain indexer → API database: stores indexed proposals
- DAO community → Proposal creation: drafts proposals (evidence: `README.md`)
- DAO community → API key manager: manages API access
- API key manager → User API: uses account services
- User API → API token service: provisions API keys
- API token service → Authful database: stores tokens
- MCP client → DAO API gateway: consumes API resources (evidence: `README.md`)
- Proposal relayer → External data providers: executes proposal actions
- Address enrichment → External data providers: queries address sources
