# monetarium/monetarium-explorer architecture

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

- Interactive diagram: https://gitdiagram.com/monetarium/monetarium-explorer
- Repository: https://github.com/monetarium/monetarium-explorer

## Overview

Monetarium Explorer serves a multi-coin blockchain explorer: a user requests a page or API result, the Go server routes the request to explorer or API handlers, and those handlers use indexed chain data to respond. The broader runtime also collects node data, tracks mempool and governance information, renders charts, and publishes live updates over WebSockets. PostgreSQL is the persistent backend. The graph reflects documented capabilities and indexed imports; unsampled implementation details are not inferred as direct calls.

Main entry points: [`cmd/dcrdata/main.go`](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/main.go) (dcrdata Server), [`blockdata/blockdata.go`](https://github.com/monetarium/monetarium-explorer/blob/main/blockdata/blockdata.go) (Block Collection), [`db/dcrpg/pgblockchain.go`](https://github.com/monetarium/monetarium-explorer/blob/main/db/dcrpg/pgblockchain.go) (PostgreSQL Backend), [`cmd/dcrdata/public/js/controllers/charts_controller.js`](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/controllers/charts_controller.js) (Charts View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Server Runtime"]
  node_server["dcrdata Server<br/>[main.go]"]
end

subgraph group_data["Chain Data"]
  node_blockdata["Block Collection<br/>[blockdata.go]"]
  node_rpc["Node RPC<br/>[rpcclient.go]"]
  node_pg["PostgreSQL Backend<br/>[pgblockchain.go]"]
  node_cache["Chart Cache<br/>[charts.go]"]
  node_mempool["Mempool Monitor<br/>[collector.go]"]
  node_stake["Ticket Tracking<br/>[stakedb.go]"]
end

subgraph group_features["Explorer Features"]
  node_governance["Governance Data<br/>[tracker.go]"]
end

subgraph group_interfaces["Client Interfaces"]
  node_pages["Explorer Pages<br/>[explorerroutes.go]"]
  node_api["Explorer API<br/>[apiroutes.go]"]
  node_insight["Insight API<br/>[apiroutes.go]"]
  node_pubsub["Live Pub/Sub<br/>[pubsubhub.go]"]
end

subgraph group_frontend["Browser Experience"]
  node_address["Address View"]
  node_charts["Charts View"]
  node_chartdefs["Chart Definitions<br/>[address.js]"]
  node_chartpanel["Chart Rendering<br/>[chart_panel.js]"]
  node_http["HTTP Helper<br/>[http.js]"]
end

node_user(("Explorer User"))
node_node["Monetarium Node"]
node_postgres[("PostgreSQL")]

node_user -->|"requests pages"| node_server
node_server -->|"registers routes"| node_pages
node_server -->|"registers routes"| node_api
node_server -->|"registers routes"| node_insight
node_server -->|"initializes"| node_blockdata
node_server -->|"initializes"| node_pubsub
node_blockdata -.->|"uses RPC"| node_rpc
node_rpc -->|"connects to"| node_node
node_blockdata -.->|"stores chain data"| node_pg
node_pg -->|"persists data"| node_postgres
node_pg -->|"updates charts"| node_cache
node_server -->|"starts monitor"| node_mempool
node_server -->|"initializes"| node_stake
node_server -->|"initializes"| node_governance
node_pages -.->|"queries chain data"| node_pg
node_api -.->|"queries chain data"| node_pg
node_api -->|"checks chart cache"| node_cache
node_insight -->|"broadcasts transactions"| node_blockdata
node_blockdata -->|"publishes blocks"| node_pubsub
node_user -->|"opens address"| node_address
node_address -->|"requests data"| node_http
node_user -.->|"selects charts"| node_charts
node_charts -->|"fetches data"| node_http
node_charts -->|"gets definitions"| node_chartdefs
node_charts -->|"renders charts"| node_chartpanel

click node_server "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/main.go"
click node_blockdata "https://github.com/monetarium/monetarium-explorer/blob/main/blockdata/blockdata.go"
click node_rpc "https://github.com/monetarium/monetarium-explorer/blob/main/rpcutils/rpcclient.go"
click node_pg "https://github.com/monetarium/monetarium-explorer/blob/main/db/dcrpg/pgblockchain.go"
click node_cache "https://github.com/monetarium/monetarium-explorer/blob/main/db/cache/charts.go"
click node_mempool "https://github.com/monetarium/monetarium-explorer/blob/main/mempool/collector.go"
click node_stake "https://github.com/monetarium/monetarium-explorer/blob/main/stakedb/stakedb.go"
click node_governance "https://github.com/monetarium/monetarium-explorer/blob/main/gov/agendas/tracker.go"
click node_pages "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/internal/explorer/explorerroutes.go"
click node_api "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/internal/api/apiroutes.go"
click node_insight "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/internal/api/insight/apiroutes.go"
click node_pubsub "https://github.com/monetarium/monetarium-explorer/blob/main/pubsub/pubsubhub.go"
click node_address "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/controllers/address_controller.js"
click node_charts "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/controllers/charts_controller.js"
click node_chartdefs "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/charts/definitions/address.js"
click node_chartpanel "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/helpers/chart_panel.js"
click node_http "https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/helpers/http.js"

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_user toneBlue
class node_blockdata,node_rpc,node_pg,node_cache,node_mempool,node_stake,node_postgres toneAmber
class node_governance toneMint
class node_pages,node_api,node_insight,node_pubsub toneRose
class node_address,node_charts,node_chartdefs,node_chartpanel,node_http,node_node toneIndigo
```

## Components

### Server Runtime

- [dcrdata Server](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/main.go): `cmd/dcrdata/main.go`

### Chain Data

- [Block Collection](https://github.com/monetarium/monetarium-explorer/blob/main/blockdata/blockdata.go): `blockdata/blockdata.go`
- [Node RPC](https://github.com/monetarium/monetarium-explorer/blob/main/rpcutils/rpcclient.go): `rpcutils/rpcclient.go`
- [PostgreSQL Backend](https://github.com/monetarium/monetarium-explorer/blob/main/db/dcrpg/pgblockchain.go): `db/dcrpg/pgblockchain.go`
- [Chart Cache](https://github.com/monetarium/monetarium-explorer/blob/main/db/cache/charts.go): `db/cache/charts.go`
- [Mempool Monitor](https://github.com/monetarium/monetarium-explorer/blob/main/mempool/collector.go): `mempool/collector.go`
- [Ticket Tracking](https://github.com/monetarium/monetarium-explorer/blob/main/stakedb/stakedb.go): `stakedb/stakedb.go`

### Explorer Features

- [Governance Data](https://github.com/monetarium/monetarium-explorer/blob/main/gov/agendas/tracker.go): `gov/agendas/tracker.go`

### Client Interfaces

- [Explorer Pages](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/internal/explorer/explorerroutes.go): `cmd/dcrdata/internal/explorer/explorerroutes.go`
- [Explorer API](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/internal/api/apiroutes.go): `cmd/dcrdata/internal/api/apiroutes.go`
- [Insight API](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/internal/api/insight/apiroutes.go): `cmd/dcrdata/internal/api/insight/apiroutes.go`
- [Live Pub/Sub](https://github.com/monetarium/monetarium-explorer/blob/main/pubsub/pubsubhub.go): `pubsub/pubsubhub.go`

### Browser Experience

- [Address View](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/controllers/address_controller.js): `cmd/dcrdata/public/js/controllers/address_controller.js`
- [Charts View](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/controllers/charts_controller.js): `cmd/dcrdata/public/js/controllers/charts_controller.js`
- [Chart Definitions](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/charts/definitions/address.js): `cmd/dcrdata/public/js/charts/definitions/address.js`
- [Chart Rendering](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/helpers/chart_panel.js): `cmd/dcrdata/public/js/helpers/chart_panel.js`
- [HTTP Helper](https://github.com/monetarium/monetarium-explorer/blob/main/cmd/dcrdata/public/js/helpers/http.js): `cmd/dcrdata/public/js/helpers/http.js`

### Other components

- **Explorer User**
- **Monetarium Node**
- **PostgreSQL**

## Connections

- Explorer User → dcrdata Server: requests pages
- dcrdata Server → Explorer Pages: registers routes (evidence: `cmd/dcrdata/main.go`)
- dcrdata Server → Explorer API: registers routes (evidence: `cmd/dcrdata/main.go`)
- dcrdata Server → Insight API: registers routes (evidence: `cmd/dcrdata/main.go`)
- dcrdata Server → Block Collection: initializes (evidence: `cmd/dcrdata/main.go`)
- dcrdata Server → Live Pub/Sub: initializes (evidence: `cmd/dcrdata/main.go`)
- Block Collection → Node RPC: uses RPC
- Node RPC → Monetarium Node: connects to
- Block Collection → PostgreSQL Backend: stores chain data
- PostgreSQL Backend → PostgreSQL: persists data
- PostgreSQL Backend → Chart Cache: updates charts (evidence: `db/dcrpg/pgblockchain.go`)
- dcrdata Server → Mempool Monitor: starts monitor (evidence: `cmd/dcrdata/main.go`)
- dcrdata Server → Ticket Tracking: initializes (evidence: `cmd/dcrdata/main.go`)
- dcrdata Server → Governance Data: initializes (evidence: `cmd/dcrdata/main.go`)
- Explorer Pages → PostgreSQL Backend: queries chain data
- Explorer API → PostgreSQL Backend: queries chain data
- Explorer API → Chart Cache: checks chart cache (evidence: `cmd/dcrdata/internal/api/apiroutes.go`)
- Insight API → Block Collection: broadcasts transactions (evidence: `cmd/dcrdata/internal/api/insight/apiroutes.go`)
- Block Collection → Live Pub/Sub: publishes blocks (evidence: `pubsub/pubsubhub.go`)
- Explorer User → Address View: opens address (evidence: `cmd/dcrdata/public/js/controllers/address_controller.js`)
- Address View → HTTP Helper: requests data (evidence: `cmd/dcrdata/public/js/controllers/address_controller.js`)
- Explorer User → Charts View: selects charts
- Charts View → HTTP Helper: fetches data (evidence: `cmd/dcrdata/public/js/controllers/charts_controller.js`)
- Charts View → Chart Definitions: gets definitions (evidence: `cmd/dcrdata/public/js/controllers/charts_controller.js`)
- Charts View → Chart Rendering: renders charts (evidence: `cmd/dcrdata/public/js/controllers/charts_controller.js`)
