Skip to main content

Walrus Node Architecture

The Walrus node architecture is documented at the role level, not at the private server level.

Public architecture

ComponentResponsibility
Chain workloadRuns the protocol client or service process.
Kubernetes controllerKeeps the workload scheduled, restarted, and observable.
Persistent storageStores chain data or service state according to the chain profile.
Secret deliveryInjects node identity, API credentials, or signer material through runtime secret controllers.
MonitoringEmits node, workload, and chain-family metrics to the FP Validated monitoring stack.
Guard/API surfaceGives operators controlled visibility and response actions without direct server login.

Safety model

Walrus operations prioritize storage service health, checkpoint dependencies, and metrics. Public docs intentionally avoid exact topology, private host paths, node names, and secret paths.

Architecture diagram