# inkonchain/node architecture

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

- Interactive diagram: https://gitdiagram.com/inkonchain/node
- Repository: https://github.com/inkonchain/node

## Overview

Ink Node is a Docker Compose stack for operating an Ink OP Stack node. The operator selects a network and node type, supplies L1 endpoints, then starts the stack; initialization restores an op-reth snapshot and prepares shared state before the execution client and rollup node run. A healthcheck compares node progress with a reference RPC, while Prometheus and Grafana expose monitoring. The graph follows README-documented relationships; source excerpts were unavailable, so implementation-level calls and undocumented links are omitted.

Main entry points: [`envs/ink-mainnet/op-node.env`](https://github.com/inkonchain/node/blob/main/envs/ink-mainnet/op-node.env) (op-node rollup), [`envs/ink-mainnet/op-reth.env`](https://github.com/inkonchain/node/blob/main/envs/ink-mainnet/op-reth.env) (op-reth execution), [`docker-compose.yml`](https://github.com/inkonchain/node/blob/main/docker-compose.yml) (Compose stack), [`scripts/init-bedrock.sh`](https://github.com/inkonchain/node/blob/main/scripts/init-bedrock.sh) (Bedrock init)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operation["Node operation"]
  node_compose["Compose stack<br/>[docker-compose.yml]"]
  node_init["Bedrock init<br/>[init-bedrock.sh]"]
  node_snapshot["op-reth snapshot"]
  node_reth["op-reth execution<br/>[op-reth.env]"]
  node_node["op-node rollup<br/>[op-node.env]"]
end

subgraph group_configuration["Network configuration"]
  node_network["Network settings"]
  node_sepolia["Sepolia settings"]
  node_envtemplate["Environment template<br/>[.env.example]"]
end

subgraph group_monitoring["Health and monitoring"]
  node_health["Healthcheck<br/>[healthcheck.env]"]
  node_prometheus[("Prometheus<br/>[prometheus.yml]")]
  node_grafana["Grafana dashboard"]
end

node_operator(("Node operator"))
node_l1rpc["L1 execution RPC"]
node_beacon["L1 beacon API"]
node_reference["Reference RPC"]
node_operatorview(("Dashboard user"))

node_operator -->|"configures"| node_envtemplate
node_operator -->|"starts"| node_compose
node_compose -->|"runs once"| node_init
node_init -->|"restores"| node_snapshot
node_compose -->|"starts"| node_reth
node_compose -->|"starts"| node_node
node_init -->|"prepares shared state"| node_reth
node_init -->|"prepares shared state"| node_node
node_network -->|"sets network defaults"| node_node
node_network -->|"sets network config"| node_reth
node_sepolia -->|"sets network defaults"| node_node
node_sepolia -->|"sets network config"| node_reth
node_operator -->|"provides endpoint"| node_l1rpc
node_operator -->|"provides endpoint"| node_beacon
node_node -->|"derives from"| node_l1rpc
node_node -->|"uses"| node_beacon
node_health -->|"compares against"| node_reference
node_health -->|"checks height"| node_reth
node_health -->|"exposes metrics to"| node_prometheus
node_prometheus -->|"supplies metrics to"| node_grafana
node_operatorview -->|"views dashboard"| node_grafana

click node_compose "https://github.com/inkonchain/node/blob/main/docker-compose.yml"
click node_init "https://github.com/inkonchain/node/blob/main/scripts/init-bedrock.sh"
click node_reth "https://github.com/inkonchain/node/blob/main/envs/ink-mainnet/op-reth.env"
click node_node "https://github.com/inkonchain/node/blob/main/envs/ink-mainnet/op-node.env"
click node_network "https://github.com/inkonchain/node/tree/main/envs/ink-mainnet"
click node_sepolia "https://github.com/inkonchain/node/tree/main/envs/ink-sepolia"
click node_envtemplate "https://github.com/inkonchain/node/blob/main/.env.example"
click node_health "https://github.com/inkonchain/node/blob/main/envs/common/healthcheck.env"
click node_prometheus "https://github.com/inkonchain/node/blob/main/docker/prometheus/prometheus.yml"
click node_grafana "https://github.com/inkonchain/node/blob/main/docker/grafana/dashboards/simple_node_dashboard.json"

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_compose,node_init,node_snapshot,node_reth,node_node,node_operatorview toneBlue
class node_network,node_sepolia,node_envtemplate toneAmber
class node_health,node_prometheus,node_grafana,node_beacon toneMint
class node_operator,node_l1rpc,node_reference toneIndigo
```

## Components

### Node operation

- [Compose stack](https://github.com/inkonchain/node/blob/main/docker-compose.yml): `docker-compose.yml`
- [Bedrock init](https://github.com/inkonchain/node/blob/main/scripts/init-bedrock.sh): `scripts/init-bedrock.sh`
- **op-reth snapshot**
- [op-reth execution](https://github.com/inkonchain/node/blob/main/envs/ink-mainnet/op-reth.env): `envs/ink-mainnet/op-reth.env`
- [op-node rollup](https://github.com/inkonchain/node/blob/main/envs/ink-mainnet/op-node.env): `envs/ink-mainnet/op-node.env`

### Network configuration

- [Network settings](https://github.com/inkonchain/node/tree/main/envs/ink-mainnet): `envs/ink-mainnet`
- [Sepolia settings](https://github.com/inkonchain/node/tree/main/envs/ink-sepolia): `envs/ink-sepolia`
- [Environment template](https://github.com/inkonchain/node/blob/main/.env.example): `.env.example`

### Health and monitoring

- [Healthcheck](https://github.com/inkonchain/node/blob/main/envs/common/healthcheck.env): `envs/common/healthcheck.env`
- [Prometheus](https://github.com/inkonchain/node/blob/main/docker/prometheus/prometheus.yml): `docker/prometheus/prometheus.yml`
- [Grafana dashboard](https://github.com/inkonchain/node/blob/main/docker/grafana/dashboards/simple_node_dashboard.json): `docker/grafana/dashboards/simple_node_dashboard.json`

### Other components

- **Node operator**
- **L1 execution RPC**
- **L1 beacon API**
- **Reference RPC**
- **Dashboard user**

## Connections

- Node operator → Environment template: configures (evidence: `README.md`)
- Node operator → Compose stack: starts (evidence: `README.md`)
- Compose stack → Bedrock init: runs once (evidence: `README.md`)
- Bedrock init → op-reth snapshot: restores (evidence: `README.md`)
- Compose stack → op-reth execution: starts (evidence: `README.md`)
- Compose stack → op-node rollup: starts (evidence: `README.md`)
- Bedrock init → op-reth execution: prepares shared state (evidence: `README.md`)
- Bedrock init → op-node rollup: prepares shared state (evidence: `README.md`)
- Network settings → op-node rollup: sets network defaults (evidence: `README.md`)
- Network settings → op-reth execution: sets network config (evidence: `README.md`)
- Sepolia settings → op-node rollup: sets network defaults (evidence: `README.md`)
- Sepolia settings → op-reth execution: sets network config (evidence: `README.md`)
- Node operator → L1 execution RPC: provides endpoint (evidence: `README.md`)
- Node operator → L1 beacon API: provides endpoint (evidence: `README.md`)
- op-node rollup → L1 execution RPC: derives from (evidence: `README.md`)
- op-node rollup → L1 beacon API: uses (evidence: `README.md`)
- Healthcheck → Reference RPC: compares against (evidence: `README.md`)
- Healthcheck → op-reth execution: checks height (evidence: `README.md`)
- Healthcheck → Prometheus: exposes metrics to (evidence: `README.md`)
- Prometheus → Grafana dashboard: supplies metrics to (evidence: `README.md`)
- Dashboard user → Grafana dashboard: views dashboard (evidence: `README.md`)
