# centre-for-dpi/verifiably architecture

> Architecture diagram of the GitHub repository centre-for-dpi/verifiably, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/centre-for-dpi/verifiably
- Repository: https://github.com/centre-for-dpi/verifiably

## Overview

Verifiably is a backend-agnostic Go/HTMX hub for issuing, holding, and verifying verifiable credentials across multiple DPG stacks. A user enters through the web application, selects a role, signs in when required, then uses issuer, holder, or verifier flows; configured adapters mediate backend operations. The README documents schema building, delegation, federation, status-list revocation, and translation as additional capabilities. Some subsystem wiring is documented rather than visible in the excerpts, so those links cite the README; unsampled implementation details are not inferred.

Main entry points: [`verifiably-go/internal/handlers/handlers.go`](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/handlers/handlers.go) (Web handlers), [`verifiably-go/cmd/server/main.go`](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/cmd/server/main.go) (HTTP server), [`verifiably-go/internal/handlers/session.go`](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/handlers/session.go) (User sessions), [`verifiably-go/internal/adapters/registry/registry.go`](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/registry/registry.go) (Backend registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_server["HTTP server<br/>[main.go]"]
  node_routes["Web handlers<br/>[handlers.go]"]
  node_sessions["User sessions<br/>[session.go]"]
end

subgraph group_credential["Credential workflows"]
  node_adapter["Adapter interface<br/>[adapter.go]"]
  node_schema["Schema builder<br/>[authcode.go]"]
  node_delegation["Delegation<br/>[extract.go]"]
end

subgraph group_integrations["Identity and integrations"]
  node_auth["OIDC sign-in<br/>[auth.go]"]
  node_registry["Backend registry<br/>[registry.go]"]
  node_walt["walt.id adapter<br/>[wallet.go]"]
  node_injiverify["Inji Verify<br/>[adapter.go]"]
  node_httpx["HTTP client<br/>[client.go]"]
  node_translate["Translation<br/>[client.go]"]
end

subgraph group_state["State and trust"]
  node_status["Credential status<br/>[store.go]"]
  node_statuscache["Status cache<br/>[fetcher.go]"]
  node_pg[("Postgres<br/>[sessions.go]")]
  node_redis[("Redis sessions<br/>[sessions.go]")]
end

node_user(("User"))
node_vendor["DPG services"]
node_translator["LibreTranslate"]

node_user -->|"uses"| node_server
node_server -->|"routes requests"| node_routes
node_routes -->|"uses sessions"| node_sessions
node_routes -->|"supports sign-in"| node_auth
node_routes -->|"runs credential flows"| node_adapter
node_server -->|"configures backends"| node_registry
node_registry -->|"dispatches to"| node_walt
node_registry -->|"dispatches to"| node_injiverify
node_walt -->|"sends requests"| node_httpx
node_injiverify -->|"sends requests"| node_httpx
node_walt -->|"calls wallet APIs"| node_vendor
node_injiverify -->|"calls verifier APIs"| node_vendor
node_routes -->|"offers schema creation"| node_schema
node_routes -->|"supports delegation"| node_delegation
node_routes -->|"handles revocation"| node_status
node_statuscache -.->|"fetches status data"| node_status
node_sessions -->|"persists sessions"| node_pg
node_sessions -->|"can use Redis"| node_redis
node_server -->|"configures translation"| node_translate
node_translate -->|"uses client"| node_httpx
node_translate -->|"translates text"| node_translator

click node_server "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/cmd/server/main.go"
click node_routes "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/handlers/handlers.go"
click node_sessions "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/handlers/session.go"
click node_auth "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/cmd/server/auth.go"
click node_adapter "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/backend/adapter.go"
click node_registry "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/registry/registry.go"
click node_walt "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/waltid/wallet.go"
click node_injiverify "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/injiverify/adapter.go"
click node_schema "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/injicertify/authcode.go"
click node_delegation "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/delegation/extract.go"
click node_status "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/statuslist/store.go"
click node_statuscache "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/statuslistcache/fetcher.go"
click node_pg "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/storage/pg/sessions.go"
click node_redis "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/storage/redis/sessions.go"
click node_httpx "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/httpx/client.go"
click node_translate "https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/libretranslate/client.go"

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_server,node_routes,node_sessions,node_user toneBlue
class node_adapter,node_schema,node_delegation toneAmber
class node_auth,node_registry,node_walt,node_injiverify,node_httpx,node_translate toneMint
class node_status,node_statuscache,node_pg,node_redis toneRose
class node_vendor,node_translator toneIndigo
```

## Components

### Web application

- [HTTP server](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/cmd/server/main.go): `verifiably-go/cmd/server/main.go`
- [Web handlers](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/handlers/handlers.go): `verifiably-go/internal/handlers/handlers.go`
- [User sessions](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/handlers/session.go): `verifiably-go/internal/handlers/session.go`

### Credential workflows

- [Adapter interface](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/backend/adapter.go): `verifiably-go/backend/adapter.go`
- [Schema builder](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/injicertify/authcode.go): `verifiably-go/internal/adapters/injicertify/authcode.go`
- [Delegation](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/delegation/extract.go): `verifiably-go/internal/delegation/extract.go`

### Identity and integrations

- [OIDC sign-in](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/cmd/server/auth.go): `verifiably-go/cmd/server/auth.go`
- [Backend registry](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/registry/registry.go): `verifiably-go/internal/adapters/registry/registry.go`
- [walt.id adapter](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/waltid/wallet.go): `verifiably-go/internal/adapters/waltid/wallet.go`
- [Inji Verify](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/injiverify/adapter.go): `verifiably-go/internal/adapters/injiverify/adapter.go`
- [HTTP client](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/httpx/client.go): `verifiably-go/internal/httpx/client.go`
- [Translation](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/adapters/libretranslate/client.go): `verifiably-go/internal/adapters/libretranslate/client.go`

### State and trust

- [Credential status](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/statuslist/store.go): `verifiably-go/internal/statuslist/store.go`
- [Status cache](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/statuslistcache/fetcher.go): `verifiably-go/internal/statuslistcache/fetcher.go`
- [Postgres](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/storage/pg/sessions.go): `verifiably-go/internal/storage/pg/sessions.go`
- [Redis sessions](https://github.com/centre-for-dpi/verifiably/blob/main/verifiably-go/internal/storage/redis/sessions.go): `verifiably-go/internal/storage/redis/sessions.go`

### Other components

- **User**
- **DPG services**
- **LibreTranslate**

## Connections

- User → HTTP server: uses (evidence: `README.md`)
- HTTP server → Web handlers: routes requests (evidence: `verifiably-go/cmd/server/main.go`)
- Web handlers → User sessions: uses sessions (evidence: `verifiably-go/internal/handlers/handlers.go`)
- Web handlers → OIDC sign-in: supports sign-in (evidence: `README.md`)
- Web handlers → Adapter interface: runs credential flows (evidence: `verifiably-go/internal/handlers/handlers.go`)
- HTTP server → Backend registry: configures backends
- Backend registry → walt.id adapter: dispatches to (evidence: `README.md`)
- Backend registry → Inji Verify: dispatches to (evidence: `README.md`)
- walt.id adapter → HTTP client: sends requests (evidence: `verifiably-go/internal/adapters/waltid/wallet.go`)
- Inji Verify → HTTP client: sends requests (evidence: `verifiably-go/internal/adapters/injiverify/adapter.go`)
- walt.id adapter → DPG services: calls wallet APIs (evidence: `README.md`)
- Inji Verify → DPG services: calls verifier APIs (evidence: `README.md`)
- Web handlers → Schema builder: offers schema creation (evidence: `README.md`)
- Web handlers → Delegation: supports delegation (evidence: `verifiably-go/internal/handlers/handlers.go`)
- Web handlers → Credential status: handles revocation (evidence: `verifiably-go/internal/handlers/handlers.go`)
- Status cache → Credential status: fetches status data
- User sessions → Postgres: persists sessions (evidence: `verifiably-go/internal/storage/pg/sessions.go`)
- User sessions → Redis sessions: can use Redis (evidence: `verifiably-go/internal/storage/redis/sessions.go`)
- HTTP server → Translation: configures translation (evidence: `verifiably-go/cmd/server/main.go`)
- Translation → HTTP client: uses client (evidence: `verifiably-go/internal/adapters/libretranslate/client.go`)
- Translation → LibreTranslate: translates text (evidence: `verifiably-go/internal/adapters/libretranslate/client.go`)
