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>hood-js: weigh the 4.55 kB Robinhood Chain wrapper</title>
<meta name="description" content="The five-lines-to-your-first-trade wrapper for Robinhood Chain (chain 4663). 4.55 kB gzipped, sideEffects:false, promise-first. Put it on a balance against your bundle budget and toggle imports to watch it tree-shake." />
<link rel="canonical" href="https://nirholas.github.io/hood-js/" />
<meta name="theme-color" content="#131313" />
<meta property="og:type" content="website" />
<meta property="og:title" content="hood-js: a library you can weigh" />
<meta property="og:description" content="One import to your first Robinhood Chain trade. 4.55 kB gzipped against a 15 kB budget. Toggle the exports you use and watch the balance tilt as it tree-shakes." />
<meta property="og:url" content="https://nirholas.github.io/hood-js/" />
<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='%23131313'/><path d='M16 6 V24 M8 24 H24 M6 12 H26' fill='none' stroke='%23f3f2ee' stroke-width='1.6'/><path d='M6 12 L3 18 H9 Z M26 12 L23 18 H29 Z' fill='none' stroke='%23f3f2ee' stroke-width='1.4'/></svg>" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"SoftwareApplication","name":"hood-js","applicationCategory":"DeveloperApplication","operatingSystem":"Node.js >= 20, browsers","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"description":"The five-lines-to-your-first-trade wrapper for Robinhood Chain (ID 4663). One import, sensible defaults, promise-first, browser + Node: stock prices, portfolios, trending memecoins, launch streams, and swaps. 4.55 kB gzipped.","softwareVersion":"0.1.0","author":{"@type":"Person","name":"nirholas","url":"https://x.com/nichxbt"},"downloadUrl":"https://www.npmjs.com/package/hood-js","codeRepository":"https://github.com/nirholas/hood-js"}
</script>
<style>
:root{
--ink:#131313; --paper:#f3f2ee; --graphite:#736f68; --steel:#adaaa2;
--hair:rgba(19,19,19,.12); --hair2:rgba(19,19,19,.28);
--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%;scroll-behavior:smooth}
@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}}
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"}
/* fine measurement grid, pure CSS */
body::before{content:""; position:fixed; inset:0; z-index:9999; pointer-events:none;
background:repeating-linear-gradient(0deg,rgba(19,19,19,.022) 0 1px,transparent 1px 4px);
mix-blend-mode:multiply; opacity:.6}
.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)}
.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:760px){.rail{width:0;border:0}.rail b,.rail .stn,.rail .carriage{display:none}main{margin-left:0}}
section{position:relative; padding:clamp(60px,9vh,120px) 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(38px,7vw,98px)}
h2{font-size:clamp(29px,5vw,62px)}
.lede{max-width:60ch; font-size:clamp(16px,1.6vw,22px); line-height:1.44; color:#242320}
/* ============ HERO / THE BALANCE ============ */
#weigh{min-height:100svh; display:grid; grid-template-columns:1.02fr 0.98fr; gap:clamp(28px,4vw,72px);
align-items:center; padding-top:clamp(56px,8vh,104px); padding-bottom:clamp(40px,6vh,72px)}
@media(max-width:940px){#weigh{grid-template-columns:1fr; align-items:start; gap:30px}}
.boot{font:500 12px/1.7 var(--mono); color:var(--graphite); letter-spacing:.03em; margin-bottom:18px}
@media(max-width:760px){.boot{font-size:10.5px}}
.boot span{display:inline-block; white-space:pre; opacity:0; animation:type .5s var(--ease) forwards}
@keyframes type{to{opacity:1}}
.herohead{max-width:14ch}
.herohead .lo{color:var(--graphite)}
.sub{margin-top:20px; max-width:44ch; font-size:clamp(15px,1.5vw,19px); color:#2a2925}
/* toggle grid = the interaction */
.imports{margin-top:26px}
.imports .cap{font:600 10px/1 var(--mono); letter-spacing:.2em; text-transform:uppercase; color:var(--graphite); margin-bottom:12px; display:flex; justify-content:space-between; align-items:center}
.grid{display:grid; grid-template-columns:repeat(2,1fr); gap:8px}
@media(max-width:420px){.grid{grid-template-columns:1fr}}
.tog{appearance:none; text-align:left; border:1px solid var(--hair2); background:transparent; color:var(--ink);
padding:11px 12px; cursor:pointer; position:relative; transition:border-color .25s,background .25s; overflow:hidden}
.tog:hover{border-color:var(--ink)}
.tog .nm{font:600 12px/1 var(--mono); letter-spacing:.02em; display:flex; align-items:center; gap:8px}
.tog .box{width:9px;height:9px;border:1px solid var(--hair2); flex:none; transition:all .25s}
.tog[aria-pressed="true"] .box{background:var(--ink); border-color:var(--ink)}
.tog .bar{margin-top:9px; height:3px; background:var(--hair2); position:relative; overflow:hidden}
.tog .bar i{position:absolute; inset:0; background:var(--ink); transform-origin:left; transition:transform .35s var(--ease)}
.tog[aria-pressed="false"]{opacity:.5}
.tog[aria-pressed="false"] .bar i{transform:scaleX(0)!important}
.tog .w{font:500 9.5px/1 var(--mono); color:var(--graphite); margin-top:6px; letter-spacing:.04em}
.tog.locked{cursor:default; opacity:1; border-style:dashed}
.tog.locked .box{background:var(--graphite); border-color:var(--graphite)}
.tog .need{position:absolute; top:9px; right:10px; font:600 8px/1 var(--mono); letter-spacing:.14em; color:var(--graphite); text-transform:uppercase}
.readbar{margin-top:18px; display:flex; flex-wrap:wrap; gap:20px; align-items:baseline; border-top:1px solid var(--hair); padding-top:16px}
.readbar .n{font:700 clamp(26px,3.4vw,40px)/1 var(--grot); letter-spacing:-.02em}
.readbar .n small{font:600 13px/1 var(--mono); color:var(--graphite); letter-spacing:.04em}
.readbar .lab{font:500 11px/1.4 var(--mono); color:var(--graphite); letter-spacing:.02em; max-width:20ch}
/* the scale svg */
.scalewrap{position:relative; align-self:center; display:flex; align-items:center; justify-content:center;
border:1px solid var(--hair2); background:linear-gradient(180deg,transparent,rgba(19,19,19,.02));
height:clamp(360px,66vh,560px); width:100%; padding:22px 18px}
@media(max-width:940px){.scalewrap{height:clamp(320px,52vh,460px)}}
.scalewrap svg{width:100%; height:100%; overflow:visible}
.scalewrap .cap2{position:absolute; left:14px; top:12px; font:600 9.5px/1 var(--mono); letter-spacing:.22em; text-transform:uppercase; color:var(--graphite)}
.scalewrap .verdict{position:absolute; left:14px; right:14px; bottom:12px; font:600 11px/1.4 var(--mono); letter-spacing:.02em; color:var(--ink)}
.sk-line{stroke:var(--ink); stroke-width:2.4; fill:none; stroke-linecap:round}
.sk-thin{stroke:var(--ink); stroke-width:1.2; fill:none; stroke-linecap:round}
.sk-hair{stroke:rgba(19,19,19,.35); stroke-width:1; fill:none}
.sk-fill{fill:var(--ink)}
.sk-txt{font-family:var(--mono); fill:var(--ink); font-weight:600}
.sk-txt.mut{fill:var(--graphite)}
/* generic blocks */
.cols{display:grid; grid-template-columns:1fr 1fr; gap:clamp(28px,5vw,80px); align-items:start}
@media(max-width:860px){.cols{grid-template-columns:1fr; gap:32px}}
.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)}
.code{border:1px solid var(--ink); background:var(--ink); color:var(--paper); padding:20px 22px;
font:500 13px/1.85 var(--mono); position:relative; overflow-x:auto; white-space:pre}
.code .c{color:#89857f} .code .k{color:#cfccc4} .code .s{color:#b9b6ae}
.copy{position:absolute; top:12px; right:12px; appearance:none; border:1px solid rgba(243,242,238,.26);
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(243,242,238,.14)}
/* API table */
.apit{border-top:1px solid var(--hair); margin-top:34px}
.apit .r{display:grid; grid-template-columns:220px 1fr 92px; gap:20px; padding:15px 0; border-bottom:1px solid var(--hair); align-items:baseline}
@media(max-width:640px){.apit .r{grid-template-columns:1fr; gap:5px}}
.apit .r .call{font:600 13px/1.4 var(--mono); letter-spacing:.01em; color:var(--ink)}
.apit .r .d{font-size:15px; color:#26241f; max-width:58ch}
.apit .r .wal{font:600 10px/1 var(--mono); letter-spacing:.14em; text-transform:uppercase; color:var(--graphite); text-align:right}
@media(max-width:640px){.apit .r .wal{text-align:left}}
.apit .r .wal.y{color:var(--ink)}
/* error codes */
.errs{display:grid; grid-template-columns:repeat(3,1fr); border-left:1px solid var(--hair); border-top:1px solid var(--hair); margin-top:32px}
@media(max-width:860px){.errs{grid-template-columns:repeat(2,1fr)}}
@media(max-width:480px){.errs{grid-template-columns:1fr}}
.errs .e{border-right:1px solid var(--hair); border-bottom:1px solid var(--hair); padding:18px 18px 22px; transition:background .3s}
.errs .e:hover{background:rgba(19,19,19,.03)}
.errs .e .code{font:700 13px/1 var(--mono); letter-spacing:.02em}
.errs .e .when{font-size:13.5px; color:#2c2925; line-height:1.4; margin-top:9px}
.fuse{display:grid; grid-template-columns:repeat(4,1fr); gap:14px; margin-top:14px}
@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 12.5px/1 var(--mono); letter-spacing:.06em; text-transform:uppercase; margin-bottom:9px}
.fuse .f .b{font-size:13.5px; color:#2c2925; line-height:1.45}
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}
@media(prefers-reduced-motion:reduce){.rise{opacity:1;transform:none}}
</style>
</head>
<body>
<nav class="rail" aria-label="Sections">
<b>hood·js</b>
<span class="carriage" id="carriage"></span>
<a class="stn" href="#weigh" aria-current="true">Weigh</a>
<a class="stn" href="#api">API</a>
<a class="stn" href="#errors">Errors</a>
<a class="stn" href="#browser">Browser</a>
<a class="stn" href="#get">Get it</a>
</nav>
<main>
<!-- ============ WEIGH / BALANCE ============ -->
<section id="weigh">
<div class="herotext">
<p class="boot mono" id="boot"></p>
<div class="eyebrow"><span class="n">00</span> / A LIBRARY YOU CAN WEIGH</div>
<h1 class="herohead">Five lines<br><span class="lo">to your first<br>trade.</span></h1>
<p class="sub">hood-js is the one-import wrapper for Robinhood Chain (ID 4663): prices, portfolios, trending coins, launch streams, swaps. It ships at <b>4.55 kB gzipped</b> and it's <span class="mono">sideEffects:false</span>, so your bundler drops everything you don't import. Toggle the exports you actually use and watch it tree-shake on the scale.</p>
<div class="imports">
<div class="cap"><span>imports · click to tree-shake</span><span id="selcount">10 / 10</span></div>
<div class="grid" id="grid"></div>
</div>
<div class="readbar">
<div class="n mono" id="kb">4.55<small> kB</small></div>
<div class="lab">modeled from the measured <b>4.55 kB</b> gzipped total ·<br>weighed against the <b>15 kB</b> budget hood-js sets itself</div>
</div>
</div>
<div class="scalewrap">
<div class="cap2">balance · gzip vs budget</div>
<svg id="scale" viewBox="0 0 440 300" role="img" aria-label="A balance scale weighing the selected hood-js bundle against its 15 kB budget. The lighter the selection, the higher the hood-js pan rises.">
<!-- stand -->
<line class="sk-line" x1="140" y1="286" x2="300" y2="286"/>
<line class="sk-thin" x1="220" y1="286" x2="220" y2="86"/>
<!-- fulcrum -->
<path class="sk-line" d="M220 74 L212 90 L228 90 Z"/>
<!-- beam -->
<line id="beam" class="sk-line" x1="70" y1="84" x2="370" y2="84"/>
<circle id="hub" class="sk-fill" cx="220" cy="84" r="4"/>
<!-- strings -->
<path id="strL" class="sk-hair" d="M70 84 L52 170 M70 84 L88 170"/>
<path id="strR" class="sk-hair" d="M370 84 L352 170 M370 84 L388 170"/>
<!-- left pan (hood-js) -->
<g id="panL">
<path class="sk-line" d="M40 172 Q70 202 100 172"/>
<text class="sk-txt mut" x="70" y="220" text-anchor="middle" font-size="9" letter-spacing="1">HOOD-JS</text>
<g id="discs"></g>
</g>
<!-- right pan (budget) -->
<g id="panR">
<path class="sk-line" d="M340 172 Q370 200 400 172"/>
<rect x="356" y="120" width="28" height="52" class="sk-line" fill="none"/>
<text class="sk-txt" x="370" y="150" text-anchor="middle" font-size="11">15</text>
<text class="sk-txt mut" x="370" y="216" text-anchor="middle" font-size="9" letter-spacing="1">BUDGET kB</text>
</g>
</svg>
<div class="verdict" id="verdict"></div>
</div>
</section>
<!-- ============ API ============ -->
<section id="api">
<div class="eyebrow"><span class="n">01</span> / ONE IMPORT, SENSIBLE DEFAULTS</div>
<div class="cols">
<div>
<h2>No RPC URL.<br>No ABI. No config.</h2>
<p class="lede" style="margin-top:22px">Public RPC by default. Every read call needs nothing at all: no wallet, no key. Only <code class="mono">swap</code> needs one. Every function is async and throws a single <code class="mono">HoodError</code> on failure, never a raw viem error. It wraps <a href="https://github.com/nirholas/robinhood-chain-sdk" style="border-bottom:1px solid var(--hair2)">hoodchain</a> the way <span class="mono">axios</span> wraps <span class="mono">http</span>.</p>
<div class="btns">
<a class="btn solid" href="https://www.npmjs.com/package/hood-js">npm</a>
<a class="btn" href="https://github.com/nirholas/hood-js">source</a>
</div>
</div>
<div>
<div class="code"><button class="copy" data-copy="qs">COPY</button><span class="k">import</span> hood <span class="k">from</span> <span class="s">'hood-js'</span>
<span class="k">const</span> { usd } = <span class="k">await</span> hood.price(<span class="s">'AAPL'</span>)
<span class="k">const</span> top = <span class="k">await</span> hood.coins({ limit: 5 })
<span class="k">const</span> q = <span class="k">await</span> hood.quote({
sell: <span class="s">'USDG'</span>, buy: <span class="s">'WETH'</span>, amount: 100 })
<span class="c">// spread the quote straight into swap()</span>
<span class="k">const</span> { url } = <span class="k">await</span> hood.swap({ ...q, wallet })</div>
</div>
</div>
<div class="apit" id="apit"></div>
</section>
<!-- ============ ERRORS ============ -->
<section id="errors">
<div class="eyebrow"><span class="n">02</span> / ONE ERROR TYPE, STABLE CODES</div>
<h2>Every failure is a<br>HoodError.</h2>
<p class="lede" style="margin-top:22px">Plain-language <code class="mono">message</code>, a stable <code class="mono">code</code> you can branch on, and the original error on <code class="mono">cause</code>. Never a raw viem stack. A batched <code class="mono">prices()</code> never fails wholesale over one bad ticker: unpriced symbols come back <code class="mono">null</code>, only a single <code class="mono">price()</code> throws.</p>
<div class="errs" id="errs"></div>
</section>
<!-- ============ BROWSER ============ -->
<section id="browser">
<div class="eyebrow"><span class="n">03</span> / BROWSER & NODE, SAME IMPORT</div>
<div class="cols">
<div>
<h2>Runs from a<br>script tag.</h2>
<p class="lede" style="margin-top:22px">A plain <code class="mono"><script type="module"></code> against any ESM CDN, no bundler required. For <code class="mono">swap()</code> in the browser, pass <code class="mono">window.ethereum</code> (or any EIP-1193 provider) as the wallet and hood-js drives it directly. In Node, pass a <code class="mono">0x</code> private key read from an env var.</p>
<div class="fuse">
<div class="f"><div class="h">Chainlink</div><div class="b">Live Stock Token prices, multiplier-correct via ERC-8056.</div></div>
<div class="f"><div class="h">GeckoTerminal</div><div class="b">Trending memecoin stats, no key required.</div></div>
<div class="f"><div class="h">Uniswap v3</div><div class="b">Fee-tier probing + two-hop routing for the best output.</div></div>
<div class="f"><div class="h">Testnet</div><div class="b"><code>hood.testnet()</code> switches every call to chain 46630.</div></div>
</div>
</div>
<div>
<div class="code"><button class="copy" data-copy="cdn">COPY</button><span class="c"><!-- no build step --></span>
<span class="k"><script</span> type=<span class="s">"module"</span><span class="k">></span>
<span class="k">import</span> hood <span class="k">from</span>
<span class="s">'https://esm.sh/hood-js'</span>
<span class="k">const</span> { usd } = <span class="k">await</span> hood.price(<span class="s">'AAPL'</span>)
document.body.textContent = <span class="s">`AAPL: $${usd}`</span>
<span class="k"></script></span></div>
<p class="sub" style="margin-top:18px; max-width:none; font-size:13px; color:var(--graphite)"><b style="color:var(--ink)">Stock Token eligibility.</b> Stock Tokens are tokenized debt securities (issuer: Robinhood Assets (Jersey) Ltd) and may not be offered or sold to US persons (also Canada, UK, Switzerland). Buying one throws <span class="mono">NEEDS_ELIGIBILITY</span> until you acknowledge eligibility; reading, holding, and selling are never gated. Memecoins are never gated.</p>
</div>
</div>
</section>
<!-- ============ GET ============ -->
<section id="get">
<div class="eyebrow"><span class="n">04</span> / GET IT</div>
<div class="cols">
<div>
<h2>Install, and<br>you're trading.</h2>
<p class="lede" style="margin-top:22px"><code class="mono">viem</code> is the only peer. Read calls run against the public RPC out of the box. The quickstart below is verbatim what ships in the repo root as <code class="mono">quickstart.mjs</code>.</p>
<div class="btns">
<a class="btn solid" href="https://github.com/nirholas/hood-js#readme">read the docs</a>
<a class="btn" href="https://github.com/nirholas/robinhood-chain-sdk">hoodchain</a>
</div>
</div>
<div>
<div class="code"><button class="copy" data-copy="get">COPY</button><span class="c"># Node >= 20, or any modern browser</span>
<span class="s">$</span> npm install hood-js viem
<span class="c"># run the shipped quickstart verbatim</span>
<span class="s">$</span> node quickstart.mjs
<span class="c"># own code: 4.55 kB gzipped (budget 15)</span>
<span class="s">$</span> npm run build && npm run size</div>
</div>
</div>
</section>
<footer>
<div class="big">hood-<br>js</div>
<div class="meta">
4.55 kB gzipped · sideEffects:false · Node & browser<br>
<a href="https://github.com/nirholas/hood-js">github.com/nirholas/hood-js</a><br>
<a href="https://www.npmjs.com/package/hood-js">npmjs.com/package/hood-js</a><br>
built by <a href="https://x.com/nichxbt">@nichxbt</a> · not affiliated with Robinhood Markets
</div>
</footer>
</main>
<script>
"use strict";
const reduce = matchMedia('(prefers-reduced-motion:reduce)').matches;
/* ---------- boot ---------- */
(function(){
const el=document.getElementById('boot');
const line='● hood-js 0.1.0 · chain 4663 · 4.55 kB gzipped · sideEffects:false';
[...line].forEach((ch,i)=>{const s=document.createElement('span');s.textContent=ch;s.style.animationDelay=(reduce?0:i*12+100)+'ms';el.appendChild(s);});
})();
/* ---------- copy ---------- */
document.querySelectorAll('.copy').forEach(btn=>{
const map={
qs:"import hood from 'hood-js'\nconst { usd } = await hood.price('AAPL')",
cdn:"import hood from 'https://esm.sh/hood-js'",
get:'npm install hood-js viem'
};
btn.addEventListener('click',()=>{navigator.clipboard&&navigator.clipboard.writeText(map[btn.dataset.copy]||'').then(()=>{const t=btn.textContent;btn.textContent='COPIED';setTimeout(()=>btn.textContent=t,1200);}).catch(()=>{});});
});
/* ---------- reveal (observer defined here; observed after dynamic rows exist) ---------- */
const io=new IntersectionObserver(es=>{es.forEach(e=>{if(e.isIntersecting){e.target.classList.add('in');io.unobserve(e.target);}});},{threshold:.12});
function observeRises(){ document.querySelectorAll('.rise:not([data-obs])').forEach((el,i)=>{el.dataset.obs='1';el.style.transitionDelay=(i%3*60)+'ms';io.observe(el);}); }
/* ---------- rail ---------- */
const stations=[...document.querySelectorAll('.rail .stn')];
const secs=stations.map(a=>document.querySelector(a.getAttribute('href')));
const carriage=document.getElementById('carriage');
function updateRail(){
let idx=0,mid=innerHeight*0.4;
secs.forEach((s,i)=>{const r=s.getBoundingClientRect();if(r.top<=mid)idx=i;});
stations.forEach((s,i)=>s.setAttribute('aria-current',i===idx));
const a=stations[idx],railR=document.querySelector('.rail').getBoundingClientRect(),r=a.getBoundingClientRect();
carriage.style.height=r.height+'px';carriage.style.transform=`translateY(${r.top-railR.top}px)`;
}
stations.forEach(a=>a.addEventListener('click',e=>{e.preventDefault();document.querySelector(a.getAttribute('href')).scrollIntoView({behavior:reduce?'auto':'smooth'});}));
addEventListener('scroll',()=>requestAnimationFrame(updateRail),{passive:true});
addEventListener('resize',updateRail);updateRail();
/* ---------- API table ---------- */
const API=[
['hood.price(symbol)','Live Chainlink price for one Stock Token.',false],
['hood.prices([symbols])','The same, batched into one multicall; unpriced come back null.',false],
['hood.portfolio(address)','Multiplier-correct, USD-valued positions (ERC-8056 shares).',false],
['hood.coins({ limit, window })','Live memecoin prices + 24h stats across launchpads + Uniswap.',false],
['hood.launches({ live }, cb?)','Recent launches, or a live on-chain stream you can unwatch.',false],
['hood.quote({ sell, buy, amount })','Best Uniswap v3 route across fee tiers + two-hop paths.',false],
['hood.swap({ ...quote, wallet })','Executes it; returns hash, url, amounts, status.',true],
['hood.config({ rpcUrl, ... })','Chainable overrides: RPC, Alchemy key, eligibility.',false],
['hood.testnet() / .mainnet()','Switch every subsequent call between 4663 and 46630.',false],
];
const apit=document.getElementById('apit');
API.forEach(a=>{
const r=document.createElement('div'); r.className='r rise';
r.innerHTML=`<div class="call mono">${a[0]}</div><div class="d">${a[1]}</div><div class="wal ${a[2]?'y':''}">${a[2]?'wallet':'no wallet'}</div>`;
apit.appendChild(r);
});
/* ---------- error codes ---------- */
const ERR=[
['UNKNOWN_SYMBOL',"Ticker isn't a canonical Stock Token."],
['NO_FEED','Token exists but has no live Chainlink feed.'],
['STALE_PRICE','Feed answer older than the staleness window (72h default).'],
['BAD_PRICE','Feed returned a non-positive or incomplete answer.'],
['NO_ROUTE','No swappable Uniswap v3 route between the two tokens.'],
['NEEDS_WALLET','swap() called with no wallet.'],
['NEEDS_ELIGIBILITY','Buying a Stock Token without acknowledging eligibility.'],
['BAD_INPUT','An argument is malformed, caught before any network call.'],
['NETWORK',"Couldn't reach the chain or GeckoTerminal."],
];
const errs=document.getElementById('errs');
ERR.forEach(e=>{const d=document.createElement('div');d.className='e rise';d.innerHTML=`<div class="code mono">${e[0]}</div><div class="when">${e[1]}</div>`;errs.appendChild(d);});
/* now that all .rise rows exist, start observing them */
observeRises();
/* =========================================================
THE BALANCE / signature interaction
Left pan = selected hood-js bundle (modeled shares of the
real 4.55 kB gzipped total). Right pan = the 15 kB budget.
Toggling exports tree-shakes the bundle: the pan rises.
Geometry is recomputed each rAF; a spring eases the tilt.
========================================================= */
const BASE=0.20; // runtime client + HoodError, always shipped
const EXPORTS=[
['price',0.30,false],['prices',0.20,false],['portfolio',0.55,false],
['coins',0.65,false],['launches',0.60,false],['quote',0.85,false],
['swap',0.95,true],['config',0.15,false],['testnet/mainnet',0.10,false],
];
const FULL=BASE+EXPORTS.reduce((s,e)=>s+e[1],0); // = 4.55
const state=EXPORTS.map(()=>true);
const grid=document.getElementById('grid');
const selcount=document.getElementById('selcount');
const kbEl=document.getElementById('kb');
const verdict=document.getElementById('verdict');
const discs=document.getElementById('discs');
// locked base chip
const base=document.createElement('div'); base.className='tog locked';
base.innerHTML=`<div class="nm"><span class="box"></span>runtime + HoodError</div><div class="bar"><i style="transform:scaleX(${BASE/0.95})"></i></div><div class="w">${BASE.toFixed(2)} kB · always shipped</div>`;
grid.appendChild(base);
EXPORTS.forEach((e,i)=>{
const b=document.createElement('button'); b.className='tog'; b.type='button'; b.setAttribute('aria-pressed','true');
b.innerHTML=`<div class="nm"><span class="box"></span>${e[0]}</div>${e[2]?'<span class="need">wallet</span>':''}<div class="bar"><i style="transform:scaleX(${e[1]/0.95})"></i></div><div class="w">${e[1].toFixed(2)} kB modeled</div>`;
b.addEventListener('click',()=>{ state[i]=!state[i]; b.setAttribute('aria-pressed',state[i]); recompute(); });
grid.appendChild(b);
});
let selKB=FULL, target=0, angle=0, raf=null;
function computeKB(){
let kb=BASE, n=0;
EXPORTS.forEach((e,i)=>{ if(state[i]){ kb+=e[1]; n++; } });
return {kb, n};
}
function recompute(){
const {kb,n}=computeKB();
selKB=kb;
kbEl.innerHTML=`${kb.toFixed(2)}<small> kB</small>`;
selcount.textContent=`${n} / ${EXPORTS.length}`;
const pct=Math.round((kb/15)*100);
verdict.textContent=`${kb.toFixed(2)} kB of the 15 kB budget · ${(15-kb).toFixed(2)} kB headroom (${pct}%)`;
// discs on left pan: one stacked plate per selected export, width scaled by weight
discs.innerHTML='';
const cx=70, baseY=194; let k=0;
EXPORTS.forEach((e,i)=>{ if(!state[i])return;
const w=12+e[1]*17; const rectY=baseY-(k*6);
discs.insertAdjacentHTML('beforeend',`<rect x="${(cx-w/2).toFixed(1)}" y="${(rectY-5).toFixed(1)}" width="${w.toFixed(1)}" height="5" rx="1.4" fill="none" stroke="#131313" stroke-width="1.1"/>`);
k++;
});
// target tilt: lighter selection (less kB) → hood-js pan rises higher (bigger positive angle)
target = 0.045 + (1 - kb/FULL) * 0.12; // radians, ~2.6deg .. ~9.4deg
if(reduce){ angle=target; layout(); return; }
if(!raf) raf=requestAnimationFrame(tick);
}
function tick(){
angle += (target-angle)*0.16;
layout();
if(Math.abs(target-angle)>0.0004){ raf=requestAnimationFrame(tick); }
else { angle=target; layout(); raf=null; }
}
const CX=220, CY=84, ARM=150, HANG=86;
const beam=document.getElementById('beam'), hub=document.getElementById('hub');
const strL=document.getElementById('strL'), strR=document.getElementById('strR');
const panL=document.getElementById('panL'), panR=document.getElementById('panR');
// pans authored around left(70,~172) and right(370,~172) at level; translate them by delta.
function layout(){
const s=Math.sin(angle), c=Math.cos(angle);
const lx=CX-c*ARM, ly=CY-s*ARM; // left end (rises: angle>0 → ly<CY)
const rx=CX+c*ARM, ry=CY+s*ARM; // right end (sinks)
beam.setAttribute('x1',lx.toFixed(1)); beam.setAttribute('y1',ly.toFixed(1));
beam.setAttribute('x2',rx.toFixed(1)); beam.setAttribute('y2',ry.toFixed(1));
// strings from ends to pan tops (pan authored top ~172)
const lpx=70, rpx=370; // pan x stays fixed (hangs vertically)
const lpy=ly+HANG, rpy=ry+HANG;
strL.setAttribute('d',`M${lx.toFixed(1)} ${ly.toFixed(1)} L${lpx-18} ${lpy.toFixed(1)} M${lx.toFixed(1)} ${ly.toFixed(1)} L${lpx+18} ${lpy.toFixed(1)}`);
strR.setAttribute('d',`M${rx.toFixed(1)} ${ry.toFixed(1)} L${rpx-18} ${rpy.toFixed(1)} M${rx.toFixed(1)} ${ry.toFixed(1)} L${rpx+18} ${rpy.toFixed(1)}`);
panL.setAttribute('transform',`translate(0 ${(ly+HANG-172).toFixed(1)})`);
panR.setAttribute('transform',`translate(0 ${(ry+HANG-172).toFixed(1)})`);
}
recompute();
</script>
</body>
</html>