diff --git a/apps/site/.gitignore b/apps/site/.gitignore
index 5047651..79baa44 100644
--- a/apps/site/.gitignore
+++ b/apps/site/.gitignore
@@ -18,3 +18,7 @@ yarn-debug.log*
 .DS_Store
 .env.local
 .env*.local
+.source
+
+# T1 migration temp backup of TSX docs pages
+_docs_old_tsx_backup/
diff --git a/apps/site/app/api/search/route.ts b/apps/site/app/api/search/route.ts
new file mode 100644
index 0000000..d86bfc5
--- /dev/null
+++ b/apps/site/app/api/search/route.ts
@@ -0,0 +1,4 @@
+import { source } from "@/lib/source";
+import { createFromSource } from "fumadocs-core/search/server";
+
+export const { GET } = createFromSource(source);
diff --git a/apps/site/app/docs/[[...slug]]/page.tsx b/apps/site/app/docs/[[...slug]]/page.tsx
new file mode 100644
index 0000000..d81e90e
--- /dev/null
+++ b/apps/site/app/docs/[[...slug]]/page.tsx
@@ -0,0 +1,95 @@
+import { notFound } from "next/navigation";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import type { Metadata } from "next";
+import type { ComponentType } from "react";
+import { source } from "@/lib/source";
+import { DocPage } from "@/components/docs/doc-page";
+import { CopyPageButton } from "@/components/docs/copy-page-button";
+import { getMDXComponents } from "@/lib/mdx-components";
+
+type Props = { params: Promise<{ slug?: string[] }> };
+
+// The frontmatter schema (defined in source.config.ts) doesn't flow into source.getPage().data
+// as typed fields — fumadocs surfaces them as `unknown` by default. This interface is the
+// runtime shape we know exists.
+interface DocFrontmatter {
+  title: string;
+  description?: string;
+  importLine?: string;
+  breadcrumb?: string[];
+  prev?: { href: string; label: string };
+  next?: { href: string; label: string };
+  body: ComponentType<{ components: ReturnType<typeof getMDXComponents> }>;
+  toc: Array<{ url: string; title: unknown; depth: number }>;
+}
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const { slug } = await params;
+  const page = source.getPage(slug);
+  if (!page) return {};
+  const data = page.data as unknown as DocFrontmatter;
+  return {
+    title: `${data.title} — cdr-kit`,
+    description: data.description,
+  };
+}
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export default async function Page({ params }: Props) {
+  const { slug } = await params;
+  const page = source.getPage(slug);
+  if (!page) notFound();
+
+  const data = page.data as unknown as DocFrontmatter;
+  const MDX = data.body;
+
+  // Map fumadocs TOC ({ url: "#id", title, depth }) → DocTocItem ({ id, label }).
+  // Only h2/h3 land in the right rail to match the existing scrollspy density.
+  const tocItems = data.toc
+    .filter((node) => node.depth <= 3)
+    .map((node) => ({
+      id: node.url.replace(/^#/, ""),
+      label: typeof node.title === "string" ? node.title : "",
+    }));
+
+  // Raw MDX for the per-page Copy button. Server-read once; passed as a string
+  // to the client component so there's no extra fetch round-trip. The MDX file
+  // path is derived from the URL: /docs/components/x → content/docs/components/x.mdx;
+  // /docs → content/docs/index.mdx.
+  let rawMarkdown = "";
+  try {
+    const rel = page.url.replace(/^\/docs\/?/, "") || "index";
+    const mdxPath = join(process.cwd(), "content/docs", `${rel}.mdx`);
+    rawMarkdown = readFileSync(mdxPath, "utf-8");
+  } catch (err) {
+    // Surface but don't crash — the page itself is already rendered via fumadocs
+    // page.data.body; the Copy button just degrades to an empty payload.
+    console.warn(`[docs] Failed to read raw MDX for ${page.url}:`, (err as Error).message);
+  }
+
+  return (
+    <DocPage
+      data={{
+        breadcrumb: data.breadcrumb ?? [],
+        title: data.title,
+        badges: <CopyPageButton markdown={rawMarkdown} />,
+        lede: data.description ?? "",
+        importLine: data.importLine,
+        prev: data.prev,
+        next: data.next,
+        sections: [
+          {
+            id: "content",
+            title: "",
+            content: <MDX components={getMDXComponents()} />,
+          },
+        ],
+      }}
+      tocItems={tocItems}
+    />
+  );
+}
diff --git a/apps/site/app/docs/agent-kit/agentkit/page.tsx b/apps/site/app/docs/agent-kit/agentkit/page.tsx
deleted file mode 100644
index 138fb1d..0000000
--- a/apps/site/app/docs/agent-kit/agentkit/page.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `import { CdrAgent } from "@cdr-kit/agent";
-import { cdrActionProvider } from "@cdr-kit/agentkit";
-
-const agent = new CdrAgent({ privateKey, apiUrl });
-// Slot into Coinbase AgentKit's action providers:
-const provider = cdrActionProvider(agent);`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit", "Coinbase AgentKit"],
-        title: "Coinbase AgentKit adapter",
-        badges: <Badge tone="primary">@cdr-kit/agentkit</Badge>,
-        lede: <>Coinbase AgentKit <code>ActionProvider</code> exposing the three CDR tools as on-chain actions.</>,
-        importLine: 'import { cdrActionProvider } from "@cdr-kit/agentkit"',
-        sections: [{ id: "usage", title: "Usage", content: <CodePanel title="agentkit.ts" code={CODE} /> }],
-        prev: { href: "/docs/agent-kit/langchain", label: "LangChain" },
-        next: { href: "/docs/agent-kit/goat", label: "GOAT SDK" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/agent-kit/goat/page.tsx b/apps/site/app/docs/agent-kit/goat/page.tsx
deleted file mode 100644
index 032321b..0000000
--- a/apps/site/app/docs/agent-kit/goat/page.tsx
+++ /dev/null
@@ -1,26 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `import { CdrAgent } from "@cdr-kit/agent";
-import { cdrPlugin } from "@cdr-kit/goat";
-
-const agent = new CdrAgent({ privateKey, apiUrl });
-const plugin = cdrPlugin(agent); // pass into GOAT's getOnChainTools`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit", "GOAT SDK"],
-        title: "GOAT SDK adapter",
-        badges: <Badge tone="primary">@cdr-kit/goat</Badge>,
-        lede: <>GOAT SDK plugin exposing the CDR tools to any GOAT-enabled agent stack.</>,
-        importLine: 'import { cdrPlugin } from "@cdr-kit/goat"',
-        sections: [{ id: "usage", title: "Usage", content: <CodePanel title="goat.ts" code={CODE} /> }],
-        prev: { href: "/docs/agent-kit/agentkit", label: "Coinbase AgentKit" },
-        next: { href: "/docs/agent-kit/mcp", label: "MCP server" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/agent-kit/langchain/page.tsx b/apps/site/app/docs/agent-kit/langchain/page.tsx
deleted file mode 100644
index 20aa123..0000000
--- a/apps/site/app/docs/agent-kit/langchain/page.tsx
+++ /dev/null
@@ -1,32 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `import { ChatOpenAI } from "@langchain/openai";
-import { createReactAgent } from "@langchain/langgraph/prebuilt";
-import { CdrAgent } from "@cdr-kit/agent";
-import { getLangChainTools } from "@cdr-kit/langchain";
-
-const cdr = new CdrAgent({ privateKey, apiUrl });
-const agent = createReactAgent({
-  llm: new ChatOpenAI({ model: "gpt-4o" }),
-  tools: getLangChainTools(cdr),
-});
-const res = await agent.invoke({ messages: [{ role: "user", content: "Read vault 4200." }] });`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit", "LangChain"],
-        title: "LangChain adapter",
-        badges: <Badge tone="primary">@cdr-kit/langchain</Badge>,
-        lede: <>Returns LangChain <code>StructuredToolInterface[]</code> — drop into <code>createReactAgent</code> or any LangChain agent constructor.</>,
-        importLine: 'import { getLangChainTools } from "@cdr-kit/langchain"',
-        sections: [{ id: "usage", title: "Usage", content: <CodePanel title="langchain-agent.ts" code={CODE} /> }],
-        prev: { href: "/docs/agent-kit/openai", label: "OpenAI / Anthropic" },
-        next: { href: "/docs/agent-kit/agentkit", label: "Coinbase AgentKit" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/agent-kit/mcp/page.tsx b/apps/site/app/docs/agent-kit/mcp/page.tsx
deleted file mode 100644
index beb0d2c..0000000
--- a/apps/site/app/docs/agent-kit/mcp/page.tsx
+++ /dev/null
@@ -1,147 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const INSTALL = `# Recommended: get the CLI (gives you cdr + cdr mcp + cdr skill install)
-$ npm install -g @cdr-kit/cli
-
-# Alternative: just the MCP wrapper (used by claude mcp add)
-$ npm install -g @cdr-kit/mcp`;
-
-const ADD = `$ claude mcp add cdr-kit npx @cdr-kit/mcp`;
-
-const JSON_CONFIG = `{
-  "mcpServers": {
-    "cdr-kit": {
-      "command": "npx",
-      "args": ["-y", "@cdr-kit/mcp"],
-      "env": {
-        "CDR_PRIVATE_KEY": "0x_your_aeneid_testnet_key_here",
-        "CDR_NETWORK": "aeneid"
-      }
-    }
-  }
-}`;
-
-const TOOLS_TABLE: { name: string; group: string; description: string }[] = [
-  { name: "cdr_discover_vaults", group: "Discover + read", description: "Scan recent VaultCreated events; returns uuid, ipId, creator per vault." },
-  { name: "cdr_subscribe_and_access", group: "Discover + read", description: "Pay the subscription, then read + decrypt — one composite call." },
-  { name: "cdr_access_vault", group: "Discover + read", description: "Read + decrypt a vault the agent is already entitled to." },
-  { name: "cdr_access_license_gated", group: "Discover + read", description: "Read a license-gated vault by presenting a Story license token the agent owns." },
-  { name: "cdr_get_vault_info", group: "Introspection", description: "Resolve uuid → tokenId, ipId, creator, licenseTermsId. View-only." },
-  { name: "cdr_creator_vaults", group: "Introspection", description: "List every vault a given creator has minted. View-only." },
-  { name: "cdr_check_entitlement", group: "Introspection", description: "Is the agent (or any address) currently subscribed? Returns paidUntil + isEntitled. View-only." },
-  { name: "cdr_estimate_cost", group: "Introspection", description: "Subscription plan: pricePerPeriod, period, payee, mode. View-only." },
-  { name: "cdr_list_subscriptions", group: "Introspection", description: "Every vault the agent is currently subscribed to (active paidUntil)." },
-  { name: "cdr_get_fees", group: "Introspection", description: "CDR allocate / write / read fees + operational threshold. View-only, no wallet needed." },
-  { name: "cdr_create_vault", group: "Author / publish", description: "Mint NFT + register IP + allocate slot + configure read condition — one tx." },
-  { name: "cdr_write_vault_data", group: "Author / publish", description: "Encrypt a small (<1KB) UTF-8 string and write it to a vault." },
-  { name: "cdr_upload_file", group: "Author / publish", description: "Encrypt + IPFS-pin + allocate + write — for any >1KB payload." },
-  // 0.5 advanced-condition vaults
-  { name: "cdr_create_time_window_vault", group: "Advanced conditions (0.5)", description: "Create a Story CDR vault gated by an absolute time (or block) window." },
-  { name: "cdr_create_dead_man_vault", group: "Advanced conditions (0.5)", description: "Create a dead-man-switch vault — auto-unlocks to heirs if the creator stops poke()-ing." },
-  { name: "cdr_create_escrow_vault", group: "Advanced conditions (0.5)", description: "Create a buyer-pays-then-confirms-delivery escrow vault with optional arbiter." },
-  { name: "cdr_create_multi_sig_vault", group: "Advanced conditions (0.5)", description: "Create an N-of-M multi-sig vault — both off-chain EIP-712 sigs AND on-chain approve() paths supported. First-of-kind in the CDR ecosystem." },
-  { name: "cdr_approve_multi_sig", group: "Advanced conditions (0.5)", description: "Safe-style on-chain approval — agent calls approve(uuid). Dashboards read currentApprovalsCount(uuid)." },
-  // 0.5 Story IP integration
-  { name: "cdr_register_ip", group: "Story IP (0.5)", description: "Register an NFT as a Story IP asset (fresh-mint via SPG)." },
-  { name: "cdr_attach_license_terms", group: "Story IP (0.5)", description: "Attach PIL license terms to a Story IP asset (required before minting license tokens)." },
-  { name: "cdr_mint_license_token", group: "Story IP (0.5)", description: "Mint Story license tokens against an IP asset's licenseTermsId." },
-  { name: "cdr_publish_data", group: "Story IP (0.5)", description: "Agent-as-publisher one-shot: register IP + attach commercial terms + create license-gated CDR vault + write encrypted secret. The highest-DX win for autonomous data sellers." },
-];
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit", "MCP server"],
-        title: "MCP server",
-        badges: <><Badge tone="primary">@cdr-kit/mcp</Badge><Badge>22 tools · v0.5</Badge></>,
-        lede: <>One stdio binary that plugs into Claude Desktop, Cursor, Windsurf, and any MCP host. Exposes the full CDR surface — discover, subscribe, access, audit, publish, plus 4 advanced-condition vault creators and 4 Story IP wrappers (including the <code>cdr_publish_data</code> one-shot) — as <b>21 tools</b> backed by the agent&apos;s own auto-generated wallet. Shares code with <code>@cdr-kit/cli</code>, so anything the MCP can do, <code>cdr &lt;cmd&gt;</code> can do at the terminal.</>,
-        sections: [
-          {
-            id: "install",
-            title: "Install",
-            content: <CodePanel title="terminal" language="bash" code={INSTALL} />,
-          },
-          {
-            id: "add-to-claude",
-            title: "Add to Claude Desktop (one command)",
-            content: (
-              <>
-                <p>
-                  If you have Claude Code installed, the cleanest path is:
-                </p>
-                <CodePanel title="terminal" language="bash" code={ADD} />
-                <p>
-                  This registers <code>npx @cdr-kit/mcp</code> as the <code>cdr-kit</code> server. The first run auto-generates a wallet at <code>~/.config/cdr-kit/wallet.json</code> (chmod 600) and prints the address + faucet URL to stderr. Fund it with <code>cdr fund</code> before calling write/subscribe tools.
-                </p>
-              </>
-            ),
-          },
-          {
-            id: "manual-config",
-            title: "Manual config (Claude Desktop / Cursor / Windsurf)",
-            content: (
-              <>
-                <p>
-                  Paste this into your host&apos;s MCP config (Claude Desktop:{" "}
-                  <code>~/Library/Application Support/Claude/claude_desktop_config.json</code>; Cursor:{" "}
-                  <code>~/.cursor/mcp.json</code>; Windsurf: <code>~/.codeium/windsurf/mcp_config.json</code>).
-                </p>
-                <CodePanel title="mcp config" language="json" code={JSON_CONFIG} />
-                <p>
-                  <code>CDR_PRIVATE_KEY</code> is optional — if omitted, the wallet is auto-generated and loaded from disk on every run.
-                </p>
-              </>
-            ),
-          },
-          {
-            id: "tools",
-            title: "Tools (13)",
-            content: (
-              <>
-                <p>
-                  All tools come from a single source of truth in <code>@cdr-kit/tools</code>. Adapter packages (Vercel AI / OpenAI / LangChain / AgentKit / GOAT) iterate the same list, so every adapter gets all 13 automatically.
-                </p>
-                <table className="props">
-                  <thead>
-                    <tr><th>Tool</th><th>Group</th><th>Description</th></tr>
-                  </thead>
-                  <tbody>
-                    {TOOLS_TABLE.map((t) => (
-                      <tr key={t.name}>
-                        <td><code>{t.name}</code></td>
-                        <td>{t.group}</td>
-                        <td>{t.description}</td>
-                      </tr>
-                    ))}
-                  </tbody>
-                </table>
-              </>
-            ),
-          },
-          {
-            id: "env",
-            title: "Env reference",
-            content: (
-              <table className="props">
-                <thead><tr><th>Var</th><th>Default</th><th>Purpose</th></tr></thead>
-                <tbody>
-                  <tr><td><code>CDR_PRIVATE_KEY</code></td><td>(auto-generated)</td><td>Agent&apos;s wallet. Overrides the disk file at <code>~/.config/cdr-kit/wallet.json</code>.</td></tr>
-                  <tr><td><code>CDR_NETWORK</code></td><td>aeneid</td><td>aeneid (default) or mainnet (throws — not yet deployed).</td></tr>
-                  <tr><td><code>CDR_RPC_URL</code></td><td>network&apos;s canonical RPC</td><td>Override the JSON-RPC endpoint (use a paid RPC for production).</td></tr>
-                  <tr><td><code>CDR_API_URL</code></td><td>network&apos;s canonical Story-API REST</td><td>Override the Story-API base URL.</td></tr>
-                  <tr><td><code>LOG_LEVEL</code></td><td>info</td><td>pino level: trace, debug, info, warn, error.</td></tr>
-                  <tr><td><code>PRIVATE_KEY</code></td><td>(deprecated)</td><td>Old name for <code>CDR_PRIVATE_KEY</code>. Still honored in 0.4 with a deprecation warning; removed in 0.5.</td></tr>
-                </tbody>
-              </table>
-            ),
-          },
-        ],
-        prev: { href: "/docs/agent-kit/goat", label: "GOAT SDK" },
-        next: { href: "/docs/cli", label: "CLI: cdr" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/agent-kit/openai/page.tsx b/apps/site/app/docs/agent-kit/openai/page.tsx
deleted file mode 100644
index 36059ac..0000000
--- a/apps/site/app/docs/agent-kit/openai/page.tsx
+++ /dev/null
@@ -1,35 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `import OpenAI from "openai";
-import { CdrAgent } from "@cdr-kit/agent";
-import { getOpenAITools } from "@cdr-kit/openai";
-
-const agent = new CdrAgent({ privateKey, apiUrl });
-const { tools, dispatch } = getOpenAITools(agent);
-
-const openai = new OpenAI();
-const res = await openai.chat.completions.create({
-  model: "gpt-4o",
-  tools, // JSON-schema tool definitions
-  messages: [{ role: "user", content: "Find and read vault 4200." }],
-});
-// route tool calls back through dispatch(name, args)`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit", "OpenAI / Anthropic"],
-        title: "OpenAI / Anthropic adapter",
-        badges: <Badge tone="primary">@cdr-kit/openai</Badge>,
-        lede: <>JSON-Schema <code>tools[]</code> + a <code>dispatch</code> router for OpenAI Chat Completions / Anthropic Messages. Works with either provider.</>,
-        importLine: 'import { getOpenAITools } from "@cdr-kit/openai"',
-        sections: [{ id: "usage", title: "Usage", content: <CodePanel title="openai-agent.ts" code={CODE} /> }],
-        prev: { href: "/docs/agent-kit/vercel-ai", label: "Vercel AI SDK" },
-        next: { href: "/docs/agent-kit/langchain", label: "LangChain" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/agent-kit/page.tsx b/apps/site/app/docs/agent-kit/page.tsx
deleted file mode 100644
index fbeaf54..0000000
--- a/apps/site/app/docs/agent-kit/page.tsx
+++ /dev/null
@@ -1,56 +0,0 @@
-import Link from "next/link";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `import { CdrAgent } from "@cdr-kit/agent";
-
-const agent = new CdrAgent({
-  privateKey: process.env.PRIVATE_KEY,
-  apiUrl: process.env.CDR_API_URL,
-});
-
-const vaults = await agent.discover();
-const bytes = await agent.subscribeAndAccess({
-  uuid: vaults[0].uuid,
-  periods: 1n,
-  maxPricePerPeriod: 5n * 10n ** 18n,
-  value: 5n * 10n ** 18n,
-});`;
-
-export default function AgentKitPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit"],
-        title: "CdrAgent",
-        badges: <Badge tone="primary">@cdr-kit/agent</Badge>,
-        lede: <>Autonomous agent client: discover vaults on the factory, subscribe from its own wallet, decrypt, and use the data — no human in the loop. The headless object every framework adapter wraps.</>,
-        importLine: 'import { CdrAgent } from "@cdr-kit/agent"',
-        sections: [
-          {
-            id: "usage",
-            title: "Usage",
-            content: <CodePanel title="agent-demo.ts" code={CODE} />,
-          },
-          {
-            id: "adapters",
-            title: "Framework adapters",
-            content: (
-              <ul>
-                <li><Link href="/docs/agent-kit/vercel-ai"><code>@cdr-kit/vercel-ai</code></Link> — <code>generateText</code> tools</li>
-                <li><Link href="/docs/agent-kit/openai"><code>@cdr-kit/openai</code></Link> — OpenAI / Anthropic JSON-schema tools</li>
-                <li><Link href="/docs/agent-kit/langchain"><code>@cdr-kit/langchain</code></Link> — <code>StructuredTool</code>s</li>
-                <li><Link href="/docs/agent-kit/agentkit"><code>@cdr-kit/agentkit</code></Link> — Coinbase AgentKit <code>ActionProvider</code></li>
-                <li><Link href="/docs/agent-kit/goat"><code>@cdr-kit/goat</code></Link> — GOAT SDK plugin</li>
-                <li><Link href="/docs/agent-kit/mcp"><code>@cdr-kit/mcp</code></Link> — MCP server</li>
-              </ul>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-cdr-wallet", label: "useCdrWallet" },
-        next: { href: "/docs/agent-kit/vercel-ai", label: "Vercel AI SDK" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/agent-kit/vercel-ai/page.tsx b/apps/site/app/docs/agent-kit/vercel-ai/page.tsx
deleted file mode 100644
index 924259a..0000000
--- a/apps/site/app/docs/agent-kit/vercel-ai/page.tsx
+++ /dev/null
@@ -1,34 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `import { generateText, stepCountIs } from "ai";
-import { anthropic } from "@ai-sdk/anthropic";
-import { CdrAgent } from "@cdr-kit/agent";
-import { getVercelAITools } from "@cdr-kit/vercel-ai";
-
-const agent = new CdrAgent({ privateKey, apiUrl });
-
-const { text } = await generateText({
-  model: anthropic("claude-sonnet-4-6"),
-  tools: getVercelAITools(agent),
-  stopWhen: stepCountIs(8),
-  prompt: "Find a CDR vault, subscribe if needed, and tell me the signal.",
-});`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Agent kit", "Vercel AI SDK"],
-        title: "Vercel AI SDK adapter",
-        badges: <Badge tone="primary">@cdr-kit/vercel-ai</Badge>,
-        lede: <>Returns a <code>ToolSet</code> for <code>generateText</code> / <code>streamText</code>. The model autonomously picks the three CDR tools and drives the loop.</>,
-        importLine: 'import { getVercelAITools } from "@cdr-kit/vercel-ai"',
-        sections: [{ id: "usage", title: "Usage", content: <CodePanel title="agent.ts" code={CODE} /> }],
-        prev: { href: "/docs/agent-kit", label: "CdrAgent" },
-        next: { href: "/docs/agent-kit/openai", label: "OpenAI / Anthropic" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/cli/page.tsx b/apps/site/app/docs/cli/page.tsx
deleted file mode 100644
index dc50178..0000000
--- a/apps/site/app/docs/cli/page.tsx
+++ /dev/null
@@ -1,119 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const INSTALL = `$ npm install -g @cdr-kit/cli
-$ cdr --help`;
-
-const FIRST_RUN = `$ cdr wallet
-# first run prints a banner with the auto-generated address + faucet URL → stderr
-# subsequent runs return the wallet state as JSON / pretty-printed object`;
-
-const COMMANDS: { name: string; description: string }[] = [
-  { name: "cdr mcp", description: "Start the stdio MCP server. Same surface @cdr-kit/mcp exposes." },
-  { name: "cdr wallet [--json]", description: "Show address, network, balance, wallet path (doctor command)." },
-  { name: "cdr wallet new [--force]", description: "Force-generate a new wallet (refuses to overwrite without --force)." },
-  { name: "cdr wallet export --yes", description: "Print the private key (DANGEROUS — requires --yes to confirm)." },
-  { name: "cdr fund", description: "Print address + open the Aeneid faucet in your browser (captcha-gated)." },
-  { name: "cdr config", description: "Print resolved network / RPC / API URL / wallet path." },
-  { name: "cdr fees", description: "Allocate / write / read fees + operational threshold (view-only)." },
-  { name: "cdr discover [--from-block N]", description: "Scan factory VaultCreated events." },
-  { name: "cdr vault info <uuid>", description: "Vault info + plan + your entitlement, in one call." },
-  { name: "cdr vault list --creator <addr>", description: "Every vault a creator has minted." },
-  { name: "cdr vault create --read <addr> --read-config <hex> [--license-terms-id N]", description: "Create + configure + allocate — one tx." },
-  { name: "cdr subscribe <uuid> [--periods N] [--max-price wei]", description: "Subscribe to + read a subscription-gated vault." },
-  { name: "cdr access <uuid> [--aux-data hex]", description: "Read a vault you're already entitled to." },
-  { name: "cdr access-license <uuid> --license-token-id N", description: "Read a license-gated vault by presenting a Story license token." },
-  { name: "cdr subscriptions", description: "Every vault the agent is currently subscribed to." },
-  { name: "cdr tools", description: "Enumerate all 34 MCP tools (introspection)." },
-  { name: "cdr skill install", description: "Install the cdr-kit Claude Code plugin into ~/.claude/skills/cdr-kit/." },
-  // 0.5 advanced-condition vault creators
-  { name: "cdr create time-window --start <ts> --end <ts> [--block-based]", description: "Create a TimeWindowCondition vault — read allowed only during [startTs, endTs]." },
-  { name: "cdr create dead-man --duration <s> --heirs <list> [--public-after]", description: "Create a DeadManSwitchCondition vault — auto-unlocks to heirs after the heartbeat lapses." },
-  { name: "cdr create escrow --price <wei> --timeout <s> [--arbiter <addr>]", description: "Create a ConditionalEscrowCondition vault — buyer pays, confirms, then reads." },
-  { name: "cdr create multi-sig --signers <list> --threshold <n>", description: "Create an N-of-M MultiSigCondition vault (off-chain sigs OR on-chain approve)." },
-  // 0.5 condition mutators
-  { name: "cdr poke <uuid>", description: "Reset the dead-man-switch heartbeat for a vault you created." },
-  { name: "cdr multi-sig approve <uuid>", description: "On-chain Safe-style approval — agent must be a configured signer." },
-  { name: "cdr multi-sig sign <uuid> --caller <addr> --deadline <ts>", description: "Produce an off-chain EIP-712 sig for collecting threshold-many off-band." },
-  { name: "cdr multi-sig access <uuid> --deadline <ts> --sigs <list>", description: "Read a multi-sig vault by submitting collected off-chain sigs." },
-  { name: "cdr multi-sig rotate <uuid> --signers <list> --threshold <n>", description: "Creator-only signer rotation; bumps epoch (invalidates BOTH paths)." },
-  { name: "cdr escrow pay <uuid> --price <wei>", description: "Buyer step 1 — escrow the listing price (excess refunded same tx)." },
-  { name: "cdr escrow confirm <uuid>", description: "Buyer step 2 — confirm delivery, releases funds + grants read." },
-  { name: "cdr escrow claim-timeout <uuid> --buyer <addr>", description: "Seller — claim funds + grant buyer read after timeoutSecs of silence." },
-  { name: "cdr escrow arbiter-refund <uuid> --buyer <addr>", description: "Arbiter — refund a buyer who paid but disputes delivery." },
-  // 0.5 Story IP
-  { name: "cdr ip register --spg <addr> [--metadata <uri>]", description: "Register a freshly-minted SPG NFT as a Story IP asset." },
-  { name: "cdr ip attach-terms --ip <addr> --terms-id <id>", description: "Attach existing PIL license terms to an IP." },
-  { name: "cdr ip mint-license --licensor <addr> --terms-id <id> [--amount N]", description: "Mint Story license tokens against an IP's licenseTermsId." },
-  { name: "cdr ip register-derivative --child <addr> --parents <list> --terms-ids <list>", description: "Register a derivative IP — child inherits parents' PIL terms." },
-  { name: "cdr ip wrap-ip --amount <wei>", description: "Wrap native IP into WIP (required before paying royalties)." },
-  { name: "cdr ip approve-wip --spender <addr> --amount <wei>", description: "Approve a spender (typically RoyaltyModule) to pull WIP." },
-];
-
-const FLAGS = `--network aeneid|mainnet   # default aeneid; mainnet throws (not yet deployed)
---json                     # machine-readable JSON output for any command`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "CLI"],
-        title: "cdr command",
-        badges: <><Badge tone="primary">@cdr-kit/cli</Badge><Badge>0.5 · 25 commands</Badge></>,
-        lede: <>One binary, three surfaces. <code>cdr</code> ships every cdr-kit operation as a human-friendly CLI command (25 commands across wallet / discovery / advanced conditions / Story IP); <code>cdr mcp</code> starts the stdio MCP server (same 34 tools); <code>cdr skill install</code> drops the multi-skill Claude Code plugin into <code>~/.claude/skills/cdr-kit/</code>. Auto-creates the agent&apos;s wallet on first run — no &quot;bring your own private key&quot; friction.</>,
-        sections: [
-          { id: "install", title: "Install", content: <CodePanel title="terminal" language="bash" code={INSTALL} /> },
-          {
-            id: "first-run",
-            title: "First run",
-            content: (
-              <>
-                <CodePanel title="terminal" language="bash" code={FIRST_RUN} />
-                <p>
-                  The wallet is generated by viem&apos;s <code>generatePrivateKey()</code>, stored at <code>~/.config/cdr-kit/wallet.json</code> (resolved cross-platform via <code>env-paths</code>), and written with <code>chmod 600</code>. Override anytime with <code>CDR_PRIVATE_KEY=0x...</code>.
-                </p>
-              </>
-            ),
-          },
-          {
-            id: "commands",
-            title: "Commands",
-            content: (
-              <table className="props">
-                <thead><tr><th>Command</th><th>Description</th></tr></thead>
-                <tbody>
-                  {COMMANDS.map((c) => (
-                    <tr key={c.name}>
-                      <td><code>{c.name}</code></td>
-                      <td>{c.description}</td>
-                    </tr>
-                  ))}
-                </tbody>
-              </table>
-            ),
-          },
-          {
-            id: "flags",
-            title: "Global flags",
-            content: <CodePanel title="terminal" language="bash" code={FLAGS} />,
-          },
-          {
-            id: "mcp",
-            title: "Use as MCP server",
-            content: (
-              <>
-                <p>
-                  <code>cdr mcp</code> is the same stdio server <code>@cdr-kit/mcp</code> ships. Either binary works for MCP host configs — most prefer <code>npx @cdr-kit/mcp</code> for zero install footprint.
-                </p>
-                <CodePanel title="terminal" language="bash" code={`$ claude mcp add cdr-kit npx @cdr-kit/mcp`} />
-              </>
-            ),
-          },
-        ],
-        prev: { href: "/docs/agent-kit/mcp", label: "MCP server" },
-        next: { href: "/docs/skill", label: "Claude Code plugin" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/access-stepper/page.tsx b/apps/site/app/docs/components/access-stepper/page.tsx
deleted file mode 100644
index 0b6003d..0000000
--- a/apps/site/app/docs/components/access-stepper/page.tsx
+++ /dev/null
@@ -1,46 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { AccessStepperDemo } from "@/components/gallery/access-stepper-demo";
-
-const CODE = `import { AccessStepper } from "@cdr-kit/react-ui";
-import { useAccessVault } from "@cdr-kit/react";
-
-function Stepper({ uuid }) {
-  const { status, progress } = useAccessVault(uuid);
-  return <AccessStepper status={status} progress={progress} withPay />;
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "Components", "AccessStepper"],
-        title: "<AccessStepper>",
-        badges: <Badge tone="primary">styled</Badge>,
-        lede: <>Designed wait-state UI for the 2-step pay→access flow. Derives step state from <code>useAccessVault</code>&apos;s <code>status</code> + an optional <code>{`{collected, threshold}`}</code> for the determinate partial-collection bar.</>,
-        importLine: 'import { AccessStepper } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<AccessStepperDemo />} code={CODE} badge={<Badge>phase selector</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "status", type: '"idle" | "paying" | "collecting-partials" | "ready" | "error"', required: true, description: "Drives which step is active / done / errored." },
-                { name: "progress", type: "{ collected: number; threshold: number }", description: "When provided, drives the determinate partials bar in the collecting step." },
-                { name: "withPay", type: "boolean", defaultValue: "true", description: "Include the leading Subscribe & pay step (for subscription-gated vaults)." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/condition-badge", label: "ConditionBadge" },
-        next: { href: "/docs/components/subscribe-button", label: "SubscribeButton" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-error/page.tsx b/apps/site/app/docs/components/cdr-error/page.tsx
deleted file mode 100644
index c8088fb..0000000
--- a/apps/site/app/docs/components/cdr-error/page.tsx
+++ /dev/null
@@ -1,60 +0,0 @@
-"use client";
-
-import { CdrError } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { CdrError } from "@cdr-kit/react-ui";
-
-<CdrError
-  title="Read timed out"
-  message="Threshold not met in time."
-  onRetry={() => refetch()}
-/>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrError"],
-        title: "<CdrError>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Soft-bordered danger state with an optional retry CTA. Pair with caught errors from <code>useAccessVault</code> or <code>useSubscribeAndAccess</code>.</>,
-        importLine: 'import { CdrError } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <CdrError
-                    title="Read timed out"
-                    message="Threshold not met in time."
-                    onRetry={() => undefined}
-                  />
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "title", type: "ReactNode", required: true, description: "Bold first line — the error title." },
-                { name: "message", type: "ReactNode", description: "Optional detail line below the title." },
-                { name: "onRetry", type: "() => void", description: "When set, renders the retry button on the right." },
-                { name: "retryLabel", type: "string", defaultValue: '"Retry"', description: "Retry button label." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/cdr-progress", label: "CdrProgress" },
-        next: { href: "/docs/agent-kit", label: "Agent kit" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-inspector/page.tsx b/apps/site/app/docs/components/cdr-inspector/page.tsx
deleted file mode 100644
index 8497471..0000000
--- a/apps/site/app/docs/components/cdr-inspector/page.tsx
+++ /dev/null
@@ -1,39 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { CdrInspectorDemo } from "@/components/docs/demos/headless-demos";
-
-const CODE = `import { CdrInspector } from "@cdr-kit/react";
-
-export function App() {
-  return (
-    <CdrProvider mockKit={createMockCdrKit()}>
-      {process.env.NODE_ENV !== "production" && <CdrInspector />}
-      {/* …rest of app */}
-    </CdrProvider>
-  );
-}`;
-
-export default function CdrInspectorPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "CdrInspector"],
-        title: "<CdrInspector>",
-        badges: <Badge>dev tool</Badge>,
-        lede: (
-          <>
-            Drop-in debug strip showing how the kit is wired (<code>mock</code> vs <code>live</code>, WASM ready, API
-            URL). Keep it in dev builds; remove or guard for production.
-          </>
-        ),
-        importLine: 'import { CdrInspector } from "@cdr-kit/react"',
-        sections: [
-          { id: "preview", title: "Live preview", content: <Demo preview={<CdrInspectorDemo />} code={CODE} /> },
-        ],
-        prev: { href: "/docs/components/vault", label: "Vault compound" },
-        next: { href: "/docs/components/cdr-skeleton", label: "CdrSkeleton" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-network-chip/page.tsx b/apps/site/app/docs/components/cdr-network-chip/page.tsx
deleted file mode 100644
index c92272d..0000000
--- a/apps/site/app/docs/components/cdr-network-chip/page.tsx
+++ /dev/null
@@ -1,52 +0,0 @@
-import { CdrNetworkChip } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { CdrNetworkChip } from "@cdr-kit/react-ui";
-
-<CdrNetworkChip mode="live" />
-<CdrNetworkChip mode="mock" />`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrNetworkChip"],
-        title: "<CdrNetworkChip>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Pill with a glowing status dot indicating live vs mock mode. Drop into your app chrome so users always know whether they&apos;re hitting Aeneid or the in-memory mock.</>,
-        importLine: 'import { CdrNetworkChip } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <div style={{ display: "flex", flexWrap: "wrap", gap: 10, alignItems: "center" }}>
-                    <CdrNetworkChip mode="live" />
-                    <CdrNetworkChip mode="mock" />
-                  </div>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "mode", type: '"live" | "mock"', required: true, description: "Drives the dot color and glow (signal vs warn)." },
-                { name: "network", type: "string", defaultValue: '"Aeneid"', description: "Network label rendered next to the status." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/ip-price", label: "IpPrice" },
-        next: { href: "/docs/components/cdr-spinner", label: "CdrSpinner" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-progress/page.tsx b/apps/site/app/docs/components/cdr-progress/page.tsx
deleted file mode 100644
index 8e57087..0000000
--- a/apps/site/app/docs/components/cdr-progress/page.tsx
+++ /dev/null
@@ -1,53 +0,0 @@
-import { CdrProgress } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { CdrProgress } from "@cdr-kit/react-ui";
-
-<CdrProgress value={64} />
-<CdrProgress collected={6} threshold={10} />`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrProgress"],
-        title: "<CdrProgress>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Determinate progress bar with a primary→signal gradient fill. Pass a <code>value</code> 0–100, or pass <code>{`{collected, threshold}`}</code> and the component derives it.</>,
-        importLine: 'import { CdrProgress } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <div style={{ display: "flex", flexDirection: "column", gap: 12, width: "100%", maxWidth: 320 }}>
-                    <CdrProgress value={64} />
-                    <CdrProgress collected={6} threshold={10} />
-                  </div>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "value", type: "number", description: "0–100 percentage. Takes precedence over collected/threshold." },
-                { name: "collected", type: "number", description: "Numerator — used when value isn't provided." },
-                { name: "threshold", type: "number", description: "Denominator — used when value isn't provided." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/cdr-spinner", label: "CdrSpinner" },
-        next: { href: "/docs/components/cdr-error", label: "CdrError" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-provider/page.tsx b/apps/site/app/docs/components/cdr-provider/page.tsx
deleted file mode 100644
index 6283c9c..0000000
--- a/apps/site/app/docs/components/cdr-provider/page.tsx
+++ /dev/null
@@ -1,41 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-
-export default function CdrProviderPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "CdrProvider"],
-        title: "CdrProvider",
-        badges: <Badge tone="primary">component</Badge>,
-        lede: (
-          <>
-            Batteries-included root provider. Wires <code>WagmiProvider</code>, react-query, and initializes the CDR
-            crypto WASM. Use <code>CdrConfigProvider</code> directly if you already have your own wagmi stack
-            (Privy / RainbowKit).
-          </>
-        ),
-        importLine: 'import { CdrProvider } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable
-                rows={[
-                  { name: "apiUrl", type: "string", required: true, description: "Story-API REST base — keeper endpoint for partial collection." },
-                  { name: "mockKit", type: "MockCdrKit", description: "Pass createMockCdrKit() for offline dev. When set, no chain/wallet is touched." },
-                  { name: "config", type: "Config (wagmi)", description: "Optional wagmi config. A minimal default with an injected connector ships if omitted." },
-                  { name: "queryClient", type: "QueryClient", description: "Optional TanStack Query client." },
-                  { name: "appearance", type: "CdrAppearance", description: "CSS custom properties applied to the cdr-kit root (see Theming)." },
-                ]}
-              />
-            ),
-          },
-        ],
-        prev: { href: "/docs/theming", label: "Theming" },
-        next: { href: "/docs/components/vault-gate", label: "VaultGate" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-skeleton/page.tsx b/apps/site/app/docs/components/cdr-skeleton/page.tsx
deleted file mode 100644
index 30dec03..0000000
--- a/apps/site/app/docs/components/cdr-skeleton/page.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { CdrSkeletonDemo } from "@/components/docs/demos/headless-demos";
-
-const CODE = `import { CdrSkeleton } from "@cdr-kit/react";
-
-<CdrSkeleton />
-<CdrSkeleton lines={5} />`;
-
-export default function CdrSkeletonPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "CdrSkeleton"],
-        title: "<CdrSkeleton>",
-        lede: <>Default placeholder rendered by <code>&lt;VaultGate&gt;</code> / <code>&lt;Vault.Loading&gt;</code> when no custom <code>loading</code> slot is supplied. Themeable via <code>--cdr-skeleton</code>.</>,
-        importLine: 'import { CdrSkeleton } from "@cdr-kit/react"',
-        sections: [
-          { id: "preview", title: "Live preview", content: <Demo preview={<CdrSkeletonDemo />} code={CODE} /> },
-          { id: "props", title: "Props", content: <PropsTable rows={[{ name: "lines", type: "number", defaultValue: "3", description: "Number of bar rows to render." }]} /> },
-        ],
-        prev: { href: "/docs/components/cdr-inspector", label: "CdrInspector" },
-        next: { href: "/docs/components/empty-vaults", label: "EmptyVaults" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/cdr-spinner/page.tsx b/apps/site/app/docs/components/cdr-spinner/page.tsx
deleted file mode 100644
index d627cdf..0000000
--- a/apps/site/app/docs/components/cdr-spinner/page.tsx
+++ /dev/null
@@ -1,49 +0,0 @@
-import { CdrSpinner } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { CdrSpinner } from "@cdr-kit/react-ui";
-
-<CdrSpinner />
-<CdrSpinner size={24} />`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrSpinner"],
-        title: "<CdrSpinner>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Indeterminate CSS spinner. Use when you don&apos;t have a determinate progress to show (e.g. wallet confirmation).</>,
-        importLine: 'import { CdrSpinner } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <div style={{ display: "flex", gap: 18, alignItems: "center" }}>
-                    <CdrSpinner />
-                    <CdrSpinner size={24} />
-                  </div>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[{ name: "size", type: "number", defaultValue: "18", description: "Pixel size of the square spinner box." }]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/cdr-network-chip", label: "CdrNetworkChip" },
-        next: { href: "/docs/components/cdr-progress", label: "CdrProgress" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/components.css b/apps/site/app/docs/components/components.css
deleted file mode 100644
index 2c1fe6b..0000000
--- a/apps/site/app/docs/components/components.css
+++ /dev/null
@@ -1,88 +0,0 @@
-/* Components index — grid of cards + a "live" sampler at the bottom. */
-
-.comp-section { margin-top: 44px; }
-.comp-section-head { margin-bottom: 18px; }
-.comp-section-head h2 {
-  font-family: var(--display); font-size: 1.3rem; font-weight: 700; letter-spacing: -0.02em;
-  display: block; margin: 0 0 4px;
-}
-.comp-section-head h2::after { display: none; }
-.comp-section-head p { font-size: 0.92rem; color: var(--ink-2); margin: 0; }
-
-.comp-subheading {
-  font-family: var(--mono); font-size: 0.74rem; font-weight: 500;
-  letter-spacing: 0.1em; text-transform: uppercase; color: var(--ink-3);
-  margin: 26px 0 12px;
-}
-
-.comp-grid {
-  display: grid; grid-template-columns: repeat(2, 1fr); gap: 12px;
-}
-@media (max-width: 720px) { .comp-grid { grid-template-columns: 1fr; } }
-.comp-card {
-  display: flex; flex-direction: column; gap: 6px;
-  padding: 14px 16px;
-  border: 1px solid var(--line); border-radius: var(--r-md);
-  background: var(--card);
-  transition: border-color .14s, transform .14s, box-shadow .14s;
-}
-.comp-card:hover { border-color: var(--line-2); transform: translateY(-2px); box-shadow: var(--sh-1); }
-.comp-card-head { display: flex; align-items: center; gap: 8px; }
-.comp-name { font-family: var(--mono); font-size: 0.84rem; color: var(--primary); font-weight: 500; }
-.comp-tag {
-  font-family: var(--mono); font-size: 0.62rem; color: var(--ink-3);
-  border: 1px solid var(--line); border-radius: 4px; padding: 1px 5px; letter-spacing: 0.02em;
-}
-.comp-desc { font-size: 0.86rem; color: var(--ink-2); line-height: 1.5; margin: 0; }
-
-/* Live sampler bits (subset of the old gallery.css). */
-.spec-row { display: flex; flex-wrap: wrap; gap: 10px; align-items: center; }
-
-.phasectl {
-  display: inline-flex; gap: 2px; padding: 3px; border: 1px solid var(--line);
-  border-radius: var(--r-md); background: var(--paper-2); margin-bottom: 22px; flex-wrap: wrap;
-}
-.phasectl button {
-  font-family: var(--mono); font-size: 0.74rem; padding: 6px 11px; border-radius: var(--r-sm);
-  color: var(--ink-2); transition: all .14s;
-}
-.phasectl button[aria-pressed="true"] { background: var(--card); color: var(--ink); box-shadow: var(--sh-1); }
-
-.vgrid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 16px; width: 100%; }
-@media (max-width: 620px) { .vgrid { grid-template-columns: 1fr; } }
-
-.prim-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 14px; }
-@media (max-width: 620px) { .prim-grid { grid-template-columns: 1fr; } }
-.prim { border: 1px solid var(--line); border-radius: var(--r-md); background: var(--card); padding: 16px; }
-.prim .pn { font-family: var(--mono); font-size: 0.78rem; color: var(--primary); margin-bottom: 10px; }
-.prim .pdemo { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; min-height: 36px; }
-
-/* Unlockable demo prose styling — premium magazine feel without competing with the pill itself. */
-.unl-demo { font-family: var(--sans); color: var(--ink); max-width: 580px; }
-.unl-demo-title { font-family: var(--display); font-size: 1.55rem; font-weight: 700; letter-spacing: -0.02em; line-height: 1.15; margin: 0 0 4px; color: var(--ink); }
-.unl-demo-byline { font-family: var(--mono); font-size: 0.74rem; color: var(--ink-3); margin: 0 0 22px; letter-spacing: 0.04em; text-transform: uppercase; }
-.unl-demo p { font-size: 1rem; line-height: 1.72; color: var(--ink-2); margin: 0 0 16px; }
-.unl-demo p:last-child { margin-bottom: 0; }
-
-/* Docs-page CTA banner that points readers at the showcase. */
-.unl-doc-cta {
-  display: block;
-  padding: 18px 22px;
-  margin: 8px 0 26px;
-  border-radius: var(--r-md);
-  border: 1px solid var(--primary-line);
-  background: linear-gradient(135deg, var(--primary-soft), var(--card));
-  text-decoration: none;
-  color: var(--ink);
-  transition: transform .14s, border-color .18s, box-shadow .18s;
-}
-.unl-doc-cta:hover { transform: translateY(-1px); border-color: var(--primary); box-shadow: var(--sh-2); }
-.unl-doc-cta-eyebrow {
-  display: block; font-family: var(--mono); font-size: 0.68rem;
-  letter-spacing: 0.1em; text-transform: uppercase; color: var(--primary); margin-bottom: 6px;
-}
-.unl-doc-cta-title {
-  display: block; font-family: var(--display); font-size: 1.15rem; font-weight: 700;
-  letter-spacing: -0.01em; color: var(--ink); margin-bottom: 4px;
-}
-.unl-doc-cta-sub { display: block; font-size: 0.88rem; color: var(--ink-2); line-height: 1.5; }
diff --git a/apps/site/app/docs/components/condition-badge/page.tsx b/apps/site/app/docs/components/condition-badge/page.tsx
deleted file mode 100644
index cd8606d..0000000
--- a/apps/site/app/docs/components/condition-badge/page.tsx
+++ /dev/null
@@ -1,56 +0,0 @@
-import { ConditionBadge } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { ConditionBadge } from "@cdr-kit/react-ui";
-
-<ConditionBadge kind="subscription" />
-<ConditionBadge kind="tiergate" />
-<ConditionBadge kind="composable" />
-<ConditionBadge kind="open" />`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "Components", "ConditionBadge"],
-        title: "<ConditionBadge>",
-        badges: <Badge tone="primary">styled</Badge>,
-        lede: <>Color-mapped pill for a vault&apos;s read-condition kind. Pure presentational, zero app logic.</>,
-        importLine: 'import { ConditionBadge } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <div style={{ display: "flex", flexWrap: "wrap", gap: 10, alignItems: "center" }}>
-                    <ConditionBadge kind="subscription" />
-                    <ConditionBadge kind="tiergate" />
-                    <ConditionBadge kind="composable" />
-                    <ConditionBadge kind="open" />
-                  </div>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "kind", type: '"subscription" | "tiergate" | "composable" | "open"', required: true, description: "Determines the color (primary / warn / signal / neutral) and the default label." },
-                { name: "children", type: "ReactNode", description: "Optional label override. Defaults to a human-readable kind name." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/empty-vaults", label: "EmptyVaults" },
-        next: { href: "/docs/components/access-stepper", label: "AccessStepper" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/copy-button/page.tsx b/apps/site/app/docs/components/copy-button/page.tsx
deleted file mode 100644
index bc4973d..0000000
--- a/apps/site/app/docs/components/copy-button/page.tsx
+++ /dev/null
@@ -1,52 +0,0 @@
-import { CopyButton } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { CopyButton } from "@cdr-kit/react-ui";
-
-<CopyButton value="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" />`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CopyButton"],
-        title: "<CopyButton>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Minimal copy-to-clipboard control. Flashes a check icon for 1.4s on success. Composes inside other primitives (e.g. <code>&lt;ShortAddress&gt;</code>).</>,
-        importLine: 'import { CopyButton } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <span className="cdr-ui-addr-chip" data-cdr-ui="">
-                    sample value
-                    <CopyButton value="sample value" />
-                  </span>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "value", type: "string", required: true, description: "Text written to the clipboard on click." },
-                { name: "label", type: "string", defaultValue: '"copy"', description: "ARIA label for the button." },
-                { name: "className", type: "string", description: "Custom class — defaults to none; style via the wrapping chip." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/vault-card", label: "VaultCard" },
-        next: { href: "/docs/components/short-address", label: "ShortAddress" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/empty-vaults/page.tsx b/apps/site/app/docs/components/empty-vaults/page.tsx
deleted file mode 100644
index 7ba4365..0000000
--- a/apps/site/app/docs/components/empty-vaults/page.tsx
+++ /dev/null
@@ -1,31 +0,0 @@
-import { DocPage } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { EmptyVaultsDemo } from "@/components/docs/demos/headless-demos";
-
-const CODE = `import { EmptyVaults } from "@cdr-kit/react";
-
-<EmptyVaults />
-<EmptyVaults>No vaults match your filter.</EmptyVaults>
-
-// typical use:
-{vaults.length === 0
-  ? <EmptyVaults>No vaults match your filter.</EmptyVaults>
-  : <VaultGrid vaults={vaults} />}`;
-
-export default function EmptyVaultsPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "EmptyVaults"],
-        title: "<EmptyVaults>",
-        lede: <>Semantic empty-state slot — a <code>div[data-cdr-empty]</code> with a default copy fallback. Style at the consumer level.</>,
-        importLine: 'import { EmptyVaults } from "@cdr-kit/react"',
-        sections: [
-          { id: "preview", title: "Live preview", content: <Demo preview={<EmptyVaultsDemo />} code={CODE} /> },
-        ],
-        prev: { href: "/docs/components/cdr-skeleton", label: "CdrSkeleton" },
-        next: { href: "/docs/components/condition-badge", label: "ConditionBadge" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/escrow-delivery-confirm/page.tsx b/apps/site/app/docs/components/escrow-delivery-confirm/page.tsx
deleted file mode 100644
index 49bb9c8..0000000
--- a/apps/site/app/docs/components/escrow-delivery-confirm/page.tsx
+++ /dev/null
@@ -1,59 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { EscrowDeliveryConfirmDemo } from "@/components/docs/demos/escrow-delivery-confirm-demo";
-import "../components.css";
-
-const CODE = `import { EscrowDeliveryConfirm } from "@cdr-kit/react";
-
-<EscrowDeliveryConfirm uuid={8812} buyer={connectedAddress} />
-
-// Render-prop for the dashboard:
-<EscrowDeliveryConfirm uuid={8812} buyer={connectedAddress}>
-  {({ paid, delivered, timeoutInMs, confirmDelivery, pay }) => (
-    paid === 0n
-      ? <button onClick={() => pay()}>Pay listing price</button>
-      : delivered
-        ? <span>delivered ✓</span>
-        : <button onClick={() => confirmDelivery()}>Confirm delivery</button>
-  )}
-</EscrowDeliveryConfirm>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "EscrowDeliveryConfirm"],
-        title: "<EscrowDeliveryConfirm>",
-        badges: <><Badge tone="primary">new in 0.5</Badge><Badge>headless</Badge></>,
-        lede: <>Buyer-side flow for <code>ConditionalEscrowCondition</code>: pay → confirm delivery → seller paid + buyer reads. Surfaces the timeout countdown after which the seller can claim unilaterally.</>,
-        importLine: 'import { EscrowDeliveryConfirm } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<EscrowDeliveryConfirmDemo />} code={CODE} badge={<Badge>mock</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "ConditionalEscrowCondition-gated vault uuid." },
-                { name: "buyer", type: "Hex | undefined", description: "Address whose paidAt/delivered state to read. Usually the connected wallet." },
-                { name: "children", type: "(state) => ReactNode", description: "Render-prop. Receives the full EscrowState including seller, price, timeoutSecs, arbiter, paidAt, delivered, timeoutInMs, plus pay() and confirmDelivery() actions." },
-              ]} />
-            ),
-          },
-          {
-            id: "intrinsic",
-            title: "Intrinsic CDR limitation",
-            content: <p>Once a buyer pays + confirms + reads, they hold plaintext forever. The dispute path (arbiter refund) can revoke future access but cannot &quot;un-read.&quot; Document this in your buyer UX.</p>,
-          },
-        ],
-        prev: { href: "/docs/components/multi-sig-signer", label: "MultiSigSigner" },
-        next: { href: "/docs/components/condition-badge", label: "ConditionBadge" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/explorer-link/page.tsx b/apps/site/app/docs/components/explorer-link/page.tsx
deleted file mode 100644
index 8ecf223..0000000
--- a/apps/site/app/docs/components/explorer-link/page.tsx
+++ /dev/null
@@ -1,52 +0,0 @@
-import { ExplorerLink } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { ExplorerLink } from "@cdr-kit/react-ui";
-
-<ExplorerLink href="https://aeneid.storyrpc.io/address/0xac592f…">
-  view on Aeneid
-</ExplorerLink>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "ExplorerLink"],
-        title: "<ExplorerLink>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Mono primary-colored link with an external-link icon. Opens in a new tab with <code>rel=&quot;noopener noreferrer&quot;</code>.</>,
-        importLine: 'import { ExplorerLink } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <ExplorerLink href="https://aeneid.storyrpc.io/address/0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C">
-                    view on Aeneid
-                  </ExplorerLink>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "href", type: "string", required: true, description: "Target URL (typically a block-explorer address / tx page)." },
-                { name: "children", type: "ReactNode", defaultValue: '"view"', description: "Link label." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/short-address", label: "ShortAddress" },
-        next: { href: "/docs/components/ip-price", label: "IpPrice" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/heartbeat-timer/page.tsx b/apps/site/app/docs/components/heartbeat-timer/page.tsx
deleted file mode 100644
index 95d42d8..0000000
--- a/apps/site/app/docs/components/heartbeat-timer/page.tsx
+++ /dev/null
@@ -1,58 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { HeartbeatTimerDemo } from "@/components/docs/demos/heartbeat-timer-demo";
-import "../components.css";
-
-const CODE = `import { HeartbeatTimer, useDeadManTimer } from "@cdr-kit/react";
-
-// Default headless render — countdown + extend button:
-<HeartbeatTimer uuid={4242} />
-
-// Custom render — full control via render-prop:
-<HeartbeatTimer uuid={4242}>
-  {({ remainingMs, isCritical, isUnlocked, poke }) => (
-    <div className={isCritical ? "warn" : ""}>
-      {isUnlocked ? "unlocked" : \`unlocks in \${remainingMs / 1000}s\`}
-      <button onClick={() => poke()}>extend now</button>
-    </div>
-  )}
-</HeartbeatTimer>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "HeartbeatTimer"],
-        title: "<HeartbeatTimer>",
-        badges: <><Badge tone="primary">new in 0.5</Badge><Badge>headless</Badge></>,
-        lede: <>Countdown to <code>DeadManSwitchCondition.unlockAt</code> with a creator-side <code>poke()</code> button. Flips into <code>critical</code> mode once &lt; 25% of the window remains, so the UI can prompt the creator before silence becomes irreversible.</>,
-        importLine: 'import { HeartbeatTimer } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<HeartbeatTimerDemo />} code={CODE} badge={<Badge>mock</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "DeadManSwitchCondition-gated vault uuid." },
-                { name: "children", type: "(state: DeadManTimer) => ReactNode", description: "Optional render-prop. Receives { unlocksAt, duration, remainingMs, isUnlocked, isCritical, poke, isLoading }." },
-              ]} />
-            ),
-          },
-          {
-            id: "hook",
-            title: "Hook variant",
-            content: <p>Skip the component and consume <code>useDeadManTimer(uuid)</code> directly. Returns the same state object the render-prop receives.</p>,
-          },
-        ],
-        prev: { href: "/docs/components/empty-vaults", label: "EmptyVaults" },
-        next: { href: "/docs/components/time-window-badge", label: "TimeWindowBadge" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/ip-price/page.tsx b/apps/site/app/docs/components/ip-price/page.tsx
deleted file mode 100644
index c103b71..0000000
--- a/apps/site/app/docs/components/ip-price/page.tsx
+++ /dev/null
@@ -1,55 +0,0 @@
-import { IpPrice } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const FIVE_IP = BigInt(5) * BigInt(10) ** BigInt(18);
-
-const CODE = `import { IpPrice } from "@cdr-kit/react-ui";
-
-<IpPrice wei={5n * 10n ** 18n} period="/ 30d" />
-<IpPrice wei={null} />            {/* "License-gated" */}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "IpPrice"],
-        title: "<IpPrice>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Formats <code>wei</code> as <code>n IP</code> with an optional period suffix. Pass <code>null</code> for license-gated vaults — renders the standard alt label.</>,
-        importLine: 'import { IpPrice } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <div style={{ display: "flex", flexWrap: "wrap", gap: 18, alignItems: "center" }}>
-                    <IpPrice wei={FIVE_IP} period="/ 30d" />
-                    <IpPrice wei={null} />
-                  </div>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "wei", type: "bigint | null", required: true, description: "Price in wei. null renders \"License-gated\"." },
-                { name: "period", type: "string", description: "Suffix appended after the IP value (e.g. \"/ 30d\")." },
-                { name: "decimals", type: "number", defaultValue: "4", description: "Max significant decimal digits in the formatted output." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/explorer-link", label: "ExplorerLink" },
-        next: { href: "/docs/components/cdr-network-chip", label: "CdrNetworkChip" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/multi-sig-approval-tracker/page.tsx b/apps/site/app/docs/components/multi-sig-approval-tracker/page.tsx
deleted file mode 100644
index 351ae75..0000000
--- a/apps/site/app/docs/components/multi-sig-approval-tracker/page.tsx
+++ /dev/null
@@ -1,53 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { MultiSigApprovalTrackerDemo } from "@/components/docs/demos/multi-sig-approval-tracker-demo";
-import "../components.css";
-
-const CODE = `import { MultiSigApprovalTracker } from "@cdr-kit/react";
-
-// signedBy is the list of signers who have already produced a sig OFF-CHAIN
-// (the contract is stateless on approvals — no per-signer tx).
-<MultiSigApprovalTracker
-  uuid={7331}
-  signedBy={["0xAlice...", "0xBob..."]}
-/>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "MultiSigApprovalTracker"],
-        title: "<MultiSigApprovalTracker>",
-        badges: <><Badge tone="primary">new in 0.5</Badge><Badge>headless</Badge></>,
-        lede: <>X of Y approved + epoch — the read-side dashboard for <code>MultiSigCondition</code>. Combines the on-chain signer set with the off-chain set of collected sigs to render approval progress.</>,
-        importLine: 'import { MultiSigApprovalTracker } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<MultiSigApprovalTrackerDemo />} code={CODE} badge={<Badge>mock</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "MultiSigCondition-gated vault uuid." },
-                { name: "signedBy", type: "readonly Hex[]", defaultValue: "[]", description: "Off-chain set of signers who have produced a sig (the contract stores no approvals — this comes from your sig-collection UI)." },
-                { name: "children", type: "(state) => ReactNode", description: "Render-prop. Receives { signers, threshold, epoch, signedCount, isReady, isLoading }." },
-              ]} />
-            ),
-          },
-          {
-            id: "rotation",
-            title: "Epoch rotation",
-            content: <p>Each call to <code>rotateSigners()</code> bumps <code>epoch</code>. The tracker re-reads on rotation; UI should prompt for a fresh sig collection because in-flight sigs against the previous epoch are invalidated.</p>,
-          },
-        ],
-        prev: { href: "/docs/components/time-window-badge", label: "TimeWindowBadge" },
-        next: { href: "/docs/components/multi-sig-signer", label: "MultiSigSigner" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/multi-sig-signer/page.tsx b/apps/site/app/docs/components/multi-sig-signer/page.tsx
deleted file mode 100644
index 5ff05cb..0000000
--- a/apps/site/app/docs/components/multi-sig-signer/page.tsx
+++ /dev/null
@@ -1,143 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-import { Demo } from "@/components/docs/demo";
-import { MultiSigSignerDemo } from "@/components/docs/demos/multi-sig-signer-demo";
-import "../components.css";
-
-const SIGN_CODE = `import { MultiSigSigner } from "@cdr-kit/react";
-
-// Default render — button → on click signs EIP-712 → shows the sig + copy button.
-<MultiSigSigner uuid={7331} />
-
-// With a custom caller (default = connected wallet) and 30-min deadline:
-<MultiSigSigner
-  uuid={7331}
-  caller="0xBuyerWhoWillSubmit"
-  deadline={BigInt(Math.floor(Date.now() / 1000) + 1800)}
-/>
-
-// Render-prop for full custom UI:
-<MultiSigSigner uuid={7331}>
-  {({ sign, signature, isLoading, error, onSign }) => (
-    signature
-      ? <span>Sig: {signature}</span>
-      : <button disabled={isLoading} onClick={onSign}>
-          {isLoading ? "signing…" : "Approve read"}
-        </button>
-  )}
-</MultiSigSigner>`;
-
-const SUBMIT_CODE = `// Buyer side — once threshold-many sigs collected from different signers:
-import { CdrAgent } from "@cdr-kit/agent";
-
-const bytes = await agent.accessMultiSig({
-  uuid: 7331,
-  deadline,                  // MUST match every sig's deadline
-  sigs: [sigFromAlice, sigFromBob],  // sorted by signer address ASC
-});`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "MultiSigSigner"],
-        title: "<MultiSigSigner>",
-        badges: (
-          <>
-            <Badge tone="primary">new in 0.5</Badge>
-            <Badge>headless</Badge>
-            <Badge>signer-side</Badge>
-          </>
-        ),
-        lede: (
-          <>
-            Producer half of the off-chain dual-path <code>MultiSigCondition</code> flow: a button that
-            signs an EIP-712 <code>Approval(uuid, caller, epoch, deadline)</code> and surfaces the 65-byte sig
-            for the signer to share with the buyer. Pair with <code>agent.accessMultiSig({"{ uuid, deadline, sigs[] }"})</code>{" "}
-            on the buyer side to submit threshold-many sigs as <code>accessAuxData</code>. The complementary{" "}
-            <code>&lt;MultiSigApprovalTracker&gt;</code> is the buyer-side aggregator.
-          </>
-        ),
-        importLine: 'import { MultiSigSigner } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<MultiSigSignerDemo />} code={SIGN_CODE} badge={<Badge>mock</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable
-                rows={[
-                  { name: "uuid", type: "number", required: true, description: "MultiSigCondition-gated vault uuid." },
-                  {
-                    name: "caller",
-                    type: "Hex",
-                    description:
-                      "Optional override — defaults to the connected wallet. The sig is bound to this address; only this caller can use it via accessAuxData (anyone else fails ecrecover).",
-                  },
-                  {
-                    name: "deadline",
-                    type: "bigint",
-                    description:
-                      "Optional unix-seconds expiry. Default: 1 hour from when the user clicks Sign. The buyer's `accessMultiSig` call MUST pass the same deadline used at signing time.",
-                  },
-                  {
-                    name: "children",
-                    type: "(state) => ReactNode",
-                    description:
-                      "Render-prop. Receives { sign, signature, isLoading, error, onSign }. `onSign` is a bound zero-arg helper that calls `sign(...)` with the component's caller+deadline.",
-                  },
-                ]}
-              />
-            ),
-          },
-          {
-            id: "submit",
-            title: "Submit threshold-many sigs",
-            content: (
-              <>
-                <p>
-                  Once <code>threshold</code>-many signers have produced sigs, the buyer (or any caller) builds the
-                  combined <code>accessAuxData</code> and reads the vault. <code>agent.accessMultiSig</code> handles the
-                  abi-encoding; sigs must be ordered by recovered signer address ascending (the contract enforces a
-                  strict-ascending dedupe).
-                </p>
-                <CodePanel title="ts" language="ts" code={SUBMIT_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "rotation",
-            title: "Epoch rotation invalidates in-flight sigs",
-            content: (
-              <p>
-                The hook fetches the current <code>epoch</code> from <code>getConfig(uuid)</code> immediately before
-                signing. If <code>rotateSigners</code> lands between sign and submit, the contract recomputes the
-                digest with the new epoch — <code>ecrecover</code> returns a different address and the sig is
-                rejected. The signer can re-sign against the new epoch if they still want to authorize the new set
-                (use the &quot;re-sign&quot; button in the default render, or call <code>sign()</code> again).
-              </p>
-            ),
-          },
-          {
-            id: "hook",
-            title: "Hook variant",
-            content: (
-              <p>
-                Skip the component and use <code>useSignMultiSigApproval(uuid)</code> directly — returns{" "}
-                <code>{`{ sign, signature, isLoading, error }`}</code>. Useful when the sign trigger lives in a
-                non-button surface (drag-and-drop, gesture, programmatic flow).
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/multi-sig-approval-tracker", label: "MultiSigApprovalTracker" },
-        next: { href: "/docs/components/escrow-delivery-confirm", label: "EscrowDeliveryConfirm" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/page.tsx b/apps/site/app/docs/components/page.tsx
deleted file mode 100644
index 3387c8a..0000000
--- a/apps/site/app/docs/components/page.tsx
+++ /dev/null
@@ -1,172 +0,0 @@
-"use client";
-
-import "./components.css";
-
-import Link from "next/link";
-import {
-  ConditionBadge,
-  VaultCard,
-  ShortAddress,
-  ExplorerLink,
-  IpPrice,
-  CdrNetworkChip,
-  CdrSpinner,
-  CdrProgress,
-  CdrError,
-} from "@cdr-kit/react-ui";
-
-import { AccessStepperDemo } from "@/components/gallery/access-stepper-demo";
-import { SubscribeButtonDemo } from "@/components/gallery/subscribe-button-demo";
-import { Badge } from "@/components/primitives/badge";
-
-const FIVE_IP = BigInt(5) * BigInt(10) ** BigInt(18);
-const TWO_MIL_IP = BigInt(18) * BigInt(10) ** BigInt(15);
-
-const HEADLESS: { name: string; href: string; tag?: string; description: string }[] = [
-  { name: "CdrProvider", href: "/docs/components/cdr-provider", description: "Root provider — wires WagmiProvider + react-query + initializes the CDR crypto WASM." },
-  { name: "VaultGate", href: "/docs/components/vault-gate", description: "Declarative gate. Wrap encrypted data; renders the decrypted bytes via a render-prop." },
-  { name: "Vault", href: "/docs/components/vault", tag: "compound", description: "Compound component — Vault.Locked / Vault.Loading / Vault.Unlocked slots." },
-  { name: "CdrInspector", href: "/docs/components/cdr-inspector", description: "Dev panel showing mock / live mode + WASM ready state + API URL." },
-  { name: "CdrSkeleton", href: "/docs/components/cdr-skeleton", description: "Default placeholder when no custom loading slot is supplied." },
-  { name: "EmptyVaults", href: "/docs/components/empty-vaults", description: "Semantic empty-state slot." },
-];
-
-const STYLED_CORE: { name: string; href: string; tag?: string; description: string }[] = [
-  { name: "ConditionBadge", href: "/docs/components/condition-badge", description: "Color-mapped pill for the read condition kind." },
-  { name: "AccessStepper", href: "/docs/components/access-stepper", description: "Designed wait-state stepper for the 2-step pay→access flow." },
-  { name: "SubscribeButton", href: "/docs/components/subscribe-button", description: "Batteries-included CTA wrapping useSubscribeAndAccess + inline stepper + decoded JSON." },
-  { name: "VaultCard", href: "/docs/components/vault-card", description: "Marketplace card with CSS pointer-tracking spotlight on hover." },
-];
-
-const STYLED_PRIMITIVES: { name: string; href: string; description: string }[] = [
-  { name: "CopyButton", href: "/docs/components/copy-button", description: "Minimal copy-to-clipboard control with check-mark feedback." },
-  { name: "ShortAddress", href: "/docs/components/short-address", description: "Truncated mono address chip with inline copy." },
-  { name: "ExplorerLink", href: "/docs/components/explorer-link", description: "Mono link with external-link icon — opens in new tab." },
-  { name: "IpPrice", href: "/docs/components/ip-price", description: "Formats wei as IP with an optional period suffix." },
-  { name: "CdrNetworkChip", href: "/docs/components/cdr-network-chip", description: "Pill with a glowing dot showing live vs mock mode." },
-  { name: "CdrSpinner", href: "/docs/components/cdr-spinner", description: "Indeterminate CSS spinner." },
-  { name: "CdrProgress", href: "/docs/components/cdr-progress", description: "Determinate progress bar with gradient fill." },
-  { name: "CdrError", href: "/docs/components/cdr-error", description: "Soft-bordered danger state with optional retry CTA." },
-];
-
-export default function ComponentsIndex() {
-  return (
-    <main className="doc" style={{ maxWidth: 920 }}>
-      <div className="crumbs">
-        <span className="cur">Components</span>
-      </div>
-      <div className="doc-titlerow">
-        <h1 className="doc-title">Components</h1>
-        <Badge tone="primary">18 components</Badge>
-      </div>
-      <p className="doc-lede">
-        Every component the kit ships, in one place. Headless render-prop slots from{" "}
-        <code>@cdr-kit/react</code> on top — drop in your own visuals, theme freely. Styled, batteries-included
-        variants from <code>@cdr-kit/react-ui</code> below — designed UI you can theme via{" "}
-        <code>--cdr-ui-*</code> CSS variables. Click any component for its live preview, code, props, and states.
-      </p>
-
-      <section className="comp-section">
-        <div className="comp-section-head">
-          <h2>Headless · @cdr-kit/react</h2>
-          <p className="muted">Render-prop slots + hooks. Bring your own visuals.</p>
-        </div>
-        <div className="comp-grid">
-          {HEADLESS.map((c) => (
-            <Link key={c.name} href={c.href} className="comp-card">
-              <div className="comp-card-head">
-                <code className="comp-name">{`<${c.name}>`}</code>
-                {c.tag && <span className="comp-tag">{c.tag}</span>}
-              </div>
-              <p className="comp-desc">{c.description}</p>
-            </Link>
-          ))}
-        </div>
-      </section>
-
-      <section className="comp-section">
-        <div className="comp-section-head">
-          <h2>Styled · @cdr-kit/react-ui</h2>
-          <p className="muted">Designed, batteries-included variants. Drop in and theme via CSS variables.</p>
-        </div>
-        <h3 className="comp-subheading">Vault-centric</h3>
-        <div className="comp-grid">
-          {STYLED_CORE.map((c) => (
-            <Link key={c.name} href={c.href} className="comp-card">
-              <div className="comp-card-head">
-                <code className="comp-name">{`<${c.name}>`}</code>
-                {c.tag && <span className="comp-tag">{c.tag}</span>}
-              </div>
-              <p className="comp-desc">{c.description}</p>
-            </Link>
-          ))}
-        </div>
-
-        <h3 className="comp-subheading">DX primitives</h3>
-        <div className="comp-grid">
-          {STYLED_PRIMITIVES.map((c) => (
-            <Link key={c.name} href={c.href} className="comp-card">
-              <div className="comp-card-head">
-                <code className="comp-name">{`<${c.name}>`}</code>
-              </div>
-              <p className="comp-desc">{c.description}</p>
-            </Link>
-          ))}
-        </div>
-      </section>
-
-      <section className="comp-section">
-        <div className="comp-section-head">
-          <h2>At a glance — live</h2>
-          <p className="muted">A quick sampler of the styled set. Each component has a full page with Preview + Code + props.</p>
-        </div>
-
-        <div className="spec-row">
-          <ConditionBadge kind="subscription" />
-          <ConditionBadge kind="tiergate" />
-          <ConditionBadge kind="composable" />
-          <ConditionBadge kind="open" />
-        </div>
-
-        <div style={{ marginTop: 28 }}>
-          <AccessStepperDemo />
-        </div>
-
-        <div style={{ marginTop: 28 }}>
-          <SubscribeButtonDemo />
-        </div>
-
-        <div style={{ marginTop: 28 }} className="vgrid">
-          <VaultCard
-            uuid={4200}
-            condition="subscription"
-            title="ETH/USD alpha signal"
-            description="Hourly directional signal, threshold-encrypted."
-            dataType="signal"
-            creatorName="0xc183…96E2"
-            price={<IpPrice wei={FIVE_IP} period="/ 30d" />}
-          />
-          <VaultCard
-            uuid={4201}
-            condition="tiergate"
-            title="Proprietary dataset"
-            description="Gated by a Commercial PIL tier license."
-            dataType="dataset"
-            creatorName="0x74F2…800B"
-            price={<IpPrice wei={null} />}
-          />
-        </div>
-
-        <div className="prim-grid" style={{ marginTop: 28 }}>
-          <div className="prim"><div className="pn">{`<ShortAddress />`}</div><div className="pdemo"><ShortAddress address="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" /></div></div>
-          <div className="prim"><div className="pn">{`<ExplorerLink />`}</div><div className="pdemo"><ExplorerLink href="https://aeneid.storyrpc.io/address/0xac592f">view on Aeneid</ExplorerLink></div></div>
-          <div className="prim"><div className="pn">{`<IpPrice />`}</div><div className="pdemo"><IpPrice wei={TWO_MIL_IP} period="/ 30d" /></div></div>
-          <div className="prim"><div className="pn">{`<CdrNetworkChip />`}</div><div className="pdemo"><CdrNetworkChip mode="live" /><CdrNetworkChip mode="mock" /></div></div>
-          <div className="prim"><div className="pn">{`<CdrProgress />`}</div><div className="pdemo" style={{ width: "100%" }}><CdrProgress collected={6} threshold={10} /></div></div>
-          <div className="prim"><div className="pn">{`<CdrSpinner />`}</div><div className="pdemo"><CdrSpinner /></div></div>
-          <div className="prim"><div className="pn">{`<CdrError />`}</div><div className="pdemo"><CdrError title="Read timed out" message="Threshold not met in time." /></div></div>
-        </div>
-      </section>
-    </main>
-  );
-}
diff --git a/apps/site/app/docs/components/short-address/page.tsx b/apps/site/app/docs/components/short-address/page.tsx
deleted file mode 100644
index d976203..0000000
--- a/apps/site/app/docs/components/short-address/page.tsx
+++ /dev/null
@@ -1,48 +0,0 @@
-import { ShortAddress } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const CODE = `import { ShortAddress } from "@cdr-kit/react-ui";
-
-<ShortAddress address="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" />`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "ShortAddress"],
-        title: "<ShortAddress>",
-        badges: <Badge tone="primary">DX primitive</Badge>,
-        lede: <>Truncated mono address chip with an inline <code>&lt;CopyButton&gt;</code>. The chip&apos;s default truncation is 6 / 4 (head / tail).</>,
-        importLine: 'import { ShortAddress } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={<ShortAddress address="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" />}
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "address", type: "string", required: true, description: "The full hex address (or any string) to render + copy." },
-                { name: "head", type: "number", defaultValue: "6", description: "Leading characters to keep (after the 0x prefix)." },
-                { name: "tail", type: "number", defaultValue: "4", description: "Trailing characters to keep." },
-                { name: "copyable", type: "boolean", defaultValue: "true", description: "Show the inline copy button." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/copy-button", label: "CopyButton" },
-        next: { href: "/docs/components/explorer-link", label: "ExplorerLink" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/subscribe-button/page.tsx b/apps/site/app/docs/components/subscribe-button/page.tsx
deleted file mode 100644
index 40357cc..0000000
--- a/apps/site/app/docs/components/subscribe-button/page.tsx
+++ /dev/null
@@ -1,53 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { SubscribeButtonDemo } from "@/components/gallery/subscribe-button-demo";
-
-const CODE = `import { CdrProvider } from "@cdr-kit/react";
-import { createMockCdrKit } from "@cdr-kit/core";
-import { SubscribeButton } from "@cdr-kit/react-ui";
-
-<CdrProvider mockKit={createMockCdrKit()}>
-  <SubscribeButton
-    uuid={4200}
-    priceWei={5n * 10n ** 18n}
-    priceLabel="5 $IP"
-  />
-</CdrProvider>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "Components", "SubscribeButton"],
-        title: "<SubscribeButton>",
-        badges: <><Badge tone="primary">styled</Badge><Badge>mock-ready</Badge></>,
-        lede: <>Batteries-included CTA. Wraps <code>useSubscribeAndAccess</code>, renders an inline <code>AccessStepper</code> through the wait phases, then shows the decrypted JSON when access is granted.</>,
-        importLine: 'import { SubscribeButton } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<SubscribeButtonDemo />} code={CODE} badge={<Badge>mock kit</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "The CDR vault id to subscribe to." },
-                { name: "priceWei", type: "bigint", required: true, description: "Total value (wei) sent to subscribe. Use the maxPricePerPeriod from your condition config." },
-                { name: "priceLabel", type: "string", required: true, description: "Human-readable price rendered on the button (e.g. \"5 $IP\")." },
-                { name: "periods", type: "bigint", defaultValue: "1n", description: "Number of subscription periods to pay for in this call." },
-                { name: "subscriptionCondition", type: "Hex", description: "Override the default deployed SubscriptionCondition address." },
-                { name: "onAccess", type: "(bytes: Uint8Array) => void", description: "Called with the decrypted bytes once the flow completes." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/access-stepper", label: "AccessStepper" },
-        next: { href: "/docs/components/vault-card", label: "VaultCard" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/time-window-badge/page.tsx b/apps/site/app/docs/components/time-window-badge/page.tsx
deleted file mode 100644
index f7a8eb0..0000000
--- a/apps/site/app/docs/components/time-window-badge/page.tsx
+++ /dev/null
@@ -1,56 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { TimeWindowBadgeDemo } from "@/components/docs/demos/time-window-badge-demo";
-import "../components.css";
-
-const CODE = `import { TimeWindowBadge } from "@cdr-kit/react";
-
-<TimeWindowBadge uuid={5101} />
-
-// Render-prop for custom presentation:
-<TimeWindowBadge uuid={5101}>
-  {({ isOpen, opensInMs, closesInMs }) =>
-    isOpen
-      ? <span>open · closes in {Math.floor(closesInMs / 60_000)}m</span>
-      : <span>opens in {Math.floor(opensInMs / 3_600_000)}h</span>
-  }
-</TimeWindowBadge>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "TimeWindowBadge"],
-        title: "<TimeWindowBadge>",
-        badges: <><Badge tone="primary">new in 0.5</Badge><Badge>headless</Badge></>,
-        lede: <>Status badge for <code>TimeWindowCondition</code>-gated vaults: <code>opens in 3d 4h</code>, <code>closes in 2h 15m</code>, or <code>closed</code>. Ticks every second client-side, no extra RPC traffic after the first read.</>,
-        importLine: 'import { TimeWindowBadge } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<TimeWindowBadgeDemo />} code={CODE} badge={<Badge>cycles</Badge>} />,
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "TimeWindowCondition-gated vault uuid." },
-                { name: "children", type: "(state: TimeWindowState) => ReactNode", description: "Optional render-prop. Receives { startTs, endTs, blockBased, isOpen, opensInMs, closesInMs, isLoading }." },
-              ]} />
-            ),
-          },
-          {
-            id: "block-based",
-            title: "Block-based windows",
-            content: <p>For windows configured with <code>blockBased: true</code>, the client-side <code>opensInMs</code>/<code>closesInMs</code> return <code>0</code> — block.number can&apos;t be ticked client-side cheaply. Render the raw block bounds from the state object instead.</p>,
-          },
-        ],
-        prev: { href: "/docs/components/heartbeat-timer", label: "HeartbeatTimer" },
-        next: { href: "/docs/components/multi-sig-approval-tracker", label: "MultiSigApprovalTracker" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/unlockable/page.tsx b/apps/site/app/docs/components/unlockable/page.tsx
deleted file mode 100644
index d3a2968..0000000
--- a/apps/site/app/docs/components/unlockable/page.tsx
+++ /dev/null
@@ -1,121 +0,0 @@
-import Link from "next/link";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-import { UnlockableDemo } from "@/components/docs/demos/unlockable-demo";
-import "../components.css";
-
-const CODE = `import { CdrProvider } from "@cdr-kit/react";
-import { createMockCdrKit } from "@cdr-kit/core";
-import { UnlockablePill } from "@cdr-kit/react-ui";
-
-<CdrProvider mockKit={createMockCdrKit()}>
-  <p>
-    Arlo Vance told the press he was alone, but{" "}
-    <UnlockablePill uuid={4242} priceLabel="3 $IP">
-      the woman beside him on the dock
-    </UnlockablePill>{" "}
-    disagrees.
-  </p>
-</CdrProvider>`;
-
-const HOOK_CODE = `import { useUnlockable } from "@cdr-kit/react";
-
-function CustomPill({ uuid }) {
-  const { status, data, isOpen, open, close, request } =
-    useUnlockable({ uuid, mode: "subscribe" });
-
-  return (
-    <span onClick={open}>
-      [click to unlock]
-      {isOpen && (
-        <div role="dialog">
-          {status === "ready" ? render(data) : (
-            <button onClick={() => request()}>Pay 5 $IP</button>
-          )}
-        </div>
-      )}
-    </span>
-  );
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "Components", "Unlockable"],
-        title: "<UnlockablePill>",
-        badges: <><Badge tone="primary">styled</Badge><Badge>new in 0.2</Badge><Badge>mock-ready</Badge></>,
-        lede: <>Inline &quot;free to read, pay to unlock&quot; paywall. Wrap any anchor text in a pill; the click opens a floating card that runs the full CDR <code>subscribe → threshold-read → decrypt</code> flow and reveals the attached payload (text, image, file) right where the pill stands.</>,
-        importLine: 'import { UnlockablePill } from "@cdr-kit/react-ui"',
-        callout: (
-          <Link href="/showcase/blog" className="unl-doc-cta">
-            <span className="unl-doc-cta-eyebrow">live showcase</span>
-            <span className="unl-doc-cta-title">See &lt;UnlockablePill&gt; in a real blog post →</span>
-            <span className="unl-doc-cta-sub">Five live unlocks across text, image, and prose attachments. Mock CDR — no wallet, no chain.</span>
-          </Link>
-        ),
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: <Demo preview={<UnlockableDemo />} code={CODE} badge={<Badge>mock kit</Badge>} />,
-          },
-          {
-            id: "hook",
-            title: "Headless variant",
-            content: (
-              <>
-                <p>
-                  Prefer to render your own UI? <code>useUnlockable</code> exposes the entire state machine — status, data, error, isOpen, open/close, request, reset. The styled <code>UnlockablePill</code> is a 60-line wrapper on top of it.
-                </p>
-                <Demo preview={<div style={{ padding: 18, fontSize: 13, color: "var(--ink-3)" }}>Use the hook for full control. Snippet on the Code tab.</div>} code={HOOK_CODE} language="tsx" />
-              </>
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "The CDR vault holding the encrypted attachment." },
-                { name: "children", type: "ReactNode", required: true, description: "The anchor text (stays plaintext / SEO-visible — it's the teaser, not the secret)." },
-                { name: "priceLabel", type: "string", defaultValue: '"5 $IP"', description: "Human-readable price shown in the unlock card." },
-                { name: "mode", type: '"subscribe" | "access"', defaultValue: '"subscribe"', description: "Subscribe runs the paywall flow; access skips payment (open/tier-gate vaults where the reader already has rights)." },
-                { name: "title", type: "ReactNode", defaultValue: '"Unlock to reveal"', description: "Card header title." },
-                { name: "subtitle", type: "ReactNode", description: "Card header subtitle, e.g. \"1 photo · attached\"." },
-                { name: "unlockedRenderer", type: "(bytes: Uint8Array) => ReactNode", defaultValue: "unlockedAuto", description: "Render the decrypted bytes. Default auto-detects PNG/JPEG/WebP/GIF, falls back to UTF-8 text, then to a download link." },
-                { name: "subscriptionCondition", type: "Hex", description: "Override the default deployed SubscriptionCondition address." },
-              ]} />
-            ),
-          },
-          {
-            id: "mobile",
-            title: "Mobile fallback",
-            content: (
-              <p>
-                Below 560px the floating popover collapses to a bottom-sheet — the card pins to the bottom of the viewport with a safe-area-aware inset. No additional code; the same <code>UnlockablePill</code> handles both.
-              </p>
-            ),
-          },
-          {
-            id: "anchor",
-            title: "The anchor is plaintext — that's intentional",
-            content: (
-              <>
-                <p>
-                  The text inside <code>&lt;UnlockablePill&gt;</code> is a public teaser. Search engines and inspect-element will see it. The <b>encrypted payload</b> is what the vault holds — an image, a file, a hidden paragraph — and that only exists in the DOM after a successful read.
-                </p>
-                <p>
-                  This matches the onscroll.app pattern: highlighted phrases anchor the unlock UX, attached content is the secret. If you want the anchor itself to be the secret, use <code>&lt;VaultGate&gt;</code> instead.
-                </p>
-              </>
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/subscribe-button", label: "SubscribeButton" },
-        next: { href: "/docs/components/vault-card", label: "VaultCard" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/vault-card/page.tsx b/apps/site/app/docs/components/vault-card/page.tsx
deleted file mode 100644
index 0c2a849..0000000
--- a/apps/site/app/docs/components/vault-card/page.tsx
+++ /dev/null
@@ -1,75 +0,0 @@
-import { VaultCard, IpPrice } from "@cdr-kit/react-ui";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-import { Demo } from "@/components/docs/demo";
-
-const FIVE_IP = BigInt(5) * BigInt(10) ** BigInt(18);
-
-const CODE = `import { VaultCard, IpPrice } from "@cdr-kit/react-ui";
-
-<VaultCard
-  uuid={4200}
-  condition="subscription"
-  title="ETH/USD alpha signal"
-  description="Hourly directional signal, threshold-encrypted."
-  dataType="signal"
-  creatorName="0xc183…96E2"
-  price={<IpPrice wei={5n * 10n ** 18n} period="/ 30d" />}
-  href="/vault/4200"
-/>`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react-ui", "Components", "VaultCard"],
-        title: "<VaultCard>",
-        badges: <Badge tone="primary">styled</Badge>,
-        lede: <>Marketplace card with a CSS pointer-tracking spotlight on hover. Renders the condition badge, title, description, optional data type, creator, and price.</>,
-        importLine: 'import { VaultCard } from "@cdr-kit/react-ui"',
-        sections: [
-          {
-            id: "preview",
-            title: "Live preview",
-            content: (
-              <Demo
-                preview={
-                  <div style={{ display: "grid", gridTemplateColumns: "1fr", gap: 16, width: "100%", maxWidth: 380 }}>
-                    <VaultCard
-                      uuid={4200}
-                      condition="subscription"
-                      title="ETH/USD alpha signal"
-                      description="Hourly directional signal, threshold-encrypted. Subscribers decrypt the latest window."
-                      dataType="signal"
-                      creatorName="0xc183…96E2"
-                      price={<IpPrice wei={FIVE_IP} period="/ 30d" />}
-                    />
-                  </div>
-                }
-                code={CODE}
-              />
-            ),
-          },
-          {
-            id: "props",
-            title: "Props",
-            content: (
-              <PropsTable rows={[
-                { name: "uuid", type: "number", required: true, description: "The CDR vault id (rendered in the corner)." },
-                { name: "condition", type: "ConditionKind", required: true, description: "Drives the colored ConditionBadge in the card header." },
-                { name: "title", type: "string", required: true, description: "Card heading." },
-                { name: "description", type: "string", required: true, description: "2-line clamped body description." },
-                { name: "dataType", type: "string", description: "Small chip in the meta row (e.g. \"signal\", \"dataset\")." },
-                { name: "creatorName", type: "string", description: "Truncated address or display name in the footer." },
-                { name: "price", type: "ReactNode", description: "Right-aligned footer price slot — pair with <IpPrice />." },
-                { name: "href", type: "string", description: "Render the card as an <a> linking to the vault detail page." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/subscribe-button", label: "SubscribeButton" },
-        next: { href: "/docs/components/copy-button", label: "CopyButton" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/components/vault-gate/page.tsx b/apps/site/app/docs/components/vault-gate/page.tsx
deleted file mode 100644
index f80ee2d..0000000
--- a/apps/site/app/docs/components/vault-gate/page.tsx
+++ /dev/null
@@ -1,164 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { Breadcrumb, Callout, DocTitle, H2, PrevNext, PropsTable } from "@/components/docs/parts";
-import { Demo } from "@/components/docs/demo";
-import { CodePanel } from "@/components/docs/code-panel";
-import { Toc } from "@/components/docs/toc";
-import { VaultGateDemo } from "@/components/docs/demos/vault-gate-demo";
-
-const CODE = `import { CdrProvider, VaultGate } from "@cdr-kit/react";
-import { createMockCdrKit } from "@cdr-kit/core";
-
-export function SignalCard() {
-  return (
-    <CdrProvider mockKit={createMockCdrKit()}>
-      <VaultGate
-        uuid={4200}
-        fallback={<SubscribeButton price="5 $IP" />}
-        loading={<CdrSkeleton lines={3} />}>
-        {(data) => <pre>{new TextDecoder().decode(data)}</pre>}
-      </VaultGate>
-    </CdrProvider>
-  );
-}`;
-
-const TOC = [
-  { id: "preview", label: "Live preview" },
-  { id: "usage", label: "Usage" },
-  { id: "props", label: "Props" },
-  { id: "states", label: "States" },
-  { id: "mock", label: "Mock mode" },
-];
-
-export default function VaultGatePage() {
-  return (
-    <>
-      <main className="doc">
-        <Breadcrumb parts={["@cdr-kit/react", "Components", "VaultGate"]} />
-        <DocTitle
-          title="VaultGate"
-          badges={
-            <>
-              <Badge tone="primary">component</Badge>
-              <Badge>mock-ready</Badge>
-            </>
-          }
-        />
-        <p className="doc-lede">
-          A declarative gate. Wrap it around the data you want to protect; it checks the vault&apos;s on-chain read condition,
-          collects key shares, and renders the <b>decrypted bytes</b> via a render-prop once access is granted.
-        </p>
-        <div className="doc-imports">
-          <span className="badge mono">import {`{ VaultGate }`} from &quot;@cdr-kit/react&quot;</span>
-        </div>
-
-        <Callout>
-          <b>Mock by default.</b> Every example on this page runs against an in-memory CDR — no wallet, no chain, no testnet
-          funds. Swap <code>mockKit</code> for <code>config</code> + <code>apiUrl</code> to go live on Aeneid.
-        </Callout>
-
-        <H2 id="preview">Live preview</H2>
-        <p>
-          Press subscribe to run the full mock flow — condition check, payment, threshold key-share collection, and local
-          decryption. It mirrors the real 2-step <code>subscribeAndAccess</code> path against the actual{" "}
-          <code>createMockCdrKit()</code> from <code>@cdr-kit/core</code>.
-        </p>
-        <Demo preview={<VaultGateDemo />} code={CODE} badge={<Badge>mock kit</Badge>} />
-
-        <H2 id="usage">Usage</H2>
-        <p>
-          The simplest gate: pass a <code>uuid</code> and a render-prop. With <code>auto</code>, <code>VaultGate</code>{" "}
-          requests access on mount; without it, it waits for an imperative trigger from the access hook.
-        </p>
-        <CodePanel title="SignalCard.tsx" code={`<VaultGate uuid={4200} auto fallback={<SubscribeButton />}>
-  {(data) => <SignalView bytes={data} />}
-</VaultGate>`} />
-
-        <H2 id="props">Props</H2>
-        <PropsTable
-          rows={[
-            {
-              name: "uuid",
-              type: "number",
-              required: true,
-              description: (
-                <>
-                  The CDR vault id. Read it from the <code>VaultCreated</code> event — never predict it (it&apos;s a global
-                  counter).
-                </>
-              ),
-            },
-            {
-              name: "children",
-              type: "(data: Uint8Array) => ReactNode",
-              required: true,
-              description: "Render-prop called with the decrypted bytes once the condition is satisfied.",
-            },
-            {
-              name: "auto",
-              type: "boolean",
-              defaultValue: "false",
-              description: "Request access on mount instead of waiting for an imperative trigger.",
-            },
-            {
-              name: "fallback",
-              type: "ReactNode",
-              defaultValue: "null",
-              description: "Rendered while the condition is unmet — typically your subscribe / pay button.",
-            },
-            {
-              name: "loading",
-              type: "ReactNode",
-              defaultValue: "<CdrSkeleton/>",
-              description: "Rendered during the ~15s threshold read while key shares are collected.",
-            },
-            {
-              name: "accessAuxData",
-              type: "Hex",
-              defaultValue: '"0x"',
-              description: (
-                <>
-                  Optional ABI-encoded auxiliary data passed to the read condition (e.g. a tier-gate license tokenId).
-                </>
-              ),
-            },
-          ]}
-        />
-
-        <H2 id="states">States</H2>
-        <p>
-          <code>VaultGate</code> is a thin wrapper over <code>useAccessVault</code>, whose discriminated{" "}
-          <code>status</code> drives what renders:
-        </p>
-        <ul>
-          <li>
-            <code>idle</code> / <code>error</code> — condition unmet → renders <code>fallback</code>.
-          </li>
-          <li>
-            <code>collecting-partials</code> — collecting key shares (the ~15s read) → renders <code>loading</code>.
-          </li>
-          <li>
-            <code>ready</code> — threshold met, decrypted → renders <code>children(data)</code>.
-          </li>
-        </ul>
-
-        <H2 id="mock">Mock mode</H2>
-        <p>
-          Wrap your tree in a <code>CdrProvider</code> with a <code>createMockCdrKit()</code> and the entire component
-          surface works with zero chain dependencies — ideal for Storybook, tests, and the previews on this page. Going
-          live is a one-line swap:
-        </p>
-        <CodePanel title="provider.tsx" code={`// local / tests — no wallet, no chain
-<CdrProvider mockKit={createMockCdrKit()}> … </CdrProvider>
-
-// live on Aeneid — same children, real round-trip
-<CdrProvider config={wagmiConfig} apiUrl={apiUrl}> … </CdrProvider>`} />
-
-        <PrevNext
-          prev={{ href: "/docs/components/cdr-provider", label: "CdrProvider" }}
-          next={{ href: "/docs/components/vault", label: "Vault compound" }}
-        />
-      </main>
-      <Toc items={TOC} />
-    </>
-  );
-}
diff --git a/apps/site/app/docs/components/vault/page.tsx b/apps/site/app/docs/components/vault/page.tsx
deleted file mode 100644
index 93fb32e..0000000
--- a/apps/site/app/docs/components/vault/page.tsx
+++ /dev/null
@@ -1,51 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const CODE = `<Vault uuid={4200} auto>
-  <Vault.Locked>   <SubscribeButton /> </Vault.Locked>
-  <Vault.Loading>  <CdrSkeleton lines={3} /> </Vault.Loading>
-  <Vault.Unlocked> {(data) => <SignalView bytes={data} />} </Vault.Unlocked>
-</Vault>`;
-
-export default function VaultCompoundPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Components", "Vault"],
-        title: "Vault",
-        badges: <><Badge tone="primary">component</Badge><Badge>compound</Badge></>,
-        lede: (
-          <>
-            Compound component — Clerk&apos;s <code>SignedIn</code> / <code>SignedOut</code> pattern adapted to CDR. A
-            single access drives the shared state; <code>Vault.Locked</code>, <code>Vault.Loading</code>, and{" "}
-            <code>Vault.Unlocked</code> render against it.
-          </>
-        ),
-        importLine: 'import { Vault } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "usage",
-            title: "Usage",
-            content: (
-              <CodePanel title="SignalView.tsx" code={CODE} />
-            ),
-          },
-          {
-            id: "slots",
-            title: "Slots",
-            content: (
-              <ul>
-                <li><code>Vault.Locked</code> — status is <code>idle</code> or <code>error</code>.</li>
-                <li><code>Vault.Loading</code> — status is <code>paying</code> or <code>collecting-partials</code>. Optional render-prop receives <code>{`{ collected, threshold }`}</code>.</li>
-                <li><code>Vault.Unlocked</code> — status is <code>ready</code>. Render-prop receives the decrypted bytes.</li>
-              </ul>
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/vault-gate", label: "VaultGate" },
-        next: { href: "/docs/components/cdr-inspector", label: "CdrInspector" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/cdr-kit-vault/page.tsx b/apps/site/app/docs/contracts/cdr-kit-vault/page.tsx
deleted file mode 100644
index ec98ef3..0000000
--- a/apps/site/app/docs/contracts/cdr-kit-vault/page.tsx
+++ /dev/null
@@ -1,45 +0,0 @@
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "CdrKitVault"],
-        title: "CdrKitVault (factory)",
-        badges: <><Badge tone="primary">factory</Badge><Badge tone="live">deployed</Badge></>,
-        lede: <>The atomic factory: <code>createVault</code> mints the vault NFT, registers it as a Story IP asset, allocates the CDR slot, configures the read condition, and (optionally) attaches PIL license terms — all in one transaction. The configure step is permissioned to the factory only, closing the race a permissionless <code>setConfig</code> would open.</>,
-        importLine: `address = ${aeneid.cdrKitVault}`,
-        sections: [
-          {
-            id: "create",
-            title: "createVault signature",
-            content: (
-              <CodePanel title="CdrKitVault.sol" code={`function createVault(
-  address readConditionAddr,
-  bytes calldata readConfig,
-  address[] calldata childConditions,
-  bytes[] calldata childConfigs,
-  uint256 licenseTermsId
-) external payable returns (uint32 uuid, uint256 tokenId, address ipId);`} />
-            ),
-          },
-          {
-            id: "events",
-            title: "Events",
-            content: <p>Emits <code>VaultCreated(tokenId, uuid, ipId, creator, licenseTermsId)</code> — read the <code>uuid</code> from the tx receipt; never predict it (global counter).</p>,
-          },
-          {
-            id: "gas",
-            title: "Gas note",
-            content: <p>The factory nests a CDR precompile call (<code>allocate</code>) whose gas <code>eth_estimateGas</code> underestimates. Always set an explicit gas limit (<code>3_000_000</code> is the SDK default).</p>,
-          },
-        ],
-        prev: { href: "/docs/contracts/creator-write-condition", label: "CreatorWriteCondition" },
-        next: { href: "/docs/scaffolder", label: "npm create cdr-kit" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/composable-condition/page.tsx b/apps/site/app/docs/contracts/composable-condition/page.tsx
deleted file mode 100644
index 2e8968e..0000000
--- a/apps/site/app/docs/contracts/composable-condition/page.tsx
+++ /dev/null
@@ -1,36 +0,0 @@
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "ComposableCondition"],
-        title: "ComposableCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge>boolean</Badge></>,
-        lede: <>Boolean AND / OR over child conditions, up to 8 deep. Compose &quot;Subscription <code>OR</code> Tier&quot; or &quot;Royalty <code>AND</code> License&quot; — natively, on chain, in one read check.</>,
-        importLine: `address = ${aeneid.composableCondition}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <ul>
-                <li><code>mode: uint8</code> — 0 = AND, 1 = OR.</li>
-                <li><code>children: address[]</code> — child condition addresses (1–8).</li>
-              </ul>
-            ),
-          },
-          {
-            id: "aux",
-            title: "accessAuxData",
-            content: <p>ABI-encoded <code>bytes[]</code> of per-child aux, aligned to the configured children order.</p>,
-          },
-        ],
-        prev: { href: "/docs/contracts/tier-gate-condition", label: "TierGateCondition" },
-        next: { href: "/docs/contracts/open-condition", label: "OpenCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/conditional-escrow-condition/page.tsx b/apps/site/app/docs/contracts/conditional-escrow-condition/page.tsx
deleted file mode 100644
index c97af42..0000000
--- a/apps/site/app/docs/contracts/conditional-escrow-condition/page.tsx
+++ /dev/null
@@ -1,52 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-
-// Hardcoded until @cdr-kit/contracts@0.5.0 publishes (apps/site consumes ^0.4.0 from npm).
-const ESCROW_ADDRESS = "0x7fcDe02DB7c14fD3587aB2fED064a1D8355b7584";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "ConditionalEscrowCondition"],
-        title: "ConditionalEscrowCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Buyer pays → confirms delivery → seller paid + buyer reads. Optional arbiter can refund. Seller can <code>claimAfterTimeout(buyer)</code> if the buyer goes silent.</>,
-        importLine: `address = ${ESCROW_ADDRESS}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <PropsTable rows={[
-                { name: "seller", type: "address", required: true, description: "Receives funds on confirmDelivery / claimAfterTimeout." },
-                { name: "price", type: "uint128", required: true, description: "Listing price in wei (native IP)." },
-                { name: "timeoutSecs", type: "uint64", required: true, description: "Seconds after paidAt before the seller can claim unilaterally." },
-                { name: "arbiter", type: "address", required: true, description: "Optional dispute resolver. address(0) = no refund path." },
-              ]} />
-            ),
-          },
-          {
-            id: "flow",
-            title: "Flow",
-            content: (
-              <ol>
-                <li><code>pay(uuid)</code> — buyer escrows the price (excess refunded same tx).</li>
-                <li><code>confirmDelivery(uuid)</code> — buyer signs off → seller paid + buyer reads.</li>
-                <li><code>claimAfterTimeout(uuid, buyer)</code> — seller only, after <code>paidAt + timeoutSecs</code>.</li>
-                <li><code>arbiterRefund(uuid, buyer)</code> — arbiter only; resets paidAt and refunds the buyer.</li>
-              </ol>
-            ),
-          },
-          {
-            id: "intrinsic",
-            title: "Intrinsic CDR limitation",
-            content: <p>CDR has no confidential compute — once a buyer reads, they hold plaintext forever. The dispute path can revoke future access but cannot &quot;un-read.&quot; Document this in your buyer UX.</p>,
-          },
-        ],
-        prev: { href: "/docs/contracts/dead-man-switch-condition", label: "DeadManSwitchCondition" },
-        next: { href: "/docs/contracts/multi-sig-condition", label: "MultiSigCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/creator-write-condition/page.tsx b/apps/site/app/docs/contracts/creator-write-condition/page.tsx
deleted file mode 100644
index e9f7534..0000000
--- a/apps/site/app/docs/contracts/creator-write-condition/page.tsx
+++ /dev/null
@@ -1,22 +0,0 @@
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "CreatorWriteCondition"],
-        title: "CreatorWriteCondition",
-        badges: <Badge tone="live">deployed</Badge>,
-        lede: <>The default write gate when you mint through <code>CdrKitVault</code>: only the original creator (vault NFT owner) can write encrypted payloads. Factory-aware variant of <code>OwnerWriteCondition</code>.</>,
-        importLine: `address = ${aeneid.creatorWriteCondition}`,
-        sections: [
-          { id: "config", title: "Config", content: <p>No config bytes required — the factory wires the creator at allocation time.</p> },
-        ],
-        prev: { href: "/docs/contracts/open-condition", label: "OpenCondition" },
-        next: { href: "/docs/contracts/cdr-kit-vault", label: "CdrKitVault" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/dead-man-switch-condition/page.tsx b/apps/site/app/docs/contracts/dead-man-switch-condition/page.tsx
deleted file mode 100644
index 7cb1fe5..0000000
--- a/apps/site/app/docs/contracts/dead-man-switch-condition/page.tsx
+++ /dev/null
@@ -1,46 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-
-// Hardcoded until @cdr-kit/contracts@0.5.0 publishes (apps/site consumes ^0.4.0 from npm).
-const DEAD_MAN_ADDRESS = "0x37226f97e184843aB0b8d4f08A55969801B97766";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "DeadManSwitchCondition"],
-        title: "DeadManSwitchCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Auto-unlock to heir(s) (or public) if the creator stops calling <code>poke()</code> within <code>duration</code>. The wallet-recovery / estate-planning / leak-on-disappearance primitive Story docs reference.</>,
-        importLine: `address = ${DEAD_MAN_ADDRESS}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <PropsTable rows={[
-                { name: "duration", type: "uint64", required: true, description: "Heartbeat window length (seconds OR blocks). Must be > 0." },
-                { name: "heirs", type: "address[]", required: true, description: "Allowed readers post-unlock if publicAfterUnlock = false. Empty array forces publicAfterUnlock to true." },
-                { name: "blockBased", type: "bool", required: true, description: "true = interpret duration as block count." },
-                { name: "creatorCanReadWhileLocked", type: "bool", required: true, description: "Creator reads their own vault pre-unlock (default true via agent helper)." },
-                { name: "publicAfterUnlock", type: "bool", required: true, description: "true = anyone reads post-unlock; false = restricted to heirs." },
-              ]} />
-            ),
-          },
-          {
-            id: "trapdoor",
-            title: "The trapdoor",
-            content: <p>Post-unlock, the creator gets NO special treatment. If <code>publicAfterUnlock = false</code> AND the creator isn&apos;t in <code>heirs</code>, they lose read access permanently at unlock — by design. <code>agent.createDeadManVault</code> defaults <code>creatorCanReadWhileLocked = true</code> and recommends adding the creator to <code>heirs</code> for post-unlock access.</p>,
-          },
-          {
-            id: "poke",
-            title: "poke()",
-            content: <p>Creator-only. Cannot be called after <code>unlockAt</code> (one-way trapdoor — reviving would let a late-poking creator block heirs forever). Most operational risk is forgetting to poke; consider a self-hosted cron or Gelato Automate for long durations.</p>,
-          },
-        ],
-        prev: { href: "/docs/contracts/time-window-condition", label: "TimeWindowCondition" },
-        next: { href: "/docs/contracts/conditional-escrow-condition", label: "ConditionalEscrowCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/multi-sig-condition/page.tsx b/apps/site/app/docs/contracts/multi-sig-condition/page.tsx
deleted file mode 100644
index a8545e1..0000000
--- a/apps/site/app/docs/contracts/multi-sig-condition/page.tsx
+++ /dev/null
@@ -1,66 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-
-// Hardcoded until @cdr-kit/contracts@0.5.0 publishes (apps/site consumes ^0.4.0 from npm).
-// 0x61061c… is the 0.5 redeploy with on-chain `approve()` path added; previous 0xb22EBF…
-// retired (off-chain-only — same epoch + sig logic but no on-chain approve fn).
-const MULTI_SIG_ADDRESS = "0x61061CCb8BD4C9E0AfF67ed4d2226f0Fc140FB87";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "MultiSigCondition"],
-        title: "MultiSigCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge tone="primary">first-of-kind</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>N-of-M read gate with <b>two parallel approval paths</b>: off-chain EIP-712 sigs (gas-free; buyer collects + submits at read time) OR Safe-style on-chain <code>approve()</code> (signers pay gas; dashboards read chain truth). A read passes when EITHER path meets <code>threshold</code>. First-of-kind in the CDR ecosystem.</>,
-        importLine: `address = ${MULTI_SIG_ADDRESS}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <PropsTable rows={[
-                { name: "signers", type: "address[]", required: true, description: "Allowed signers. MUST be sorted strictly ascending (agent helper auto-sorts)." },
-                { name: "threshold", type: "uint16", required: true, description: "Minimum sigs required (1 ≤ threshold ≤ signers.length)." },
-              ]} />
-            ),
-          },
-          {
-            id: "eip712",
-            title: "EIP-712 Approval",
-            content: (
-              <ul>
-                <li>Domain: <code>cdr-kit:MultiSigCondition</code>, version <code>1</code>, chainId 1315, verifyingContract = condition address.</li>
-                <li>Type: <code>Approval(uint32 uuid, address caller, uint64 epoch, uint64 deadline)</code>.</li>
-                <li><code>caller</code> binding prevents sig replay against a different reader; <code>epoch</code> rotation invalidates in-flight sigs.</li>
-              </ul>
-            ),
-          },
-          {
-            id: "onchain-approve",
-            title: "On-chain approve() — the Safe-style path",
-            content: (
-              <>
-                <p>For dashboards that prefer chain-truth over off-chain sig collection, signers call <code>approve(uuid)</code> on-chain. Each approval costs ~50k gas. <code>currentApprovalsCount(uuid)</code> returns the count for the active epoch — read it directly in your UI via <code>useMultiSigStatus</code>.</p>
-                <p>Storage shape (epoch-scoped, so rotation auto-invalidates): <code>hasApproved[uuid][epoch][signer]</code> + <code>approvalsCount[uuid][epoch]</code>. Emits <code>Approved(uuid, signer, epoch)</code> for indexers.</p>
-              </>
-            ),
-          },
-          {
-            id: "rotation",
-            title: "rotateSigners()",
-            content: <p>Creator-only. Validates the new signer set + threshold, bumps <code>epoch</code> — invalidates BOTH off-chain sigs (signed against the old epoch) AND on-chain approvals (the count under the old epoch key no longer matters since reads check the new epoch). Use this to remove a compromised signer immediately.</p>,
-          },
-          {
-            id: "limitations",
-            title: "Limitations",
-            content: <p>EIP-1271 (Safe / contract-wallet signers) not supported in 0.5 — <code>ecrecover</code> handles EOAs only. Workaround: have a Safe-owned EOA sign on behalf and register that EOA.</p>,
-          },
-        ],
-        prev: { href: "/docs/contracts/conditional-escrow-condition", label: "ConditionalEscrowCondition" },
-        next: { href: "/docs/contracts/cdr-kit-vault", label: "CdrKitVault" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/open-condition/page.tsx b/apps/site/app/docs/contracts/open-condition/page.tsx
deleted file mode 100644
index 4ff5c43..0000000
--- a/apps/site/app/docs/contracts/open-condition/page.tsx
+++ /dev/null
@@ -1,20 +0,0 @@
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "OpenCondition"],
-        title: "OpenCondition",
-        badges: <Badge tone="live">deployed</Badge>,
-        lede: <>Always returns <code>true</code>. Use as a fallback / sanity gate, or as the read condition for genuinely public data.</>,
-        importLine: `address = ${aeneid.openCondition}`,
-        sections: [{ id: "config", title: "Config", content: <p>No config bytes required — pass <code>0x</code>.</p> }],
-        prev: { href: "/docs/contracts/composable-condition", label: "ComposableCondition" },
-        next: { href: "/docs/contracts/creator-write-condition", label: "CreatorWriteCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/page.tsx b/apps/site/app/docs/contracts/page.tsx
deleted file mode 100644
index 46801c8..0000000
--- a/apps/site/app/docs/contracts/page.tsx
+++ /dev/null
@@ -1,66 +0,0 @@
-import Link from "next/link";
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function ContractsPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Contracts"],
-        title: "Condition standard library",
-        badges: <Badge tone="primary">@cdr-kit/contracts</Badge>,
-        lede: <>A tested Solidity standard library + a factory (<code>CdrKitVault</code>) that mints, registers IP, allocates the CDR slot, and configures the read condition in one transaction. All deployed to Aeneid testnet (chain id <code>{aeneid.chainId}</code>).</>,
-        importLine: 'import { aeneid } from "@cdr-kit/contracts"',
-        sections: [
-          {
-            id: "library",
-            title: "Library",
-            content: (
-              <ul>
-                <li><Link href="/docs/contracts/subscription-condition"><code>SubscriptionCondition</code></Link></li>
-                <li><Link href="/docs/contracts/tier-gate-condition"><code>TierGateCondition</code></Link></li>
-                <li><Link href="/docs/contracts/composable-condition"><code>ComposableCondition</code></Link></li>
-                <li><Link href="/docs/contracts/open-condition"><code>OpenCondition</code></Link></li>
-                <li><Link href="/docs/contracts/creator-write-condition"><code>CreatorWriteCondition</code></Link></li>
-                <li><Link href="/docs/contracts/cdr-kit-vault"><code>CdrKitVault</code></Link> — the factory</li>
-              </ul>
-            ),
-          },
-          {
-            id: "interface",
-            title: "Condition interface",
-            content: (
-              <>
-                <p>Conditions are pure <code>view</code> functions the validator network calls at read/write time. The 4-param signature:</p>
-                <CodePanel title="ICdrCondition.sol" code={`function checkReadCondition(
-  uint32 uuid,
-  bytes accessAuxData,
-  bytes conditionData,
-  address caller
-) external view returns (bool);`} />
-              </>
-            ),
-          },
-          {
-            id: "addresses",
-            title: "Deployed (Aeneid)",
-            content: (
-              <ul style={{ fontFamily: "var(--mono)", fontSize: "0.82rem" }}>
-                <li>CdrKitVault: <code>{aeneid.cdrKitVault}</code></li>
-                <li>SubscriptionCondition: <code>{aeneid.subscriptionCondition}</code></li>
-                <li>TierGateCondition: <code>{aeneid.tierGateCondition}</code></li>
-                <li>ComposableCondition: <code>{aeneid.composableCondition}</code></li>
-                <li>OpenCondition: <code>{aeneid.openCondition}</code></li>
-                <li>CreatorWriteCondition: <code>{aeneid.creatorWriteCondition}</code></li>
-              </ul>
-            ),
-          },
-        ],
-        prev: { href: "/docs/agent-kit/mcp", label: "MCP server" },
-        next: { href: "/docs/contracts/subscription-condition", label: "SubscriptionCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/subscription-condition/page.tsx b/apps/site/app/docs/contracts/subscription-condition/page.tsx
deleted file mode 100644
index 634cd36..0000000
--- a/apps/site/app/docs/contracts/subscription-condition/page.tsx
+++ /dev/null
@@ -1,34 +0,0 @@
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "SubscriptionCondition"],
-        title: "SubscriptionCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge>recurring</Badge></>,
-        lede: <>Recurring paid access. The buyer calls <code>subscribe(uuid, periods, maxPricePerPeriod)</code> with the right <code>value</code>; subsequent reads pass until the subscription expires.</>,
-        importLine: `address = ${aeneid.subscriptionCondition}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <PropsTable rows={[
-                { name: "pricePerPeriod", type: "uint256", required: true, description: "Price in wei per subscription period." },
-                { name: "period", type: "uint256", required: true, description: "Period length in seconds." },
-                { name: "payee", type: "address", required: true, description: "Where subscription value is routed." },
-                { name: "mode", type: "uint8", required: true, description: "0 = native IP, 1 = WIP royalty routing." },
-                { name: "licensorIpId", type: "address", description: "Required in royalty mode; 0x0 in native mode." },
-              ]} />
-            ),
-          },
-        ],
-        prev: { href: "/docs/contracts", label: "Condition library" },
-        next: { href: "/docs/contracts/tier-gate-condition", label: "TierGateCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/tier-gate-condition/page.tsx b/apps/site/app/docs/contracts/tier-gate-condition/page.tsx
deleted file mode 100644
index 1cddd80..0000000
--- a/apps/site/app/docs/contracts/tier-gate-condition/page.tsx
+++ /dev/null
@@ -1,36 +0,0 @@
-import { aeneid } from "@cdr-kit/contracts";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "TierGateCondition"],
-        title: "TierGateCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge>licensed</Badge></>,
-        lede: <>Gate by a held Story IP license-token tier. The buyer passes the tokenId of their license as <code>accessAuxData</code>; the condition verifies ownership + that the tier is in the allowed set.</>,
-        importLine: `address = ${aeneid.tierGateCondition}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <ul>
-                <li><code>ipId: address</code> — the IP asset the license must reference.</li>
-                <li><code>allowedTermsIds: uint256[]</code> — accepted PIL terms ids (≥1).</li>
-              </ul>
-            ),
-          },
-          {
-            id: "aux",
-            title: "accessAuxData",
-            content: <p>ABI-encoded <code>uint256</code> tokenId of the license the caller holds.</p>,
-          },
-        ],
-        prev: { href: "/docs/contracts/subscription-condition", label: "SubscriptionCondition" },
-        next: { href: "/docs/contracts/composable-condition", label: "ComposableCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/contracts/time-window-condition/page.tsx b/apps/site/app/docs/contracts/time-window-condition/page.tsx
deleted file mode 100644
index 36fac04..0000000
--- a/apps/site/app/docs/contracts/time-window-condition/page.tsx
+++ /dev/null
@@ -1,45 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage, PropsTable } from "@/components/docs/doc-page";
-
-// Hardcoded until @cdr-kit/contracts@0.5.0 publishes (apps/site consumes ^0.4.0 from npm).
-const TIME_WINDOW_ADDRESS = "0x67911435F262e7e4EC4F7FEB4e868a67b9dd90b1";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/contracts", "Conditions", "TimeWindowCondition"],
-        title: "TimeWindowCondition",
-        badges: <><Badge tone="live">deployed</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Read access is allowed only during <code>[startTs, endTs]</code>. <code>endTs == 0</code> means open-ended (release-on-date pattern). Block-based mode (<code>blockBased: true</code>) is preferred for short horizons.</>,
-        importLine: `address = ${TIME_WINDOW_ADDRESS}`,
-        sections: [
-          {
-            id: "config",
-            title: "Config shape",
-            content: (
-              <PropsTable rows={[
-                { name: "startTs", type: "uint64", required: true, description: "Start timestamp (or block number if blockBased)." },
-                { name: "endTs", type: "uint64", required: true, description: "End (0 = open-ended)." },
-                { name: "blockBased", type: "bool", required: true, description: "true = interpret startTs/endTs as block.number; false = block.timestamp." },
-              ]} />
-            ),
-          },
-          {
-            id: "presets",
-            title: "Agent presets",
-            content: (
-              <ul>
-                <li><code>releaseOnDate(startTs)</code> → <code>(startTs, 0, false)</code> — open-ended after a date.</li>
-                <li><code>availableDuring(startTs, endTs)</code> → <code>(startTs, endTs, false)</code> — bounded window.</li>
-                <li><code>releaseAfterBlocks(blockNum)</code> → <code>(0, blockNum, true)</code> — block-based release.</li>
-              </ul>
-            ),
-          },
-        ],
-        prev: { href: "/docs/contracts/cdr-kit-vault", label: "CdrKitVault" },
-        next: { href: "/docs/contracts/dead-man-switch-condition", label: "DeadManSwitchCondition" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/docs.css b/apps/site/app/docs/docs.css
index 157cdaf..d6f62fc 100644
--- a/apps/site/app/docs/docs.css
+++ b/apps/site/app/docs/docs.css
@@ -234,3 +234,107 @@
   .doc-nav-foot { flex-direction: column; gap: 10px; }
   .doc-nav-foot .next { text-align: left; }
 }
+
+/* T1-F: per-page Copy Page button — appears in the title row as a "badge".
+ * Style mirrors the existing .badge with a hover affordance + flash on copy. */
+.copy-page-btn {
+  display: inline-flex; align-items: center; gap: 6px;
+  padding: 6px 10px;
+  border-radius: 8px;
+  border: 1px solid var(--line, oklch(22% 0.012 90));
+  background: color-mix(in oklab, var(--paper, oklch(17% 0.012 90)) 80%, transparent);
+  color: var(--ink-2, oklch(70% 0.012 90));
+  font-family: ui-monospace, monospace;
+  font-size: 0.74rem;
+  line-height: 1;
+  cursor: pointer;
+  transition: background 120ms ease, color 120ms ease, border-color 120ms ease;
+}
+.copy-page-btn:hover {
+  border-color: color-mix(in oklab, var(--accent, oklch(78% 0.16 70)) 50%, var(--line));
+  color: var(--ink, oklch(94% 0.01 90));
+  background: color-mix(in oklab, var(--paper, oklch(17% 0.012 90)) 92%, transparent);
+}
+.copy-page-btn[data-copied] {
+  color: oklch(72% 0.18 145);
+  border-color: color-mix(in oklab, oklch(72% 0.18 145) 60%, var(--line));
+}
+
+/* T2-C: docs Demo live overlay — frosted backdrop with a connect-wallet CTA
+ * shown over the preview when the user has no wallet or is on the wrong chain. */
+.docs-live-wrap { position: relative; }
+.docs-live-overlay {
+  position: absolute; inset: 0; z-index: 5;
+  display: grid; place-items: center;
+  border-radius: inherit;
+  background: color-mix(in oklab, var(--paper, oklch(17% 0.012 90)) 70%, transparent);
+  backdrop-filter: blur(10px) saturate(140%);
+}
+.docs-live-card {
+  text-align: center;
+  padding: 18px 22px;
+  max-width: 320px;
+  background: color-mix(in oklab, var(--paper, oklch(17% 0.012 90)) 92%, transparent);
+  border: 1px solid var(--line, oklch(22% 0.012 90));
+  border-radius: 12px;
+  box-shadow: 0 20px 40px -16px color-mix(in oklab, oklch(0% 0 0) 60%, transparent);
+}
+.docs-live-eyebrow {
+  font-family: ui-monospace, monospace; font-size: 0.66rem;
+  color: var(--accent, oklch(78% 0.16 70));
+  letter-spacing: 0.10em; text-transform: uppercase; margin: 0 0 8px;
+}
+.docs-live-title { font-size: 0.96rem; font-weight: 700; margin: 0 0 6px; color: var(--ink, oklch(94% 0.01 90)); }
+.docs-live-sub { font-size: 0.84rem; line-height: 1.5; color: var(--ink-2, oklch(70% 0.01 90)); margin: 0 0 14px; }
+.docs-live-card [data-rk] { display: inline-block; }
+
+/* M2: components gallery grid — "at a glance" tiles for /docs/components */
+[data-components-gallery] { display: flex; flex-direction: column; gap: 48px; margin-top: 8px; }
+[data-gallery-section-head] { margin: 0 0 18px; }
+[data-gallery-section-head] h3 { margin: 0 0 4px; font-size: 1.05rem; font-weight: 700; letter-spacing: -0.01em; }
+[data-gallery-hint] { margin: 0; font-size: 0.86rem; color: var(--ink-2, oklch(70% 0.012 90)); }
+[data-gallery-grid] {
+  display: grid; gap: 14px;
+  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+}
+[data-gallery-tile] {
+  display: flex; flex-direction: column;
+  min-height: 130px;
+  padding: 14px 16px 12px;
+  background: var(--paper, oklch(17% 0.012 90));
+  border: 1px solid var(--line, oklch(22% 0.012 90));
+  border-radius: 12px;
+  text-decoration: none; color: inherit;
+  transition: border-color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
+}
+[data-gallery-tile]:hover {
+  border-color: color-mix(in oklab, var(--accent, oklch(78% 0.16 70)) 50%, var(--line));
+  transform: translateY(-1px);
+  box-shadow: 0 6px 16px -8px color-mix(in oklab, oklch(0% 0 0) 50%, transparent);
+}
+[data-tile-preview] {
+  flex: 1;
+  display: grid; place-items: center;
+  padding: 10px 6px;
+  margin-bottom: 10px;
+  border-radius: 8px;
+  background: color-mix(in oklab, var(--paper-2, oklch(20% 0.012 90)) 60%, transparent);
+  min-height: 48px;
+  text-align: center;
+}
+[data-tile-headless] {
+  font-family: ui-monospace, monospace;
+  font-size: 0.74rem;
+  line-height: 1.4;
+  color: var(--ink-3, oklch(56% 0.01 90));
+}
+[data-tile-meta] { display: flex; align-items: baseline; justify-content: space-between; gap: 10px; min-width: 0; }
+[data-tile-label] {
+  font-family: ui-monospace, monospace; font-size: 0.82rem; font-weight: 600;
+  color: var(--ink, oklch(94% 0.01 90));
+  white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+[data-tile-import] {
+  font-family: ui-monospace, monospace; font-size: 0.66rem;
+  color: var(--ink-3, oklch(56% 0.01 90)); white-space: nowrap;
+}
diff --git a/apps/site/app/docs/hooks/use-access-vault/page.tsx b/apps/site/app/docs/hooks/use-access-vault/page.tsx
deleted file mode 100644
index a9c1a14..0000000
--- a/apps/site/app/docs/hooks/use-access-vault/page.tsx
+++ /dev/null
@@ -1,46 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function useAccessVault(uuid: number): {
-  access: (accessAuxData?: Hex) => Promise<Uint8Array>;
-  status: "idle" | "collecting-partials" | "ready" | "error";
-  data?: Uint8Array;
-  error?: CdrError;
-  progress?: { collected: number; threshold: number };  // mock-mode only
-};`;
-
-export default function UseAccessVaultPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useAccessVault"],
-        title: "useAccessVault",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>Imperative access to one vault. Returns a discriminated status + the decrypted bytes when ready. The state machine behind <code>&lt;VaultGate&gt;</code> and <code>&lt;Vault&gt;</code>.</>,
-        importLine: 'import { useAccessVault } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "signature",
-            title: "Signature",
-            content: <CodePanel title="type" code={SIG} language="ts" />,
-          },
-          {
-            id: "states",
-            title: "States",
-            content: (
-              <ul>
-                <li><code>idle</code> — initial; call <code>access()</code> to begin.</li>
-                <li><code>collecting-partials</code> — the ~15s threshold read.</li>
-                <li><code>ready</code> — <code>data</code> populated.</li>
-                <li><code>error</code> — see <code>error</code> for the typed reason.</li>
-              </ul>
-            ),
-          },
-        ],
-        prev: { href: "/docs/components/empty-vaults", label: "EmptyVaults" },
-        next: { href: "/docs/hooks/use-subscribe-and-access", label: "useSubscribeAndAccess" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-attach-license-terms/page.tsx b/apps/site/app/docs/hooks/use-attach-license-terms/page.tsx
deleted file mode 100644
index fa0becb..0000000
--- a/apps/site/app/docs/hooks/use-attach-license-terms/page.tsx
+++ /dev/null
@@ -1,84 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function useAttachLicenseTerms(client: StoryClient | undefined): {
-  attach: (params: {
-    ipId: Hex;
-    licenseTermsId: bigint;
-    licenseTemplate?: Hex;   // defaults to the canonical PIL template
-  }) => Promise<{ txHash: Hex }>;
-  isLoading: boolean;
-  error?: Error;
-};`;
-
-const EXAMPLE = `import { useStoryClient, useAttachLicenseTerms } from "@cdr-kit/react";
-
-function AttachTerms({ ipId, licenseTermsId }) {
-  const client = useStoryClient();
-  const { attach, isLoading, error } = useAttachLicenseTerms(client);
-  return (
-    <>
-      <button
-        disabled={!client || isLoading}
-        onClick={() => attach({ ipId, licenseTermsId })}
-      >
-        {isLoading ? "attaching…" : "attach PIL terms"}
-      </button>
-      {error && <span>{error.message}</span>}
-    </>
-  );
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useAttachLicenseTerms"],
-        title: "useAttachLicenseTerms",
-        badges: (
-          <>
-            <Badge tone="primary">hook</Badge>
-            <Badge>new in 0.5</Badge>
-            <Badge>Story IP</Badge>
-          </>
-        ),
-        lede: (
-          <>
-            Attach an existing PIL <code>licenseTermsId</code> to an IP asset — required before any
-            buyer can <code>mintLicenseTokens</code> against it. Idempotent: calling twice with the
-            same args is a no-op tx (still costs gas, so check first if you can).
-          </>
-        ),
-        importLine: 'import { useAttachLicenseTerms } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={SIG} /> },
-          { id: "example", title: "Example", content: <CodePanel title="tsx" language="tsx" code={EXAMPLE} /> },
-          {
-            id: "ordering",
-            title: "Call ordering",
-            content: (
-              <p>
-                The flow is: (1) <code>registerIpAsset</code> → ipId, (2) <code>registerPilTerms</code>{" "}
-                → licenseTermsId (or use a previously registered set), (3) <code>attachLicenseTerms</code>{" "}
-                links the two. Only then can buyers mint license tokens against your IP.
-              </p>
-            ),
-          },
-          {
-            id: "template",
-            title: "License template",
-            content: (
-              <p>
-                <code>licenseTemplate</code> defaults to the canonical Story PIL template. Override
-                only if you&apos;ve registered a custom template at the protocol level — rare.
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-mint-license-token", label: "useMintLicenseToken" },
-        next: { href: "/docs/hooks/use-publish", label: "usePublish" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-cdr-wallet/page.tsx b/apps/site/app/docs/hooks/use-cdr-wallet/page.tsx
deleted file mode 100644
index 65bde61..0000000
--- a/apps/site/app/docs/hooks/use-cdr-wallet/page.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useCdrWallet"],
-        title: "useCdrWallet",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>Lightweight wallet connect for the simple path: pairs with <code>&lt;CdrProvider&gt;</code>&apos;s built-in injected connector. Bring your own wallet stack (Privy / RainbowKit) for the rich path.</>,
-        importLine: 'import { useCdrWallet } from "@cdr-kit/react"',
-        sections: [{ id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useCdrWallet(): {
-  address?: Hex;
-  isConnected: boolean;
-  isConnecting: boolean;
-  error: Error | null;
-  connect: () => void;
-  disconnect: () => void;
-};`} /> }],
-        prev: { href: "/docs/hooks/use-creator-vaults", label: "useCreatorVaults" },
-        next: { href: "/docs/agent-kit", label: "Agent kit" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-create-vault/page.tsx b/apps/site/app/docs/hooks/use-create-vault/page.tsx
deleted file mode 100644
index 1b6d21d..0000000
--- a/apps/site/app/docs/hooks/use-create-vault/page.tsx
+++ /dev/null
@@ -1,29 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useCreateVault"],
-        title: "useCreateVault",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>Seller-side: call the <code>CdrKitVault</code> factory to mint the NFT, register the IP asset, allocate the CDR slot, and configure the read condition — in one transaction.</>,
-        importLine: 'import { useCreateVault } from "@cdr-kit/react"',
-        sections: [{ id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useCreateVault(): (params: {
-  readConditionAddr: Hex;
-  readConfig: Hex;
-  childConditions?: Hex[];
-  childConfigs?: Hex[];
-  licenseTermsId?: bigint;
-  value?: bigint;
-  gas?: bigint;
-  vault?: Hex;
-}) => Promise<Hash>;`} /> }],
-        prev: { href: "/docs/hooks/use-subscribe-and-access", label: "useSubscribeAndAccess" },
-        next: { href: "/docs/hooks/use-discover-vaults", label: "useDiscoverVaults" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-creator-vaults/page.tsx b/apps/site/app/docs/hooks/use-creator-vaults/page.tsx
deleted file mode 100644
index bc7ec5e..0000000
--- a/apps/site/app/docs/hooks/use-creator-vaults/page.tsx
+++ /dev/null
@@ -1,25 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useCreatorVaults"],
-        title: "useCreatorVaults",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>Returns the token ids owned by a given creator address — wraps the factory&apos;s <code>getCreatorVaults(address)</code>. Standard wagmi <code>useReadContract</code> result shape.</>,
-        importLine: 'import { useCreatorVaults } from "@cdr-kit/react"',
-        sections: [{ id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useCreatorVaults(creator?: Hex): {
-  data?: readonly bigint[];
-  isLoading: boolean;
-  error?: Error;
-  // …plus the rest of wagmi's useReadContract return
-};`} /> }],
-        prev: { href: "/docs/hooks/use-vault-events", label: "useVaultEvents" },
-        next: { href: "/docs/hooks/use-cdr-wallet", label: "useCdrWallet" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-dead-man-timer/page.tsx b/apps/site/app/docs/hooks/use-dead-man-timer/page.tsx
deleted file mode 100644
index 1690dc5..0000000
--- a/apps/site/app/docs/hooks/use-dead-man-timer/page.tsx
+++ /dev/null
@@ -1,32 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useDeadManTimer"],
-        title: "useDeadManTimer",
-        badges: <><Badge tone="primary">hook</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Live countdown to <code>DeadManSwitchCondition.unlockAt</code> + a creator-only <code>poke()</code> action. The data source for <code>&lt;HeartbeatTimer&gt;</code>.</>,
-        importLine: 'import { useDeadManTimer } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useDeadManTimer(uuid: number, address?: Hex): {
-  unlocksAt?: bigint;
-  duration?: bigint;
-  blockBased?: boolean;
-  remainingMs: number;
-  isUnlocked: boolean;
-  isCritical: boolean;   // < 25% of duration left
-  poke: () => Promise<Hex>;
-  isLoading: boolean;
-};`} /> },
-          { id: "address-override", title: "Address override", content: <p>The default reads from <code>aeneid.deadManSwitchCondition</code>. Pass <code>address</code> to point at a custom deployment (e.g. mainnet once it ships).</p> },
-        ],
-        prev: { href: "/docs/hooks/use-cdr-wallet", label: "useCdrWallet" },
-        next: { href: "/docs/hooks/use-time-window-state", label: "useTimeWindowState" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-discover-vaults/page.tsx b/apps/site/app/docs/hooks/use-discover-vaults/page.tsx
deleted file mode 100644
index c618522..0000000
--- a/apps/site/app/docs/hooks/use-discover-vaults/page.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useDiscoverVaults"],
-        title: "useDiscoverVaults",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>One-shot historical scan of the factory&apos;s <code>VaultCreated</code> events. Paginates inside a bounded RPC window. For live feeds, pair with <code>useVaultEvents</code>.</>,
-        importLine: 'import { useDiscoverVaults } from "@cdr-kit/react"',
-        sections: [{ id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useDiscoverVaults(opts?: {
-  fromBlock?: bigint;
-  enabled?: boolean;  // skip the scan entirely (mock mode)
-}): {
-  vaults: VaultCreatedEvent[];
-  isLoading: boolean;
-  error?: Error;
-};`} /> }],
-        prev: { href: "/docs/hooks/use-create-vault", label: "useCreateVault" },
-        next: { href: "/docs/hooks/use-vault", label: "useVault" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-escrow-state/page.tsx b/apps/site/app/docs/hooks/use-escrow-state/page.tsx
deleted file mode 100644
index f2d591e..0000000
--- a/apps/site/app/docs/hooks/use-escrow-state/page.tsx
+++ /dev/null
@@ -1,34 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useEscrowState"],
-        title: "useEscrowState",
-        badges: <><Badge tone="primary">hook</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>The buyer-side state machine for <code>ConditionalEscrowCondition</code>: listing + paid status + delivery + timeout countdown, plus the two write actions (<code>pay</code>, <code>confirmDelivery</code>).</>,
-        importLine: 'import { useEscrowState } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useEscrowState(uuid: number, buyer: Hex | undefined, address?: Hex): {
-  seller?: Hex;
-  price?: bigint;
-  timeoutSecs?: bigint;
-  arbiter?: Hex;
-  paidAt: bigint;       // 0 = unpaid
-  delivered: boolean;
-  timeoutAt?: bigint;
-  timeoutInMs: number;
-  pay: () => Promise<Hex>;
-  confirmDelivery: () => Promise<Hex>;
-  isLoading: boolean;
-};`} /> },
-        ],
-        prev: { href: "/docs/hooks/use-multi-sig-status", label: "useMultiSigStatus" },
-        next: { href: "/docs/hooks/use-storage-backend", label: "useStorageBackend" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-mint-license-token/page.tsx b/apps/site/app/docs/hooks/use-mint-license-token/page.tsx
deleted file mode 100644
index 6bb7097..0000000
--- a/apps/site/app/docs/hooks/use-mint-license-token/page.tsx
+++ /dev/null
@@ -1,97 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function useMintLicenseToken(client: StoryClient | undefined): {
-  mint: (params: {
-    licensorIpId: Hex;
-    licenseTermsId: bigint;
-    amount?: bigint;          // default 1n
-    receiver?: Hex;           // default connected wallet
-    maxMintingFee?: bigint;   // default 0n (be careful with commercial flavors!)
-  }) => Promise<{ licenseTokenIds: bigint[]; txHash: Hex }>;
-  isLoading: boolean;
-  error?: Error;
-};`;
-
-const EXAMPLE = `import { useStoryClient, useMintLicenseToken } from "@cdr-kit/react";
-
-function BuyAccess({ ipId, licenseTermsId, priceWei }) {
-  const client = useStoryClient();
-  const { mint, isLoading } = useMintLicenseToken(client);
-  return (
-    <button
-      disabled={!client || isLoading}
-      onClick={async () => {
-        const { licenseTokenIds } = await mint({
-          licensorIpId: ipId,
-          licenseTermsId,
-          amount: 1n,
-          maxMintingFee: priceWei,  // cap exposure if seller changes price mid-tx
-        });
-        // licenseTokenIds[0] is the buyer's proof — pass as accessAuxData to read
-        // a license-gated CDR vault via agent.accessLicenseGated(...).
-      }}
-    >
-      {isLoading ? "minting…" : \`Buy license (\${priceWei} wei)\`}
-    </button>
-  );
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useMintLicenseToken"],
-        title: "useMintLicenseToken",
-        badges: (
-          <>
-            <Badge tone="primary">hook</Badge>
-            <Badge>new in 0.5</Badge>
-            <Badge>Story IP</Badge>
-          </>
-        ),
-        lede: (
-          <>
-            Buyer-side helper: mint Story license token(s) against an IP&apos;s{" "}
-            <code>licenseTermsId</code>. For commercial flavors the mint is the <b>payment</b> —
-            the fee flows from the buyer&apos;s wallet via WIP. The returned token id is the proof
-            the buyer holds the license; pass it as <code>accessAuxData</code> to read a
-            license-gated CDR vault.
-          </>
-        ),
-        importLine: 'import { useMintLicenseToken } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={SIG} /> },
-          { id: "example", title: "Example", content: <CodePanel title="tsx" language="tsx" code={EXAMPLE} /> },
-          {
-            id: "wip",
-            title: "WIP wrap + approval",
-            content: (
-              <p>
-                Commercial PIL flavors charge in WIP (the ERC-20 wrap of native IP). Before
-                <code>mint</code> succeeds, the buyer wallet needs (1) enough WIP to cover the
-                fee × amount and (2) an allowance for the RoyaltyModule. Call <code>agent.wrapIp</code>{" "}
-                + <code>agent.approveWip</code> in the buyer flow, or wire matching hooks if you
-                build them in your dashboard.
-              </p>
-            ),
-          },
-          {
-            id: "maxfee",
-            title: "Always set maxMintingFee",
-            content: (
-              <p>
-                Default <code>maxMintingFee</code> is <code>0n</code> — which means commercial
-                mints will revert! Pass the buyer-facing price you displayed in the UI to cap the
-                exposure if the seller changes the fee mid-tx.
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-register-ip", label: "useRegisterIp" },
-        next: { href: "/docs/hooks/use-attach-license-terms", label: "useAttachLicenseTerms" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-multi-sig-status/page.tsx b/apps/site/app/docs/hooks/use-multi-sig-status/page.tsx
deleted file mode 100644
index 2176d84..0000000
--- a/apps/site/app/docs/hooks/use-multi-sig-status/page.tsx
+++ /dev/null
@@ -1,27 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useMultiSigStatus"],
-        title: "useMultiSigStatus",
-        badges: <><Badge tone="primary">hook</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Reads the configured signers + threshold + epoch for a <code>MultiSigCondition</code> vault. Sigs themselves live off-chain — combine this with your own collection state to render approval progress.</>,
-        importLine: 'import { useMultiSigStatus } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useMultiSigStatus(uuid: number, address?: Hex): {
-  signers: readonly Hex[];
-  threshold: number;
-  epoch: bigint;
-  isLoading: boolean;
-};`} /> },
-        ],
-        prev: { href: "/docs/hooks/use-time-window-state", label: "useTimeWindowState" },
-        next: { href: "/docs/hooks/use-escrow-state", label: "useEscrowState" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-publish/page.tsx b/apps/site/app/docs/hooks/use-publish/page.tsx
deleted file mode 100644
index 0889bd3..0000000
--- a/apps/site/app/docs/hooks/use-publish/page.tsx
+++ /dev/null
@@ -1,132 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function usePublish(): {
-  publish: (
-    agent: { publish: (p: PublishParams) => Promise<PublishResult> },
-    params: PublishParams,
-  ) => Promise<PublishResult>;
-  isLoading: boolean;
-  error?: Error;
-  result?: PublishResult;
-};
-
-interface PublishParams {
-  data: Uint8Array;
-  spgNftContract: Hex;
-  pilTerms: unknown;        // PILFlavor.commercialUse({...}) etc.
-  ipMetadata?: { ipMetadataURI?: string; ipMetadataHash?: Hex; nftMetadataURI?: string; nftMetadataHash?: Hex; };
-}
-
-interface PublishResult {
-  ipId: Hex;
-  tokenId: bigint;
-  licenseTermsId: bigint;
-  vaultUuid: number;
-  vaultTxHash: Hex;
-  ipRegisterTxHash: Hex;
-  writeTxHash: Hex;
-}`;
-
-const EXAMPLE = `import { CdrAgent } from "@cdr-kit/agent";
-import { PILFlavor } from "@cdr-kit/story";
-import { usePublish } from "@cdr-kit/react";
-import { useAccount, useWalletClient } from "wagmi";
-
-function PublishButton({ secret }: { secret: string }) {
-  const { data: walletClient } = useWalletClient();
-  const { publish, isLoading, result, error } = usePublish();
-
-  const onClick = async () => {
-    if (!walletClient) return;
-    const agent = new CdrAgent({
-      privateKey: "0x...", // server-side; in browser, pass walletClient.account
-      network: "aeneid",
-    });
-    await publish(agent, {
-      data: new TextEncoder().encode(secret),
-      spgNftContract: "0xYourSpgCollection",
-      pilTerms: PILFlavor.commercialUse({
-        defaultMintingFee: 1_000_000_000_000_000_000n,
-        commercialRevShare: 5,
-      }),
-    });
-  };
-
-  return (
-    <>
-      <button disabled={isLoading} onClick={onClick}>
-        {isLoading ? "publishing…" : "publish + license-gate"}
-      </button>
-      {result && (
-        <pre>
-{\`ipId:          \${result.ipId}
-licenseTermsId: \${result.licenseTermsId}
-vaultUuid:      \${result.vaultUuid}\`}
-        </pre>
-      )}
-      {error && <span>{error.message}</span>}
-    </>
-  );
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "usePublish"],
-        title: "usePublish",
-        badges: (
-          <>
-            <Badge tone="primary">hook</Badge>
-            <Badge>new in 0.5</Badge>
-            <Badge>one-shot</Badge>
-            <Badge>Story IP</Badge>
-          </>
-        ),
-        lede: (
-          <>
-            Render-side wrapper for <code>agent.publish()</code> — the agent-as-publisher one-shot
-            that collapses register-IP + register-PIL-terms + attach-terms + create-license-gated-vault
-            + write-encrypted-data into a single call. Returns every artifact the buyer needs to
-            subscribe + read.
-          </>
-        ),
-        importLine: 'import { usePublish } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={SIG} /> },
-          { id: "example", title: "Example", content: <CodePanel title="tsx" language="tsx" code={EXAMPLE} /> },
-          {
-            id: "agent-required",
-            title: "Why does it take an `agent` argument?",
-            content: (
-              <p>
-                <code>agent.publish()</code> needs a wallet client + private key for the
-                multi-step orchestration (4 contract writes across IP-registry, PIL-template,
-                CDR-precompile). The React hook stays headless — you construct the{" "}
-                <code>CdrAgent</code> however your app does (server-side env, browser RPC over the
-                connected wallet) and the hook handles loading/error/result state around it.
-              </p>
-            ),
-          },
-          {
-            id: "buyer",
-            title: "Buyer flow",
-            content: (
-              <p>
-                After <code>publish</code> resolves, share <code>{`{ ipId, licenseTermsId, vaultUuid }`}</code>{" "}
-                with the buyer (URL param, QR, on-chain event). They call <code>agent.wrapIp</code> →{" "}
-                <code>agent.approveWip</code> → <code>useMintLicenseToken.mint</code> →{" "}
-                <code>agent.accessLicenseGated</code> to pay + decrypt. See{" "}
-                <a href="/docs/story#buyer">/docs/story</a> for the full buyer code.
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-attach-license-terms", label: "useAttachLicenseTerms" },
-        next: { href: "/docs/storage", label: "Storage adapters" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-register-ip/page.tsx b/apps/site/app/docs/hooks/use-register-ip/page.tsx
deleted file mode 100644
index 8a4dd59..0000000
--- a/apps/site/app/docs/hooks/use-register-ip/page.tsx
+++ /dev/null
@@ -1,78 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function useRegisterIp(client: StoryClient | undefined): {
-  registerIp: (params: {
-    spgNftContract: Hex;
-    recipient?: Hex;
-    ipMetadataURI?: string;
-    ipMetadataHash?: Hex;
-  }) => Promise<{ ipId: Hex; tokenId: bigint; txHash: Hex }>;
-  isLoading: boolean;
-  error?: Error;
-};`;
-
-const EXAMPLE = `import { useStoryClient, useRegisterIp } from "@cdr-kit/react";
-
-function RegisterButton() {
-  const client = useStoryClient();
-  const { registerIp, isLoading, error } = useRegisterIp(client);
-  return (
-    <button
-      disabled={!client || isLoading}
-      onClick={async () => {
-        const { ipId, tokenId } = await registerIp({
-          spgNftContract: "0xYourSpgCollection",
-          ipMetadataURI: "ipfs://bafy...",
-        });
-        console.log("registered IP", ipId, "tokenId", tokenId);
-      }}
-    >
-      {isLoading ? "registering…" : "register IP"}
-    </button>
-  );
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useRegisterIp"],
-        title: "useRegisterIp",
-        badges: (
-          <>
-            <Badge tone="primary">hook</Badge>
-            <Badge>new in 0.5</Badge>
-            <Badge>Story IP</Badge>
-          </>
-        ),
-        lede: (
-          <>
-            Mint a fresh NFT (via your SPG collection) and register it as a Story IP asset in a
-            single tx. Pair with <code>useAttachLicenseTerms</code> to make the IP licensable, then{" "}
-            <code>useMintLicenseToken</code> on the buyer side.
-          </>
-        ),
-        importLine: 'import { useRegisterIp } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={SIG} /> },
-          { id: "example", title: "Example", content: <CodePanel title="tsx" language="tsx" code={EXAMPLE} /> },
-          {
-            id: "prereq",
-            title: "Prerequisites",
-            content: (
-              <p>
-                You need an existing SPG NFT collection. Create one via Story&apos;s registration
-                workflows (<code>registrationWorkflows.createCollection</code>) or use a previously
-                deployed collection address. The connected wallet must be allowed to mint into it.
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-story-client", label: "useStoryClient" },
-        next: { href: "/docs/hooks/use-mint-license-token", label: "useMintLicenseToken" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-storage-backend/page.tsx b/apps/site/app/docs/hooks/use-storage-backend/page.tsx
deleted file mode 100644
index b594ff6..0000000
--- a/apps/site/app/docs/hooks/use-storage-backend/page.tsx
+++ /dev/null
@@ -1,32 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useStorageBackend"],
-        title: "useStorageBackend",
-        badges: <><Badge tone="primary">hook</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Config-driven <code>CdrStorageProvider</code> factory. A dashboard switches backends at runtime by passing a JSON config (Pinata / Supabase / IPFS / read-only gateway / in-memory).</>,
-        importLine: 'import { useStorageBackend } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`type StorageBackendConfig =
-  | { kind: "memory" }
-  | { kind: "pinata"; jwt: string; gatewayUrl?: string }
-  | { kind: "supabase"; supabaseUrl: string; key: string; bucket: string;
-      pathPrefix?: string; bucketIsPublic?: boolean }
-  | { kind: "gateway"; gatewayUrl: string }
-  | { kind: "ipfs"; addUrl: string; gatewayUrl: string;
-      headers?: Record<string, string> };
-
-function useStorageBackend(config: StorageBackendConfig | undefined): CdrStorageProvider | undefined;`} /> },
-          { id: "memoization", title: "Memoization", content: <p>The provider instance is memoized on <code>config</code> identity. Pass a stable config object (typically from your environment variables, not a fresh literal every render).</p> },
-        ],
-        prev: { href: "/docs/hooks/use-escrow-state", label: "useEscrowState" },
-        next: { href: "/docs/contracts", label: "Condition library" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-story-client/page.tsx b/apps/site/app/docs/hooks/use-story-client/page.tsx
deleted file mode 100644
index 462d227..0000000
--- a/apps/site/app/docs/hooks/use-story-client/page.tsx
+++ /dev/null
@@ -1,79 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function useStoryClient(chainId?: number): StoryClient | undefined;`;
-
-const EXAMPLE = `import { useStoryClient } from "@cdr-kit/react";
-
-function Publish() {
-  const client = useStoryClient();              // bound to the connected wagmi wallet
-  if (!client) return <p>connect a wallet to publish</p>;
-  // client is the StoryClient from @story-protocol/core-sdk —
-  // pass it to useRegisterIp, useMintLicenseToken, etc.
-  return <RegisterButton client={client} />;
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useStoryClient"],
-        title: "useStoryClient",
-        badges: (
-          <>
-            <Badge tone="primary">hook</Badge>
-            <Badge>new in 0.5</Badge>
-            <Badge>Story IP</Badge>
-          </>
-        ),
-        lede: (
-          <>
-            Lazy-load and memoize a <code>StoryClient</code> from <code>@story-protocol/core-sdk</code>{" "}
-            bound to the connected wagmi wallet. Returns <code>undefined</code> until the wallet
-            connects and the lazy import resolves. Pair with <code>useRegisterIp</code>,{" "}
-            <code>useMintLicenseToken</code>, <code>useAttachLicenseTerms</code>, or any other Story
-            SDK call.
-          </>
-        ),
-        importLine: 'import { useStoryClient } from "@cdr-kit/react"',
-        sections: [
-          {
-            id: "signature",
-            title: "Signature",
-            content: <CodePanel title="type" language="ts" code={SIG} />,
-          },
-          {
-            id: "example",
-            title: "Example",
-            content: <CodePanel title="tsx" language="tsx" code={EXAMPLE} />,
-          },
-          {
-            id: "lazy",
-            title: "Lazy-loaded peer dep",
-            content: (
-              <p>
-                <code>@cdr-kit/story</code> is an optional peer dep on <code>@cdr-kit/react</code>{" "}
-                — the hook does a dynamic <code>import(&quot;@cdr-kit/story&quot;)</code> on first
-                call, so dashboards that never publish IP don&apos;t pay the bundle cost. If the
-                peer dep isn&apos;t installed, the hook throws with a clear install hint.
-              </p>
-            ),
-          },
-          {
-            id: "chain",
-            title: "Custom chain",
-            content: (
-              <p>
-                The default <code>chainId</code> is 1315 (Story Aeneid). Pass an explicit value to
-                bind the client to a different chain (e.g. Story mainnet once it ships).
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-storage-backend", label: "useStorageBackend" },
-        next: { href: "/docs/hooks/use-register-ip", label: "useRegisterIp" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-subscribe-and-access/page.tsx b/apps/site/app/docs/hooks/use-subscribe-and-access/page.tsx
deleted file mode 100644
index 17c651a..0000000
--- a/apps/site/app/docs/hooks/use-subscribe-and-access/page.tsx
+++ /dev/null
@@ -1,36 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const SIG = `function useSubscribeAndAccess(
-  uuid: number,
-  subscriptionCondition?: Hex,
-): {
-  run: (p: {
-    periods: bigint;
-    maxPricePerPeriod: bigint;
-    value: bigint;
-    accessAuxData?: Hex;
-  }) => Promise<Uint8Array>;
-  status: "idle" | "paying" | "collecting-partials" | "ready" | "error";
-  data?: Uint8Array;
-};`;
-
-export default function UseSubscribeAndAccessPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useSubscribeAndAccess"],
-        title: "useSubscribeAndAccess",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>The full 2-step flow — pay (real subscribe tx) then access (threshold read). Five status values; design the &quot;paying&quot; and &quot;collecting-partials&quot; states legibly.</>,
-        importLine: 'import { useSubscribeAndAccess } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" code={SIG} language="ts" /> },
-        ],
-        prev: { href: "/docs/hooks/use-access-vault", label: "useAccessVault" },
-        next: { href: "/docs/hooks/use-create-vault", label: "useCreateVault" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-time-window-state/page.tsx b/apps/site/app/docs/hooks/use-time-window-state/page.tsx
deleted file mode 100644
index d454c66..0000000
--- a/apps/site/app/docs/hooks/use-time-window-state/page.tsx
+++ /dev/null
@@ -1,31 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useTimeWindowState"],
-        title: "useTimeWindowState",
-        badges: <><Badge tone="primary">hook</Badge><Badge>new in 0.5</Badge></>,
-        lede: <>Reads a <code>TimeWindowCondition</code> vault&apos;s <code>[startTs, endTs]</code> window + ticks a 1-second client-side timer to surface <code>opensInMs</code>/<code>closesInMs</code>.</>,
-        importLine: 'import { useTimeWindowState } from "@cdr-kit/react"',
-        sections: [
-          { id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useTimeWindowState(uuid: number, address?: Hex): {
-  startTs?: bigint;
-  endTs?: bigint;      // 0 = open-ended after startTs
-  blockBased?: boolean;
-  isOpen: boolean;
-  opensInMs: number;    // 0 if already open or unconfigured
-  closesInMs: number;   // 0 if open-ended or already closed
-  isLoading: boolean;
-};`} /> },
-          { id: "block-based", title: "Block-based windows", content: <p>For <code>blockBased: true</code> windows, <code>opensInMs</code>/<code>closesInMs</code> return <code>0</code> — <code>block.number</code> isn&apos;t ticked client-side. Read the raw block bounds from the result object.</p> },
-        ],
-        prev: { href: "/docs/hooks/use-dead-man-timer", label: "useDeadManTimer" },
-        next: { href: "/docs/hooks/use-multi-sig-status", label: "useMultiSigStatus" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-vault-events/page.tsx b/apps/site/app/docs/hooks/use-vault-events/page.tsx
deleted file mode 100644
index 3b334a5..0000000
--- a/apps/site/app/docs/hooks/use-vault-events/page.tsx
+++ /dev/null
@@ -1,25 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useVaultEvents"],
-        title: "useVaultEvents",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>Live subscription to <code>VaultCreated</code> events on the factory. Returns events accumulated since mount — pair with <code>useDiscoverVaults</code> for backfill + live.</>,
-        importLine: 'import { useVaultEvents } from "@cdr-kit/react"',
-        sections: [{ id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useVaultEvents(): {
-  tokenId: bigint;
-  uuid: number;
-  ipId: Hex;
-  creator: Hex;
-}[];`} /> }],
-        prev: { href: "/docs/hooks/use-vault", label: "useVault" },
-        next: { href: "/docs/hooks/use-creator-vaults", label: "useCreatorVaults" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/hooks/use-vault/page.tsx b/apps/site/app/docs/hooks/use-vault/page.tsx
deleted file mode 100644
index a753a0d..0000000
--- a/apps/site/app/docs/hooks/use-vault/page.tsx
+++ /dev/null
@@ -1,25 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/react", "Hooks", "useVault"],
-        title: "useVault",
-        badges: <Badge tone="primary">hook</Badge>,
-        lede: <>Resolve a vault&apos;s on-chain metadata from its <code>uuid</code> via the <code>CdrKitVault</code> factory (token id, IP id, creator, license terms id).</>,
-        importLine: 'import { useVault } from "@cdr-kit/react"',
-        sections: [{ id: "signature", title: "Signature", content: <CodePanel title="type" language="ts" code={`function useVault(uuid: number): {
-  tokenId?: bigint;
-  info?: { /* factory getVaultInfo struct */ };
-  isLoading: boolean;
-  error?: Error;
-};`} /> }],
-        prev: { href: "/docs/hooks/use-discover-vaults", label: "useDiscoverVaults" },
-        next: { href: "/docs/hooks/use-vault-events", label: "useVaultEvents" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/page.tsx b/apps/site/app/docs/page.tsx
deleted file mode 100644
index 2eb9eeb..0000000
--- a/apps/site/app/docs/page.tsx
+++ /dev/null
@@ -1,141 +0,0 @@
-import Link from "next/link";
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-
-export default function IntroductionPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Getting started", "Introduction"],
-        title: "Introduction",
-        badges: <Badge tone="live">v0.5.0</Badge>,
-        lede: (
-          <>
-            <b>cdr-kit</b> is the developer toolkit for Story Protocol&apos;s Confidential Data Rails — the{" "}
-            <span className="mono" style={{ color: "var(--ink)" }}>wagmi</span>-style layer that makes it possible to
-            ship private, paid, license-gated data on Story without hand-writing Solidity, hand-rolling encryption
-            flows, or wiring IP licensing primitives by hand.
-          </>
-        ),
-        sections: [
-          {
-            id: "what",
-            title: "What's in the kit",
-            content: (
-              <>
-                <p>
-                  15 packages, MIT-licensed, all published to{" "}
-                  <a href="https://www.npmjs.com/org/cdr-kit" target="_blank" rel="noopener noreferrer">
-                    npmjs.com/org/cdr-kit
-                  </a>{" "}
-                  at v0.5.0:
-                </p>
-                <ul>
-                  <li>
-                    <Link href="/docs/components/vault-gate">
-                      <code>@cdr-kit/react</code>
-                    </Link>{" "}
-                    — components + hooks + theming (5 new 0.5 components, 7 new hooks)
-                  </li>
-                  <li>
-                    <code>@cdr-kit/react-ui</code> — styled drop-ins built on the headless layer
-                  </li>
-                  <li>
-                    <Link href="/docs/components/cdr-provider">
-                      <code>@cdr-kit/core</code>
-                    </Link>{" "}
-                    — typed SDK (condition encoders, 2-step flows, 8 storage adapters, mock kit, WASM init)
-                  </li>
-                  <li>
-                    <Link href="/docs/contracts">
-                      <code>@cdr-kit/contracts</code>
-                    </Link>{" "}
-                    — Solidity ABIs + deployed addresses for 9 conditions (5 base + 4 advanced in 0.5)
-                  </li>
-                  <li>
-                    <Link href="/docs/agent-kit">
-                      <code>@cdr-kit/agent</code>
-                    </Link>{" "}
-                    — autonomous-agent client (discover → subscribe → access; +12 advanced helpers in 0.5)
-                  </li>
-                  <li>
-                    <Link href="/docs/story">
-                      <code>@cdr-kit/story</code>
-                    </Link>{" "}
-                    — Story IP creator surface (NEW in 0.5): registerIpAsset / PIL flavors / mintLicenseTokens
-                  </li>
-                  <li>
-                    <code>@cdr-kit/tools</code> — framework-agnostic tool definitions (34 tools)
-                  </li>
-                  <li>
-                    Framework adapters:{" "}
-                    <Link href="/docs/agent-kit/vercel-ai">
-                      <code>@cdr-kit/vercel-ai</code>
-                    </Link>{" "}
-                    ·{" "}
-                    <Link href="/docs/agent-kit/openai">
-                      <code>@cdr-kit/openai</code>
-                    </Link>{" "}
-                    ·{" "}
-                    <Link href="/docs/agent-kit/langchain">
-                      <code>@cdr-kit/langchain</code>
-                    </Link>{" "}
-                    ·{" "}
-                    <Link href="/docs/agent-kit/agentkit">
-                      <code>@cdr-kit/agentkit</code>
-                    </Link>{" "}
-                    ·{" "}
-                    <Link href="/docs/agent-kit/goat">
-                      <code>@cdr-kit/goat</code>
-                    </Link>
-                  </li>
-                  <li>
-                    <Link href="/docs/agent-kit/mcp">
-                      <code>@cdr-kit/mcp</code>
-                    </Link>{" "}
-                    — the MCP server (Claude Desktop / Cursor / Windsurf / OpenClaw)
-                  </li>
-                  <li>
-                    <Link href="/docs/cli">
-                      <code>@cdr-kit/cli</code>
-                    </Link>{" "}
-                    — the <span className="mono">cdr</span> binary (25 commands across vault / multi-sig / escrow / IP)
-                  </li>
-                  <li>
-                    <Link href="/docs/scaffolder">
-                      <code>create-cdr-kit-app</code>
-                    </Link>{" "}
-                    — the scaffolder
-                  </li>
-                </ul>
-              </>
-            ),
-          },
-          {
-            id: "where",
-            title: "Where to start",
-            content: (
-              <>
-                <ul>
-                  <li>
-                    <Link href="/docs/quickstart">Quickstart</Link> — install, gate encrypted data in under 60s.
-                  </li>
-                  <li>
-                    <Link href="/docs/components/vault-gate">VaultGate component</Link> — the canonical drop-in.
-                  </li>
-                  <li>
-                    <Link href="/docs/agent-kit">Agent kit overview</Link> — autonomous agents that buy data.
-                  </li>
-                  <li>
-                    <Link href="/docs/contracts">Condition library</Link> — the Solidity standard library.
-                  </li>
-                </ul>
-              </>
-            ),
-          },
-        ],
-        next: { href: "/docs/quickstart", label: "Quickstart" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/quickstart/page.tsx b/apps/site/app/docs/quickstart/page.tsx
deleted file mode 100644
index 1a4c4e5..0000000
--- a/apps/site/app/docs/quickstart/page.tsx
+++ /dev/null
@@ -1,78 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const PROVIDER_CODE = `import { CdrProvider } from "@cdr-kit/react";
-import { wagmiConfig } from "./wagmi";
-
-export function App({ children }) {
-  return (
-    <CdrProvider config={wagmiConfig} apiUrl={process.env.NEXT_PUBLIC_CDR_API_URL!}>
-      {children}
-    </CdrProvider>
-  );
-}`;
-
-const GATE_CODE = `import { VaultGate } from "@cdr-kit/react";
-
-export function SignalCard() {
-  return (
-    <VaultGate uuid={4200} auto fallback={<SubscribeButton />}>
-      {(data) => <pre>{new TextDecoder().decode(data)}</pre>}
-    </VaultGate>
-  );
-}`;
-
-export default function QuickstartPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Getting started", "Quickstart"],
-        title: "Quickstart",
-        badges: <Badge tone="primary">≈ 60 seconds</Badge>,
-        lede: <>Install the React layer, wrap your app in a provider, drop in a <code>&lt;VaultGate&gt;</code>. That&apos;s it.</>,
-        sections: [
-          {
-            id: "install",
-            title: "Install",
-            content: <CodePanel title="terminal" language="bash" code="$ pnpm add @cdr-kit/react @cdr-kit/core wagmi viem" />,
-          },
-          {
-            id: "provider",
-            title: "Wrap in <CdrProvider>",
-            content: (
-              <>
-                <p>
-                  <code>&lt;CdrProvider&gt;</code> wires <code>WagmiProvider</code>, react-query, and initializes the CDR
-                  crypto WASM. Pass <code>config</code> + <code>apiUrl</code> for live mode, or <code>mockKit</code> for
-                  offline dev.
-                </p>
-                <CodePanel title="App.tsx" code={PROVIDER_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "gate",
-            title: "Gate your data",
-            content: (
-              <>
-                <p>
-                  <code>&lt;VaultGate&gt;</code> checks the on-chain condition, collects key shares, and hands you the
-                  decrypted bytes. Pass a fallback for the &quot;not yet entitled&quot; state.
-                </p>
-                <CodePanel title="SignalCard.tsx" code={GATE_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "scaffold",
-            title: "Or scaffold a starter",
-            content: <CodePanel title="terminal" language="bash" code="$ npm create cdr-kit" />,
-          },
-        ],
-        prev: { href: "/docs", label: "Introduction" },
-        next: { href: "/docs/theming", label: "Theming" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/scaffolder/page.tsx b/apps/site/app/docs/scaffolder/page.tsx
deleted file mode 100644
index 1369ac1..0000000
--- a/apps/site/app/docs/scaffolder/page.tsx
+++ /dev/null
@@ -1,79 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Scaffolder"],
-        title: "npm create cdr-kit",
-        badges: <><Badge tone="primary">create-cdr-kit-app</Badge><Badge>9 templates · 0.3</Badge></>,
-        lede: <>One command per pattern. Pick a template and you have a working consumer app — paywalled blog, single-page Subscribe, stdio MCP server, or any of five agent-framework wirings — running locally in under a minute. Mock CDR out of the box; swap one provider to go live on Aeneid.</>,
-        sections: [
-          {
-            id: "invoke",
-            title: "Invoke",
-            content: (
-              <CodePanel title="terminal" language="bash" code={`# default = starter (Node mock-flow)
-$ npm create cdr-kit my-app
-
-# any other template via --template
-$ npm create cdr-kit my-blog -- --template blog
-$ npm create cdr-kit my-paywall -- --template paywall
-$ npm create cdr-kit my-mcp -- --template mcp-server`} />
-            ),
-          },
-          {
-            id: "ui",
-            title: "UI templates",
-            content: (
-              <>
-                <p><b>blog</b> — Next.js 16 + React 19 + <code>@cdr-kit/react-ui</code>. Three inline <code>&lt;UnlockablePill&gt;</code>s on a real-looking blog post. The onscroll.app pattern. <i>Recommended first.</i></p>
-                <p><b>paywall</b> — Next.js single-page <code>&lt;SubscribeButton&gt;</code> gating a whole content block. Classic Substack/Patreon pattern.</p>
-              </>
-            ),
-          },
-          {
-            id: "mcp",
-            title: "MCP server template",
-            content: (
-              <>
-                <p><b>mcp-server</b> — stdio Model Context Protocol server. Exposes <code>cdr_discover_vaults</code>, <code>cdr_subscribe_and_access</code>, <code>cdr_access_vault</code> to any MCP host (Claude Desktop, Cursor, Windsurf). The agent pays from its own wallet — the LLM never sees the key.</p>
-                <p>Ships with a ready-to-paste <code>claude_desktop_config.json</code>.</p>
-              </>
-            ),
-          },
-          {
-            id: "agents",
-            title: "Agent templates (one per framework)",
-            content: (
-              <>
-                <p>Each template instantiates <code>new CdrAgent({"{"} privateKey, apiUrl {"}"})</code> and wires CDR tools into the named framework. Pick the one your stack uses; the rest of your agent logic stays untouched.</p>
-                <p><b>agent-vercel-ai</b> — Vercel AI SDK chatbot using <code>getVercelAITools(agent)</code> with <code>generateText</code>.</p>
-                <p><b>agent-openai</b> — Raw OpenAI / Anthropic tool-calling loop using <code>getOpenAITools(agent).{"{"}tools, dispatch{"}"}</code>.</p>
-                <p><b>agent-langchain</b> — LangChain ReAct agent via <code>createReactAgent({"{"}llm, tools: getLangChainTools(agent){"}"})</code>.</p>
-                <p><b>agent-agentkit</b> — Coinbase AgentKit action provider via <code>getCdrActionProvider(agent)</code>. Compose with your wallet provider.</p>
-                <p><b>agent-goat</b> — GOAT SDK <code>ToolBase[]</code> via <code>getGoatTools(agent)</code>.</p>
-              </>
-            ),
-          },
-          {
-            id: "starter",
-            title: "starter template",
-            content: (
-              <>
-                <p><b>starter</b> — Two-file Node TypeScript script that runs <code>createMockCdrKit()</code> + <code>accessVault()</code> end-to-end. Good for verifying the kit works in your env or for backend-only CDR work.</p>
-                <CodePanel title="tree" language="bash" code={`my-app/
-├── src/index.ts          # mock CDR end-to-end in ~10 lines
-├── package.json          # @cdr-kit/core@^0.3.0 + consola
-└── README.md`} />
-              </>
-            ),
-          },
-        ],
-        prev: { href: "/docs/contracts/cdr-kit-vault", label: "CdrKitVault" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/skill/page.tsx b/apps/site/app/docs/skill/page.tsx
deleted file mode 100644
index 275de70..0000000
--- a/apps/site/app/docs/skill/page.tsx
+++ /dev/null
@@ -1,100 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const INSTALL_PATHS = `# 1. via the cdr CLI (recommended)
-$ npm install -g @cdr-kit/cli
-$ cdr skill install
-
-# 2. via Claude Code's plugin marketplace
-$ claude
-/plugin marketplace add Blockchain-Oracle/cdr-kit
-/plugin install cdr-kit@cdr-kit
-
-# 3. manual
-$ git clone https://github.com/Blockchain-Oracle/cdr-kit
-$ cp -r cdr-kit/packages/plugin/cdr-kit ~/.claude/skills/cdr-kit`;
-
-const SKILLS: { name: string; trigger: string; what: string }[] = [
-  { name: "design-condition", trigger: "Which CDR condition should I use for X?", what: "Decision tree for picking among open / subscription / tier-gate / composable / license-read. Encoding cheatsheet per condition." },
-  { name: "wire-allocate-pay-read", trigger: "How do I create a vault and read it?", what: "The canonical 4-step flow (creator + consumer sides). Gotchas: OOG, uuid-from-receipt, value-must-match-price." },
-  { name: "debug-cdr-precompile", trigger: "OOG / ReentrancySentryOOG / AlreadyConfigured / partial-collection timeout", what: "7 failure modes with root cause + fix. Backed by the gotchas in context/research/cdr-protocol-truth.md." },
-  { name: "audit-vault-config", trigger: "Should I subscribe to this? / Did my deploy configure right?", what: "4-call view-only audit. Red-flag checklist (payee mismatch, never-expiring period, missing licenseTermsId)." },
-  { name: "explain-cdr-error", trigger: "(Any raw error message)", what: "Lookup table from error code → root cause + fix. Maps every @piplabs/cdr-sdk error class." },
-  // 0.5 — advanced features
-  { name: "design-storage-adapter", trigger: "Which storage backend for my CDR file vault? Pinata / Supabase / R2 / Storacha?", what: "Decision tree for picking among the 6 official adapters + 3 ecosystem packages. Wiring examples, common failure modes (CORS, RLS, CID drift)." },
-  { name: "design-multisig-condition", trigger: "Multi-sig CDR vault / N-of-M approval / off-chain signing", what: "N-of-M EIP-712 setup, signer rotation, sig-collection UX, caller binding, ECDSA-malleability dedupe, EIP-1271 gap." },
-  { name: "design-deadman-switch", trigger: "Dead-man switch / wallet recovery / leak-on-disappearance / heartbeat", what: "Trapdoor semantics, poke() cadence, block-vs-timestamp tradeoff, heir variants, operational risk (forgotten heartbeat)." },
-];
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Plugin / Skill"],
-        title: "Claude Code plugin",
-        badges: <><Badge tone="primary">cdr-kit plugin</Badge><Badge>8 skills · v0.5</Badge></>,
-        lede: <>A multi-skill Claude Code plugin (Trail-of-Bits density) that teaches any agent the cdr-kit workflows. Each <code>SKILL.md</code> is under 500 lines (per Anthropic&apos;s hard cap); reference docs (ABIs, error catalog) live in a <code>references/</code> subdir loaded on demand. Pairs with the <code>cdr</code> CLI and the <code>@cdr-kit/mcp</code> server — three coordinated surfaces, one bundle.</>,
-        sections: [
-          { id: "install", title: "Install (three paths)", content: <CodePanel title="terminal" language="bash" code={INSTALL_PATHS} /> },
-          {
-            id: "skills",
-            title: "Skills (8)",
-            content: (
-              <table className="props">
-                <thead><tr><th>Skill</th><th>When it fires</th><th>What it teaches</th></tr></thead>
-                <tbody>
-                  {SKILLS.map((s) => (
-                    <tr key={s.name}>
-                      <td><code>{s.name}</code></td>
-                      <td>{s.trigger}</td>
-                      <td>{s.what}</td>
-                    </tr>
-                  ))}
-                </tbody>
-              </table>
-            ),
-          },
-          {
-            id: "layout",
-            title: "Plugin layout",
-            content: (
-              <CodePanel title="tree" language="bash" code={`packages/plugin/cdr-kit/
-├── .claude-plugin/
-│   └── plugin.json             # plugin manifest (8 skills registered)
-├── skills/
-│   ├── design-condition/           SKILL.md
-│   ├── wire-allocate-pay-read/     SKILL.md
-│   ├── debug-cdr-precompile/       SKILL.md
-│   ├── audit-vault-config/         SKILL.md
-│   ├── explain-cdr-error/          SKILL.md
-│   ├── design-storage-adapter/     SKILL.md   # 0.5
-│   ├── design-multisig-condition/  SKILL.md   # 0.5
-│   └── design-deadman-switch/      SKILL.md   # 0.5
-├── references/
-│   ├── conditions-cheatsheet.md  # full ABI + encoding per condition
-│   └── error-catalog.md          # every CdrErrorCode + SDK mapping
-└── README.md`} />
-            ),
-          },
-          {
-            id: "boundary",
-            title: "Skill vs MCP vs CLI",
-            content: (
-              <>
-                <p>
-                  Per the Anthropic-blessed boundary (<a href="https://www.morphllm.com/claude-code-skills-mcp-plugins" target="_blank" rel="noreferrer">guide</a>): <b>MCP</b> = let Claude <i>access</i> external systems; <b>Skill</b> = let Claude <i>know how</i> to do something; <b>CLI</b> = the same operations exposed for a human in the terminal.
-                </p>
-                <p>
-                  cdr-kit ships all three from one shared core: the 21 CDR operations are MCP tools in <code>@cdr-kit/mcp</code>; this plugin&apos;s 8 SKILL.mds teach Claude the procedural knowledge for designing, wiring, and debugging around those tools; <code>cdr</code> exposes the same surface for terminal use.
-                </p>
-              </>
-            ),
-          },
-        ],
-        prev: { href: "/docs/cli", label: "CLI: cdr" },
-        next: { href: "/docs/contracts", label: "Contracts" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/storage/page.tsx b/apps/site/app/docs/storage/page.tsx
deleted file mode 100644
index 750f401..0000000
--- a/apps/site/app/docs/storage/page.tsx
+++ /dev/null
@@ -1,195 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const PINATA_CODE = `import { createPinataStorage, uploadFile } from "@cdr-kit/core";
-
-const storage = createPinataStorage({ jwt: process.env.PINATA_JWT! });
-const { uuid, cid, txHashes } = await uploadFile(client, {
-  content: fileBytes,
-  storage,
-  readConditionAddr,
-  readConditionData,
-});`;
-
-const SUPABASE_CODE = `import { createSupabaseStorage } from "@cdr-kit/core";
-
-const storage = createSupabaseStorage({
-  supabaseUrl: process.env.SUPABASE_URL!,
-  key: process.env.SUPABASE_SERVICE_ROLE_KEY!,
-  bucket: "cdr-secrets",
-  pathPrefix: "vaults/",       // optional, default "cdr/"
-  bucketIsPublic: false,        // download uses /authenticated/ when private
-});`;
-
-const READ_ONLY_CODE = `import { createReadOnlyGatewayStorage, downloadFile } from "@cdr-kit/core";
-
-// Buyer-side: read from any public IPFS gateway. Throws on upload() — by design.
-const storage = createReadOnlyGatewayStorage({ gatewayUrl: "https://gateway.pinata.cloud" });
-const { content } = await downloadFile(client, { uuid, storage });`;
-
-const IPFS_CODE = `import { createIpfsStorage } from "@cdr-kit/core";
-
-// Self-hosted Kubo, or any pinning service with a multipart POST + JSON CID response.
-const storage = createIpfsStorage({
-  addUrl: "http://kubo:5001/api/v0/add",
-  gatewayUrl: "http://kubo:8080",
-  headers: { Authorization: "Bearer ..." },
-});`;
-
-const MEMORY_CODE = `import { createMemoryStorage } from "@cdr-kit/core";
-
-// Unit tests, CI, mocks. Content-addressed, returns a real CIDv1.
-const storage = createMemoryStorage();`;
-
-const S3_CODE = `import { createS3Storage } from "@cdr-kit/core";
-
-// Works against AWS S3, Cloudflare R2, MinIO, or any S3-compatible store.
-// Lazy-loads @aws-sdk/client-s3 via dynamic import — install it yourself.
-const storage = await createS3Storage({
-  bucket: "cdr-secrets",
-  region: "auto",                                     // R2: "auto"; AWS: "us-east-1" etc.
-  endpoint: "https://<acct>.r2.cloudflarestorage.com", // omit for AWS
-  accessKeyId: process.env.S3_ACCESS_KEY_ID!,
-  secretAccessKey: process.env.S3_SECRET_ACCESS_KEY!,
-  publicUrlBase: "https://<acct>.r2.dev/cdr-secrets",  // for browser-readable downloads
-  prefix: "cdr/",
-});`;
-
-const STORACHA_CODE = `import { createStorachaStorage } from "@cdr-kit/core";
-
-// Storacha-server (UCAN-backed pinning over @web3-storage/w3up-client).
-// Install: pnpm add @web3-storage/w3up-client
-const storage = await createStorachaStorage({
-  key: process.env.STORACHA_KEY!,
-  spaceDid: process.env.STORACHA_SPACE_DID!,
-  proof: process.env.STORACHA_PROOF!,    // base64 UCAN delegation
-  gatewayUrl: "https://w3s.link",         // optional, default w3s.link
-});`;
-
-const HELIA_CODE = `import { createHeliaStorage } from "@cdr-kit/core";
-
-// Browser-side embedded IPFS via Helia — no remote pinner, the user is the node.
-// Install: pnpm add helia @helia/unixfs
-// Pin @peculiar/webcrypto: 1.7.0 in pnpm.overrides (Helia's wasm setup is fragile).
-const storage = await createHeliaStorage({
-  gatewayUrl: "https://ipfs.io",  // optional, only used by downloadFile if user is offline
-});`;
-
-const ROUTING_CODE = `import { shouldUseFile, getInlineLimit } from "@cdr-kit/core";
-
-const limit = await getInlineLimit(client);   // reads CDR.maxEncryptedDataSize() once + caches
-if (shouldUseFile(content, limit)) {
-  await uploadFile(client, { content, storage, readConditionAddr, readConditionData });
-} else {
-  await writeVaultData(client, { uuid, dataKey: content });
-}`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/core", "Storage adapters"],
-        title: "Storage adapters",
-        badges: <><Badge tone="primary">@cdr-kit/core</Badge><Badge>0.5</Badge></>,
-        lede: <>CDR vaults route payloads by size: <code>≤ 1 KB</code> goes inline on-chain, larger payloads go off-chain with a CDR-secured key reference. The off-chain path needs a <code>CdrStorageProvider</code> — <b>8 ship in <code>@cdr-kit/core</code></b> (5 core + 3 ecosystem: S3-compat / Storacha / Helia). All speak the same 2-method interface: <code>upload(bytes) → cid</code>, <code>download(cid) → bytes</code>.</>,
-        importLine: 'import { createPinataStorage, createSupabaseStorage, /* ... */ } from "@cdr-kit/core"',
-        sections: [
-          {
-            id: "decision",
-            title: "Pick the right adapter",
-            content: (
-              <ul>
-                <li><b>Buyer-only / dashboards</b> → <code>createReadOnlyGatewayStorage</code> (no pin creds needed, throws on upload).</li>
-                <li><b>Hosted IPFS pinning</b> → <code>createPinataStorage</code> (JWT, default Pinata gateway).</li>
-                <li><b>Already-have-Supabase shops</b> → <code>createSupabaseStorage</code> (bucket + service-role key, bare REST — no <code>@supabase/supabase-js</code> dep).</li>
-                <li><b>Self-hosted Kubo / custom pinner</b> → <code>createIpfsStorage</code> (multipart POST + JSON CID response).</li>
-                <li><b>AWS S3 / R2 / MinIO</b> → <code>createS3Storage</code> (signed-URL downloads, lazy-loads <code>@aws-sdk/client-s3</code>).</li>
-                <li><b>UCAN-backed pinning</b> → <code>createStorachaStorage</code> (peer-dep <code>@web3-storage/w3up-client</code>).</li>
-                <li><b>Browser-embedded IPFS</b> → <code>createHeliaStorage</code> (peer-dep <code>helia</code>, user is the node).</li>
-                <li><b>Tests / CI</b> → <code>createMemoryStorage</code> (content-addressed, real CIDv1).</li>
-              </ul>
-            ),
-          },
-          {
-            id: "pinata",
-            title: "createPinataStorage",
-            content: <CodePanel title="ts" language="ts" code={PINATA_CODE} />,
-          },
-          {
-            id: "supabase",
-            title: "createSupabaseStorage",
-            content: (
-              <>
-                <CodePanel title="ts" language="ts" code={SUPABASE_CODE} />
-                <p>The &quot;CID&quot; is the bucket-relative path the object was uploaded to. Supabase doesn&apos;t speak IPFS, but <code>CdrStorageProvider</code> only requires a string round-trip handle.</p>
-              </>
-            ),
-          },
-          {
-            id: "gateway",
-            title: "createReadOnlyGatewayStorage",
-            content: (
-              <>
-                <CodePanel title="ts" language="ts" code={READ_ONLY_CODE} />
-                <p>For dashboards that consume but never produce. Pair with a seller using <code>createPinataStorage</code> (or any IPFS pinner) on the write side.</p>
-              </>
-            ),
-          },
-          {
-            id: "ipfs",
-            title: "createIpfsStorage",
-            content: <CodePanel title="ts" language="ts" code={IPFS_CODE} />,
-          },
-          {
-            id: "memory",
-            title: "createMemoryStorage",
-            content: <CodePanel title="ts" language="ts" code={MEMORY_CODE} />,
-          },
-          {
-            id: "routing",
-            title: "Inline cap + routing",
-            content: (
-              <>
-                <p>CDR sizes payloads at write time. The hard cap comes from the on-chain <code>CDR.maxEncryptedDataSize()</code> (currently ≈ 1 KB after TDH2 overhead). <code>getInlineLimit(client)</code> reads it once + caches; <code>shouldUseFile(content, limit)</code> picks the routing.</p>
-                <CodePanel title="ts" language="ts" code={ROUTING_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "s3",
-            title: "createS3Storage",
-            content: (
-              <>
-                <p>Works against AWS S3, Cloudflare R2, or any S3-compatible store. The SDK is loaded lazily via dynamic import so non-S3 deployments don&apos;t pay the bundle cost. Install <code>@aws-sdk/client-s3</code> yourself in your project.</p>
-                <CodePanel title="ts" language="ts" code={S3_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "storacha",
-            title: "createStorachaStorage",
-            content: (
-              <>
-                <p>UCAN-backed pinning service. Lazy-loads <code>@web3-storage/w3up-client</code>; install it yourself. The agent address must be authorized for the Space via a base64 UCAN proof.</p>
-                <CodePanel title="ts" language="ts" code={STORACHA_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "helia",
-            title: "createHeliaStorage",
-            content: (
-              <>
-                <p>Browser-side embedded IPFS. The user&apos;s tab IS the IPFS node — no remote pinner needed. Lazy-loads <code>helia</code> + <code>@helia/unixfs</code>. Pin <code>@peculiar/webcrypto: 1.7.0</code> in <code>pnpm.overrides</code> (Helia&apos;s WASM init is sensitive to webcrypto version drift).</p>
-                <CodePanel title="ts" language="ts" code={HELIA_CODE} />
-              </>
-            ),
-          },
-        ],
-        prev: { href: "/docs/hooks/use-storage-backend", label: "useStorageBackend" },
-        next: { href: "/docs/contracts", label: "Condition library" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/story/page.tsx b/apps/site/app/docs/story/page.tsx
deleted file mode 100644
index 8f9d524..0000000
--- a/apps/site/app/docs/story/page.tsx
+++ /dev/null
@@ -1,107 +0,0 @@
-import { Badge } from "@/components/primitives/badge";
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const PUBLISH_CODE = `import { CdrAgent } from "@cdr-kit/agent";
-import { PILFlavor } from "@cdr-kit/story";
-
-const agent = new CdrAgent({ privateKey: process.env.CDR_PRIVATE_KEY!, network: "aeneid" });
-
-const result = await agent.publish({
-  data: new TextEncoder().encode("the secret data"),
-  spgNftContract: "0xYourSpgCollection",
-  pilTerms: PILFlavor.commercialUse({
-    defaultMintingFee: 1_000_000_000_000_000_000n,  // 1 WIP per license
-    commercialRevShare: 5,                            // 5% derivative revenue
-  }),
-});
-
-// → { ipId, tokenId, licenseTermsId, vaultUuid,
-//     vaultTxHash, ipRegisterTxHash, writeTxHash }`;
-
-const BUYER_CODE = `// Buyer flow once they have { ipId, licenseTermsId, vaultUuid }:
-await agent.wrapIp({ amountWei: 1_000_000_000_000_000_000n });
-await agent.approveWip({ spender: ROYALTY_MODULE, amountWei: 1_000_000_000_000_000_000n });
-
-const { licenseTokenIds } = await agent.mintLicenseTokens({
-  licensorIpId: ipId,
-  licenseTermsId,
-  amount: 1n,
-  maxMintingFee: 1_000_000_000_000_000_000n,
-});
-
-const bytes = await agent.accessLicenseGated({
-  uuid: vaultUuid,
-  licenseTokenId: licenseTokenIds[0]!,
-});`;
-
-export default function Page() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit/story", "Overview"],
-        title: "@cdr-kit/story",
-        badges: <><Badge tone="primary">@cdr-kit/story</Badge><Badge>0.5</Badge></>,
-        lede: <>Thin TypeScript wrappers over <code>@story-protocol/core-sdk</code>: register an IP asset, attach PIL license terms, mint license tokens, register derivatives, wrap IP into WIP. Plus the headline <code>agent.publish()</code> one-shot that collapses register-IP + attach-terms + create-license-gated-vault + write-encrypted-data into a single agent call.</>,
-        importLine: 'import { PILFlavor, createStoryClient } from "@cdr-kit/story"',
-        sections: [
-          {
-            id: "publish",
-            title: "agent.publish() — the one-shot",
-            content: (
-              <>
-                <p>Collapses 4 normally-separate Story SDK calls into a single agent method. Returns the IP / license / vault artifacts a buyer needs to subscribe + read.</p>
-                <CodePanel title="ts" language="ts" code={PUBLISH_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "buyer",
-            title: "Buyer flow",
-            content: (
-              <>
-                <p>Once the seller publishes, share <code>{`{ ipId, licenseTermsId, vaultUuid }`}</code> with buyers (URL, QR, whatever). Buyer wraps IP → mints license token → reads vault:</p>
-                <CodePanel title="ts" language="ts" code={BUYER_CODE} />
-              </>
-            ),
-          },
-          {
-            id: "flavors",
-            title: "PIL flavors",
-            content: (
-              <ul>
-                <li><code>PILFlavor.nonCommercialSocialRemixing()</code> — open-source / free public IP (0 fee, 0 rev share).</li>
-                <li><code>PILFlavor.commercialUse({"{ defaultMintingFee, commercialRevShare }"})</code> — paid one-off use, no derivatives.</li>
-                <li><code>PILFlavor.commercialRemix({"{ defaultMintingFee, commercialRevShare }"})</code> — paid use + derivative works allowed, revenue flows back.</li>
-                <li><code>PILFlavor.creativeCommonsAttribution()</code> — CC-BY style (0 fee, attribution required).</li>
-              </ul>
-            ),
-          },
-          {
-            id: "individual",
-            title: "Lower-level wrappers",
-            content: (
-              <p>If <code>publish()</code> doesn&apos;t fit, the individual wrappers stay accessible from the agent: <code>registerIpAsset</code>, <code>attachLicenseTerms</code>, <code>mintLicenseTokens</code>, <code>registerDerivative</code>, <code>registerPilTerms</code>, <code>wrapIp</code>, <code>approveWip</code>. Each is a thin <code>@story-protocol/core-sdk</code> wrapper with normalized return shapes.</p>
-            ),
-          },
-          {
-            id: "react",
-            title: "React hooks",
-            content: (
-              <p><code>@cdr-kit/react</code> exposes <code>useStoryClient</code> (memoized client bound to the wagmi wallet), <code>useRegisterIp</code>, <code>useAttachLicenseTerms</code>, <code>useMintLicenseToken</code>, and <code>usePublish</code> (the one-shot delegator). Both <code>@cdr-kit/agent</code> and <code>@cdr-kit/story</code> are optional peer deps on the React package — pay only when you publish.</p>
-            ),
-          },
-          {
-            id: "skill",
-            title: "Design skill",
-            content: (
-              <p>See <a href="https://github.com/Blockchain-Oracle/cdr-kit/blob/main/packages/plugin/cdr-kit/skills/design-publish-with-story/SKILL.md"><code>design-publish-with-story</code></a> SKILL.md for the decision tree on picking PIL flavor, prerequisites (SPG NFT collection), common failure modes, and the agent / CLI / MCP triangulation.</p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/agent-kit", label: "Agent kit" },
-        next: { href: "/docs/contracts", label: "Condition library" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/docs/theming/page.tsx b/apps/site/app/docs/theming/page.tsx
deleted file mode 100644
index 04713ad..0000000
--- a/apps/site/app/docs/theming/page.tsx
+++ /dev/null
@@ -1,64 +0,0 @@
-import { DocPage } from "@/components/docs/doc-page";
-import { CodePanel } from "@/components/docs/code-panel";
-
-const APPEARANCE_CODE = `<CdrProvider
-  appearance={{
-    variables: {
-      "--cdr-accent": "#3E3BE3",
-      "--cdr-border": "#E6E2DA",
-      "--cdr-skeleton": "#EDEAE2",
-    },
-  }}
-  // ...
->`;
-
-export default function ThemingPage() {
-  return (
-    <DocPage
-      data={{
-        breadcrumb: ["@cdr-kit", "Getting started", "Theming"],
-        title: "Theming",
-        lede: (
-          <>
-            <code>@cdr-kit/react</code> is intentionally headless. The components ship minimal default visuals; you theme
-            the look through CSS custom properties passed via <code>CdrProvider.appearance.variables</code> (or by setting
-            them on a parent stylesheet).
-          </>
-        ),
-        sections: [
-          {
-            id: "tokens",
-            title: "Recognized tokens",
-            content: (
-              <ul>
-                <li><code>--cdr-accent</code> — primary accent</li>
-                <li><code>--cdr-border</code> — hairline border color</li>
-                <li><code>--cdr-skeleton</code> — placeholder background</li>
-                <li><code>--cdr-fg</code>, <code>--cdr-muted</code> — text colors</li>
-              </ul>
-            ),
-          },
-          {
-            id: "passing",
-            title: "Passing tokens",
-            content: (
-              <CodePanel title="App.tsx" code={APPEARANCE_CODE} />
-            ),
-          },
-          {
-            id: "styled",
-            title: "Styled variants",
-            content: (
-              <p>
-                Want batteries-included pre-styled components instead of headless slots? See{" "}
-                <code>@cdr-kit/react-ui</code> in the component gallery.
-              </p>
-            ),
-          },
-        ],
-        prev: { href: "/docs/quickstart", label: "Quickstart" },
-        next: { href: "/docs/components/cdr-provider", label: "CdrProvider" },
-      }}
-    />
-  );
-}
diff --git a/apps/site/app/globals.css b/apps/site/app/globals.css
index bd681ce..23165e8 100644
--- a/apps/site/app/globals.css
+++ b/apps/site/app/globals.css
@@ -495,3 +495,67 @@ h1, h2, h3 { font-family: var(--display); font-weight: 700; letter-spacing: -0.0
 .footer-bottom .mono { font-size: 0.76rem; color: var(--ink-3); }
 @media (max-width: 760px) { .footer-inner { grid-template-columns: 1fr 1fr; gap: 30px; } }
 
+
+/* T1-F: docs search — compact icon button in nav, popover dialog with results */
+.nav-search-btn { display: inline-flex; align-items: center; gap: 6px; padding: 0 9px; font-family: ui-monospace, monospace; font-size: 0.72rem; }
+.nav-search-btn svg { width: 14px; height: 14px; }
+.nav-search-kbd { color: var(--ink-2); opacity: 0.7; }
+@media (max-width: 720px) { .nav-search-kbd { display: none; } }
+
+.nav-search-overlay {
+  position: fixed; inset: 0; z-index: 200;
+  display: grid; place-items: start center;
+  padding: 8vh 20px 20px;
+  background: color-mix(in oklab, oklch(0% 0 0) 50%, transparent);
+  backdrop-filter: blur(6px);
+}
+.nav-search-panel {
+  width: 100%; max-width: 640px;
+  background: var(--paper, oklch(17% 0.012 90));
+  border: 1px solid var(--line, oklch(22% 0.012 90));
+  border-radius: 14px;
+  box-shadow: 0 24px 48px -16px color-mix(in oklab, oklch(0% 0 0) 60%, transparent);
+  overflow: hidden;
+}
+.nav-search-inputrow {
+  display: flex; align-items: center; gap: 10px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--line, oklch(22% 0.012 90));
+  color: var(--ink-2, oklch(70% 0.012 90));
+}
+.nav-search-inputrow input {
+  flex: 1; min-width: 0;
+  background: transparent; border: 0; outline: none;
+  color: var(--ink, oklch(94% 0.01 90));
+  font: inherit; font-size: 1rem;
+}
+.nav-search-inputrow input::placeholder { color: var(--ink-3, oklch(56% 0.01 90)); }
+.nav-search-esckbd {
+  padding: 2px 6px; border-radius: 4px; font-family: ui-monospace, monospace; font-size: 0.7rem;
+  background: var(--paper-2, oklch(20% 0.012 90));
+  border: 1px solid var(--line, oklch(24% 0.012 90));
+  color: var(--ink-2, oklch(70% 0.012 90));
+}
+.nav-search-results { max-height: min(60vh, 520px); overflow-y: auto; }
+.nav-search-result {
+  display: flex; flex-direction: column; gap: 2px;
+  padding: 10px 16px;
+  border-bottom: 1px solid color-mix(in oklab, var(--line) 60%, transparent);
+  text-decoration: none;
+}
+.nav-search-result.is-focused, .nav-search-result:hover {
+  background: color-mix(in oklab, var(--accent, oklch(78% 0.16 70)) 10%, transparent);
+}
+.nav-search-title {
+  color: var(--ink, oklch(94% 0.01 90));
+  font-size: 0.94rem; line-height: 1.3;
+}
+.nav-search-url {
+  color: var(--ink-3, oklch(56% 0.01 90));
+  font-family: ui-monospace, monospace; font-size: 0.74rem;
+}
+.nav-search-empty, .nav-search-hint {
+  padding: 18px 16px; margin: 0;
+  color: var(--ink-3, oklch(56% 0.01 90));
+  font-size: 0.9rem;
+}
diff --git a/apps/site/app/layout.tsx b/apps/site/app/layout.tsx
index 481a04e..ddbbc6c 100644
--- a/apps/site/app/layout.tsx
+++ b/apps/site/app/layout.tsx
@@ -4,6 +4,7 @@ import { fontVariables } from "@/lib/fonts";
 import { Nav } from "@/components/nav";
 import { Footer } from "@/components/footer";
 import { Reveal } from "@/components/reveal";
+import { SiteProviders } from "./providers";
 import "./globals.css";
 import "@cdr-kit/react-ui/styles.css";
 
@@ -24,10 +25,12 @@ export default function RootLayout({ children }: { children: ReactNode }) {
         <script dangerouslySetInnerHTML={{ __html: THEME_INIT }} />
       </head>
       <body>
-        <Reveal />
-        <Nav />
-        <main>{children}</main>
-        <Footer />
+        <SiteProviders>
+          <Reveal />
+          <Nav />
+          <main>{children}</main>
+          <Footer />
+        </SiteProviders>
       </body>
     </html>
   );
diff --git a/apps/site/app/llms-full.txt/route.ts b/apps/site/app/llms-full.txt/route.ts
new file mode 100644
index 0000000..66f2ff0
--- /dev/null
+++ b/apps/site/app/llms-full.txt/route.ts
@@ -0,0 +1,43 @@
+import { source } from "@/lib/source";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+// Cached forever — page content changes only at build time
+export const revalidate = false;
+
+/**
+ * Full text of every docs page, concatenated. AI agents fetch this once
+ * to get the entire docs corpus in one shot.
+ */
+export async function GET() {
+  const chunks: string[] = [];
+
+  for (const page of source.getPages()) {
+    const data = page.data as unknown as { title?: string; description?: string };
+    const title = data.title ?? page.url;
+    const desc = data.description ?? "";
+
+    chunks.push(`# ${title}\n`);
+    if (desc) chunks.push(`> ${desc}\n`);
+    chunks.push(`\nSource: https://cdr-kit.dev${page.url}\n\n`);
+
+    // Read the raw MDX file for the body — page.data.body is a compiled React
+    // component, not text. Derive file path from URL: /docs/x/y → content/docs/x/y.mdx;
+    // /docs → content/docs/index.mdx.
+    try {
+      const rel = page.url.replace(/^\/docs\/?/, "") || "index";
+      const mdxPath = join(process.cwd(), "content/docs", `${rel}.mdx`);
+      const raw = readFileSync(mdxPath, "utf-8");
+      // Strip frontmatter — content between first two `---` lines
+      const body = raw.replace(/^---\n[\s\S]*?\n---\n/, "").trim();
+      chunks.push(body);
+      chunks.push("\n\n---\n\n");
+    } catch {
+      // skip pages we can't read; the index in llms.txt still covers them
+    }
+  }
+
+  return new Response(chunks.join(""), {
+    headers: { "content-type": "text/plain; charset=utf-8" },
+  });
+}
diff --git a/apps/site/app/llms.txt/route.ts b/apps/site/app/llms.txt/route.ts
new file mode 100644
index 0000000..b2a7df4
--- /dev/null
+++ b/apps/site/app/llms.txt/route.ts
@@ -0,0 +1,30 @@
+import { source } from "@/lib/source";
+
+// Cached forever — page tree changes only at build time
+export const revalidate = false;
+
+/**
+ * AI-friendly index of every docs page. Mirrors the sidebar tree.
+ * AI agents (Claude/GPT/etc.) crawl this to understand the docs surface area.
+ */
+export async function GET() {
+  const lines: string[] = [
+    "# cdr-kit",
+    "",
+    "> Developer toolkit for Story Protocol's Confidential Data Rails (CDR). Ship private, paid, license-gated data on Story.",
+    "",
+    "## Documentation",
+    "",
+  ];
+
+  for (const page of source.getPages()) {
+    const data = page.data as unknown as { title?: string; description?: string };
+    const title = data.title ?? page.url;
+    const desc = data.description ? `: ${data.description}` : "";
+    lines.push(`- [${title}](https://cdr-kit.dev${page.url})${desc}`);
+  }
+
+  return new Response(lines.join("\n"), {
+    headers: { "content-type": "text/plain; charset=utf-8" },
+  });
+}
diff --git a/apps/site/app/providers.tsx b/apps/site/app/providers.tsx
new file mode 100644
index 0000000..123c75d
--- /dev/null
+++ b/apps/site/app/providers.tsx
@@ -0,0 +1,32 @@
+"use client";
+
+import { useState, type ReactNode } from "react";
+import { WagmiProvider } from "wagmi";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { RainbowKitProvider, darkTheme } from "@rainbow-me/rainbowkit";
+import { wagmiConfig } from "@/lib/wagmi-config";
+import "@rainbow-me/rainbowkit/styles.css";
+
+/**
+ * Site-wide client providers: wagmi → react-query → RainbowKit. Wraps everything
+ * inside <body>. No CdrConfigProvider here — that lives inside the docs Demo blocks
+ * (via DocsLiveProvider) so non-docs pages don't pay the WASM init cost.
+ */
+export function SiteProviders({ children }: { children: ReactNode }) {
+  const [queryClient] = useState(() => new QueryClient());
+  return (
+    <WagmiProvider config={wagmiConfig}>
+      <QueryClientProvider client={queryClient}>
+        <RainbowKitProvider
+          theme={darkTheme({
+            accentColor: "oklch(78% 0.16 70)",
+            accentColorForeground: "oklch(15% 0.012 90)",
+            borderRadius: "medium",
+          })}
+        >
+          {children}
+        </RainbowKitProvider>
+      </QueryClientProvider>
+    </WagmiProvider>
+  );
+}
diff --git a/apps/site/app/showcase/blog/page.tsx b/apps/site/app/showcase/blog/page.tsx
index 8a57c48..bac7487 100644
--- a/apps/site/app/showcase/blog/page.tsx
+++ b/apps/site/app/showcase/blog/page.tsx
@@ -3,7 +3,7 @@
 import { useEffect, useState } from "react";
 import Link from "next/link";
 import { UnlockablePill } from "@cdr-kit/react-ui";
-import { DocsMockProvider } from "@/components/docs/providers";
+import { DocsLiveProvider } from "@/components/docs/providers";
 import "./blog.css";
 
 const HINT_KEY = "cdr-blog-pill-hint-seen";
@@ -40,7 +40,7 @@ function FirstPillHint() {
 
 export default function ShowcaseBlogPage() {
   return (
-    <DocsMockProvider>
+    <DocsLiveProvider>
       <article className="blog">
         <header className="blog-head">
           <Link href="/" className="blog-back">← cdr-kit</Link>
@@ -110,6 +110,6 @@ export default function ShowcaseBlogPage() {
           </p>
         </div>
       </article>
-    </DocsMockProvider>
+    </DocsLiveProvider>
   );
 }
diff --git a/apps/site/components/docs/copy-page-button.tsx b/apps/site/components/docs/copy-page-button.tsx
new file mode 100644
index 0000000..3d24526
--- /dev/null
+++ b/apps/site/components/docs/copy-page-button.tsx
@@ -0,0 +1,45 @@
+"use client";
+
+import { useState } from "react";
+
+/**
+ * Per-page "Copy page" button — copies the raw MDX source so an AI agent
+ * (Claude, GPT, etc.) can ingest a single page without crawling. The
+ * markdown text is passed in from the server component, so this stays
+ * fully client-side with no fetch round-trip.
+ */
+export function CopyPageButton({ markdown }: { markdown: string }) {
+  const [copied, setCopied] = useState(false);
+
+  async function onCopy() {
+    try {
+      await navigator.clipboard.writeText(markdown);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1400);
+    } catch {
+      // clipboard API not available — fall back silently
+    }
+  }
+
+  return (
+    <button
+      type="button"
+      onClick={onCopy}
+      className="copy-page-btn"
+      data-copied={copied || undefined}
+      title="Copy page as markdown — paste into Claude / ChatGPT / Cursor"
+    >
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden>
+        {copied ? (
+          <path d="M20 6 9 17l-5-5" />
+        ) : (
+          <>
+            <rect x="9" y="9" width="13" height="13" rx="2" ry="2" />
+            <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
+          </>
+        )}
+      </svg>
+      <span>{copied ? "Copied" : "Copy page"}</span>
+    </button>
+  );
+}
diff --git a/apps/site/components/docs/demos/cdr-error-demo.tsx b/apps/site/components/docs/demos/cdr-error-demo.tsx
new file mode 100644
index 0000000..8eccc8a
--- /dev/null
+++ b/apps/site/components/docs/demos/cdr-error-demo.tsx
@@ -0,0 +1,25 @@
+"use client";
+
+import { useState } from "react";
+import { CdrError } from "@cdr-kit/react-ui";
+
+/**
+ * Client-side demo for {@link CdrError}. The retry button needs a real onRetry
+ * handler — the catch-all docs route is a Server Component, so the handler
+ * can't be serialized inline in MDX. Wrapping it in this "use client" demo
+ * lets the button actually click without RSC-serialization errors.
+ */
+export function CdrErrorDemo() {
+  const [retries, setRetries] = useState(0);
+  return (
+    <CdrError
+      title="Read timed out"
+      message={
+        retries === 0
+          ? "Threshold not met in time."
+          : `Threshold not met in time. (retried ${retries}×)`
+      }
+      onRetry={() => setRetries((n) => n + 1)}
+    />
+  );
+}
diff --git a/apps/site/components/docs/demos/components-gallery-demo.tsx b/apps/site/components/docs/demos/components-gallery-demo.tsx
new file mode 100644
index 0000000..bda5a60
--- /dev/null
+++ b/apps/site/components/docs/demos/components-gallery-demo.tsx
@@ -0,0 +1,236 @@
+"use client";
+
+import Link from "next/link";
+import { type ReactNode } from "react";
+import {
+  CdrNetworkChip,
+  CdrSpinner,
+  CdrProgress,
+  CdrError,
+  IpPrice,
+  ConditionBadge,
+  ShortAddress,
+  ExplorerLink,
+} from "@cdr-kit/react-ui";
+import { aeneid } from "@cdr-kit/contracts";
+
+// Single source for the factory address — never hardcode the literal here
+// (CLAUDE.md: addresses live in @cdr-kit/contracts only).
+const FACTORY = aeneid.cdrKitVault as `0x${string}`;
+const FACTORY_EXPLORER = `https://aeneid.storyscan.xyz/address/${FACTORY}`;
+
+interface Tile {
+  href: string;
+  label: string;
+  importLine?: string;
+  preview: ReactNode;
+}
+
+interface Section {
+  heading: string;
+  hint: string;
+  tiles: Tile[];
+}
+
+const SECTIONS: Section[] = [
+  {
+    heading: "Headless · @cdr-kit/react",
+    hint: "Render-prop slots + hooks. Bring your own visuals.",
+    tiles: [
+      {
+        href: "/docs/components/cdr-provider",
+        label: "<CdrProvider>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Root provider — wagmi + react-query + WASM init</span>,
+      },
+      {
+        href: "/docs/components/vault-gate",
+        label: "<VaultGate>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Declarative gate around encrypted data</span>,
+      },
+      {
+        href: "/docs/components/vault",
+        label: "<Vault>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Compound: Vault.Locked · Loading · Unlocked</span>,
+      },
+      {
+        href: "/docs/components/cdr-inspector",
+        label: "<CdrInspector>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Dev panel — mode + WASM + API URL</span>,
+      },
+      {
+        href: "/docs/components/cdr-skeleton",
+        label: "<CdrSkeleton>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Default loading slot placeholder</span>,
+      },
+      {
+        href: "/docs/components/empty-vaults",
+        label: "<EmptyVaults>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Semantic empty-state slot</span>,
+      },
+    ],
+  },
+  {
+    heading: "0.5 advanced · @cdr-kit/react",
+    hint: "Headless components for the 4 advanced conditions deployed in 0.5.",
+    tiles: [
+      {
+        href: "/docs/components/heartbeat-timer",
+        label: "<HeartbeatTimer>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>DeadManSwitch countdown + creator poke()</span>,
+      },
+      {
+        href: "/docs/components/time-window-badge",
+        label: "<TimeWindowBadge>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Open / opens-in / closes-in / closed</span>,
+      },
+      {
+        href: "/docs/components/multi-sig-approval-tracker",
+        label: "<MultiSigApprovalTracker>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>X of Y approved + epoch tracker</span>,
+      },
+      {
+        href: "/docs/components/multi-sig-signer",
+        label: "<MultiSigSigner>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>EIP-712 signer + clipboard signature</span>,
+      },
+      {
+        href: "/docs/components/escrow-delivery-confirm",
+        label: "<EscrowDeliveryConfirm>",
+        importLine: "@cdr-kit/react",
+        preview: <span data-tile-headless>Buyer pay → confirm delivery</span>,
+      },
+    ],
+  },
+  {
+    heading: "Styled · @cdr-kit/react-ui",
+    hint: "Designed, batteries-included. Live previews below.",
+    tiles: [
+      {
+        href: "/docs/components/condition-badge",
+        label: "<ConditionBadge>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <ConditionBadge kind="subscription" />,
+      },
+      {
+        href: "/docs/components/cdr-network-chip",
+        label: "<CdrNetworkChip>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <CdrNetworkChip mode="live" />,
+      },
+      {
+        href: "/docs/components/cdr-spinner",
+        label: "<CdrSpinner>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <CdrSpinner />,
+      },
+      {
+        href: "/docs/components/cdr-progress",
+        label: "<CdrProgress>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <CdrProgress collected={4} threshold={7} />,
+      },
+      {
+        href: "/docs/components/ip-price",
+        label: "<IpPrice>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <IpPrice wei={5n * 10n ** 18n} period="month" />,
+      },
+      {
+        href: "/docs/components/short-address",
+        label: "<ShortAddress>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <ShortAddress address={FACTORY} />,
+      },
+      {
+        href: "/docs/components/explorer-link",
+        label: "<ExplorerLink>",
+        importLine: "@cdr-kit/react-ui",
+        preview: (
+          <ExplorerLink href={FACTORY_EXPLORER}>view on explorer</ExplorerLink>
+        ),
+      },
+      {
+        href: "/docs/components/cdr-error",
+        label: "<CdrError>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <CdrError title="Read timed out" />,
+      },
+      {
+        href: "/docs/components/access-stepper",
+        label: "<AccessStepper>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <span data-tile-headless>pay → collect-partials → decrypt</span>,
+      },
+      {
+        href: "/docs/components/subscribe-button",
+        label: "<SubscribeButton>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <span data-tile-headless>CTA + stepper + decoded payload</span>,
+      },
+      {
+        href: "/docs/components/vault-card",
+        label: "<VaultCard>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <span data-tile-headless>Marketplace card w/ pointer spotlight</span>,
+      },
+      {
+        href: "/docs/components/unlockable",
+        label: "<UnlockablePill>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <span data-tile-headless>Inline pay-to-unlock pill (onscroll-style)</span>,
+      },
+      {
+        href: "/docs/components/copy-button",
+        label: "<CopyButton>",
+        importLine: "@cdr-kit/react-ui",
+        preview: <span data-tile-headless>Tap-to-copy with checkmark feedback</span>,
+      },
+    ],
+  },
+];
+
+/**
+ * Gallery grid that restores the bespoke "at a glance" components-index look
+ * lost in the TSX → MDX migration. Each tile shows a live (or descriptive)
+ * preview + import line + link to the detail page.
+ */
+export function ComponentsGalleryDemo() {
+  return (
+    <div data-components-gallery>
+      {SECTIONS.map((section) => (
+        <section key={section.heading} data-gallery-section>
+          <div data-gallery-section-head>
+            <h3>{section.heading}</h3>
+            <p data-gallery-hint>{section.hint}</p>
+          </div>
+          <div data-gallery-grid>
+            {section.tiles.map((tile) => (
+              <Link
+                key={tile.href}
+                href={tile.href}
+                data-gallery-tile
+                aria-label={`Docs for ${tile.label}`}
+              >
+                <div data-tile-preview>{tile.preview}</div>
+                <div data-tile-meta>
+                  <code data-tile-label>{tile.label}</code>
+                  {tile.importLine && <span data-tile-import>{tile.importLine}</span>}
+                </div>
+              </Link>
+            ))}
+          </div>
+        </section>
+      ))}
+    </div>
+  );
+}
diff --git a/apps/site/components/docs/demos/headless-demos.tsx b/apps/site/components/docs/demos/headless-demos.tsx
index cd6f48f..95255cd 100644
--- a/apps/site/components/docs/demos/headless-demos.tsx
+++ b/apps/site/components/docs/demos/headless-demos.tsx
@@ -1,13 +1,13 @@
 "use client";
 
 import { CdrInspector, CdrSkeleton, EmptyVaults } from "@cdr-kit/react";
-import { DocsMockProvider } from "../providers";
+import { DocsLiveProvider } from "../providers";
 
 export function CdrInspectorDemo() {
   return (
-    <DocsMockProvider>
+    <DocsLiveProvider>
       <CdrInspector />
-    </DocsMockProvider>
+    </DocsLiveProvider>
   );
 }
 
diff --git a/apps/site/components/docs/demos/unlockable-demo.tsx b/apps/site/components/docs/demos/unlockable-demo.tsx
index 6d1d607..680bcf3 100644
--- a/apps/site/components/docs/demos/unlockable-demo.tsx
+++ b/apps/site/components/docs/demos/unlockable-demo.tsx
@@ -1,13 +1,13 @@
 "use client";
 
 import { UnlockablePill } from "@cdr-kit/react-ui";
-import { DocsMockProvider } from "../providers";
+import { DocsLiveProvider } from "../providers";
 
 /** Live preview for `/docs/components/unlockable` — a realistic blog paragraph with three
  *  pills of different reveal types (text exhibit, image attachment, hidden prose). */
 export function UnlockableDemo() {
   return (
-    <DocsMockProvider>
+    <DocsLiveProvider>
       <article className="unl-demo">
         <h3 className="unl-demo-title">Trouble at the Lake House</h3>
         <p className="unl-demo-byline">Arlo Vance · 6 min read</p>
@@ -36,6 +36,6 @@ export function UnlockableDemo() {
           — written in his own hand the morning after.
         </p>
       </article>
-    </DocsMockProvider>
+    </DocsLiveProvider>
   );
 }
diff --git a/apps/site/components/docs/demos/vault-gate-demo.tsx b/apps/site/components/docs/demos/vault-gate-demo.tsx
index 615e509..3030ab8 100644
--- a/apps/site/components/docs/demos/vault-gate-demo.tsx
+++ b/apps/site/components/docs/demos/vault-gate-demo.tsx
@@ -3,7 +3,7 @@
 import { useState } from "react";
 import { useSubscribeAndAccess } from "@cdr-kit/react";
 import { Badge } from "@/components/primitives/badge";
-import { DocsMockProvider } from "../providers";
+import { DocsLiveProvider } from "../providers";
 
 const PRICE_WEI = BigInt(5);
 const PERIOD = 30 * 24 * 60 * 60;
@@ -78,8 +78,8 @@ function VaultWidget() {
 
 export function VaultGateDemo() {
   return (
-    <DocsMockProvider>
+    <DocsLiveProvider>
       <VaultWidget />
-    </DocsMockProvider>
+    </DocsLiveProvider>
   );
 }
diff --git a/apps/site/components/docs/doc-page.tsx b/apps/site/components/docs/doc-page.tsx
index 13e8ebb..b1e0107 100644
--- a/apps/site/components/docs/doc-page.tsx
+++ b/apps/site/components/docs/doc-page.tsx
@@ -8,6 +8,12 @@ export interface DocSection {
   content: ReactNode;
 }
 
+/** Right-rail TOC item — either derived from `sections` or supplied directly (e.g. from fumadocs MDX heading scan). */
+export interface DocTocItem {
+  id: string;
+  label: string;
+}
+
 export interface DocPageData {
   breadcrumb: string[];
   title: string;
@@ -20,8 +26,16 @@ export interface DocPageData {
   next?: { href: string; label: string };
 }
 
-/** The canonical anatomy: breadcrumb → title row → lede → import badge → optional callout → sections → prev/next. */
-export function DocPage({ data }: { data: DocPageData }) {
+/** The canonical anatomy: breadcrumb → title row → lede → import badge → optional callout → sections → prev/next.
+ *  Pass `tocItems` to override the right-rail TOC (e.g. from MDX heading scan); otherwise derived from sections. */
+export function DocPage({
+  data,
+  tocItems,
+}: {
+  data: DocPageData;
+  tocItems?: DocTocItem[];
+}) {
+  const items = tocItems ?? data.sections.filter((s) => s.title).map((s) => ({ id: s.id, label: s.title }));
   return (
     <>
       <main className="doc">
@@ -36,13 +50,13 @@ export function DocPage({ data }: { data: DocPageData }) {
         {data.callout}
         {data.sections.map((s) => (
           <section key={s.id}>
-            <H2 id={s.id}>{s.title}</H2>
+            {s.title && <H2 id={s.id}>{s.title}</H2>}
             {s.content}
           </section>
         ))}
         <PrevNext prev={data.prev} next={data.next} />
       </main>
-      <Toc items={data.sections.map((s) => ({ id: s.id, label: s.title }))} />
+      <Toc items={items} />
     </>
   );
 }
diff --git a/apps/site/components/docs/providers.tsx b/apps/site/components/docs/providers.tsx
index e4a3e7d..9829762 100644
--- a/apps/site/components/docs/providers.tsx
+++ b/apps/site/components/docs/providers.tsx
@@ -1,35 +1,45 @@
 "use client";
 
-import { useMemo, type ReactNode } from "react";
-import { CdrProvider } from "@cdr-kit/react";
-import { createMockCdrKit } from "@cdr-kit/core";
+import type { ReactNode } from "react";
+import { useAccount } from "wagmi";
+import { ConnectButton } from "@rainbow-me/rainbowkit";
+import { CdrConfigProvider } from "@cdr-kit/react";
+import { AENEID_CHAIN_ID } from "@/lib/wagmi-config";
 
-const PLAINTEXT = '{ "signal": "BUY", "pair": "ETH/USD",\n  "confidence": 0.86, "ttl": "30d" }';
-const UNLOCK_TEXT = "Tahoe county sheriff's report — exhibit 14B:\n\n\"At 7:42pm the suspect was observed exiting via the boat-house door, not the main path as the witness initially stated. The discrepancy is the case.\"";
-const UNLOCK_PROSE = "The shadow on the dock wasn't her sister.\n\nArlo had paid Mrs. Calder twenty dollars to keep the negative — she'd developed it in her own basement that summer, before the fire. The woman in the silver swimsuit was Eleanor Vance, and she had not, as she would later testify, been three hundred miles south at the time.";
-// 1x1 transparent PNG — smallest valid PNG we can use to prove the auto-detect image branch.
-// Real demos would hold an actual image; this is enough to flip the magic-byte detector.
-const TINY_PNG = new Uint8Array([
-  0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00, 0x00, 0x0d, 0x49, 0x48, 0x44, 0x52,
-  0x00, 0x00, 0x00, 0x60, 0x00, 0x00, 0x00, 0x40, 0x08, 0x06, 0x00, 0x00, 0x00, 0x52, 0x99, 0xe8,
-  0xb9, 0x00, 0x00, 0x00, 0x19, 0x74, 0x45, 0x58, 0x74, 0x53, 0x6f, 0x66, 0x74, 0x77, 0x61, 0x72,
-  0x65, 0x00, 0x41, 0x64, 0x6f, 0x62, 0x65, 0x20, 0x49, 0x6d, 0x61, 0x67, 0x65, 0x52, 0x65, 0x61,
-  0x64, 0x79, 0x71, 0xc9, 0x65, 0x3c, 0x00, 0x00, 0x00, 0x1f, 0x49, 0x44, 0x41, 0x54, 0x78, 0xda,
-  0xed, 0xc1, 0x01, 0x0d, 0x00, 0x00, 0x00, 0xc2, 0xa0, 0xf7, 0x4f, 0x6d, 0x0e, 0x37, 0xa0, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xbe, 0x0d, 0x21, 0x00, 0x00, 0x01, 0x9a, 0x60, 0xe1,
-  0xd5, 0x00, 0x00, 0x00, 0x00, 0x49, 0x45, 0x4e, 0x44, 0xae, 0x42, 0x60, 0x82,
-]);
+/**
+ * Live CDR provider for docs demos. Reads wagmi from the surrounding SiteProviders.
+ * No mock. When the visitor hasn't connected (or is on the wrong chain) we render
+ * a frosted overlay with a Connect CTA; once they connect, the demo runs the real
+ * on-chain flow against the configured vault.
+ */
+export function DocsLiveProvider({ children }: { children: ReactNode }) {
+  const { isConnected, chainId } = useAccount();
+  const onAeneid = chainId === AENEID_CHAIN_ID;
 
-/** Wraps a demo subtree in a real `<CdrProvider>` driven by `createMockCdrKit()`, seeded so the
- *  canonical demo uuids resolve to real bytes. Used by every live demo on every docs page. */
-export function DocsMockProvider({ children }: { children: ReactNode }) {
-  const kit = useMemo(() => {
-    const k = createMockCdrKit({ readDelayMs: 2200, threshold: 7 });
-    void k.writeVaultData({ uuid: 4200, dataKey: new TextEncoder().encode(PLAINTEXT) });
-    void k.writeVaultData({ uuid: 4242, dataKey: new TextEncoder().encode(UNLOCK_TEXT) });
-    void k.writeVaultData({ uuid: 4243, dataKey: TINY_PNG });
-    void k.writeVaultData({ uuid: 4244, dataKey: new TextEncoder().encode(UNLOCK_PROSE) });
-    return k;
-  }, []);
-  return <CdrProvider mockKit={kit}>{children}</CdrProvider>;
+  return (
+    <CdrConfigProvider>
+      <div className="docs-live-wrap">
+        {children}
+        {(!isConnected || !onAeneid) && (
+          <div className="docs-live-overlay" aria-live="polite">
+            <div className="docs-live-card">
+              <p className="docs-live-eyebrow">live · Aeneid testnet</p>
+              <p className="docs-live-title">
+                {!isConnected ? "Connect your wallet to interact." : "Switch to Aeneid testnet."}
+              </p>
+              <p className="docs-live-sub">
+                Every demo runs the real subscribe → threshold-decrypt → reveal flow.
+                Grab free testnet IP at{" "}
+                <a href="https://aeneid.faucet.story.foundation/" target="_blank" rel="noreferrer">
+                  the Aeneid faucet
+                </a>
+                .
+              </p>
+              <ConnectButton accountStatus="address" chainStatus="icon" />
+            </div>
+          </div>
+        )}
+      </div>
+    </CdrConfigProvider>
+  );
 }
diff --git a/apps/site/components/docs/sidebar.tsx b/apps/site/components/docs/sidebar.tsx
index c705e12..a3b2478 100644
--- a/apps/site/components/docs/sidebar.tsx
+++ b/apps/site/components/docs/sidebar.tsx
@@ -140,6 +140,10 @@ export const SIDEBAR: SideGroup[] = [
     heading: "Plugin / Skill",
     links: [{ href: "/docs/skill", label: "Claude Code plugin", tag: "new" }],
   },
+  {
+    heading: "Forms",
+    links: [{ href: "/docs/forms", label: "@cdr-kit/forms", tag: "0.7" }],
+  },
   {
     heading: "Showcase",
     links: [{ href: "/showcase/blog", label: "Pay-to-unlock blog" }],
diff --git a/apps/site/components/gallery/subscribe-button-demo.tsx b/apps/site/components/gallery/subscribe-button-demo.tsx
index 8a06191..808b581 100644
--- a/apps/site/components/gallery/subscribe-button-demo.tsx
+++ b/apps/site/components/gallery/subscribe-button-demo.tsx
@@ -1,14 +1,14 @@
 "use client";
 
 import { SubscribeButton } from "@cdr-kit/react-ui";
-import { DocsMockProvider } from "@/components/docs/providers";
+import { DocsLiveProvider } from "@/components/docs/providers";
 
 const FIVE_IP = BigInt(5) * BigInt(10) ** BigInt(18);
 
 export function SubscribeButtonDemo() {
   return (
-    <DocsMockProvider>
+    <DocsLiveProvider>
       <SubscribeButton uuid={4200} priceWei={FIVE_IP} priceLabel="5 $IP" />
-    </DocsMockProvider>
+    </DocsLiveProvider>
   );
 }
diff --git a/apps/site/components/nav-search.tsx b/apps/site/components/nav-search.tsx
new file mode 100644
index 0000000..7269503
--- /dev/null
+++ b/apps/site/components/nav-search.tsx
@@ -0,0 +1,153 @@
+"use client";
+
+import { useCallback, useEffect, useRef, useState } from "react";
+import Link from "next/link";
+
+/**
+ * Compact docs search button → dialog. Hits `/api/search` (Orama, via fumadocs).
+ *
+ * We fetch the endpoint directly with a 120ms debounce instead of going through
+ * fumadocs' `useDocsSearch` — the hook silently returned no data even when the
+ * underlying API returned 5 results, which made it ship-broken.
+ *
+ * Keyboard: Cmd/Ctrl+K opens, Esc closes, ArrowUp/Down navigates, Enter follows.
+ */
+
+interface SearchResult {
+  id: string;
+  type: "page" | "heading" | "text";
+  content: string;
+  url: string;
+  breadcrumbs?: string[];
+}
+
+export function NavSearch() {
+  const [open, setOpen] = useState(false);
+  const [query, setQuery] = useState("");
+  const [results, setResults] = useState<SearchResult[]>([]);
+  const [focused, setFocused] = useState(0);
+  const inputRef = useRef<HTMLInputElement | null>(null);
+  const debounceRef = useRef<number | undefined>(undefined);
+
+  // Cmd/Ctrl+K opens; Esc closes
+  useEffect(() => {
+    function onKey(e: KeyboardEvent) {
+      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "k") {
+        e.preventDefault();
+        setOpen(true);
+      } else if (e.key === "Escape") {
+        setOpen(false);
+      }
+    }
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, []);
+
+  // Focus input on open
+  useEffect(() => {
+    if (open) setTimeout(() => inputRef.current?.focus(), 10);
+  }, [open]);
+
+  // Debounced search
+  const runSearch = useCallback((q: string) => {
+    if (!q.trim()) {
+      setResults([]);
+      return;
+    }
+    fetch(`/api/search?query=${encodeURIComponent(q)}`)
+      .then((r) => r.json())
+      .then((data: SearchResult[] | { error?: string }) => {
+        if (Array.isArray(data)) {
+          // Strip <mark> tags for clean display (server marks the matched substring)
+          setResults(data.slice(0, 10));
+        } else {
+          setResults([]);
+        }
+      })
+      .catch(() => setResults([]));
+  }, []);
+
+  useEffect(() => {
+    window.clearTimeout(debounceRef.current);
+    debounceRef.current = window.setTimeout(() => runSearch(query), 120);
+    return () => window.clearTimeout(debounceRef.current);
+  }, [query, runSearch]);
+
+  // Strip <mark>/</mark> for clean display
+  const clean = (s: string) => s.replace(/<\/?mark>/g, "");
+
+  return (
+    <>
+      <button
+        type="button"
+        className="icon-btn nav-icon-md nav-search-btn"
+        onClick={() => setOpen(true)}
+        aria-label="Search docs"
+        title="Search docs (⌘K)"
+      >
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden>
+          <circle cx="11" cy="11" r="7" />
+          <path d="m21 21-4.3-4.3" />
+        </svg>
+        <span className="nav-search-kbd">⌘K</span>
+      </button>
+
+      {open && (
+        <div className="nav-search-overlay" role="dialog" aria-modal="true" aria-label="Search docs" onClick={() => setOpen(false)}>
+          <div className="nav-search-panel" onClick={(e) => e.stopPropagation()}>
+            <div className="nav-search-inputrow">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden>
+                <circle cx="11" cy="11" r="7" />
+                <path d="m21 21-4.3-4.3" />
+              </svg>
+              <input
+                ref={inputRef}
+                value={query}
+                onChange={(e) => {
+                  setQuery(e.target.value);
+                  setFocused(0);
+                }}
+                onKeyDown={(e) => {
+                  if (e.key === "ArrowDown") {
+                    e.preventDefault();
+                    setFocused((i) => Math.min(i + 1, results.length - 1));
+                  } else if (e.key === "ArrowUp") {
+                    e.preventDefault();
+                    setFocused((i) => Math.max(i - 1, 0));
+                  } else if (e.key === "Enter" && results[focused]) {
+                    window.location.href = results[focused]!.url;
+                  }
+                }}
+                placeholder="Search components, hooks, contracts…"
+                aria-label="Search query"
+              />
+              <kbd className="nav-search-esckbd">esc</kbd>
+            </div>
+            <div className="nav-search-results">
+              {results.length === 0 && query && (
+                <p className="nav-search-empty">No matches for &ldquo;{query}&rdquo;.</p>
+              )}
+              {results.length === 0 && !query && (
+                <p className="nav-search-hint">Type to search the docs.</p>
+              )}
+              {results.map((r, i) => (
+                <Link
+                  key={r.id}
+                  href={r.url}
+                  className={i === focused ? "nav-search-result is-focused" : "nav-search-result"}
+                  onMouseEnter={() => setFocused(i)}
+                  onClick={() => setOpen(false)}
+                >
+                  <span className="nav-search-title">{clean(r.content)}</span>
+                  <span className="nav-search-url">
+                    {r.breadcrumbs ? r.breadcrumbs.join(" › ") : r.url}
+                  </span>
+                </Link>
+              ))}
+            </div>
+          </div>
+        </div>
+      )}
+    </>
+  );
+}
diff --git a/apps/site/components/nav.tsx b/apps/site/components/nav.tsx
index 6869838..73151eb 100644
--- a/apps/site/components/nav.tsx
+++ b/apps/site/components/nav.tsx
@@ -5,6 +5,7 @@ import { usePathname } from "next/navigation";
 import { useEffect, useRef, useState } from "react";
 import { LockboxGlyph, Npm, Github } from "./icons";
 import { ThemeToggle } from "./theme-toggle";
+import { NavSearch } from "./nav-search";
 
 const primary = [
   { href: "/docs", label: "Docs" },
@@ -107,6 +108,7 @@ export function Nav() {
           </Link>
         </nav>
         <div className="nav-right">
+          <NavSearch />
           <a
             className="icon-btn nav-icon-md"
             href="https://www.npmjs.com/org/cdr-kit"
diff --git a/apps/site/content/docs/agent-kit/agentkit.mdx b/apps/site/content/docs/agent-kit/agentkit.mdx
new file mode 100644
index 0000000..949fcdb
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/agentkit.mdx
@@ -0,0 +1,21 @@
+---
+title: Coinbase AgentKit adapter
+description: "Coinbase AgentKit ActionProvider exposing the three CDR tools as on-chain actions."
+importLine: 'import { cdrActionProvider } from "@cdr-kit/agentkit"'
+breadcrumb: ["@cdr-kit", "Agent kit", "Coinbase AgentKit"]
+prev:
+  href: /docs/agent-kit/langchain
+  label: LangChain
+next:
+  href: /docs/agent-kit/goat
+  label: GOAT SDK
+---
+
+## Usage
+
+<CodePanel title="agentkit.ts" code={`import { CdrAgent } from "@cdr-kit/agent";
+import { cdrActionProvider } from "@cdr-kit/agentkit";
+
+const agent = new CdrAgent({ privateKey, apiUrl });
+// Slot into Coinbase AgentKit's action providers:
+const provider = cdrActionProvider(agent);`} />
diff --git a/apps/site/content/docs/agent-kit/goat.mdx b/apps/site/content/docs/agent-kit/goat.mdx
new file mode 100644
index 0000000..ce03c32
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/goat.mdx
@@ -0,0 +1,20 @@
+---
+title: GOAT SDK adapter
+description: "GOAT SDK plugin exposing the CDR tools to any GOAT-enabled agent stack."
+importLine: 'import { cdrPlugin } from "@cdr-kit/goat"'
+breadcrumb: ["@cdr-kit", "Agent kit", "GOAT SDK"]
+prev:
+  href: /docs/agent-kit/agentkit
+  label: Coinbase AgentKit
+next:
+  href: /docs/agent-kit/mcp
+  label: MCP server
+---
+
+## Usage
+
+<CodePanel title="goat.ts" code={`import { CdrAgent } from "@cdr-kit/agent";
+import { cdrPlugin } from "@cdr-kit/goat";
+
+const agent = new CdrAgent({ privateKey, apiUrl });
+const plugin = cdrPlugin(agent); // pass into GOAT's getOnChainTools`} />
diff --git a/apps/site/content/docs/agent-kit/index.mdx b/apps/site/content/docs/agent-kit/index.mdx
new file mode 100644
index 0000000..9f3ac78
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/index.mdx
@@ -0,0 +1,40 @@
+---
+title: CdrAgent
+description: "Autonomous agent client: discover vaults on the factory, subscribe from its own wallet, decrypt, and use the data — no human in the loop. The headless object every framework adapter wraps."
+importLine: 'import { CdrAgent } from "@cdr-kit/agent"'
+breadcrumb: ["@cdr-kit", "Agent kit"]
+prev:
+  href: /docs/hooks/use-cdr-wallet
+  label: useCdrWallet
+next:
+  href: /docs/agent-kit/vercel-ai
+  label: Vercel AI SDK
+---
+
+## Usage
+
+<CodePanel title="agent-demo.ts" code={`import { CdrAgent } from "@cdr-kit/agent";
+
+const agent = new CdrAgent({
+  privateKey: process.env.PRIVATE_KEY,
+  apiUrl: process.env.CDR_API_URL,
+});
+
+const vaults = await agent.discover();
+const bytes = await agent.subscribeAndAccess({
+  uuid: vaults[0].uuid,
+  periods: 1n,
+  maxPricePerPeriod: 5n * 10n ** 18n,
+  value: 5n * 10n ** 18n,
+});`} />
+
+## Framework adapters
+
+<ul>
+  <li><a href="/docs/agent-kit/vercel-ai"><code>@cdr-kit/vercel-ai</code></a> — <code>generateText</code> tools</li>
+  <li><a href="/docs/agent-kit/openai"><code>@cdr-kit/openai</code></a> — OpenAI / Anthropic JSON-schema tools</li>
+  <li><a href="/docs/agent-kit/langchain"><code>@cdr-kit/langchain</code></a> — <code>StructuredTool</code>s</li>
+  <li><a href="/docs/agent-kit/agentkit"><code>@cdr-kit/agentkit</code></a> — Coinbase AgentKit <code>ActionProvider</code></li>
+  <li><a href="/docs/agent-kit/goat"><code>@cdr-kit/goat</code></a> — GOAT SDK plugin</li>
+  <li><a href="/docs/agent-kit/mcp"><code>@cdr-kit/mcp</code></a> — MCP server</li>
+</ul>
diff --git a/apps/site/content/docs/agent-kit/langchain.mdx b/apps/site/content/docs/agent-kit/langchain.mdx
new file mode 100644
index 0000000..05b3e12
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/langchain.mdx
@@ -0,0 +1,26 @@
+---
+title: LangChain adapter
+description: "Returns LangChain StructuredToolInterface[] — drop into createReactAgent or any LangChain agent constructor."
+importLine: 'import { getLangChainTools } from "@cdr-kit/langchain"'
+breadcrumb: ["@cdr-kit", "Agent kit", "LangChain"]
+prev:
+  href: /docs/agent-kit/openai
+  label: OpenAI / Anthropic
+next:
+  href: /docs/agent-kit/agentkit
+  label: Coinbase AgentKit
+---
+
+## Usage
+
+<CodePanel title="langchain-agent.ts" code={`import { ChatOpenAI } from "@langchain/openai";
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+import { CdrAgent } from "@cdr-kit/agent";
+import { getLangChainTools } from "@cdr-kit/langchain";
+
+const cdr = new CdrAgent({ privateKey, apiUrl });
+const agent = createReactAgent({
+  llm: new ChatOpenAI({ model: "gpt-4o" }),
+  tools: getLangChainTools(cdr),
+});
+const res = await agent.invoke({ messages: [{ role: "user", content: "Read vault 4200." }] });`} />
diff --git a/apps/site/content/docs/agent-kit/mcp.mdx b/apps/site/content/docs/agent-kit/mcp.mdx
new file mode 100644
index 0000000..c7f10a1
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/mcp.mdx
@@ -0,0 +1,94 @@
+---
+title: MCP server
+description: "One stdio binary that plugs into Claude Desktop, Cursor, Windsurf, and any MCP host. Exposes the full CDR surface — discover, subscribe, access, audit, publish, plus 4 advanced-condition vault creators and 4 Story IP wrappers — as 21 tools backed by the agent's own auto-generated wallet."
+breadcrumb: ["@cdr-kit", "Agent kit", "MCP server"]
+prev:
+  href: /docs/agent-kit/goat
+  label: GOAT SDK
+next:
+  href: /docs/cli
+  label: "CLI: cdr"
+---
+
+## Install
+
+<CodePanel title="terminal" language="bash" code={`# Recommended: get the CLI (gives you cdr + cdr mcp + cdr skill install)
+$ npm install -g @cdr-kit/cli
+
+# Alternative: just the MCP wrapper (used by claude mcp add)
+$ npm install -g @cdr-kit/mcp`} />
+
+## Add to Claude Desktop (one command)
+
+<p>If you have Claude Code installed, the cleanest path is:</p>
+
+<CodePanel title="terminal" language="bash" code={`$ claude mcp add cdr-kit npx @cdr-kit/mcp`} />
+
+<p>This registers <code>npx @cdr-kit/mcp</code> as the <code>cdr-kit</code> server. The first run auto-generates a wallet at <code>~/.config/cdr-kit/wallet.json</code> (chmod 600) and prints the address + faucet URL to stderr. Fund it with <code>cdr fund</code> before calling write/subscribe tools.</p>
+
+## Manual config (Claude Desktop / Cursor / Windsurf)
+
+Paste this into your host's MCP config. Paths: Claude Desktop uses `~/Library/Application Support/Claude/claude_desktop_config.json`. Cursor uses `~/.cursor/mcp.json`. Windsurf uses `~/.codeium/windsurf/mcp_config.json`.
+
+<CodePanel title="mcp config" language="json" code={`{
+  "mcpServers": {
+    "cdr-kit": {
+      "command": "npx",
+      "args": ["-y", "@cdr-kit/mcp"],
+      "env": {
+        "CDR_PRIVATE_KEY": "0x_your_aeneid_testnet_key_here",
+        "CDR_NETWORK": "aeneid"
+      }
+    }
+  }
+}`} />
+
+<p><code>CDR_PRIVATE_KEY</code> is optional — if omitted, the wallet is auto-generated and loaded from disk on every run.</p>
+
+## Tools (13)
+
+<p>All tools come from a single source of truth in <code>@cdr-kit/tools</code>. Adapter packages (Vercel AI / OpenAI / LangChain / AgentKit / GOAT) iterate the same list, so every adapter gets all 13 automatically.</p>
+
+<table className="props">
+  <thead>
+    <tr><th>Tool</th><th>Group</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>cdr_discover_vaults</code></td><td>Discover + read</td><td>Scan recent VaultCreated events; returns uuid, ipId, creator per vault.</td></tr>
+    <tr><td><code>cdr_subscribe_and_access</code></td><td>Discover + read</td><td>Pay the subscription, then read + decrypt — one composite call.</td></tr>
+    <tr><td><code>cdr_access_vault</code></td><td>Discover + read</td><td>Read + decrypt a vault the agent is already entitled to.</td></tr>
+    <tr><td><code>cdr_access_license_gated</code></td><td>Discover + read</td><td>Read a license-gated vault by presenting a Story license token the agent owns.</td></tr>
+    <tr><td><code>cdr_get_vault_info</code></td><td>Introspection</td><td>Resolve uuid → tokenId, ipId, creator, licenseTermsId. View-only.</td></tr>
+    <tr><td><code>cdr_creator_vaults</code></td><td>Introspection</td><td>List every vault a given creator has minted. View-only.</td></tr>
+    <tr><td><code>cdr_check_entitlement</code></td><td>Introspection</td><td>Is the agent (or any address) currently subscribed? Returns paidUntil + isEntitled. View-only.</td></tr>
+    <tr><td><code>cdr_estimate_cost</code></td><td>Introspection</td><td>Subscription plan: pricePerPeriod, period, payee, mode. View-only.</td></tr>
+    <tr><td><code>cdr_list_subscriptions</code></td><td>Introspection</td><td>Every vault the agent is currently subscribed to (active paidUntil).</td></tr>
+    <tr><td><code>cdr_get_fees</code></td><td>Introspection</td><td>CDR allocate / write / read fees + operational threshold. View-only, no wallet needed.</td></tr>
+    <tr><td><code>cdr_create_vault</code></td><td>Author / publish</td><td>Mint NFT + register IP + allocate slot + configure read condition — one tx.</td></tr>
+    <tr><td><code>cdr_write_vault_data</code></td><td>Author / publish</td><td>Encrypt a small (&lt;1KB) UTF-8 string and write it to a vault.</td></tr>
+    <tr><td><code>cdr_upload_file</code></td><td>Author / publish</td><td>Encrypt + IPFS-pin + allocate + write — for any &gt;1KB payload.</td></tr>
+    <tr><td><code>cdr_create_time_window_vault</code></td><td>Advanced conditions (0.5)</td><td>Create a Story CDR vault gated by an absolute time (or block) window.</td></tr>
+    <tr><td><code>cdr_create_dead_man_vault</code></td><td>Advanced conditions (0.5)</td><td>Create a dead-man-switch vault — auto-unlocks to heirs if the creator stops poke()-ing.</td></tr>
+    <tr><td><code>cdr_create_escrow_vault</code></td><td>Advanced conditions (0.5)</td><td>Create a buyer-pays-then-confirms-delivery escrow vault with optional arbiter.</td></tr>
+    <tr><td><code>cdr_create_multi_sig_vault</code></td><td>Advanced conditions (0.5)</td><td>Create an N-of-M multi-sig vault — both off-chain EIP-712 sigs AND on-chain approve() paths supported. First-of-kind in the CDR ecosystem.</td></tr>
+    <tr><td><code>cdr_approve_multi_sig</code></td><td>Advanced conditions (0.5)</td><td>Safe-style on-chain approval — agent calls approve(uuid). Dashboards read currentApprovalsCount(uuid).</td></tr>
+    <tr><td><code>cdr_register_ip</code></td><td>Story IP (0.5)</td><td>Register an NFT as a Story IP asset (fresh-mint via SPG).</td></tr>
+    <tr><td><code>cdr_attach_license_terms</code></td><td>Story IP (0.5)</td><td>Attach PIL license terms to a Story IP asset (required before minting license tokens).</td></tr>
+    <tr><td><code>cdr_mint_license_token</code></td><td>Story IP (0.5)</td><td>Mint Story license tokens against an IP asset's licenseTermsId.</td></tr>
+    <tr><td><code>cdr_publish_data</code></td><td>Story IP (0.5)</td><td>Agent-as-publisher one-shot: register IP + attach commercial terms + create license-gated CDR vault + write encrypted secret. The highest-DX win for autonomous data sellers.</td></tr>
+  </tbody>
+</table>
+
+## Env reference
+
+<table className="props">
+  <thead><tr><th>Var</th><th>Default</th><th>Purpose</th></tr></thead>
+  <tbody>
+    <tr><td><code>CDR_PRIVATE_KEY</code></td><td>(auto-generated)</td><td>Agent's wallet. Overrides the disk file at <code>~/.config/cdr-kit/wallet.json</code>.</td></tr>
+    <tr><td><code>CDR_NETWORK</code></td><td>aeneid</td><td>aeneid (default) or mainnet (throws — not yet deployed).</td></tr>
+    <tr><td><code>CDR_RPC_URL</code></td><td>network's canonical RPC</td><td>Override the JSON-RPC endpoint (use a paid RPC for production).</td></tr>
+    <tr><td><code>CDR_API_URL</code></td><td>network's canonical Story-API REST</td><td>Override the Story-API base URL.</td></tr>
+    <tr><td><code>LOG_LEVEL</code></td><td>info</td><td>pino level: trace, debug, info, warn, error.</td></tr>
+    <tr><td><code>PRIVATE_KEY</code></td><td>(deprecated)</td><td>Old name for <code>CDR_PRIVATE_KEY</code>. Still honored in 0.4 with a deprecation warning; removed in 0.5.</td></tr>
+  </tbody>
+</table>
diff --git a/apps/site/content/docs/agent-kit/openai.mdx b/apps/site/content/docs/agent-kit/openai.mdx
new file mode 100644
index 0000000..e8fc5f5
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/openai.mdx
@@ -0,0 +1,29 @@
+---
+title: OpenAI / Anthropic adapter
+description: "JSON-Schema tools[] + a dispatch router for OpenAI Chat Completions / Anthropic Messages. Works with either provider."
+importLine: 'import { getOpenAITools } from "@cdr-kit/openai"'
+breadcrumb: ["@cdr-kit", "Agent kit", "OpenAI / Anthropic"]
+prev:
+  href: /docs/agent-kit/vercel-ai
+  label: Vercel AI SDK
+next:
+  href: /docs/agent-kit/langchain
+  label: LangChain
+---
+
+## Usage
+
+<CodePanel title="openai-agent.ts" code={`import OpenAI from "openai";
+import { CdrAgent } from "@cdr-kit/agent";
+import { getOpenAITools } from "@cdr-kit/openai";
+
+const agent = new CdrAgent({ privateKey, apiUrl });
+const { tools, dispatch } = getOpenAITools(agent);
+
+const openai = new OpenAI();
+const res = await openai.chat.completions.create({
+  model: "gpt-4o",
+  tools, // JSON-schema tool definitions
+  messages: [{ role: "user", content: "Find and read vault 4200." }],
+});
+// route tool calls back through dispatch(name, args)`} />
diff --git a/apps/site/content/docs/agent-kit/vercel-ai.mdx b/apps/site/content/docs/agent-kit/vercel-ai.mdx
new file mode 100644
index 0000000..f41db4c
--- /dev/null
+++ b/apps/site/content/docs/agent-kit/vercel-ai.mdx
@@ -0,0 +1,28 @@
+---
+title: Vercel AI SDK adapter
+description: "Returns a ToolSet for generateText / streamText. The model autonomously picks the three CDR tools and drives the loop."
+importLine: 'import { getVercelAITools } from "@cdr-kit/vercel-ai"'
+breadcrumb: ["@cdr-kit", "Agent kit", "Vercel AI SDK"]
+prev:
+  href: /docs/agent-kit
+  label: CdrAgent
+next:
+  href: /docs/agent-kit/openai
+  label: OpenAI / Anthropic
+---
+
+## Usage
+
+<CodePanel title="agent.ts" code={`import { generateText, stepCountIs } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+import { CdrAgent } from "@cdr-kit/agent";
+import { getVercelAITools } from "@cdr-kit/vercel-ai";
+
+const agent = new CdrAgent({ privateKey, apiUrl });
+
+const { text } = await generateText({
+  model: anthropic("claude-sonnet-4-6"),
+  tools: getVercelAITools(agent),
+  stopWhen: stepCountIs(8),
+  prompt: "Find a CDR vault, subscribe if needed, and tell me the signal.",
+});`} />
diff --git a/apps/site/content/docs/cli.mdx b/apps/site/content/docs/cli.mdx
new file mode 100644
index 0000000..641f194
--- /dev/null
+++ b/apps/site/content/docs/cli.mdx
@@ -0,0 +1,79 @@
+---
+title: cdr command
+description: One binary, three surfaces. cdr ships every cdr-kit operation as a CLI command (25 commands), cdr mcp starts the stdio MCP server, cdr skill install drops the Claude Code plugin. Auto-creates the agent's wallet on first run.
+breadcrumb: ["@cdr-kit", "CLI"]
+prev:
+  href: /docs/agent-kit/mcp
+  label: MCP server
+next:
+  href: /docs/skill
+  label: Claude Code plugin
+---
+
+## Install
+
+<CodePanel title="terminal" language="bash" code={`$ npm install -g @cdr-kit/cli
+$ cdr --help`} />
+
+## First run
+
+<CodePanel title="terminal" language="bash" code={`$ cdr wallet
+# first run prints a banner with the auto-generated address + faucet URL → stderr
+# subsequent runs return the wallet state as JSON / pretty-printed object`} />
+
+<p>The wallet is generated by viem's <code>generatePrivateKey()</code>, stored at <code>~/.config/cdr-kit/wallet.json</code> (resolved cross-platform via <code>env-paths</code>), and written with <code>chmod 600</code>. Override anytime with <code>CDR_PRIVATE_KEY=0x...</code>.</p>
+
+## Commands
+
+<table className="props">
+  <thead><tr><th>Command</th><th>Description</th></tr></thead>
+  <tbody>
+    <tr><td><code>cdr mcp</code></td><td>Start the stdio MCP server. Same surface @cdr-kit/mcp exposes.</td></tr>
+    <tr><td><code>cdr wallet [--json]</code></td><td>Show address, network, balance, wallet path (doctor command).</td></tr>
+    <tr><td><code>cdr wallet new [--force]</code></td><td>Force-generate a new wallet (refuses to overwrite without --force).</td></tr>
+    <tr><td><code>cdr wallet export --yes</code></td><td>Print the private key (DANGEROUS — requires --yes to confirm).</td></tr>
+    <tr><td><code>cdr fund</code></td><td>Print address + open the Aeneid faucet in your browser (captcha-gated).</td></tr>
+    <tr><td><code>cdr config</code></td><td>Print resolved network / RPC / API URL / wallet path.</td></tr>
+    <tr><td><code>cdr fees</code></td><td>Allocate / write / read fees + operational threshold (view-only).</td></tr>
+    <tr><td><code>cdr discover [--from-block N]</code></td><td>Scan factory VaultCreated events.</td></tr>
+    <tr><td><code>cdr vault info &lt;uuid&gt;</code></td><td>Vault info + plan + your entitlement, in one call.</td></tr>
+    <tr><td><code>cdr vault list --creator &lt;addr&gt;</code></td><td>Every vault a creator has minted.</td></tr>
+    <tr><td><code>cdr vault create --read &lt;addr&gt; --read-config &lt;hex&gt; [--license-terms-id N]</code></td><td>Create + configure + allocate — one tx.</td></tr>
+    <tr><td><code>cdr subscribe &lt;uuid&gt; [--periods N] [--max-price wei]</code></td><td>Subscribe to + read a subscription-gated vault.</td></tr>
+    <tr><td><code>cdr access &lt;uuid&gt; [--aux-data hex]</code></td><td>Read a vault you're already entitled to.</td></tr>
+    <tr><td><code>cdr access-license &lt;uuid&gt; --license-token-id N</code></td><td>Read a license-gated vault by presenting a Story license token.</td></tr>
+    <tr><td><code>cdr subscriptions</code></td><td>Every vault the agent is currently subscribed to.</td></tr>
+    <tr><td><code>cdr tools</code></td><td>Enumerate all 34 MCP tools (introspection).</td></tr>
+    <tr><td><code>cdr skill install</code></td><td>Install the cdr-kit Claude Code plugin into ~/.claude/skills/cdr-kit/.</td></tr>
+    <tr><td><code>cdr create time-window --start &lt;ts&gt; --end &lt;ts&gt; [--block-based]</code></td><td>Create a TimeWindowCondition vault — read allowed only during [startTs, endTs].</td></tr>
+    <tr><td><code>cdr create dead-man --duration &lt;s&gt; --heirs &lt;list&gt; [--public-after]</code></td><td>Create a DeadManSwitchCondition vault — auto-unlocks to heirs after the heartbeat lapses.</td></tr>
+    <tr><td><code>cdr create escrow --price &lt;wei&gt; --timeout &lt;s&gt; [--arbiter &lt;addr&gt;]</code></td><td>Create a ConditionalEscrowCondition vault — buyer pays, confirms, then reads.</td></tr>
+    <tr><td><code>cdr create multi-sig --signers &lt;list&gt; --threshold &lt;n&gt;</code></td><td>Create an N-of-M MultiSigCondition vault (off-chain sigs OR on-chain approve).</td></tr>
+    <tr><td><code>cdr poke &lt;uuid&gt;</code></td><td>Reset the dead-man-switch heartbeat for a vault you created.</td></tr>
+    <tr><td><code>cdr multi-sig approve &lt;uuid&gt;</code></td><td>On-chain Safe-style approval — agent must be a configured signer.</td></tr>
+    <tr><td><code>cdr multi-sig sign &lt;uuid&gt; --caller &lt;addr&gt; --deadline &lt;ts&gt;</code></td><td>Produce an off-chain EIP-712 sig for collecting threshold-many off-band.</td></tr>
+    <tr><td><code>cdr multi-sig access &lt;uuid&gt; --deadline &lt;ts&gt; --sigs &lt;list&gt;</code></td><td>Read a multi-sig vault by submitting collected off-chain sigs.</td></tr>
+    <tr><td><code>cdr multi-sig rotate &lt;uuid&gt; --signers &lt;list&gt; --threshold &lt;n&gt;</code></td><td>Creator-only signer rotation; bumps epoch (invalidates BOTH paths).</td></tr>
+    <tr><td><code>cdr escrow pay &lt;uuid&gt; --price &lt;wei&gt;</code></td><td>Buyer step 1 — escrow the listing price (excess refunded same tx).</td></tr>
+    <tr><td><code>cdr escrow confirm &lt;uuid&gt;</code></td><td>Buyer step 2 — confirm delivery, releases funds + grants read.</td></tr>
+    <tr><td><code>cdr escrow claim-timeout &lt;uuid&gt; --buyer &lt;addr&gt;</code></td><td>Seller — claim funds + grant buyer read after timeoutSecs of silence.</td></tr>
+    <tr><td><code>cdr escrow arbiter-refund &lt;uuid&gt; --buyer &lt;addr&gt;</code></td><td>Arbiter — refund a buyer who paid but disputes delivery.</td></tr>
+    <tr><td><code>cdr ip register --spg &lt;addr&gt; [--metadata &lt;uri&gt;]</code></td><td>Register a freshly-minted SPG NFT as a Story IP asset.</td></tr>
+    <tr><td><code>cdr ip attach-terms --ip &lt;addr&gt; --terms-id &lt;id&gt;</code></td><td>Attach existing PIL license terms to an IP.</td></tr>
+    <tr><td><code>cdr ip mint-license --licensor &lt;addr&gt; --terms-id &lt;id&gt; [--amount N]</code></td><td>Mint Story license tokens against an IP's licenseTermsId.</td></tr>
+    <tr><td><code>cdr ip register-derivative --child &lt;addr&gt; --parents &lt;list&gt; --terms-ids &lt;list&gt;</code></td><td>Register a derivative IP — child inherits parents' PIL terms.</td></tr>
+    <tr><td><code>cdr ip wrap-ip --amount &lt;wei&gt;</code></td><td>Wrap native IP into WIP (required before paying royalties).</td></tr>
+    <tr><td><code>cdr ip approve-wip --spender &lt;addr&gt; --amount &lt;wei&gt;</code></td><td>Approve a spender (typically RoyaltyModule) to pull WIP.</td></tr>
+  </tbody>
+</table>
+
+## Global flags
+
+<CodePanel title="terminal" language="bash" code={`--network aeneid|mainnet   # default aeneid; mainnet throws (not yet deployed)
+--json                     # machine-readable JSON output for any command`} />
+
+## Use as MCP server
+
+<p><code>cdr mcp</code> is the same stdio server <code>@cdr-kit/mcp</code> ships. Either binary works for MCP host configs — most prefer <code>npx @cdr-kit/mcp</code> for zero install footprint.</p>
+
+<CodePanel title="terminal" language="bash" code={`$ claude mcp add cdr-kit npx @cdr-kit/mcp`} />
diff --git a/apps/site/content/docs/components/access-stepper.mdx b/apps/site/content/docs/components/access-stepper.mdx
new file mode 100644
index 0000000..7775200
--- /dev/null
+++ b/apps/site/content/docs/components/access-stepper.mdx
@@ -0,0 +1,30 @@
+---
+title: "<AccessStepper>"
+description: "Designed wait-state UI for the 2-step pay→access flow. Derives step state from useAccessVault's status + an optional {collected, threshold} for the determinate partial-collection bar."
+importLine: 'import { AccessStepper } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "Components", "AccessStepper"]
+prev:
+  href: /docs/components/condition-badge
+  label: ConditionBadge
+next:
+  href: /docs/components/subscribe-button
+  label: SubscribeButton
+---
+
+## Live preview
+
+<Demo preview={<AccessStepperDemo />} code={`import { AccessStepper } from "@cdr-kit/react-ui";
+import { useAccessVault } from "@cdr-kit/react";
+
+function Stepper({ uuid }) {
+  const { status, progress } = useAccessVault(uuid);
+  return <AccessStepper status={status} progress={progress} withPay />;
+}`} badge={<Badge>phase selector</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "status", type: '"idle" | "paying" | "collecting-partials" | "ready" | "error"', required: true, description: "Drives which step is active / done / errored." },
+  { name: "progress", type: "{ collected: number; threshold: number }", description: "When provided, drives the determinate partials bar in the collecting step." },
+  { name: "withPay", type: "boolean", defaultValue: "true", description: "Include the leading Subscribe & pay step (for subscription-gated vaults)." },
+]} />
diff --git a/apps/site/content/docs/components/cdr-error.mdx b/apps/site/content/docs/components/cdr-error.mdx
new file mode 100644
index 0000000..bd39661
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-error.mdx
@@ -0,0 +1,31 @@
+---
+title: "<CdrError>"
+description: Soft-bordered danger state with an optional retry CTA. Pair with caught errors from useAccessVault or useSubscribeAndAccess.
+importLine: 'import { CdrError } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrError"]
+prev:
+  href: /docs/components/cdr-progress
+  label: CdrProgress
+next:
+  href: /docs/agent-kit
+  label: Agent kit
+---
+
+## Live preview
+
+<Demo preview={<CdrErrorDemo />} code={`import { CdrError } from "@cdr-kit/react-ui";
+
+<CdrError
+  title="Read timed out"
+  message="Threshold not met in time."
+  onRetry={() => refetch()}
+/>`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "title", type: "ReactNode", required: true, description: "Bold first line — the error title." },
+  { name: "message", type: "ReactNode", description: "Optional detail line below the title." },
+  { name: "onRetry", type: "() => void", description: "When set, renders the retry button on the right." },
+  { name: "retryLabel", type: "string", defaultValue: '"Retry"', description: "Retry button label." },
+]} />
diff --git a/apps/site/content/docs/components/cdr-inspector.mdx b/apps/site/content/docs/components/cdr-inspector.mdx
new file mode 100644
index 0000000..04136f1
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-inspector.mdx
@@ -0,0 +1,25 @@
+---
+title: "<CdrInspector>"
+description: "Drop-in debug strip showing how the kit is wired (mock vs live, WASM ready, API URL). Keep it in dev builds; remove or guard for production."
+importLine: 'import { CdrInspector } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "CdrInspector"]
+prev:
+  href: /docs/components/vault
+  label: Vault compound
+next:
+  href: /docs/components/cdr-skeleton
+  label: CdrSkeleton
+---
+
+## Live preview
+
+<Demo preview={<CdrInspectorDemo />} code={`import { CdrInspector } from "@cdr-kit/react";
+
+export function App() {
+  return (
+    <CdrProvider mockKit={createMockCdrKit()}>
+      {process.env.NODE_ENV !== "production" && <CdrInspector />}
+      {/* …rest of app */}
+    </CdrProvider>
+  );
+}`} />
diff --git a/apps/site/content/docs/components/cdr-network-chip.mdx b/apps/site/content/docs/components/cdr-network-chip.mdx
new file mode 100644
index 0000000..f77fd06
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-network-chip.mdx
@@ -0,0 +1,28 @@
+---
+title: "<CdrNetworkChip>"
+description: "Pill with a glowing status dot indicating live vs mock mode. Drop into your app chrome so users always know whether they're hitting Aeneid or the in-memory mock."
+importLine: 'import { CdrNetworkChip } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrNetworkChip"]
+prev:
+  href: /docs/components/ip-price
+  label: IpPrice
+next:
+  href: /docs/components/cdr-spinner
+  label: CdrSpinner
+---
+
+import { CdrNetworkChip } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<div style={{ display: "flex", flexWrap: "wrap", gap: 10, alignItems: "center" }}><CdrNetworkChip mode="live" /><CdrNetworkChip mode="mock" /></div>} code={`import { CdrNetworkChip } from "@cdr-kit/react-ui";
+
+<CdrNetworkChip mode="live" />
+<CdrNetworkChip mode="mock" />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "mode", type: '"live" | "mock"', required: true, description: "Drives the dot color and glow (signal vs warn)." },
+  { name: "network", type: "string", defaultValue: '"Aeneid"', description: "Network label rendered next to the status." },
+]} />
diff --git a/apps/site/content/docs/components/cdr-progress.mdx b/apps/site/content/docs/components/cdr-progress.mdx
new file mode 100644
index 0000000..7a4b9bd
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-progress.mdx
@@ -0,0 +1,29 @@
+---
+title: "<CdrProgress>"
+description: "Determinate progress bar with a primary→signal gradient fill. Pass a value 0–100, or pass {collected, threshold} and the component derives it."
+importLine: 'import { CdrProgress } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrProgress"]
+prev:
+  href: /docs/components/cdr-spinner
+  label: CdrSpinner
+next:
+  href: /docs/components/cdr-error
+  label: CdrError
+---
+
+import { CdrProgress } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<div style={{ display: "flex", flexDirection: "column", gap: 12, width: "100%", maxWidth: 320 }}><CdrProgress value={64} /><CdrProgress collected={6} threshold={10} /></div>} code={`import { CdrProgress } from "@cdr-kit/react-ui";
+
+<CdrProgress value={64} />
+<CdrProgress collected={6} threshold={10} />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "value", type: "number", description: "0–100 percentage. Takes precedence over collected/threshold." },
+  { name: "collected", type: "number", description: "Numerator — used when value isn't provided." },
+  { name: "threshold", type: "number", description: "Denominator — used when value isn't provided." },
+]} />
diff --git a/apps/site/content/docs/components/cdr-provider.mdx b/apps/site/content/docs/components/cdr-provider.mdx
new file mode 100644
index 0000000..14f78ca
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-provider.mdx
@@ -0,0 +1,22 @@
+---
+title: CdrProvider
+description: "Batteries-included root provider. Wires WagmiProvider, react-query, and initializes the CDR crypto WASM. Use CdrConfigProvider directly if you already have your own wagmi stack (Privy / RainbowKit)."
+importLine: 'import { CdrProvider } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "CdrProvider"]
+prev:
+  href: /docs/theming
+  label: Theming
+next:
+  href: /docs/components/vault-gate
+  label: VaultGate
+---
+
+## Props
+
+<PropsTable rows={[
+  { name: "apiUrl", type: "string", required: true, description: "Story-API REST base — keeper endpoint for partial collection." },
+  { name: "mockKit", type: "MockCdrKit", description: "Pass createMockCdrKit() for offline dev. When set, no chain/wallet is touched." },
+  { name: "config", type: "Config (wagmi)", description: "Optional wagmi config. A minimal default with an injected connector ships if omitted." },
+  { name: "queryClient", type: "QueryClient", description: "Optional TanStack Query client." },
+  { name: "appearance", type: "CdrAppearance", description: "CSS custom properties applied to the cdr-kit root (see Theming)." },
+]} />
diff --git a/apps/site/content/docs/components/cdr-skeleton.mdx b/apps/site/content/docs/components/cdr-skeleton.mdx
new file mode 100644
index 0000000..0e8540d
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-skeleton.mdx
@@ -0,0 +1,25 @@
+---
+title: "<CdrSkeleton>"
+description: "Default placeholder rendered by <VaultGate> / <Vault.Loading> when no custom loading slot is supplied. Themeable via --cdr-skeleton."
+importLine: 'import { CdrSkeleton } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "CdrSkeleton"]
+prev:
+  href: /docs/components/cdr-inspector
+  label: CdrInspector
+next:
+  href: /docs/components/empty-vaults
+  label: EmptyVaults
+---
+
+## Live preview
+
+<Demo preview={<CdrSkeletonDemo />} code={`import { CdrSkeleton } from "@cdr-kit/react";
+
+<CdrSkeleton />
+<CdrSkeleton lines={5} />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "lines", type: "number", defaultValue: "3", description: "Number of bar rows to render." },
+]} />
diff --git a/apps/site/content/docs/components/cdr-spinner.mdx b/apps/site/content/docs/components/cdr-spinner.mdx
new file mode 100644
index 0000000..8e8a9c5
--- /dev/null
+++ b/apps/site/content/docs/components/cdr-spinner.mdx
@@ -0,0 +1,27 @@
+---
+title: "<CdrSpinner>"
+description: "Indeterminate CSS spinner. Use when you don't have a determinate progress to show (e.g. wallet confirmation)."
+importLine: 'import { CdrSpinner } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CdrSpinner"]
+prev:
+  href: /docs/components/cdr-network-chip
+  label: CdrNetworkChip
+next:
+  href: /docs/components/cdr-progress
+  label: CdrProgress
+---
+
+import { CdrSpinner } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<div style={{ display: "flex", gap: 18, alignItems: "center" }}><CdrSpinner /><CdrSpinner size={24} /></div>} code={`import { CdrSpinner } from "@cdr-kit/react-ui";
+
+<CdrSpinner />
+<CdrSpinner size={24} />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "size", type: "number", defaultValue: "18", description: "Pixel size of the square spinner box." },
+]} />
diff --git a/apps/site/content/docs/components/condition-badge.mdx b/apps/site/content/docs/components/condition-badge.mdx
new file mode 100644
index 0000000..958a08d
--- /dev/null
+++ b/apps/site/content/docs/components/condition-badge.mdx
@@ -0,0 +1,30 @@
+---
+title: "<ConditionBadge>"
+description: "Color-mapped pill for a vault's read-condition kind. Pure presentational, zero app logic."
+importLine: 'import { ConditionBadge } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "Components", "ConditionBadge"]
+prev:
+  href: /docs/components/empty-vaults
+  label: EmptyVaults
+next:
+  href: /docs/components/access-stepper
+  label: AccessStepper
+---
+
+import { ConditionBadge } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<div style={{ display: "flex", flexWrap: "wrap", gap: 10, alignItems: "center" }}><ConditionBadge kind="subscription" /><ConditionBadge kind="tiergate" /><ConditionBadge kind="composable" /><ConditionBadge kind="open" /></div>} code={`import { ConditionBadge } from "@cdr-kit/react-ui";
+
+<ConditionBadge kind="subscription" />
+<ConditionBadge kind="tiergate" />
+<ConditionBadge kind="composable" />
+<ConditionBadge kind="open" />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "kind", type: '"subscription" | "tiergate" | "composable" | "open"', required: true, description: "Determines the color (primary / warn / signal / neutral) and the default label." },
+  { name: "children", type: "ReactNode", description: "Optional label override. Defaults to a human-readable kind name." },
+]} />
diff --git a/apps/site/content/docs/components/copy-button.mdx b/apps/site/content/docs/components/copy-button.mdx
new file mode 100644
index 0000000..f1937a4
--- /dev/null
+++ b/apps/site/content/docs/components/copy-button.mdx
@@ -0,0 +1,28 @@
+---
+title: "<CopyButton>"
+description: "Minimal copy-to-clipboard control. Flashes a check icon for 1.4s on success. Composes inside other primitives (e.g. <ShortAddress>)."
+importLine: 'import { CopyButton } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "CopyButton"]
+prev:
+  href: /docs/components/vault-card
+  label: VaultCard
+next:
+  href: /docs/components/short-address
+  label: ShortAddress
+---
+
+import { CopyButton as UiCopyButton } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<span className="cdr-ui-addr-chip" data-cdr-ui="">sample value<UiCopyButton value="sample value" /></span>} code={`import { CopyButton } from "@cdr-kit/react-ui";
+
+<CopyButton value="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "value", type: "string", required: true, description: "Text written to the clipboard on click." },
+  { name: "label", type: "string", defaultValue: '"copy"', description: "ARIA label for the button." },
+  { name: "className", type: "string", description: "Custom class — defaults to none; style via the wrapping chip." },
+]} />
diff --git a/apps/site/content/docs/components/empty-vaults.mdx b/apps/site/content/docs/components/empty-vaults.mdx
new file mode 100644
index 0000000..4cb418a
--- /dev/null
+++ b/apps/site/content/docs/components/empty-vaults.mdx
@@ -0,0 +1,24 @@
+---
+title: "<EmptyVaults>"
+description: "Semantic empty-state slot — a div[data-cdr-empty] with a default copy fallback. Style at the consumer level."
+importLine: 'import { EmptyVaults } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "EmptyVaults"]
+prev:
+  href: /docs/components/cdr-skeleton
+  label: CdrSkeleton
+next:
+  href: /docs/components/condition-badge
+  label: ConditionBadge
+---
+
+## Live preview
+
+<Demo preview={<EmptyVaultsDemo />} code={`import { EmptyVaults } from "@cdr-kit/react";
+
+<EmptyVaults />
+<EmptyVaults>No vaults match your filter.</EmptyVaults>
+
+// typical use:
+{vaults.length === 0
+  ? <EmptyVaults>No vaults match your filter.</EmptyVaults>
+  : <VaultGrid vaults={vaults} />}`} />
diff --git a/apps/site/content/docs/components/escrow-delivery-confirm.mdx b/apps/site/content/docs/components/escrow-delivery-confirm.mdx
new file mode 100644
index 0000000..5a02026
--- /dev/null
+++ b/apps/site/content/docs/components/escrow-delivery-confirm.mdx
@@ -0,0 +1,41 @@
+---
+title: "<EscrowDeliveryConfirm>"
+description: "Buyer-side flow for ConditionalEscrowCondition: pay → confirm delivery → seller paid + buyer reads. Surfaces the timeout countdown after which the seller can claim unilaterally."
+importLine: 'import { EscrowDeliveryConfirm } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "EscrowDeliveryConfirm"]
+prev:
+  href: /docs/components/multi-sig-signer
+  label: MultiSigSigner
+next:
+  href: /docs/components/condition-badge
+  label: ConditionBadge
+---
+
+## Live preview
+
+<Demo preview={<EscrowDeliveryConfirmDemo />} code={`import { EscrowDeliveryConfirm } from "@cdr-kit/react";
+
+<EscrowDeliveryConfirm uuid={8812} buyer={connectedAddress} />
+
+// Render-prop for the dashboard:
+<EscrowDeliveryConfirm uuid={8812} buyer={connectedAddress}>
+  {({ paid, delivered, timeoutInMs, confirmDelivery, pay }) => (
+    paid === 0n
+      ? <button onClick={() => pay()}>Pay listing price</button>
+      : delivered
+        ? <span>delivered ✓</span>
+        : <button onClick={() => confirmDelivery()}>Confirm delivery</button>
+  )}
+</EscrowDeliveryConfirm>`} badge={<Badge>mock</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "ConditionalEscrowCondition-gated vault uuid." },
+  { name: "buyer", type: "Hex | undefined", description: "Address whose paidAt/delivered state to read. Usually the connected wallet." },
+  { name: "children", type: "(state) => ReactNode", description: "Render-prop. Receives the full EscrowState including seller, price, timeoutSecs, arbiter, paidAt, delivered, timeoutInMs, plus pay() and confirmDelivery() actions." },
+]} />
+
+## Intrinsic CDR limitation
+
+<p>Once a buyer pays + confirms + reads, they hold plaintext forever. The dispute path (arbiter refund) can revoke future access but cannot "un-read." Document this in your buyer UX.</p>
diff --git a/apps/site/content/docs/components/explorer-link.mdx b/apps/site/content/docs/components/explorer-link.mdx
new file mode 100644
index 0000000..3c1080d
--- /dev/null
+++ b/apps/site/content/docs/components/explorer-link.mdx
@@ -0,0 +1,29 @@
+---
+title: "<ExplorerLink>"
+description: 'Mono primary-colored link with an external-link icon. Opens in a new tab with rel="noopener noreferrer".'
+importLine: 'import { ExplorerLink } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "ExplorerLink"]
+prev:
+  href: /docs/components/short-address
+  label: ShortAddress
+next:
+  href: /docs/components/ip-price
+  label: IpPrice
+---
+
+import { ExplorerLink } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<ExplorerLink href="https://aeneid.storyrpc.io/address/0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C">view on Aeneid</ExplorerLink>} code={`import { ExplorerLink } from "@cdr-kit/react-ui";
+
+<ExplorerLink href="https://aeneid.storyrpc.io/address/0xac592f…">
+  view on Aeneid
+</ExplorerLink>`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "href", type: "string", required: true, description: "Target URL (typically a block-explorer address / tx page)." },
+  { name: "children", type: "ReactNode", defaultValue: '"view"', description: "Link label." },
+]} />
diff --git a/apps/site/content/docs/components/heartbeat-timer.mdx b/apps/site/content/docs/components/heartbeat-timer.mdx
new file mode 100644
index 0000000..2f23dba
--- /dev/null
+++ b/apps/site/content/docs/components/heartbeat-timer.mdx
@@ -0,0 +1,40 @@
+---
+title: "<HeartbeatTimer>"
+description: "Countdown to DeadManSwitchCondition.unlockAt with a creator-side poke() button. Flips into critical mode once < 25% of the window remains, so the UI can prompt the creator before silence becomes irreversible."
+importLine: 'import { HeartbeatTimer } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "HeartbeatTimer"]
+prev:
+  href: /docs/components/empty-vaults
+  label: EmptyVaults
+next:
+  href: /docs/components/time-window-badge
+  label: TimeWindowBadge
+---
+
+## Live preview
+
+<Demo preview={<HeartbeatTimerDemo />} code={`import { HeartbeatTimer, useDeadManTimer } from "@cdr-kit/react";
+
+// Default headless render — countdown + extend button:
+<HeartbeatTimer uuid={4242} />
+
+// Custom render — full control via render-prop:
+<HeartbeatTimer uuid={4242}>
+  {({ remainingMs, isCritical, isUnlocked, poke }) => (
+    <div className={isCritical ? "warn" : ""}>
+      {isUnlocked ? "unlocked" : \`unlocks in \${remainingMs / 1000}s\`}
+      <button onClick={() => poke()}>extend now</button>
+    </div>
+  )}
+</HeartbeatTimer>`} badge={<Badge>mock</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "DeadManSwitchCondition-gated vault uuid." },
+  { name: "children", type: "(state: DeadManTimer) => ReactNode", description: "Optional render-prop. Receives { unlocksAt, duration, remainingMs, isUnlocked, isCritical, poke, isLoading }." },
+]} />
+
+## Hook variant
+
+<p>Skip the component and consume <code>useDeadManTimer(uuid)</code> directly. Returns the same state object the render-prop receives.</p>
diff --git a/apps/site/content/docs/components/index.mdx b/apps/site/content/docs/components/index.mdx
new file mode 100644
index 0000000..e77635d
--- /dev/null
+++ b/apps/site/content/docs/components/index.mdx
@@ -0,0 +1,7 @@
+---
+title: Components
+description: Every component the kit ships, in one place. Headless render-prop slots from @cdr-kit/react on top — bring your own visuals. Styled, batteries-included variants from @cdr-kit/react-ui below.
+breadcrumb: ["@cdr-kit", "Components"]
+---
+
+<ComponentsGalleryDemo />
diff --git a/apps/site/content/docs/components/ip-price.mdx b/apps/site/content/docs/components/ip-price.mdx
new file mode 100644
index 0000000..877ffd2
--- /dev/null
+++ b/apps/site/content/docs/components/ip-price.mdx
@@ -0,0 +1,29 @@
+---
+title: "<IpPrice>"
+description: 'Formats wei as n IP with an optional period suffix. Pass null for license-gated vaults — renders the standard alt label.'
+importLine: 'import { IpPrice } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "IpPrice"]
+prev:
+  href: /docs/components/explorer-link
+  label: ExplorerLink
+next:
+  href: /docs/components/cdr-network-chip
+  label: CdrNetworkChip
+---
+
+import { IpPrice } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<div style={{ display: "flex", flexWrap: "wrap", gap: 18, alignItems: "center" }}><IpPrice wei={5n * 10n ** 18n} period="/ 30d" /><IpPrice wei={null} /></div>} code={`import { IpPrice } from "@cdr-kit/react-ui";
+
+<IpPrice wei={5n * 10n ** 18n} period="/ 30d" />
+<IpPrice wei={null} />            {/* "License-gated" */}`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "wei", type: "bigint | null", required: true, description: 'Price in wei. null renders "License-gated".' },
+  { name: "period", type: "string", description: 'Suffix appended after the IP value (e.g. "/ 30d").' },
+  { name: "decimals", type: "number", defaultValue: "4", description: "Max significant decimal digits in the formatted output." },
+]} />
diff --git a/apps/site/content/docs/components/multi-sig-approval-tracker.mdx b/apps/site/content/docs/components/multi-sig-approval-tracker.mdx
new file mode 100644
index 0000000..4415546
--- /dev/null
+++ b/apps/site/content/docs/components/multi-sig-approval-tracker.mdx
@@ -0,0 +1,35 @@
+---
+title: "<MultiSigApprovalTracker>"
+description: "X of Y approved + epoch — the read-side dashboard for MultiSigCondition. Combines the on-chain signer set with the off-chain set of collected sigs to render approval progress."
+importLine: 'import { MultiSigApprovalTracker } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "MultiSigApprovalTracker"]
+prev:
+  href: /docs/components/time-window-badge
+  label: TimeWindowBadge
+next:
+  href: /docs/components/multi-sig-signer
+  label: MultiSigSigner
+---
+
+## Live preview
+
+<Demo preview={<MultiSigApprovalTrackerDemo />} code={`import { MultiSigApprovalTracker } from "@cdr-kit/react";
+
+// signedBy is the list of signers who have already produced a sig OFF-CHAIN
+// (the contract is stateless on approvals — no per-signer tx).
+<MultiSigApprovalTracker
+  uuid={7331}
+  signedBy={["0xAlice...", "0xBob..."]}
+/>`} badge={<Badge>mock</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "MultiSigCondition-gated vault uuid." },
+  { name: "signedBy", type: "readonly Hex[]", defaultValue: "[]", description: "Off-chain set of signers who have produced a sig (the contract stores no approvals — this comes from your sig-collection UI)." },
+  { name: "children", type: "(state) => ReactNode", description: "Render-prop. Receives { signers, threshold, epoch, signedCount, isReady, isLoading }." },
+]} />
+
+## Epoch rotation
+
+<p>Each call to <code>rotateSigners()</code> bumps <code>epoch</code>. The tracker re-reads on rotation; UI should prompt for a fresh sig collection because in-flight sigs against the previous epoch are invalidated.</p>
diff --git a/apps/site/content/docs/components/multi-sig-signer.mdx b/apps/site/content/docs/components/multi-sig-signer.mdx
new file mode 100644
index 0000000..2b5c55e
--- /dev/null
+++ b/apps/site/content/docs/components/multi-sig-signer.mdx
@@ -0,0 +1,67 @@
+---
+title: "<MultiSigSigner>"
+description: "Producer half of the off-chain dual-path MultiSigCondition flow: a button that signs an EIP-712 Approval and surfaces the 65-byte sig for the signer to share with the buyer."
+importLine: 'import { MultiSigSigner } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "MultiSigSigner"]
+prev:
+  href: /docs/components/multi-sig-approval-tracker
+  label: MultiSigApprovalTracker
+next:
+  href: /docs/components/escrow-delivery-confirm
+  label: EscrowDeliveryConfirm
+---
+
+## Live preview
+
+<Demo preview={<MultiSigSignerDemo />} code={`import { MultiSigSigner } from "@cdr-kit/react";
+
+// Default render — button → on click signs EIP-712 → shows the sig + copy button.
+<MultiSigSigner uuid={7331} />
+
+// With a custom caller (default = connected wallet) and 30-min deadline:
+<MultiSigSigner
+  uuid={7331}
+  caller="0xBuyerWhoWillSubmit"
+  deadline={BigInt(Math.floor(Date.now() / 1000) + 1800)}
+/>
+
+// Render-prop for full custom UI:
+<MultiSigSigner uuid={7331}>
+  {({ sign, signature, isLoading, error, onSign }) => (
+    signature
+      ? <span>Sig: {signature}</span>
+      : <button disabled={isLoading} onClick={onSign}>
+          {isLoading ? "signing…" : "Approve read"}
+        </button>
+  )}
+</MultiSigSigner>`} badge={<Badge>mock</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "MultiSigCondition-gated vault uuid." },
+  { name: "caller", type: "Hex", description: "Optional override — defaults to the connected wallet. The sig is bound to this address; only this caller can use it via accessAuxData (anyone else fails ecrecover)." },
+  { name: "deadline", type: "bigint", description: "Optional unix-seconds expiry. Default: 1 hour from when the user clicks Sign. The buyer's accessMultiSig call MUST pass the same deadline used at signing time." },
+  { name: "children", type: "(state) => ReactNode", description: "Render-prop. Receives { sign, signature, isLoading, error, onSign }. onSign is a bound zero-arg helper that calls sign(...) with the component's caller+deadline." },
+]} />
+
+## Submit threshold-many sigs
+
+<p>Once <code>threshold</code>-many signers have produced sigs, the buyer (or any caller) builds the combined <code>accessAuxData</code> and reads the vault. <code>agent.accessMultiSig</code> handles the abi-encoding; sigs must be ordered by recovered signer address ascending (the contract enforces a strict-ascending dedupe).</p>
+
+<CodePanel title="ts" language="ts" code={`// Buyer side — once threshold-many sigs collected from different signers:
+import { CdrAgent } from "@cdr-kit/agent";
+
+const bytes = await agent.accessMultiSig({
+  uuid: 7331,
+  deadline,                  // MUST match every sig's deadline
+  sigs: [sigFromAlice, sigFromBob],  // sorted by signer address ASC
+});`} />
+
+## Epoch rotation invalidates in-flight sigs
+
+<p>The hook fetches the current <code>epoch</code> from <code>getConfig(uuid)</code> immediately before signing. If <code>rotateSigners</code> lands between sign and submit, the contract recomputes the digest with the new epoch — <code>ecrecover</code> returns a different address and the sig is rejected. The signer can re-sign against the new epoch if they still want to authorize the new set (use the "re-sign" button in the default render, or call <code>sign()</code> again).</p>
+
+## Hook variant
+
+<p>Skip the component and use <code>useSignMultiSigApproval(uuid)</code> directly — returns <code>{`{ sign, signature, isLoading, error }`}</code>. Useful when the sign trigger lives in a non-button surface (drag-and-drop, gesture, programmatic flow).</p>
diff --git a/apps/site/content/docs/components/short-address.mdx b/apps/site/content/docs/components/short-address.mdx
new file mode 100644
index 0000000..9c42555
--- /dev/null
+++ b/apps/site/content/docs/components/short-address.mdx
@@ -0,0 +1,29 @@
+---
+title: "<ShortAddress>"
+description: "Truncated mono address chip with an inline <CopyButton>. The chip's default truncation is 6 / 4 (head / tail)."
+importLine: 'import { ShortAddress } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "DX primitives", "ShortAddress"]
+prev:
+  href: /docs/components/copy-button
+  label: CopyButton
+next:
+  href: /docs/components/explorer-link
+  label: ExplorerLink
+---
+
+import { ShortAddress } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<ShortAddress address="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" />} code={`import { ShortAddress } from "@cdr-kit/react-ui";
+
+<ShortAddress address="0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C" />`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "address", type: "string", required: true, description: "The full hex address (or any string) to render + copy." },
+  { name: "head", type: "number", defaultValue: "6", description: "Leading characters to keep (after the 0x prefix)." },
+  { name: "tail", type: "number", defaultValue: "4", description: "Trailing characters to keep." },
+  { name: "copyable", type: "boolean", defaultValue: "true", description: "Show the inline copy button." },
+]} />
diff --git a/apps/site/content/docs/components/subscribe-button.mdx b/apps/site/content/docs/components/subscribe-button.mdx
new file mode 100644
index 0000000..0bfc9fa
--- /dev/null
+++ b/apps/site/content/docs/components/subscribe-button.mdx
@@ -0,0 +1,37 @@
+---
+title: "<SubscribeButton>"
+description: "Batteries-included CTA. Wraps useSubscribeAndAccess, renders an inline AccessStepper through the wait phases, then shows the decrypted JSON when access is granted."
+importLine: 'import { SubscribeButton } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "Components", "SubscribeButton"]
+prev:
+  href: /docs/components/access-stepper
+  label: AccessStepper
+next:
+  href: /docs/components/vault-card
+  label: VaultCard
+---
+
+## Live preview
+
+<Demo preview={<SubscribeButtonDemo />} code={`import { CdrProvider } from "@cdr-kit/react";
+import { createMockCdrKit } from "@cdr-kit/core";
+import { SubscribeButton } from "@cdr-kit/react-ui";
+
+<CdrProvider mockKit={createMockCdrKit()}>
+  <SubscribeButton
+    uuid={4200}
+    priceWei={5n * 10n ** 18n}
+    priceLabel="5 $IP"
+  />
+</CdrProvider>`} badge={<Badge>mock kit</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "The CDR vault id to subscribe to." },
+  { name: "priceWei", type: "bigint", required: true, description: "Total value (wei) sent to subscribe. Use the maxPricePerPeriod from your condition config." },
+  { name: "priceLabel", type: "string", required: true, description: 'Human-readable price rendered on the button (e.g. "5 $IP").' },
+  { name: "periods", type: "bigint", defaultValue: "1n", description: "Number of subscription periods to pay for in this call." },
+  { name: "subscriptionCondition", type: "Hex", description: "Override the default deployed SubscriptionCondition address." },
+  { name: "onAccess", type: "(bytes: Uint8Array) => void", description: "Called with the decrypted bytes once the flow completes." },
+]} />
diff --git a/apps/site/content/docs/components/time-window-badge.mdx b/apps/site/content/docs/components/time-window-badge.mdx
new file mode 100644
index 0000000..0ceaa2d
--- /dev/null
+++ b/apps/site/content/docs/components/time-window-badge.mdx
@@ -0,0 +1,38 @@
+---
+title: "<TimeWindowBadge>"
+description: "Status badge for TimeWindowCondition-gated vaults: opens in 3d 4h, closes in 2h 15m, or closed. Ticks every second client-side, no extra RPC traffic after the first read."
+importLine: 'import { TimeWindowBadge } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "TimeWindowBadge"]
+prev:
+  href: /docs/components/heartbeat-timer
+  label: HeartbeatTimer
+next:
+  href: /docs/components/multi-sig-approval-tracker
+  label: MultiSigApprovalTracker
+---
+
+## Live preview
+
+<Demo preview={<TimeWindowBadgeDemo />} code={`import { TimeWindowBadge } from "@cdr-kit/react";
+
+<TimeWindowBadge uuid={5101} />
+
+// Render-prop for custom presentation:
+<TimeWindowBadge uuid={5101}>
+  {({ isOpen, opensInMs, closesInMs }) =>
+    isOpen
+      ? <span>open · closes in {Math.floor(closesInMs / 60_000)}m</span>
+      : <span>opens in {Math.floor(opensInMs / 3_600_000)}h</span>
+  }
+</TimeWindowBadge>`} badge={<Badge>cycles</Badge>} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "TimeWindowCondition-gated vault uuid." },
+  { name: "children", type: "(state: TimeWindowState) => ReactNode", description: "Optional render-prop. Receives { startTs, endTs, blockBased, isOpen, opensInMs, closesInMs, isLoading }." },
+]} />
+
+## Block-based windows
+
+<p>For windows configured with <code>blockBased: true</code>, the client-side <code>opensInMs</code>/<code>closesInMs</code> return <code>0</code> — block.number can't be ticked client-side cheaply. Render the raw block bounds from the state object instead.</p>
diff --git a/apps/site/content/docs/components/unlockable.mdx b/apps/site/content/docs/components/unlockable.mdx
new file mode 100644
index 0000000..7e2e7bf
--- /dev/null
+++ b/apps/site/content/docs/components/unlockable.mdx
@@ -0,0 +1,81 @@
+---
+title: "<UnlockablePill>"
+description: 'Inline "free to read, pay to unlock" paywall. Wrap any anchor text in a pill; the click opens a floating card that runs the full CDR subscribe → threshold-read → decrypt flow.'
+importLine: 'import { UnlockablePill } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "Components", "Unlockable"]
+prev:
+  href: /docs/components/subscribe-button
+  label: SubscribeButton
+next:
+  href: /docs/components/vault-card
+  label: VaultCard
+---
+
+<a href="/showcase/blog" className="unl-doc-cta">
+  <span className="unl-doc-cta-eyebrow">live showcase</span>
+  <span className="unl-doc-cta-title">See &lt;UnlockablePill&gt; in a real blog post →</span>
+  <span className="unl-doc-cta-sub">Five live unlocks across text, image, and prose attachments. Mock CDR — no wallet, no chain.</span>
+</a>
+
+## Live preview
+
+<Demo preview={<UnlockableDemo />} code={`import { CdrProvider } from "@cdr-kit/react";
+import { createMockCdrKit } from "@cdr-kit/core";
+import { UnlockablePill } from "@cdr-kit/react-ui";
+
+<CdrProvider mockKit={createMockCdrKit()}>
+  <p>
+    Arlo Vance told the press he was alone, but{" "}
+    <UnlockablePill uuid={4242} priceLabel="3 $IP">
+      the woman beside him on the dock
+    </UnlockablePill>{" "}
+    disagrees.
+  </p>
+</CdrProvider>`} badge={<Badge>mock kit</Badge>} />
+
+## Headless variant
+
+<p>Prefer to render your own UI? <code>useUnlockable</code> exposes the entire state machine — status, data, error, isOpen, open/close, request, reset. The styled <code>UnlockablePill</code> is a 60-line wrapper on top of it.</p>
+
+<Demo preview={<div style={{ padding: 18, fontSize: 13, color: "var(--ink-3)" }}>Use the hook for full control. Snippet on the Code tab.</div>} code={`import { useUnlockable } from "@cdr-kit/react";
+
+function CustomPill({ uuid }) {
+  const { status, data, isOpen, open, close, request } =
+    useUnlockable({ uuid, mode: "subscribe" });
+
+  return (
+    <span onClick={open}>
+      [click to unlock]
+      {isOpen && (
+        <div role="dialog">
+          {status === "ready" ? render(data) : (
+            <button onClick={() => request()}>Pay 5 $IP</button>
+          )}
+        </div>
+      )}
+    </span>
+  );
+}`} language="tsx" />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "The CDR vault holding the encrypted attachment." },
+  { name: "children", type: "ReactNode", required: true, description: "The anchor text (stays plaintext / SEO-visible — it's the teaser, not the secret)." },
+  { name: "priceLabel", type: "string", defaultValue: '"5 $IP"', description: "Human-readable price shown in the unlock card." },
+  { name: "mode", type: '"subscribe" | "access"', defaultValue: '"subscribe"', description: "Subscribe runs the paywall flow; access skips payment (open/tier-gate vaults where the reader already has rights)." },
+  { name: "title", type: "ReactNode", defaultValue: '"Unlock to reveal"', description: "Card header title." },
+  { name: "subtitle", type: "ReactNode", description: 'Card header subtitle, e.g. "1 photo · attached".' },
+  { name: "unlockedRenderer", type: "(bytes: Uint8Array) => ReactNode", defaultValue: "unlockedAuto", description: "Render the decrypted bytes. Default auto-detects PNG/JPEG/WebP/GIF, falls back to UTF-8 text, then to a download link." },
+  { name: "subscriptionCondition", type: "Hex", description: "Override the default deployed SubscriptionCondition address." },
+]} />
+
+## Mobile fallback
+
+<p>Below 560px the floating popover collapses to a bottom-sheet — the card pins to the bottom of the viewport with a safe-area-aware inset. No additional code; the same <code>UnlockablePill</code> handles both.</p>
+
+## The anchor is plaintext — that's intentional
+
+<p>The text inside <code>&lt;UnlockablePill&gt;</code> is a public teaser. Search engines and inspect-element will see it. The <b>encrypted payload</b> is what the vault holds — an image, a file, a hidden paragraph — and that only exists in the DOM after a successful read.</p>
+
+<p>This matches the onscroll.app pattern: highlighted phrases anchor the unlock UX, attached content is the secret. If you want the anchor itself to be the secret, use <code>&lt;VaultGate&gt;</code> instead.</p>
diff --git a/apps/site/content/docs/components/vault-card.mdx b/apps/site/content/docs/components/vault-card.mdx
new file mode 100644
index 0000000..dff3bbf
--- /dev/null
+++ b/apps/site/content/docs/components/vault-card.mdx
@@ -0,0 +1,42 @@
+---
+title: "<VaultCard>"
+description: "Marketplace card with a CSS pointer-tracking spotlight on hover. Renders the condition badge, title, description, optional data type, creator, and price."
+importLine: 'import { VaultCard } from "@cdr-kit/react-ui"'
+breadcrumb: ["@cdr-kit/react-ui", "Components", "VaultCard"]
+prev:
+  href: /docs/components/subscribe-button
+  label: SubscribeButton
+next:
+  href: /docs/components/copy-button
+  label: CopyButton
+---
+
+import { VaultCard, IpPrice } from "@cdr-kit/react-ui";
+
+## Live preview
+
+<Demo preview={<div style={{ display: "grid", gridTemplateColumns: "1fr", gap: 16, width: "100%", maxWidth: 380 }}><VaultCard uuid={4200} condition="subscription" title="ETH/USD alpha signal" description="Hourly directional signal, threshold-encrypted. Subscribers decrypt the latest window." dataType="signal" creatorName="0xc183…96E2" price={<IpPrice wei={5n * 10n ** 18n} period="/ 30d" />} /></div>} code={`import { VaultCard, IpPrice } from "@cdr-kit/react-ui";
+
+<VaultCard
+  uuid={4200}
+  condition="subscription"
+  title="ETH/USD alpha signal"
+  description="Hourly directional signal, threshold-encrypted."
+  dataType="signal"
+  creatorName="0xc183…96E2"
+  price={<IpPrice wei={5n * 10n ** 18n} period="/ 30d" />}
+  href="/vault/4200"
+/>`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "The CDR vault id (rendered in the corner)." },
+  { name: "condition", type: "ConditionKind", required: true, description: "Drives the colored ConditionBadge in the card header." },
+  { name: "title", type: "string", required: true, description: "Card heading." },
+  { name: "description", type: "string", required: true, description: "2-line clamped body description." },
+  { name: "dataType", type: "string", description: 'Small chip in the meta row (e.g. "signal", "dataset").' },
+  { name: "creatorName", type: "string", description: "Truncated address or display name in the footer." },
+  { name: "price", type: "ReactNode", description: "Right-aligned footer price slot — pair with <IpPrice />." },
+  { name: "href", type: "string", description: "Render the card as an <a> linking to the vault detail page." },
+]} />
diff --git a/apps/site/content/docs/components/vault-gate.mdx b/apps/site/content/docs/components/vault-gate.mdx
new file mode 100644
index 0000000..f14f372
--- /dev/null
+++ b/apps/site/content/docs/components/vault-gate.mdx
@@ -0,0 +1,75 @@
+---
+title: VaultGate
+description: "A declarative gate. Wrap it around the data you want to protect; it checks the vault's on-chain read condition, collects key shares, and renders the decrypted bytes via a render-prop once access is granted."
+importLine: 'import { VaultGate } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "VaultGate"]
+prev:
+  href: /docs/components/cdr-provider
+  label: CdrProvider
+next:
+  href: /docs/components/vault
+  label: Vault compound
+---
+
+<Callout>
+  <b>Mock by default.</b> Every example on this page runs against an in-memory CDR — no wallet, no chain, no testnet funds. Swap <code>mockKit</code> for <code>config</code> + <code>apiUrl</code> to go live on Aeneid.
+</Callout>
+
+## Live preview
+
+<p>Press subscribe to run the full mock flow — condition check, payment, threshold key-share collection, and local decryption. It mirrors the real 2-step <code>subscribeAndAccess</code> path against the actual <code>createMockCdrKit()</code> from <code>@cdr-kit/core</code>.</p>
+
+<Demo preview={<VaultGateDemo />} code={`import { CdrProvider, VaultGate } from "@cdr-kit/react";
+import { createMockCdrKit } from "@cdr-kit/core";
+
+export function SignalCard() {
+  return (
+    <CdrProvider mockKit={createMockCdrKit()}>
+      <VaultGate
+        uuid={4200}
+        fallback={<SubscribeButton price="5 $IP" />}
+        loading={<CdrSkeleton lines={3} />}>
+        {(data) => <pre>{new TextDecoder().decode(data)}</pre>}
+      </VaultGate>
+    </CdrProvider>
+  );
+}`} badge={<Badge>mock kit</Badge>} />
+
+## Usage
+
+<p>The simplest gate: pass a <code>uuid</code> and a render-prop. With <code>auto</code>, <code>VaultGate</code> requests access on mount; without it, it waits for an imperative trigger from the access hook.</p>
+
+<CodePanel title="SignalCard.tsx" code={`<VaultGate uuid={4200} auto fallback={<SubscribeButton />}>
+  {(data) => <SignalView bytes={data} />}
+</VaultGate>`} />
+
+## Props
+
+<PropsTable rows={[
+  { name: "uuid", type: "number", required: true, description: "The CDR vault id. Read it from the VaultCreated event — never predict it (it's a global counter)." },
+  { name: "children", type: "(data: Uint8Array) => ReactNode", required: true, description: "Render-prop called with the decrypted bytes once the condition is satisfied." },
+  { name: "auto", type: "boolean", defaultValue: "false", description: "Request access on mount instead of waiting for an imperative trigger." },
+  { name: "fallback", type: "ReactNode", defaultValue: "null", description: "Rendered while the condition is unmet — typically your subscribe / pay button." },
+  { name: "loading", type: "ReactNode", defaultValue: "<CdrSkeleton/>", description: "Rendered during the ~15s threshold read while key shares are collected." },
+  { name: "accessAuxData", type: "Hex", defaultValue: '"0x"', description: "Optional ABI-encoded auxiliary data passed to the read condition (e.g. a tier-gate license tokenId)." },
+]} />
+
+## States
+
+<p><code>VaultGate</code> is a thin wrapper over <code>useAccessVault</code>, whose discriminated <code>status</code> drives what renders:</p>
+
+<ul>
+  <li><code>idle</code> / <code>error</code> — condition unmet → renders <code>fallback</code>.</li>
+  <li><code>collecting-partials</code> — collecting key shares (the ~15s read) → renders <code>loading</code>.</li>
+  <li><code>ready</code> — threshold met, decrypted → renders <code>children(data)</code>.</li>
+</ul>
+
+## Mock mode
+
+<p>Wrap your tree in a <code>CdrProvider</code> with a <code>createMockCdrKit()</code> and the entire component surface works with zero chain dependencies — ideal for Storybook, tests, and the previews on this page. Going live is a one-line swap:</p>
+
+<CodePanel title="provider.tsx" code={`// local / tests — no wallet, no chain
+<CdrProvider mockKit={createMockCdrKit()}> … </CdrProvider>
+
+// live on Aeneid — same children, real round-trip
+<CdrProvider config={wagmiConfig} apiUrl={apiUrl}> … </CdrProvider>`} />
diff --git a/apps/site/content/docs/components/vault.mdx b/apps/site/content/docs/components/vault.mdx
new file mode 100644
index 0000000..beec9cc
--- /dev/null
+++ b/apps/site/content/docs/components/vault.mdx
@@ -0,0 +1,28 @@
+---
+title: Vault
+description: "Compound component — Clerk's SignedIn / SignedOut pattern adapted to CDR. A single access drives the shared state; Vault.Locked, Vault.Loading, and Vault.Unlocked render against it."
+importLine: 'import { Vault } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Components", "Vault"]
+prev:
+  href: /docs/components/vault-gate
+  label: VaultGate
+next:
+  href: /docs/components/cdr-inspector
+  label: CdrInspector
+---
+
+## Usage
+
+<CodePanel title="SignalView.tsx" code={`<Vault uuid={4200} auto>
+  <Vault.Locked>   <SubscribeButton /> </Vault.Locked>
+  <Vault.Loading>  <CdrSkeleton lines={3} /> </Vault.Loading>
+  <Vault.Unlocked> {(data) => <SignalView bytes={data} />} </Vault.Unlocked>
+</Vault>`} />
+
+## Slots
+
+<ul>
+  <li><code>Vault.Locked</code> — status is <code>idle</code> or <code>error</code>.</li>
+  <li><code>Vault.Loading</code> — status is <code>paying</code> or <code>collecting-partials</code>. Optional render-prop receives <code>{`{ collected, threshold }`}</code>.</li>
+  <li><code>Vault.Unlocked</code> — status is <code>ready</code>. Render-prop receives the decrypted bytes.</li>
+</ul>
diff --git a/apps/site/content/docs/contracts/cdr-kit-vault.mdx b/apps/site/content/docs/contracts/cdr-kit-vault.mdx
new file mode 100644
index 0000000..e4f794f
--- /dev/null
+++ b/apps/site/content/docs/contracts/cdr-kit-vault.mdx
@@ -0,0 +1,30 @@
+---
+title: CdrKitVault (factory)
+description: "The atomic factory: createVault mints the vault NFT, registers it as a Story IP asset, allocates the CDR slot, configures the read condition, and (optionally) attaches PIL license terms — all in one transaction."
+importLine: "address = 0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C"
+breadcrumb: ["@cdr-kit/contracts", "CdrKitVault"]
+prev:
+  href: /docs/contracts/creator-write-condition
+  label: CreatorWriteCondition
+next:
+  href: /docs/scaffolder
+  label: npm create cdr-kit
+---
+
+## createVault signature
+
+<CodePanel title="CdrKitVault.sol" code={`function createVault(
+  address readConditionAddr,
+  bytes calldata readConfig,
+  address[] calldata childConditions,
+  bytes[] calldata childConfigs,
+  uint256 licenseTermsId
+) external payable returns (uint32 uuid, uint256 tokenId, address ipId);`} />
+
+## Events
+
+<p>Emits <code>VaultCreated(tokenId, uuid, ipId, creator, licenseTermsId)</code> — read the <code>uuid</code> from the tx receipt; never predict it (global counter).</p>
+
+## Gas note
+
+<p>The factory nests a CDR precompile call (<code>allocate</code>) whose gas <code>eth_estimateGas</code> underestimates. Always set an explicit gas limit (<code>3_000_000</code> is the SDK default).</p>
diff --git a/apps/site/content/docs/contracts/composable-condition.mdx b/apps/site/content/docs/contracts/composable-condition.mdx
new file mode 100644
index 0000000..7367ce8
--- /dev/null
+++ b/apps/site/content/docs/contracts/composable-condition.mdx
@@ -0,0 +1,23 @@
+---
+title: ComposableCondition
+description: 'Boolean AND / OR over child conditions, up to 8 deep. Compose "Subscription OR Tier" or "Royalty AND License" — natively, on chain, in one read check.'
+importLine: "address = 0x74F2f94e7867b07ECDFbcc667050CBec1dE2800B"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "ComposableCondition"]
+prev:
+  href: /docs/contracts/tier-gate-condition
+  label: TierGateCondition
+next:
+  href: /docs/contracts/open-condition
+  label: OpenCondition
+---
+
+## Config shape
+
+<ul>
+  <li><code>mode: uint8</code> — 0 = AND, 1 = OR.</li>
+  <li><code>children: address[]</code> — child condition addresses (1–8).</li>
+</ul>
+
+## accessAuxData
+
+<p>ABI-encoded <code>bytes[]</code> of per-child aux, aligned to the configured children order.</p>
diff --git a/apps/site/content/docs/contracts/conditional-escrow-condition.mdx b/apps/site/content/docs/contracts/conditional-escrow-condition.mdx
new file mode 100644
index 0000000..80d3db7
--- /dev/null
+++ b/apps/site/content/docs/contracts/conditional-escrow-condition.mdx
@@ -0,0 +1,34 @@
+---
+title: ConditionalEscrowCondition
+description: "Buyer pays → confirms delivery → seller paid + buyer reads. Optional arbiter can refund. Seller can claimAfterTimeout(buyer) if the buyer goes silent."
+importLine: "address = 0x7fcDe02DB7c14fD3587aB2fED064a1D8355b7584"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "ConditionalEscrowCondition"]
+prev:
+  href: /docs/contracts/dead-man-switch-condition
+  label: DeadManSwitchCondition
+next:
+  href: /docs/contracts/multi-sig-condition
+  label: MultiSigCondition
+---
+
+## Config shape
+
+<PropsTable rows={[
+  { name: "seller", type: "address", required: true, description: "Receives funds on confirmDelivery / claimAfterTimeout." },
+  { name: "price", type: "uint128", required: true, description: "Listing price in wei (native IP)." },
+  { name: "timeoutSecs", type: "uint64", required: true, description: "Seconds after paidAt before the seller can claim unilaterally." },
+  { name: "arbiter", type: "address", required: true, description: "Optional dispute resolver. address(0) = no refund path." },
+]} />
+
+## Flow
+
+<ol>
+  <li><code>pay(uuid)</code> — buyer escrows the price (excess refunded same tx).</li>
+  <li><code>confirmDelivery(uuid)</code> — buyer signs off → seller paid + buyer reads.</li>
+  <li><code>claimAfterTimeout(uuid, buyer)</code> — seller only, after <code>paidAt + timeoutSecs</code>.</li>
+  <li><code>arbiterRefund(uuid, buyer)</code> — arbiter only; resets paidAt and refunds the buyer.</li>
+</ol>
+
+## Intrinsic CDR limitation
+
+<p>CDR has no confidential compute — once a buyer reads, they hold plaintext forever. The dispute path can revoke future access but cannot "un-read." Document this in your buyer UX.</p>
diff --git a/apps/site/content/docs/contracts/creator-write-condition.mdx b/apps/site/content/docs/contracts/creator-write-condition.mdx
new file mode 100644
index 0000000..ce19926
--- /dev/null
+++ b/apps/site/content/docs/contracts/creator-write-condition.mdx
@@ -0,0 +1,16 @@
+---
+title: CreatorWriteCondition
+description: "The default write gate when you mint through CdrKitVault: only the original creator (vault NFT owner) can write encrypted payloads. Factory-aware variant of OwnerWriteCondition."
+importLine: "address = 0x85CEB332445ca1d3D1975d6929cA6BED25195b2F"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "CreatorWriteCondition"]
+prev:
+  href: /docs/contracts/open-condition
+  label: OpenCondition
+next:
+  href: /docs/contracts/cdr-kit-vault
+  label: CdrKitVault
+---
+
+## Config
+
+<p>No config bytes required — the factory wires the creator at allocation time.</p>
diff --git a/apps/site/content/docs/contracts/dead-man-switch-condition.mdx b/apps/site/content/docs/contracts/dead-man-switch-condition.mdx
new file mode 100644
index 0000000..92f8edf
--- /dev/null
+++ b/apps/site/content/docs/contracts/dead-man-switch-condition.mdx
@@ -0,0 +1,30 @@
+---
+title: DeadManSwitchCondition
+description: "Auto-unlock to heir(s) (or public) if the creator stops calling poke() within duration. The wallet-recovery / estate-planning / leak-on-disappearance primitive Story docs reference."
+importLine: "address = 0x37226f97e184843aB0b8d4f08A55969801B97766"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "DeadManSwitchCondition"]
+prev:
+  href: /docs/contracts/time-window-condition
+  label: TimeWindowCondition
+next:
+  href: /docs/contracts/conditional-escrow-condition
+  label: ConditionalEscrowCondition
+---
+
+## Config shape
+
+<PropsTable rows={[
+  { name: "duration", type: "uint64", required: true, description: "Heartbeat window length (seconds OR blocks). Must be > 0." },
+  { name: "heirs", type: "address[]", required: true, description: "Allowed readers post-unlock if publicAfterUnlock = false. Empty array forces publicAfterUnlock to true." },
+  { name: "blockBased", type: "bool", required: true, description: "true = interpret duration as block count." },
+  { name: "creatorCanReadWhileLocked", type: "bool", required: true, description: "Creator reads their own vault pre-unlock (default true via agent helper)." },
+  { name: "publicAfterUnlock", type: "bool", required: true, description: "true = anyone reads post-unlock; false = restricted to heirs." },
+]} />
+
+## The trapdoor
+
+<p>Post-unlock, the creator gets NO special treatment. If <code>publicAfterUnlock = false</code> AND the creator isn't in <code>heirs</code>, they lose read access permanently at unlock — by design. <code>agent.createDeadManVault</code> defaults <code>creatorCanReadWhileLocked = true</code> and recommends adding the creator to <code>heirs</code> for post-unlock access.</p>
+
+## poke()
+
+<p>Creator-only. Cannot be called after <code>unlockAt</code> (one-way trapdoor — reviving would let a late-poking creator block heirs forever). Most operational risk is forgetting to poke; consider a self-hosted cron or Gelato Automate for long durations.</p>
diff --git a/apps/site/content/docs/contracts/index.mdx b/apps/site/content/docs/contracts/index.mdx
new file mode 100644
index 0000000..c9e9e04
--- /dev/null
+++ b/apps/site/content/docs/contracts/index.mdx
@@ -0,0 +1,53 @@
+---
+title: Condition standard library
+description: "A tested Solidity standard library + a factory (CdrKitVault) that mints, registers IP, allocates the CDR slot, and configures the read condition in one transaction. All deployed to Aeneid testnet (chain id 1315)."
+importLine: 'import { aeneid } from "@cdr-kit/contracts"'
+breadcrumb: ["@cdr-kit", "Contracts"]
+prev:
+  href: /docs/agent-kit/mcp
+  label: MCP server
+next:
+  href: /docs/contracts/subscription-condition
+  label: SubscriptionCondition
+---
+
+## Library
+
+<ul>
+  <li><a href="/docs/contracts/subscription-condition"><code>SubscriptionCondition</code></a></li>
+  <li><a href="/docs/contracts/tier-gate-condition"><code>TierGateCondition</code></a></li>
+  <li><a href="/docs/contracts/composable-condition"><code>ComposableCondition</code></a></li>
+  <li><a href="/docs/contracts/open-condition"><code>OpenCondition</code></a></li>
+  <li><a href="/docs/contracts/creator-write-condition"><code>CreatorWriteCondition</code></a></li>
+  <li><a href="/docs/contracts/time-window-condition"><code>TimeWindowCondition</code></a></li>
+  <li><a href="/docs/contracts/dead-man-switch-condition"><code>DeadManSwitchCondition</code></a></li>
+  <li><a href="/docs/contracts/conditional-escrow-condition"><code>ConditionalEscrowCondition</code></a></li>
+  <li><a href="/docs/contracts/multi-sig-condition"><code>MultiSigCondition</code></a></li>
+  <li><a href="/docs/contracts/cdr-kit-vault"><code>CdrKitVault</code></a> — the factory</li>
+</ul>
+
+## Condition interface
+
+<p>Conditions are pure <code>view</code> functions the validator network calls at read/write time. The 4-param signature:</p>
+
+<CodePanel title="ICdrCondition.sol" code={`function checkReadCondition(
+  uint32 uuid,
+  bytes accessAuxData,
+  bytes conditionData,
+  address caller
+) external view returns (bool);`} />
+
+## Deployed (Aeneid)
+
+<ul style={{ fontFamily: "var(--mono)", fontSize: "0.82rem" }}>
+  <li>CdrKitVault: <code>0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C</code></li>
+  <li>SubscriptionCondition: <code>0xB75Cc6571ac7E0ee30A519192740fc471e187458</code></li>
+  <li>TierGateCondition: <code>0xdA704Faf61b2FFB37205d7Eb8C1D26BD3090455f</code></li>
+  <li>ComposableCondition: <code>0x74F2f94e7867b07ECDFbcc667050CBec1dE2800B</code></li>
+  <li>OpenCondition: <code>0x36fB2e2d10efd1E905b7779A684F34B9c775b62B</code></li>
+  <li>CreatorWriteCondition: <code>0x85CEB332445ca1d3D1975d6929cA6BED25195b2F</code></li>
+  <li>TimeWindowCondition: <code>0x67911435F262e7e4EC4F7FEB4e868a67b9dd90b1</code></li>
+  <li>DeadManSwitchCondition: <code>0x37226f97e184843aB0b8d4f08A55969801B97766</code></li>
+  <li>ConditionalEscrowCondition: <code>0x7fcDe02DB7c14fD3587aB2fED064a1D8355b7584</code></li>
+  <li>MultiSigCondition: <code>0x3A0Cf72f167A2c1f5a7A5025eb36219f28C20FCd</code></li>
+</ul>
diff --git a/apps/site/content/docs/contracts/multi-sig-condition.mdx b/apps/site/content/docs/contracts/multi-sig-condition.mdx
new file mode 100644
index 0000000..48fc2cc
--- /dev/null
+++ b/apps/site/content/docs/contracts/multi-sig-condition.mdx
@@ -0,0 +1,41 @@
+---
+title: MultiSigCondition
+description: "N-of-M read gate with two parallel approval paths: off-chain EIP-712 sigs (gas-free; buyer collects + submits at read time) OR Safe-style on-chain approve() (signers pay gas; dashboards read chain truth). First-of-kind in the CDR ecosystem."
+importLine: "address = 0x3A0Cf72f167A2c1f5a7A5025eb36219f28C20FCd"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "MultiSigCondition"]
+prev:
+  href: /docs/contracts/conditional-escrow-condition
+  label: ConditionalEscrowCondition
+next:
+  href: /docs/contracts/cdr-kit-vault
+  label: CdrKitVault
+---
+
+## Config shape
+
+<PropsTable rows={[
+  { name: "signers", type: "address[]", required: true, description: "Allowed signers. MUST be sorted strictly ascending (agent helper auto-sorts)." },
+  { name: "threshold", type: "uint16", required: true, description: "Minimum sigs required (1 ≤ threshold ≤ signers.length)." },
+]} />
+
+## EIP-712 Approval
+
+<ul>
+  <li>Domain: <code>cdr-kit:MultiSigCondition</code>, version <code>1</code>, chainId 1315, verifyingContract = condition address.</li>
+  <li>Type: <code>Approval(uint32 uuid, address caller, uint64 epoch, uint64 deadline)</code>.</li>
+  <li><code>caller</code> binding prevents sig replay against a different reader; <code>epoch</code> rotation invalidates in-flight sigs.</li>
+</ul>
+
+## On-chain approve() — the Safe-style path
+
+<p>For dashboards that prefer chain-truth over off-chain sig collection, signers call <code>approve(uuid)</code> on-chain. Each approval costs ~50k gas. <code>currentApprovalsCount(uuid)</code> returns the count for the active epoch — read it directly in your UI via <code>useMultiSigStatus</code>.</p>
+
+<p>Storage shape (epoch-scoped, so rotation auto-invalidates): <code>hasApproved[uuid][epoch][signer]</code> + <code>approvalsCount[uuid][epoch]</code>. Emits <code>Approved(uuid, signer, epoch)</code> for indexers.</p>
+
+## rotateSigners()
+
+<p>Creator-only. Validates the new signer set + threshold, bumps <code>epoch</code> — invalidates BOTH off-chain sigs (signed against the old epoch) AND on-chain approvals (the count under the old epoch key no longer matters since reads check the new epoch). Use this to remove a compromised signer immediately.</p>
+
+## Limitations
+
+<p>EIP-1271 (Safe / contract-wallet signers) not supported in 0.5 — <code>ecrecover</code> handles EOAs only. Workaround: have a Safe-owned EOA sign on behalf and register that EOA.</p>
diff --git a/apps/site/content/docs/contracts/open-condition.mdx b/apps/site/content/docs/contracts/open-condition.mdx
new file mode 100644
index 0000000..e3e69a1
--- /dev/null
+++ b/apps/site/content/docs/contracts/open-condition.mdx
@@ -0,0 +1,16 @@
+---
+title: OpenCondition
+description: "Always returns true. Use as a fallback / sanity gate, or as the read condition for genuinely public data."
+importLine: "address = 0x36fB2e2d10efd1E905b7779A684F34B9c775b62B"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "OpenCondition"]
+prev:
+  href: /docs/contracts/composable-condition
+  label: ComposableCondition
+next:
+  href: /docs/contracts/creator-write-condition
+  label: CreatorWriteCondition
+---
+
+## Config
+
+<p>No config bytes required — pass <code>0x</code>.</p>
diff --git a/apps/site/content/docs/contracts/subscription-condition.mdx b/apps/site/content/docs/contracts/subscription-condition.mdx
new file mode 100644
index 0000000..c506709
--- /dev/null
+++ b/apps/site/content/docs/contracts/subscription-condition.mdx
@@ -0,0 +1,22 @@
+---
+title: SubscriptionCondition
+description: "Recurring paid access. The buyer calls subscribe(uuid, periods, maxPricePerPeriod) with the right value; subsequent reads pass until the subscription expires."
+importLine: "address = 0xB75Cc6571ac7E0ee30A519192740fc471e187458"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "SubscriptionCondition"]
+prev:
+  href: /docs/contracts
+  label: Condition library
+next:
+  href: /docs/contracts/tier-gate-condition
+  label: TierGateCondition
+---
+
+## Config shape
+
+<PropsTable rows={[
+  { name: "pricePerPeriod", type: "uint256", required: true, description: "Price in wei per subscription period." },
+  { name: "period", type: "uint256", required: true, description: "Period length in seconds." },
+  { name: "payee", type: "address", required: true, description: "Where subscription value is routed." },
+  { name: "mode", type: "uint8", required: true, description: "0 = native IP, 1 = WIP royalty routing." },
+  { name: "licensorIpId", type: "address", description: "Required in royalty mode; 0x0 in native mode." },
+]} />
diff --git a/apps/site/content/docs/contracts/tier-gate-condition.mdx b/apps/site/content/docs/contracts/tier-gate-condition.mdx
new file mode 100644
index 0000000..f242c8e
--- /dev/null
+++ b/apps/site/content/docs/contracts/tier-gate-condition.mdx
@@ -0,0 +1,23 @@
+---
+title: TierGateCondition
+description: "Gate by a held Story IP license-token tier. The buyer passes the tokenId of their license as accessAuxData; the condition verifies ownership + that the tier is in the allowed set."
+importLine: "address = 0xdA704Faf61b2FFB37205d7Eb8C1D26BD3090455f"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "TierGateCondition"]
+prev:
+  href: /docs/contracts/subscription-condition
+  label: SubscriptionCondition
+next:
+  href: /docs/contracts/composable-condition
+  label: ComposableCondition
+---
+
+## Config shape
+
+<ul>
+  <li><code>ipId: address</code> — the IP asset the license must reference.</li>
+  <li><code>allowedTermsIds: uint256[]</code> — accepted PIL terms ids (≥1).</li>
+</ul>
+
+## accessAuxData
+
+<p>ABI-encoded <code>uint256</code> tokenId of the license the caller holds.</p>
diff --git a/apps/site/content/docs/contracts/time-window-condition.mdx b/apps/site/content/docs/contracts/time-window-condition.mdx
new file mode 100644
index 0000000..593f527
--- /dev/null
+++ b/apps/site/content/docs/contracts/time-window-condition.mdx
@@ -0,0 +1,28 @@
+---
+title: TimeWindowCondition
+description: "Read access is allowed only during [startTs, endTs]. endTs == 0 means open-ended (release-on-date pattern). Block-based mode (blockBased: true) is preferred for short horizons."
+importLine: "address = 0x67911435F262e7e4EC4F7FEB4e868a67b9dd90b1"
+breadcrumb: ["@cdr-kit/contracts", "Conditions", "TimeWindowCondition"]
+prev:
+  href: /docs/contracts/cdr-kit-vault
+  label: CdrKitVault
+next:
+  href: /docs/contracts/dead-man-switch-condition
+  label: DeadManSwitchCondition
+---
+
+## Config shape
+
+<PropsTable rows={[
+  { name: "startTs", type: "uint64", required: true, description: "Start timestamp (or block number if blockBased)." },
+  { name: "endTs", type: "uint64", required: true, description: "End (0 = open-ended)." },
+  { name: "blockBased", type: "bool", required: true, description: "true = interpret startTs/endTs as block.number; false = block.timestamp." },
+]} />
+
+## Agent presets
+
+<ul>
+  <li><code>releaseOnDate(startTs)</code> → <code>(startTs, 0, false)</code> — open-ended after a date.</li>
+  <li><code>availableDuring(startTs, endTs)</code> → <code>(startTs, endTs, false)</code> — bounded window.</li>
+  <li><code>releaseAfterBlocks(blockNum)</code> → <code>(0, blockNum, true)</code> — block-based release.</li>
+</ul>
diff --git a/apps/site/content/docs/forms/index.mdx b/apps/site/content/docs/forms/index.mdx
new file mode 100644
index 0000000..b39e5ec
--- /dev/null
+++ b/apps/site/content/docs/forms/index.mdx
@@ -0,0 +1,144 @@
+---
+title: "@cdr-kit/forms"
+description: Encrypted form submissions on Story Aeneid. Pick one of six CdrStorageProvider adapters, wire it once in your server route, and respondents never hold a wallet.
+importLine: 'import { CdrForm, CdrField, CdrSubmitButton } from "@cdr-kit/forms"'
+breadcrumb: ["@cdr-kit/forms", "Overview"]
+prev:
+  href: /docs/agent-kit/mcp
+  label: MCP server
+next:
+  href: /docs
+  label: Introduction
+---
+
+Drop `<CdrForm>` + a few `<CdrField>`s into any page; each submission gets its own CDR vault on Aeneid. Only the form creator can decrypt. Respondents never connect a wallet — gas + signature + storage upload are the server's burden (the platform-wallet pattern, extracted from [Confide](https://github.com/Blockchain-Oracle/confide)).
+
+Storage adapter selection is a developer concern: you wire one of the six `CdrStorageProvider` factories from `@cdr-kit/core` into your server route once, with credentials from env vars. The respondent UI never sees a "pick a storage backend" choice — that would be a UX smell.
+
+## Install
+
+<CodePanel code={`pnpm add @cdr-kit/forms @cdr-kit/agent @cdr-kit/core`} language="bash" />
+
+## Client quickstart
+
+<CodePanel code={`"use client";
+
+import { CdrForm, CdrField, CdrSubmitButton } from "@cdr-kit/forms";
+import "@cdr-kit/forms/styles.css";
+
+export function Survey() {
+  return (
+    <CdrForm
+      onEncrypt={async (fields) => {
+        const r = await fetch("/api/respond", {
+          method: "POST",
+          body: JSON.stringify({ fields }),
+        });
+        const { vaultId } = await r.json();
+        return vaultId;
+      }}
+      onSuccess={(uuid) => console.log("stored at vault", uuid)}
+    >
+      <CdrField name="mood" label="Mood (1–10)" type="number" required />
+      <CdrField name="highlight" label="Highlight of the week" required />
+      <CdrField name="notes" label="Anything else?" type="textarea" />
+      <CdrSubmitButton />
+    </CdrForm>
+  );
+}`} language="tsx" />
+
+`<CdrForm>` serializes every `<CdrField>` (via `FormData`) and calls your `onEncrypt` with the resulting object. It expects you to return the CDR vault UUID — that's what gets persisted in your DB so you can decrypt later.
+
+## Server quickstart
+
+The server route is where you wire your storage adapter. Here it's Pinata:
+
+<CodePanel code={`// app/api/respond/route.ts
+import { NextResponse } from "next/server";
+import { createPinataStorage } from "@cdr-kit/core";
+import { storeFormSubmission } from "@cdr-kit/forms/server";
+
+export async function POST(req: Request) {
+  const { fields } = await req.json();
+
+  const storage = createPinataStorage({
+    jwt: process.env.PINATA_JWT!,
+    gatewayUrl: process.env.PINATA_GATEWAY_URL ?? "https://gateway.pinata.cloud",
+  });
+
+  const { vaultId, cid } = await storeFormSubmission(fields, {
+    privateKey: process.env.WALLET_PRIVATE_KEY as \`0x\${string}\`,
+    storage,
+    rpcUrl: "https://aeneid.storyrpc.io",
+  });
+
+  return NextResponse.json({ vaultId, cid });
+}`} language="tsx" />
+
+To read the submission back, use the same storage adapter:
+
+<CodePanel code={`import { readFormSubmission } from "@cdr-kit/forms/server";
+
+const { fields, submittedAt } = await readFormSubmission(vaultId, {
+  privateKey: process.env.WALLET_PRIVATE_KEY,
+  storage,    // same adapter as the write
+});`} language="tsx" />
+
+## The six storage adapters
+
+`@cdr-kit/core` ships six `CdrStorageProvider` factories. Pick the one that matches your existing infra; swap by changing the factory call in your server route — no other code changes required.
+
+<PropsTable rows={[
+  { name: "createPinataStorage", type: "(opts: { jwt, gatewayUrl? }) => CdrStorageProvider", description: "Hosted IPFS pinning. Free signup at pinata.cloud. Simplest setup — one JWT env var." },
+  { name: "createSupabaseStorage", type: "(opts: { url, key, bucket }) => CdrStorageProvider", description: "Postgres-backed object storage. Best if you already use Supabase Auth/DB." },
+  { name: "createIpfsStorage", type: "(opts: { addUrl, gatewayUrl, headers? }) => CdrStorageProvider", description: "Any IPFS-compatible HTTP API (kubo, your own gateway, etc.)." },
+  { name: "createS3Storage", type: "(opts: { endpoint, region, accessKey, secretKey, bucket }) => CdrStorageProvider", description: "AWS S3, Cloudflare R2, Backblaze B2 — anything S3-compatible." },
+  { name: "createStorachaStorage", type: "(opts: { agentDelegation, spaceDid }) => CdrStorageProvider", description: "web3.storage / w3up — Filecoin-backed permanence. Needs w3up CLI for setup." },
+  { name: "createHeliaStorage", type: "(opts?: { helia? }) => CdrStorageProvider", description: "Self-hosted in-process Helia node. Good for local dev, no third-party deps." },
+]} />
+
+## `<CdrField>` types
+
+<PropsTable rows={[
+  { name: "text", type: "CdrFieldType", description: "Single-line input." },
+  { name: "textarea", type: "CdrFieldType", description: "Multi-line textarea." },
+  { name: "email", type: "CdrFieldType", description: "Email input with HTML5 validation." },
+  { name: "number", type: "CdrFieldType", description: "Number input." },
+  { name: "select", type: "CdrFieldType", description: "Dropdown — pass `options={[{value, label}]}`." },
+  { name: "radio", type: "CdrFieldType", description: "Radio group — pass `options={[{value, label}]}`." },
+  { name: "checkbox", type: "CdrFieldType", description: "Checkbox group — pass `options={[{value, label}]}`." },
+]} />
+
+## `useCdrSubmit()` (low-level)
+
+If you don't want the `<CdrForm>` wrapper, you can call `useCdrSubmit({ onEncrypt })` directly to drive your own form layout. It returns `{ submit, isLoading, error, vaultId, reset }`.
+
+<CodePanel code={`import { useCdrSubmit } from "@cdr-kit/forms";
+
+function MyForm() {
+  const { submit, isLoading, vaultId } = useCdrSubmit({
+    onEncrypt: async (fields) => {
+      const r = await fetch("/api/respond", { method: "POST", body: JSON.stringify(fields) });
+      return (await r.json()).vaultId;
+    },
+  });
+
+  return (
+    <form onSubmit={(e) => {
+      e.preventDefault();
+      const data = Object.fromEntries(new FormData(e.currentTarget));
+      submit(data);
+    }}>
+      {/* ...your own inputs... */}
+      <button disabled={isLoading}>{vaultId ? "Submitted" : "Submit"}</button>
+    </form>
+  );
+}`} language="tsx" />
+
+## Scaffolder
+
+A working end-to-end forms app — Pinata wired, `/api/respond` + `/api/results` routes, dark premium layout — is one command away:
+
+<CodePanel code={`pnpm create cdr-kit-app my-forms --template forms`} language="bash" />
+
+The generated app's `lib/storage.ts` is the single source of truth for which adapter is wired; comments inline show how to swap to any of the other five. See [the scaffolder docs](/docs/scaffolder) for other templates.
diff --git a/apps/site/content/docs/hooks/use-access-vault.mdx b/apps/site/content/docs/hooks/use-access-vault.mdx
new file mode 100644
index 0000000..cb36252
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-access-vault.mdx
@@ -0,0 +1,31 @@
+---
+title: useAccessVault
+description: "Imperative access to one vault. Returns a discriminated status + the decrypted bytes when ready. The state machine behind <VaultGate> and <Vault>."
+importLine: 'import { useAccessVault } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useAccessVault"]
+prev:
+  href: /docs/components/empty-vaults
+  label: EmptyVaults
+next:
+  href: /docs/hooks/use-subscribe-and-access
+  label: useSubscribeAndAccess
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useAccessVault(uuid: number): {
+  access: (accessAuxData?: Hex) => Promise<Uint8Array>;
+  status: "idle" | "collecting-partials" | "ready" | "error";
+  data?: Uint8Array;
+  error?: CdrError;
+  progress?: { collected: number; threshold: number };  // mock-mode only
+};`} />
+
+## States
+
+<ul>
+  <li><code>idle</code> — initial; call <code>access()</code> to begin.</li>
+  <li><code>collecting-partials</code> — the ~15s threshold read.</li>
+  <li><code>ready</code> — <code>data</code> populated.</li>
+  <li><code>error</code> — see <code>error</code> for the typed reason.</li>
+</ul>
diff --git a/apps/site/content/docs/hooks/use-attach-license-terms.mdx b/apps/site/content/docs/hooks/use-attach-license-terms.mdx
new file mode 100644
index 0000000..bdf8fe9
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-attach-license-terms.mdx
@@ -0,0 +1,52 @@
+---
+title: useAttachLicenseTerms
+description: "Attach an existing PIL licenseTermsId to an IP asset — required before any buyer can mintLicenseTokens against it. Idempotent: calling twice with the same args is a no-op tx."
+importLine: 'import { useAttachLicenseTerms } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useAttachLicenseTerms"]
+prev:
+  href: /docs/hooks/use-mint-license-token
+  label: useMintLicenseToken
+next:
+  href: /docs/hooks/use-publish
+  label: usePublish
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useAttachLicenseTerms(client: StoryClient | undefined): {
+  attach: (params: {
+    ipId: Hex;
+    licenseTermsId: bigint;
+    licenseTemplate?: Hex;   // defaults to the canonical PIL template
+  }) => Promise<{ txHash: Hex }>;
+  isLoading: boolean;
+  error?: Error;
+};`} />
+
+## Example
+
+<CodePanel title="tsx" language="tsx" code={`import { useStoryClient, useAttachLicenseTerms } from "@cdr-kit/react";
+
+function AttachTerms({ ipId, licenseTermsId }) {
+  const client = useStoryClient();
+  const { attach, isLoading, error } = useAttachLicenseTerms(client);
+  return (
+    <>
+      <button
+        disabled={!client || isLoading}
+        onClick={() => attach({ ipId, licenseTermsId })}
+      >
+        {isLoading ? "attaching…" : "attach PIL terms"}
+      </button>
+      {error && <span>{error.message}</span>}
+    </>
+  );
+}`} />
+
+## Call ordering
+
+<p>The flow is: (1) <code>registerIpAsset</code> → ipId, (2) <code>registerPilTerms</code> → licenseTermsId (or use a previously registered set), (3) <code>attachLicenseTerms</code> links the two. Only then can buyers mint license tokens against your IP.</p>
+
+## License template
+
+<p><code>licenseTemplate</code> defaults to the canonical Story PIL template. Override only if you've registered a custom template at the protocol level — rare.</p>
diff --git a/apps/site/content/docs/hooks/use-cdr-wallet.mdx b/apps/site/content/docs/hooks/use-cdr-wallet.mdx
new file mode 100644
index 0000000..e39ff39
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-cdr-wallet.mdx
@@ -0,0 +1,23 @@
+---
+title: useCdrWallet
+description: "Lightweight wallet connect for the simple path: pairs with <CdrProvider>'s built-in injected connector. Bring your own wallet stack (Privy / RainbowKit) for the rich path."
+importLine: 'import { useCdrWallet } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useCdrWallet"]
+prev:
+  href: /docs/hooks/use-creator-vaults
+  label: useCreatorVaults
+next:
+  href: /docs/agent-kit
+  label: Agent kit
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useCdrWallet(): {
+  address?: Hex;
+  isConnected: boolean;
+  isConnecting: boolean;
+  error: Error | null;
+  connect: () => void;
+  disconnect: () => void;
+};`} />
diff --git a/apps/site/content/docs/hooks/use-create-vault.mdx b/apps/site/content/docs/hooks/use-create-vault.mdx
new file mode 100644
index 0000000..33b7609
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-create-vault.mdx
@@ -0,0 +1,25 @@
+---
+title: useCreateVault
+description: "Seller-side: call the CdrKitVault factory to mint the NFT, register the IP asset, allocate the CDR slot, and configure the read condition — in one transaction."
+importLine: 'import { useCreateVault } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useCreateVault"]
+prev:
+  href: /docs/hooks/use-subscribe-and-access
+  label: useSubscribeAndAccess
+next:
+  href: /docs/hooks/use-discover-vaults
+  label: useDiscoverVaults
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useCreateVault(): (params: {
+  readConditionAddr: Hex;
+  readConfig: Hex;
+  childConditions?: Hex[];
+  childConfigs?: Hex[];
+  licenseTermsId?: bigint;
+  value?: bigint;
+  gas?: bigint;
+  vault?: Hex;
+}) => Promise<Hash>;`} />
diff --git a/apps/site/content/docs/hooks/use-creator-vaults.mdx b/apps/site/content/docs/hooks/use-creator-vaults.mdx
new file mode 100644
index 0000000..4c1897d
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-creator-vaults.mdx
@@ -0,0 +1,21 @@
+---
+title: useCreatorVaults
+description: "Returns the token ids owned by a given creator address — wraps the factory's getCreatorVaults(address). Standard wagmi useReadContract result shape."
+importLine: 'import { useCreatorVaults } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useCreatorVaults"]
+prev:
+  href: /docs/hooks/use-vault-events
+  label: useVaultEvents
+next:
+  href: /docs/hooks/use-cdr-wallet
+  label: useCdrWallet
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useCreatorVaults(creator?: Hex): {
+  data?: readonly bigint[];
+  isLoading: boolean;
+  error?: Error;
+  // …plus the rest of wagmi's useReadContract return
+};`} />
diff --git a/apps/site/content/docs/hooks/use-dead-man-timer.mdx b/apps/site/content/docs/hooks/use-dead-man-timer.mdx
new file mode 100644
index 0000000..60b2b4d
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-dead-man-timer.mdx
@@ -0,0 +1,29 @@
+---
+title: useDeadManTimer
+description: "Live countdown to DeadManSwitchCondition.unlockAt + a creator-only poke() action. The data source for <HeartbeatTimer>."
+importLine: 'import { useDeadManTimer } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useDeadManTimer"]
+prev:
+  href: /docs/hooks/use-cdr-wallet
+  label: useCdrWallet
+next:
+  href: /docs/hooks/use-time-window-state
+  label: useTimeWindowState
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useDeadManTimer(uuid: number, address?: Hex): {
+  unlocksAt?: bigint;
+  duration?: bigint;
+  blockBased?: boolean;
+  remainingMs: number;
+  isUnlocked: boolean;
+  isCritical: boolean;   // < 25% of duration left
+  poke: () => Promise<Hex>;
+  isLoading: boolean;
+};`} />
+
+## Address override
+
+<p>The default reads from <code>aeneid.deadManSwitchCondition</code>. Pass <code>address</code> to point at a custom deployment (e.g. mainnet once it ships).</p>
diff --git a/apps/site/content/docs/hooks/use-discover-vaults.mdx b/apps/site/content/docs/hooks/use-discover-vaults.mdx
new file mode 100644
index 0000000..9a957d2
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-discover-vaults.mdx
@@ -0,0 +1,23 @@
+---
+title: useDiscoverVaults
+description: "One-shot historical scan of the factory's VaultCreated events. Paginates inside a bounded RPC window. For live feeds, pair with useVaultEvents."
+importLine: 'import { useDiscoverVaults } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useDiscoverVaults"]
+prev:
+  href: /docs/hooks/use-create-vault
+  label: useCreateVault
+next:
+  href: /docs/hooks/use-vault
+  label: useVault
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useDiscoverVaults(opts?: {
+  fromBlock?: bigint;
+  enabled?: boolean;  // skip the scan entirely (mock mode)
+}): {
+  vaults: VaultCreatedEvent[];
+  isLoading: boolean;
+  error?: Error;
+};`} />
diff --git a/apps/site/content/docs/hooks/use-escrow-state.mdx b/apps/site/content/docs/hooks/use-escrow-state.mdx
new file mode 100644
index 0000000..4ce7cd0
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-escrow-state.mdx
@@ -0,0 +1,28 @@
+---
+title: useEscrowState
+description: "The buyer-side state machine for ConditionalEscrowCondition: listing + paid status + delivery + timeout countdown, plus the two write actions (pay, confirmDelivery)."
+importLine: 'import { useEscrowState } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useEscrowState"]
+prev:
+  href: /docs/hooks/use-multi-sig-status
+  label: useMultiSigStatus
+next:
+  href: /docs/hooks/use-storage-backend
+  label: useStorageBackend
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useEscrowState(uuid: number, buyer: Hex | undefined, address?: Hex): {
+  seller?: Hex;
+  price?: bigint;
+  timeoutSecs?: bigint;
+  arbiter?: Hex;
+  paidAt: bigint;       // 0 = unpaid
+  delivered: boolean;
+  timeoutAt?: bigint;
+  timeoutInMs: number;
+  pay: () => Promise<Hex>;
+  confirmDelivery: () => Promise<Hex>;
+  isLoading: boolean;
+};`} />
diff --git a/apps/site/content/docs/hooks/use-mint-license-token.mdx b/apps/site/content/docs/hooks/use-mint-license-token.mdx
new file mode 100644
index 0000000..2864ac2
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-mint-license-token.mdx
@@ -0,0 +1,60 @@
+---
+title: useMintLicenseToken
+description: "Buyer-side helper: mint Story license token(s) against an IP's licenseTermsId. For commercial flavors the mint is the payment — the fee flows from the buyer's wallet via WIP."
+importLine: 'import { useMintLicenseToken } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useMintLicenseToken"]
+prev:
+  href: /docs/hooks/use-register-ip
+  label: useRegisterIp
+next:
+  href: /docs/hooks/use-attach-license-terms
+  label: useAttachLicenseTerms
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useMintLicenseToken(client: StoryClient | undefined): {
+  mint: (params: {
+    licensorIpId: Hex;
+    licenseTermsId: bigint;
+    amount?: bigint;          // default 1n
+    receiver?: Hex;           // default connected wallet
+    maxMintingFee?: bigint;   // default 0n (be careful with commercial flavors!)
+  }) => Promise<{ licenseTokenIds: bigint[]; txHash: Hex }>;
+  isLoading: boolean;
+  error?: Error;
+};`} />
+
+## Example
+
+<CodePanel title="tsx" language="tsx" code={`import { useStoryClient, useMintLicenseToken } from "@cdr-kit/react";
+
+function BuyAccess({ ipId, licenseTermsId, priceWei }) {
+  const client = useStoryClient();
+  const { mint, isLoading } = useMintLicenseToken(client);
+  return (
+    <button
+      disabled={!client || isLoading}
+      onClick={async () => {
+        const { licenseTokenIds } = await mint({
+          licensorIpId: ipId,
+          licenseTermsId,
+          amount: 1n,
+          maxMintingFee: priceWei,  // cap exposure if seller changes price mid-tx
+        });
+        // licenseTokenIds[0] is the buyer's proof — pass as accessAuxData to read
+        // a license-gated CDR vault via agent.accessLicenseGated(...).
+      }}
+    >
+      {isLoading ? "minting…" : \`Buy license (\${priceWei} wei)\`}
+    </button>
+  );
+}`} />
+
+## WIP wrap + approval
+
+<p>Commercial PIL flavors charge in WIP (the ERC-20 wrap of native IP). Before <code>mint</code> succeeds, the buyer wallet needs (1) enough WIP to cover the fee × amount and (2) an allowance for the RoyaltyModule. Call <code>agent.wrapIp</code> + <code>agent.approveWip</code> in the buyer flow, or wire matching hooks if you build them in your dashboard.</p>
+
+## Always set maxMintingFee
+
+<p>Default <code>maxMintingFee</code> is <code>0n</code> — which means commercial mints will revert! Pass the buyer-facing price you displayed in the UI to cap the exposure if the seller changes the fee mid-tx.</p>
diff --git a/apps/site/content/docs/hooks/use-multi-sig-status.mdx b/apps/site/content/docs/hooks/use-multi-sig-status.mdx
new file mode 100644
index 0000000..775f6cd
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-multi-sig-status.mdx
@@ -0,0 +1,21 @@
+---
+title: useMultiSigStatus
+description: "Reads the configured signers + threshold + epoch for a MultiSigCondition vault. Sigs themselves live off-chain — combine this with your own collection state to render approval progress."
+importLine: 'import { useMultiSigStatus } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useMultiSigStatus"]
+prev:
+  href: /docs/hooks/use-time-window-state
+  label: useTimeWindowState
+next:
+  href: /docs/hooks/use-escrow-state
+  label: useEscrowState
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useMultiSigStatus(uuid: number, address?: Hex): {
+  signers: readonly Hex[];
+  threshold: number;
+  epoch: bigint;
+  isLoading: boolean;
+};`} />
diff --git a/apps/site/content/docs/hooks/use-publish.mdx b/apps/site/content/docs/hooks/use-publish.mdx
new file mode 100644
index 0000000..0754bb8
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-publish.mdx
@@ -0,0 +1,93 @@
+---
+title: usePublish
+description: "Render-side wrapper for agent.publish() — the agent-as-publisher one-shot that collapses register-IP + register-PIL-terms + attach-terms + create-license-gated-vault + write-encrypted-data into a single call."
+importLine: 'import { usePublish } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "usePublish"]
+prev:
+  href: /docs/hooks/use-attach-license-terms
+  label: useAttachLicenseTerms
+next:
+  href: /docs/storage
+  label: Storage adapters
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function usePublish(): {
+  publish: (
+    agent: { publish: (p: PublishParams) => Promise<PublishResult> },
+    params: PublishParams,
+  ) => Promise<PublishResult>;
+  isLoading: boolean;
+  error?: Error;
+  result?: PublishResult;
+};
+
+interface PublishParams {
+  data: Uint8Array;
+  spgNftContract: Hex;
+  pilTerms: unknown;        // PILFlavor.commercialUse({...}) etc.
+  ipMetadata?: { ipMetadataURI?: string; ipMetadataHash?: Hex; nftMetadataURI?: string; nftMetadataHash?: Hex; };
+}
+
+interface PublishResult {
+  ipId: Hex;
+  tokenId: bigint;
+  licenseTermsId: bigint;
+  vaultUuid: number;
+  vaultTxHash: Hex;
+  ipRegisterTxHash: Hex;
+  writeTxHash: Hex;
+}`} />
+
+## Example
+
+<CodePanel title="tsx" language="tsx" code={`import { CdrAgent } from "@cdr-kit/agent";
+import { PILFlavor } from "@cdr-kit/story";
+import { usePublish } from "@cdr-kit/react";
+import { useAccount, useWalletClient } from "wagmi";
+
+function PublishButton({ secret }: { secret: string }) {
+  const { data: walletClient } = useWalletClient();
+  const { publish, isLoading, result, error } = usePublish();
+
+  const onClick = async () => {
+    if (!walletClient) return;
+    const agent = new CdrAgent({
+      privateKey: "0x...", // server-side; in browser, pass walletClient.account
+      network: "aeneid",
+    });
+    await publish(agent, {
+      data: new TextEncoder().encode(secret),
+      spgNftContract: "0xYourSpgCollection",
+      pilTerms: PILFlavor.commercialUse({
+        defaultMintingFee: 1_000_000_000_000_000_000n,
+        commercialRevShare: 5,
+      }),
+    });
+  };
+
+  return (
+    <>
+      <button disabled={isLoading} onClick={onClick}>
+        {isLoading ? "publishing…" : "publish + license-gate"}
+      </button>
+      {result && (
+        <pre>
+{\`ipId:          \${result.ipId}
+licenseTermsId: \${result.licenseTermsId}
+vaultUuid:      \${result.vaultUuid}\`}
+        </pre>
+      )}
+      {error && <span>{error.message}</span>}
+    </>
+  );
+}`} />
+
+## Why does it take an `agent` argument?
+
+<p><code>agent.publish()</code> needs a wallet client + private key for the multi-step orchestration (4 contract writes across IP-registry, PIL-template, CDR-precompile). The React hook stays headless — you construct the <code>CdrAgent</code> however your app does (server-side env, browser RPC over the connected wallet) and the hook handles loading/error/result state around it.</p>
+
+## Buyer flow
+
+<p>After <code>publish</code> resolves, share <code>{`{ ipId, licenseTermsId, vaultUuid }`}</code> with the buyer (URL param, QR, on-chain event). They call <code>agent.wrapIp</code> → <code>agent.approveWip</code> → <code>useMintLicenseToken.mint</code> → <code>agent.accessLicenseGated</code> to pay + decrypt. See <a href="/docs/story#buyer">/docs/story</a> for the full buyer code.</p>
diff --git a/apps/site/content/docs/hooks/use-register-ip.mdx b/apps/site/content/docs/hooks/use-register-ip.mdx
new file mode 100644
index 0000000..b30cdfc
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-register-ip.mdx
@@ -0,0 +1,52 @@
+---
+title: useRegisterIp
+description: "Mint a fresh NFT (via your SPG collection) and register it as a Story IP asset in a single tx. Pair with useAttachLicenseTerms to make the IP licensable."
+importLine: 'import { useRegisterIp } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useRegisterIp"]
+prev:
+  href: /docs/hooks/use-story-client
+  label: useStoryClient
+next:
+  href: /docs/hooks/use-mint-license-token
+  label: useMintLicenseToken
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useRegisterIp(client: StoryClient | undefined): {
+  registerIp: (params: {
+    spgNftContract: Hex;
+    recipient?: Hex;
+    ipMetadataURI?: string;
+    ipMetadataHash?: Hex;
+  }) => Promise<{ ipId: Hex; tokenId: bigint; txHash: Hex }>;
+  isLoading: boolean;
+  error?: Error;
+};`} />
+
+## Example
+
+<CodePanel title="tsx" language="tsx" code={`import { useStoryClient, useRegisterIp } from "@cdr-kit/react";
+
+function RegisterButton() {
+  const client = useStoryClient();
+  const { registerIp, isLoading, error } = useRegisterIp(client);
+  return (
+    <button
+      disabled={!client || isLoading}
+      onClick={async () => {
+        const { ipId, tokenId } = await registerIp({
+          spgNftContract: "0xYourSpgCollection",
+          ipMetadataURI: "ipfs://bafy...",
+        });
+        console.log("registered IP", ipId, "tokenId", tokenId);
+      }}
+    >
+      {isLoading ? "registering…" : "register IP"}
+    </button>
+  );
+}`} />
+
+## Prerequisites
+
+<p>You need an existing SPG NFT collection. Create one via Story's registration workflows (<code>registrationWorkflows.createCollection</code>) or use a previously deployed collection address. The connected wallet must be allowed to mint into it.</p>
diff --git a/apps/site/content/docs/hooks/use-storage-backend.mdx b/apps/site/content/docs/hooks/use-storage-backend.mdx
new file mode 100644
index 0000000..a7a8974
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-storage-backend.mdx
@@ -0,0 +1,29 @@
+---
+title: useStorageBackend
+description: "Config-driven CdrStorageProvider factory. A dashboard switches backends at runtime by passing a JSON config (Pinata / Supabase / IPFS / read-only gateway / in-memory)."
+importLine: 'import { useStorageBackend } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useStorageBackend"]
+prev:
+  href: /docs/hooks/use-escrow-state
+  label: useEscrowState
+next:
+  href: /docs/contracts
+  label: Condition library
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`type StorageBackendConfig =
+  | { kind: "memory" }
+  | { kind: "pinata"; jwt: string; gatewayUrl?: string }
+  | { kind: "supabase"; supabaseUrl: string; key: string; bucket: string;
+      pathPrefix?: string; bucketIsPublic?: boolean }
+  | { kind: "gateway"; gatewayUrl: string }
+  | { kind: "ipfs"; addUrl: string; gatewayUrl: string;
+      headers?: Record<string, string> };
+
+function useStorageBackend(config: StorageBackendConfig | undefined): CdrStorageProvider | undefined;`} />
+
+## Memoization
+
+<p>The provider instance is memoized on <code>config</code> identity. Pass a stable config object (typically from your environment variables, not a fresh literal every render).</p>
diff --git a/apps/site/content/docs/hooks/use-story-client.mdx b/apps/site/content/docs/hooks/use-story-client.mdx
new file mode 100644
index 0000000..5c99f68
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-story-client.mdx
@@ -0,0 +1,36 @@
+---
+title: useStoryClient
+description: "Lazy-load and memoize a StoryClient from @story-protocol/core-sdk bound to the connected wagmi wallet. Returns undefined until the wallet connects and the lazy import resolves."
+importLine: 'import { useStoryClient } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useStoryClient"]
+prev:
+  href: /docs/hooks/use-storage-backend
+  label: useStorageBackend
+next:
+  href: /docs/hooks/use-register-ip
+  label: useRegisterIp
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useStoryClient(chainId?: number): StoryClient | undefined;`} />
+
+## Example
+
+<CodePanel title="tsx" language="tsx" code={`import { useStoryClient } from "@cdr-kit/react";
+
+function Publish() {
+  const client = useStoryClient();              // bound to the connected wagmi wallet
+  if (!client) return <p>connect a wallet to publish</p>;
+  // client is the StoryClient from @story-protocol/core-sdk —
+  // pass it to useRegisterIp, useMintLicenseToken, etc.
+  return <RegisterButton client={client} />;
+}`} />
+
+## Lazy-loaded peer dep
+
+<p><code>@cdr-kit/story</code> is an optional peer dep on <code>@cdr-kit/react</code> — the hook does a dynamic <code>import("@cdr-kit/story")</code> on first call, so dashboards that never publish IP don't pay the bundle cost. If the peer dep isn't installed, the hook throws with a clear install hint.</p>
+
+## Custom chain
+
+<p>The default <code>chainId</code> is 1315 (Story Aeneid). Pass an explicit value to bind the client to a different chain (e.g. Story mainnet once it ships).</p>
diff --git a/apps/site/content/docs/hooks/use-subscribe-and-access.mdx b/apps/site/content/docs/hooks/use-subscribe-and-access.mdx
new file mode 100644
index 0000000..6ce7000
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-subscribe-and-access.mdx
@@ -0,0 +1,28 @@
+---
+title: useSubscribeAndAccess
+description: "The full 2-step flow — pay (real subscribe tx) then access (threshold read). Five status values; design the paying and collecting-partials states legibly."
+importLine: 'import { useSubscribeAndAccess } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useSubscribeAndAccess"]
+prev:
+  href: /docs/hooks/use-access-vault
+  label: useAccessVault
+next:
+  href: /docs/hooks/use-create-vault
+  label: useCreateVault
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useSubscribeAndAccess(
+  uuid: number,
+  subscriptionCondition?: Hex,
+): {
+  run: (p: {
+    periods: bigint;
+    maxPricePerPeriod: bigint;
+    value: bigint;
+    accessAuxData?: Hex;
+  }) => Promise<Uint8Array>;
+  status: "idle" | "paying" | "collecting-partials" | "ready" | "error";
+  data?: Uint8Array;
+};`} />
diff --git a/apps/site/content/docs/hooks/use-time-window-state.mdx b/apps/site/content/docs/hooks/use-time-window-state.mdx
new file mode 100644
index 0000000..35a1bd0
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-time-window-state.mdx
@@ -0,0 +1,28 @@
+---
+title: useTimeWindowState
+description: "Reads a TimeWindowCondition vault's [startTs, endTs] window + ticks a 1-second client-side timer to surface opensInMs/closesInMs."
+importLine: 'import { useTimeWindowState } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useTimeWindowState"]
+prev:
+  href: /docs/hooks/use-dead-man-timer
+  label: useDeadManTimer
+next:
+  href: /docs/hooks/use-multi-sig-status
+  label: useMultiSigStatus
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useTimeWindowState(uuid: number, address?: Hex): {
+  startTs?: bigint;
+  endTs?: bigint;      // 0 = open-ended after startTs
+  blockBased?: boolean;
+  isOpen: boolean;
+  opensInMs: number;    // 0 if already open or unconfigured
+  closesInMs: number;   // 0 if open-ended or already closed
+  isLoading: boolean;
+};`} />
+
+## Block-based windows
+
+<p>For <code>blockBased: true</code> windows, <code>opensInMs</code>/<code>closesInMs</code> return <code>0</code> — <code>block.number</code> isn't ticked client-side. Read the raw block bounds from the result object.</p>
diff --git a/apps/site/content/docs/hooks/use-vault-events.mdx b/apps/site/content/docs/hooks/use-vault-events.mdx
new file mode 100644
index 0000000..4fe6bbf
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-vault-events.mdx
@@ -0,0 +1,21 @@
+---
+title: useVaultEvents
+description: "Live subscription to VaultCreated events on the factory. Returns events accumulated since mount — pair with useDiscoverVaults for backfill + live."
+importLine: 'import { useVaultEvents } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useVaultEvents"]
+prev:
+  href: /docs/hooks/use-vault
+  label: useVault
+next:
+  href: /docs/hooks/use-creator-vaults
+  label: useCreatorVaults
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useVaultEvents(): {
+  tokenId: bigint;
+  uuid: number;
+  ipId: Hex;
+  creator: Hex;
+}[];`} />
diff --git a/apps/site/content/docs/hooks/use-vault.mdx b/apps/site/content/docs/hooks/use-vault.mdx
new file mode 100644
index 0000000..4117b45
--- /dev/null
+++ b/apps/site/content/docs/hooks/use-vault.mdx
@@ -0,0 +1,21 @@
+---
+title: useVault
+description: "Resolve a vault's on-chain metadata from its uuid via the CdrKitVault factory (token id, IP id, creator, license terms id)."
+importLine: 'import { useVault } from "@cdr-kit/react"'
+breadcrumb: ["@cdr-kit/react", "Hooks", "useVault"]
+prev:
+  href: /docs/hooks/use-discover-vaults
+  label: useDiscoverVaults
+next:
+  href: /docs/hooks/use-vault-events
+  label: useVaultEvents
+---
+
+## Signature
+
+<CodePanel title="type" language="ts" code={`function useVault(uuid: number): {
+  tokenId?: bigint;
+  info?: { /* factory getVaultInfo struct */ };
+  isLoading: boolean;
+  error?: Error;
+};`} />
diff --git a/apps/site/content/docs/index.mdx b/apps/site/content/docs/index.mdx
new file mode 100644
index 0000000..cacc2d6
--- /dev/null
+++ b/apps/site/content/docs/index.mdx
@@ -0,0 +1,35 @@
+---
+title: Introduction
+description: cdr-kit is the developer toolkit for Story Protocol's Confidential Data Rails — the wagmi-style layer that makes it possible to ship private, paid, license-gated data on Story without hand-writing Solidity, hand-rolling encryption flows, or wiring IP licensing primitives by hand.
+breadcrumb: ["@cdr-kit", "Getting started", "Introduction"]
+next:
+  href: /docs/quickstart
+  label: Quickstart
+---
+
+## What's in the kit
+
+<p>15 packages, MIT-licensed, all published to <a href="https://www.npmjs.com/org/cdr-kit" target="_blank" rel="noopener noreferrer">npmjs.com/org/cdr-kit</a> at v0.5.0:</p>
+
+<ul>
+  <li><a href="/docs/components/vault-gate"><code>@cdr-kit/react</code></a> — components + hooks + theming (5 new 0.5 components, 7 new hooks)</li>
+  <li><code>@cdr-kit/react-ui</code> — styled drop-ins built on the headless layer</li>
+  <li><a href="/docs/components/cdr-provider"><code>@cdr-kit/core</code></a> — typed SDK (condition encoders, 2-step flows, 8 storage adapters, mock kit, WASM init)</li>
+  <li><a href="/docs/contracts"><code>@cdr-kit/contracts</code></a> — Solidity ABIs + deployed addresses for 9 conditions (5 base + 4 advanced in 0.5)</li>
+  <li><a href="/docs/agent-kit"><code>@cdr-kit/agent</code></a> — autonomous-agent client (discover → subscribe → access; +12 advanced helpers in 0.5)</li>
+  <li><a href="/docs/story"><code>@cdr-kit/story</code></a> — Story IP creator surface (NEW in 0.5): registerIpAsset / PIL flavors / mintLicenseTokens</li>
+  <li><code>@cdr-kit/tools</code> — framework-agnostic tool definitions (34 tools)</li>
+  <li>Framework adapters: <a href="/docs/agent-kit/vercel-ai"><code>@cdr-kit/vercel-ai</code></a> · <a href="/docs/agent-kit/openai"><code>@cdr-kit/openai</code></a> · <a href="/docs/agent-kit/langchain"><code>@cdr-kit/langchain</code></a> · <a href="/docs/agent-kit/agentkit"><code>@cdr-kit/agentkit</code></a> · <a href="/docs/agent-kit/goat"><code>@cdr-kit/goat</code></a></li>
+  <li><a href="/docs/agent-kit/mcp"><code>@cdr-kit/mcp</code></a> — the MCP server (Claude Desktop / Cursor / Windsurf / OpenClaw)</li>
+  <li><a href="/docs/cli"><code>@cdr-kit/cli</code></a> — the <span className="mono">cdr</span> binary (25 commands across vault / multi-sig / escrow / IP)</li>
+  <li><a href="/docs/scaffolder"><code>create-cdr-kit-app</code></a> — the scaffolder</li>
+</ul>
+
+## Where to start
+
+<ul>
+  <li><a href="/docs/quickstart">Quickstart</a> — install, gate encrypted data in under 60s.</li>
+  <li><a href="/docs/components/vault-gate">VaultGate component</a> — the canonical drop-in.</li>
+  <li><a href="/docs/agent-kit">Agent kit overview</a> — autonomous agents that buy data.</li>
+  <li><a href="/docs/contracts">Condition library</a> — the Solidity standard library.</li>
+</ul>
diff --git a/apps/site/content/docs/quickstart.mdx b/apps/site/content/docs/quickstart.mdx
new file mode 100644
index 0000000..96a5f35
--- /dev/null
+++ b/apps/site/content/docs/quickstart.mdx
@@ -0,0 +1,48 @@
+---
+title: Quickstart
+description: Install the React layer, wrap your app in a provider, drop in a VaultGate. That's it.
+breadcrumb: ["@cdr-kit", "Getting started", "Quickstart"]
+prev:
+  href: /docs
+  label: Introduction
+next:
+  href: /docs/theming
+  label: Theming
+---
+
+## Install
+
+<CodePanel title="terminal" language="bash" code="$ pnpm add @cdr-kit/react @cdr-kit/core wagmi viem" />
+
+## Wrap in &lt;CdrProvider&gt;
+
+<p><code>&lt;CdrProvider&gt;</code> wires <code>WagmiProvider</code>, react-query, and initializes the CDR crypto WASM. Pass <code>config</code> + <code>apiUrl</code> for live mode, or <code>mockKit</code> for offline dev.</p>
+
+<CodePanel title="App.tsx" code={`import { CdrProvider } from "@cdr-kit/react";
+import { wagmiConfig } from "./wagmi";
+
+export function App({ children }) {
+  return (
+    <CdrProvider config={wagmiConfig} apiUrl={process.env.NEXT_PUBLIC_CDR_API_URL!}>
+      {children}
+    </CdrProvider>
+  );
+}`} />
+
+## Gate your data
+
+<p><code>&lt;VaultGate&gt;</code> checks the on-chain condition, collects key shares, and hands you the decrypted bytes. Pass a fallback for the "not yet entitled" state.</p>
+
+<CodePanel title="SignalCard.tsx" code={`import { VaultGate } from "@cdr-kit/react";
+
+export function SignalCard() {
+  return (
+    <VaultGate uuid={4200} auto fallback={<SubscribeButton />}>
+      {(data) => <pre>{new TextDecoder().decode(data)}</pre>}
+    </VaultGate>
+  );
+}`} />
+
+## Or scaffold a starter
+
+<CodePanel title="terminal" language="bash" code="$ npm create cdr-kit" />
diff --git a/apps/site/content/docs/scaffolder.mdx b/apps/site/content/docs/scaffolder.mdx
new file mode 100644
index 0000000..2e26fa0
--- /dev/null
+++ b/apps/site/content/docs/scaffolder.mdx
@@ -0,0 +1,53 @@
+---
+title: npm create cdr-kit
+description: One command per pattern. Pick a template and you have a working consumer app running locally in under a minute. Mock CDR out of the box; swap one provider to go live on Aeneid.
+breadcrumb: ["@cdr-kit", "Scaffolder"]
+prev:
+  href: /docs/contracts/cdr-kit-vault
+  label: CdrKitVault
+---
+
+## Invoke
+
+<CodePanel title="terminal" language="bash" code={`# default = starter (Node mock-flow)
+$ npm create cdr-kit my-app
+
+# any other template via --template
+$ npm create cdr-kit my-blog -- --template blog
+$ npm create cdr-kit my-paywall -- --template paywall
+$ npm create cdr-kit my-mcp -- --template mcp-server`} />
+
+## UI templates
+
+<p><b>blog</b> — Next.js 16 + React 19 + <code>@cdr-kit/react-ui</code>. Three inline <code>&lt;UnlockablePill&gt;</code>s on a real-looking blog post. The onscroll.app pattern. <i>Recommended first.</i></p>
+
+<p><b>paywall</b> — Next.js single-page <code>&lt;SubscribeButton&gt;</code> gating a whole content block. Classic Substack/Patreon pattern.</p>
+
+## MCP server template
+
+<p><b>mcp-server</b> — stdio Model Context Protocol server. Exposes <code>cdr_discover_vaults</code>, <code>cdr_subscribe_and_access</code>, <code>cdr_access_vault</code> to any MCP host (Claude Desktop, Cursor, Windsurf). The agent pays from its own wallet — the LLM never sees the key.</p>
+
+<p>Ships with a ready-to-paste <code>claude_desktop_config.json</code>.</p>
+
+## Agent templates (one per framework)
+
+<p>Each template instantiates <code>{`new CdrAgent({ privateKey, apiUrl })`}</code> and wires CDR tools into the named framework. Pick the one your stack uses; the rest of your agent logic stays untouched.</p>
+
+<p><b>agent-vercel-ai</b> — Vercel AI SDK chatbot using <code>getVercelAITools(agent)</code> with <code>generateText</code>.</p>
+
+<p><b>agent-openai</b> — Raw OpenAI / Anthropic tool-calling loop using <code>{`getOpenAITools(agent).{tools, dispatch}`}</code>.</p>
+
+<p><b>agent-langchain</b> — LangChain ReAct agent via <code>{`createReactAgent({llm, tools: getLangChainTools(agent)})`}</code>.</p>
+
+<p><b>agent-agentkit</b> — Coinbase AgentKit action provider via <code>getCdrActionProvider(agent)</code>. Compose with your wallet provider.</p>
+
+<p><b>agent-goat</b> — GOAT SDK <code>ToolBase[]</code> via <code>getGoatTools(agent)</code>.</p>
+
+## starter template
+
+<p><b>starter</b> — Two-file Node TypeScript script that runs <code>createMockCdrKit()</code> + <code>accessVault()</code> end-to-end. Good for verifying the kit works in your env or for backend-only CDR work.</p>
+
+<CodePanel title="tree" language="bash" code={`my-app/
+├── src/index.ts          # mock CDR end-to-end in ~10 lines
+├── package.json          # @cdr-kit/core@^0.3.0 + consola
+└── README.md`} />
diff --git a/apps/site/content/docs/skill.mdx b/apps/site/content/docs/skill.mdx
new file mode 100644
index 0000000..361726c
--- /dev/null
+++ b/apps/site/content/docs/skill.mdx
@@ -0,0 +1,99 @@
+---
+title: Claude Code plugin
+description: A multi-skill Claude Code plugin that teaches any agent the cdr-kit workflows. Pairs with the cdr CLI and the @cdr-kit/mcp server — three coordinated surfaces, one bundle.
+breadcrumb: ["@cdr-kit", "Plugin / Skill"]
+prev:
+  href: /docs/cli
+  label: "CLI: cdr"
+next:
+  href: /docs/contracts
+  label: Contracts
+---
+
+## Install (three paths)
+
+<CodePanel title="terminal" language="bash" code={`# 1. via the cdr CLI (recommended)
+$ npm install -g @cdr-kit/cli
+$ cdr skill install
+
+# 2. via Claude Code's plugin marketplace
+$ claude
+/plugin marketplace add Blockchain-Oracle/cdr-kit
+/plugin install cdr-kit@cdr-kit
+
+# 3. manual
+$ git clone https://github.com/Blockchain-Oracle/cdr-kit
+$ cp -r cdr-kit/packages/plugin/cdr-kit ~/.claude/skills/cdr-kit`} />
+
+## Skills (8)
+
+<table className="props">
+  <thead><tr><th>Skill</th><th>When it fires</th><th>What it teaches</th></tr></thead>
+  <tbody>
+    <tr>
+      <td><code>design-condition</code></td>
+      <td>Which CDR condition should I use for X?</td>
+      <td>Decision tree for picking among open / subscription / tier-gate / composable / license-read. Encoding cheatsheet per condition.</td>
+    </tr>
+    <tr>
+      <td><code>wire-allocate-pay-read</code></td>
+      <td>How do I create a vault and read it?</td>
+      <td>The canonical 4-step flow (creator + consumer sides). Gotchas: OOG, uuid-from-receipt, value-must-match-price.</td>
+    </tr>
+    <tr>
+      <td><code>debug-cdr-precompile</code></td>
+      <td>OOG / ReentrancySentryOOG / AlreadyConfigured / partial-collection timeout</td>
+      <td>7 failure modes with root cause + fix. Backed by the gotchas in context/research/cdr-protocol-truth.md.</td>
+    </tr>
+    <tr>
+      <td><code>audit-vault-config</code></td>
+      <td>Should I subscribe to this? / Did my deploy configure right?</td>
+      <td>4-call view-only audit. Red-flag checklist (payee mismatch, never-expiring period, missing licenseTermsId).</td>
+    </tr>
+    <tr>
+      <td><code>explain-cdr-error</code></td>
+      <td>(Any raw error message)</td>
+      <td>Lookup table from error code → root cause + fix. Maps every @piplabs/cdr-sdk error class.</td>
+    </tr>
+    <tr>
+      <td><code>design-storage-adapter</code></td>
+      <td>Which storage backend for my CDR file vault? Pinata / Supabase / R2 / Storacha?</td>
+      <td>Decision tree for picking among the 6 official adapters + 3 ecosystem packages. Wiring examples, common failure modes (CORS, RLS, CID drift).</td>
+    </tr>
+    <tr>
+      <td><code>design-multisig-condition</code></td>
+      <td>Multi-sig CDR vault / N-of-M approval / off-chain signing</td>
+      <td>N-of-M EIP-712 setup, signer rotation, sig-collection UX, caller binding, ECDSA-malleability dedupe, EIP-1271 gap.</td>
+    </tr>
+    <tr>
+      <td><code>design-deadman-switch</code></td>
+      <td>Dead-man switch / wallet recovery / leak-on-disappearance / heartbeat</td>
+      <td>Trapdoor semantics, poke() cadence, block-vs-timestamp tradeoff, heir variants, operational risk (forgotten heartbeat).</td>
+    </tr>
+  </tbody>
+</table>
+
+## Plugin layout
+
+<CodePanel title="tree" language="bash" code={`packages/plugin/cdr-kit/
+├── .claude-plugin/
+│   └── plugin.json             # plugin manifest (8 skills registered)
+├── skills/
+│   ├── design-condition/           SKILL.md
+│   ├── wire-allocate-pay-read/     SKILL.md
+│   ├── debug-cdr-precompile/       SKILL.md
+│   ├── audit-vault-config/         SKILL.md
+│   ├── explain-cdr-error/          SKILL.md
+│   ├── design-storage-adapter/     SKILL.md   # 0.5
+│   ├── design-multisig-condition/  SKILL.md   # 0.5
+│   └── design-deadman-switch/      SKILL.md   # 0.5
+├── references/
+│   ├── conditions-cheatsheet.md  # full ABI + encoding per condition
+│   └── error-catalog.md          # every CdrErrorCode + SDK mapping
+└── README.md`} />
+
+## Skill vs MCP vs CLI
+
+<p>Per the Anthropic-blessed boundary (<a href="https://www.morphllm.com/claude-code-skills-mcp-plugins" target="_blank" rel="noreferrer">guide</a>): <b>MCP</b> = let Claude <i>access</i> external systems; <b>Skill</b> = let Claude <i>know how</i> to do something; <b>CLI</b> = the same operations exposed for a human in the terminal.</p>
+
+<p>cdr-kit ships all three from one shared core: the 21 CDR operations are MCP tools in <code>@cdr-kit/mcp</code>; this plugin's 8 SKILL.mds teach Claude the procedural knowledge for designing, wiring, and debugging around those tools; <code>cdr</code> exposes the same surface for terminal use.</p>
diff --git a/apps/site/content/docs/storage.mdx b/apps/site/content/docs/storage.mdx
new file mode 100644
index 0000000..13d828e
--- /dev/null
+++ b/apps/site/content/docs/storage.mdx
@@ -0,0 +1,138 @@
+---
+title: Storage adapters
+description: CDR vaults route payloads by size. Pick a CdrStorageProvider — 8 ship in @cdr-kit/core (5 core + 3 ecosystem). All speak the same upload/download 2-method interface.
+importLine: 'import { createPinataStorage, createSupabaseStorage, /* ... */ } from "@cdr-kit/core"'
+breadcrumb: ["@cdr-kit/core", "Storage adapters"]
+prev:
+  href: /docs/hooks/use-storage-backend
+  label: useStorageBackend
+next:
+  href: /docs/contracts
+  label: Condition library
+---
+
+## Pick the right adapter
+
+<ul>
+  <li><b>Buyer-only / dashboards</b> → <code>createReadOnlyGatewayStorage</code> (no pin creds needed, throws on upload).</li>
+  <li><b>Hosted IPFS pinning</b> → <code>createPinataStorage</code> (JWT, default Pinata gateway).</li>
+  <li><b>Already-have-Supabase shops</b> → <code>createSupabaseStorage</code> (bucket + service-role key, bare REST — no <code>@supabase/supabase-js</code> dep).</li>
+  <li><b>Self-hosted Kubo / custom pinner</b> → <code>createIpfsStorage</code> (multipart POST + JSON CID response).</li>
+  <li><b>AWS S3 / R2 / MinIO</b> → <code>createS3Storage</code> (signed-URL downloads, lazy-loads <code>@aws-sdk/client-s3</code>).</li>
+  <li><b>UCAN-backed pinning</b> → <code>createStorachaStorage</code> (peer-dep <code>@web3-storage/w3up-client</code>).</li>
+  <li><b>Browser-embedded IPFS</b> → <code>createHeliaStorage</code> (peer-dep <code>helia</code>, user is the node).</li>
+  <li><b>Tests / CI</b> → <code>createMemoryStorage</code> (content-addressed, real CIDv1).</li>
+</ul>
+
+## createPinataStorage
+
+<CodePanel title="ts" language="ts" code={`import { createPinataStorage, uploadFile } from "@cdr-kit/core";
+
+const storage = createPinataStorage({ jwt: process.env.PINATA_JWT! });
+const { uuid, cid, txHashes } = await uploadFile(client, {
+  content: fileBytes,
+  storage,
+  readConditionAddr,
+  readConditionData,
+});`} />
+
+## createSupabaseStorage
+
+<CodePanel title="ts" language="ts" code={`import { createSupabaseStorage } from "@cdr-kit/core";
+
+const storage = createSupabaseStorage({
+  supabaseUrl: process.env.SUPABASE_URL!,
+  key: process.env.SUPABASE_SERVICE_ROLE_KEY!,
+  bucket: "cdr-secrets",
+  pathPrefix: "vaults/",       // optional, default "cdr/"
+  bucketIsPublic: false,        // download uses /authenticated/ when private
+});`} />
+
+<p>The "CID" is the bucket-relative path the object was uploaded to. Supabase doesn't speak IPFS, but <code>CdrStorageProvider</code> only requires a string round-trip handle.</p>
+
+## createReadOnlyGatewayStorage
+
+<CodePanel title="ts" language="ts" code={`import { createReadOnlyGatewayStorage, downloadFile } from "@cdr-kit/core";
+
+// Buyer-side: read from any public IPFS gateway. Throws on upload() — by design.
+const storage = createReadOnlyGatewayStorage({ gatewayUrl: "https://gateway.pinata.cloud" });
+const { content } = await downloadFile(client, { uuid, storage });`} />
+
+<p>For dashboards that consume but never produce. Pair with a seller using <code>createPinataStorage</code> (or any IPFS pinner) on the write side.</p>
+
+## createIpfsStorage
+
+<CodePanel title="ts" language="ts" code={`import { createIpfsStorage } from "@cdr-kit/core";
+
+// Self-hosted Kubo, or any pinning service with a multipart POST + JSON CID response.
+const storage = createIpfsStorage({
+  addUrl: "http://kubo:5001/api/v0/add",
+  gatewayUrl: "http://kubo:8080",
+  headers: { Authorization: "Bearer ..." },
+});`} />
+
+## createMemoryStorage
+
+<CodePanel title="ts" language="ts" code={`import { createMemoryStorage } from "@cdr-kit/core";
+
+// Unit tests, CI, mocks. Content-addressed, returns a real CIDv1.
+const storage = createMemoryStorage();`} />
+
+## Inline cap + routing
+
+<p>CDR sizes payloads at write time. The hard cap comes from the on-chain <code>CDR.maxEncryptedDataSize()</code> (currently ≈ 1 KB after TDH2 overhead). <code>getInlineLimit(client)</code> reads it once + caches; <code>shouldUseFile(content, limit)</code> picks the routing.</p>
+
+<CodePanel title="ts" language="ts" code={`import { shouldUseFile, getInlineLimit } from "@cdr-kit/core";
+
+const limit = await getInlineLimit(client);   // reads CDR.maxEncryptedDataSize() once + caches
+if (shouldUseFile(content, limit)) {
+  await uploadFile(client, { content, storage, readConditionAddr, readConditionData });
+} else {
+  await writeVaultData(client, { uuid, dataKey: content });
+}`} />
+
+## createS3Storage
+
+<p>Works against AWS S3, Cloudflare R2, or any S3-compatible store. The SDK is loaded lazily via dynamic import so non-S3 deployments don't pay the bundle cost. Install <code>@aws-sdk/client-s3</code> yourself in your project.</p>
+
+<CodePanel title="ts" language="ts" code={`import { createS3Storage } from "@cdr-kit/core";
+
+// Works against AWS S3, Cloudflare R2, MinIO, or any S3-compatible store.
+// Lazy-loads @aws-sdk/client-s3 via dynamic import — install it yourself.
+const storage = await createS3Storage({
+  bucket: "cdr-secrets",
+  region: "auto",                                     // R2: "auto"; AWS: "us-east-1" etc.
+  endpoint: "https://<acct>.r2.cloudflarestorage.com", // omit for AWS
+  accessKeyId: process.env.S3_ACCESS_KEY_ID!,
+  secretAccessKey: process.env.S3_SECRET_ACCESS_KEY!,
+  publicUrlBase: "https://<acct>.r2.dev/cdr-secrets",  // for browser-readable downloads
+  prefix: "cdr/",
+});`} />
+
+## createStorachaStorage
+
+<p>UCAN-backed pinning service. Lazy-loads <code>@web3-storage/w3up-client</code>; install it yourself. The agent address must be authorized for the Space via a base64 UCAN proof.</p>
+
+<CodePanel title="ts" language="ts" code={`import { createStorachaStorage } from "@cdr-kit/core";
+
+// Storacha-server (UCAN-backed pinning over @web3-storage/w3up-client).
+// Install: pnpm add @web3-storage/w3up-client
+const storage = await createStorachaStorage({
+  key: process.env.STORACHA_KEY!,
+  spaceDid: process.env.STORACHA_SPACE_DID!,
+  proof: process.env.STORACHA_PROOF!,    // base64 UCAN delegation
+  gatewayUrl: "https://w3s.link",         // optional, default w3s.link
+});`} />
+
+## createHeliaStorage
+
+<p>Browser-side embedded IPFS. The user's tab IS the IPFS node — no remote pinner needed. Lazy-loads <code>helia</code> + <code>@helia/unixfs</code>. Pin <code>@peculiar/webcrypto: 1.7.0</code> in <code>pnpm.overrides</code> (Helia's WASM init is sensitive to webcrypto version drift).</p>
+
+<CodePanel title="ts" language="ts" code={`import { createHeliaStorage } from "@cdr-kit/core";
+
+// Browser-side embedded IPFS via Helia — no remote pinner, the user is the node.
+// Install: pnpm add helia @helia/unixfs
+// Pin @peculiar/webcrypto: 1.7.0 in pnpm.overrides (Helia's wasm setup is fragile).
+const storage = await createHeliaStorage({
+  gatewayUrl: "https://ipfs.io",  // optional, only used by downloadFile if user is offline
+});`} />
diff --git a/apps/site/content/docs/story.mdx b/apps/site/content/docs/story.mdx
new file mode 100644
index 0000000..dd9a6dd
--- /dev/null
+++ b/apps/site/content/docs/story.mdx
@@ -0,0 +1,74 @@
+---
+title: "@cdr-kit/story"
+description: "Thin TypeScript wrappers over @story-protocol/core-sdk: register an IP asset, attach PIL license terms, mint license tokens, register derivatives, wrap IP into WIP. Plus the agent.publish() one-shot."
+importLine: 'import { PILFlavor, createStoryClient } from "@cdr-kit/story"'
+breadcrumb: ["@cdr-kit/story", "Overview"]
+prev:
+  href: /docs/agent-kit
+  label: Agent kit
+next:
+  href: /docs/contracts
+  label: Condition library
+---
+
+## agent.publish() — the one-shot
+
+<p>Collapses 4 normally-separate Story SDK calls into a single agent method. Returns the IP / license / vault artifacts a buyer needs to subscribe + read.</p>
+
+<CodePanel title="ts" language="ts" code={`import { CdrAgent } from "@cdr-kit/agent";
+import { PILFlavor } from "@cdr-kit/story";
+
+const agent = new CdrAgent({ privateKey: process.env.CDR_PRIVATE_KEY!, network: "aeneid" });
+
+const result = await agent.publish({
+  data: new TextEncoder().encode("the secret data"),
+  spgNftContract: "0xYourSpgCollection",
+  pilTerms: PILFlavor.commercialUse({
+    defaultMintingFee: 1_000_000_000_000_000_000n,  // 1 WIP per license
+    commercialRevShare: 5,                            // 5% derivative revenue
+  }),
+});
+
+// → { ipId, tokenId, licenseTermsId, vaultUuid,
+//     vaultTxHash, ipRegisterTxHash, writeTxHash }`} />
+
+## Buyer flow
+
+<p>Once the seller publishes, share <code>{`{ ipId, licenseTermsId, vaultUuid }`}</code> with buyers (URL, QR, whatever). Buyer wraps IP → mints license token → reads vault:</p>
+
+<CodePanel title="ts" language="ts" code={`// Buyer flow once they have { ipId, licenseTermsId, vaultUuid }:
+await agent.wrapIp({ amountWei: 1_000_000_000_000_000_000n });
+await agent.approveWip({ spender: ROYALTY_MODULE, amountWei: 1_000_000_000_000_000_000n });
+
+const { licenseTokenIds } = await agent.mintLicenseTokens({
+  licensorIpId: ipId,
+  licenseTermsId,
+  amount: 1n,
+  maxMintingFee: 1_000_000_000_000_000_000n,
+});
+
+const bytes = await agent.accessLicenseGated({
+  uuid: vaultUuid,
+  licenseTokenId: licenseTokenIds[0]!,
+});`} />
+
+## PIL flavors
+
+<ul>
+  <li><code>PILFlavor.nonCommercialSocialRemixing()</code> — open-source / free public IP (0 fee, 0 rev share).</li>
+  <li><code>{`PILFlavor.commercialUse({ defaultMintingFee, commercialRevShare })`}</code> — paid one-off use, no derivatives.</li>
+  <li><code>{`PILFlavor.commercialRemix({ defaultMintingFee, commercialRevShare })`}</code> — paid use + derivative works allowed, revenue flows back.</li>
+  <li><code>PILFlavor.creativeCommonsAttribution()</code> — CC-BY style (0 fee, attribution required).</li>
+</ul>
+
+## Lower-level wrappers
+
+<p>If <code>publish()</code> doesn't fit, the individual wrappers stay accessible from the agent: <code>registerIpAsset</code>, <code>attachLicenseTerms</code>, <code>mintLicenseTokens</code>, <code>registerDerivative</code>, <code>registerPilTerms</code>, <code>wrapIp</code>, <code>approveWip</code>. Each is a thin <code>@story-protocol/core-sdk</code> wrapper with normalized return shapes.</p>
+
+## React hooks
+
+<p><code>@cdr-kit/react</code> exposes <code>useStoryClient</code> (memoized client bound to the wagmi wallet), <code>useRegisterIp</code>, <code>useAttachLicenseTerms</code>, <code>useMintLicenseToken</code>, and <code>usePublish</code> (the one-shot delegator). Both <code>@cdr-kit/agent</code> and <code>@cdr-kit/story</code> are optional peer deps on the React package — pay only when you publish.</p>
+
+## Design skill
+
+<p>See <a href="https://github.com/Blockchain-Oracle/cdr-kit/blob/main/packages/plugin/cdr-kit/skills/design-publish-with-story/SKILL.md"><code>design-publish-with-story</code></a> SKILL.md for the decision tree on picking PIL flavor, prerequisites (SPG NFT collection), common failure modes, and the agent / CLI / MCP triangulation.</p>
diff --git a/apps/site/content/docs/theming.mdx b/apps/site/content/docs/theming.mdx
new file mode 100644
index 0000000..e552e4b
--- /dev/null
+++ b/apps/site/content/docs/theming.mdx
@@ -0,0 +1,37 @@
+---
+title: Theming
+description: "@cdr-kit/react is intentionally headless. Theme the look through CSS custom properties passed via CdrProvider.appearance.variables."
+breadcrumb: ["@cdr-kit", "Getting started", "Theming"]
+prev:
+  href: /docs/quickstart
+  label: Quickstart
+next:
+  href: /docs/components/cdr-provider
+  label: CdrProvider
+---
+
+## Recognized tokens
+
+<ul>
+  <li><code>--cdr-accent</code> — primary accent</li>
+  <li><code>--cdr-border</code> — hairline border color</li>
+  <li><code>--cdr-skeleton</code> — placeholder background</li>
+  <li><code>--cdr-fg</code>, <code>--cdr-muted</code> — text colors</li>
+</ul>
+
+## Passing tokens
+
+<CodePanel title="App.tsx" code={`<CdrProvider
+  appearance={{
+    variables: {
+      "--cdr-accent": "#3E3BE3",
+      "--cdr-border": "#E6E2DA",
+      "--cdr-skeleton": "#EDEAE2",
+    },
+  }}
+  // ...
+>`} />
+
+## Styled variants
+
+<p>Want batteries-included pre-styled components instead of headless slots? See <code>@cdr-kit/react-ui</code> in the component gallery.</p>
diff --git a/apps/site/lib/demo-vaults.ts b/apps/site/lib/demo-vaults.ts
new file mode 100644
index 0000000..25447f1
--- /dev/null
+++ b/apps/site/lib/demo-vaults.ts
@@ -0,0 +1,28 @@
+/**
+ * Real CDR vaults on Aeneid testnet (factory 0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C).
+ * Verified deployed via `cast call getVaultInfo(uint256)` over tokenIds 1..15.
+ *
+ * For the docs site, every Demo block connects to one of these UUIDs. When a
+ * visitor connects their wallet, the SubscribeButton / VaultGate / Unlockable
+ * runs the real on-chain flow against the named vault.
+ */
+export const DEMO_VAULTS = {
+  /** Trading signal (JSON). Used by SubscribeButton, AccessStepper, etc. */
+  tradingSignal: 4200,
+  /** Secondary signal — used where the demo needs a second vault id. */
+  secondarySignal: 4201,
+  /** Image-bytes vault — proves the magic-byte image branch. */
+  image: 4202,
+  /** Prose-text vault — used by UnlockablePill and prose demos. */
+  unlockProse: 4724,
+  /** Multi-sig vault — used by MultiSigSigner / MultiSigApprovalTracker demos. */
+  multiSig: 4874,
+  /** Time-window vault — used by TimeWindowBadge demo. */
+  timeWindow: 4875,
+  /** Dead-man-switch vault — used by HeartbeatTimer demo. */
+  deadMan: 4876,
+  /** Escrow vault — used by EscrowDeliveryConfirm demo. */
+  escrow: 4877,
+} as const;
+
+export type DemoVaultName = keyof typeof DEMO_VAULTS;
diff --git a/apps/site/lib/mdx-components.tsx b/apps/site/lib/mdx-components.tsx
new file mode 100644
index 0000000..0fe443c
--- /dev/null
+++ b/apps/site/lib/mdx-components.tsx
@@ -0,0 +1,60 @@
+import type { MDXComponents } from "mdx/types";
+
+// docs primitives — these stay 100% custom (zero fumadocs-ui)
+import { Demo } from "@/components/docs/demo";
+import { PropsTable } from "@/components/docs/doc-page";
+import { CodePanel } from "@/components/docs/code-panel";
+import { Callout } from "@/components/docs/parts";
+
+// primitives
+import { Badge } from "@/components/primitives/badge";
+import { CopyButton } from "@/components/primitives/copy-button";
+import { CopyLine } from "@/components/primitives/copy-line";
+
+// gallery + docs demos — registered so MDX can reference them without imports
+import { SubscribeButtonDemo } from "@/components/gallery/subscribe-button-demo";
+import { AccessStepperDemo } from "@/components/gallery/access-stepper-demo";
+import { VaultGateDemo } from "@/components/docs/demos/vault-gate-demo";
+import { UnlockableDemo } from "@/components/docs/demos/unlockable-demo";
+import { HeartbeatTimerDemo } from "@/components/docs/demos/heartbeat-timer-demo";
+import { TimeWindowBadgeDemo } from "@/components/docs/demos/time-window-badge-demo";
+import { MultiSigApprovalTrackerDemo } from "@/components/docs/demos/multi-sig-approval-tracker-demo";
+import { MultiSigSignerDemo } from "@/components/docs/demos/multi-sig-signer-demo";
+import { EscrowDeliveryConfirmDemo } from "@/components/docs/demos/escrow-delivery-confirm-demo";
+import { CdrErrorDemo } from "@/components/docs/demos/cdr-error-demo";
+import { ComponentsGalleryDemo } from "@/components/docs/demos/components-gallery-demo";
+import {
+  CdrInspectorDemo,
+  CdrSkeletonDemo,
+  EmptyVaultsDemo,
+} from "@/components/docs/demos/headless-demos";
+
+/**
+ * Components available to every MDX page without per-file imports.
+ * Adding a new demo component? Register it here.
+ */
+export function getMDXComponents(): MDXComponents {
+  return {
+    Demo,
+    PropsTable,
+    CodePanel,
+    Callout,
+    Badge,
+    CopyButton,
+    CopyLine,
+    SubscribeButtonDemo,
+    AccessStepperDemo,
+    VaultGateDemo,
+    UnlockableDemo,
+    HeartbeatTimerDemo,
+    TimeWindowBadgeDemo,
+    MultiSigApprovalTrackerDemo,
+    MultiSigSignerDemo,
+    EscrowDeliveryConfirmDemo,
+    CdrErrorDemo,
+    ComponentsGalleryDemo,
+    CdrInspectorDemo,
+    CdrSkeletonDemo,
+    EmptyVaultsDemo,
+  };
+}
diff --git a/apps/site/lib/source.ts b/apps/site/lib/source.ts
new file mode 100644
index 0000000..f580653
--- /dev/null
+++ b/apps/site/lib/source.ts
@@ -0,0 +1,7 @@
+import { loader } from "fumadocs-core/source";
+import { docs } from "@/.source/server";
+
+export const source = loader({
+  source: docs.toFumadocsSource(),
+  baseUrl: "/docs",
+});
diff --git a/apps/site/lib/wagmi-config.ts b/apps/site/lib/wagmi-config.ts
new file mode 100644
index 0000000..c33cd01
--- /dev/null
+++ b/apps/site/lib/wagmi-config.ts
@@ -0,0 +1,25 @@
+import { http } from "wagmi";
+import { getDefaultConfig } from "@rainbow-me/rainbowkit";
+
+const aeneid = {
+  id: 1315,
+  name: "Story Aeneid Testnet",
+  nativeCurrency: { name: "IP", symbol: "IP", decimals: 18 },
+  rpcUrls: { default: { http: ["https://aeneid.storyrpc.io"] } },
+  blockExplorers: { default: { name: "Aeneid Explorer", url: "https://aeneid.storyscan.xyz" } },
+} as const;
+
+/**
+ * Single wagmi config for the docs site — Aeneid testnet only.
+ * Every Demo block + the catch-all page uses this through `<SiteProviders>`.
+ * Visitors connect their own wallet; we never hold a private key here.
+ */
+export const wagmiConfig = getDefaultConfig({
+  appName: "cdr-kit docs",
+  projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID ?? "cdrkit-docs-dev",
+  chains: [aeneid],
+  transports: { [aeneid.id]: http() },
+  ssr: true,
+});
+
+export const AENEID_CHAIN_ID = 1315;
diff --git a/apps/site/next.config.ts b/apps/site/next.config.ts
index 3cefa3f..78236ab 100644
--- a/apps/site/next.config.ts
+++ b/apps/site/next.config.ts
@@ -1,7 +1,9 @@
 import type { NextConfig } from "next";
+import { createMDX } from "fumadocs-mdx/next";
 
 const config: NextConfig = {
   reactStrictMode: true,
 };
 
-export default config;
+const withMDX = createMDX();
+export default withMDX(config);
diff --git a/apps/site/package.json b/apps/site/package.json
index 9902fc8..4fec7e5 100644
--- a/apps/site/package.json
+++ b/apps/site/package.json
@@ -15,14 +15,19 @@
     "@cdr-kit/react": "npm:@cdr-kit/react@^0.5.0",
     "@cdr-kit/react-ui": "npm:@cdr-kit/react-ui@^0.5.0",
     "@radix-ui/react-popover": "^1.1.15",
+    "@rainbow-me/rainbowkit": "^2.2.11",
     "@tanstack/react-query": "^5.62.0",
+    "fumadocs-core": "^16.9.3",
+    "fumadocs-mdx": "^15.0.10",
     "next": "16.2.6",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "viem": "^2.51.3",
-    "wagmi": "^2.14.0"
+    "wagmi": "^2.14.0",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@types/mdx": "^2.0.13",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
diff --git a/apps/site/source.config.ts b/apps/site/source.config.ts
new file mode 100644
index 0000000..c805c0f
--- /dev/null
+++ b/apps/site/source.config.ts
@@ -0,0 +1,17 @@
+// fumadocs config — consumed by the fumadocs-mdx CLI generator
+import { defineDocs, defineConfig, frontmatterSchema } from "fumadocs-mdx/config";
+import { z } from "zod";
+
+export const docs = defineDocs({
+  dir: "content/docs",
+  docs: {
+    schema: frontmatterSchema.extend({
+      importLine: z.string().optional(),
+      breadcrumb: z.array(z.string()).optional(),
+      prev: z.object({ href: z.string(), label: z.string() }).optional(),
+      next: z.object({ href: z.string(), label: z.string() }).optional(),
+    }),
+  },
+});
+
+export default defineConfig();
diff --git a/apps/site/tsconfig.json b/apps/site/tsconfig.json
index 67976be..80654c4 100644
--- a/apps/site/tsconfig.json
+++ b/apps/site/tsconfig.json
@@ -5,6 +5,7 @@
     "lib": ["dom", "dom.iterable", "es2022"],
     "allowJs": false,
     "noEmit": true,
+    "declaration": false,
     "incremental": true,
     "module": "esnext",
     "moduleResolution": "bundler",
@@ -21,5 +22,5 @@
     "**/*.tsx",
     ".next/types/**/*.ts"
   ],
-  "exclude": ["node_modules"]
+  "exclude": ["node_modules", "./source.config.ts", "./.source/**/*"]
 }
diff --git a/eslint.config.js b/eslint.config.js
index 7589767..1c7ad67 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -6,10 +6,15 @@ export default tseslint.config(
     ignores: [
       "**/dist/**",
       "**/.next/**",
+      "**/.source/**",
       "**/generated.ts",
       "**/node_modules/**",
       "contracts/**",
       "**/*.config.*",
+      // Scaffolder templates are stringified codegen — they're conceptually configs that
+      // happen to be .ts files. The 400-line cap doesn't make sense for these and any split
+      // would just scatter a single conceptual artifact across multiple files.
+      "packages/create-cdr-kit-app/src/templates/**",
     ],
   },
   js.configs.recommended,
diff --git a/packages/create-cdr-kit-app/src/index.ts b/packages/create-cdr-kit-app/src/index.ts
index b9ec3ba..c9ad70e 100644
--- a/packages/create-cdr-kit-app/src/index.ts
+++ b/packages/create-cdr-kit-app/src/index.ts
@@ -7,6 +7,8 @@ const KNOWN_TEMPLATES: TemplateName[] = [
   "starter",
   "blog",
   "paywall",
+  "data-marketplace",
+  "forms",
   "mcp-server",
   "agent-vercel-ai",
   "agent-openai",
@@ -49,8 +51,8 @@ function parseArgs(argv: string[]): { target?: string; template: TemplateName; h
 }
 
 function printHelp(): void {
-  process.stdout.write("usage: create-cdr-kit-app <dir> [--template starter|blog]\n\ntemplates:\n");
-  for (const t of listTemplates()) process.stdout.write(`  ${t.name.padEnd(8)}  ${t.description}\n`);
+  process.stdout.write("usage: create-cdr-kit-app <dir> [--template <name>]\n\ntemplates:\n");
+  for (const t of listTemplates()) process.stdout.write(`  ${t.name.padEnd(20)}  ${t.description}\n`);
 }
 
 // CLI entry (skipped when imported, e.g. by tests).
diff --git a/packages/create-cdr-kit-app/src/templates/blog.ts b/packages/create-cdr-kit-app/src/templates/blog.ts
index 98bab1b..49c55a1 100644
--- a/packages/create-cdr-kit-app/src/templates/blog.ts
+++ b/packages/create-cdr-kit-app/src/templates/blog.ts
@@ -1,9 +1,25 @@
 import { dedent } from "../util.js";
-import { CDR_VERSION, type Template } from "./types.js";
+import {
+  ENV_LOCAL_EXAMPLE,
+  GITIGNORE,
+  NEXT_CONFIG_TS,
+  NEXT_ENV_DTS,
+  PROVIDERS_TSX,
+  SHARED_DEPS,
+  SHARED_DEV_DEPS,
+  THEME_INIT_SCRIPT,
+  TSCONFIG_JSON,
+} from "./shared.js";
+import type { Template } from "./types.js";
 
+/**
+ * Premium blog template — inline <UnlockablePill> paywalls over a dark editorial layout.
+ * Real Aeneid integration from the first render. No mock. Connect a wallet to interact.
+ */
 export const BLOG: Template = {
   name: "blog",
-  description: "Next.js 16 blog with inline <UnlockablePill> paywalls. Mock-CDR out of the box; swap one provider to go live.",
+  description:
+    "Next.js 16 editorial blog with inline <UnlockablePill> paywalls — real Aeneid integration, dark premium design.",
   postInstall: ["pnpm install", "pnpm dev   # http://localhost:3000"],
   files: [
     {
@@ -13,108 +29,77 @@ export const BLOG: Template = {
           name: "cdr-kit-blog",
           private: true,
           version: "0.0.1",
-          scripts: { dev: "next dev", build: "next build", start: "next start", lint: "next lint" },
-          dependencies: {
-            "@cdr-kit/contracts": CDR_VERSION,
-            "@cdr-kit/core": CDR_VERSION,
-            "@cdr-kit/react": CDR_VERSION,
-            "@cdr-kit/react-ui": CDR_VERSION,
-            "@tanstack/react-query": "^5.62.0",
-            next: "^16.2.6",
-            react: "^19.2.0",
-            "react-dom": "^19.2.0",
-            viem: "^2.51.3",
-            wagmi: "^2.14.0",
-          },
-          devDependencies: {
-            "@types/node": "^20",
-            "@types/react": "^19",
-            "@types/react-dom": "^19",
-            typescript: "^5.7.2",
+          scripts: {
+            dev: "next dev",
+            build: "next build",
+            start: "next start",
+            lint: "next lint",
+            "upload:sample": "tsx scripts/upload.ts",
           },
+          dependencies: SHARED_DEPS,
+          devDependencies: { ...SHARED_DEV_DEPS, tsx: "^4.19.2" },
         },
         null,
         2,
       ),
     },
-    {
-      path: "tsconfig.json",
-      content: JSON.stringify(
-        {
-          compilerOptions: {
-            target: "ES2022",
-            lib: ["dom", "dom.iterable", "esnext"],
-            module: "esnext",
-            moduleResolution: "bundler",
-            jsx: "preserve",
-            strict: true,
-            esModuleInterop: true,
-            skipLibCheck: true,
-            isolatedModules: true,
-            noEmit: true,
-            incremental: true,
-            resolveJsonModule: true,
-            allowJs: true,
-            plugins: [{ name: "next" }],
-            paths: { "@/*": ["./*"] },
-          },
-          include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-          exclude: ["node_modules"],
-        },
-        null,
-        2,
-      ),
-    },
-    { path: "next.config.ts", content: "export default { reactStrictMode: true };\n" },
-    { path: "next-env.d.ts", content: '/// <reference types="next" />\n/// <reference types="next/types/global" />\n' },
+    { path: "tsconfig.json", content: TSCONFIG_JSON },
+    { path: "next.config.ts", content: NEXT_CONFIG_TS },
+    { path: "next-env.d.ts", content: NEXT_ENV_DTS },
     {
       path: "app/layout.tsx",
       content: dedent(`
         import type { ReactNode } from "react";
         import { Providers } from "./providers";
+        import { SiteHeader } from "./header";
         import "@cdr-kit/react-ui/styles.css";
         import "./globals.css";
 
         export const metadata = {
           title: "cdr-kit blog — pay-to-unlock prose",
-          description: "Inline paywalls powered by Story Confidential Data Rails.",
+          description: "Inline paywalls powered by Story Confidential Data Rails (real Aeneid testnet).",
         };
 
         export default function RootLayout({ children }: { children: ReactNode }) {
           return (
-            <html lang="en">
+            <html lang="en" data-theme="dark" suppressHydrationWarning>
+              <head>
+                ${THEME_INIT_SCRIPT}
+              </head>
               <body>
-                <Providers>{children}</Providers>
+                <Providers>
+                  <SiteHeader />
+                  <main>{children}</main>
+                </Providers>
               </body>
             </html>
           );
         }
       `),
     },
+    { path: "app/providers.tsx", content: PROVIDERS_TSX },
     {
-      path: "app/providers.tsx",
+      path: "app/header.tsx",
       content: dedent(`
         "use client";
 
-        import { useMemo, type ReactNode } from "react";
-        import { CdrProvider } from "@cdr-kit/react";
-        import { createMockCdrKit } from "@cdr-kit/core";
+        import { ConnectButton } from "@rainbow-me/rainbowkit";
+        import { CdrNetworkChip } from "@cdr-kit/react-ui";
 
-        /** Mock CDR provider — every <UnlockablePill> on the page runs the full
-         *  subscribe → threshold-read → decrypt flow against in-memory bytes.
-         *  Swap mockKit for { config, apiUrl } to go live on Aeneid. */
-        export function Providers({ children }: { children: ReactNode }) {
-          const kit = useMemo(() => {
-            const k = createMockCdrKit({ readDelayMs: 2200, threshold: 7 });
-            void k.writeVaultData({ uuid: 4242, dataKey: new TextEncoder().encode(
-              "Exhibit 14B — sheriff's report excerpt:\\n\\n\\"At 7:42pm the suspect was observed exiting via the boat-house door, not the main path as the witness initially stated.\\"",
-            ) });
-            void k.writeVaultData({ uuid: 4243, dataKey: new TextEncoder().encode(
-              "The shadow on the dock wasn't her sister.\\n\\nArlo had paid Mrs. Calder twenty dollars to keep the negative — she'd developed it in her own basement that summer.",
-            ) });
-            return k;
-          }, []);
-          return <CdrProvider mockKit={kit}>{children}</CdrProvider>;
+        /** Top bar with the network chip + RainbowKit connect button. */
+        export function SiteHeader() {
+          return (
+            <header className="site-header">
+              <div className="brand">
+                <span className="brand-dot" aria-hidden />
+                <span>cdr-kit blog</span>
+              </div>
+              <div className="header-actions">
+                <CdrNetworkChip mode="live" />
+                <ConnectButton accountStatus="address" chainStatus="icon" />
+              </div>
+            </header>
+          );
         }
       `),
     },
@@ -123,6 +108,11 @@ export const BLOG: Template = {
       content: dedent(`
         import { UnlockablePill } from "@cdr-kit/react-ui";
 
+        /** Real Aeneid vault IDs (deployed via the cdr-kit factory at 0xac592f…).
+         *  Swap these for your own after running scripts/upload.ts. */
+        const VAULT_EXHIBIT = 4200;
+        const VAULT_CHAPTER = 4201;
+
         export default function HomePage() {
           return (
             <article className="post">
@@ -134,7 +124,7 @@ export const BLOG: Template = {
 
               <p>
                 Arlo Vance told the press he was alone in Tahoe to write. But{" "}
-                <UnlockablePill uuid={4242} priceLabel="3 $IP" title="Exhibit 14B" subtitle="sheriff's report · attached">
+                <UnlockablePill uuid={VAULT_EXHIBIT} priceLabel="3 $IP" title="Exhibit 14B" subtitle="sheriff's report · attached">
                   the woman beside him on the dock
                 </UnlockablePill>{" "}
                 disagrees — and the timeline in the official record doesn't add up.
@@ -142,11 +132,17 @@ export const BLOG: Template = {
 
               <p>
                 What follows is the part the estate fought to suppress —{" "}
-                <UnlockablePill uuid={4243} priceLabel="8 $IP" title="Closing chapter" subtitle="prose · unpublished">
+                <UnlockablePill uuid={VAULT_CHAPTER} priceLabel="8 $IP" title="Closing chapter" subtitle="prose · unpublished">
                   the closing chapter from Arlo's lost notebook
                 </UnlockablePill>{" "}
                 — written in his own hand the morning after.
               </p>
+
+              <p className="hint">
+                Click either inline pill above to run the real subscribe → threshold-read → decrypt flow on Aeneid.
+                You'll need a wallet connected with a small amount of testnet IP (free from{" "}
+                <a href="https://aeneid.faucet.story.foundation/" target="_blank" rel="noreferrer">the faucet</a>).
+              </p>
             </article>
           );
         }
@@ -155,21 +151,61 @@ export const BLOG: Template = {
     {
       path: "app/globals.css",
       content: dedent(`
-        :root { color-scheme: light dark; }
+        :root { color-scheme: dark light; }
         * { box-sizing: border-box; }
+        html { background: var(--cdr-ui-bg, oklch(13% 0.012 90)); }
         body {
-          margin: 0; font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
-          background: #fafafa; color: #1a1614;
+          margin: 0;
+          font-family: var(--cdr-ui-font-sans, ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif);
+          background: var(--cdr-ui-bg, oklch(13% 0.012 90));
+          color: var(--cdr-ui-fg, oklch(94% 0.01 90));
           -webkit-font-smoothing: antialiased;
         }
-        .post { max-width: 680px; margin: 0 auto; padding: 64px 24px 96px; }
-        .post .eyebrow { font-family: ui-monospace, monospace; font-size: 0.72rem; color: #d9952e; letter-spacing: 0.06em; text-transform: uppercase; margin: 0 0 12px; }
-        .post h1 { font-size: clamp(2.1rem, 4.4vw, 3rem); font-weight: 800; letter-spacing: -0.025em; line-height: 1.1; margin: 0 0 14px; }
-        .post .byline { font-family: ui-monospace, monospace; font-size: 0.78rem; color: #777; margin: 0 0 36px; }
-        .post p { font-size: 1.08rem; line-height: 1.72; color: #2c2825; margin: 0 0 22px; }
-        @media (prefers-color-scheme: dark) {
-          body { background: #15110f; color: #fafafa; }
-          .post p { color: #d4cfc9; }
+        a { color: var(--cdr-ui-primary, oklch(78% 0.16 70)); text-decoration: none; }
+        a:hover { text-decoration: underline; }
+
+        .site-header {
+          display: flex; align-items: center; justify-content: space-between;
+          padding: 18px 28px;
+          border-bottom: 1px solid var(--cdr-ui-border, oklch(22% 0.012 90));
+          backdrop-filter: blur(8px);
+          position: sticky; top: 0; z-index: 10;
+          background: color-mix(in oklab, var(--cdr-ui-bg) 80%, transparent);
+        }
+        .brand { display: flex; align-items: center; gap: 10px; font-weight: 600; letter-spacing: -0.01em; }
+        .brand-dot {
+          width: 10px; height: 10px; border-radius: 999px;
+          background: linear-gradient(135deg, oklch(78% 0.16 70), oklch(72% 0.20 30));
+        }
+        .header-actions { display: flex; align-items: center; gap: 14px; }
+
+        .post { max-width: 720px; margin: 0 auto; padding: 80px 28px 120px; }
+        .post .eyebrow {
+          font-family: ui-monospace, monospace; font-size: 0.72rem;
+          color: var(--cdr-ui-accent, oklch(78% 0.16 70));
+          letter-spacing: 0.08em; text-transform: uppercase; margin: 0 0 14px;
+        }
+        .post h1 {
+          font-size: clamp(2.2rem, 4.4vw, 3.4rem); font-weight: 800;
+          letter-spacing: -0.028em; line-height: 1.08; margin: 0 0 16px;
+          background: linear-gradient(135deg, var(--cdr-ui-fg, #fafafa) 0%, color-mix(in oklab, var(--cdr-ui-fg) 60%, var(--cdr-ui-primary, oklch(78% 0.16 70))) 100%);
+          -webkit-background-clip: text; background-clip: text; color: transparent;
+        }
+        .post .byline {
+          font-family: ui-monospace, monospace; font-size: 0.78rem;
+          color: var(--cdr-ui-muted, oklch(60% 0.01 90)); margin: 0 0 44px;
+        }
+        .post p { font-size: 1.12rem; line-height: 1.78; color: var(--cdr-ui-fg, #fafafa); margin: 0 0 22px; opacity: 0.92; }
+        .post .hint {
+          margin-top: 56px; padding: 18px 22px;
+          font-size: 0.92rem; line-height: 1.6;
+          border: 1px dashed var(--cdr-ui-border, oklch(28% 0.012 90));
+          border-radius: 12px;
+          color: var(--cdr-ui-muted, oklch(60% 0.01 90));
+        }
+
+        @media (prefers-color-scheme: light) {
+          [data-theme="light"] html, [data-theme="light"] body { background: oklch(98% 0.005 90); color: oklch(20% 0.012 90); }
         }
       `),
     },
@@ -204,8 +240,6 @@ export const BLOG: Template = {
         const client = createCdrKitClient({ apiUrl: "https://aeneid.storyrpc.io", publicClient, walletClient });
 
         const bytes = readFileSync(path);
-        // Set IPFS_ADD_URL + IPFS_GATEWAY_URL for your pinning service (web3.storage, Pinata, etc.)
-        // Optionally IPFS_AUTH for an Authorization header.
         const storage = createIpfsStorage({
           addUrl: process.env.IPFS_ADD_URL ?? "https://api.web3.storage/upload",
           gatewayUrl: process.env.IPFS_GATEWAY_URL ?? "https://w3s.link",
@@ -214,7 +248,6 @@ export const BLOG: Template = {
         const res = await uploadFile(client, {
           content: bytes,
           storage,
-          // default = OpenCondition. For paywall, pass subscriptionCondition + readConditionData.
           readConditionAddr: aeneid.subscriptionCondition as \`0x\${string}\`,
         });
         console.log("uuid:", res.uuid);
@@ -227,38 +260,38 @@ export const BLOG: Template = {
       content: dedent(`
         # cdr-kit blog
 
-        Inline pay-to-unlock paywalls with Story CDR — the [onscroll.app](https://onscroll.app) pattern.
+        Inline pay-to-unlock paywalls with Story CDR — the [onscroll.app](https://onscroll.app) pattern,
+        wired to **real Aeneid testnet** from the first render. No mock layer.
 
         \`\`\`bash
         pnpm install
-        pnpm dev      # http://localhost:3000 — mock mode, no wallet
+        pnpm dev      # http://localhost:3000
         \`\`\`
 
+        Connect any wallet that supports the Story Aeneid testnet (chain ID 1315). Grab free testnet IP
+        from <https://aeneid.faucet.story.foundation/>. Click an inline pill → real subscribe + decrypt
+        runs on chain.
+
         ## How it works
 
-        Each \`<UnlockablePill>\` is an inline span tied to a CDR vault \`uuid\`. Click it →
-        a popover opens → "Unlock" runs the full \`subscribe → threshold-read → decrypt\`
-        flow → the encrypted attachment renders right there. The anchor text stays
-        plaintext (it's a public teaser); only the **attached payload** is encrypted.
+        Each \`<UnlockablePill>\` is an inline span tied to a CDR vault \`uuid\`. Click → popover opens →
+        "Unlock" runs the full subscribe → threshold-read → decrypt flow → encrypted attachment renders.
+        The anchor text stays plaintext (it's a teaser); only the attached payload is encrypted.
 
-        ## Going live on Aeneid
+        ## Using your own vaults
 
-        1. Get a funded Aeneid testnet wallet. Add \`WALLET_PRIVATE_KEY=0x...\` to \`.env.local\`.
-        2. Upload your real file & get its uuid:
+        1. Get a funded Aeneid wallet. Set \`WALLET_PRIVATE_KEY=0x...\` in \`.env.local\`.
+        2. Upload your file:
            \`\`\`bash
-           pnpm tsx scripts/upload.ts ./your-photo.jpg
+           pnpm upload:sample ./your-photo.jpg
            # → uuid: 12345
            \`\`\`
-        3. Replace the \`Providers\` in \`app/providers.tsx\` — drop the \`mockKit\`, wire your
-           \`wagmi\` config + the Aeneid apiUrl. (Or use \`@cdr-kit/react\`'s \`CdrConfigProvider\`
-           in a wagmi tree you already maintain.)
-        4. Update the \`<UnlockablePill uuid={...}>\` to use the real uuid from step 2.
+        3. Replace the \`VAULT_EXHIBIT\` / \`VAULT_CHAPTER\` constants in \`app/page.tsx\`.
 
-        See full docs: <https://github.com/Blockchain-Oracle/cdr-kit>
+        Full docs: <https://cdr-kit.dev>
       `),
     },
-    { path: ".gitignore", content: "node_modules\n.next\ndist\n.env\n.env.local\n.env.*.local\n" },
-    { path: ".env.local.example", content: "# WALLET_PRIVATE_KEY=0x...  # required only when uploading or going live\n" },
+    { path: ".gitignore", content: GITIGNORE },
+    { path: ".env.local.example", content: ENV_LOCAL_EXAMPLE },
   ],
 };
-
diff --git a/packages/create-cdr-kit-app/src/templates/data-marketplace.ts b/packages/create-cdr-kit-app/src/templates/data-marketplace.ts
new file mode 100644
index 0000000..0295992
--- /dev/null
+++ b/packages/create-cdr-kit-app/src/templates/data-marketplace.ts
@@ -0,0 +1,304 @@
+import { dedent } from "../util.js";
+import {
+  ENV_LOCAL_EXAMPLE,
+  GITIGNORE,
+  NEXT_CONFIG_TS,
+  NEXT_ENV_DTS,
+  PROVIDERS_TSX,
+  SHARED_DEPS,
+  SHARED_DEV_DEPS,
+  THEME_INIT_SCRIPT,
+  TSCONFIG_JSON,
+} from "./shared.js";
+import type { Template } from "./types.js";
+
+/**
+ * Flagship template: a data marketplace landing dark UI with a discovery grid
+ * (useDiscoverVaults → VaultCard) and inline SubscribeButton per card.
+ * Real Aeneid integration. No mock anywhere. The default `create-cdr-kit-app` template.
+ */
+export const DATA_MARKETPLACE: Template = {
+  name: "data-marketplace",
+  description:
+    "Flagship template — dark hero + live vault discovery grid + SubscribeButton CTAs on Aeneid.",
+  postInstall: ["pnpm install", "pnpm dev   # http://localhost:3000"],
+  files: [
+    {
+      path: "package.json",
+      content: JSON.stringify(
+        {
+          name: "cdr-kit-marketplace",
+          private: true,
+          version: "0.0.1",
+          scripts: {
+            dev: "next dev",
+            build: "next build",
+            start: "next start",
+            lint: "next lint",
+          },
+          dependencies: SHARED_DEPS,
+          devDependencies: SHARED_DEV_DEPS,
+        },
+        null,
+        2,
+      ),
+    },
+    { path: "tsconfig.json", content: TSCONFIG_JSON },
+    { path: "next.config.ts", content: NEXT_CONFIG_TS },
+    { path: "next-env.d.ts", content: NEXT_ENV_DTS },
+    {
+      path: "app/layout.tsx",
+      content: dedent(`
+        import type { ReactNode } from "react";
+        import { Providers } from "./providers";
+        import { SiteHeader } from "./header";
+        import "@cdr-kit/react-ui/styles.css";
+        import "./globals.css";
+
+        export const metadata = {
+          title: "cdr-kit · data marketplace",
+          description: "Discover encrypted CDR vaults on Story Aeneid. Subscribe to decrypt.",
+        };
+
+        export default function RootLayout({ children }: { children: ReactNode }) {
+          return (
+            <html lang="en" data-theme="dark" suppressHydrationWarning>
+              <head>
+                ${THEME_INIT_SCRIPT}
+              </head>
+              <body>
+                <Providers>
+                  <SiteHeader />
+                  <main>{children}</main>
+                </Providers>
+              </body>
+            </html>
+          );
+        }
+      `),
+    },
+    { path: "app/providers.tsx", content: PROVIDERS_TSX },
+    {
+      path: "app/header.tsx",
+      content: dedent(`
+        "use client";
+
+        import { ConnectButton } from "@rainbow-me/rainbowkit";
+        import { CdrNetworkChip } from "@cdr-kit/react-ui";
+
+        export function SiteHeader() {
+          return (
+            <header className="site-header">
+              <div className="brand">
+                <span className="brand-dot" aria-hidden />
+                <span className="brand-text">market.cdr</span>
+              </div>
+              <nav className="header-nav">
+                <a href="/">Discover</a>
+                <a href="/seller">Seller</a>
+              </nav>
+              <div className="header-actions">
+                <CdrNetworkChip mode="live" />
+                <ConnectButton accountStatus="address" chainStatus="icon" />
+              </div>
+            </header>
+          );
+        }
+      `),
+    },
+    {
+      path: "app/page.tsx",
+      content: dedent(`
+        import { Hero } from "./hero";
+        import { DiscoveryGrid } from "./discovery-grid";
+
+        export default function Page() {
+          return (
+            <>
+              <Hero />
+              <DiscoveryGrid />
+            </>
+          );
+        }
+      `),
+    },
+    {
+      path: "app/hero.tsx",
+      content: dedent(`
+        export function Hero() {
+          return (
+            <section className="hero">
+              <div className="hero-inner">
+                <p className="eyebrow">Story · Confidential Data Rails</p>
+                <h1 className="hero-title">
+                  Encrypted vaults. <br />
+                  <span className="hero-grad">Real on-chain access.</span>
+                </h1>
+                <p className="hero-lede">
+                  Discover live CDR vaults on Aeneid testnet. Subscribe to decrypt — every read goes
+                  through the threshold-decrypt protocol, every payment is on chain. No mock.
+                </p>
+                <div className="hero-meta">
+                  <span className="hero-pill">15 active vaults</span>
+                  <span className="hero-pill">9 condition types</span>
+                  <span className="hero-pill">Aeneid · chain 1315</span>
+                </div>
+              </div>
+            </section>
+          );
+        }
+      `),
+    },
+    {
+      path: "app/discovery-grid.tsx",
+      content: dedent(`
+        "use client";
+
+        import { useDiscoverVaults } from "@cdr-kit/react";
+        import { VaultCard, SubscribeButton, CdrSpinner, CdrError } from "@cdr-kit/react-ui";
+
+        export function DiscoveryGrid() {
+          const { vaults, isLoading, error } = useDiscoverVaults({ enabled: true });
+
+          if (isLoading) return (
+            <section className="discovery"><CdrSpinner /> <span className="loading-text">Scanning VaultCreated events…</span></section>
+          );
+          if (error) return (
+            <section className="discovery">
+              <CdrError title="Discovery failed" message={String(error.message ?? error)} />
+            </section>
+          );
+          if (!vaults?.length) return (
+            <section className="discovery"><p className="empty">No vaults yet on this RPC. Try the seller template to create one.</p></section>
+          );
+
+          return (
+            <section className="discovery">
+              <h2 className="discovery-h">Live vaults</h2>
+              <div className="grid">
+                {vaults.slice(0, 12).map((v) => (
+                  <div key={v.uuid} className="vault-cell">
+                    <VaultCard
+                      uuid={v.uuid}
+                      condition="subscription"
+                      title={\`Vault #\${v.uuid}\`}
+                      description={\`Created by \${v.creator.slice(0, 8)}…\`}
+                      price="5 $IP"
+                    />
+                    <SubscribeButton uuid={v.uuid} priceWei={5n * 10n ** 18n} priceLabel="5 $IP" />
+                  </div>
+                ))}
+              </div>
+            </section>
+          );
+        }
+      `),
+    },
+    {
+      path: "app/globals.css",
+      content: dedent(`
+        :root { color-scheme: dark light; }
+        * { box-sizing: border-box; }
+        html { background: var(--cdr-ui-bg, oklch(12% 0.012 90)); }
+        body {
+          margin: 0;
+          font-family: var(--cdr-ui-font-sans, ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif);
+          background: var(--cdr-ui-bg, oklch(12% 0.012 90));
+          color: var(--cdr-ui-fg, oklch(94% 0.01 90));
+          -webkit-font-smoothing: antialiased;
+          min-height: 100vh;
+        }
+        a { color: var(--cdr-ui-primary, oklch(78% 0.16 70)); text-decoration: none; }
+        a:hover { text-decoration: underline; }
+
+        .site-header {
+          display: flex; align-items: center; justify-content: space-between;
+          padding: 16px 32px;
+          border-bottom: 1px solid var(--cdr-ui-border, oklch(20% 0.012 90));
+          backdrop-filter: blur(10px);
+          position: sticky; top: 0; z-index: 10;
+          background: color-mix(in oklab, var(--cdr-ui-bg) 84%, transparent);
+        }
+        .brand { display: flex; align-items: center; gap: 10px; font-weight: 600; letter-spacing: -0.01em; font-family: ui-monospace, monospace; }
+        .brand-dot {
+          width: 10px; height: 10px; border-radius: 999px;
+          background: linear-gradient(135deg, oklch(78% 0.16 70), oklch(72% 0.20 30));
+        }
+        .header-nav { display: flex; gap: 22px; font-size: 0.92rem; color: var(--cdr-ui-muted, oklch(68% 0.01 90)); }
+        .header-actions { display: flex; align-items: center; gap: 14px; }
+
+        .hero { padding: 96px 32px 64px; }
+        .hero-inner { max-width: 1080px; margin: 0 auto; }
+        .eyebrow {
+          font-family: ui-monospace, monospace; font-size: 0.74rem;
+          color: var(--cdr-ui-accent, oklch(78% 0.16 70));
+          letter-spacing: 0.10em; text-transform: uppercase; margin: 0 0 14px;
+        }
+        .hero-title {
+          font-size: clamp(2.8rem, 6.4vw, 5.2rem);
+          font-weight: 800; letter-spacing: -0.035em; line-height: 1.04; margin: 0 0 22px;
+        }
+        .hero-grad {
+          background: linear-gradient(135deg, oklch(78% 0.16 70), oklch(72% 0.20 30));
+          -webkit-background-clip: text; background-clip: text; color: transparent;
+        }
+        .hero-lede {
+          font-size: 1.14rem; line-height: 1.65; max-width: 640px;
+          color: var(--cdr-ui-muted, oklch(74% 0.01 90)); margin: 0 0 32px;
+        }
+        .hero-meta { display: flex; flex-wrap: wrap; gap: 10px; }
+        .hero-pill {
+          padding: 6px 12px; border-radius: 999px;
+          font-size: 0.78rem; font-family: ui-monospace, monospace;
+          border: 1px solid var(--cdr-ui-border, oklch(24% 0.012 90));
+          color: var(--cdr-ui-muted, oklch(70% 0.01 90));
+          background: color-mix(in oklab, var(--cdr-ui-surface, oklch(18% 0.012 90)) 80%, transparent);
+        }
+
+        .discovery { max-width: 1080px; margin: 0 auto; padding: 24px 32px 96px; }
+        .discovery-h {
+          font-size: 1.6rem; font-weight: 700; letter-spacing: -0.02em;
+          margin: 0 0 24px;
+        }
+        .grid {
+          display: grid; gap: 18px;
+          grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+        }
+        .loading-text {
+          font-family: ui-monospace, monospace; font-size: 0.86rem;
+          color: var(--cdr-ui-muted, oklch(68% 0.01 90));
+          margin-left: 10px;
+        }
+        .empty { font-size: 0.96rem; color: var(--cdr-ui-muted, oklch(68% 0.01 90)); }
+      `),
+    },
+    {
+      path: "README.md",
+      content: dedent(`
+        # cdr-kit · data marketplace
+
+        Flagship template: live vault discovery grid + SubscribeButton CTAs on **real Aeneid testnet**.
+        Zero mock. Connect a wallet to interact.
+
+        \`\`\`bash
+        pnpm install
+        pnpm dev      # http://localhost:3000
+        \`\`\`
+
+        Need testnet IP? <https://aeneid.faucet.story.foundation/>
+
+        ## What's wired up
+
+        - \`useDiscoverVaults()\` scans \`VaultCreated\` events on the factory at
+          \`0xac592f165D8dD1f27A087bdB39c0b2f619FF6C8C\` and renders each vault as a \`<VaultCard>\`
+        - \`<SubscribeButton>\` runs the full subscribe → threshold-decrypt → reveal flow per card
+        - \`<CdrNetworkChip>\` in the header shows the live network state
+        - RainbowKit \`<ConnectButton>\` handles wallet connection
+
+        Full docs: <https://cdr-kit.dev>
+      `),
+    },
+    { path: ".gitignore", content: GITIGNORE },
+    { path: ".env.local.example", content: ENV_LOCAL_EXAMPLE },
+  ],
+};
diff --git a/packages/create-cdr-kit-app/src/templates/forms.ts b/packages/create-cdr-kit-app/src/templates/forms.ts
new file mode 100644
index 0000000..cfe009b
--- /dev/null
+++ b/packages/create-cdr-kit-app/src/templates/forms.ts
@@ -0,0 +1,465 @@
+import { dedent } from "../util.js";
+import {
+  GITIGNORE,
+  NEXT_CONFIG_TS,
+  NEXT_ENV_DTS,
+  PROVIDERS_TSX,
+  SHARED_DEPS,
+  SHARED_DEV_DEPS,
+  THEME_INIT_SCRIPT,
+  TSCONFIG_JSON,
+} from "./shared.js";
+import type { Template } from "./types.js";
+
+/**
+ * Encrypted forms template — `@cdr-kit/forms` end-to-end with a real
+ * `CdrStorageProvider` adapter wired into the server route. Default adapter:
+ * Pinata (single JWT env var, easiest signup). Swap to Supabase / S3 /
+ * Storacha / IPFS / Helia by changing the factory call in `/api/respond/route.ts`
+ * — every option is documented in comments.
+ */
+export const FORMS: Template = {
+  name: "forms",
+  description:
+    "Encrypted forms — CdrForm + Pinata storage adapter, server stores per-submission CDR vault on Aeneid.",
+  postInstall: [
+    "pnpm install",
+    "cp .env.local.example .env.local",
+    "# add WALLET_PRIVATE_KEY and PINATA_JWT (or swap to another adapter)",
+    "pnpm dev   # http://localhost:3000",
+  ],
+  files: [
+    {
+      path: "package.json",
+      content: JSON.stringify(
+        {
+          name: "cdr-kit-forms",
+          private: true,
+          version: "0.0.1",
+          scripts: {
+            dev: "next dev",
+            build: "next build",
+            start: "next start",
+            lint: "next lint",
+          },
+          dependencies: {
+            ...SHARED_DEPS,
+            "@cdr-kit/agent": "^0.7.0",
+            "@cdr-kit/forms": "^0.7.0",
+          },
+          devDependencies: SHARED_DEV_DEPS,
+        },
+        null,
+        2,
+      ),
+    },
+    { path: "tsconfig.json", content: TSCONFIG_JSON },
+    { path: "next.config.ts", content: NEXT_CONFIG_TS },
+    { path: "next-env.d.ts", content: NEXT_ENV_DTS },
+    {
+      path: "app/layout.tsx",
+      content: dedent(`
+        import type { ReactNode } from "react";
+        import { Providers } from "./providers";
+        import { FormHeader } from "./header";
+        import "@cdr-kit/react-ui/styles.css";
+        import "@cdr-kit/forms/styles.css";
+        import "./globals.css";
+
+        export const metadata = {
+          title: "Encrypted forms · cdr-kit",
+          description: "Submit encrypted forms to CDR on Aeneid. Only the creator can decrypt.",
+        };
+
+        export default function RootLayout({ children }: { children: ReactNode }) {
+          return (
+            <html lang="en" data-theme="dark" suppressHydrationWarning>
+              <head>
+                ${THEME_INIT_SCRIPT}
+              </head>
+              <body>
+                <Providers>
+                  <FormHeader />
+                  <main>{children}</main>
+                </Providers>
+              </body>
+            </html>
+          );
+        }
+      `),
+    },
+    { path: "app/providers.tsx", content: PROVIDERS_TSX },
+    {
+      path: "app/header.tsx",
+      content: dedent(`
+        "use client";
+
+        import Link from "next/link";
+        import { ConnectButton } from "@rainbow-me/rainbowkit";
+        import { CdrNetworkChip } from "@cdr-kit/react-ui";
+
+        export function FormHeader() {
+          return (
+            <header className="site-header">
+              <div className="brand">
+                <span className="brand-dot" aria-hidden />
+                <span>forms.cdr</span>
+              </div>
+              <nav className="header-nav">
+                <Link href="/">Respond</Link>
+                <Link href="/results">Results</Link>
+              </nav>
+              <div className="header-actions">
+                <CdrNetworkChip mode="live" />
+                <ConnectButton accountStatus="address" chainStatus="icon" />
+              </div>
+            </header>
+          );
+        }
+      `),
+    },
+    {
+      path: "app/page.tsx",
+      content: dedent(`
+        "use client";
+
+        import { CdrForm, CdrField, CdrSubmitButton } from "@cdr-kit/forms";
+
+        async function encryptOnServer(fields: Record<string, unknown>): Promise<number> {
+          const res = await fetch("/api/respond", {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ fields }),
+          });
+          if (!res.ok) throw new Error(\`submit failed: \${res.status}\`);
+          const data = await res.json();
+          return data.vaultId as number;
+        }
+
+        export default function Page() {
+          return (
+            <section className="form-stage">
+              <article className="form-card">
+                <p className="eyebrow">survey · encrypted on-chain</p>
+                <h1 className="form-title">How was your week?</h1>
+                <p className="form-lede">
+                  Your answers are encrypted server-side, uploaded to the configured storage adapter,
+                  and only the form creator can decrypt. No wallet required to submit.
+                </p>
+
+                <CdrForm
+                  onEncrypt={(fields) => encryptOnServer(fields)}
+                  onSuccess={(uuid) => console.info(\`stored at vault \${uuid}\`)}
+                >
+                  <CdrField name="mood" label="Mood (1–10)" type="number" required />
+                  <CdrField name="highlight" label="Highlight of the week" type="text" placeholder="What stood out?" required />
+                  <CdrField name="notes" label="Anything else?" type="textarea" placeholder="Optional" />
+                  <CdrSubmitButton>Submit securely</CdrSubmitButton>
+                </CdrForm>
+              </article>
+            </section>
+          );
+        }
+      `),
+    },
+    {
+      path: "app/results/page.tsx",
+      content: dedent(`
+        "use client";
+
+        import { useEffect, useState } from "react";
+
+        interface Submission {
+          vaultId: number;
+          fields: Record<string, unknown>;
+          submittedAt: string;
+        }
+
+        export default function ResultsPage() {
+          const [items, setItems] = useState<Submission[]>([]);
+          const [loading, setLoading] = useState(true);
+          const [error, setError] = useState<string | null>(null);
+
+          useEffect(() => {
+            (async () => {
+              try {
+                const r = await fetch("/api/results");
+                if (!r.ok) throw new Error(\`HTTP \${r.status}\`);
+                const j = await r.json();
+                setItems(j.items ?? []);
+              } catch (e) {
+                setError(String((e as Error).message ?? e));
+              } finally {
+                setLoading(false);
+              }
+            })();
+          }, []);
+
+          return (
+            <section className="form-stage">
+              <article className="form-card">
+                <h1 className="form-title">Decrypted submissions</h1>
+                <p className="form-lede">
+                  Pulled from each per-submission CDR vault and decrypted with the platform wallet
+                  private key (server-side only).
+                </p>
+                {loading && <p>Loading…</p>}
+                {error && <p style={{ color: "salmon" }}>error: {error}</p>}
+                {!loading && !error && items.length === 0 && <p>No submissions yet.</p>}
+                <ol className="result-list">
+                  {items.map((it) => (
+                    <li key={it.vaultId} className="result-item">
+                      <div className="result-meta">
+                        <span className="result-vault">vault #{it.vaultId}</span>
+                        <span className="result-date">{new Date(it.submittedAt).toLocaleString()}</span>
+                      </div>
+                      <pre className="result-fields">{JSON.stringify(it.fields, null, 2)}</pre>
+                    </li>
+                  ))}
+                </ol>
+              </article>
+            </section>
+          );
+        }
+      `),
+    },
+    {
+      path: "lib/storage.ts",
+      content: dedent(`
+        import { createPinataStorage } from "@cdr-kit/core";
+        // 5 other adapters available — swap createPinataStorage(...) below for any of:
+        //   createSupabaseStorage  ({ url, key, bucket })             — Postgres + S3 storage
+        //   createIpfsStorage      ({ addUrl, gatewayUrl, headers? }) — any IPFS HTTP API
+        //   createS3Storage        ({ endpoint, region, accessKey, secretKey, bucket }) — S3 / R2 / B2
+        //   createStorachaStorage  ({ agentDelegation, spaceDid })    — web3.storage / w3up
+        //   createHeliaStorage     ({ helia? })                       — self-hosted Helia node
+
+        /**
+         * Single source of truth for the storage adapter — imported by both
+         * /api/respond and /api/results so writes + reads round-trip the same way.
+         * Keys come from .env.local (never committed; see .env.local.example).
+         */
+        export function getStorage() {
+          const jwt = process.env.PINATA_JWT;
+          if (!jwt) {
+            throw new Error(
+              "Missing PINATA_JWT in .env.local. Get one free at https://app.pinata.cloud/developers/api-keys",
+            );
+          }
+          return createPinataStorage({
+            jwt,
+            gatewayUrl: process.env.PINATA_GATEWAY_URL ?? "https://gateway.pinata.cloud",
+          });
+        }
+      `),
+    },
+    {
+      path: "app/api/respond/route.ts",
+      content: dedent(`
+        import { NextResponse } from "next/server";
+        import { storeFormSubmission } from "@cdr-kit/forms/server";
+        import { getStorage } from "../../../lib/storage";
+
+        /** Platform-wallet pattern: respondent never holds a wallet. The server signs
+         *  every submission with its own funded Aeneid key and uploads the encrypted
+         *  blob through the configured storage adapter. */
+        export async function POST(req: Request) {
+          const pk = process.env.WALLET_PRIVATE_KEY as \`0x\${string}\` | undefined;
+          if (!pk) {
+            return NextResponse.json({ error: "Server missing WALLET_PRIVATE_KEY" }, { status: 500 });
+          }
+
+          const { fields } = await req.json();
+          try {
+            const storage = getStorage();
+            const { vaultId, cid } = await storeFormSubmission(fields, {
+              privateKey: pk,
+              storage,
+              rpcUrl: "https://aeneid.storyrpc.io",
+            });
+
+            // In production, persist { vaultId, cid, submittedAt } in your DB alongside
+            // the form id so /api/results can list them later.
+            return NextResponse.json({ vaultId, cid });
+          } catch (e) {
+            return NextResponse.json({ error: String((e as Error).message ?? e) }, { status: 500 });
+          }
+        }
+      `),
+    },
+    {
+      path: "app/api/results/route.ts",
+      content: dedent(`
+        import { NextResponse } from "next/server";
+        import { readFormSubmission } from "@cdr-kit/forms/server";
+        import { getStorage } from "../../../lib/storage";
+
+        /** Demo: decrypts known vault IDs from an in-memory list. In production
+         *  you'd pull this list from your DB (the IDs you stored from
+         *  /api/respond) for the authenticated form creator only. */
+        const SAMPLE_VAULT_IDS: number[] = [];
+
+        export async function GET() {
+          const pk = process.env.WALLET_PRIVATE_KEY as \`0x\${string}\` | undefined;
+          if (!pk) {
+            return NextResponse.json({ error: "Server missing WALLET_PRIVATE_KEY" }, { status: 500 });
+          }
+
+          const storage = getStorage();
+          const items = await Promise.all(
+            SAMPLE_VAULT_IDS.map(async (vaultId) => {
+              const { fields, submittedAt } = await readFormSubmission(vaultId, {
+                privateKey: pk,
+                storage,
+                rpcUrl: "https://aeneid.storyrpc.io",
+              });
+              return { vaultId, fields, submittedAt };
+            }),
+          );
+
+          return NextResponse.json({ items });
+        }
+      `),
+    },
+    {
+      path: "app/globals.css",
+      content: dedent(`
+        :root { color-scheme: dark light; }
+        * { box-sizing: border-box; }
+        html { background: var(--cdr-ui-bg, oklch(13% 0.012 90)); }
+        body {
+          margin: 0;
+          font-family: var(--cdr-ui-font-sans, ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif);
+          background: var(--cdr-ui-bg, oklch(13% 0.012 90));
+          color: var(--cdr-ui-fg, oklch(94% 0.01 90));
+          -webkit-font-smoothing: antialiased;
+          min-height: 100vh;
+        }
+        a { color: var(--cdr-ui-primary, oklch(78% 0.16 70)); text-decoration: none; }
+        a:hover { text-decoration: underline; }
+
+        .site-header {
+          display: flex; align-items: center; justify-content: space-between;
+          padding: 16px 28px;
+          border-bottom: 1px solid var(--cdr-ui-border, oklch(22% 0.012 90));
+          backdrop-filter: blur(8px);
+          position: sticky; top: 0; z-index: 10;
+          background: color-mix(in oklab, var(--cdr-ui-bg) 80%, transparent);
+        }
+        .brand { display: flex; align-items: center; gap: 10px; font-weight: 600; font-family: ui-monospace, monospace; }
+        .brand-dot { width: 10px; height: 10px; border-radius: 999px; background: linear-gradient(135deg, oklch(78% 0.16 70), oklch(72% 0.20 30)); }
+        .header-nav { display: flex; gap: 22px; font-size: 0.92rem; color: var(--cdr-ui-muted, oklch(68% 0.01 90)); }
+        .header-actions { display: flex; align-items: center; gap: 14px; }
+
+        .form-stage { padding: 56px 24px; display: grid; place-items: start center; }
+        .form-card {
+          width: 100%; max-width: 640px;
+          background: color-mix(in oklab, var(--cdr-ui-surface, oklch(17% 0.012 90)) 92%, transparent);
+          border: 1px solid var(--cdr-ui-border, oklch(24% 0.012 90));
+          border-radius: 18px;
+          padding: 36px 32px 32px;
+          box-shadow: 0 1px 0 color-mix(in oklab, oklch(100% 0 0) 5%, transparent) inset, 0 24px 48px -24px color-mix(in oklab, oklch(0% 0 0) 50%, transparent);
+        }
+        .eyebrow { font-family: ui-monospace, monospace; font-size: 0.72rem; letter-spacing: 0.08em; text-transform: uppercase; color: var(--cdr-ui-accent, oklch(78% 0.16 70)); margin: 0 0 10px; }
+        .form-title {
+          font-size: clamp(1.8rem, 3.4vw, 2.4rem); font-weight: 800; letter-spacing: -0.025em; line-height: 1.1; margin: 0 0 12px;
+          background: linear-gradient(135deg, var(--cdr-ui-fg, #fafafa), color-mix(in oklab, var(--cdr-ui-fg) 60%, var(--cdr-ui-primary, oklch(78% 0.16 70))));
+          -webkit-background-clip: text; background-clip: text; color: transparent;
+        }
+        .form-lede { font-size: 0.98rem; line-height: 1.6; color: var(--cdr-ui-muted, oklch(72% 0.01 90)); margin: 0 0 28px; }
+
+        .result-list { list-style: none; padding: 0; margin: 0; display: grid; gap: 16px; }
+        .result-item {
+          padding: 14px 16px;
+          background: color-mix(in oklab, var(--cdr-ui-bg) 60%, transparent);
+          border: 1px solid var(--cdr-ui-border);
+          border-radius: 12px;
+        }
+        .result-meta { display: flex; justify-content: space-between; font-family: ui-monospace, monospace; font-size: 0.78rem; color: var(--cdr-ui-muted); margin: 0 0 8px; }
+        .result-vault { color: var(--cdr-ui-primary); }
+        .result-fields {
+          margin: 0; padding: 12px; border-radius: 8px;
+          background: color-mix(in oklab, oklch(0% 0 0) 50%, transparent);
+          font-family: ui-monospace, monospace; font-size: 0.82rem; line-height: 1.5;
+          overflow-x: auto;
+        }
+      `),
+    },
+    {
+      path: "README.md",
+      content: dedent(`
+        # cdr-kit forms
+
+        End-to-end encrypted form submissions on Story Aeneid. Built on
+        [\`@cdr-kit/forms\`](https://cdr-kit.dev/docs/forms).
+
+        \`\`\`bash
+        pnpm install
+        cp .env.local.example .env.local      # add WALLET_PRIVATE_KEY + PINATA_JWT
+        pnpm dev                              # http://localhost:3000
+        \`\`\`
+
+        ## How it works
+
+        - The respondent fills \`<CdrField>\`s and clicks \`<CdrSubmitButton>\`.
+        - \`<CdrForm onEncrypt={...}>\` posts the fields to \`/api/respond\`.
+        - The route calls \`storeFormSubmission()\` from \`@cdr-kit/forms/server\`,
+          which signs with the platform wallet (your \`WALLET_PRIVATE_KEY\`),
+          uploads the encrypted blob through the configured storage adapter
+          (Pinata by default — see \`lib/storage.ts\`), and allocates a fresh
+          CDR vault per submission.
+        - The vault UUID + CID is returned; persist it to your DB alongside the
+          form ID so the creator can decrypt via \`readFormSubmission()\`.
+
+        Respondents **never hold a wallet**. Gas + signature + storage cost is
+        the platform's burden.
+
+        ## Swapping the storage adapter
+
+        Edit \`lib/storage.ts\`. Five other adapters are documented inline:
+
+        - \`createSupabaseStorage({ url, key, bucket })\` — Postgres-backed
+        - \`createIpfsStorage({ addUrl, gatewayUrl })\` — any IPFS HTTP API
+        - \`createS3Storage({ endpoint, region, accessKey, secretKey, bucket })\` — AWS S3 / R2 / B2
+        - \`createStorachaStorage({ agentDelegation, spaceDid })\` — web3.storage / w3up
+        - \`createHeliaStorage()\` — self-hosted Helia node
+
+        Whatever you pick, make sure \`/api/respond\` and \`/api/results\` use the
+        same adapter — that's why both routes import \`getStorage()\` from one place.
+
+        Full docs: <https://cdr-kit.dev/docs/forms>
+      `),
+    },
+    { path: ".gitignore", content: GITIGNORE },
+    {
+      path: ".env.local.example",
+      content: dedent(`
+        # ====== REQUIRED ======
+        # Funded Aeneid testnet wallet (chain ID 1315) — pays for vault creation + writes.
+        # Get testnet IP at https://aeneid.faucet.story.foundation/
+        WALLET_PRIVATE_KEY=0x_your_aeneid_testnet_private_key
+
+        # Pinata JWT for IPFS pinning. Free signup at https://app.pinata.cloud/developers/api-keys
+        PINATA_JWT=eyJ...
+        # PINATA_GATEWAY_URL=https://your-gateway.mypinata.cloud  # optional
+
+        # ====== OPTIONAL — only needed for WalletConnect-protocol wallets ======
+        # NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
+
+        # ====== ALTERNATIVES — uncomment if you swap the adapter in lib/storage.ts ======
+        # SUPABASE_URL=https://xxxx.supabase.co
+        # SUPABASE_SERVICE_ROLE_KEY=
+        # SUPABASE_BUCKET=cdr-blobs
+
+        # IPFS_ADD_URL=http://localhost:5001/api/v0/add
+        # IPFS_GATEWAY_URL=http://localhost:8080
+
+        # S3_ENDPOINT=https://s3.amazonaws.com
+        # S3_REGION=us-east-1
+        # S3_ACCESS_KEY=
+        # S3_SECRET_KEY=
+        # S3_BUCKET=
+      `),
+    },
+  ],
+};
diff --git a/packages/create-cdr-kit-app/src/templates/index.ts b/packages/create-cdr-kit-app/src/templates/index.ts
index c876b82..07efc55 100644
--- a/packages/create-cdr-kit-app/src/templates/index.ts
+++ b/packages/create-cdr-kit-app/src/templates/index.ts
@@ -2,15 +2,19 @@ import type { Template, TemplateName } from "./types.js";
 import { STARTER } from "./starter.js";
 import { BLOG } from "./blog.js";
 import { PAYWALL } from "./paywall.js";
+import { DATA_MARKETPLACE } from "./data-marketplace.js";
+import { FORMS } from "./forms.js";
 import { MCP_SERVER } from "./mcp-server.js";
 import { AGENT_VERCEL_AI, AGENT_OPENAI, AGENT_LANGCHAIN, AGENT_AGENTKIT, AGENT_GOAT } from "./agents.js";
 
 export type { Template, TemplateFile, TemplateName } from "./types.js";
 
-const TEMPLATES: Record<TemplateName, Template> = {
+const TEMPLATES: Partial<Record<TemplateName, Template>> = {
   starter: STARTER,
   blog: BLOG,
   paywall: PAYWALL,
+  "data-marketplace": DATA_MARKETPLACE,
+  forms: FORMS,
   "mcp-server": MCP_SERVER,
   "agent-vercel-ai": AGENT_VERCEL_AI,
   "agent-openai": AGENT_OPENAI,
@@ -26,5 +30,7 @@ export function getTemplate(name: TemplateName): Template {
 }
 
 export function listTemplates(): { name: TemplateName; description: string }[] {
-  return Object.values(TEMPLATES).map((t) => ({ name: t.name, description: t.description }));
+  return Object.values(TEMPLATES)
+    .filter((t): t is Template => Boolean(t))
+    .map((t) => ({ name: t.name, description: t.description }));
 }
diff --git a/packages/create-cdr-kit-app/src/templates/paywall.ts b/packages/create-cdr-kit-app/src/templates/paywall.ts
index b0d5545..5571a5e 100644
--- a/packages/create-cdr-kit-app/src/templates/paywall.ts
+++ b/packages/create-cdr-kit-app/src/templates/paywall.ts
@@ -1,9 +1,25 @@
 import { dedent } from "../util.js";
-import { CDR_VERSION, type Template } from "./types.js";
+import {
+  ENV_LOCAL_EXAMPLE,
+  GITIGNORE,
+  NEXT_CONFIG_TS,
+  NEXT_ENV_DTS,
+  PROVIDERS_TSX,
+  SHARED_DEPS,
+  SHARED_DEV_DEPS,
+  THEME_INIT_SCRIPT,
+  TSCONFIG_JSON,
+} from "./shared.js";
+import type { Template } from "./types.js";
 
+/**
+ * Single-page paywall: one Subscribe CTA gates the whole content block.
+ * Real Aeneid integration. No mock. Connect a wallet to interact.
+ */
 export const PAYWALL: Template = {
   name: "paywall",
-  description: "Next.js single-page paywall — one Subscribe CTA gates the whole content block (classic pattern).",
+  description:
+    "Next.js single-page paywall — one Subscribe CTA on real Aeneid CDR, dark premium card.",
   postInstall: ["pnpm install", "pnpm dev   # http://localhost:3000"],
   files: [
     {
@@ -13,120 +29,207 @@ export const PAYWALL: Template = {
           name: "cdr-kit-paywall",
           private: true,
           version: "0.0.1",
-          scripts: { dev: "next dev", build: "next build", start: "next start" },
-          dependencies: {
-            "@cdr-kit/contracts": CDR_VERSION,
-            "@cdr-kit/core": CDR_VERSION,
-            "@cdr-kit/react": CDR_VERSION,
-            "@cdr-kit/react-ui": CDR_VERSION,
-            "@tanstack/react-query": "^5.62.0",
-            next: "^16.2.6",
-            react: "^19.2.0",
-            "react-dom": "^19.2.0",
-            viem: "^2.51.3",
-            wagmi: "^2.14.0",
+          scripts: {
+            dev: "next dev",
+            build: "next build",
+            start: "next start",
+            lint: "next lint",
           },
-          devDependencies: { "@types/node": "^20", "@types/react": "^19", "@types/react-dom": "^19", typescript: "^5.7.2" },
+          dependencies: SHARED_DEPS,
+          devDependencies: SHARED_DEV_DEPS,
         },
         null,
         2,
       ),
     },
-    {
-      path: "tsconfig.json",
-      content: JSON.stringify(
-        {
-          compilerOptions: {
-            target: "ES2022",
-            lib: ["dom", "dom.iterable", "esnext"],
-            module: "esnext",
-            moduleResolution: "bundler",
-            jsx: "preserve",
-            strict: true,
-            esModuleInterop: true,
-            skipLibCheck: true,
-            isolatedModules: true,
-            noEmit: true,
-            resolveJsonModule: true,
-            allowJs: true,
-            plugins: [{ name: "next" }],
-            paths: { "@/*": ["./*"] },
-          },
-          include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-          exclude: ["node_modules"],
-        },
-        null,
-        2,
-      ),
-    },
-    { path: "next.config.ts", content: "export default { reactStrictMode: true };\n" },
-    { path: "next-env.d.ts", content: '/// <reference types="next" />\n/// <reference types="next/types/global" />\n' },
+    { path: "tsconfig.json", content: TSCONFIG_JSON },
+    { path: "next.config.ts", content: NEXT_CONFIG_TS },
+    { path: "next-env.d.ts", content: NEXT_ENV_DTS },
     {
       path: "app/layout.tsx",
       content: dedent(`
         import type { ReactNode } from "react";
         import { Providers } from "./providers";
+        import { PaywallHeader } from "./header";
         import "@cdr-kit/react-ui/styles.css";
+        import "./globals.css";
 
-        export const metadata = { title: "Paywalled report", description: "Subscribe to read." };
+        export const metadata = {
+          title: "This week's signal — cdr-kit paywall",
+          description: "Subscribe to decrypt the trade signal. Real Aeneid CDR.",
+        };
 
         export default function RootLayout({ children }: { children: ReactNode }) {
-          return <html lang="en"><body>{<Providers>{children}</Providers>}</body></html>;
+          return (
+            <html lang="en" data-theme="dark" suppressHydrationWarning>
+              <head>
+                ${THEME_INIT_SCRIPT}
+              </head>
+              <body>
+                <Providers>
+                  <PaywallHeader />
+                  <main>{children}</main>
+                </Providers>
+              </body>
+            </html>
+          );
         }
       `),
     },
+    { path: "app/providers.tsx", content: PROVIDERS_TSX },
     {
-      path: "app/providers.tsx",
+      path: "app/header.tsx",
       content: dedent(`
         "use client";
-        import { useMemo, type ReactNode } from "react";
-        import { CdrProvider } from "@cdr-kit/react";
-        import { createMockCdrKit } from "@cdr-kit/core";
 
-        const PAYLOAD = JSON.stringify({ signal: "BUY", pair: "ETH/USD", confidence: 0.86, ttl: "30d" }, null, 2);
+        import { ConnectButton } from "@rainbow-me/rainbowkit";
+        import { CdrNetworkChip } from "@cdr-kit/react-ui";
 
-        export function Providers({ children }: { children: ReactNode }) {
-          const kit = useMemo(() => {
-            const k = createMockCdrKit({ readDelayMs: 2200, threshold: 7 });
-            void k.writeVaultData({ uuid: 4200, dataKey: new TextEncoder().encode(PAYLOAD) });
-            return k;
-          }, []);
-          return <CdrProvider mockKit={kit}>{children}</CdrProvider>;
+        export function PaywallHeader() {
+          return (
+            <header className="site-header">
+              <div className="brand">
+                <span className="brand-dot" aria-hidden />
+                <span>signal.cdr</span>
+              </div>
+              <div className="header-actions">
+                <CdrNetworkChip mode="live" />
+                <ConnectButton accountStatus="address" chainStatus="icon" />
+              </div>
+            </header>
+          );
         }
       `),
     },
     {
       path: "app/page.tsx",
       content: dedent(`
-        import { SubscribeButton } from "@cdr-kit/react-ui";
+        import { SubscribeButton, IpPrice, ConditionBadge } from "@cdr-kit/react-ui";
+
+        /** Real Aeneid vault — deployed via the cdr-kit factory. */
+        const VAULT_ID = 4200;
+        const PRICE_WEI = 5n * 10n ** 18n;
 
         export default function Page() {
           return (
-            <main style={{ maxWidth: 560, margin: "0 auto", padding: "64px 24px", fontFamily: "system-ui" }}>
-              <h1 style={{ fontSize: "2.2rem", letterSpacing: "-0.02em", marginBottom: 14 }}>This week's signal</h1>
-              <p style={{ color: "#666", lineHeight: 1.6, marginBottom: 32 }}>
-                A confidential trade signal. Subscribe to decrypt and view the JSON payload locally —
-                the data never enters your bundle. Mock CDR · 5 IP / month.
-              </p>
-              <SubscribeButton uuid={4200} priceWei={5n * 10n ** 18n} priceLabel="5 $IP" />
-            </main>
+            <section className="paywall-stage">
+              <article className="paywall-card">
+                <div className="card-meta">
+                  <ConditionBadge kind="subscription">Subscription</ConditionBadge>
+                  <IpPrice wei={PRICE_WEI} period="month" />
+                </div>
+                <h1 className="card-title">This week's signal</h1>
+                <p className="card-lede">
+                  Confidential trade signal — encrypted via Story CDR. Subscribe to decrypt and view
+                  the JSON payload locally. The data never enters your bundle, server logs, or DOM
+                  until your wallet's read succeeds.
+                </p>
+                <SubscribeButton uuid={VAULT_ID} priceWei={PRICE_WEI} priceLabel="5 $IP / month" />
+                <p className="card-hint">
+                  Real Aeneid testnet. Need IP?{" "}
+                  <a href="https://aeneid.faucet.story.foundation/" target="_blank" rel="noreferrer">
+                    Grab free testnet IP →
+                  </a>
+                </p>
+              </article>
+            </section>
           );
         }
       `),
     },
+    {
+      path: "app/globals.css",
+      content: dedent(`
+        :root { color-scheme: dark light; }
+        * { box-sizing: border-box; }
+        html { background: var(--cdr-ui-bg, oklch(13% 0.012 90)); }
+        body {
+          margin: 0;
+          font-family: var(--cdr-ui-font-sans, ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif);
+          background: var(--cdr-ui-bg, oklch(13% 0.012 90));
+          color: var(--cdr-ui-fg, oklch(94% 0.01 90));
+          -webkit-font-smoothing: antialiased;
+          min-height: 100vh;
+        }
+        a { color: var(--cdr-ui-primary, oklch(78% 0.16 70)); text-decoration: none; }
+        a:hover { text-decoration: underline; }
+
+        .site-header {
+          display: flex; align-items: center; justify-content: space-between;
+          padding: 18px 28px;
+          border-bottom: 1px solid var(--cdr-ui-border, oklch(22% 0.012 90));
+          backdrop-filter: blur(8px);
+          position: sticky; top: 0; z-index: 10;
+          background: color-mix(in oklab, var(--cdr-ui-bg) 80%, transparent);
+        }
+        .brand { display: flex; align-items: center; gap: 10px; font-weight: 600; letter-spacing: -0.01em; font-family: ui-monospace, monospace; }
+        .brand-dot {
+          width: 10px; height: 10px; border-radius: 999px;
+          background: linear-gradient(135deg, oklch(78% 0.16 70), oklch(72% 0.20 30));
+        }
+        .header-actions { display: flex; align-items: center; gap: 14px; }
+
+        .paywall-stage {
+          min-height: calc(100vh - 70px);
+          display: grid; place-items: center;
+          padding: 48px 24px;
+          background:
+            radial-gradient(800px 400px at 50% 0%, color-mix(in oklab, oklch(78% 0.16 70) 12%, transparent), transparent),
+            var(--cdr-ui-bg);
+        }
+        .paywall-card {
+          width: 100%; max-width: 520px;
+          background: color-mix(in oklab, var(--cdr-ui-surface, oklch(17% 0.012 90)) 92%, transparent);
+          border: 1px solid var(--cdr-ui-border, oklch(24% 0.012 90));
+          border-radius: 20px;
+          padding: 36px 32px 32px;
+          box-shadow:
+            0 1px 0 color-mix(in oklab, oklch(100% 0 0) 6%, transparent) inset,
+            0 24px 48px -24px color-mix(in oklab, oklch(0% 0 0) 50%, transparent);
+        }
+        .card-meta {
+          display: flex; align-items: center; justify-content: space-between; margin: 0 0 22px;
+        }
+        .card-title {
+          font-size: clamp(1.8rem, 3.4vw, 2.4rem);
+          font-weight: 800; letter-spacing: -0.025em; line-height: 1.1; margin: 0 0 14px;
+          background: linear-gradient(135deg, var(--cdr-ui-fg, #fafafa) 0%, color-mix(in oklab, var(--cdr-ui-fg) 60%, var(--cdr-ui-primary, oklch(78% 0.16 70))) 100%);
+          -webkit-background-clip: text; background-clip: text; color: transparent;
+        }
+        .card-lede {
+          font-size: 0.98rem; line-height: 1.65; color: var(--cdr-ui-muted, oklch(70% 0.01 90));
+          margin: 0 0 24px;
+        }
+        .card-hint {
+          margin-top: 18px; font-size: 0.84rem;
+          color: var(--cdr-ui-muted, oklch(60% 0.01 90));
+        }
+      `),
+    },
     {
       path: "README.md",
       content: dedent(`
         # cdr-kit paywall
 
+        Classic single-block paywall: \`<SubscribeButton>\` runs subscribe → threshold-read → decrypt → reveal.
+
         \`\`\`bash
-        pnpm install && pnpm dev
+        pnpm install
+        pnpm dev      # http://localhost:3000
         \`\`\`
 
-        Classic single-block paywall pattern: <SubscribeButton> runs subscribe → threshold-read → decrypt → reveal. To go live on Aeneid, swap the mock provider in \`app/providers.tsx\` for a real wagmi config + apiUrl. Use \`uploadFile()\` from \`@cdr-kit/core\` to encrypt + allocate a real vault and update the uuid.
+        Connect any wallet that supports Story Aeneid (chain ID 1315). Grab testnet IP from
+        <https://aeneid.faucet.story.foundation/>. Click Subscribe → real on-chain payment → decrypted JSON renders.
+
+        ## Using your own vault
+
+        1. Run \`uploadFile()\` from \`@cdr-kit/core\` server-side (or the \`cdr\` CLI) with your real data + a SubscriptionCondition.
+        2. Update \`VAULT_ID\` and \`PRICE_WEI\` in \`app/page.tsx\`.
+
+        Full docs: <https://cdr-kit.dev>
       `),
     },
-    { path: ".gitignore", content: "node_modules\n.next\ndist\n.env\n.env.local\n.env.*.local\n" },
+    { path: ".gitignore", content: GITIGNORE },
+    { path: ".env.local.example", content: ENV_LOCAL_EXAMPLE },
   ],
 };
-
diff --git a/packages/create-cdr-kit-app/src/templates/shared.ts b/packages/create-cdr-kit-app/src/templates/shared.ts
new file mode 100644
index 0000000..8c98a9b
--- /dev/null
+++ b/packages/create-cdr-kit-app/src/templates/shared.ts
@@ -0,0 +1,114 @@
+import { dedent } from "../util.js";
+
+/**
+ * Shared snippets reused by every "premium" template (blog, paywall, data-marketplace, forms).
+ * Every template wires real wagmi + RainbowKit + CdrConfigProvider against Aeneid testnet.
+ * No mock — when the user has no wallet connected, the components render their own connect CTAs.
+ */
+
+export const PROVIDERS_TSX = dedent(`
+  "use client";
+
+  import { useState, type ReactNode } from "react";
+  import { WagmiProvider, http } from "wagmi";
+  import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+  import { RainbowKitProvider, getDefaultConfig, midnightTheme } from "@rainbow-me/rainbowkit";
+  import { CdrConfigProvider } from "@cdr-kit/react";
+  import "@rainbow-me/rainbowkit/styles.css";
+
+  const aeneid = {
+    id: 1315,
+    name: "Story Aeneid Testnet",
+    nativeCurrency: { name: "IP", symbol: "IP", decimals: 18 },
+    rpcUrls: { default: { http: ["https://aeneid.storyrpc.io"] } },
+    blockExplorers: { default: { name: "Aeneid Explorer", url: "https://aeneid.storyscan.xyz" } },
+  } as const;
+
+  const config = getDefaultConfig({
+    appName: "cdr-kit app",
+    projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID ?? "dev",
+    chains: [aeneid],
+    transports: { [aeneid.id]: http() },
+    ssr: true,
+  });
+
+  /** Real CDR provider — connects to Aeneid testnet. No mock anywhere.
+   *  Visitors without a wallet see the components render their own
+   *  Connect prompts; once they connect, every flow runs on real chain. */
+  export function Providers({ children }: { children: ReactNode }) {
+    const [queryClient] = useState(() => new QueryClient());
+    return (
+      <WagmiProvider config={config}>
+        <QueryClientProvider client={queryClient}>
+          <RainbowKitProvider theme={midnightTheme()}>
+            <CdrConfigProvider>{children}</CdrConfigProvider>
+          </RainbowKitProvider>
+        </QueryClientProvider>
+      </WagmiProvider>
+    );
+  }
+`);
+
+export const THEME_INIT_SCRIPT = `<script dangerouslySetInnerHTML={{ __html: "try{var t=localStorage.getItem('cdr-theme')||'dark';document.documentElement.setAttribute('data-theme',t);}catch(e){document.documentElement.setAttribute('data-theme','dark');}" }} />`;
+
+export const SHARED_DEPS = {
+  "@cdr-kit/contracts": "^0.7.0",
+  "@cdr-kit/core": "^0.7.0",
+  "@cdr-kit/react": "^0.7.0",
+  "@cdr-kit/react-ui": "^0.7.0",
+  "@rainbow-me/rainbowkit": "^2.2.0",
+  "@tanstack/react-query": "^5.62.0",
+  next: "^16.2.6",
+  react: "^19.2.0",
+  "react-dom": "^19.2.0",
+  viem: "^2.51.3",
+  wagmi: "^2.14.0",
+};
+
+export const SHARED_DEV_DEPS = {
+  "@types/node": "^20",
+  "@types/react": "^19",
+  "@types/react-dom": "^19",
+  typescript: "^5.7.2",
+};
+
+export const TSCONFIG_JSON = JSON.stringify(
+  {
+    compilerOptions: {
+      target: "ES2022",
+      lib: ["dom", "dom.iterable", "esnext"],
+      module: "esnext",
+      moduleResolution: "bundler",
+      jsx: "preserve",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      isolatedModules: true,
+      noEmit: true,
+      incremental: true,
+      resolveJsonModule: true,
+      allowJs: true,
+      plugins: [{ name: "next" }],
+      paths: { "@/*": ["./*"] },
+    },
+    include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+    exclude: ["node_modules"],
+  },
+  null,
+  2,
+);
+
+export const NEXT_ENV_DTS = '/// <reference types="next" />\n/// <reference types="next/types/global" />\n';
+
+export const NEXT_CONFIG_TS = "export default { reactStrictMode: true };\n";
+
+export const ENV_LOCAL_EXAMPLE = dedent(`
+  # WalletConnect (optional — only needed for WalletConnect-protocol wallets).
+  # Get one free at https://cloud.walletconnect.com
+  # NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
+
+  # For server-side helpers that write to CDR (forms / data-marketplace):
+  # WALLET_PRIVATE_KEY=0x...funded-aeneid-testnet-wallet...
+`);
+
+export const GITIGNORE = "node_modules\n.next\ndist\n.env\n.env.local\n.env.*.local\n";
diff --git a/packages/create-cdr-kit-app/src/templates/starter.ts b/packages/create-cdr-kit-app/src/templates/starter.ts
index 7729d86..355f807 100644
--- a/packages/create-cdr-kit-app/src/templates/starter.ts
+++ b/packages/create-cdr-kit-app/src/templates/starter.ts
@@ -3,8 +3,14 @@ import { CDR_VERSION, type Template } from "./types.js";
 
 export const STARTER: Template = {
   name: "starter",
-  description: "Minimal Node script — runs the CDR mock flow end-to-end. Good for verifying the kit works in your env.",
-  postInstall: ["pnpm install", "pnpm start"],
+  description:
+    "Minimal Node script — runs the full CDR allocate → write → read flow against real Aeneid testnet.",
+  postInstall: [
+    "pnpm install",
+    "cp .env.example .env",
+    "# add your funded Aeneid testnet WALLET_PRIVATE_KEY=0x...",
+    "pnpm start",
+  ],
   files: [
     {
       path: "package.json",
@@ -14,8 +20,15 @@ export const STARTER: Template = {
           private: true,
           type: "module",
           scripts: { start: "tsx src/index.ts" },
-          dependencies: { "@cdr-kit/core": CDR_VERSION, consola: "^3.2.3" },
-          devDependencies: { tsx: "^4.19.2", typescript: "^5.7.2" },
+          dependencies: {
+            "@cdr-kit/agent": CDR_VERSION,
+            "@cdr-kit/contracts": CDR_VERSION,
+            "@cdr-kit/core": CDR_VERSION,
+            consola: "^3.2.3",
+            dotenv: "^16.4.7",
+            viem: "^2.51.3",
+          },
+          devDependencies: { tsx: "^4.19.2", typescript: "^5.7.2", "@types/node": "^20" },
         },
         null,
         2,
@@ -24,7 +37,16 @@ export const STARTER: Template = {
     {
       path: "tsconfig.json",
       content: JSON.stringify(
-        { compilerOptions: { target: "ES2022", module: "ESNext", moduleResolution: "Bundler", strict: true } },
+        {
+          compilerOptions: {
+            target: "ES2022",
+            module: "ESNext",
+            moduleResolution: "Bundler",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+          },
+        },
         null,
         2,
       ),
@@ -32,19 +54,40 @@ export const STARTER: Template = {
     {
       path: "src/index.ts",
       content: dedent(`
-        import { createMockCdrKit } from "@cdr-kit/core";
+        import "dotenv/config";
+        import { createCdrAgent } from "@cdr-kit/agent";
         import { consola } from "consola";
 
-        // Mock mode: the full CDR flow (incl. the threshold-decrypt read) with no wallet/chain.
-        const kit = createMockCdrKit({ readDelayMs: 800, threshold: 4 });
+        const privateKey = process.env.WALLET_PRIVATE_KEY as \`0x\${string}\` | undefined;
+        if (!privateKey) {
+          consola.error("Missing WALLET_PRIVATE_KEY env. Copy .env.example to .env and add a funded Aeneid testnet wallet.");
+          consola.info("Grab free testnet IP from https://aeneid.faucet.story.foundation/");
+          process.exit(1);
+        }
+
+        const agent = createCdrAgent({ privateKey, rpcUrl: "https://aeneid.storyrpc.io" });
+
+        const secret = new TextEncoder().encode("hello from cdr-kit on real Aeneid");
+
+        consola.start("creating real CDR vault on Aeneid…");
+        const { uuid, txHash } = await agent.createVault({});
+        consola.success(\`vault uuid=\${uuid}  tx=\${txHash}\`);
 
-        const secret = new TextEncoder().encode("hello from cdr-kit");
-        const { uuid } = await kit.createVault({ data: secret });
-        consola.info(\`created vault \${uuid}\`);
+        consola.start("writing encrypted data via CDR precompile…");
+        await agent.writeVaultData({ uuid, dataKey: secret });
+        consola.success("write confirmed");
 
-        consola.start("reading (simulated CDR threshold-decrypt)…");
-        const data = await kit.accessVault({ uuid, onProgress: (p) => consola.info(\`  partials \${p.collected}/\${p.threshold}\`) });
-        consola.success(\`decrypted: \${new TextDecoder().decode(data)}\`);
+        consola.start("reading + decrypting (threshold-decrypt over the network)…");
+        const bytes = await agent.readVaultData({ uuid });
+        consola.success(\`decrypted: \${new TextDecoder().decode(bytes)}\`);
+      `),
+    },
+    {
+      path: ".env.example",
+      content: dedent(`
+        # Required: funded Aeneid testnet wallet (chain ID 1315)
+        # Get free testnet IP at https://aeneid.faucet.story.foundation/
+        WALLET_PRIVATE_KEY=0x_your_aeneid_testnet_private_key
       `),
     },
     {
@@ -52,14 +95,20 @@ export const STARTER: Template = {
       content: dedent(`
         # cdr-kit starter
 
+        Runs the full CDR flow (allocate → write encrypted → threshold-decrypt read) against
+        **real Aeneid testnet** — no mock. Proves your environment can talk to CDR end to end.
+
         \`\`\`bash
         pnpm install
-        pnpm start   # runs the mock-mode CDR flow — no wallet/chain needed
+        cp .env.example .env       # add your funded Aeneid testnet WALLET_PRIVATE_KEY
+        pnpm start
         \`\`\`
 
-        Swap \`createMockCdrKit()\` for \`createCdrKitClient({ privateKey, apiUrl })\` + the flow helpers to go live on Aeneid. See https://github.com/Blockchain-Oracle/cdr-kit
+        Need testnet IP? <https://aeneid.faucet.story.foundation/>
+
+        Full docs: <https://cdr-kit.dev>
       `),
     },
-    { path: ".gitignore", content: "node_modules\ndist\n" },
+    { path: ".gitignore", content: "node_modules\ndist\n.env\n" },
   ],
 };
diff --git a/packages/create-cdr-kit-app/src/templates/types.ts b/packages/create-cdr-kit-app/src/templates/types.ts
index 525daf1..12dd6f8 100644
--- a/packages/create-cdr-kit-app/src/templates/types.ts
+++ b/packages/create-cdr-kit-app/src/templates/types.ts
@@ -2,6 +2,8 @@ export type TemplateName =
   | "starter"
   | "blog"
   | "paywall"
+  | "data-marketplace"
+  | "forms"
   | "mcp-server"
   | "agent-vercel-ai"
   | "agent-openai"
@@ -24,4 +26,4 @@ export interface Template {
 }
 
 /** The `@cdr-kit/*` peer-dep version templates ship with. Bumped per release. */
-export const CDR_VERSION = "^0.5.0";
+export const CDR_VERSION = "^0.7.0";
diff --git a/packages/create-cdr-kit-app/test/scaffold.test.ts b/packages/create-cdr-kit-app/test/scaffold.test.ts
index 46f9b64..c8af731 100644
--- a/packages/create-cdr-kit-app/test/scaffold.test.ts
+++ b/packages/create-cdr-kit-app/test/scaffold.test.ts
@@ -11,12 +11,12 @@ describe("create-cdr-kit-app scaffold", () => {
     base = undefined;
   });
 
-  it("writes a runnable mock-mode starter tree", () => {
+  it("writes a runnable starter tree (no-mock, real Aeneid)", () => {
     base = mkdtempSync(join(tmpdir(), "cdrkit-"));
     const target = join(base, "my-app");
     scaffold(target);
 
-    for (const f of ["package.json", "tsconfig.json", "README.md", ".gitignore", "src/index.ts"]) {
+    for (const f of ["package.json", "tsconfig.json", "README.md", ".gitignore", "src/index.ts", ".env.example"]) {
       expect(existsSync(join(target, f)), `${f} should exist`).toBe(true);
     }
     const pkg = JSON.parse(readFileSync(join(target, "package.json"), "utf8")) as {
@@ -24,11 +24,15 @@ describe("create-cdr-kit-app scaffold", () => {
       scripts: Record<string, string>;
     };
     expect(pkg.dependencies["@cdr-kit/core"]).toBeDefined();
+    expect(pkg.dependencies["@cdr-kit/agent"]).toBeDefined();
     expect(pkg.scripts.start).toContain("tsx");
 
     const index = readFileSync(join(target, "src", "index.ts"), "utf8");
-    expect(index).toContain("createMockCdrKit");
-    expect(index).toContain("accessVault");
+    // 0.7 ships real Aeneid; no mock anywhere
+    expect(index).not.toContain("createMockCdrKit");
+    expect(index).toContain("createCdrAgent");
+    expect(index).toContain("aeneid.storyrpc.io");
+    expect(index).toContain("WALLET_PRIVATE_KEY");
   });
 
   it("refuses to overwrite an existing path", () => {
@@ -38,7 +42,7 @@ describe("create-cdr-kit-app scaffold", () => {
     expect(() => scaffold(target)).toThrow(/refusing to overwrite/);
   });
 
-  it("writes the blog template with Next.js + UnlockablePill wiring", () => {
+  it("writes the blog template with Next.js + UnlockablePill on real Aeneid", () => {
     base = mkdtempSync(join(tmpdir(), "cdrkit-"));
     const target = join(base, "my-blog");
     scaffold(target, { template: "blog" });
@@ -51,6 +55,7 @@ describe("create-cdr-kit-app scaffold", () => {
       "app/layout.tsx",
       "app/page.tsx",
       "app/providers.tsx",
+      "app/header.tsx",
       "app/globals.css",
       "scripts/upload.ts",
       "README.md",
@@ -64,24 +69,115 @@ describe("create-cdr-kit-app scaffold", () => {
       dependencies: Record<string, string>;
       scripts: Record<string, string>;
     };
-    expect(pkg.dependencies["@cdr-kit/react-ui"]).toBe("^0.5.0");
-    expect(pkg.dependencies["@cdr-kit/core"]).toBe("^0.5.0");
+    expect(pkg.dependencies["@cdr-kit/react-ui"]).toBe("^0.7.0");
+    expect(pkg.dependencies["@cdr-kit/core"]).toBe("^0.7.0");
+    expect(pkg.dependencies["@rainbow-me/rainbowkit"]).toBeDefined();
     expect(pkg.dependencies.next).toBeDefined();
     expect(pkg.scripts.dev).toContain("next");
 
     const page = readFileSync(join(target, "app/page.tsx"), "utf8");
     expect(page).toContain("UnlockablePill");
-    expect(page).toContain("uuid={4242}");
+    expect(page).toContain("VAULT_EXHIBIT");
 
     const providers = readFileSync(join(target, "app/providers.tsx"), "utf8");
-    expect(providers).toContain("createMockCdrKit");
-    expect(providers).toContain("writeVaultData");
+    // 0.7 — real Aeneid, no mock
+    expect(providers).not.toContain("createMockCdrKit");
+    expect(providers).not.toContain("mockKit");
+    expect(providers).toContain("WagmiProvider");
+    expect(providers).toContain("CdrConfigProvider");
+    expect(providers).toContain("RainbowKitProvider");
+    expect(providers).toContain("aeneid.storyrpc.io");
 
     const upload = readFileSync(join(target, "scripts/upload.ts"), "utf8");
     expect(upload).toContain("uploadFile");
     expect(upload).toContain("WALLET_PRIVATE_KEY");
   });
 
+  it("writes the data-marketplace flagship template (live discovery grid)", () => {
+    base = mkdtempSync(join(tmpdir(), "cdrkit-"));
+    const target = join(base, "my-marketplace");
+    scaffold(target, { template: "data-marketplace" });
+
+    for (const f of [
+      "package.json",
+      "app/page.tsx",
+      "app/hero.tsx",
+      "app/discovery-grid.tsx",
+      "app/providers.tsx",
+      "app/header.tsx",
+      "README.md",
+    ]) {
+      expect(existsSync(join(target, f)), `${f} should exist`).toBe(true);
+    }
+
+    const grid = readFileSync(join(target, "app/discovery-grid.tsx"), "utf8");
+    expect(grid).toContain("useDiscoverVaults");
+    expect(grid).toContain("VaultCard");
+    expect(grid).toContain("SubscribeButton");
+    expect(grid).not.toContain("createMockCdrKit");
+
+    const providers = readFileSync(join(target, "app/providers.tsx"), "utf8");
+    expect(providers).not.toContain("createMockCdrKit");
+  });
+
+  it("writes the forms template — Pinata adapter wired through lib/storage.ts", () => {
+    base = mkdtempSync(join(tmpdir(), "cdrkit-"));
+    const target = join(base, "my-forms");
+    scaffold(target, { template: "forms" });
+
+    for (const f of [
+      "package.json",
+      "app/page.tsx",
+      "app/results/page.tsx",
+      "app/api/respond/route.ts",
+      "app/api/results/route.ts",
+      "app/providers.tsx",
+      "app/header.tsx",
+      "lib/storage.ts",
+      ".env.local.example",
+      "README.md",
+    ]) {
+      expect(existsSync(join(target, f)), `${f} should exist`).toBe(true);
+    }
+
+    const pkg = JSON.parse(readFileSync(join(target, "package.json"), "utf8")) as {
+      dependencies: Record<string, string>;
+    };
+    expect(pkg.dependencies["@cdr-kit/forms"]).toBe("^0.7.0");
+    expect(pkg.dependencies["@cdr-kit/agent"]).toBeDefined();
+
+    const page = readFileSync(join(target, "app/page.tsx"), "utf8");
+    expect(page).toContain("CdrForm");
+    expect(page).toContain("CdrField");
+    expect(page).toContain("CdrSubmitButton");
+    // Picker is gone — storage adapter is a server concern, not a respondent UX choice.
+    expect(page).not.toContain("StorageProviderPicker");
+    expect(page).not.toContain("createMockCdrKit");
+
+    const storage = readFileSync(join(target, "lib/storage.ts"), "utf8");
+    expect(storage).toContain("createPinataStorage");
+    expect(storage).toContain("PINATA_JWT");
+    // Other 5 adapters documented inline as swap options:
+    for (const f of [
+      "createSupabaseStorage",
+      "createIpfsStorage",
+      "createS3Storage",
+      "createStorachaStorage",
+      "createHeliaStorage",
+    ]) {
+      expect(storage).toContain(f);
+    }
+
+    const respond = readFileSync(join(target, "app/api/respond/route.ts"), "utf8");
+    expect(respond).toContain("storeFormSubmission");
+    expect(respond).toContain("@cdr-kit/forms/server");
+    expect(respond).toContain("getStorage");
+
+    const env = readFileSync(join(target, ".env.local.example"), "utf8");
+    expect(env).toContain("WALLET_PRIVATE_KEY");
+    expect(env).toContain("PINATA_JWT");
+  });
+
   it("rejects an unknown template", () => {
     base = mkdtempSync(join(tmpdir(), "cdrkit-"));
     const target = join(base, "x");
diff --git a/packages/forms/README.md b/packages/forms/README.md
new file mode 100644
index 0000000..c74631e
--- /dev/null
+++ b/packages/forms/README.md
@@ -0,0 +1,41 @@
+# @cdr-kit/forms
+
+Encrypted form submission components for [Story Protocol CDR](https://cdr-kit.dev). Drop in `<CdrForm>` + `<CdrField>` + `<StorageProviderPicker>`, wire `onEncrypt` to the bundled server helper (`@cdr-kit/forms/server`), and every submission becomes a CDR vault — multi-provider storage, platform-wallet payment, whole-form encryption — with no decrypt key on the client.
+
+## Install
+
+```sh
+pnpm add @cdr-kit/forms @cdr-kit/react @cdr-kit/core
+```
+
+## Quickstart
+
+```tsx
+// app/contact/page.tsx
+import { CdrForm, CdrField, CdrSubmitButton } from "@cdr-kit/forms";
+import "@cdr-kit/forms/styles.css";
+import { encryptFormAction } from "./actions";
+
+export default function ContactPage() {
+  return (
+    <CdrForm onEncrypt={encryptFormAction} onSuccess={(id) => console.log("vault", id)}>
+      <CdrField name="email" label="Email" type="email" required />
+      <CdrField name="message" label="Message" type="textarea" required />
+      <CdrSubmitButton />
+    </CdrForm>
+  );
+}
+```
+
+```ts
+// app/contact/actions.ts
+"use server";
+import { storeFormSubmission } from "@cdr-kit/forms/server";
+
+export async function encryptFormAction(fields: Record<string, FormDataEntryValue>) {
+  const { vaultId } = await storeFormSubmission(fields, { privateKey: process.env.PLATFORM_KEY! as `0x${string}` });
+  return vaultId;
+}
+```
+
+Docs: [cdr-kit.dev/docs/forms](https://cdr-kit.dev/docs/forms).
diff --git a/packages/forms/package.json b/packages/forms/package.json
new file mode 100644
index 0000000..38ef4c5
--- /dev/null
+++ b/packages/forms/package.json
@@ -0,0 +1,79 @@
+{
+  "name": "@cdr-kit/forms",
+  "version": "0.7.0",
+  "description": "Encrypted form submission components for CDR — multi-provider storage, platform wallet, whole-form encryption.",
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.mts",
+        "default": "./dist/server.mjs"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
+    },
+    "./styles.css": "./src/styles.css",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "src/styles.css",
+    "src/assets"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist .turbo"
+  },
+  "peerDependencies": {
+    "@cdr-kit/core": ">=0.6.0",
+    "@cdr-kit/react": ">=0.6.0",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@cdr-kit/core": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "consola": "^3.2.3"
+  },
+  "devDependencies": {
+    "@cdr-kit/agent": "workspace:*",
+    "@cdr-kit/contracts": "workspace:*",
+    "@cdr-kit/core": "workspace:*",
+    "@cdr-kit/react": "workspace:*",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.2.0",
+    "happy-dom": "^15.11.7",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tsdown": "^0.22.0",
+    "typescript": "^5.7.2",
+    "viem": "^2.51.3",
+    "vitest": "^2.1.9"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}
diff --git a/packages/forms/src/cdr-field.tsx b/packages/forms/src/cdr-field.tsx
new file mode 100644
index 0000000..c414aec
--- /dev/null
+++ b/packages/forms/src/cdr-field.tsx
@@ -0,0 +1,133 @@
+"use client";
+import { useId, type ReactNode } from "react";
+
+/** Field type — drives which input is rendered. */
+export type CdrFieldType = "text" | "textarea" | "email" | "number" | "select" | "radio" | "checkbox";
+
+export interface CdrFieldOption {
+  value: string;
+  label: string;
+}
+
+export interface CdrFieldProps {
+  /** Submitted as the FormData key — required for the value to round-trip into `onEncrypt`. */
+  name: string;
+  /** Visible label rendered above the input. */
+  label?: ReactNode;
+  /** Renders the matching primitive. Defaults to "text". */
+  type?: CdrFieldType;
+  placeholder?: string;
+  required?: boolean;
+  defaultValue?: string;
+  /** Options for `type="select" | "radio"`. */
+  options?: CdrFieldOption[];
+  /** Visible help text below the input. */
+  hint?: ReactNode;
+  /** Pass to the underlying input (e.g. `min`, `step` for number, `rows` for textarea). */
+  inputProps?: Record<string, unknown>;
+  className?: string;
+}
+
+/**
+ * Renders a labeled input bound to a FormData key. The `<CdrForm>` parent
+ * harvests it via `Object.fromEntries(FormData)` on submit.
+ * @param name FormData key — required.
+ * @param type Input primitive: text | textarea | email | number | select | radio | checkbox.
+ * @param options Required for `select` and `radio`.
+ */
+export function CdrField({
+  name,
+  label,
+  type = "text",
+  placeholder,
+  required,
+  defaultValue,
+  options,
+  hint,
+  inputProps,
+  className,
+}: CdrFieldProps) {
+  const id = useId();
+  const rootClass = ["cdr-forms-field", className].filter(Boolean).join(" ");
+  const common = {
+    id,
+    name,
+    required,
+    placeholder,
+    defaultValue,
+    className: "cdr-forms-input",
+    ...(inputProps as Record<string, unknown>),
+  };
+
+  return (
+    <div className={rootClass} data-cdr-field data-type={type}>
+      {label !== undefined && (
+        <label htmlFor={type === "checkbox" || type === "radio" ? undefined : id} className="cdr-forms-label">
+          {label}
+          {required && (
+            <span aria-hidden="true" className="cdr-forms-required">
+              *
+            </span>
+          )}
+        </label>
+      )}
+      {renderInput(type, name, common, options)}
+      {hint !== undefined && <p className="cdr-forms-hint">{hint}</p>}
+    </div>
+  );
+}
+
+function renderInput(
+  type: CdrFieldType,
+  name: string,
+  common: Record<string, unknown>,
+  options: CdrFieldOption[] | undefined,
+) {
+  if (type === "textarea") {
+    return <textarea {...common} className="cdr-forms-input cdr-forms-input--textarea" />;
+  }
+  if (type === "select") {
+    return (
+      <select {...common} className="cdr-forms-input cdr-forms-input--select">
+        {(options ?? []).map((o) => (
+          <option key={o.value} value={o.value}>
+            {o.label}
+          </option>
+        ))}
+      </select>
+    );
+  }
+  if (type === "radio") {
+    const { defaultValue: dv } = common as { defaultValue?: string };
+    return (
+      <div className="cdr-forms-radiogroup" role="radiogroup">
+        {(options ?? []).map((o) => (
+          <label key={o.value} className="cdr-forms-radio">
+            <input
+              type="radio"
+              name={name}
+              value={o.value}
+              defaultChecked={dv === o.value}
+              required={common.required as boolean | undefined}
+            />
+            <span>{o.label}</span>
+          </label>
+        ))}
+      </div>
+    );
+  }
+  if (type === "checkbox") {
+    return (
+      <label className="cdr-forms-checkbox">
+        <input
+          type="checkbox"
+          name={name}
+          required={common.required as boolean | undefined}
+          defaultChecked={Boolean(common.defaultValue)}
+        />
+      </label>
+    );
+  }
+  // text | email | number
+  return <input {...common} type={type} />;
+}
diff --git a/packages/forms/src/cdr-form.tsx b/packages/forms/src/cdr-form.tsx
new file mode 100644
index 0000000..44e6fdb
--- /dev/null
+++ b/packages/forms/src/cdr-form.tsx
@@ -0,0 +1,109 @@
+"use client";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useMemo,
+  useState,
+  type FormEvent,
+  type FormHTMLAttributes,
+  type ReactNode,
+} from "react";
+
+/** Public shape of values consumers pass through `onEncrypt`. */
+export type CdrFormFields = Record<string, FormDataEntryValue>;
+
+/** Encrypt callback — runs on submit. Return the new vault id (uint32 from CDR). */
+export type CdrEncryptFn = (fields: CdrFormFields) => Promise<number>;
+
+export interface CdrFormContextValue {
+  /** True while `onEncrypt` is in flight. */
+  isLoading: boolean;
+  /** True once a submission succeeded; `vaultId` will be set. */
+  isCompleted: boolean;
+  /** Most recent error thrown by `onEncrypt`. */
+  error: Error | null;
+  /** The vault id returned by the most recent successful submission. */
+  vaultId: number | null;
+}
+
+const CdrFormContext = createContext<CdrFormContextValue | null>(null);
+
+/** Hook for {@link CdrSubmitButton} et al. — reads the parent form's submit state. */
+export function useCdrFormContext(): CdrFormContextValue {
+  const v = useContext(CdrFormContext);
+  if (!v) throw new Error("@cdr-kit/forms: useCdrFormContext must be used inside <CdrForm>");
+  return v;
+}
+
+export interface CdrFormProps extends Omit<FormHTMLAttributes<HTMLFormElement>, "onSubmit" | "onError"> {
+  /** Encrypt the submitted fields and return the new vault id. */
+  onEncrypt: CdrEncryptFn;
+  /** Called after `onEncrypt` resolves; receives the new vault id. */
+  onSuccess?: (vaultId: number) => void;
+  /** Called when `onEncrypt` rejects. */
+  onError?: (error: Error) => void;
+  children: ReactNode;
+}
+
+/**
+ * Wraps a `<form>` and runs `onEncrypt(Object.fromEntries(FormData))` on submit.
+ * Provides the loading/completed state to children via {@link useCdrFormContext}.
+ * @param onEncrypt Encrypt + store the form payload; resolves to the new vault id.
+ * @param onSuccess Called with the vault id after a successful submission.
+ * @param onError Called with the thrown Error if `onEncrypt` rejects.
+ */
+export function CdrForm({
+  onEncrypt,
+  onSuccess,
+  onError,
+  children,
+  className,
+  ...rest
+}: CdrFormProps) {
+  const [isLoading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+  const [vaultId, setVaultId] = useState<number | null>(null);
+
+  const handleSubmit = useCallback(
+    async (e: FormEvent<HTMLFormElement>) => {
+      e.preventDefault();
+      if (isLoading) return;
+      setLoading(true);
+      setError(null);
+      try {
+        const fields = Object.fromEntries(new FormData(e.currentTarget));
+        const id = await onEncrypt(fields);
+        setVaultId(id);
+        onSuccess?.(id);
+      } catch (err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        setError(wrapped);
+        onError?.(wrapped);
+      } finally {
+        setLoading(false);
+      }
+    },
+    [isLoading, onEncrypt, onSuccess, onError],
+  );
+
+  const ctx = useMemo<CdrFormContextValue>(
+    () => ({ isLoading, isCompleted: vaultId !== null, error, vaultId }),
+    [isLoading, vaultId, error],
+  );
+
+  return (
+    <CdrFormContext.Provider value={ctx}>
+      <form
+        {...rest}
+        className={["cdr-forms-form", className].filter(Boolean).join(" ")}
+        onSubmit={handleSubmit}
+        data-cdr-form
+        data-loading={isLoading || undefined}
+        data-completed={vaultId !== null || undefined}
+      >
+        {children}
+      </form>
+    </CdrFormContext.Provider>
+  );
+}
diff --git a/packages/forms/src/cdr-submit-button.tsx b/packages/forms/src/cdr-submit-button.tsx
new file mode 100644
index 0000000..08bd865
--- /dev/null
+++ b/packages/forms/src/cdr-submit-button.tsx
@@ -0,0 +1,41 @@
+"use client";
+import type { ButtonHTMLAttributes, ReactNode } from "react";
+import { useCdrFormContext } from "./cdr-form.js";
+
+export interface CdrSubmitButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+  /** Default idle label. */
+  children?: ReactNode;
+  /** Label shown while the encrypt call is in flight. */
+  loadingLabel?: ReactNode;
+  /** Label shown after a successful submission. */
+  completedLabel?: ReactNode;
+}
+
+/**
+ * Submit button bound to the parent {@link CdrForm} state.
+ * Renders `loadingLabel` while encrypting, `completedLabel` after success,
+ * and `children` (default "Submit securely") at rest.
+ */
+export function CdrSubmitButton({
+  children = "Submit securely",
+  loadingLabel = "Encrypting…",
+  completedLabel = "Submitted ✓",
+  className,
+  disabled,
+  ...rest
+}: CdrSubmitButtonProps) {
+  const { isLoading, isCompleted } = useCdrFormContext();
+  const label = isCompleted ? completedLabel : isLoading ? loadingLabel : children;
+  return (
+    <button
+      type="submit"
+      {...rest}
+      className={["cdr-forms-submit", className].filter(Boolean).join(" ")}
+      disabled={disabled || isLoading || isCompleted}
+      data-loading={isLoading || undefined}
+      data-completed={isCompleted || undefined}
+    >
+      {label}
+    </button>
+  );
+}
diff --git a/packages/forms/src/index.ts b/packages/forms/src/index.ts
new file mode 100644
index 0000000..753f493
--- /dev/null
+++ b/packages/forms/src/index.ts
@@ -0,0 +1,11 @@
+export { CdrForm, useCdrFormContext } from "./cdr-form.js";
+export type { CdrFormProps, CdrFormContextValue, CdrFormFields, CdrEncryptFn } from "./cdr-form.js";
+
+export { CdrField } from "./cdr-field.js";
+export type { CdrFieldProps, CdrFieldType, CdrFieldOption } from "./cdr-field.js";
+
+export { CdrSubmitButton } from "./cdr-submit-button.js";
+export type { CdrSubmitButtonProps } from "./cdr-submit-button.js";
+
+export { useCdrSubmit } from "./use-cdr-submit.js";
+export type { CdrSubmitOptions, CdrSubmitResult } from "./use-cdr-submit.js";
diff --git a/packages/forms/src/server.ts b/packages/forms/src/server.ts
new file mode 100644
index 0000000..9cef46e
--- /dev/null
+++ b/packages/forms/src/server.ts
@@ -0,0 +1,181 @@
+import "server-only";
+import { consola } from "consola";
+import type { Hex } from "viem";
+// Type-only — erased at build. The runtime values for these modules are loaded
+// via the lazy-import pattern below so client-only consumers don't have to
+// install them.
+import type { CdrStorageProvider } from "@cdr-kit/core";
+import type { CdrFormFields } from "./cdr-form.js";
+
+const log = consola.withTag("cdr-forms");
+
+type CdrAgentModule = typeof import("@cdr-kit/agent");
+type CdrCoreModule = typeof import("@cdr-kit/core");
+type CdrContractsModule = typeof import("@cdr-kit/contracts");
+
+function dynamicImport<T>(specifier: string): Promise<T> {
+  // Hide the literal specifier from build-time resolution (Vite/Rollup static-analysis trap).
+  // Same pattern as the storage-adapter ecosystem in @cdr-kit/core (CLAUDE.md).
+  const dyn = new Function("s", "return import(s)") as (s: string) => Promise<T>;
+  return dyn(specifier);
+}
+
+const loadAgentModule = () => dynamicImport<CdrAgentModule>("@cdr-kit/agent");
+const loadCoreModule = () => dynamicImport<CdrCoreModule>("@cdr-kit/core");
+const loadContractsModule = () => dynamicImport<CdrContractsModule>("@cdr-kit/contracts");
+
+export interface StoreFormSubmissionParams {
+  /** Hex private key of the wallet that pays for vault creation + writes. */
+  privateKey: Hex;
+  /**
+   * The `CdrStorageProvider` adapter the encrypted form payload uploads through.
+   *
+   * Build with one of the six factories from `@cdr-kit/core`:
+   * `createPinataStorage` · `createSupabaseStorage` · `createIpfsStorage`
+   * `createS3Storage` · `createStorachaStorage` · `createHeliaStorage`
+   *
+   * Storage is **required** — the form's encrypted bytes have to land somewhere
+   * the read path can fetch them from. Configure the adapter in server code
+   * with env vars (PINATA_JWT, SUPABASE_URL+KEY, etc.); never expose the choice
+   * to respondents.
+   */
+  storage: CdrStorageProvider;
+  /** Override the network's canonical RPC URL. Defaults to Aeneid testnet. */
+  rpcUrl?: string;
+  /** Defaults to OpenCondition (anyone-can-read) — pass a tighter gate for production. */
+  readConditionAddr?: Hex;
+  /** ABI-encoded config for `readConditionAddr`. Defaults to "0x" (no config). */
+  readConditionData?: Hex;
+  /** Pin the IPFS CID after upload. Defaults to `true`. */
+  pin?: boolean;
+}
+
+export interface StoreFormSubmissionResult {
+  /** Global CDR vault counter — use to read the submission back. */
+  vaultId: number;
+  /** IPFS CID returned by the storage adapter — useful for audit logs. */
+  cid: string;
+  /** Allocate + write tx hashes for on-chain receipts. */
+  txHashes: { allocate: Hex; write: Hex };
+}
+
+/**
+ * Encrypt + store a form submission via the supplied storage adapter.
+ *
+ * Server-only. Call from a Next.js route handler or server action with a
+ * pre-configured `storage`. The respondent never picks or constructs the
+ * adapter — the developer wires it once with env-backed credentials.
+ *
+ * @param fields The submitted form fields (typically `Object.fromEntries(formData)`).
+ * @param params `{ privateKey, storage, rpcUrl?, readConditionAddr?, readConditionData?, pin? }`.
+ * @returns `{ vaultId, cid, txHashes }`.
+ */
+export async function storeFormSubmission(
+  fields: CdrFormFields,
+  params: StoreFormSubmissionParams,
+): Promise<StoreFormSubmissionResult> {
+  if (!params.storage) {
+    throw new Error(
+      "@cdr-kit/forms: storeFormSubmission requires a CdrStorageProvider — " +
+        "build one with createPinataStorage / createSupabaseStorage / createIpfsStorage / " +
+        "createS3Storage / createStorachaStorage / createHeliaStorage from @cdr-kit/core.",
+    );
+  }
+
+  const [{ CdrAgent }, core, contracts] = await Promise.all([
+    loadAgentModule(),
+    loadCoreModule(),
+    loadContractsModule(),
+  ]);
+  const { uploadFile } = core;
+  const { resolveAddresses } = contracts;
+
+  const agent = new CdrAgent({ privateKey: params.privateKey, rpcUrl: params.rpcUrl });
+  const addrs = resolveAddresses(agent.network);
+  const readConditionAddr = params.readConditionAddr ?? (addrs.openCondition as Hex);
+  const readConditionData = params.readConditionData ?? "0x";
+
+  const payload = JSON.stringify({
+    answers: serializeFields(fields),
+    submittedAt: new Date().toISOString(),
+  });
+  const bytes = new TextEncoder().encode(payload);
+
+  log.info(
+    { fields: Object.keys(fields).length, bytes: bytes.length },
+    "storeFormSubmission: uploading via storage adapter",
+  );
+
+  // CdrAgent already holds a CdrKitClient — reuse it instead of constructing a second one.
+  const res = await uploadFile(agent.client, {
+    content: bytes,
+    storage: params.storage,
+    readConditionAddr,
+    readConditionData,
+    pin: params.pin ?? true,
+  });
+
+  log.success({ uuid: res.uuid, cid: res.cid }, "storeFormSubmission: stored");
+  return { vaultId: res.uuid, cid: res.cid, txHashes: res.txHashes };
+}
+
+export interface ReadFormSubmissionParams {
+  /** Hex private key of a wallet authorized to read the vault. */
+  privateKey: Hex;
+  /** Same storage adapter used to write — needed to download the blob. */
+  storage: CdrStorageProvider;
+  /** Override the network's canonical RPC URL. */
+  rpcUrl?: string;
+}
+
+export interface ReadFormSubmissionResult {
+  /** The decoded form fields. */
+  fields: Record<string, string>;
+  /** ISO-8601 timestamp written at submit time. */
+  submittedAt: string;
+}
+
+/**
+ * Read + decrypt a form submission stored via {@link storeFormSubmission}.
+ * @param vaultId The uuid returned by `storeFormSubmission`.
+ * @param params `{ privateKey, storage, rpcUrl? }`.
+ * @returns `{ fields, submittedAt }`.
+ */
+export async function readFormSubmission(
+  vaultId: number,
+  params: ReadFormSubmissionParams,
+): Promise<ReadFormSubmissionResult> {
+  if (!params.storage) {
+    throw new Error(
+      "@cdr-kit/forms: readFormSubmission requires the same CdrStorageProvider used to write.",
+    );
+  }
+
+  const [{ CdrAgent }, core] = await Promise.all([loadAgentModule(), loadCoreModule()]);
+  const { downloadFile } = core;
+
+  const agent = new CdrAgent({ privateKey: params.privateKey, rpcUrl: params.rpcUrl });
+
+  log.info({ vaultId }, "readFormSubmission: downloading via storage adapter");
+  const { content } = await downloadFile(agent.client, { uuid: vaultId, storage: params.storage });
+  const payload = JSON.parse(new TextDecoder().decode(content)) as {
+    answers: Record<string, string>;
+    submittedAt: string;
+  };
+  return { fields: payload.answers, submittedAt: payload.submittedAt };
+}
+
+/** Form fields can include File objects; we coerce to strings for JSON serialization. */
+export function serializeFields(fields: CdrFormFields): Record<string, string> {
+  const out: Record<string, string> = {};
+  for (const [k, v] of Object.entries(fields)) {
+    if (typeof v === "string") {
+      out[k] = v;
+    } else if (v && typeof v === "object" && "name" in v) {
+      out[k] = `[file:${(v as { name: string }).name}]`;
+    } else {
+      out[k] = String(v ?? "");
+    }
+  }
+  return out;
+}
diff --git a/packages/forms/src/styles.css b/packages/forms/src/styles.css
new file mode 100644
index 0000000..db61be3
--- /dev/null
+++ b/packages/forms/src/styles.css
@@ -0,0 +1,85 @@
+/* @cdr-kit/forms — opt-in default theme.
+ *   import "@cdr-kit/forms/styles.css";
+ * Tokens are --cdr-forms-* on [data-cdr-form] roots; override to theme. Light is default,
+ * dark via [data-theme="dark"]. No Tailwind, no animation libraries. */
+
+:where([data-cdr-form]) {
+  --cdr-forms-bg: oklch(0.992 0.004 95);
+  --cdr-forms-card: oklch(1 0 0);
+  --cdr-forms-fg: oklch(0.235 0.013 65);
+  --cdr-forms-muted: oklch(0.55 0.012 70);
+  --cdr-forms-line: oklch(0.905 0.006 85);
+  --cdr-forms-line-2: oklch(0.86 0.007 85);
+  --cdr-forms-primary: oklch(0.52 0.20 268);
+  --cdr-forms-primary-soft: oklch(0.52 0.20 268 / 0.10);
+  --cdr-forms-primary-line: oklch(0.52 0.20 268 / 0.32);
+  --cdr-forms-on-primary: oklch(0.99 0.004 95);
+  --cdr-forms-danger: oklch(0.57 0.20 26);
+  --cdr-forms-radius: 9px;
+  --cdr-forms-radius-sm: 5px;
+  --cdr-forms-font: system-ui, -apple-system, sans-serif;
+}
+
+[data-theme="dark"] :where([data-cdr-form]) {
+  --cdr-forms-bg: oklch(0.175 0.008 265);
+  --cdr-forms-card: oklch(0.215 0.009 265);
+  --cdr-forms-fg: oklch(0.955 0.004 95);
+  --cdr-forms-muted: oklch(0.66 0.012 250);
+  --cdr-forms-line: oklch(0.30 0.010 265);
+  --cdr-forms-line-2: oklch(0.37 0.012 265);
+  --cdr-forms-primary: oklch(0.66 0.18 268);
+  --cdr-forms-primary-soft: oklch(0.66 0.18 268 / 0.16);
+  --cdr-forms-primary-line: oklch(0.66 0.18 268 / 0.40);
+  --cdr-forms-on-primary: oklch(0.16 0.01 265);
+  --cdr-forms-danger: oklch(0.70 0.18 26);
+}
+
+/* ----- form root + field shell ----- */
+.cdr-forms-form {
+  display: flex;
+  flex-direction: column;
+  gap: 18px;
+  font-family: var(--cdr-forms-font);
+  color: var(--cdr-forms-fg);
+}
+.cdr-forms-field { display: flex; flex-direction: column; gap: 6px; }
+.cdr-forms-label { font-size: 0.85rem; font-weight: 600; color: var(--cdr-forms-fg); display: inline-flex; gap: 4px; }
+.cdr-forms-required { color: var(--cdr-forms-danger); }
+.cdr-forms-hint { font-size: 0.78rem; color: var(--cdr-forms-muted); margin: 0; }
+
+/* ----- inputs ----- */
+.cdr-forms-input {
+  font: inherit;
+  color: var(--cdr-forms-fg);
+  background: var(--cdr-forms-card);
+  border: 1px solid var(--cdr-forms-line);
+  border-radius: var(--cdr-forms-radius-sm);
+  padding: 9px 12px;
+  width: 100%;
+  outline: none;
+  transition: border-color .14s ease, box-shadow .14s ease;
+}
+.cdr-forms-input:focus-visible {
+  border-color: var(--cdr-forms-primary-line);
+  box-shadow: 0 0 0 3px var(--cdr-forms-primary-soft);
+}
+.cdr-forms-input--textarea { min-height: 96px; resize: vertical; font-family: var(--cdr-forms-font); }
+.cdr-forms-input--select { appearance: none; padding-right: 32px; background-image: linear-gradient(45deg, transparent 50%, currentColor 50%), linear-gradient(135deg, currentColor 50%, transparent 50%); background-position: calc(100% - 16px) calc(50% - 2px), calc(100% - 11px) calc(50% - 2px); background-size: 5px 5px; background-repeat: no-repeat; }
+
+.cdr-forms-radiogroup { display: flex; flex-direction: column; gap: 8px; }
+.cdr-forms-radio, .cdr-forms-checkbox { display: inline-flex; align-items: center; gap: 8px; font-size: 0.9rem; cursor: pointer; }
+
+/* ----- submit button ----- */
+.cdr-forms-submit {
+  display: inline-flex; align-items: center; justify-content: center; gap: 8px;
+  font-family: var(--cdr-forms-font); font-weight: 600; font-size: 0.95rem;
+  padding: 11px 18px;
+  border-radius: var(--cdr-forms-radius);
+  border: 1px solid transparent;
+  background: var(--cdr-forms-primary); color: var(--cdr-forms-on-primary);
+  cursor: pointer; line-height: 1;
+  transition: background-color .16s ease, transform .12s ease, opacity .16s ease;
+}
+.cdr-forms-submit:active { transform: translateY(1px); }
+.cdr-forms-submit:disabled { opacity: 0.6; cursor: default; }
+.cdr-forms-submit[data-completed] { background: oklch(0.58 0.15 152); }
diff --git a/packages/forms/src/use-cdr-submit.ts b/packages/forms/src/use-cdr-submit.ts
new file mode 100644
index 0000000..ed4d3e6
--- /dev/null
+++ b/packages/forms/src/use-cdr-submit.ts
@@ -0,0 +1,67 @@
+"use client";
+import { useCallback, useState } from "react";
+import type { CdrFormFields } from "./cdr-form.js";
+
+export interface CdrSubmitOptions {
+  /** Encrypt + store the submitted fields. Return the new vault id. */
+  onEncrypt: (fields: CdrFormFields) => Promise<number>;
+  /** Called after `onEncrypt` resolves; receives the new vault id. */
+  onSuccess?: (vaultId: number) => void;
+  /** Called when `onEncrypt` rejects. */
+  onError?: (error: Error) => void;
+}
+
+export interface CdrSubmitResult {
+  /** Run the encrypt call. Resolves to the vault id on success, throws on failure. */
+  submit: (fields: CdrFormFields) => Promise<number>;
+  /** True while `onEncrypt` is in flight. */
+  isLoading: boolean;
+  /** Most recent error from a failed submit, or null. */
+  error: Error | null;
+  /** Vault id of the most recent successful submit, or null. */
+  vaultId: number | null;
+  /** Clear vaultId + error so the form can accept another submission. */
+  reset: () => void;
+}
+
+/**
+ * Isomorphic submit hook for custom forms (i.e. when you can't or don't want to use {@link CdrForm}).
+ * The `onEncrypt` callback is abstract — wire it to a server action, a fetch to /api, or a
+ * client-side encrypt path.
+ *
+ * @param onEncrypt Encrypts the submitted fields and resolves to a vault id.
+ * @returns `{ submit, isLoading, error, vaultId, reset }`.
+ */
+export function useCdrSubmit({ onEncrypt, onSuccess, onError }: CdrSubmitOptions): CdrSubmitResult {
+  const [isLoading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+  const [vaultId, setVaultId] = useState<number | null>(null);
+
+  const submit = useCallback(
+    async (fields: CdrFormFields) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const id = await onEncrypt(fields);
+        setVaultId(id);
+        onSuccess?.(id);
+        return id;
+      } catch (err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        setError(wrapped);
+        onError?.(wrapped);
+        throw wrapped;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [onEncrypt, onSuccess, onError],
+  );
+
+  const reset = useCallback(() => {
+    setVaultId(null);
+    setError(null);
+  }, []);
+
+  return { submit, isLoading, error, vaultId, reset };
+}
diff --git a/packages/forms/test/cdr-form.test.tsx b/packages/forms/test/cdr-form.test.tsx
new file mode 100644
index 0000000..75d5679
--- /dev/null
+++ b/packages/forms/test/cdr-form.test.tsx
@@ -0,0 +1,82 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen, fireEvent, waitFor } from "@testing-library/react";
+import React from "react";
+import { CdrForm } from "../src/cdr-form.js";
+import { CdrField } from "../src/cdr-field.js";
+import { CdrSubmitButton } from "../src/cdr-submit-button.js";
+
+describe("<CdrForm>", () => {
+  it("renders children inside a form with data-cdr-form attribute", () => {
+    const { container } = render(
+      <CdrForm onEncrypt={async () => 1}>
+        <CdrField name="name" label="Name" />
+        <CdrSubmitButton>Submit</CdrSubmitButton>
+      </CdrForm>,
+    );
+    expect(container.querySelector("form[data-cdr-form]")).not.toBeNull();
+    expect(screen.getByLabelText("Name")).toBeDefined();
+  });
+
+  it("posts every CdrField value to onEncrypt as a Record<string, FormDataEntryValue>", async () => {
+    const onEncrypt = vi.fn(async () => 7);
+    render(
+      <CdrForm onEncrypt={onEncrypt}>
+        <CdrField name="mood" label="Mood" />
+        <CdrField name="note" label="Note" type="textarea" />
+        <CdrSubmitButton>Submit</CdrSubmitButton>
+      </CdrForm>,
+    );
+
+    fireEvent.change(screen.getByLabelText("Mood"), { target: { value: "8" } });
+    fireEvent.change(screen.getByLabelText("Note"), { target: { value: "hello" } });
+    fireEvent.click(screen.getByRole("button", { name: /submit/i }));
+
+    await waitFor(() => expect(onEncrypt).toHaveBeenCalledOnce());
+    expect(onEncrypt).toHaveBeenCalledWith({ mood: "8", note: "hello" });
+  });
+
+  it("CdrSubmitButton renders Submitted ✓ after a successful submit", async () => {
+    render(
+      <CdrForm onEncrypt={async () => 11}>
+        <CdrSubmitButton>Submit securely</CdrSubmitButton>
+      </CdrForm>,
+    );
+    fireEvent.click(screen.getByRole("button", { name: /submit/i }));
+    await waitFor(() => expect(screen.getByText("Submitted ✓")).toBeDefined());
+  });
+});
+
+describe("<CdrField>", () => {
+  it("renders each type with the right input element", () => {
+    const { rerender } = render(<CdrField name="x" label="X" type="text" />);
+    expect(screen.getByLabelText("X").tagName).toBe("INPUT");
+
+    rerender(<CdrField name="x" label="X" type="textarea" />);
+    expect(screen.getByLabelText("X").tagName).toBe("TEXTAREA");
+
+    rerender(
+      <CdrField
+        name="x"
+        label="X"
+        type="select"
+        options={[{ value: "a", label: "A" }]}
+      />,
+    );
+    expect(screen.getByLabelText("X").tagName).toBe("SELECT");
+  });
+
+  it("renders radio options when type=radio", () => {
+    render(
+      <CdrField
+        name="size"
+        type="radio"
+        options={[
+          { value: "s", label: "Small" },
+          { value: "m", label: "Medium" },
+        ]}
+      />,
+    );
+    expect(screen.getByLabelText("Small")).toBeDefined();
+    expect(screen.getByLabelText("Medium")).toBeDefined();
+  });
+});
diff --git a/packages/forms/test/use-cdr-submit.test.tsx b/packages/forms/test/use-cdr-submit.test.tsx
new file mode 100644
index 0000000..b348afd
--- /dev/null
+++ b/packages/forms/test/use-cdr-submit.test.tsx
@@ -0,0 +1,69 @@
+import { describe, it, expect, vi } from "vitest";
+import { renderHook, act } from "@testing-library/react";
+import { useCdrSubmit } from "../src/use-cdr-submit.js";
+
+describe("useCdrSubmit", () => {
+  it("starts idle with no vault and no error", () => {
+    const { result } = renderHook(() =>
+      useCdrSubmit({ onEncrypt: async () => 1 }),
+    );
+    expect(result.current.isLoading).toBe(false);
+    expect(result.current.error).toBeNull();
+    expect(result.current.vaultId).toBeNull();
+  });
+
+  it("calls onEncrypt and records the returned vault id on success", async () => {
+    const onEncrypt = vi.fn(async (fields: Record<string, unknown>) => {
+      expect(fields).toEqual({ name: "Abu" });
+      return 4242;
+    });
+    const onSuccess = vi.fn();
+    const { result } = renderHook(() => useCdrSubmit({ onEncrypt, onSuccess }));
+
+    await act(async () => {
+      await result.current.submit({ name: "Abu" });
+    });
+
+    expect(onEncrypt).toHaveBeenCalledOnce();
+    expect(onSuccess).toHaveBeenCalledWith(4242);
+    expect(result.current.vaultId).toBe(4242);
+    expect(result.current.error).toBeNull();
+    expect(result.current.isLoading).toBe(false);
+  });
+
+  it("captures the error from onEncrypt and exposes it on error", async () => {
+    const boom = new Error("bad");
+    const onError = vi.fn();
+    const { result } = renderHook(() =>
+      useCdrSubmit({
+        onEncrypt: async () => {
+          throw boom;
+        },
+        onError,
+      }),
+    );
+
+    await act(async () => {
+      try {
+        await result.current.submit({});
+      } catch {
+        // expected
+      }
+    });
+
+    expect(result.current.error).toBe(boom);
+    expect(result.current.vaultId).toBeNull();
+    expect(onError).toHaveBeenCalledWith(boom);
+  });
+
+  it("reset clears state back to idle", async () => {
+    const { result } = renderHook(() => useCdrSubmit({ onEncrypt: async () => 9 }));
+    await act(async () => {
+      await result.current.submit({});
+    });
+    expect(result.current.vaultId).toBe(9);
+    act(() => result.current.reset());
+    expect(result.current.vaultId).toBeNull();
+    expect(result.current.error).toBeNull();
+  });
+});
diff --git a/packages/forms/tsconfig.json b/packages/forms/tsconfig.json
new file mode 100644
index 0000000..c899da4
--- /dev/null
+++ b/packages/forms/tsconfig.json
@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "outDir": "dist",
+    "jsx": "react-jsx"
+  }
+}
diff --git a/packages/forms/tsdown.config.ts b/packages/forms/tsdown.config.ts
new file mode 100644
index 0000000..817b184
--- /dev/null
+++ b/packages/forms/tsdown.config.ts
@@ -0,0 +1,22 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig([
+  // Client entry: every TSX file uses hooks/context, so banner the whole bundle as a
+  // React Server Components client module (mirrors @cdr-kit/react).
+  {
+    entry: ["src/index.ts"],
+    format: ["esm", "cjs"],
+    dts: true,
+    treeshake: true,
+    external: ["react", "react/jsx-runtime", "@cdr-kit/react", "@cdr-kit/core", "@cdr-kit/contracts"],
+    outputOptions: { banner: '"use client";' },
+  },
+  // Server entry: lazy-loads @cdr-kit/agent at runtime — never bundle it.
+  {
+    entry: ["src/server.ts"],
+    format: ["esm", "cjs"],
+    dts: true,
+    treeshake: true,
+    external: ["@cdr-kit/agent", "@cdr-kit/core", "@cdr-kit/contracts", "viem", "consola", "server-only"],
+  },
+]);
diff --git a/packages/forms/vitest.config.ts b/packages/forms/vitest.config.ts
new file mode 100644
index 0000000..30eed03
--- /dev/null
+++ b/packages/forms/vitest.config.ts
@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "happy-dom",
+    globals: true,
+    include: ["test/**/*.test.ts", "test/**/*.test.tsx"],
+  },
+});
diff --git a/packages/react/src/story-hooks.ts b/packages/react/src/story-hooks.ts
index 5b72740..e287cb4 100644
--- a/packages/react/src/story-hooks.ts
+++ b/packages/react/src/story-hooks.ts
@@ -23,7 +23,13 @@ type StoryMod = typeof import("@cdr-kit/story");
 let storyModulePromise: Promise<StoryMod> | null = null;
 async function loadStoryModule(): Promise<StoryMod> {
   if (!storyModulePromise) {
-    storyModulePromise = import("@cdr-kit/story").catch(() => {
+    // Hide the literal specifier from build-time static resolution. Turbopack
+    // and Vite both try to resolve any `import("@cdr-kit/story")` at compile
+    // time and fail the build when the optional peer isn't installed. Routing
+    // through `new Function("s", ...)` makes the specifier opaque to the
+    // analyzer. CLAUDE.md pattern — same as the storage-adapter ecosystem.
+    const dynImport = new Function("s", "return import(s)") as (s: string) => Promise<StoryMod>;
+    storyModulePromise = dynImport("@cdr-kit/story").catch(() => {
       storyModulePromise = null;
       throw new Error(
         "@cdr-kit/story is required for Story IP hooks. Install: pnpm add @cdr-kit/story @story-protocol/core-sdk",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index b3ca906..ea9789c 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -43,22 +43,31 @@ importers:
     dependencies:
       '@cdr-kit/contracts':
         specifier: npm:@cdr-kit/contracts@^0.5.0
-        version: 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+        version: 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       '@cdr-kit/core':
         specifier: npm:@cdr-kit/core@^0.5.0
-        version: 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+        version: 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       '@cdr-kit/react':
         specifier: npm:@cdr-kit/react@^0.5.0
-        version: 0.5.0(fe6219abba1ce2fd38b5b8d62dc518fa)
+        version: 0.5.0(78f83cda882c8eaeee56bebfc104fe07)
       '@cdr-kit/react-ui':
         specifier: npm:@cdr-kit/react-ui@^0.5.0
-        version: 0.5.0(@cdr-kit/core@0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)))(@cdr-kit/react@0.5.0(fe6219abba1ce2fd38b5b8d62dc518fa))(@radix-ui/react-popover@1.1.15(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+        version: 0.5.0(@cdr-kit/core@0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)))(@cdr-kit/react@0.5.0(78f83cda882c8eaeee56bebfc104fe07))(@radix-ui/react-popover@1.1.15(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       '@radix-ui/react-popover':
         specifier: ^1.1.15
         version: 1.1.15(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      '@rainbow-me/rainbowkit':
+        specifier: ^2.2.11
+        version: 2.2.11(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(wagmi@2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(zod@3.25.76))
       '@tanstack/react-query':
         specifier: ^5.62.0
         version: 5.100.14(react@19.2.4)
+      fumadocs-core:
+        specifier: ^16.9.3
+        version: 16.9.3(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.15)(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
+      fumadocs-mdx:
+        specifier: ^15.0.10
+        version: 15.0.10(@types/mdast@4.0.4)(@types/mdx@2.0.13)(@types/react@19.2.15)(fumadocs-core@16.9.3(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.15)(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react@19.2.4)(rolldown@1.0.3)(vite@5.4.21(@types/node@25.9.1)(lightningcss@1.32.0)(terser@5.48.0))
       next:
         specifier: 16.2.6
         version: 16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
@@ -70,11 +79,17 @@ importers:
         version: 19.2.4(react@19.2.4)
       viem:
         specifier: ^2.51.3
-        version: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+        version: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
       wagmi:
         specifier: ^2.14.0
-        version: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(zod@4.4.3)
+        version: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(zod@3.25.76)
+      zod:
+        specifier: ^3.25.76
+        version: 3.25.76
     devDependencies:
+      '@types/mdx':
+        specifier: ^2.0.13
+        version: 2.0.13
       '@types/node':
         specifier: ^20
         version: 20.19.41
@@ -95,7 +110,7 @@ importers:
         version: 2.0.80(zod@4.4.3)
       '@cdr-kit/agent':
         specifier: npm:@cdr-kit/agent@^0.5.0
-        version: 0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+        version: 0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       '@cdr-kit/contracts':
         specifier: npm:@cdr-kit/contracts@^0.5.0
         version: 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
@@ -104,7 +119,7 @@ importers:
         version: 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       '@cdr-kit/vercel-ai':
         specifier: npm:@cdr-kit/vercel-ai@^0.5.0
-        version: 0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(ai@6.0.191(zod@4.4.3))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+        version: 0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(ai@6.0.191(zod@4.4.3))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       ai:
         specifier: ^6.0.191
         version: 6.0.191(zod@4.4.3)
@@ -297,6 +312,52 @@ importers:
         specifier: ^2.1.8
         version: 2.1.9(@types/node@22.19.19)(happy-dom@15.11.7)(lightningcss@1.32.0)(msw@2.14.6(@types/node@22.19.19)(typescript@5.9.3))(terser@5.48.0)
 
+  packages/forms:
+    dependencies:
+      consola:
+        specifier: ^3.2.3
+        version: 3.4.2
+    devDependencies:
+      '@cdr-kit/agent':
+        specifier: workspace:*
+        version: link:../agent
+      '@cdr-kit/contracts':
+        specifier: workspace:*
+        version: link:../contracts
+      '@cdr-kit/core':
+        specifier: workspace:*
+        version: link:../core
+      '@cdr-kit/react':
+        specifier: workspace:*
+        version: link:../react
+      '@testing-library/react':
+        specifier: ^16.1.0
+        version: 16.3.2(@testing-library/dom@10.4.1)(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      '@types/react':
+        specifier: ^19.2.0
+        version: 19.2.15
+      happy-dom:
+        specifier: ^15.11.7
+        version: 15.11.7
+      react:
+        specifier: ^19.2.0
+        version: 19.2.4
+      react-dom:
+        specifier: ^19.2.0
+        version: 19.2.4(react@19.2.4)
+      tsdown:
+        specifier: ^0.22.0
+        version: 0.22.0(publint@0.3.21)(tsx@4.22.3)(typescript@5.9.3)
+      typescript:
+        specifier: ^5.7.2
+        version: 5.9.3
+      viem:
+        specifier: ^2.51.3
+        version: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
+      vitest:
+        specifier: ^2.1.9
+        version: 2.1.9(@types/node@25.9.1)(happy-dom@15.11.7)(lightningcss@1.32.0)(msw@2.14.6(@types/node@25.9.1)(typescript@5.9.3))(terser@5.48.0)
+
   packages/goat:
     dependencies:
       '@cdr-kit/agent':
@@ -429,13 +490,13 @@ importers:
         version: 5.9.3
       viem:
         specifier: ^2.51.3
-        version: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
+        version: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
       vitest:
         specifier: ^2.1.8
         version: 2.1.9(@types/node@25.9.1)(happy-dom@15.11.7)(lightningcss@1.32.0)(msw@2.14.6(@types/node@25.9.1)(typescript@5.9.3))(terser@5.48.0)
       wagmi:
         specifier: ^2.14.0
-        version: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(zod@3.25.76)
+        version: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(zod@4.4.3)
 
   packages/react-ui:
     devDependencies:
@@ -843,6 +904,16 @@ packages:
       '@cdr-kit/story':
         optional: true
 
+  '@cdr-kit/agent@0.6.0':
+    resolution: {integrity: sha512-5tLRO+Uf166MF8F7SZDvrLJJS/vaI15oSjNjZKWWS//7rMMStYuJN1/3q2oy3WLnbjMEX3uQzTQSCJVOO5zqrw==}
+    engines: {node: '>=20'}
+    peerDependencies:
+      '@cdr-kit/story': '>=0.4.0'
+      viem: ^2
+    peerDependenciesMeta:
+      '@cdr-kit/story':
+        optional: true
+
   '@cdr-kit/contracts@0.5.0':
     resolution: {integrity: sha512-T5h4kAKb1zkEKNd4H2lGEmNXU/ebYKwjGth/HRClEBAS1xRCfvrJXPUE9GBX5IgmMLibYCgdzqybX+qX/Zu5Qg==}
     engines: {node: '>=20'}
@@ -868,6 +939,25 @@ packages:
       helia:
         optional: true
 
+  '@cdr-kit/core@0.6.0':
+    resolution: {integrity: sha512-g7heobVSAIst7WNZV2bgjZ2Fm6f1mwOlOptIPuDtBXi8HjCSeFXDDDABH67j+9s3kV/lS9GjUVb6WVjD5hmR2w==}
+    engines: {node: '>=20'}
+    peerDependencies:
+      '@aws-sdk/client-s3': '*'
+      '@helia/unixfs': '*'
+      '@storacha/client': '*'
+      helia: '*'
+      viem: ^2
+    peerDependenciesMeta:
+      '@aws-sdk/client-s3':
+        optional: true
+      '@helia/unixfs':
+        optional: true
+      '@storacha/client':
+        optional: true
+      helia:
+        optional: true
+
   '@cdr-kit/react-ui@0.5.0':
     resolution: {integrity: sha512-dqXVAqLAwGDo1gYh93UscXbOL0ySLO3xghQk5uYwIVqGuNEQ3d9OLdJlnIWpmN6WAPDkd25tW7yd1OwkeBw7Bw==}
     engines: {node: '>=20'}
@@ -894,8 +984,8 @@ packages:
       '@cdr-kit/story':
         optional: true
 
-  '@cdr-kit/story@0.5.0':
-    resolution: {integrity: sha512-6v2qxKeyOKZIuuw8Yk24wZMr5ENBXy27P+LN6gH90RbaW9znZUSFYvA/yxAHaOeCQ8y62mLDB7LvTfzSx5uNzw==}
+  '@cdr-kit/story@0.6.0':
+    resolution: {integrity: sha512-UI4ozQuTYevfiitOTD6mBBzfKA39VMiCzL0tpxGDnPCVQjLB+LEXrBKNqVJJE8aLUlWJsXQqSQ5ul0+JR/sVGQ==}
     engines: {node: '>=20'}
     peerDependencies:
       '@story-protocol/core-sdk': ^1.4
@@ -1029,6 +1119,9 @@ packages:
   '@emnapi/wasi-threads@1.2.1':
     resolution: {integrity: sha512-uTII7OYF+/Mes/MrcIOYp5yOtSMLBWSIoLPpcgwipoiKbli6k322tcoFsxoIIxPDqW01SQGAgko4EzZi2BNv2w==}
 
+  '@emotion/hash@0.9.2':
+    resolution: {integrity: sha512-MyqliTZGuOm3+5ZRSaaBGP3USLw6+EGykkwZns2EPC5g8jJ4z9OrdZY9apkl3+UP9+sdz76YYkwCKP5gh8iY3g==}
+
   '@ensofinance/sdk@2.4.1':
     resolution: {integrity: sha512-fkzHOjhztlLONNDf6P/O6hMkLCxWZNGTMhaNwtRMiVeTcH0rXP9UiBVnptqHRN/WiAxObgIJKqGV1om068k/ag==}
 
@@ -2072,6 +2165,9 @@ packages:
   '@manypkg/get-packages@1.1.3':
     resolution: {integrity: sha512-fo+QhuU3qE/2TQMQmbVMqaQ6EWbMhi4ABWP+O4AM1NqPBuy0OrApV5LO6BrrgnhtAHS2NH6RrVk9OL181tTi8A==}
 
+  '@mdx-js/mdx@3.1.1':
+    resolution: {integrity: sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==}
+
   '@metamask/abi-utils@2.0.4':
     resolution: {integrity: sha512-StnIgUB75x7a7AgUhiaUZDpCsqGp7VkNnZh2XivXkJ6mPkE83U8ARGQj5MbRis7VJY8BC5V1AbB1fjdh0hupPQ==}
     engines: {node: '>=16.0.0'}
@@ -2379,6 +2475,10 @@ packages:
   '@openzeppelin/merkle-tree@1.0.8':
     resolution: {integrity: sha512-E2c9/Y3vjZXwVvPZKqCKUn7upnvam1P1ZhowJyZVQSkzZm5WhumtaRr+wkUXrZVfkIc7Gfrl7xzabElqDL09ow==}
 
+  '@orama/orama@3.1.18':
+    resolution: {integrity: sha512-a61ljmRVVyG5MC/698C8/FfFDw5a8LOIvyOLW5fztgUXqUpc1jOfQzOitSCbge657OgXXThmY3Tk8fpiDb4UcA==}
+    engines: {node: '>= 20.0.0'}
+
   '@oxc-project/types@0.133.0':
     resolution: {integrity: sha512-KzkdCd6Uxqnf6l3HOw1xfatAlUURA0g14cvBYFyJ5SaNOQbOUvBr9PKArcPcrNIeRsBdgcUzOGrhKveVpvOIGA==}
 
@@ -2705,6 +2805,16 @@ packages:
   '@radix-ui/rect@1.1.1':
     resolution: {integrity: sha512-HPwpGIzkl28mWyZqG52jiqDJ12waP11Pa1lGoiyUkIEuMLBP0oeK/C89esbXrxsky5we7dfd8U58nm0SgAWpVw==}
 
+  '@rainbow-me/rainbowkit@2.2.11':
+    resolution: {integrity: sha512-FHPsRHMBpuHHhuyKktAR13O9agmsUUunDnVEP4hG1dSZ2JojXLUSWyLG28VbGIJakHYylkNguiLFnqM/BM8ERA==}
+    engines: {node: '>=12.4'}
+    peerDependencies:
+      '@tanstack/react-query': '>=5.0.0'
+      react: '>=18'
+      react-dom: '>=18'
+      viem: 2.x
+      wagmi: ^2.9.0
+
   '@react-native/assets-registry@0.85.3':
     resolution: {integrity: sha512-u9ZiYP23vA2IFtdFQFmetzSmk6SM0xgKIoiOsr1hXNHjHaLhOm+/Ph1ud57wX6+Dbwdzx8coJgnzSKL3W21PCg==}
     engines: {node: ^20.19.4 || ^22.13.0 || ^24.3.0 || >= 25.0.0}
@@ -3061,6 +3171,37 @@ packages:
   '@scure/bip39@1.6.0':
     resolution: {integrity: sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A==}
 
+  '@shikijs/core@4.2.0':
+    resolution: {integrity: sha512-Hc87Ab1Ld/vEbZRCbwx344I5v+4RU8CVToUTRkqXL1+TjbuOp9U5Xa0M23V4GEWHxVn+yO5otb+HkQVm3ptWQQ==}
+    engines: {node: '>=20'}
+
+  '@shikijs/engine-javascript@4.2.0':
+    resolution: {integrity: sha512-fjETeq1k5ffyXqRgS6+3hpvqseLalp1kjNfRbXpUgWR8FpZ1CmQfiNHovc5lncYjt/Vg5JK/WJEmLahjwMa0og==}
+    engines: {node: '>=20'}
+
+  '@shikijs/engine-oniguruma@4.2.0':
+    resolution: {integrity: sha512-hTorK1dffPkpbMUk6Z+828PgRo7d07HbnizoP0hNPFjhxMHctj0Px/qoHeGMYafc6ju+u9iMldN4JbVzNQM++g==}
+    engines: {node: '>=20'}
+
+  '@shikijs/langs@4.2.0':
+    resolution: {integrity: sha512-bwrVRlJ0wUhZxAbVdvBbv2TTC9yLsh4C/IO5Ofz0T8MQntgDvyVnkbjw9vi50r1kx7RCIJdnJnjZAwmAsXFLZQ==}
+    engines: {node: '>=20'}
+
+  '@shikijs/primitive@4.2.0':
+    resolution: {integrity: sha512-NOq+DtUkVBJtZMVXL5A0vI0Xk8nvDYaXetFHSJFlOqjDZIVhIPRYFdGkSoElDqNuegikcc3A76SNUa8dTqtAYA==}
+    engines: {node: '>=20'}
+
+  '@shikijs/themes@4.2.0':
+    resolution: {integrity: sha512-RX8IHYeLv8Cu2W6ruc3RxUqWn0IYCqSrMBzi/uRGAmfyDNOnNO5BF/Px7o97n4XTpmFTo5GbRaazuOWj+2ak2w==}
+    engines: {node: '>=20'}
+
+  '@shikijs/types@4.2.0':
+    resolution: {integrity: sha512-VT/MKtlpOhEPZloSH3Pb9WCZEBDoQVMa9jedp5UAwmJOar1DVc9DRODAxmYPW9M93IK4ryuqRejFfmlvlVDemw==}
+    engines: {node: '>=20'}
+
+  '@shikijs/vscode-textmate@10.0.2':
+    resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
+
   '@simplewebauthn/browser@8.3.7':
     resolution: {integrity: sha512-ZtRf+pUEgOCvjrYsbMsJfiHOdKcrSZt2zrAnIIpfmA06r0FxBovFYq0rJ171soZbe13KmWzAoLKjSxVW7KxCdQ==}
 
@@ -3893,12 +4034,18 @@ packages:
   '@types/dns-packet@5.6.5':
     resolution: {integrity: sha512-qXOC7XLOEe43ehtWJCMnQXvgcIpv6rPmQ1jXT98Ad8A3TB1Ue50jsCbSSSyuazScEuZ/Q026vHbrOTVkmwA+7Q==}
 
+  '@types/estree-jsx@1.0.5':
+    resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
+
   '@types/estree@1.0.8':
     resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
 
   '@types/estree@1.0.9':
     resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
 
+  '@types/hast@3.0.4':
+    resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
+
   '@types/istanbul-lib-coverage@2.0.6':
     resolution: {integrity: sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==}
 
@@ -3917,6 +4064,12 @@ packages:
   '@types/lodash@4.17.24':
     resolution: {integrity: sha512-gIW7lQLZbue7lRSWEFql49QJJWThrTFFeIMJdp3eH4tKoxm1OvEPg02rm4wCCSHS0cL3/Fizimb35b7k8atwsQ==}
 
+  '@types/mdast@4.0.4':
+    resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
+  '@types/mdx@2.0.13':
+    resolution: {integrity: sha512-+OWZQfAYyio6YkJb3HLxDrvnx6SWWDbC0zVPfBRzUk0/nqoDyf6dNxQi3eArPe8rJ473nobTMQ/8Zk+LxJ+Yuw==}
+
   '@types/ms@2.1.0':
     resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
 
@@ -3964,6 +4117,12 @@ packages:
   '@types/trusted-types@2.0.7':
     resolution: {integrity: sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==}
 
+  '@types/unist@2.0.11':
+    resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
+
+  '@types/unist@3.0.3':
+    resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
   '@types/uuid@10.0.0':
     resolution: {integrity: sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==}
 
@@ -4038,10 +4197,27 @@ packages:
     resolution: {integrity: sha512-9WI52t8ZGLVGrPMBet25yAftqY/n95+zmoUUtJBBQTKDSKUu7OsPTroT2op7U9JatkoRccL0YkWDNMFfC4Sjxg==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
+  '@ungap/structured-clone@1.3.1':
+    resolution: {integrity: sha512-mUFwbeTqrVgDQxFveS+df2yfap6iuP20NAKAsBt5jDEoOTDew+zwLAOilHCeQJOVSvmgCX4ogqIrA0mnyr08yQ==}
+
   '@uniswap/token-lists@1.0.0-beta.33':
     resolution: {integrity: sha512-JQkXcpRI3jFG8y3/CGC4TS8NkDgcxXaOQuYW8Qdvd6DcDiIyg2vVYCG9igFEzF0G6UvxgHkBKC7cWCgzZNYvQg==}
     engines: {node: '>=10'}
 
+  '@vanilla-extract/css@1.20.1':
+    resolution: {integrity: sha512-5I9RNo5uZW9tsBnqrWzJqELegOqTHBrZyDFnES0gR9gJJHBB9dom1N0bwITM9tKwBcfKrTX4a6DHVeQdJ2ubQA==}
+
+  '@vanilla-extract/dynamic@2.1.5':
+    resolution: {integrity: sha512-QGIFGb1qyXQkbzx6X6i3+3LMc/iv/ZMBttMBL+Wm/DetQd36KsKsFg5CtH3qy+1hCA/5w93mEIIAiL4fkM8ycw==}
+
+  '@vanilla-extract/private@1.0.9':
+    resolution: {integrity: sha512-gT2jbfZuaaCLrAxwXbRgIhGhcXbRZCG3v4TTUnjw0EJ7ArdBRxkq4msNJkbuRkCgfIK5ATmprB5t9ljvLeFDEA==}
+
+  '@vanilla-extract/sprinkles@1.6.5':
+    resolution: {integrity: sha512-HOYidLONR/SeGk8NBAeI64I4gYdsMX9vJmniL13ZcLVwawyK0s2GUENEAcGA+GYLIoeyQB61UqmhqPodJry7zA==}
+    peerDependencies:
+      '@vanilla-extract/css': ^1.0.0
+
   '@vaultsfyi/sdk@2.3.5':
     resolution: {integrity: sha512-DEBc6lDeaIpo1kZg6jxOTIPNkPEsFiGMUQEQOr60wVlzDIodeUiiNkDlXx1ubZ43mO8cSSodFJvMHmnVOK8eRQ==}
 
@@ -4458,6 +4634,10 @@ packages:
     resolution: {integrity: sha512-trmleAnZ2PxN/loHWVhhx1qeOHSRXq4TDsBBxq3GqeJitfk3+jTQ+v/C1km/KYq9M7wKqCewMh+/NAvVH7m+bw==}
     engines: {node: '>=20.19.0'}
 
+  astring@1.9.0:
+    resolution: {integrity: sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==}
+    hasBin: true
+
   async-mutex@0.2.6:
     resolution: {integrity: sha512-Hs4R+4SPgamu6rSGW8C7cV9gaWUKEHykfzCCvIRuaVv636Ju10ZdeUbvb4TBEW0INuq2DHZqXbK4Nd3yG4RaRw==}
 
@@ -4488,6 +4668,9 @@ packages:
   babel-plugin-syntax-hermes-parser@0.33.3:
     resolution: {integrity: sha512-/Z9xYdaJ1lC0pT9do6TqCqhOSLfZ5Ot8D5za1p+feEfWYupCOfGbhhEXN9r2ZgJtDNUNRw/Z+T2CvAGKBqtqWA==}
 
+  bail@2.0.2:
+    resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
+
   balanced-match@1.0.2:
     resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
 
@@ -4687,6 +4870,9 @@ packages:
     resolution: {integrity: sha512-BDbSRIp6XrQXkTc7g+DN0RB9RrDPTUfals2ecWUlt3juPLjbAvy/V72mJcXY0Ehu0Dq/3WpNCOCT68HUTbW+lw==}
     hasBin: true
 
+  ccount@2.0.1:
+    resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==}
+
   chai@5.3.3:
     resolution: {integrity: sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==}
     engines: {node: '>=18'}
@@ -4702,6 +4888,18 @@ packages:
   change-case@5.4.4:
     resolution: {integrity: sha512-HRQyTk2/YPEkt9TnUPbOpr64Uw3KOicFWPVBb+xiHvd6eBx/qPr9xqfBFDT8P2vWsvvz4jbEkfDe71W3VyNu2w==}
 
+  character-entities-html4@2.1.0:
+    resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
+
+  character-entities-legacy@3.0.0:
+    resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
+
+  character-entities@2.0.2:
+    resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==}
+
+  character-reference-invalid@2.0.1:
+    resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
+
   chardet@2.1.1:
     resolution: {integrity: sha512-PsezH1rqdV9VvyNhxxOW32/d75r01NY7TQCmOqomRo15ZSOKbpTFVsfjghxo6JloQUCGnH4k1LGu0R4yCLlWQQ==}
 
@@ -4786,6 +4984,13 @@ packages:
     resolution: {integrity: sha512-EcR6r5a8bj6pu3ycsa/E/cKVGuTgZJZdsyUYHOksG/UHIiKfjxzRxYJpyVBwYaQeOvghal9fcc4PidlgzugAQg==}
     engines: {node: '>=6'}
 
+  clsx@2.1.1:
+    resolution: {integrity: sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==}
+    engines: {node: '>=6'}
+
+  collapse-white-space@2.1.0:
+    resolution: {integrity: sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==}
+
   color-convert@2.0.1:
     resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
     engines: {node: '>=7.0.0'}
@@ -4797,6 +5002,9 @@ packages:
     resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}
     engines: {node: '>= 0.8'}
 
+  comma-separated-tokens@2.0.3:
+    resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
+
   commander@12.1.0:
     resolution: {integrity: sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==}
     engines: {node: '>=18'}
@@ -4812,6 +5020,9 @@ packages:
   commander@2.20.3:
     resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==}
 
+  compute-scroll-into-view@3.1.1:
+    resolution: {integrity: sha512-VRhuHOLoKYOy4UbilLbUzbYg93XLjv2PncJC50EuTWPA3gaja1UjBsUP/D/9/juV3vQFr6XBEzn9KCAHdUvOHw==}
+
   concat-map@0.0.1:
     resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
 
@@ -4891,9 +5102,23 @@ packages:
   crypto-js@4.2.0:
     resolution: {integrity: sha512-KALDyEYgpY+Rlob/iriUtjV6d5Eq+Y191A5g4UqLAi8CyGP9N1+FdVbkc1SxKc2r4YAYqG8JzO2KGL+AizD70Q==}
 
+  css-what@6.2.2:
+    resolution: {integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==}
+    engines: {node: '>= 6'}
+
   csstype@3.2.3:
     resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
 
+  cuer@0.0.3:
+    resolution: {integrity: sha512-f/UNxRMRCYtfLEGECAViByA3JNflZImOk11G9hwSd+44jvzrc99J35u5l+fbdQ2+ZG441GvOpaeGYBmWquZsbQ==}
+    peerDependencies:
+      react: '>=18'
+      react-dom: '>=18'
+      typescript: '>=5.4.0'
+    peerDependenciesMeta:
+      typescript:
+        optional: true
+
   datastore-core@10.0.4:
     resolution: {integrity: sha512-IctgCO0GA7GHG7aRm3JRruibCsfvN4EXNnNIlLCZMKIv0TPkdAL5UFV3/xTYFYrrZ1jRNrXZNZRvfcVf/R+rAw==}
 
@@ -4940,6 +5165,9 @@ packages:
   decimal.js@10.6.0:
     resolution: {integrity: sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==}
 
+  decode-named-character-reference@1.3.0:
+    resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
+
   decode-uri-component@0.2.2:
     resolution: {integrity: sha512-FqUYQ+8o158GyGTrMFJms9qh3CqTKvAqgqsTnkLI8sKu0028orqBhxNMFkFen0zGyg6epACD32pjVk58ngIErQ==}
     engines: {node: '>=0.10'}
@@ -4951,6 +5179,14 @@ packages:
   dedent@0.7.0:
     resolution: {integrity: sha512-Q6fKUPqnAHAyhiUgFU7BUzLiv0kd8saH9al7tnu5Q/okj6dnupxyTgFIBjVzJATdfIAm9NAsvXNzjaKa+bxVyA==}
 
+  dedent@1.7.2:
+    resolution: {integrity: sha512-WzMx3mW98SN+zn3hgemf4OzdmyNhhhKz5Ay0pUfQiMQ3e1g+xmTJWp/pKdwKVXhdSkAEGIIzqeuWrL3mV/AXbA==}
+    peerDependencies:
+      babel-plugin-macros: ^3.1.0
+    peerDependenciesMeta:
+      babel-plugin-macros:
+        optional: true
+
   deep-eql@5.0.2:
     resolution: {integrity: sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==}
     engines: {node: '>=6'}
@@ -4962,6 +5198,13 @@ packages:
   deep-is@0.1.4:
     resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}
 
+  deep-object-diff@1.1.9:
+    resolution: {integrity: sha512-Rn+RuwkmkDwCi2/oXOFS9Gsr5lJZu/yTGpK7wAaAIE75CC+LCGEZHpY6VQJa/RoJcrmaA/docWJZvYohlNkWPA==}
+
+  deepmerge@4.3.1:
+    resolution: {integrity: sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==}
+    engines: {node: '>=0.10.0'}
+
   default-browser-id@5.0.1:
     resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==}
     engines: {node: '>=18'}
@@ -5019,6 +5262,9 @@ packages:
   detect-browser@5.3.0:
     resolution: {integrity: sha512-53rsFbGdwMwlF7qvCt0ypLM5V5/Mbl0szB7GPN8y9NCcbknYOeVVXdrXEq+90IwAfrrzt6Hd+u2E2ntakICU8w==}
 
+  detect-europe-js@0.1.2:
+    resolution: {integrity: sha512-lgdERlL3u0aUdHocoouzT10d9I89VVhk0qNRmll7mXdGfJT1/wqZ2ZLA4oJAjeACPY5fT1wsbq2AT+GkuInsow==}
+
   detect-indent@6.1.0:
     resolution: {integrity: sha512-reYkTUJAZb9gUuZ2RvVCNhVHdg62RHnJ7WJl8ftMi4diZ6NWlciOzQN88pUhSELEwflJht4oQDv0F0BMlwaYtA==}
     engines: {node: '>=8'}
@@ -5030,6 +5276,9 @@ packages:
   detect-node-es@1.1.0:
     resolution: {integrity: sha512-ypdmJU/TbBby2Dxibuv7ZLW3Bs1QEmM7nHjEANfohJLvE0XVujisn1qPJcZxg+qDucsr+bP6fLD1rPS3AhJ7EQ==}
 
+  devlop@1.1.0:
+    resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
+
   dijkstrajs@1.0.3:
     resolution: {integrity: sha512-qiSlmBq9+BCdCA/L46dw8Uy93mloxsPSbwnm5yrKn2vMPiy8KyAskTF6zuV/j5BMsmOGZDPs7KjU+mjb670kfA==}
 
@@ -5161,6 +5410,12 @@ packages:
   es6-promisify@5.0.0:
     resolution: {integrity: sha512-C+d6UdsYDk0lMebHNR4S2NybQMMngAOnOwYBQjTOiv0MkoJMP0Myw2mgpDLBcpfCmRLxyFqYhS/CfOENq4SJhQ==}
 
+  esast-util-from-estree@2.0.0:
+    resolution: {integrity: sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==}
+
+  esast-util-from-js@2.0.1:
+    resolution: {integrity: sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==}
+
   esbuild@0.21.5:
     resolution: {integrity: sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==}
     engines: {node: '>=12'}
@@ -5191,6 +5446,10 @@ packages:
     resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
     engines: {node: '>=10'}
 
+  escape-string-regexp@5.0.0:
+    resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+    engines: {node: '>=12'}
+
   eslint-scope@8.4.0:
     resolution: {integrity: sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
@@ -5238,6 +5497,27 @@ packages:
     resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==}
     engines: {node: '>=4.0'}
 
+  estree-util-attach-comments@3.0.0:
+    resolution: {integrity: sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==}
+
+  estree-util-build-jsx@3.0.1:
+    resolution: {integrity: sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==}
+
+  estree-util-is-identifier-name@3.0.0:
+    resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
+
+  estree-util-scope@1.0.0:
+    resolution: {integrity: sha512-2CAASclonf+JFWBNJPndcOpA8EMJwa0Q8LUFJEKqXLW6+qBvbFZuF5gItbQOs/umBUkjviCSDCbBwU2cXbmrhQ==}
+
+  estree-util-to-js@2.0.0:
+    resolution: {integrity: sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==}
+
+  estree-util-value-to-estree@3.5.0:
+    resolution: {integrity: sha512-aMV56R27Gv3QmfmF1MY12GWkGzzeAezAX+UplqHVASfjc9wNzI/X6hC0S9oxq61WT4aQesLGslWP9tKk6ghRZQ==}
+
+  estree-util-visit@2.0.0:
+    resolution: {integrity: sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==}
+
   estree-walker@3.0.3:
     resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==}
 
@@ -5340,6 +5620,9 @@ packages:
     resolution: {integrity: sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==}
     engines: {node: '>= 18'}
 
+  extend@3.0.2:
+    resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
+
   extendable-error@0.1.7:
     resolution: {integrity: sha512-UOiS2in6/Q0FK0R0q6UY9vYpQ21mr/Qn1KOnte7vsACuNJf514WvCCUHSRCPcgjPT2bAhNIJdlE6bVap1GKmeg==}
 
@@ -5513,6 +5796,96 @@ packages:
     engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
     os: [darwin]
 
+  fumadocs-core@16.9.3:
+    resolution: {integrity: sha512-8RVzKnzBJR5o+tJCccY28ntekfMQYBoYiz7alnYb/d9YJc+XpnsINzTl63lQ1eBMZ9gdhm2MqRtgUjh/8rUrbw==}
+    peerDependencies:
+      '@mdx-js/mdx': '*'
+      '@mixedbread/sdk': 0.x.x
+      '@orama/core': 1.x.x
+      '@oramacloud/client': 2.x.x
+      '@tanstack/react-router': 1.x.x
+      '@types/estree-jsx': '*'
+      '@types/hast': '*'
+      '@types/mdast': '*'
+      '@types/react': '*'
+      algoliasearch: 5.x.x
+      flexsearch: '*'
+      lucide-react: '*'
+      next: 16.x.x
+      react: ^19.2.0
+      react-dom: ^19.2.0
+      react-router: 7.x.x
+      waku: '*'
+      zod: 4.x.x
+    peerDependenciesMeta:
+      '@mdx-js/mdx':
+        optional: true
+      '@mixedbread/sdk':
+        optional: true
+      '@orama/core':
+        optional: true
+      '@oramacloud/client':
+        optional: true
+      '@tanstack/react-router':
+        optional: true
+      '@types/estree-jsx':
+        optional: true
+      '@types/hast':
+        optional: true
+      '@types/mdast':
+        optional: true
+      '@types/react':
+        optional: true
+      algoliasearch:
+        optional: true
+      flexsearch:
+        optional: true
+      lucide-react:
+        optional: true
+      next:
+        optional: true
+      react:
+        optional: true
+      react-dom:
+        optional: true
+      react-router:
+        optional: true
+      waku:
+        optional: true
+      zod:
+        optional: true
+
+  fumadocs-mdx@15.0.10:
+    resolution: {integrity: sha512-kH3S7ESS9yXTAaCkA8dDugsCK/MbnpgyZ5qBEL7cWoavV0O/T4+4YTYFkvNknz7cw+T/r+OG0p2BvlVhkk4fww==}
+    hasBin: true
+    peerDependencies:
+      '@types/mdast': '*'
+      '@types/mdx': '*'
+      '@types/react': '*'
+      fumadocs-core: ^16.7.0
+      mdast-util-directive: '*'
+      next: ^15.3.0 || ^16.0.0
+      react: ^19.2.0
+      rolldown: '*'
+      vite: 7.x.x || 8.x.x
+    peerDependenciesMeta:
+      '@types/mdast':
+        optional: true
+      '@types/mdx':
+        optional: true
+      '@types/react':
+        optional: true
+      mdast-util-directive:
+        optional: true
+      next:
+        optional: true
+      react:
+        optional: true
+      rolldown:
+        optional: true
+      vite:
+        optional: true
+
   function-bind@1.1.2:
     resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}
 
@@ -5558,6 +5931,9 @@ packages:
   github-from-package@0.0.0:
     resolution: {integrity: sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==}
 
+  github-slugger@2.0.0:
+    resolution: {integrity: sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==}
+
   glob-parent@5.1.2:
     resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
     engines: {node: '>= 6'}
@@ -5629,6 +6005,18 @@ packages:
     resolution: {integrity: sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==}
     engines: {node: '>= 0.4'}
 
+  hast-util-to-estree@3.1.3:
+    resolution: {integrity: sha512-48+B/rJWAp0jamNbAAf9M7Uf//UVqAoMmgXhBdxTDJLGKY+LRnZ99qcG+Qjl5HfMpYNzS5v4EAwVEF34LeAj7w==}
+
+  hast-util-to-html@9.0.5:
+    resolution: {integrity: sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==}
+
+  hast-util-to-jsx-runtime@2.3.6:
+    resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==}
+
+  hast-util-whitespace@3.0.0:
+    resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
+
   headers-polyfill@5.0.1:
     resolution: {integrity: sha512-1TJ6Fih/b8h5TIcv+1+Hw0PDQWJTKDKzFZzcKOiW1wJza3XoAQlkCuXLbymPYB8+ZQyw8mHvdw560e8zVFIWyA==}
 
@@ -5660,6 +6048,9 @@ packages:
   hookable@6.1.1:
     resolution: {integrity: sha512-U9LYDy1CwhMCnprUfeAZWZGByVbhd54hwepegYTK7Pi5NvqEj63ifz5z+xukznehT7i6NIZRu89Ay1AZmRsLEQ==}
 
+  html-void-elements@3.0.0:
+    resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
+
   http-cookie-agent@6.0.8:
     resolution: {integrity: sha512-qnYh3yLSr2jBsTYkw11elq+T361uKAJaZ2dR4cfYZChw1dt9uL5t3zSUwehoqqVb4oldk1BpkXKm2oat8zV+oA==}
     engines: {node: '>=18.0.0'}
@@ -5733,6 +6124,9 @@ packages:
   ini@1.3.8:
     resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==}
 
+  inline-style-parser@0.2.7:
+    resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==}
+
   inquirer@8.2.7:
     resolution: {integrity: sha512-UjOaSel/iddGZJ5xP/Eixh6dY1XghiBw4XK13rCCIJcJfyhhoul/7KhLLUGtebEj6GDYM6Vnx/mVsjx2L/mFIA==}
     engines: {node: '>=12.0.0'}
@@ -5782,6 +6176,12 @@ packages:
   iron-webcrypto@1.2.1:
     resolution: {integrity: sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==}
 
+  is-alphabetical@2.0.1:
+    resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
+
+  is-alphanumerical@2.0.1:
+    resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
+
   is-arguments@1.2.0:
     resolution: {integrity: sha512-7bVbi0huj/wrIAOzb8U1aszg9kdi3KN/CyU19CTI7tAoZYEZoL9yCDXpbXN+uPsuWnP02cyug1gleqq+TU+YCA==}
     engines: {node: '>= 0.4'}
@@ -5797,6 +6197,9 @@ packages:
     resolution: {integrity: sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==}
     engines: {node: '>= 0.4'}
 
+  is-decimal@2.0.1:
+    resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
   is-docker@2.2.1:
     resolution: {integrity: sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==}
     engines: {node: '>=8'}
@@ -5830,6 +6233,9 @@ packages:
     resolution: {integrity: sha512-WvtOiug1VFrE9v1Cydwm+FnXd3+w9GaeVUss5W4v/SLy3UW00vP+6iNF2SdnfiBoLy4bTqVdkftNGTUeOFVsbA==}
     engines: {node: '>=6.5.0', npm: '>=3'}
 
+  is-hexadecimal@2.0.1:
+    resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
+
   is-inside-container@1.0.0:
     resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==}
     engines: {node: '>=14.16'}
@@ -5880,6 +6286,9 @@ packages:
     resolution: {integrity: sha512-XVm7LOeLpTW4jV19QSH38vkswxoLud8sQ57YwJVTPWdiaI9I8keEhGFpBlslyVsgdQy4Opg8QOLb8YRgsyZiQg==}
     engines: {node: '>=10'}
 
+  is-standalone-pwa@0.1.1:
+    resolution: {integrity: sha512-9Cbovsa52vNQCjdXOzeQq5CnCbAcRk05aU62K20WO372NrTv0NxibLFCK6lQ4/iZEFdEA3p3t2VNOn8AJ53F5g==}
+
   is-stream@2.0.1:
     resolution: {integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==}
     engines: {node: '>=8'}
@@ -6276,6 +6685,9 @@ packages:
     resolution: {integrity: sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==}
     engines: {node: '>=10'}
 
+  longest-streak@3.1.0:
+    resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==}
+
   loose-envify@1.4.0:
     resolution: {integrity: sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==}
     hasBin: true
@@ -6283,6 +6695,9 @@ packages:
   loupe@3.2.1:
     resolution: {integrity: sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==}
 
+  lru-cache@10.4.3:
+    resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+
   lru-cache@11.5.1:
     resolution: {integrity: sha512-RPimw/7aMdv2oqRrxKwvZXcPfwBrn/JZ2xYcY9Hus/6LaS3VOAKVWKWgNLCFSiOm1ESXinjsDlidVU7JlnCN2A==}
     engines: {node: 20 || >=22}
@@ -6303,6 +6718,13 @@ packages:
   makeerror@1.0.12:
     resolution: {integrity: sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==}
 
+  markdown-extensions@2.0.0:
+    resolution: {integrity: sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==}
+    engines: {node: '>=16'}
+
+  markdown-table@3.0.4:
+    resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
+
   marky@1.3.0:
     resolution: {integrity: sha512-ocnPZQLNpvbedwTy9kNrQEsknEfgvcLMvOtz3sFeWApDq1MXH1TqkCIx58xlpESsfwQOnuBO9beyQuNGzVvuhQ==}
 
@@ -6316,6 +6738,57 @@ packages:
   md5@2.3.0:
     resolution: {integrity: sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==}
 
+  mdast-util-find-and-replace@3.0.2:
+    resolution: {integrity: sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==}
+
+  mdast-util-from-markdown@2.0.3:
+    resolution: {integrity: sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==}
+
+  mdast-util-gfm-autolink-literal@2.0.1:
+    resolution: {integrity: sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==}
+
+  mdast-util-gfm-footnote@2.1.0:
+    resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==}
+
+  mdast-util-gfm-strikethrough@2.0.0:
+    resolution: {integrity: sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==}
+
+  mdast-util-gfm-table@2.0.0:
+    resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==}
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==}
+
+  mdast-util-gfm@3.1.0:
+    resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==}
+
+  mdast-util-mdx-expression@2.0.1:
+    resolution: {integrity: sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==}
+
+  mdast-util-mdx-jsx@3.2.0:
+    resolution: {integrity: sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==}
+
+  mdast-util-mdx@3.0.0:
+    resolution: {integrity: sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==}
+
+  mdast-util-mdxjs-esm@2.0.1:
+    resolution: {integrity: sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==}
+
+  mdast-util-phrasing@4.1.0:
+    resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
+
+  mdast-util-to-hast@13.2.1:
+    resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
+
+  mdast-util-to-markdown@2.1.2:
+    resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==}
+
+  mdast-util-to-string@4.0.0:
+    resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==}
+
+  media-query-parser@2.0.2:
+    resolution: {integrity: sha512-1N4qp+jE0pL5Xv4uEcwVUhIkwdUO3S/9gML90nqKA7v7FcOS5vUtatfzok9S9U1EJU8dHWlcv95WLnKmmxZI9w==}
+
   media-typer@1.1.0:
     resolution: {integrity: sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==}
     engines: {node: '>= 0.8'}
@@ -6407,28 +6880,133 @@ packages:
   micro-ftch@0.3.1:
     resolution: {integrity: sha512-/0LLxhzP0tfiR5hcQebtudP56gUurs2CLkGarnCiB/OqEyUFQ6U3paQi/tgLv0hBJYt2rnr9MNpxz4fiiugstg==}
 
-  micromatch@4.0.8:
-    resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
-    engines: {node: '>=8.6'}
+  micromark-core-commonmark@2.0.3:
+    resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==}
 
-  mime-db@1.52.0:
-    resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
-    engines: {node: '>= 0.6'}
+  micromark-extension-gfm-autolink-literal@2.1.0:
+    resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==}
 
-  mime-db@1.54.0:
-    resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==}
-    engines: {node: '>= 0.6'}
+  micromark-extension-gfm-footnote@2.1.0:
+    resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==}
 
-  mime-types@2.1.35:
-    resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
-    engines: {node: '>= 0.6'}
+  micromark-extension-gfm-strikethrough@2.1.0:
+    resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==}
 
-  mime-types@3.0.2:
-    resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==}
-    engines: {node: '>=18'}
+  micromark-extension-gfm-table@2.1.1:
+    resolution: {integrity: sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==}
 
-  mime@1.6.0:
-    resolution: {integrity: sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==}
+  micromark-extension-gfm-tagfilter@2.0.0:
+    resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==}
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==}
+
+  micromark-extension-gfm@3.0.0:
+    resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==}
+
+  micromark-extension-mdx-expression@3.0.1:
+    resolution: {integrity: sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==}
+
+  micromark-extension-mdx-jsx@3.0.2:
+    resolution: {integrity: sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==}
+
+  micromark-extension-mdx-md@2.0.0:
+    resolution: {integrity: sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==}
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    resolution: {integrity: sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==}
+
+  micromark-extension-mdxjs@3.0.0:
+    resolution: {integrity: sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==}
+
+  micromark-factory-destination@2.0.1:
+    resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
+
+  micromark-factory-label@2.0.1:
+    resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
+
+  micromark-factory-mdx-expression@2.0.3:
+    resolution: {integrity: sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==}
+
+  micromark-factory-space@2.0.1:
+    resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==}
+
+  micromark-factory-title@2.0.1:
+    resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==}
+
+  micromark-factory-whitespace@2.0.1:
+    resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==}
+
+  micromark-util-character@2.1.1:
+    resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==}
+
+  micromark-util-chunked@2.0.1:
+    resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==}
+
+  micromark-util-classify-character@2.0.1:
+    resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==}
+
+  micromark-util-combine-extensions@2.0.1:
+    resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==}
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==}
+
+  micromark-util-decode-string@2.0.1:
+    resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==}
+
+  micromark-util-encode@2.0.1:
+    resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
+
+  micromark-util-events-to-acorn@2.0.3:
+    resolution: {integrity: sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==}
+
+  micromark-util-html-tag-name@2.0.1:
+    resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
+
+  micromark-util-normalize-identifier@2.0.1:
+    resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==}
+
+  micromark-util-resolve-all@2.0.1:
+    resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==}
+
+  micromark-util-sanitize-uri@2.0.1:
+    resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==}
+
+  micromark-util-subtokenize@2.1.0:
+    resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==}
+
+  micromark-util-symbol@2.0.1:
+    resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==}
+
+  micromark-util-types@2.0.2:
+    resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==}
+
+  micromark@4.0.2:
+    resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==}
+
+  micromatch@4.0.8:
+    resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
+    engines: {node: '>=8.6'}
+
+  mime-db@1.52.0:
+    resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
+    engines: {node: '>= 0.6'}
+
+  mime-db@1.54.0:
+    resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==}
+    engines: {node: '>= 0.6'}
+
+  mime-types@2.1.35:
+    resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
+    engines: {node: '>= 0.6'}
+
+  mime-types@3.0.2:
+    resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==}
+    engines: {node: '>=18'}
+
+  mime@1.6.0:
+    resolution: {integrity: sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==}
     engines: {node: '>=4'}
     hasBin: true
 
@@ -6472,6 +7050,9 @@ packages:
     engines: {node: '>=10'}
     hasBin: true
 
+  modern-ahocorasick@1.1.0:
+    resolution: {integrity: sha512-sEKPVl2rM+MNVkGQt3ChdmD8YsigmXdn5NifZn6jiwn9LRJpWm8F3guhaqrJT/JOat6pwpbXEk6kv+b9DMIjsQ==}
+
   mortice@3.3.1:
     resolution: {integrity: sha512-t3oESfijIPGsmsdLEKjF+grHfrbnKSXflJtgb1wY14cjxZpS6GnhHRXTxxzCAoCCnq1YYfpEPwY3gjiCPhOufQ==}
 
@@ -6668,6 +7249,12 @@ packages:
     resolution: {integrity: sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==}
     engines: {node: '>=6'}
 
+  oniguruma-parser@0.12.2:
+    resolution: {integrity: sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==}
+
+  oniguruma-to-es@4.3.6:
+    resolution: {integrity: sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==}
+
   open@10.2.0:
     resolution: {integrity: sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==}
     engines: {node: '>=18'}
@@ -6823,6 +7410,9 @@ packages:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
 
+  parse-entities@4.0.2:
+    resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
+
   parseurl@1.3.3:
     resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==}
     engines: {node: '>= 0.8'}
@@ -7011,6 +7601,9 @@ packages:
   promise@8.3.0:
     resolution: {integrity: sha512-rZPNPKTOYVNEEKFaq1HqTgOwZD+4/YHS5ukLzQCypkj+OkYx7iv0mA91lJlpPPZ8vMau3IIGj5Qlwrx+8iiSmg==}
 
+  property-information@7.2.0:
+    resolution: {integrity: sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==}
+
   protons-runtime@5.6.0:
     resolution: {integrity: sha512-/Kde+sB9DsMFrddJT/UZWe6XqvL7SL5dbag/DBCElFKhkwDj7XKt53S+mzLyaDP5OqS0wXjV5SA572uWDaT0Hg==}
 
@@ -7047,6 +7640,10 @@ packages:
     resolution: {integrity: sha512-KTqnxsgGiQ6ZAzZCVlJH5eOjSnvlyEgx1m8bkRJfOhmGRqfo5KLvmAlACQkrjEtOQ4B7wF9TdSLIs9O90MX9xA==}
     engines: {node: '>=16.0.0'}
 
+  qr@0.6.0:
+    resolution: {integrity: sha512-P23VoX7SipHALdiIYG+D+LT/6n22dNKwV92FAb3d+Nlki/5WisSsfLt0UDFz2XEBtuwrECTznvu+chKKFCSYhA==}
+    engines: {node: '>= 20.19.0'}
+
   qrcode@1.5.3:
     resolution: {integrity: sha512-puyri6ApkEHYiVl4CFzo1tDkAZ+ATcnbJrJ6RiBM1Fhctdn/ix9MTE3hRph33omisEbC/2fcfemsseiKgBPKZg==}
     engines: {node: '>=10.13.0'}
@@ -7208,6 +7805,20 @@ packages:
     resolution: {integrity: sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==}
     engines: {node: '>= 12.13.0'}
 
+  recma-build-jsx@1.0.0:
+    resolution: {integrity: sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==}
+
+  recma-jsx@1.0.1:
+    resolution: {integrity: sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==}
+    peerDependencies:
+      acorn: ^6.0.0 || ^7.0.0 || ^8.0.0
+
+  recma-parse@1.0.0:
+    resolution: {integrity: sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==}
+
+  recma-stringify@1.0.0:
+    resolution: {integrity: sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==}
+
   redaxios@0.5.1:
     resolution: {integrity: sha512-FSD2AmfdbkYwl7KDExYQlVvIrFz6Yd83pGfaGjBzM9F6rpq8g652Q4Yq5QD4c+nf4g2AgeElv1y+8ajUPiOYMg==}
 
@@ -7217,6 +7828,36 @@ packages:
   regenerator-runtime@0.13.11:
     resolution: {integrity: sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg==}
 
+  regex-recursion@6.0.2:
+    resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==}
+
+  regex-utilities@2.3.0:
+    resolution: {integrity: sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==}
+
+  regex@6.1.0:
+    resolution: {integrity: sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==}
+
+  rehype-recma@1.0.0:
+    resolution: {integrity: sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==}
+
+  remark-gfm@4.0.1:
+    resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
+
+  remark-mdx@3.1.1:
+    resolution: {integrity: sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==}
+
+  remark-parse@11.0.0:
+    resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
+
+  remark-rehype@11.1.2:
+    resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==}
+
+  remark-stringify@11.0.0:
+    resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==}
+
+  remark@15.0.1:
+    resolution: {integrity: sha512-Eht5w30ruCXgFmxVUSlNWQ9iiimq07URKeFS3hNc8cUWy1llX4KDWfyEDZRycMc+znsN9Ux5/tJ/BFdgdOwA3A==}
+
   require-directory@2.1.1:
     resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==}
     engines: {node: '>=0.10.0'}
@@ -7342,6 +7983,9 @@ packages:
   scheduler@0.27.0:
     resolution: {integrity: sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==}
 
+  scroll-into-view-if-needed@3.1.0:
+    resolution: {integrity: sha512-49oNpRjWRvnU8NyGVmUaYG4jtTkNonFZI86MmGRDqBphEK2EXT9gdEUoQPZhuBM8yWHxCWbobltqYO5M4XrUvQ==}
+
   scrypt-js@3.0.1:
     resolution: {integrity: sha512-cdwTTnqPu0Hyvf5in5asVdZocVDTNRmR7XEcJuIzMjJeSHybHl7vpB66AzwTaIg6CLSbtjcxc8fqcySfnTkccA==}
 
@@ -7415,6 +8059,10 @@ packages:
     resolution: {integrity: sha512-VsC6n6vz1ihYYyZZwX7YZSF5l5x36ca17OC+a69h94YqB7X6XLwf+5MOgynYir2SLFUbl8gIYvBo8K8RoNQ6bQ==}
     engines: {node: '>= 0.4'}
 
+  shiki@4.2.0:
+    resolution: {integrity: sha512-hjNax6o/ylDy9lefQEaSDtzaT3iVNtZ3WmpQnbuQNoG4xvnSKf2kSKbihZVO4JRG1TTMejs7CmNRYlWgAL66pQ==}
+    engines: {node: '>=20'}
+
   side-channel-list@1.0.1:
     resolution: {integrity: sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==}
     engines: {node: '>= 0.4'}
@@ -7480,6 +8128,13 @@ packages:
     resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
     engines: {node: '>=0.10.0'}
 
+  source-map@0.7.6:
+    resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==}
+    engines: {node: '>= 12'}
+
+  space-separated-tokens@2.0.2:
+    resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
+
   sparse-array@1.3.2:
     resolution: {integrity: sha512-ZT711fePGn3+kQyLuv1fpd3rNSkNF8vd5Kv2D+qnOANeyKs3fx6bUMGWRPvgTTcYV64QMqZKZwcuaQSP3AZ0tg==}
 
@@ -7550,6 +8205,9 @@ packages:
   string_decoder@1.3.0:
     resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
 
+  stringify-entities@4.0.4:
+    resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
+
   strip-ansi@6.0.1:
     resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
     engines: {node: '>=8'}
@@ -7573,6 +8231,12 @@ packages:
   strnum@2.3.0:
     resolution: {integrity: sha512-ums3KNd42PGyx5xaoVTO1mjU1bH3NpY4vsrVlnv9PNGqQj8wd7rJ6nEypLrJ7z5vxK5RP0yMLo6J/Gsm62DI5Q==}
 
+  style-to-js@1.1.21:
+    resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==}
+
+  style-to-object@1.0.14:
+    resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
+
   styled-jsx@5.1.6:
     resolution: {integrity: sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==}
     engines: {node: '>= 12.0.0'}
@@ -7753,6 +8417,12 @@ packages:
     resolution: {integrity: sha512-1m4RA7xVAJrSGrrXGs0L3YTwyvBs2S8PbRHaLZAkFw7JR8oIFwYtysxlBZhYIa7xSyiYJKZ3iGrrk55cGA3i9A==}
     engines: {node: '>=0.6'}
 
+  trim-lines@3.0.1:
+    resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
+
+  trough@2.2.0:
+    resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
+
   truncate-utf8-bytes@1.0.2:
     resolution: {integrity: sha512-95Pu1QXQvruGEhv62XCMO3Mm90GscOCClvrIUwCM0PYOXK3kaF3l3sIHxx71ThJfcbM2O5Au6SO3AWCSEfW4mQ==}
 
@@ -7873,6 +8543,13 @@ packages:
     engines: {node: '>=14.17'}
     hasBin: true
 
+  ua-is-frozen@0.1.2:
+    resolution: {integrity: sha512-RwKDW2p3iyWn4UbaxpP2+VxwqXh0jpvdxsYpZ5j/MLLiQOfbsV5shpgQiw93+KMYQPcteeMQ289MaAFzs3G9pw==}
+
+  ua-parser-js@2.0.10:
+    resolution: {integrity: sha512-t+3Ktbq0Ies2vaSezfOaWiolH4OigQIO1dk+1xDpOydB1COVPocVYOrEV5rqZ0kFY9XYG1v9LutCyMgYBpABcw==}
+    hasBin: true
+
   ufo@1.6.4:
     resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==}
 
@@ -7919,6 +8596,30 @@ packages:
     resolution: {integrity: sha512-4yqz8a3n5HmGTlsbADNtr/dJlhkh/55Rq798G6ibiULcXbDtaLpTl1pvdqcbFfeoj3iSi52lePFM7h9H21cw/A==}
     engines: {node: '>=18.17'}
 
+  unified@11.0.5:
+    resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
+
+  unist-util-is@6.0.1:
+    resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
+
+  unist-util-position-from-estree@2.0.0:
+    resolution: {integrity: sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==}
+
+  unist-util-position@5.0.0:
+    resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
+
+  unist-util-remove-position@5.0.0:
+    resolution: {integrity: sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==}
+
+  unist-util-stringify-position@4.0.0:
+    resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
+
+  unist-util-visit-parents@6.0.2:
+    resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
+
+  unist-util-visit@5.1.0:
+    resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
+
   universalify@0.1.2:
     resolution: {integrity: sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==}
     engines: {node: '>= 4.0.0'}
@@ -8093,6 +8794,12 @@ packages:
     resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==}
     engines: {node: '>= 0.8'}
 
+  vfile-message@4.0.3:
+    resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+  vfile@6.0.3:
+    resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
   viem@2.23.2:
     resolution: {integrity: sha512-NVmW/E0c5crMOtbEAqMF0e3NmvQykFXhLOc/CkLIXOlzHSA6KXVz3CYVmaKqBF8/xtjsjHAGjdJN3Ru1kFJLaA==}
     peerDependencies:
@@ -8463,6 +9170,9 @@ packages:
       use-sync-external-store:
         optional: true
 
+  zwitch@2.0.4:
+    resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
+
 snapshots:
 
   '@achingbrain/http-parser-js@0.5.9':
@@ -9022,52 +9732,52 @@ snapshots:
       - utf-8-validate
       - zod
 
-  '@cdr-kit/agent@0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))':
+  '@cdr-kit/agent@0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
     dependencies:
-      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
-      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       pino: 9.14.0
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
     optionalDependencies:
-      '@cdr-kit/story': 0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@cdr-kit/story': 0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
     transitivePeerDependencies:
       - '@aws-sdk/client-s3'
       - '@filoz/synapse-sdk'
       - '@helia/unixfs'
       - '@storacha/client'
       - helia
-    optional: true
 
-  '@cdr-kit/agent@0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
+  '@cdr-kit/agent@0.6.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))':
     dependencies:
-      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
-      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      '@cdr-kit/core': 0.6.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       pino: 9.14.0
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
     optionalDependencies:
-      '@cdr-kit/story': 0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/story': 0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
     transitivePeerDependencies:
       - '@aws-sdk/client-s3'
       - '@filoz/synapse-sdk'
       - '@helia/unixfs'
       - '@storacha/client'
       - helia
+    optional: true
 
-  '@cdr-kit/contracts@0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))':
+  '@cdr-kit/contracts@0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))':
     dependencies:
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
 
   '@cdr-kit/contracts@0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
     dependencies:
       viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
 
-  '@cdr-kit/core@0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))':
+  '@cdr-kit/core@0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))':
     dependencies:
-      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       '@piplabs/cdr-crypto': 0.2.1
-      '@piplabs/cdr-sdk': 0.2.1(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(multiformats@13.4.2)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@piplabs/cdr-sdk': 0.2.1(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(multiformats@13.4.2)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       multiformats: 13.4.2
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
       zod: 3.25.76
     optionalDependencies:
       '@helia/unixfs': 5.1.0(encoding@0.1.13)
@@ -9089,25 +9799,40 @@ snapshots:
     transitivePeerDependencies:
       - '@filoz/synapse-sdk'
 
-  '@cdr-kit/react-ui@0.5.0(@cdr-kit/core@0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)))(@cdr-kit/react@0.5.0(fe6219abba1ce2fd38b5b8d62dc518fa))(@radix-ui/react-popover@1.1.15(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)':
+  '@cdr-kit/core@0.6.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))':
+    dependencies:
+      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      '@piplabs/cdr-crypto': 0.2.1
+      '@piplabs/cdr-sdk': 0.2.1(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(multiformats@13.4.2)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      multiformats: 13.4.2
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
+      zod: 3.25.76
+    optionalDependencies:
+      '@helia/unixfs': 5.1.0(encoding@0.1.13)
+      helia: 5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10)
+    transitivePeerDependencies:
+      - '@filoz/synapse-sdk'
+    optional: true
+
+  '@cdr-kit/react-ui@0.5.0(@cdr-kit/core@0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)))(@cdr-kit/react@0.5.0(78f83cda882c8eaeee56bebfc104fe07))(@radix-ui/react-popover@1.1.15(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)':
     dependencies:
-      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
-      '@cdr-kit/react': 0.5.0(fe6219abba1ce2fd38b5b8d62dc518fa)
+      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      '@cdr-kit/react': 0.5.0(78f83cda882c8eaeee56bebfc104fe07)
       '@radix-ui/react-popover': 1.1.15(@types/react-dom@19.2.3(@types/react@19.2.15))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
       react: 19.2.4
       react-dom: 19.2.4(react@19.2.4)
 
-  '@cdr-kit/react@0.5.0(fe6219abba1ce2fd38b5b8d62dc518fa)':
+  '@cdr-kit/react@0.5.0(78f83cda882c8eaeee56bebfc104fe07)':
     dependencies:
-      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
-      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       '@tanstack/react-query': 5.100.14(react@19.2.4)
       react: 19.2.4
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
-      wagmi: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
+      wagmi: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(zod@3.25.76)
     optionalDependencies:
-      '@cdr-kit/agent': 0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
-      '@cdr-kit/story': 0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@cdr-kit/agent': 0.6.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      '@cdr-kit/story': 0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
     transitivePeerDependencies:
       - '@aws-sdk/client-s3'
       - '@filoz/synapse-sdk'
@@ -9115,28 +9840,28 @@ snapshots:
       - '@storacha/client'
       - helia
 
-  '@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))':
+  '@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))':
     dependencies:
-      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
-      '@story-protocol/core-sdk': 1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+      '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
+      '@story-protocol/core-sdk': 1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
     optional: true
 
-  '@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
+  '@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
     dependencies:
       '@cdr-kit/contracts': 0.5.0(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       '@story-protocol/core-sdk': 1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
       viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
     optional: true
 
-  '@cdr-kit/tools@0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
+  '@cdr-kit/tools@0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
     dependencies:
-      '@cdr-kit/agent': 0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/agent': 0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       '@cdr-kit/core': 0.5.0(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       zod: 3.25.76
       zod-to-json-schema: 3.25.2(zod@3.25.76)
     optionalDependencies:
-      '@cdr-kit/story': 0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/story': 0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
     transitivePeerDependencies:
       - '@aws-sdk/client-s3'
       - '@filoz/synapse-sdk'
@@ -9145,10 +9870,10 @@ snapshots:
       - helia
       - viem
 
-  '@cdr-kit/vercel-ai@0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(ai@6.0.191(zod@4.4.3))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
+  '@cdr-kit/vercel-ai@0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(ai@6.0.191(zod@4.4.3))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
     dependencies:
-      '@cdr-kit/agent': 0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
-      '@cdr-kit/tools': 0.5.0(@cdr-kit/story@0.5.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/agent': 0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
+      '@cdr-kit/tools': 0.5.0(@cdr-kit/story@0.6.0(@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)))(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.6)(utf-8-validate@6.0.6))(utf-8-validate@6.0.6))(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))
       ai: 6.0.191(zod@4.4.3)
     transitivePeerDependencies:
       - '@aws-sdk/client-s3'
@@ -9635,6 +10360,8 @@ snapshots:
       tslib: 2.8.1
     optional: true
 
+  '@emotion/hash@0.9.2': {}
+
   '@ensofinance/sdk@2.4.1':
     dependencies:
       axios: 1.16.0(debug@4.4.3)
@@ -11244,6 +11971,36 @@ snapshots:
       globby: 11.1.0
       read-yaml-file: 1.1.0
 
+  '@mdx-js/mdx@3.1.1':
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdx': 2.0.13
+      acorn: 8.16.0
+      collapse-white-space: 2.1.0
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      estree-util-scope: 1.0.0
+      estree-walker: 3.0.3
+      hast-util-to-jsx-runtime: 2.3.6
+      markdown-extensions: 2.0.0
+      recma-build-jsx: 1.0.0
+      recma-jsx: 1.0.1(acorn@8.16.0)
+      recma-stringify: 1.0.0
+      rehype-recma: 1.0.0
+      remark-mdx: 3.1.1
+      remark-parse: 11.0.0
+      remark-rehype: 11.1.2
+      source-map: 0.7.6
+      unified: 11.0.5
+      unist-util-position-from-estree: 2.0.0
+      unist-util-stringify-position: 4.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+    transitivePeerDependencies:
+      - supports-color
+
   '@metamask/abi-utils@2.0.4':
     dependencies:
       '@metamask/superstruct': 3.2.1
@@ -11704,6 +12461,8 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@orama/orama@3.1.18': {}
+
   '@oxc-project/types@0.133.0': {}
 
   '@paulmillr/qr@0.2.1': {}
@@ -11820,10 +12579,6 @@ snapshots:
     dependencies:
       viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
 
-  '@piplabs/cdr-contracts@0.2.1(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))':
-    dependencies:
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
-
   '@piplabs/cdr-contracts@0.2.1(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3))':
     dependencies:
       viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@6.0.6)(zod@4.4.3)
@@ -11835,11 +12590,11 @@ snapshots:
       '@noble/curves': 1.6.0
       '@noble/hashes': 2.0.1
 
-  '@piplabs/cdr-sdk@0.2.1(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(multiformats@13.4.2)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))':
+  '@piplabs/cdr-sdk@0.2.1(@helia/unixfs@5.1.0(encoding@0.1.13))(helia@5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10))(multiformats@13.4.2)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))':
     dependencies:
-      '@piplabs/cdr-contracts': 0.2.1(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3))
+      '@piplabs/cdr-contracts': 0.2.1(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))
       '@piplabs/cdr-crypto': 0.2.1
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
     optionalDependencies:
       '@helia/unixfs': 5.1.0(encoding@0.1.13)
       helia: 5.5.1(bufferutil@4.1.0)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(utf-8-validate@5.0.10)
@@ -12094,6 +12849,25 @@ snapshots:
 
   '@radix-ui/rect@1.1.1': {}
 
+  '@rainbow-me/rainbowkit@2.2.11(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(wagmi@2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(zod@3.25.76))':
+    dependencies:
+      '@tanstack/react-query': 5.100.14(react@19.2.4)
+      '@vanilla-extract/css': 1.20.1
+      '@vanilla-extract/dynamic': 2.1.5
+      '@vanilla-extract/sprinkles': 1.6.5(@vanilla-extract/css@1.20.1)
+      clsx: 2.1.1
+      cuer: 0.0.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3)
+      react: 19.2.4
+      react-dom: 19.2.4(react@19.2.4)
+      react-remove-scroll: 2.7.2(@types/react@19.2.15)(react@19.2.4)
+      ua-parser-js: 2.0.10
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
+      wagmi: 2.19.5(@tanstack/query-core@5.100.14)(@tanstack/react-query@5.100.14(react@19.2.4))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(react-native@0.85.3(@babel/core@7.29.7)(@types/react@19.2.15)(bufferutil@4.1.0)(react@19.2.4)(utf-8-validate@5.0.10))(react@19.2.4)(typescript@5.9.3)(utf-8-validate@5.0.10)(viem@2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76))(zod@3.25.76)
+    transitivePeerDependencies:
+      - '@types/react'
+      - babel-plugin-macros
+      - typescript
+
   '@react-native/assets-registry@0.85.3': {}
 
   '@react-native/codegen@0.85.3(@babel/core@7.29.7)':
@@ -13197,6 +13971,46 @@ snapshots:
       '@noble/hashes': 1.8.0
       '@scure/base': 1.2.6
 
+  '@shikijs/core@4.2.0':
+    dependencies:
+      '@shikijs/primitive': 4.2.0
+      '@shikijs/types': 4.2.0
+      '@shikijs/vscode-textmate': 10.0.2
+      '@types/hast': 3.0.4
+      hast-util-to-html: 9.0.5
+
+  '@shikijs/engine-javascript@4.2.0':
+    dependencies:
+      '@shikijs/types': 4.2.0
+      '@shikijs/vscode-textmate': 10.0.2
+      oniguruma-to-es: 4.3.6
+
+  '@shikijs/engine-oniguruma@4.2.0':
+    dependencies:
+      '@shikijs/types': 4.2.0
+      '@shikijs/vscode-textmate': 10.0.2
+
+  '@shikijs/langs@4.2.0':
+    dependencies:
+      '@shikijs/types': 4.2.0
+
+  '@shikijs/primitive@4.2.0':
+    dependencies:
+      '@shikijs/types': 4.2.0
+      '@shikijs/vscode-textmate': 10.0.2
+      '@types/hast': 3.0.4
+
+  '@shikijs/themes@4.2.0':
+    dependencies:
+      '@shikijs/types': 4.2.0
+
+  '@shikijs/types@4.2.0':
+    dependencies:
+      '@shikijs/vscode-textmate': 10.0.2
+      '@types/hast': 3.0.4
+
+  '@shikijs/vscode-textmate@10.0.2': {}
+
   '@simplewebauthn/browser@8.3.7':
     dependencies:
       '@simplewebauthn/typescript-types': 8.3.4
@@ -14306,14 +15120,14 @@ snapshots:
 
   '@standard-schema/spec@1.1.0': {}
 
-  '@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)':
+  '@story-protocol/core-sdk@1.4.4(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)':
     dependencies:
       '@scure/bip32': 1.7.0
-      abitype: 0.10.3(typescript@5.9.3)(zod@4.4.3)
+      abitype: 0.10.3(typescript@5.9.3)(zod@3.25.76)
       bs58: 6.0.0
       dotenv: 16.6.1
       multiformats: 9.9.0
-      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@4.4.3)
+      viem: 2.51.3(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76)
     transitivePeerDependencies:
       - bufferutil
       - typescript
@@ -14428,10 +15242,18 @@ snapshots:
     dependencies:
       '@types/node': 20.19.41
 
+  '@types/estree-jsx@1.0.5':
+    dependencies:
+      '@types/estree': 1.0.9
+
   '@types/estree@1.0.8': {}
 
   '@types/estree@1.0.9': {}
 
+  '@types/hast@3.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
   '@types/istanbul-lib-coverage@2.0.6': {}
 
   '@types/istanbul-lib-report@3.0.3':
@@ -14448,6 +15270,12 @@ snapshots:
 
   '@types/lodash@4.17.24': {}
 
+  '@types/mdast@4.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
+  '@types/mdx@2.0.13': {}
+
   '@types/ms@2.1.0': {}
 
   '@types/multicast-dns@7.2.4':
@@ -14500,6 +15328,10 @@ snapshots:
 
   '@types/trusted-types@2.0.7': {}
 
+  '@types/unist@2.0.11': {}
+
+  '@types/unist@3.0.3': {}
+
   '@types/uuid@10.0.0': {}
 
   '@types/ws@7.4.7':
@@ -14607,8 +15439,36 @@ snapshots:
       '@typescript-eslint/types': 8.60.0
       eslint-visitor-keys: 5.0.1
 
+  '@ungap/structured-clone@1.3.1': {}
+
   '@uniswap/token-lists@1.0.0-beta.33': {}
 
+  '@vanilla-extract/css@1.20.1':
+    dependencies:
+      '@emotion/hash': 0.9.2
+      '@vanilla-extract/private': 1.0.9
+      css-what: 6.2.2
+      csstype: 3.2.3
+      dedent: 1.7.2
+      deep-object-diff: 1.1.9
+      deepmerge: 4.3.1
+      lru-cache: 10.4.3
+      media-query-parser: 2.0.2
+      modern-ahocorasick: 1.1.0
+      picocolors: 1.1.1
+    transitivePeerDependencies:
+      - babel-plugin-macros
+
+  '@vanilla-extract/dynamic@2.1.5':
+    dependencies:
+      '@vanilla-extract/private': 1.0.9
+
+  '@vanilla-extract/private@1.0.9': {}
+
+  '@vanilla-extract/sprinkles@1.6.5(@vanilla-extract/css@1.20.1)':
+    dependencies:
+      '@vanilla-extract/css': 1.20.1
+
   '@vaultsfyi/sdk@2.3.5(@tanstack/react-query@5.100.14(react@19.2.6))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(fastestsmallesttextencoderdecoder@1.0.22)(react@19.2.6)(typescript@5.9.3)(utf-8-validate@6.0.6)':
     dependencies:
       x402-fetch: 0.7.0(@tanstack/react-query@5.100.14(react@19.2.6))(@types/react@19.2.15)(bufferutil@4.1.0)(encoding@0.1.13)(fastestsmallesttextencoderdecoder@1.0.22)(react@19.2.6)(typescript@5.9.3)(utf-8-validate@6.0.6)
@@ -16483,6 +17343,8 @@ snapshots:
       estree-walker: 3.0.3
       pathe: 2.0.3
 
+  astring@1.9.0: {}
+
   async-mutex@0.2.6:
     dependencies:
       tslib: 2.8.1
@@ -16518,6 +17380,8 @@ snapshots:
     dependencies:
       hermes-parser: 0.33.3
 
+  bail@2.0.2: {}
+
   balanced-match@1.0.2: {}
 
   balanced-match@4.0.4: {}
@@ -16727,6 +17591,8 @@ snapshots:
 
   cborg@5.1.1: {}
 
+  ccount@2.0.1: {}
+
   chai@5.3.3:
     dependencies:
       assertion-error: 2.0.1
@@ -16744,6 +17610,14 @@ snapshots:
 
   change-case@5.4.4: {}
 
+  character-entities-html4@2.1.0: {}
+
+  character-entities-legacy@3.0.0: {}
+
+  character-entities@2.0.2: {}
+
+  character-reference-invalid@2.0.1: {}
+
   chardet@2.1.1: {}
 
   charenc@0.0.2: {}
@@ -16835,6 +17709,10 @@ snapshots:
 
   clsx@1.2.1: {}
 
+  clsx@2.1.1: {}
+
+  collapse-white-space@2.1.0: {}
+
   color-convert@2.0.1:
     dependencies:
       color-name: 1.1.4
@@ -16845,6 +17723,8 @@ snapshots:
     dependencies:
       delayed-stream: 1.0.0
 
+  comma-separated-tokens@2.0.3: {}
+
   commander@12.1.0: {}
 
   commander@14.0.2: {}
@@ -16853,6 +17733,8 @@ snapshots:
 
   commander@2.20.3: {}
 
+  compute-scroll-into-view@3.1.1: {}
+
   concat-map@0.0.1: {}
 
   connect@3.7.0:
@@ -16928,8 +17810,18 @@ snapshots:
 
   crypto-js@4.2.0: {}
 
+  css-what@6.2.2: {}
+
   csstype@3.2.3: {}
 
+  cuer@0.0.3(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(typescript@5.9.3):
+    dependencies:
+      qr: 0.6.0
+      react: 19.2.4
+      react-dom: 19.2.4(react@19.2.4)
+    optionalDependencies:
+      typescript: 5.9.3
+
   datastore-core@10.0.4:
     dependencies:
       '@libp2p/logger': 5.2.0
@@ -16967,6 +17859,10 @@ snapshots:
 
   decimal.js@10.6.0: {}
 
+  decode-named-character-reference@1.3.0:
+    dependencies:
+      character-entities: 2.0.2
+
   decode-uri-component@0.2.2: {}
 
   decompress-response@6.0.0:
@@ -16975,12 +17871,18 @@ snapshots:
 
   dedent@0.7.0: {}
 
+  dedent@1.7.2: {}
+
   deep-eql@5.0.2: {}
 
   deep-extend@0.6.0: {}
 
   deep-is@0.1.4: {}
 
+  deep-object-diff@1.1.9: {}
+
+  deepmerge@4.3.1: {}
+
   default-browser-id@5.0.1: {}
 
   default-browser@5.5.0:
@@ -17026,12 +17928,18 @@ snapshots:
 
   detect-browser@5.3.0: {}
 
+  detect-europe-js@0.1.2: {}
+
   detect-indent@6.1.0: {}
 
   detect-libc@2.1.2: {}
 
   detect-node-es@1.1.0: {}
 
+  devlop@1.1.0:
+    dependencies:
+      dequal: 2.0.3
+
   dijkstrajs@1.0.3: {}
 
   dir-glob@3.0.1:
@@ -17173,6 +18081,20 @@ snapshots:
     dependencies:
       es6-promise: 4.2.8
 
+  esast-util-from-estree@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      unist-util-position-from-estree: 2.0.0
+
+  esast-util-from-js@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      acorn: 8.16.0
+      esast-util-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
   esbuild@0.21.5:
     optionalDependencies:
       '@esbuild/aix-ppc64': 0.21.5
@@ -17265,6 +18187,8 @@ snapshots:
 
   escape-string-regexp@4.0.0: {}
 
+  escape-string-regexp@5.0.0: {}
+
   eslint-scope@8.4.0:
     dependencies:
       esrecurse: 4.3.0
@@ -17335,6 +18259,39 @@ snapshots:
 
   estraverse@5.3.0: {}
 
+  estree-util-attach-comments@3.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+
+  estree-util-build-jsx@3.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      estree-walker: 3.0.3
+
+  estree-util-is-identifier-name@3.0.0: {}
+
+  estree-util-scope@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+
+  estree-util-to-js@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      astring: 1.9.0
+      source-map: 0.7.6
+
+  estree-util-value-to-estree@3.5.0:
+    dependencies:
+      '@types/estree': 1.0.9
+
+  estree-util-visit@2.0.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/unist': 3.0.3
+
   estree-walker@3.0.3:
     dependencies:
       '@types/estree': 1.0.9
@@ -17509,6 +18466,8 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  extend@3.0.2: {}
+
   extendable-error@0.1.7: {}
 
   extension-port-stream@3.0.0:
@@ -17686,6 +18645,68 @@ snapshots:
   fsevents@2.3.3:
     optional: true
 
+  fumadocs-core@16.9.3(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.15)(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76):
+    dependencies:
+      '@orama/orama': 3.1.18
+      estree-util-value-to-estree: 3.5.0
+      github-slugger: 2.0.0
+      hast-util-to-estree: 3.1.3
+      hast-util-to-jsx-runtime: 2.3.6
+      js-yaml: 4.1.1
+      mdast-util-mdx: 3.0.0
+      mdast-util-to-markdown: 2.1.2
+      remark: 15.0.1
+      remark-gfm: 4.0.1
+      remark-rehype: 11.1.2
+      scroll-into-view-if-needed: 3.1.0
+      shiki: 4.2.0
+      tinyglobby: 0.2.16
+      unified: 11.0.5
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+    optionalDependencies:
+      '@mdx-js/mdx': 3.1.1
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      '@types/react': 19.2.15
+      next: 16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      react: 19.2.4
+      react-dom: 19.2.4(react@19.2.4)
+      zod: 3.25.76
+    transitivePeerDependencies:
+      - supports-color
+
+  fumadocs-mdx@15.0.10(@types/mdast@4.0.4)(@types/mdx@2.0.13)(@types/react@19.2.15)(fumadocs-core@16.9.3(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.15)(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76))(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react@19.2.4)(rolldown@1.0.3)(vite@5.4.21(@types/node@25.9.1)(lightningcss@1.32.0)(terser@5.48.0)):
+    dependencies:
+      '@mdx-js/mdx': 3.1.1
+      '@standard-schema/spec': 1.1.0
+      chokidar: 5.0.0
+      esbuild: 0.28.0
+      estree-util-value-to-estree: 3.5.0
+      fumadocs-core: 16.9.3(@mdx-js/mdx@3.1.1)(@types/estree-jsx@1.0.5)(@types/hast@3.0.4)(@types/mdast@4.0.4)(@types/react@19.2.15)(next@16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4))(react-dom@19.2.4(react@19.2.4))(react@19.2.4)(zod@3.25.76)
+      js-yaml: 4.1.1
+      mdast-util-mdx: 3.0.0
+      picocolors: 1.1.1
+      picomatch: 4.0.4
+      tinyexec: 1.2.2
+      tinyglobby: 0.2.16
+      unified: 11.0.5
+      unist-util-remove-position: 5.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+      zod: 4.4.3
+    optionalDependencies:
+      '@types/mdast': 4.0.4
+      '@types/mdx': 2.0.13
+      '@types/react': 19.2.15
+      next: 16.2.6(@babel/core@7.29.7)(@opentelemetry/api@1.9.1)(react-dom@19.2.4(react@19.2.4))(react@19.2.4)
+      react: 19.2.4
+      rolldown: 1.0.3
+      vite: 5.4.21(@types/node@25.9.1)(lightningcss@1.32.0)(terser@5.48.0)
+    transitivePeerDependencies:
+      - supports-color
+
   function-bind@1.1.2: {}
 
   function-timeout@0.1.1: {}
@@ -17726,6 +18747,8 @@ snapshots:
 
   github-from-package@0.0.0: {}
 
+  github-slugger@2.0.0: {}
+
   glob-parent@5.1.2:
     dependencies:
       is-glob: 4.0.3
@@ -17809,6 +18832,65 @@ snapshots:
     dependencies:
       function-bind: 1.1.2
 
+  hast-util-to-estree@3.1.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      estree-util-attach-comments: 3.0.0
+      estree-util-is-identifier-name: 3.0.0
+      hast-util-whitespace: 3.0.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      style-to-js: 1.1.21
+      unist-util-position: 5.0.0
+      zwitch: 2.0.4
+    transitivePeerDependencies:
+      - supports-color
+
+  hast-util-to-html@9.0.5:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      comma-separated-tokens: 2.0.3
+      hast-util-whitespace: 3.0.0
+      html-void-elements: 3.0.0
+      mdast-util-to-hast: 13.2.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      stringify-entities: 4.0.4
+      zwitch: 2.0.4
+
+  hast-util-to-jsx-runtime@2.3.6:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/hast': 3.0.4
+      '@types/unist': 3.0.3
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      hast-util-whitespace: 3.0.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      property-information: 7.2.0
+      space-separated-tokens: 2.0.2
+      style-to-js: 1.1.21
+      unist-util-position: 5.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  hast-util-whitespace@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.4
+
   headers-polyfill@5.0.1:
     dependencies:
       '@types/set-cookie-parser': 2.4.10
@@ -17961,6 +19043,8 @@ snapshots:
 
   hookable@6.1.1: {}
 
+  html-void-elements@3.0.0: {}
+
   http-cookie-agent@6.0.8(tough-cookie@5.1.2)(undici@6.26.0):
     dependencies:
       agent-base: 7.1.4
@@ -18025,6 +19109,8 @@ snapshots:
 
   ini@1.3.8: {}
 
+  inline-style-parser@0.2.7: {}
+
   inquirer@8.2.7(@types/node@25.9.1):
     dependencies:
       '@inquirer/external-editor': 1.0.3(@types/node@25.9.1)
@@ -18134,6 +19220,13 @@ snapshots:
 
   iron-webcrypto@1.2.1: {}
 
+  is-alphabetical@2.0.1: {}
+
+  is-alphanumerical@2.0.1:
+    dependencies:
+      is-alphabetical: 2.0.1
+      is-decimal: 2.0.1
+
   is-arguments@1.2.0:
     dependencies:
       call-bound: 1.0.4
@@ -18145,6 +19238,8 @@ snapshots:
 
   is-callable@1.2.7: {}
 
+  is-decimal@2.0.1: {}
+
   is-docker@2.2.1: {}
 
   is-docker@3.0.0: {}
@@ -18169,6 +19264,8 @@ snapshots:
 
   is-hex-prefixed@1.0.0: {}
 
+  is-hexadecimal@2.0.1: {}
+
   is-inside-container@1.0.0:
     dependencies:
       is-docker: 3.0.0
@@ -18206,6 +19303,8 @@ snapshots:
 
   is-retry-allowed@2.2.0: {}
 
+  is-standalone-pwa@0.1.1: {}
+
   is-stream@2.0.1: {}
 
   is-subdir@1.2.0:
@@ -18657,12 +19756,16 @@ snapshots:
       chalk: 4.1.2
       is-unicode-supported: 0.1.0
 
+  longest-streak@3.1.0: {}
+
   loose-envify@1.4.0:
     dependencies:
       js-tokens: 4.0.0
 
   loupe@3.2.1: {}
 
+  lru-cache@10.4.3: {}
+
   lru-cache@11.5.1: {}
 
   lru-cache@5.1.1:
@@ -18681,6 +19784,10 @@ snapshots:
     dependencies:
       tmpl: 1.0.5
 
+  markdown-extensions@2.0.0: {}
+
+  markdown-table@3.0.4: {}
+
   marky@1.3.0: {}
 
   math-intrinsics@1.1.0: {}
@@ -18697,6 +19804,173 @@ snapshots:
       crypt: 0.0.2
       is-buffer: 1.1.6
 
+  mdast-util-find-and-replace@3.0.2:
+    dependencies:
+      '@types/mdast': 4.0.4
+      escape-string-regexp: 5.0.0
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
+  mdast-util-from-markdown@2.0.3:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      mdast-util-to-string: 4.0.0
+      micromark: 4.0.2
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-decode-string: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-stringify-position: 4.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-autolink-literal@2.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-find-and-replace: 3.0.2
+      micromark-util-character: 2.1.1
+
+  mdast-util-gfm-footnote@2.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      micromark-util-normalize-identifier: 2.0.1
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-strikethrough@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-table@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      markdown-table: 3.0.4
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm@3.1.0:
+    dependencies:
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-gfm-autolink-literal: 2.0.1
+      mdast-util-gfm-footnote: 2.1.0
+      mdast-util-gfm-strikethrough: 2.0.0
+      mdast-util-gfm-table: 2.0.0
+      mdast-util-gfm-task-list-item: 2.0.0
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-expression@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-jsx@3.2.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      parse-entities: 4.0.2
+      stringify-entities: 4.0.4
+      unist-util-stringify-position: 4.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx@3.0.0:
+    dependencies:
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdxjs-esm@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-phrasing@4.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      unist-util-is: 6.0.1
+
+  mdast-util-to-hast@13.2.1:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      '@ungap/structured-clone': 1.3.1
+      devlop: 1.1.0
+      micromark-util-sanitize-uri: 2.0.1
+      trim-lines: 3.0.1
+      unist-util-position: 5.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+
+  mdast-util-to-markdown@2.1.2:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      longest-streak: 3.1.0
+      mdast-util-phrasing: 4.1.0
+      mdast-util-to-string: 4.0.0
+      micromark-util-classify-character: 2.0.1
+      micromark-util-decode-string: 2.0.1
+      unist-util-visit: 5.1.0
+      zwitch: 2.0.4
+
+  mdast-util-to-string@4.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+
+  media-query-parser@2.0.2:
+    dependencies:
+      '@babel/runtime': 7.29.7
+
   media-typer@1.1.0: {}
 
   memoize-one@5.2.1: {}
@@ -18969,6 +20243,270 @@ snapshots:
 
   micro-ftch@0.3.1: {}
 
+  micromark-core-commonmark@2.0.3:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-factory-destination: 2.0.1
+      micromark-factory-label: 2.0.1
+      micromark-factory-space: 2.0.1
+      micromark-factory-title: 2.0.1
+      micromark-factory-whitespace: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-html-tag-name: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-autolink-literal@2.1.0:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-footnote@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-table@2.1.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-tagfilter@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm@3.0.0:
+    dependencies:
+      micromark-extension-gfm-autolink-literal: 2.1.0
+      micromark-extension-gfm-footnote: 2.1.0
+      micromark-extension-gfm-strikethrough: 2.1.0
+      micromark-extension-gfm-table: 2.1.1
+      micromark-extension-gfm-tagfilter: 2.0.0
+      micromark-extension-gfm-task-list-item: 2.1.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdx-expression@3.0.1:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdx-jsx@3.0.2:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      micromark-factory-mdx-expression: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      vfile-message: 4.0.3
+
+  micromark-extension-mdx-md@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-extension-mdxjs-esm@3.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-extension-mdxjs@3.0.0:
+    dependencies:
+      acorn: 8.16.0
+      acorn-jsx: 5.3.2(acorn@8.16.0)
+      micromark-extension-mdx-expression: 3.0.1
+      micromark-extension-mdx-jsx: 3.0.2
+      micromark-extension-mdx-md: 2.0.0
+      micromark-extension-mdxjs-esm: 3.0.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-destination@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-label@2.0.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-mdx-expression@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-events-to-acorn: 2.0.3
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-position-from-estree: 2.0.0
+      vfile-message: 4.0.3
+
+  micromark-factory-space@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-title@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-whitespace@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-character@2.1.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-chunked@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-classify-character@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-combine-extensions@2.0.1:
+    dependencies:
+      micromark-util-chunked: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-decode-string@2.0.1:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      micromark-util-character: 2.1.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-encode@2.0.1: {}
+
+  micromark-util-events-to-acorn@2.0.3:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/unist': 3.0.3
+      devlop: 1.1.0
+      estree-util-visit: 2.0.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      vfile-message: 4.0.3
+
+  micromark-util-html-tag-name@2.0.1: {}
+
+  micromark-util-normalize-identifier@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-resolve-all@2.0.1:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-util-sanitize-uri@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-encode: 2.0.1
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-subtokenize@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-symbol@2.0.1: {}
+
+  micromark-util-types@2.0.2: {}
+
+  micromark@4.0.2:
+    dependencies:
+      '@types/debug': 4.1.13
+      debug: 4.4.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-encode: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+    transitivePeerDependencies:
+      - supports-color
+
   micromatch@4.0.8:
     dependencies:
       braces: 3.0.3
@@ -19014,6 +20552,8 @@ snapshots:
 
   mkdirp@1.0.4: {}
 
+  modern-ahocorasick@1.1.0: {}
+
   mortice@3.3.1:
     dependencies:
       abort-error: 1.0.2
@@ -19244,6 +20784,14 @@ snapshots:
     dependencies:
       mimic-fn: 2.1.0
 
+  oniguruma-parser@0.12.2: {}
+
+  oniguruma-to-es@4.3.6:
+    dependencies:
+      oniguruma-parser: 0.12.2
+      regex: 6.1.0
+      regex-recursion: 6.0.2
+
   open@10.2.0:
     dependencies:
       default-browser: 5.5.0
@@ -19502,6 +21050,16 @@ snapshots:
     dependencies:
       callsites: 3.1.0
 
+  parse-entities@4.0.2:
+    dependencies:
+      '@types/unist': 2.0.11
+      character-entities-legacy: 3.0.0
+      character-reference-invalid: 2.0.1
+      decode-named-character-reference: 1.3.0
+      is-alphanumerical: 2.0.1
+      is-decimal: 2.0.1
+      is-hexadecimal: 2.0.1
+
   parseurl@1.3.3: {}
 
   path-exists@4.0.0: {}
@@ -19709,6 +21267,8 @@ snapshots:
     dependencies:
       asap: 2.0.6
 
+  property-information@7.2.0: {}
+
   protons-runtime@5.6.0:
     dependencies:
       uint8-varint: 2.0.5
@@ -19750,6 +21310,8 @@ snapshots:
 
   pvutils@1.1.5: {}
 
+  qr@0.6.0: {}
+
   qrcode@1.5.3:
     dependencies:
       dijkstrajs: 1.0.3
@@ -20078,12 +21640,109 @@ snapshots:
 
   real-require@0.2.0: {}
 
+  recma-build-jsx@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      estree-util-build-jsx: 3.0.1
+      vfile: 6.0.3
+
+  recma-jsx@1.0.1(acorn@8.16.0):
+    dependencies:
+      acorn: 8.16.0
+      acorn-jsx: 5.3.2(acorn@8.16.0)
+      estree-util-to-js: 2.0.0
+      recma-parse: 1.0.0
+      recma-stringify: 1.0.0
+      unified: 11.0.5
+
+  recma-parse@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      esast-util-from-js: 2.0.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  recma-stringify@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      estree-util-to-js: 2.0.0
+      unified: 11.0.5
+      vfile: 6.0.3
+
   redaxios@0.5.1: {}
 
   reflect-metadata@0.2.2: {}
 
   regenerator-runtime@0.13.11: {}
 
+  regex-recursion@6.0.2:
+    dependencies:
+      regex-utilities: 2.3.0
+
+  regex-utilities@2.3.0: {}
+
+  regex@6.1.0:
+    dependencies:
+      regex-utilities: 2.3.0
+
+  rehype-recma@1.0.0:
+    dependencies:
+      '@types/estree': 1.0.9
+      '@types/hast': 3.0.4
+      hast-util-to-estree: 3.1.3
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-gfm@4.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-gfm: 3.1.0
+      micromark-extension-gfm: 3.0.0
+      remark-parse: 11.0.0
+      remark-stringify: 11.0.0
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-mdx@3.1.1:
+    dependencies:
+      mdast-util-mdx: 3.0.0
+      micromark-extension-mdxjs: 3.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-parse@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.0.3
+      micromark-util-types: 2.0.2
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-rehype@11.1.2:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      mdast-util-to-hast: 13.2.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  remark-stringify@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-to-markdown: 2.1.2
+      unified: 11.0.5
+
+  remark@15.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      remark-parse: 11.0.0
+      remark-stringify: 11.0.0
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
   require-directory@2.1.1: {}
 
   require-from-string@2.0.2: {}
@@ -20244,6 +21903,10 @@ snapshots:
 
   scheduler@0.27.0: {}
 
+  scroll-into-view-if-needed@3.1.0:
+    dependencies:
+      compute-scroll-into-view: 3.1.1
+
   scrypt-js@3.0.1: {}
 
   secp256k1@5.0.1:
@@ -20374,6 +22037,17 @@ snapshots:
 
   shell-quote@1.8.4: {}
 
+  shiki@4.2.0:
+    dependencies:
+      '@shikijs/core': 4.2.0
+      '@shikijs/engine-javascript': 4.2.0
+      '@shikijs/engine-oniguruma': 4.2.0
+      '@shikijs/langs': 4.2.0
+      '@shikijs/themes': 4.2.0
+      '@shikijs/types': 4.2.0
+      '@shikijs/vscode-textmate': 10.0.2
+      '@types/hast': 3.0.4
+
   side-channel-list@1.0.1:
     dependencies:
       es-errors: 1.3.0
@@ -20466,6 +22140,10 @@ snapshots:
 
   source-map@0.6.1: {}
 
+  source-map@0.7.6: {}
+
+  space-separated-tokens@2.0.2: {}
+
   sparse-array@1.3.2: {}
 
   spawndamnit@3.0.1:
@@ -20529,6 +22207,11 @@ snapshots:
     dependencies:
       safe-buffer: 5.2.1
 
+  stringify-entities@4.0.4:
+    dependencies:
+      character-entities-html4: 2.1.0
+      character-entities-legacy: 3.0.0
+
   strip-ansi@6.0.1:
     dependencies:
       ansi-regex: 5.0.1
@@ -20545,6 +22228,14 @@ snapshots:
 
   strnum@2.3.0: {}
 
+  style-to-js@1.1.21:
+    dependencies:
+      style-to-object: 1.0.14
+
+  style-to-object@1.0.14:
+    dependencies:
+      inline-style-parser: 0.2.7
+
   styled-jsx@5.1.6(@babel/core@7.29.7)(react@19.2.4):
     dependencies:
       client-only: 0.0.1
@@ -20702,6 +22393,10 @@ snapshots:
 
   treeify@1.1.0: {}
 
+  trim-lines@3.0.1: {}
+
+  trough@2.2.0: {}
+
   truncate-utf8-bytes@1.0.2:
     dependencies:
       utf8-byte-length: 1.0.5
@@ -20814,6 +22509,14 @@ snapshots:
 
   typescript@5.9.3: {}
 
+  ua-is-frozen@0.1.2: {}
+
+  ua-parser-js@2.0.10:
+    dependencies:
+      detect-europe-js: 0.1.2
+      is-standalone-pwa: 0.1.1
+      ua-is-frozen: 0.1.2
+
   ufo@1.6.4: {}
 
   uint8-varint@2.0.5:
@@ -20864,6 +22567,48 @@ snapshots:
 
   undici@6.26.0: {}
 
+  unified@11.0.5:
+    dependencies:
+      '@types/unist': 3.0.3
+      bail: 2.0.2
+      devlop: 1.1.0
+      extend: 3.0.2
+      is-plain-obj: 4.1.0
+      trough: 2.2.0
+      vfile: 6.0.3
+
+  unist-util-is@6.0.1:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-position-from-estree@2.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-remove-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-visit: 5.1.0
+
+  unist-util-stringify-position@4.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-visit-parents@6.0.2:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+
+  unist-util-visit@5.1.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
   universalify@0.1.2: {}
 
   unpipe@1.0.0: {}
@@ -20983,6 +22728,16 @@ snapshots:
 
   vary@1.1.2: {}
 
+  vfile-message@4.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-stringify-position: 4.0.0
+
+  vfile@6.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      vfile-message: 4.0.3
+
   viem@2.23.2(bufferutil@4.1.0)(typescript@5.9.3)(utf-8-validate@5.0.10)(zod@3.25.76):
     dependencies:
       '@noble/curves': 1.8.1
@@ -21876,3 +23631,5 @@ snapshots:
       '@types/react': 19.2.15
       react: 19.2.6
       use-sync-external-store: 1.6.0(react@19.2.6)
+
+  zwitch@2.0.4: {}