mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
382 lines
22 KiB
HTML
382 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-nchain</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-nchain.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-nchain">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-nchain.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-nchain</h1><p class="lede">Nchain is a Kubernetes operator for deploying and scaling blockchain nodes.</p><h1>Hanzo Nchain - Composable Blockchain Node Infrastructure Operator</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-hke.md</code>, <code>hanzo/hanzo-platform.md</code>, <code>hanzo/hanzo-cloud.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Nchain is a <strong>Kubernetes operator for deploying and scaling blockchain nodes</strong>. Built with kubebuilder and controller-runtime, it defines custom resources (CRDs) for managing multi-protocol blockchain infrastructure declaratively. Supports Lux, Ethereum, Bitcoin, Cosmos, Solana, and Substrate via a pluggable protocol driver interface.</p>
|
|
<h3>Why Nchain?</h3>
|
|
<ul><li><strong>Multi-protocol</strong> -- Single operator handles Lux, Ethereum, Bitcoin, Cosmos, Solana, Substrate, and generic nodes</li><li><strong>Composable CRDs</strong> -- Network (top-level composer) creates NodeClusters, Chains, Indexers, Explorers, Bridges, and Gateways</li><li><strong>Protocol drivers</strong> -- Pluggable <code>Driver</code> interface generates container commands, env vars, volumes, health checks per chain</li><li><strong>Production features</strong> -- Rolling canary upgrades, seed restore from snapshots, automated snapshot schedules, startup gates, KMS secret sync</li><li><strong>K8s-native</strong> -- Standard kubebuilder patterns, leader election, health/readiness probes, secure metrics</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Language</strong>: Go 1.25</li><li><strong>Framework</strong>: kubebuilder / controller-runtime v0.23</li><li><strong>CRD API</strong>: <code>nchain.hanzo.ai/v1alpha1</code></li><li><strong>Image</strong>: <code>ghcr.io/hanzoai/nchain:latest</code></li><li><strong>Binary</strong>: <code>manager</code> (single binary operator)</li></ul>
|
|
<h2>When to use</h2>
|
|
<ul><li>Deploying blockchain validator/fullnode/archive clusters on Kubernetes</li><li>Managing multi-chain networks (Lux subnets, Ethereum L2s, Cosmos zones)</li><li>Running block explorers, indexers, and API gateways alongside nodes</li><li>Automating chain data snapshots and seed-based bootstrap</li><li>Operating cross-chain bridges under K8s lifecycle management</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Kubernetes cluster</strong> with CRD support (v1.28+)</li><li><strong>controller-gen</strong> for CRD manifest generation</li><li><strong>Go 1.25+</strong> for building from source</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Module | <code>github.com/hanzoai/nchain</code> | | Go version | 1.25 | | API group | <code>nchain.hanzo.ai/v1alpha1</code> | | Image | <code>ghcr.io/hanzoai/nchain:latest</code> | | Default branch | <code>main</code> | | Health probe | <code>:8081/healthz</code> | | Readiness probe | <code>:8081/readyz</code> | | Leader election ID | <code>nchain.hanzo.ai</code> | | Repo | <code>github.com/hanzoai/nchain</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Deploy the operator</h3>
|
|
<pre><code class="lang-bash"># Build and push
|
|
make docker-push IMG=ghcr.io/hanzoai/nchain:latest
|
|
|
|
# Generate CRDs and deploy
|
|
make deploy</code></pre>
|
|
<h3>Create a Lux devnet</h3>
|
|
<pre><code class="lang-yaml">apiVersion: nchain.hanzo.ai/v1alpha1
|
|
kind: NodeCluster
|
|
metadata:
|
|
name: lux-devnet-validators
|
|
namespace: lux-devnet
|
|
spec:
|
|
protocol: lux
|
|
networkID: "3"
|
|
replicas: 5
|
|
role: validator
|
|
image:
|
|
repository: ghcr.io/luxfi/node
|
|
tag: v1.23.23
|
|
ports:
|
|
rpc: 9650
|
|
p2p: 9651
|
|
storage:
|
|
storageClassName: do-block-storage
|
|
size: 50Gi
|
|
resources:
|
|
requests:
|
|
cpu: "1"
|
|
memory: 2Gi
|
|
limits:
|
|
cpu: "2"
|
|
memory: 4Gi
|
|
consensus:
|
|
algorithm: snow
|
|
params:
|
|
sybilProtectionEnabled: false
|
|
allowPrivateIPs: true</code></pre>
|
|
<h3>Create a full Network (composer)</h3>
|
|
<pre><code class="lang-yaml">apiVersion: nchain.hanzo.ai/v1alpha1
|
|
kind: Network
|
|
metadata:
|
|
name: lux-mainnet
|
|
spec:
|
|
protocol: lux
|
|
networkID: "1"
|
|
clusters:
|
|
- name: validators
|
|
spec:
|
|
replicas: 5
|
|
role: validator
|
|
image:
|
|
repository: ghcr.io/luxfi/node
|
|
tag: v1.23.23
|
|
gateways:
|
|
- name: api
|
|
spec:
|
|
replicas: 2
|
|
nodeClusterRef: lux-mainnet-validators
|
|
autoRoutes: true
|
|
ingress:
|
|
enabled: true
|
|
hosts:
|
|
- api.lux.network
|
|
tls: true</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>CRD Hierarchy</h3>
|
|
<pre><code>Network (top-level composer)
|
|
|-- NodeCluster Stateful node pods (validator, fullnode, archive, bootnode, sentry)
|
|
|-- Chain Blockchain/subnet/L2 definitions (genesis, chainID, VMID)
|
|
|-- Indexer Block indexing services
|
|
|-- Explorer Block explorer UIs (Blockscout, etc.)
|
|
|-- Bridge Cross-chain bridge relayers
|
|
|-- Gateway API gateway / RPC load balancer with rate limits
|
|
|-- Cloud Cloud management platform (bootnode API + web UI)</code></pre>
|
|
<h3>Controllers (8 reconcilers)</h3>
|
|
<p>| Controller | CRD | Purpose | |-----------|-----|---------| | <code>NodeClusterReconciler</code> | NodeCluster | Manages StatefulSets for node pods | | <code>ChainReconciler</code> | Chain | Tracks blockchain lifecycle and block height | | <code>IndexerReconciler</code> | Indexer | Deploys and configures indexing services | | <code>ExplorerReconciler</code> | Explorer | Deploys block explorer instances | | <code>BridgeReconciler</code> | Bridge | Manages cross-chain bridge relayers | | <code>GatewayReconciler</code> | Gateway | Deploys API gateway with auto-routing and rate limits | | <code>NetworkReconciler</code> | Network | Top-level composer creating all child resources | | <code>CloudReconciler</code> | Cloud | Cloud management platform deployment |</p>
|
|
<h3>Protocol Drivers</h3>
|
|
<p>Each protocol implements the <code>Driver</code> interface:</p>
|
|
<pre><code class="lang-go">type Driver interface {
|
|
Name() string
|
|
DefaultImage() string
|
|
BuildCommand(spec *NodeClusterSpec) (command, args []string)
|
|
BuildEnv(spec *NodeClusterSpec) []corev1.EnvVar
|
|
HealthEndpoint(spec *NodeClusterSpec) (path string, port int32)
|
|
DefaultPorts() PortConfig
|
|
RecommendedResources(role string) (requests, limits corev1.ResourceList)
|
|
// ... plus volumes, init containers, config maps
|
|
}</code></pre>
|
|
<p>| Protocol | File | Default Image | |----------|------|---------------| | Lux | <code>internal/protocol/lux.go</code> | <code>ghcr.io/luxfi/node</code> | | Ethereum | <code>internal/protocol/ethereum.go</code> | Geth-based | | Bitcoin | <code>internal/protocol/bitcoin.go</code> | Bitcoin Core | | Cosmos | <code>internal/protocol/cosmos.go</code> | Cosmos SDK | | Solana | <code>internal/protocol/solana.go</code> | Solana validator | | Generic | <code>internal/protocol/generic.go</code> | User-specified |</p>
|
|
<h3>NodeCluster Roles</h3>
|
|
<p>| Role | Description | |------|-------------| | <code>validator</code> | Full consensus participation (default) | | <code>fullnode</code> | Validates but doesn't propose blocks | | <code>archive</code> | Full historical state retention | | <code>bootnode</code> | Network bootstrap / peer discovery | | <code>sentry</code> | DDoS protection proxy for validators |</p>
|
|
<h2>Directory structure</h2>
|
|
<pre><code>github.com/hanzoai/nchain/
|
|
Dockerfile # Multi-stage build (distroless)
|
|
Makefile # build, test, manifests, docker-build, deploy
|
|
api/v1alpha1/
|
|
chain_types.go # Chain CRD (blockchain/subnet/L2)
|
|
nodecluster_types.go # NodeCluster CRD (node pod management)
|
|
network_types.go # Network CRD (top-level composer)
|
|
bridge_types.go # Bridge CRD (cross-chain relayer)
|
|
explorer_types.go # Explorer CRD (block explorer)
|
|
gateway_types.go # Gateway CRD (API gateway)
|
|
indexer_types.go # Indexer CRD (block indexing)
|
|
cloud_types.go # Cloud CRD (management platform)
|
|
common_types.go # Shared types (ports, storage, consensus, etc.)
|
|
groupversion_info.go # API group registration
|
|
zz_generated_deepcopy.go # Auto-generated DeepCopy methods
|
|
cmd/
|
|
main.go # Operator entrypoint (registers all 8 controllers)
|
|
config/
|
|
crd/ # Generated CRD YAML manifests
|
|
samples/
|
|
lux-mainnet.yaml # Full Lux mainnet Network example
|
|
nodecluster-standalone.yaml # Standalone NodeCluster + Gateway
|
|
ethereum-node.yaml # Ethereum node example
|
|
cloud-multi-brand.yaml # Multi-brand Cloud deployment
|
|
internal/
|
|
controller/
|
|
nodecluster_controller.go # NodeCluster reconciler
|
|
chain_controller.go # Chain reconciler
|
|
network_controller.go # Network reconciler
|
|
bridge_controller.go # Bridge reconciler
|
|
explorer_controller.go # Explorer reconciler
|
|
gateway_controller.go # Gateway reconciler
|
|
indexer_controller.go # Indexer reconciler
|
|
cloud_controller.go # Cloud reconciler
|
|
helpers.go # Shared controller utilities
|
|
predicates.go # Event filter predicates
|
|
manifests/
|
|
builder.go # K8s manifest builder (StatefulSet, Service, etc.)
|
|
labels.go # Label helpers
|
|
mutate.go # CreateOrUpdate mutation helpers
|
|
protocol/
|
|
driver.go # Driver interface definition
|
|
registry.go # Protocol driver registry
|
|
lux.go # Lux protocol driver
|
|
ethereum.go # Ethereum protocol driver
|
|
bitcoin.go # Bitcoin protocol driver
|
|
cosmos.go # Cosmos protocol driver
|
|
solana.go # Solana protocol driver
|
|
generic.go # Generic fallback driver
|
|
status/ # Status tracking utilities</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | CRDs not found | Manifests not applied | Run <code>make manifests && make deploy</code> | | Leader election contention | Multiple operator replicas | Only one replica should run, or enable <code>--leader-elect</code> | | Nodes stuck in Pending | Missing StorageClass | Verify <code>storageClassName</code> exists in cluster | | Protocol not recognized | Invalid protocol enum | Must be one of: lux, ethereum, bitcoin, cosmos, substrate, generic | | Snapshot restore fails | S3 endpoint unreachable | Check <code>seedRestore.objectStoreURL</code> and network policies |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-hke.md</code> - Managed Kubernetes Engine (placeholder)</li><li><code>hanzo/hanzo-platform.md</code> - PaaS platform for service deployment</li><li><code>hanzo/hanzo-cloud.md</code> - Cloud dashboard and console</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: kubernetes, operator, blockchain, lux, ethereum, bitcoin, cosmos, solana, infrastructure <strong>Prerequisites</strong>: Kubernetes 1.28+, Go 1.25+, controller-gen</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-nchain.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |