# deadrop-dev/server architecture

> Architecture diagram of the GitHub repository deadrop-dev/server, 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/deadrop-dev/server
- Repository: https://github.com/deadrop-dev/server

## Overview

Deadrop Server is a self-hostable HTTP service for zero-knowledge secret sharing. A client submits opaque encrypted secrets, and retrieval verifies a key hash before atomically burning the stored record; the reverse Request-a-Secret flow lets a responder attach an encrypted reply for a proof-bearing claimant. Runtime setup loads configuration and selects storage before serving the API. The excerpts show routing, validation, middleware, rate limiting, persistence, and cleanup; some request-flow and SQLite details are only partially excerpted, so the graph avoids unshown internal call sequences.

Main entry points: [`cmd/deadrop-server/main.go`](https://github.com/deadrop-dev/server/blob/master/cmd/deadrop-server/main.go) (Server process), [`internal/server/server.go`](https://github.com/deadrop-dev/server/blob/master/internal/server/server.go) (HTTP routing), [`internal/server/requests.go`](https://github.com/deadrop-dev/server/blob/master/internal/server/requests.go) (Request endpoints), [`internal/storage/storage.go`](https://github.com/deadrop-dev/server/blob/master/internal/storage/storage.go) (Store interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime setup"]
  node_config["Configuration loader<br/>[config.go]"]
  node_server_process["Server process<br/>[main.go]"]
end

subgraph group_api["HTTP API"]
  node_api_router["HTTP routing<br/>[server.go]"]
  node_secret_api["Secret endpoints<br/>[handlers.go]"]
  node_request_api["Request endpoints<br/>[requests.go]"]
  node_validation["Wire validation<br/>[validate.go]"]
end

subgraph group_controls["Request controls"]
  node_middleware["HTTP middleware<br/>[middleware.go]"]
  node_rate_limiter["Rate limiter<br/>[ratelimit.go]"]
  node_metrics["Metrics<br/>[metrics.go]"]
end

subgraph group_persistence["Persistence"]
  node_store_contract["Store interface<br/>[storage.go]"]
  node_sqlite_store["SQLite store<br/>[sqlite.go]"]
  node_memory_store["Memory store<br/>[memory.go]"]
end

node_client(("Deadrop client"))
node_operator["Operator config"]
node_requester(("Secret requester"))
node_responder(("Secret responder"))

node_operator -->|"provides settings"| node_config
node_server_process -->|"loads settings"| node_config
node_server_process -->|"opens by default"| node_sqlite_store
node_server_process -->|"selects optionally"| node_memory_store
node_server_process -->|"constructs and serves"| node_api_router
node_client -->|"sends API requests"| node_api_router
node_requester -->|"creates and claims"| node_request_api
node_responder -->|"checks and fulfills"| node_request_api
node_api_router -->|"routes secret calls"| node_secret_api
node_api_router -->|"routes request calls"| node_request_api
node_api_router -->|"wraps handlers"| node_middleware
node_secret_api -->|"validates payloads"| node_validation
node_request_api -->|"validates payloads"| node_validation
node_secret_api -->|"reads and burns secrets"| node_store_contract
node_request_api -->|"stores and claims requests"| node_store_contract
node_middleware -->|"checks request limits"| node_rate_limiter
node_middleware -->|"records request metrics"| node_metrics
node_store_contract -->|"implemented by"| node_sqlite_store
node_store_contract -->|"implemented by"| node_memory_store
node_server_process -->|"runs expiry cleanup"| node_store_contract

click node_config "https://github.com/deadrop-dev/server/blob/master/internal/config/config.go"
click node_server_process "https://github.com/deadrop-dev/server/blob/master/cmd/deadrop-server/main.go"
click node_api_router "https://github.com/deadrop-dev/server/blob/master/internal/server/server.go"
click node_secret_api "https://github.com/deadrop-dev/server/blob/master/internal/server/handlers.go"
click node_request_api "https://github.com/deadrop-dev/server/blob/master/internal/server/requests.go"
click node_validation "https://github.com/deadrop-dev/server/blob/master/internal/server/validate.go"
click node_middleware "https://github.com/deadrop-dev/server/blob/master/internal/server/middleware.go"
click node_rate_limiter "https://github.com/deadrop-dev/server/blob/master/internal/ratelimit/ratelimit.go"
click node_metrics "https://github.com/deadrop-dev/server/blob/master/internal/server/metrics.go"
click node_store_contract "https://github.com/deadrop-dev/server/blob/master/internal/storage/storage.go"
click node_sqlite_store "https://github.com/deadrop-dev/server/blob/master/internal/storage/sqlite.go"
click node_memory_store "https://github.com/deadrop-dev/server/blob/master/internal/storage/memory.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_config,node_server_process,node_client toneBlue
class node_api_router,node_secret_api,node_request_api,node_validation toneAmber
class node_middleware,node_rate_limiter,node_metrics,node_requester toneMint
class node_store_contract,node_sqlite_store,node_memory_store toneRose
class node_operator,node_responder toneIndigo
```

## Components

### Runtime setup

- [Configuration loader](https://github.com/deadrop-dev/server/blob/master/internal/config/config.go): `internal/config/config.go`
- [Server process](https://github.com/deadrop-dev/server/blob/master/cmd/deadrop-server/main.go): `cmd/deadrop-server/main.go`

### HTTP API

- [HTTP routing](https://github.com/deadrop-dev/server/blob/master/internal/server/server.go): `internal/server/server.go`
- [Secret endpoints](https://github.com/deadrop-dev/server/blob/master/internal/server/handlers.go): `internal/server/handlers.go`
- [Request endpoints](https://github.com/deadrop-dev/server/blob/master/internal/server/requests.go): `internal/server/requests.go`
- [Wire validation](https://github.com/deadrop-dev/server/blob/master/internal/server/validate.go): `internal/server/validate.go`

### Request controls

- [HTTP middleware](https://github.com/deadrop-dev/server/blob/master/internal/server/middleware.go): `internal/server/middleware.go`
- [Rate limiter](https://github.com/deadrop-dev/server/blob/master/internal/ratelimit/ratelimit.go): `internal/ratelimit/ratelimit.go`
- [Metrics](https://github.com/deadrop-dev/server/blob/master/internal/server/metrics.go): `internal/server/metrics.go`

### Persistence

- [Store interface](https://github.com/deadrop-dev/server/blob/master/internal/storage/storage.go): `internal/storage/storage.go`
- [SQLite store](https://github.com/deadrop-dev/server/blob/master/internal/storage/sqlite.go): `internal/storage/sqlite.go`
- [Memory store](https://github.com/deadrop-dev/server/blob/master/internal/storage/memory.go): `internal/storage/memory.go`

### Other components

- **Deadrop client**
- **Operator config**
- **Secret requester**
- **Secret responder**

## Connections

- Operator config → Configuration loader: provides settings (evidence: `internal/config/config.go`)
- Server process → Configuration loader: loads settings (evidence: `cmd/deadrop-server/main.go`)
- Server process → SQLite store: opens by default (evidence: `cmd/deadrop-server/main.go`)
- Server process → Memory store: selects optionally (evidence: `cmd/deadrop-server/main.go`)
- Server process → HTTP routing: constructs and serves (evidence: `cmd/deadrop-server/main.go`)
- Deadrop client → HTTP routing: sends API requests (evidence: `README.md`)
- Secret requester → Request endpoints: creates and claims (evidence: `README.md`)
- Secret responder → Request endpoints: checks and fulfills (evidence: `README.md`)
- HTTP routing → Secret endpoints: routes secret calls (evidence: `internal/server/server.go`)
- HTTP routing → Request endpoints: routes request calls (evidence: `internal/server/server.go`)
- HTTP routing → HTTP middleware: wraps handlers (evidence: `internal/server/server.go`)
- Secret endpoints → Wire validation: validates payloads (evidence: `internal/server/handlers.go`)
- Request endpoints → Wire validation: validates payloads (evidence: `internal/server/requests.go`)
- Secret endpoints → Store interface: reads and burns secrets (evidence: `internal/server/handlers.go`)
- Request endpoints → Store interface: stores and claims requests (evidence: `internal/server/requests.go`)
- HTTP middleware → Rate limiter: checks request limits (evidence: `internal/server/middleware.go`)
- HTTP middleware → Metrics: records request metrics (evidence: `internal/server/middleware.go`)
- Store interface → SQLite store: implemented by (evidence: `internal/storage/storage.go`)
- Store interface → Memory store: implemented by (evidence: `internal/storage/storage.go`)
- Server process → Store interface: runs expiry cleanup
