Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<title>hoodkit — patch the signal chain for Robinhood Chain</title>
<meta name="description" content="A power-user toolkit for Robinhood Chain: real-time streams with reconnect gap-fill, a read-through cache with request coalescing, multicall batching, and a local SQLite indexer. Patch the modules together and watch the data flow." />
<link rel="canonical" href="https://nirholas.github.io/hoodkit/" />
<meta name="theme-color" content="#0b0b0c" />
<meta property="og:type" content="website" />
<meta property="og:title" content="hoodkit — the signal patchbay" />
<meta property="og:description" content="Drag patch cables between stream, cache, indexer and your app. Complete the patch and the pipeline goes live — a toolkit you assemble with your cursor." />
<meta property="og:url" content="https://nirholas.github.io/hoodkit/" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:creator" content="@nichxbt" />
<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect width='32' height='32' fill='%230b0b0c'/><circle cx='8' cy='11' r='2.6' fill='none' stroke='%23e9e6df' stroke-width='2'/><circle cx='24' cy='21' r='2.6' fill='none' stroke='%23e9e6df' stroke-width='2'/><path d='M8 11 C 16 27 16 27 24 21' fill='none' stroke='%23e9e6df' stroke-width='2'/></svg>" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"SoftwareApplication","name":"hoodkit","applicationCategory":"DeveloperApplication","operatingSystem":"Node.js >= 20","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"description":"Power-user toolkit for Robinhood Chain (chain ID 4663): real-time streams with reconnect gap-fill, read-through caching with request coalescing, multicall batching, a local SQLite indexer (holders/OHLCV/volume), agent strategy primitives, and SSR-safe React hooks.","softwareVersion":"0.1.0","author":{"@type":"Person","name":"nirholas","url":"https://x.com/nichxbt"},"downloadUrl":"https://www.npmjs.com/package/hoodkit","codeRepository":"https://github.com/nirholas/hoodkit"}
</script>
<style>
:root{
--ink:#0b0b0c; --paper:#e9e6df; --graphite:#78746c; --white:#f7f5f0;
--hair:rgba(11,11,12,.15); --hair2:rgba(11,11,12,.30);
--mono:ui-monospace,"SFMono-Regular","JetBrains Mono","Menlo","Consolas",monospace;
--grot:"Helvetica Neue","Inter","Arial",system-ui,sans-serif;
--ease:cubic-bezier(.16,1,.3,1);
--unit:clamp(14px,1.15vw,19px);
}
*{margin:0;padding:0;box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{
background:var(--paper); color:var(--ink); font-family:var(--grot);
font-size:var(--unit); line-height:1.5; overflow-x:hidden;
-webkit-font-smoothing:antialiased; text-rendering:optimizeLegibility;
}
::selection{background:var(--ink); color:var(--paper)}
a{color:inherit}
.mono{font-family:var(--mono); font-feature-settings:"ss01","zero"}
body::before{
content:""; position:fixed; inset:0; z-index:9999; pointer-events:none;
background:repeating-linear-gradient(0deg,rgba(11,11,12,.035) 0 1px,transparent 1px 3px);
mix-blend-mode:multiply; opacity:.5;
}
.scan{position:fixed; left:0; right:0; height:2px; z-index:9998; pointer-events:none;
background:linear-gradient(90deg,transparent,rgba(11,11,12,.20),transparent);
animation:scan 8s linear infinite; will-change:transform}
@keyframes scan{0%{transform:translateY(-10vh)}100%{transform:translateY(110vh)}}
@media(prefers-reduced-motion:reduce){.scan{display:none} *{animation-duration:.001s!important}}
/* signal rail */
.rail{position:fixed; left:0; top:0; bottom:0; width:56px; z-index:60;
display:flex; flex-direction:column; align-items:center; justify-content:center; gap:2px;
border-right:1px solid var(--hair); background:var(--paper); mix-blend-mode:multiply}
.rail b{writing-mode:vertical-rl; transform:rotate(180deg); font:600 11px/1 var(--mono);
letter-spacing:.35em; text-transform:uppercase; color:var(--graphite); position:absolute; top:16px}
.rail .stn{writing-mode:vertical-rl; font:500 10px/1 var(--mono); letter-spacing:.28em;
text-transform:uppercase; color:var(--graphite); padding:14px 0; cursor:pointer;
transition:color .3s var(--ease); text-decoration:none; opacity:.6}
.rail .stn:hover{color:var(--ink); opacity:1}
.rail .stn[aria-current="true"]{color:var(--ink); opacity:1}
.rail .stn::before{content:"";display:block;width:5px;height:5px;border:1px solid var(--hair2);
border-radius:50%;margin:0 auto 8px;transition:all .3s var(--ease)}
.rail .stn[aria-current="true"]::before{background:var(--ink);border-color:var(--ink)}
.rail .carriage{position:absolute;left:-1px;width:2px;background:var(--ink);height:40px;
top:0;transition:transform .5s var(--ease);will-change:transform}
main{margin-left:56px}
@media(max-width:720px){.rail{width:0;border:0}.rail b,.rail .stn,.rail .carriage{display:none}main{margin-left:0}}
section{position:relative; padding:clamp(56px,8vh,110px) clamp(20px,5vw,88px); border-bottom:1px solid var(--hair)}
.eyebrow{font:600 11px/1 var(--mono); letter-spacing:.34em; text-transform:uppercase;
color:var(--graphite); display:flex; align-items:center; gap:12px; margin-bottom:26px}
.eyebrow::after{content:"";flex:1;height:1px;background:var(--hair)}
.eyebrow .n{color:var(--ink)}
h1,h2{font-family:var(--grot); font-weight:700; letter-spacing:-.03em; line-height:.96}
h1{font-size:clamp(40px,7.6vw,104px)}
h2{font-size:clamp(30px,5vw,64px)}
.lede{max-width:62ch; font-size:clamp(17px,1.7vw,23px); line-height:1.42; color:#26241f}
/* ============ RIG (hero + the signature interaction) ============ */
#rig{min-height:100svh; display:flex; flex-direction:column; justify-content:center; padding-bottom:clamp(40px,6vh,72px)}
.boot{font:500 12px/1.7 var(--mono); color:var(--graphite); letter-spacing:.04em; margin-bottom:20px; white-space:pre-wrap}
@media(max-width:720px){.boot{font-size:10.5px; letter-spacing:0}}
.boot span{display:inline-block; white-space:pre; opacity:0; animation:type .5s var(--ease) forwards}
@keyframes type{to{opacity:1}}
h1.headline{max-width:15ch}
h1 .lo{color:var(--graphite)}
.sub{margin-top:22px; max-width:56ch; font-size:clamp(16px,1.6vw,21px); color:#2b2823}
.patchwrap{position:relative; margin-top:clamp(26px,4vh,44px); border:1px solid var(--hair2);
background:linear-gradient(180deg,rgba(11,11,12,.015),transparent);
padding:clamp(22px,3vw,44px) clamp(18px,3vw,52px); overflow:hidden}
.patchwrap::before{content:""; position:absolute; inset:0; pointer-events:none;
background-image:radial-gradient(circle at 1px 1px, rgba(11,11,12,.13) 1px, transparent 0);
background-size:22px 22px; opacity:.55}
.cables{position:absolute; inset:0; width:100%; height:100%; pointer-events:none; z-index:3; overflow:visible}
.cables path.cable{fill:none; stroke:var(--ink); stroke-width:2.4; stroke-linecap:round;
opacity:0; transition:opacity .35s var(--ease)}
.cables path.cable.on{opacity:1}
.cables path.cable.hit{stroke:transparent; stroke-width:18; pointer-events:stroke; cursor:pointer; opacity:1}
.cables path.ghost{fill:none; stroke:var(--graphite); stroke-width:2.2; stroke-dasharray:2 7;
stroke-linecap:round; opacity:.9}
.cables .pkt{fill:var(--ink)}
.rack{position:relative; z-index:4; display:grid; grid-template-columns:repeat(4,1fr);
gap:clamp(30px,5vw,58px) clamp(34px,5vw,76px); align-items:start}
@media(min-width:761px){
.rack{grid-template-rows:auto auto}
.mod[data-slot="stream"]{grid-column:1;grid-row:1}
.mod[data-slot="cache"]{grid-column:2;grid-row:1}
.mod[data-slot="indexer"]{grid-column:3;grid-row:1}
.mod[data-slot="app"]{grid-column:4;grid-row:1}
.mod[data-slot="react"]{grid-column:2;grid-row:2}
.mod[data-slot="strategy"]{grid-column:3;grid-row:2}
}
@media(max-width:760px){.rack{grid-template-columns:1fr 1fr; gap:52px 44px}}
@media(max-width:480px){.rack{grid-template-columns:1fr; gap:46px}}
.mod{position:relative; border:1.5px solid var(--ink); background:var(--paper);
padding:14px 15px 16px; min-height:96px; transition:box-shadow .4s var(--ease); }
.mod[data-slot="app"]{background:var(--ink); color:var(--paper); border-color:var(--ink)}
.mod .mh{display:flex; align-items:baseline; justify-content:space-between; gap:8px}
.mod .mn{font:700 15px/1 var(--grot); letter-spacing:-.01em}
.mod .mt{font:600 9px/1 var(--mono); letter-spacing:.2em; text-transform:uppercase; color:var(--graphite)}
.mod[data-slot="app"] .mt{color:rgba(247,245,240,.6)}
.mod .md{margin-top:9px; font:500 11.5px/1.42 var(--mono); color:#332f28; letter-spacing:.01em}
.mod[data-slot="app"] .md{color:rgba(247,245,240,.82)}
.mod .led{position:absolute; top:12px; right:13px; width:6px; height:6px; border-radius:50%;
border:1px solid var(--hair2); transition:background .35s,border-color .35s,box-shadow .45s}
.mod[data-slot="app"] .led{border-color:rgba(247,245,240,.4)}
.mod.live .led{background:var(--ink); border-color:var(--ink); box-shadow:0 0 0 3px rgba(11,11,12,.12)}
.mod[data-slot="app"].live .led{background:var(--paper); border-color:var(--paper); box-shadow:0 0 0 3px rgba(247,245,240,.22)}
.mod.live{box-shadow:0 0 0 1px var(--ink)}
.mod.nudge{animation:nudge .34s var(--ease)}
@keyframes nudge{0%,100%{transform:none}25%{transform:translateX(-4px)}75%{transform:translateX(4px)}}
/* jacks */
.jack{position:absolute; width:20px; height:20px; border-radius:50%; border:0; padding:0;
background:var(--paper); cursor:crosshair; z-index:6; display:grid; place-items:center;
transition:transform .25s var(--ease); touch-action:none}
.mod[data-slot="app"] .jack{background:var(--ink)}
.jack::before{content:""; width:16px; height:16px; border-radius:50%; border:2px solid var(--ink);
box-shadow:inset 0 0 0 3px var(--paper), inset 0 0 0 5px var(--ink)}
.mod[data-slot="app"] .jack::before{border-color:var(--paper); box-shadow:inset 0 0 0 3px var(--ink), inset 0 0 0 5px var(--paper)}
.jack:focus-visible{outline:2px solid var(--ink); outline-offset:3px}
.jack.armed::before{animation:armpulse 1s ease-in-out infinite}
@keyframes armpulse{0%,100%{box-shadow:inset 0 0 0 3px var(--paper), inset 0 0 0 5px var(--ink)}50%{box-shadow:inset 0 0 0 2px var(--paper), inset 0 0 0 8px var(--ink)}}
.jack.wired::before{box-shadow:inset 0 0 0 2px var(--paper), inset 0 0 0 7px var(--ink)}
.mod[data-slot="app"] .jack.wired::before{box-shadow:inset 0 0 0 2px var(--ink), inset 0 0 0 7px var(--paper)}
.jack .lab{position:absolute; font:600 8px/1 var(--mono); letter-spacing:.14em; text-transform:uppercase;
color:var(--graphite); white-space:nowrap; pointer-events:none}
.mod[data-slot="app"] .jack .lab{color:rgba(247,245,240,.6)}
/* desktop: in left, out right */
.jack.in{left:-10px; top:50%; transform:translateY(-50%)}
.jack.in.armed,.jack.in.hoverable{transform:translateY(-50%) scale(1.22)}
.jack.out{right:-10px; top:50%; transform:translateY(-50%)}
.jack.out.armed,.jack.out.hoverable{transform:translateY(-50%) scale(1.22)}
.jack.in .lab{right:27px; top:50%; transform:translateY(-50%)}
.jack.out .lab{left:27px; top:50%; transform:translateY(-50%)}
@media(hover:hover){ .jack:hover{transform:translateY(-50%) scale(1.22)} }
/* satellite modules: top input jack */
.jack.in.top{left:50%; top:-10px; transform:translateX(-50%)}
.jack.in.top.armed{transform:translateX(-50%) scale(1.22)}
.jack.in.top .lab{left:50%; top:-16px; transform:translateX(-50%); right:auto}
@media(hover:hover){ .jack.in.top:hover{transform:translateX(-50%) scale(1.22)} }
@media(max-width:480px){
.jack.in{left:50%; top:-10px; right:auto; transform:translateX(-50%)}
.jack.in.armed{transform:translateX(-50%) scale(1.22)}
.jack.out{left:50%; right:auto; top:auto; bottom:-10px; transform:translateX(-50%)}
.jack.out.armed{transform:translateX(-50%) scale(1.22)}
.jack.in .lab,.jack.in.top .lab{left:50%; top:-16px; right:auto; transform:translateX(-50%)}
.jack.out .lab{left:50%; top:auto; bottom:-16px; transform:translateX(-50%)}
@media(hover:hover){ .jack.in:hover,.jack.out:hover,.jack.in.top:hover{transform:translateX(-50%) scale(1.22)} }
}
.patchbar{margin-top:22px; display:flex; flex-wrap:wrap; align-items:center; gap:16px 22px}
.seatall{appearance:none; border:1px solid var(--ink); background:var(--ink); color:var(--paper);
font:600 12px/1 var(--mono); letter-spacing:.16em; text-transform:uppercase; padding:15px 26px;
cursor:pointer; transition:transform .3s var(--ease),background .3s,color .3s}
.seatall:hover{transform:translateY(-2px)} .seatall:active{transform:translateY(0)}
.seatall:disabled{opacity:.45; cursor:default; transform:none}
.seatall.reset{background:var(--paper); color:var(--ink)}
.hint{font:500 12px/1.45 var(--mono); color:var(--graphite); letter-spacing:.02em; max-width:46ch}
.hint kbd{font:inherit; border:1px solid var(--hair2); padding:1px 5px; border-radius:3px}
.status{margin-top:24px; border:1px solid var(--hair2); display:grid; grid-template-columns:150px 1fr}
@media(max-width:520px){.status{grid-template-columns:1fr}}
.status .sk{font:600 10px/1 var(--mono); letter-spacing:.2em; text-transform:uppercase; color:var(--graphite);
padding:15px 16px; border-right:1px solid var(--hair); background:rgba(11,11,12,.02); display:flex; align-items:center; gap:10px}
@media(max-width:520px){.status .sk{border-right:0; border-bottom:1px solid var(--hair)}}
.status .sk .dot{width:7px;height:7px;border-radius:50%;border:1px solid var(--graphite)}
.status.online .sk{color:var(--ink)}
.status.online .sk .dot{background:var(--ink); border-color:var(--ink); animation:beat 1.6s ease-in-out infinite}
@keyframes beat{0%,100%{box-shadow:0 0 0 0 rgba(11,11,12,.25)}50%{box-shadow:0 0 0 4px rgba(11,11,12,0)}}
.status .sv{padding:13px 16px; font:500 12.5px/1.5 var(--mono); color:var(--ink); min-height:46px; display:flex; align-items:center}
.patchlog{margin:0; padding:12px 16px 14px; list-style:none; border-top:1px solid var(--hair); grid-column:1/-1;
font:500 12px/1.9 var(--mono); color:#332f28; min-height:30px}
.patchlog li{opacity:0; transform:translateY(6px); transition:opacity .4s var(--ease),transform .4s var(--ease)}
.patchlog li.in{opacity:1; transform:none}
.patchlog li::before{content:"› "; color:var(--graphite)}
.patchlog li b{font-weight:700}
.scrollcue{margin-top:26px; font:600 10px/1 var(--mono); letter-spacing:.3em; text-transform:uppercase;
color:var(--graphite); display:inline-flex; align-items:center; gap:10px}
.scrollcue i{display:block; width:26px; height:1px; background:var(--graphite); position:relative; overflow:hidden}
.scrollcue i::after{content:"";position:absolute;inset:0;background:var(--ink);animation:sweep 2.4s var(--ease) infinite}
@keyframes sweep{0%{transform:translateX(-100%)}60%,100%{transform:translateX(100%)}}
/* ============ MODULES / signal library ============ */
.lib{display:grid; grid-template-columns:repeat(3,1fr); border-left:1px solid var(--hair); border-top:1px solid var(--hair); margin-top:14px}
@media(max-width:860px){.lib{grid-template-columns:repeat(2,1fr)}}
@media(max-width:480px){.lib{grid-template-columns:1fr}}
.cell{border-right:1px solid var(--hair); border-bottom:1px solid var(--hair); padding:22px 20px 26px; position:relative; overflow:hidden; transition:background .3s}
.cell:hover{background:rgba(11,11,12,.03)}
.cell .id{font:600 10px/1 var(--mono); letter-spacing:.2em; color:var(--graphite)}
.cell .nm{font:700 20px/1.05 var(--grot); letter-spacing:-.02em; margin:12px 0 8px}
.cell .ds{font-size:14.5px; color:#2c2925; line-height:1.42}
.cell .ex{margin-top:14px; font:500 11.5px/1.5 var(--mono); color:var(--graphite); word-break:break-word}
.cell .wave{display:block; margin-top:18px; height:24px; width:100%; opacity:.42; transition:opacity .3s}
.cell .wave path{fill:none; stroke:var(--ink); stroke-width:1.2}
.cell:hover .wave{opacity:.9}
/* ============ RELIABILITY (gap-fill) ============ */
.cols{display:grid; grid-template-columns:1fr 1fr; gap:clamp(30px,5vw,80px); align-items:start}
@media(max-width:860px){.cols{grid-template-columns:1fr; gap:34px}}
.gapviz{border:1px solid var(--hair2); background:rgba(11,11,12,.02); padding:22px 20px 24px}
.gapviz .gl{font:600 10px/1 var(--mono); letter-spacing:.2em; text-transform:uppercase; color:var(--graphite); display:flex; justify-content:space-between; margin-bottom:16px}
.blocks{display:flex; gap:5px; align-items:flex-end; height:64px}
.blocks .blk{flex:1; height:100%; background:var(--hair2); border:1px solid var(--hair2); transition:background .3s var(--ease),transform .5s var(--ease); transform:scaleY(.18); transform-origin:bottom; will-change:transform}
.blocks .blk.filled{background:var(--ink); border-color:var(--ink)}
.blocks .blk.gap{background:var(--paper); border:1px dashed var(--hair2); transform:scaleY(1)}
.blocks .blk.refill{background:var(--ink); border-color:var(--ink)}
.gapcap{margin-top:16px; font:500 12px/1.6 var(--mono); color:#332f28; min-height:3.2em}
.gapcap b{font-weight:700}
.gapmark{display:inline-block; padding:2px 6px; background:var(--ink); color:var(--paper); font-weight:700}
.fuse{display:grid; grid-template-columns:repeat(4,1fr); gap:14px; margin-top:26px}
@media(max-width:860px){.fuse{grid-template-columns:1fr 1fr}}
@media(max-width:420px){.fuse{grid-template-columns:1fr}}
.fuse .f{border:1px solid var(--hair2); padding:18px}
.fuse .f .h{font:700 13px/1 var(--mono); letter-spacing:.06em; text-transform:uppercase; margin-bottom:9px}
.fuse .f .b{font-size:14px; color:#2c2925; line-height:1.45}
/* ============ INSTALL / GET ============ */
.install{border:1px solid var(--ink); background:var(--ink); color:var(--paper); padding:20px 22px;
font:500 13.5px/1.9 var(--mono); position:relative; overflow-x:auto; white-space:pre-wrap; word-break:break-word}
.install .c{color:#8b8781}
.install .p::before{content:"$ "; color:#8b8781}
.copy{position:absolute; top:12px; right:12px; appearance:none; border:1px solid rgba(233,230,223,.3);
background:transparent; color:var(--paper); font:600 10px/1 var(--mono); letter-spacing:.14em; padding:7px 11px; cursor:pointer; transition:background .2s}
.copy:hover{background:rgba(233,230,223,.14)}
.spec{border-top:1px solid var(--hair); margin-top:26px}
.spec .r{display:grid; grid-template-columns:150px 1fr; gap:20px; padding:16px 0; border-bottom:1px solid var(--hair); align-items:baseline}
@media(max-width:640px){.spec .r{grid-template-columns:1fr; gap:5px}}
.spec .r .t{font:600 11px/1.3 var(--mono); letter-spacing:.14em; text-transform:uppercase; color:var(--graphite)}
.spec .r .d{font-size:15px; color:#25231f; max-width:60ch}
.spec .r .d b{font-weight:700}
.btns{display:flex; flex-wrap:wrap; gap:12px; margin-top:26px}
.btn{appearance:none; text-decoration:none; border:1px solid var(--ink); color:var(--ink); background:transparent;
font:600 12px/1 var(--mono); letter-spacing:.12em; text-transform:uppercase; padding:15px 22px; cursor:pointer;
transition:background .25s,color .25s,transform .25s var(--ease)}
.btn:hover{background:var(--ink); color:var(--paper); transform:translateY(-2px)}
.btn.solid{background:var(--ink); color:var(--paper)}
.btn.solid:hover{background:transparent; color:var(--ink)}
footer{padding:clamp(40px,6vh,72px) clamp(20px,5vw,88px); display:flex; flex-wrap:wrap; justify-content:space-between; gap:20px; align-items:flex-end}
footer .big{font:700 clamp(30px,6vw,72px)/.9 var(--grot); letter-spacing:-.03em}
footer .meta{font:500 12px/1.7 var(--mono); color:var(--graphite); letter-spacing:.02em; text-align:right}
footer a{text-decoration:none; border-bottom:1px solid var(--hair2); transition:border-color .2s}
footer a:hover{border-color:var(--ink)}
.rise{opacity:0; transform:translateY(22px); transition:opacity .8s var(--ease),transform .8s var(--ease)}
.rise.in{opacity:1; transform:none}
</style>
</head>
<body>
<div class="scan" aria-hidden="true"></div>
<nav class="rail" aria-label="Sections">
<b>hoodkit</b>
<span class="carriage" id="carriage"></span>
<a class="stn" href="#rig" aria-current="true">Patch</a>
<a class="stn" href="#modules">Modules</a>
<a class="stn" href="#reliability">Gap‑fill</a>
<a class="stn" href="#install">Install</a>
<a class="stn" href="#get">Get it</a>
</nav>
<main>
<!-- ============ RIG ============ -->
<section id="rig">
<p class="boot mono" id="boot"></p>
<div class="eyebrow"><span class="n">00</span> / SIGNAL PATCHBAY · chain 4663</div>
<h1 class="headline">Patch the pipeline.<br><span class="lo">Then it runs itself.</span></h1>
<p class="sub">hoodkit is four modules you wire together: a real-time <b>stream</b>, a read-through <b>cache</b>, a local <b>indexer</b>, and your app. Drag a cable from an output jack to an input jack. Seat all three and the signal chain goes live — the same shape your code assembles in about a dozen lines.</p>
<div class="patchwrap">
<svg class="cables" id="cables" aria-hidden="true"></svg>
<div class="rack" id="rack">
<div class="mod" data-slot="stream">
<span class="led"></span>
<div class="mh"><span class="mn">Stream</span><span class="mt">source</span></div>
<div class="md">Chainlink ticks · v3 swaps · launches</div>
<button class="jack out" data-jack="s_out" data-port="out" data-slot="stream" aria-label="Stream output — start a cable"><span class="lab">out</span></button>
</div>
<div class="mod" data-slot="cache">
<span class="led"></span>
<div class="mh"><span class="mn">Cache</span><span class="mt">coalesce</span></div>
<div class="md">N identical reads → one RPC call</div>
<button class="jack in" data-jack="c_in" data-port="in" data-slot="cache" aria-label="Cache input"><span class="lab">in</span></button>
<button class="jack out" data-jack="c_out" data-port="out" data-slot="cache" aria-label="Cache output"><span class="lab">out</span></button>
</div>
<div class="mod" data-slot="indexer">
<span class="led"></span>
<div class="mh"><span class="mn">Indexer</span><span class="mt">sqlite</span></div>
<div class="md">holders · OHLCV · 24h vol · 0 RPC</div>
<button class="jack in" data-jack="i_in" data-port="in" data-slot="indexer" aria-label="Indexer input"><span class="lab">in</span></button>
<button class="jack out" data-jack="i_out" data-port="out" data-slot="indexer" aria-label="Indexer output"><span class="lab">out</span></button>
</div>
<div class="mod" data-slot="app">
<span class="led"></span>
<div class="mh"><span class="mn">Your app</span><span class="mt">sink</span></div>
<div class="md">bot · dashboard · agent</div>
<button class="jack in" data-jack="a_in" data-port="in" data-slot="app" aria-label="Your app input"><span class="lab">in</span></button>
</div>
<div class="mod" data-slot="react">
<span class="led"></span>
<div class="mh"><span class="mn">React</span><span class="mt">aux · hooks</span></div>
<div class="md">useQuote · usePortfolio · SSR-safe</div>
<button class="jack in top" data-jack="r_in" data-port="in" data-slot="react" aria-label="React hooks input"><span class="lab">in</span></button>
</div>
<div class="mod" data-slot="strategy">
<span class="led"></span>
<div class="mh"><span class="mn">Strategy</span><span class="mt">aux · agent</span></div>
<div class="md">PnL · triggers · dry-run TWAP · caps</div>
<button class="jack in top" data-jack="x_in" data-port="in" data-slot="strategy" aria-label="Strategy input"><span class="lab">in</span></button>
</div>
</div>
</div>
<div class="patchbar">
<button class="seatall" id="seatall">Seat all cables</button>
<p class="hint" id="hint">Drag from an <b>out</b> jack to an <b>in</b> jack — or tap one then the other. <kbd>Tab</kbd> + <kbd>Enter</kbd> works too.</p>
</div>
<div class="status" id="status">
<div class="sk"><span class="dot"></span><span id="statuslabel">standby</span></div>
<div class="sv" id="statusval">0 / 3 core cables patched · signal idle</div>
<ul class="patchlog" id="patchlog"></ul>
</div>
<div class="scrollcue">scroll · the modules <i></i></div>
</section>
<!-- ============ MODULES ============ -->
<section id="modules">
<div class="eyebrow"><span class="n">01</span> / SIX MODULES · one entry point</div>
<h2>Every jack on that board<br>is a real export.</h2>
<p class="lede" style="margin-top:22px">One <span class="mono">createHoodClient()</span> from <b>hoodchain</b> flows through all of them. Import only what you patch — hoodkit is side-effect-free and tree-shakes to nothing you don't call.</p>
<div class="lib" id="lib"></div>
</section>
<!-- ============ RELIABILITY ============ -->
<section id="reliability">
<div class="eyebrow"><span class="n">02</span> / THE GUARANTEE · reconnect gap-fill</div>
<div class="cols">
<div>
<h2>A dropped RPC never<br>drops an event.</h2>
<p class="lede" style="margin-top:22px">Every RPC-backed stream sits behind one gap-fill engine. It keeps a persistent block cursor that only advances <b>after</b> a range is decoded and pushed. Lose the connection and the exact same range is re-read next tick — so no confirmed swap, transfer, or launch is ever silently skipped.</p>
<div class="fuse">
<div class="f"><div class="h">backpressure</div><div class="b">A slow <span class="mono">for await</span> consumer never grows memory unboundedly — one source, bounded buffer.</div></div>
<div class="f"><div class="h">overflow policy</div><div class="b"><span class="mono">latest</span> for price ticks, <span class="mono">drop-oldest</span> or <span class="mono">block</span> where every value counts.</div></div>
<div class="f"><div class="h">coalescing</div><div class="b">100 concurrent <span class="mono">getQuote</span> calls collapse into ~1 upstream round-trip.</div></div>
<div class="f"><div class="h">zero-RPC reads</div><div class="b">Holder, candle and volume queries answer from the local SQLite index, not the chain.</div></div>
</div>
</div>
<div>
<div class="gapviz">
<div class="gl"><span>runLogCursor · block feed</span><span id="gaptag">syncing</span></div>
<div class="blocks" id="blocks"></div>
<div class="gapcap mono" id="gapcap">Cursor advancing block by block, each range decoded and pushed before the head moves.</div>
</div>
</div>
</div>
</section>
<!-- ============ INSTALL ============ -->
<section id="install">
<div class="eyebrow"><span class="n">03</span> / INSTALL</div>
<div class="cols">
<div>
<h2>Patch it in<br>real code.</h2>
<p class="lede" style="margin-top:22px">The three core modules, wired the same way you just wired the board. <b>hoodchain</b> and <b>viem</b> are peers — hoodkit never bundles them, so your app pins the versions.</p>
<div class="spec">
<div class="r"><div class="t">stream</div><div class="d"><b>streamPrices / streamSwaps / streamLaunches / streamPortfolio</b> — a backpressure-safe <span class="mono">Stream<T></span> that is both an emitter and an async iterable.</div></div>
<div class="r"><div class="t">cache</div><div class="d"><b>createHoodCache</b> — read-through with request coalescing and per-datatype TTLs. Pluggable <span class="mono">CacheStore</span> for Redis or KV.</div></div>
<div class="r"><div class="t">batch</div><div class="d"><b>plan / createBatcher</b> — Multicall3 batching with per-read failure isolation; a DataLoader-style batcher coalesces across unrelated code paths.</div></div>
<div class="r"><div class="t">indexer</div><div class="d"><b>createIndexer</b> — incremental SQLite sync of Transfer + Swap events; resumes from the last block, answers queries with zero RPC.</div></div>
</div>
</div>
<div>
<div class="install">
<button class="copy" data-copy="install">COPY</button>
<span class="c"># install — hoodchain + viem are peers</span>
<span class="p" id="cmd-install">npm install hoodkit hoodchain viem</span>
<span class="c"># the patch, in code:</span>
<span class="c"># stream → cache → indexer → your app</span>
<span class="p">import { createHoodClient } from 'hoodchain'</span>
<span class="p">import { streamPrices, createHoodCache,</span>
<span class="p"> createIndexer } from 'hoodkit'</span>
<span class="p">const hood = createHoodClient()</span>
<span class="p">const cache = createHoodCache(hood)</span>
<span class="p">const idx = await createIndexer({ client: hood,</span>
<span class="p"> path: './hood.sqlite', tokens: ['0x…'] })</span>
<span class="p">for await (const t of streamPrices(hood))</span>
<span class="p"> render(t.symbol, t.priceUsd)</span>
</div>
</div>
</div>
</section>
<!-- ============ GET ============ -->
<section id="get">
<div class="eyebrow"><span class="n">04</span> / GET IT</div>
<div class="cols">
<div>
<h2>Built on hoodchain.<br>Ships with React hooks.</h2>
<p class="lede" style="margin-top:22px">Optional peers unlock the aux modules: <span class="mono">better-sqlite3</span> for the indexer, <span class="mono">react >=18</span> for the SSR-safe hooks. Missing a peer for a feature you call throws a clear install instruction — never a silent failure.</p>
<div class="btns">
<a class="btn solid" href="https://www.npmjs.com/package/hoodkit">npm</a>
<a class="btn" href="https://github.com/nirholas/hoodkit">source</a>
<a class="btn" href="https://github.com/nirholas/robinhood-chain-sdk">hoodchain</a>
</div>
</div>
<div>
<div class="install">
<button class="copy" data-copy="react">COPY</button>
<span class="c"># React: SSR-safe hooks over the same layers</span>
<span class="p" id="cmd-react">npm install hoodkit react</span>
<span class="p">import { HoodProvider, useQuote,</span>
<span class="p"> useLaunches } from 'hoodkit/react'</span>
<span class="c"># live Chainlink price, updates on round advance</span>
<span class="p">const { data } = useQuote('AAPL')</span>
<span class="c"># optional peer, only if you patch it in</span>
<span class="p">npm install better-sqlite3 # indexer</span>
</div>
</div>
</div>
</section>
<footer>
<div class="big">hood<br>kit</div>
<div class="meta">
Node ≥ 20 · viem-native · streams · cache · indexer<br>
<a href="https://github.com/nirholas/hoodkit">github.com/nirholas/hoodkit</a><br>
<a href="https://www.npmjs.com/package/hoodkit">npmjs.com/package/hoodkit</a><br>
built by <a href="https://x.com/nichxbt">@nichxbt</a> · powered by <a href="https://three.ws">three.ws</a>
</div>
</footer>
</main>
<script>
"use strict";
/* ---------- boot line ---------- */
(function boot(){
const el = document.getElementById('boot');
const line = '● hoodchain client ready · public RPC · chain 4663 · patch a cable to begin';
[...line].forEach((ch,i)=>{ const s=document.createElement('span'); s.textContent=ch; s.style.animationDelay=(i*13+120)+'ms'; el.appendChild(s); });
})();
/* ================= THE PATCHBAY ================= */
const svg = document.getElementById('cables');
const wrap = svg.parentElement;
const SVGNS = 'http://www.w3.org/2000/svg';
const EDGES = { // directed: out -> in
s_out:{ c_in:1, r_in:1 },
c_out:{ i_in:1, x_in:1 },
i_out:{ a_in:1 },
};
const CORE = [['s_out','c_in'],['c_out','i_in'],['i_out','a_in']];
const LABELS = {
's_out|c_in':['Stream → Cache','ticks & swaps flow into the read-through cache; identical reads <b>coalesce</b>.'],
'c_out|i_in':['Cache → Indexer','decoded events land in local <b>SQLite</b> — holders, OHLCV, 24h volume.'],
'i_out|a_in':['Indexer → Your app','your bot or dashboard queries the index with <b>zero RPC</b> at read time.'],
's_out|r_in':['Stream → React','the same stream drives SSR-safe hooks: <b>useQuote</b>, <b>useLaunches</b>.'],
'c_out|x_in':['Cache → Strategy','cached reads feed <b>PnL</b>, price triggers and a dry-run <b>TWAP</b>.'],
};
const jacks = {};
document.querySelectorAll('.jack').forEach(j=>{ jacks[j.dataset.jack] = j; });
const mods = {};
document.querySelectorAll('.mod').forEach(m=>{ mods[m.dataset.slot] = m; });
const jackSlot = { s_out:'stream', c_in:'cache', c_out:'cache', i_in:'indexer', i_out:'indexer', a_in:'app', r_in:'react', x_in:'strategy' };
const connections = new Map(); // "from|to" -> conn
let armed = null, ghost = null, pointerActive = false, downPt = null, lastGhostPt = null;
function jackCenter(id){
const r = jacks[id].getBoundingClientRect();
const w = wrap.getBoundingClientRect();
return { x: r.left + r.width/2 - w.left, y: r.top + r.height/2 - w.top };
}
function cablePath(a, b){
const dx = b.x - a.x, dy = b.y - a.y, dist = Math.hypot(dx, dy);
const horiz = Math.abs(dx) >= Math.abs(dy);
const k = Math.max(38, Math.abs(dx)*0.42);
const sag = Math.min(60, dist*0.20) + 10;
const c1x = a.x + (horiz ? k : 8), c2x = b.x - (horiz ? k : 8);
return `M ${a.x} ${a.y} C ${c1x} ${a.y+sag}, ${c2x} ${b.y+sag}, ${b.x} ${b.y}`;
}
function makePath(cls){ const p=document.createElementNS(SVGNS,'path'); p.setAttribute('class',cls); svg.appendChild(p); return p; }
function key(from,to){ return from+'|'+to; }
function isValid(from,to){ return !!(EDGES[from] && EDGES[from][to]); }
function connect(from, to){
if(!isValid(from,to)) return false;
const k = key(from,to);
if(connections.has(k)) return false;
const d = cablePath(jackCenter(from), jackCenter(to));
const path = makePath('cable'); path.setAttribute('d', d);
const hit = makePath('cable hit'); hit.setAttribute('d', d);
const packets = spawnPackets(path);
const conn = { path, hit, packets, from, to };
connections.set(k, conn);
hit.addEventListener('click', ()=>disconnect(k));
requestAnimationFrame(()=>path.classList.add('on'));
jacks[from].classList.add('wired'); jacks[to].classList.add('wired');
mods[jackSlot[from]].classList.add('live'); mods[jackSlot[to]].classList.add('live');
logConn(from,to); updateStatus();
return true;
}
function disconnect(k){
const c = connections.get(k); if(!c) return;
c.path.remove(); c.hit.remove(); c.packets.forEach(p=>p.el.remove());
connections.delete(k); refreshFlags(); removeLog(c.from,c.to); updateStatus();
}
function refreshFlags(){
const uj=new Set(), um=new Set();
connections.forEach(c=>{ uj.add(c.from); uj.add(c.to); um.add(jackSlot[c.from]); um.add(jackSlot[c.to]); });
Object.keys(jacks).forEach(id=> jacks[id].classList.toggle('wired', uj.has(id)));
Object.keys(mods).forEach(s=> mods[s].classList.toggle('live', um.has(s)));
}
/* packets travel via getPointAtLength (cheap, few nodes) */
function spawnPackets(path){
const len = path.getTotalLength();
const n = Math.max(2, Math.round(len/130));
const arr = [];
for(let i=0;i<n;i++){
const el = document.createElementNS(SVGNS,'circle');
el.setAttribute('class','pkt'); el.setAttribute('r','3.1'); svg.appendChild(el);
arr.push({ el, path, len, t: i/n, speed: 0.11 + Math.random()*0.03 });
}
return arr;
}
let lastTs = 0;
function tick(ts){
const dt = Math.min(0.05, (ts - lastTs)/1000 || 0); lastTs = ts;
connections.forEach(c=>{ c.packets.forEach(p=>{
p.t += p.speed*dt; if(p.t>1) p.t-=1;
const pt = p.path.getPointAtLength(p.t*p.len);
p.el.setAttribute('cx', pt.x); p.el.setAttribute('cy', pt.y);
}); });
requestAnimationFrame(tick);
}
requestAnimationFrame(tick);
function reflow(){
const w = wrap.getBoundingClientRect();
svg.setAttribute('viewBox', `0 0 ${w.width} ${w.height}`);
connections.forEach(c=>{
const d = cablePath(jackCenter(c.from), jackCenter(c.to));
c.path.setAttribute('d', d); c.hit.setAttribute('d', d);
c.packets.forEach(p=>{ p.len = c.path.getTotalLength(); });
});
if(armed && ghost && lastGhostPt) drawGhost(lastGhostPt);
}
new ResizeObserver(()=>reflow()).observe(wrap);
addEventListener('resize', reflow);
/* arming + ghost */
function arm(id){
if(!EDGES[id]) return;
disarm();
armed = id; jacks[id].classList.add('armed');
ghost = makePath('ghost');
markTargets(id, true);
hint('cable armed — drop it on a glowing <b>in</b> jack');
}
function disarm(){
if(armed){ jacks[armed].classList.remove('armed'); markTargets(armed,false); }
armed = null; lastGhostPt = null;
if(ghost){ ghost.remove(); ghost = null; }
}
function markTargets(from,on){
const t = EDGES[from] || {};
Object.keys(t).forEach(to=>{ if(!connections.has(key(from,to))) jacks[to].classList.toggle('hoverable', on); });
}
function drawGhost(pt){
if(!ghost || !armed) return;
lastGhostPt = pt; ghost.setAttribute('d', cablePath(jackCenter(armed), pt));
}
function localPt(e){ const w = wrap.getBoundingClientRect(); return { x:e.clientX-w.left, y:e.clientY-w.top }; }
document.querySelectorAll('.jack').forEach(j=>{
const id = j.dataset.jack, isOut = !!EDGES[id];
j.addEventListener('pointerdown', e=>{
e.preventDefault();
pointerActive = true; downPt = { x:e.clientX, y:e.clientY };
if(isOut){ if(armed!==id) arm(id); drawGhost(localPt(e)); }
else if(armed && isValid(armed,id)){ if(connect(armed,id)) disarm(); else nudge(jackSlot[id]); }
});
j.addEventListener('keydown', e=>{
if(e.key!=='Enter' && e.key!==' ') return;
e.preventDefault();
if(isOut){ armed===id ? disarm() : arm(id); }
else if(armed && isValid(armed,id)){ if(connect(armed,id)) disarm(); }
else hint('arm an <b>out</b> jack first, then press this one');
});
});
addEventListener('pointermove', e=>{ if(armed && ghost) drawGhost(localPt(e)); });
addEventListener('pointerup', e=>{
if(!pointerActive) return; pointerActive = false;
if(!armed) return;
const moved = downPt && Math.hypot(e.clientX-downPt.x, e.clientY-downPt.y) > 8;
const el = document.elementFromPoint(e.clientX, e.clientY);
const jackEl = el && el.closest && el.closest('.jack');
if(jackEl){
const to = jackEl.dataset.jack;
if(isValid(armed,to)){ if(connect(armed,to)) disarm(); }
else if(to !== armed){ nudge(jackSlot[to]); if(moved) disarm(); }
} else if(moved){ disarm(); }
});
function nudge(slot){ const m=mods[slot]; if(!m) return; m.classList.remove('nudge'); void m.offsetWidth; m.classList.add('nudge'); }
/* status + log */
const statusEl=document.getElementById('status'), statusLabel=document.getElementById('statuslabel'),
statusVal=document.getElementById('statusval'), logEl=document.getElementById('patchlog');
const logItems = new Map();
let wasOnline = false;
function logConn(from,to){
const [title, body] = LABELS[key(from,to)] || [from+' → '+to, ''];
const li = document.createElement('li');
li.innerHTML = `<b>${title}</b> — ${body}`;
logEl.appendChild(li); requestAnimationFrame(()=>li.classList.add('in'));
logItems.set(key(from,to), li);
}
function removeLog(from,to){ const li=logItems.get(key(from,to)); if(li){ li.remove(); logItems.delete(key(from,to)); } }
function updateStatus(){
const coreDone = CORE.filter(([a,b])=>connections.has(key(a,b))).length;
const total = connections.size, online = coreDone === CORE.length;
statusEl.classList.toggle('online', online);
statusLabel.textContent = online ? 'online' : (total ? 'patching' : 'standby');
if(online){
statusVal.innerHTML = `<b>PIPELINE ONLINE</b> · stream → cache → indexer → app · ${total} cable${total>1?'s':''} live`;
if(!wasOnline){ hint('pipeline online — this is the shape your code assembles. Scroll on.'); wasOnline = true; }
} else {
wasOnline = false;
statusVal.textContent = `${coreDone} / 3 core cables patched · ${total?('+'+(total-coreDone)+' aux'):'signal idle'}`;
}
}
function hint(html){ document.getElementById('hint').innerHTML = html; }
/* seat all / reset */
const seatBtn = document.getElementById('seatall');
let seating = false;
seatBtn.addEventListener('click', ()=>{
if(seating) return;
if(CORE.every(([a,b])=>connections.has(key(a,b)))){
[...connections.keys()].forEach(disconnect); disarm();
seatBtn.textContent='Seat all cables'; seatBtn.classList.remove('reset');
hint('board cleared — patch it yourself, or seat all again'); return;
}
seating = true; seatBtn.disabled = true; disarm();
const steps = [...CORE, ['s_out','r_in'], ['c_out','x_in']].filter(([a,b])=>!connections.has(key(a,b)));
let i=0;
(function step(){
if(i>=steps.length){ seating=false; seatBtn.disabled=false; seatBtn.textContent='Reset board'; seatBtn.classList.add('reset'); return; }
const [a,b]=steps[i++]; connect(a,b); setTimeout(step, 320);
})();
});
/* ================= signal library ================= */
const MODULES = [
['stream','Stream','Chainlink ticks, v3 swaps, launches and portfolio deltas as one backpressure-safe Stream<T>.','streamPrices(hood, [\'AAPL\',\'TSLA\'])'],
['cache','Cache','Read-through cache with request coalescing — N identical reads become one upstream call.','createHoodCache(hood).getQuote(\'AAPL\')'],
['batch','Batch','Multicall3 batching with per-read failure isolation; a DataLoader-style auto-batcher.','plan(hood, reads) · createBatcher(hood)'],
['indexer','Indexer','Incremental local SQLite: holders, OHLCV candles, rolling 24h volume — zero RPC at query time.','createIndexer({ path, tokens })'],
['strategy','Strategy','Weighted-avg-cost PnL, price-cross triggers, hard spend caps, a dry-run-by-default TWAP executor.','createTwapExecutor(hood, cfg)'],
['react','React','SSR-safe hooks: render inert on the server, hydrate on the client. Live quotes and launches.','useQuote(\'AAPL\') · useLaunches()'],
];
const wavePaths = [
'M0 20 L14 20 L20 6 L28 20 L44 20 L50 12 L58 20 L100 20',
'M0 22 C20 22 24 6 40 6 C56 6 60 20 100 20',
'M0 24 L30 24 L30 6 L54 6 L54 20 L100 20',
'M0 20 L20 20 L20 8 L40 8 L40 20 L60 20 L60 8 L80 8 L80 20 L100 20',
'M0 22 L18 22 L18 14 L36 14 L36 22 L54 22 L54 14 L72 14 L72 22 L100 22',
'M0 14 C16 14 16 6 26 6 C40 6 40 22 54 22 C68 22 68 10 80 10 L100 10',
];
const lib = document.getElementById('lib');
MODULES.forEach((m,i)=>{
const c=document.createElement('div'); c.className='cell rise';
c.innerHTML = `<div class="id">${String(i+1).padStart(2,'0')} · ${m[0]}</div>
<div class="nm">${m[1]}</div>
<div class="ds">${m[2]}</div>
<div class="ex mono">${m[3]}</div>
<svg class="wave" viewBox="0 0 100 28" preserveAspectRatio="none" aria-hidden="true"><path d="${wavePaths[i%wavePaths.length]}"/></svg>`;
lib.appendChild(c);
});
/* ================= gap-fill viz ================= */
(function gapfill(){
const host=document.getElementById('blocks'), cap=document.getElementById('gapcap'), tag=document.getElementById('gaptag');
const N=26, GAP_START=14, GAP_LEN=5, blks=[];
for(let i=0;i<N;i++){ const b=document.createElement('div'); b.className='blk'; host.appendChild(b); blks.push(b); }
let phase=0, i=0, started=false, timer=0;
const H=()=>0.28+Math.random()*0.72;
const set=h=>cap.innerHTML=h, reset=()=>blks.forEach(b=>{b.className='blk'; b.style.transform='scaleY(.18)';});
function run(){
clearTimeout(timer);
if(phase===0){
if(i<GAP_START){ blks[i].classList.add('filled'); blks[i].style.transform=`scaleY(${H()})`; i++; timer=setTimeout(run,88); }
else { phase=1; tag.textContent='connection dropped'; set('RPC connection <span class="gapmark">dropped</span> mid-sync. A naive stream loses these blocks forever.'); timer=setTimeout(run,720); }
} else if(phase===1){
for(let g=GAP_START; g<GAP_START+GAP_LEN; g++) blks[g].className='blk gap';
phase=2; timer=setTimeout(run,900);
} else if(phase===2){
tag.textContent='gap-filling'; let g=GAP_START;
(function fill(){
if(g<GAP_START+GAP_LEN){ blks[g].className='blk refill'; blks[g].style.transform=`scaleY(${H()})`; g++; timer=setTimeout(fill,150); }
else { set('The cursor <span class="gapmark">re-read the exact same range</span> — every confirmed event recovered, in order.'); phase=3; timer=setTimeout(run,700); }
})();
} else if(phase===3){
if(i<N){ blks[i].classList.add('filled'); blks[i].style.transform=`scaleY(${H()})`; i++; timer=setTimeout(run,88); }
else { tag.textContent='synced'; set('Head reached. <b>No confirmed event silently skipped</b> — the guarantee behind every hoodkit stream.');
timer=setTimeout(()=>{ phase=0;i=0; reset(); set('Cursor advancing block by block, each range decoded and pushed before the head moves.'); tag.textContent='syncing'; timer=setTimeout(run,600); }, 3400); }
}
}
new IntersectionObserver(es=>es.forEach(e=>{ if(e.isIntersecting && !started){ started=true; run(); } }),{threshold:.3}).observe(host);
})();
/* ---------- copy buttons ---------- */
document.querySelectorAll('.copy').forEach(btn=>{
btn.addEventListener('click', ()=>{
const map = { install:'npm install hoodkit hoodchain viem', react:'npm install hoodkit react' };
navigator.clipboard.writeText(map[btn.dataset.copy]||'').then(()=>{
const t=btn.textContent; btn.textContent='COPIED'; setTimeout(()=>btn.textContent=t,1200);
}).catch(()=>{});
});
});
/* ---------- reveal on scroll ---------- */
const io = new IntersectionObserver((es)=>{ es.forEach(e=>{ if(e.isIntersecting){ e.target.classList.add('in'); io.unobserve(e.target);} }); },{threshold:.12});
document.querySelectorAll('.rise').forEach((el,i)=>{ el.style.transitionDelay=(i%3*70)+'ms'; io.observe(el); });
/* ---------- signal rail ---------- */
const stations=[...document.querySelectorAll('.rail .stn')];
const railSections=stations.map(a=>document.querySelector(a.getAttribute('href')));
const carriage=document.getElementById('carriage');
function updateRail(){
let idx=0, mid=innerHeight*0.4;
railSections.forEach((sec,i)=>{ const r=sec.getBoundingClientRect(); if(r.top<=mid) idx=i; });
stations.forEach((s,i)=>s.setAttribute('aria-current', i===idx));
const active=stations[idx], railRect=document.querySelector('.rail').getBoundingClientRect(), r=active.getBoundingClientRect();
carriage.style.height=r.height+'px'; carriage.style.transform=`translateY(${r.top-railRect.top}px)`;
}
stations.forEach(a=>a.addEventListener('click',e=>{ e.preventDefault(); document.querySelector(a.getAttribute('href')).scrollIntoView({behavior:'smooth'}); }));
addEventListener('scroll', ()=>requestAnimationFrame(updateRail), {passive:true});
addEventListener('resize', updateRail);
reflow(); updateRail();
</script>
</body>
</html>