openzoo 0.51.4 → 0.51.6

package/transmute/site/.env.production

@@ -1,2 +0,0 @@
-SITE_NAME=openzoo-transmute
-SITE_VERSION=1.0.0

package/transmute/site/api/echo.js

@@ -1,10 +0,0 @@
-// App-router style handler with a JSON body. Bodies ride inside the
-// transaction, so they are small (see /.zoo/status for the exact budget).
-export async function POST(request) {
-  const body = await request.json();
-  const keys = Object.keys(body);
-  return Response.json({ echo: body, keys, count: keys.length }, { status: 201, headers: { 'x-echo-count': String(keys.length) } });
-}
-export function GET() {
-  return new Response('POST a JSON body here', { status: 200, headers: { 'content-type': 'text/plain' } });
-}

package/transmute/site/api/hello.js

@@ -1,12 +0,0 @@
-// A Vercel-node function (pages/api style). On chain this is route 0 of the
-// site program; the gateway answers it with a free simulateTransaction.
-export default function handler(req, res) {
-  const name = req.query.name || 'anon';
-  res.status(200).json({
-    hello: name,
-    from: 'a Pinocchio program on Solana',
-    method: req.method,
-    site: process.env.SITE_NAME,
-    ua: req.headers['user-agent'] || null,
-  });
-}

package/transmute/site/api/hits.js

@@ -1,13 +0,0 @@
-// @vercel/kv on PDAs. GET reads (free simulation); POST increments (a signed
-// transaction — the gateway discovers the KV account by dry-run and pays rent
-// on first write).
-import { kv } from '@vercel/kv';
-
-export default async function handler(req, res) {
-  if (req.method === 'POST') {
-    const hits = await kv.incr('hits');
-    return res.status(200).json({ hits, wrote: true });
-  }
-  const hits = (await kv.get('hits')) || 0;
-  res.status(200).json({ hits, wrote: false });
-}

package/transmute/site/api/time.js

@@ -1,5 +0,0 @@
-// Date.now() is the cluster clock; there is no wall clock in a program.
-export default function handler(req, res) {
-  res.setHeader('cache-control', 'no-store');
-  res.status(200).json({ now: Date.now(), iso: new Date().toISOString(), note: 'from the Clock sysvar of the slot the read was simulated in' });
-}

package/transmute/site/package.json

@@ -1,6 +0,0 @@
-{
-  "name": "openzoo-transmute-site",
-  "private": true,
-  "description": "The explainer for openzoo-transmute, itself a transmuted Vercel-shaped app: static frontend in asset accounts, /api/* as a Pinocchio program.",
-  "version": "1.0.0"
-}

package/transmute/site/public/app.js

@@ -1,16 +0,0 @@
-const out = (id, v) => { document.getElementById(id).textContent = typeof v === 'string' ? v : JSON.stringify(v, null, 2); };
-async function call(id, url, init) {
-  out(id, '…');
-  try {
-    const r = await fetch(url, init);
-    const sim = r.headers.get('x-zoo-simulated'), cu = r.headers.get('x-zoo-cu'), sig = r.headers.get('x-zoo-signature');
-    let body; try { body = await r.json(); } catch { body = await r.text(); }
-    out(id, { status: r.status, simulated: sim, computeUnits: cu, signature: sig, body });
-  } catch (e) { out(id, 'error: ' + e.message); }
-}
-document.getElementById('hello').onclick = () => call('o-hello', '/api/hello?name=' + encodeURIComponent(document.getElementById('name').value || 'anon'));
-document.getElementById('hits-get').onclick = () => call('o-hits', '/api/hits');
-document.getElementById('hits-post').onclick = () => call('o-hits', '/api/hits', { method: 'POST' });
-document.getElementById('time').onclick = () => call('o-time', '/api/time');
-document.getElementById('echo').onclick = () => call('o-echo', '/api/echo', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ a: 1, b: 'two' }) });
-fetch('/.zoo/status').then((r) => r.json()).then((s) => out('o-status', s)).catch(() => {});

package/transmute/site/public/index.html

@@ -1,96 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<title>openzoo-transmute · a Vercel app running on Solana</title>
-<style>
-:root{color-scheme:light dark;font-family:ui-sans-serif,system-ui,sans-serif}
-body{max-width:52rem;margin:2rem auto;padding:0 1rem;line-height:1.5}
-h1{font-size:1.7rem;margin:.2rem 0}h2{font-size:1.15rem;margin-top:2rem}
-.muted{opacity:.7}code,pre{font-size:.88em}pre{background:#8881;padding:.7rem;border-radius:.4rem;overflow:auto;white-space:pre-wrap}
-table{border-collapse:collapse;width:100%;font-size:.92rem}td,th{padding:.3rem .5rem;border-bottom:1px solid #8883;text-align:left;vertical-align:top}
-button{padding:.4rem .8rem;font:inherit;border:1px solid #8886;border-radius:.4rem;background:#3b82f6;color:#fff;cursor:pointer;margin:.2rem .2rem .2rem 0}
-input{padding:.4rem .6rem;font:inherit;border:1px solid #8884;border-radius:.4rem;background:transparent;color:inherit}
-.demo{border:1px solid #8883;border-radius:.5rem;padding:.8rem;margin:.8rem 0}
-</style>
-</head>
-<body>
-<h1>This page is on Solana.</h1>
-<p class="muted">You are reading bytes out of a Solana account. Every button below runs a function that was a Vercel Lambda and is now an instruction of a Pinocchio program. No server holds this site.</p>
-
-<h2>What you are looking at</h2>
-<p><b>openzoo-transmute</b> takes an app shaped for Vercel (Next.js <code>pages/api</code>, the app router's <code>route.ts</code>, or a Vite repo with <code>api/*.js</code>) and re-hosts it on Solana mainnet:</p>
-<table>
-<tr><th>Vercel term</th><th>Solana term</th></tr>
-<tr><td>Lambda (<code>*.func</code>)</td><td>a route in one Pinocchio program (Rust, generated from your handler)</td></tr>
-<tr><td>node-bridge Invoke event <code>{method, path, headers, body}</code></td><td>instruction data</td></tr>
-<tr><td>bridge response <code>{statusCode, headers, body}</code></td><td>return data + log chunks</td></tr>
-<tr><td>GET</td><td><code>simulateTransaction</code> — free, no signature</td></tr>
-<tr><td>POST / PUT / DELETE</td><td>a signed transaction</td></tr>
-<tr><td><code>@vercel/kv</code></td><td>program-derived accounts, discovered by dry run</td></tr>
-<tr><td><code>static/</code></td><td>asset accounts (this HTML is one)</td></tr>
-<tr><td><code>environment</code></td><td>baked into the program at build time</td></tr>
-<tr><td><code>maxDuration</code>, <code>memory</code></td><td>compute-unit limit, heap frame</td></tr>
-<tr><td>deployment URL</td><td>a program id + any gateway (this one, or <code>npx openzoo serve</code> on your laptop)</td></tr>
-</table>
-
-<h2>Try the functions</h2>
-<div class="demo"><b>/api/hello</b> — <code>req.query</code>, <code>process.env</code>, headers<br>
-<input id="name" placeholder="your name" value="zoo"> <button id="hello">GET /api/hello</button><pre id="o-hello"></pre></div>
-<div class="demo"><b>/api/hits</b> — <code>@vercel/kv</code> counter. GET is a free simulation; POST is a real transaction (needs a signer: run the local gateway with your wallet, or wait for the x402 lane).<br>
-<button id="hits-get">GET /api/hits</button> <button id="hits-post">POST /api/hits</button><pre id="o-hits"></pre></div>
-<div class="demo"><b>/api/time</b> — <code>Date.now()</code> is the cluster clock<br><button id="time">GET /api/time</button><pre id="o-time"></pre></div>
-<div class="demo"><b>/api/echo</b> — app-router <code>POST(request)</code> with <code>await request.json()</code>, answers 201<br><button id="echo">POST /api/echo</button><pre id="o-echo"></pre></div>
-
-<h2>Capabilities, side by side</h2>
-<p class="muted">Vercel the platform vs openzoo-transmute today. Honest, not flattering.</p>
-<table>
-<tr><th>Capability</th><th>Vercel</th><th>openzoo-transmute (Solana)</th></tr>
-<tr><td>Static hosting</td><td>CDN, any size</td><td>yes: files in accounts, read by any gateway; rent ~7 SOL per MB, so KBs not MBs</td></tr>
-<tr><td>Serverless functions</td><td>Node, Edge, Python, Go, Ruby…</td><td>JS/TS handlers only, compiled to a Rust subset</td></tr>
-<tr><td>Framework support</td><td>Next.js (full: SSR, RSC, ISR), 40+ frameworks</td><td>Next.js <code>pages/api</code> + app-router <code>route.ts</code>, Vite/static + <code>api/</code>; no SSR, no React Server Components, no ISR</td></tr>
-<tr><td>Language coverage</td><td>everything</td><td>expressions, control flow, strings/arrays/objects, JSON, <code>@vercel/kv</code>, <code>Date.now</code>, <code>process.env</code>; no npm packages, regex, classes, generators, closures over mutable state</td></tr>
-<tr><td>Outbound network</td><td><code>fetch</code> anything</td><td>none. A program cannot make HTTP calls</td></tr>
-<tr><td>Databases</td><td>Postgres, KV, Blob, any external DB</td><td>KV on program-derived accounts (10 KB values, public); cross-program reads possible in principle, not exposed</td></tr>
-<tr><td>Secrets</td><td>encrypted env vars</td><td>none. Env is baked into public bytecode</td></tr>
-<tr><td>Auth</td><td>anything (cookies, JWT, OAuth)</td><td>wallet signatures are the identity; no server secret, so no sessions/JWT</td></tr>
-<tr><td>Streaming / SSE / WebSockets</td><td>yes</td><td>no. One request = one transaction, ~8 KB response</td></tr>
-<tr><td>Request size</td><td>4.5 MB</td><td>~900 bytes body</td></tr>
-<tr><td>Execution limits</td><td>10–800 s, up to 4 GB</td><td>200k–1.4M compute units (~1–5 ms of CPU), 256 KB heap</td></tr>
-<tr><td>Randomness / time</td><td>yes</td><td>no <code>Math.random</code> (deterministic); time = slot clock</td></tr>
-<tr><td>Background work (<code>waitUntil</code>, queues, cron)</td><td>yes</td><td>no</td></tr>
-<tr><td>Middleware / edge</td><td>yes</td><td>no (gateway does routing/rewrites/redirects from <code>vercel.json</code>)</td></tr>
-<tr><td>Image optimization</td><td>yes</td><td>no</td></tr>
-<tr><td>Domains / TLS</td><td>built in</td><td>via a gateway host (this one or your own); the chain has no HTTP</td></tr>
-<tr><td>Previews / rollbacks / git integration</td><td>yes</td><td>no. Each deploy updates the site's accounts in place (or, with a dedicated program, upgrades it)</td></tr>
-<tr><td>Observability</td><td>logs, analytics, tracing</td><td>transaction logs, compute-unit counts, block explorers</td></tr>
-<tr><td>Latency</td><td>~50–300 ms</td><td>reads 300–800 ms, writes 1–3 s</td></tr>
-<tr><td>Read cost</td><td>metered</td><td>free, unlimited, no account needed</td></tr>
-<tr><td>Write cost</td><td>free</td><td>~0.000005 SOL per transaction + rent for new state; a signer is required (your wallet, a bounded hub signer, or x402 pay-per-write once built)</td></tr>
-<tr><td>Deploy cost</td><td>free tier</td><td>rent up front: ~0.03–0.1 SOL for a small app on the shared <code>zoo-vm</code> runtime (this site: 0.095 SOL); ~1 SOL+ with a dedicated program per site</td></tr>
-<tr><td>Toolchain</td><td>node</td><td>node only on the shared runtime (bytecode, no cargo); node + Rust + <code>cargo-build-sbf</code> for a dedicated program</td></tr>
-<tr><td>Who can take it down</td><td>Vercel, DNS, a card on file</td><td>nobody, if the upgrade authority is burned; any RPC + any gateway serves it</td></tr>
-<tr><td>Verifiability</td><td>trust the platform</td><td>the code and every state change are public and replayable</td></tr>
-<tr><td>Composability</td><td>HTTP APIs</td><td>other programs and wallets can call your routes as instructions</td></tr>
-<tr><td>Permanence</td><td>until the bill stops</td><td>until the rent is withdrawn; rent-exempt accounts persist indefinitely</td></tr>
-</table>
-<p>Summary: it is a permanent, permissionless, verifiable host for small stateful APIs and static frontends, not a general web platform. If your app needs the network, secrets, streaming, or heavy compute, it stays on Vercel; if what it needs is to exist forever and be readable by anyone for free, it belongs here.</p>
-
-<h2>Put your own app here</h2>
-<pre>npx openzoo inspect .                       # your app, in Vercel terms + what is eligible
-npx openzoo build .                         # Rust program + asset plan (needs cargo-build-sbf)
-npx openzoo deploy . --cluster mainnet --runtime &lt;zoo-vm id&gt; --yes   # rent quoted first; paid by ~/.openzoo/wallet.json
-# → https://sites.openzoo.fun/s/&lt;programId&gt;
-npx openzoo serve &lt;programId&gt;                # local gateway that signs writes with your wallet</pre>
-<p class="muted">Eligible today: handlers using query/body/headers, JSON, string and array methods, <code>@vercel/kv</code>, <code>Date.now()</code>, <code>process.env</code>. Not eligible: network calls, the filesystem, <code>Math.random</code>, streaming, <code>waitUntil</code>, ISR, middleware. Bodies must fit in one transaction (~900 bytes), responses in the log buffer (~8 KB). Reads are free; writes cost a transaction fee plus rent for new KV accounts.</p>
-
-<h2>Where this is going</h2>
-<p>Writes through the hosted gateway will be paid per request over x402 from the openzoo proxy, at twice cost; adding a site costs a 0.1 SOL dev fee and updating one 0.05 SOL, and those fees are swapped half into TOKEN and paired as SOL/TOKEN liquidity on PumpSwap. A <code>sol://</code> scheme in a browser fork makes the gateway optional.</p>
-
-<h2>This deployment</h2>
-<pre id="o-status" class="muted">loading /.zoo/status…</pre>
-<p class="muted">Source: <code>openzoo-transmute/site</code> in <a href="https://github.com/staccDOTsol/leCore">staccDOTsol/leCore</a> · the transmuter's own docs are in <code>docs/VERCEL_TO_SOLANA.md</code>.</p>
-<script src="/app.js"></script>
-</body>
-</html>