Skip to main content
HoodCloud is a fully managed blockchain node infrastructure service. It provisions, monitors, and maintains non-validator blockchain nodes without requiring users to manage infrastructure, software upgrades, or monitoring.

Architecture

Architecture Overview

High-level system architecture, technology stack, and security boundaries.

Workflows & Lifecycle

Request lifecycle, provisioning flow, and Temporal workflow patterns.

Domain Model

Core domain objects, state machines, business rules, and database schema.

Health & Incidents

Health evaluation pipeline, incident management, and notification dispatch.

Upgrade Rollout

Upgrade rollout system: manifests, strategies, Temporal workflows, and rollback tiers.

Extending HoodCloud

Add new chains, providers, wallet types, and notification channels.

Operations

Deployment & Operations

Local development setup, day-to-day operations, and single-server staging.

Production Deployment

Two-server production deployment for the full HoodCloud stack.

Environment Variables

Complete configuration reference for all services.

Vault Integration

HashiCorp Vault setup for secrets management.

Clerk Authentication

Configure Clerk as an external authentication provider.

Developer Guide

How to read the codebase, debug, and run tests.