Files
nchain/api/v1alpha1/groupversion_info.go
zeekay 6de27ba73b feat: nchain — composable blockchain node infrastructure operator
7 CRDs (nchain.hanzo.ai/v1alpha1):
  - NodeCluster: protocol-agnostic blockchain node cluster
  - Chain: blockchain/subnet/L2 definition
  - Indexer: blockchain data indexer
  - Explorer: block explorer UI+API
  - Bridge: cross-chain bridge
  - Gateway: RPC/API gateway with routing + rate limiting
  - Network: top-level composer (creates all child CRDs)

Protocol driver architecture:
  - LuxDriver: full luxd flag generation, snow consensus, staking keys,
    snapshot restore, chain tracking, startup scripting (487 lines)
  - EthereumDriver: reth command generation, standard EVM ports
  - GenericDriver: passthrough for any containerized node

Key design principles:
  - Composable: each CRD stands alone or composes via Network
  - Orthogonal: validators, indexers, explorers, bridges, gateways
    are independent concerns with independent CRDs
  - Complete: covers the full lifecycle from bootstrap to production
  - Protocol-agnostic: driver pattern isolates blockchain-specific logic
  - Do everything exactly once: one way to manage any blockchain

Replaces both HanzoNetwork (hanzo-operator) and LuxNetwork (lux-operator)
with a unified, deeper, protocol-agnostic alternative.

6,215 lines Go | go build + go vet clean
2026-03-03 06:43:22 -08:00

21 lines
684 B
Go

// Package v1alpha1 contains API Schema definitions for the nchain v1alpha1 API group.
// +kubebuilder:object:generate=true
// +groupName=nchain.hanzo.ai
package v1alpha1
import (
"k8s.io/apimachinery/pkg/runtime/schema"
"sigs.k8s.io/controller-runtime/pkg/scheme"
)
var (
// GroupVersion is group version used to register these objects.
GroupVersion = schema.GroupVersion{Group: "nchain.hanzo.ai", Version: "v1alpha1"}
// SchemeBuilder is used to add go types to the GroupVersionResource scheme.
SchemeBuilder = &scheme.Builder{GroupVersion: GroupVersion}
// AddToScheme adds the types in this group-version to the given scheme.
AddToScheme = SchemeBuilder.AddToScheme
)