oc-agent-web

Reference web client for OC Agent. Bitcoin-identity-bound delegation authority for autonomous agents. Lives at agent.ochk.io.

Next.js 15 (Pages Router) + Tailwind 4 + Radix UI + @orangecheck/* packages.

Routes

Path	What it is
/	Landing — Hero, HowItWorks, WhyV2, Ecosystem, BottomCta
/app	The main interactive surface — connect wallet, create a delegation, see your issued delegations, revoke
/inspect	Paste any delegation / action / revocation envelope; browser runs §SPEC 8 locally
/inspect/[id]	Inspect a specific envelope from your browser's store
/docs/*	MDX docs: overview, quickstart, protocol, spec, scopes, security, why, faq, glossary
/api/og	Dynamic OpenGraph image (1200×630)
/sitemap.xml	Sitemap

Local development

This repo consumes oc-packages as a git submodule at packages/. After cloning:

git submodule update --init --recursive
yarn install
yarn dev    # http://localhost:3000

Sibling packages (@orangecheck/agent-core, @orangecheck/agent-signer, @orangecheck/stamp-core, @orangecheck/wallet-adapter) are resolved via file: dependencies to the submodule, so local changes to them reflect immediately after rebuild.

Commands

yarn dev	Dev server (Turbopack disabled — works around local symlink resolution)
yarn build	Production build
yarn start	Serve the build
yarn type-check	tsc --noEmit
yarn test	Vitest

Stack

• Next.js 15 Pages Router + MDX (with @next/mdx, remark-gfm, rehype-slug, rehype-autolink-headings)
• Tailwind 4 via @tailwindcss/postcss, dark-first theming via next-themes
• Radix UI for dialogs, popovers, separators, labels
• bip322-js for on-page BIP-322 signature verification
• qrcode for QR rendering when shipping delegations out-of-band
• @orangecheck/* submodule packages for envelope canonicalization, signing, verification, and wallet plumbing

Deployment

• Vercel handles Git-push deploys automatically. vercel.json pins runtime, headers, and output directory.
• Namecheap — agent.ochk.io CNAMEd to cname.vercel-dns.com.
• CSP in next.config.ts allows the usual OrangeCheck hosts: plausible.io, ochk.io, mempool.space, blockstream.info, plus Nostr relays (relay.damus.io, relay.nostr.band, nos.lol, relay.snort.social).

Repository structure

src/
  components/
    app/            DelegateForm, DelegationList, WalletPanel
    inspect/        InspectPanel
    landing/        Hero, HowItWorks, WhyV2, Ecosystem, BottomCta
    layout/         LayoutHeader, LayoutFooter, IdentityChip, LogoMark, ThemeProvider, MdxComponents
    docs/           DocsLayout, DocsNav, DocsBreadcrumb, DocsPagination, nav
    ui/             Button, Input, Textarea, Label, Alert, Badge, Sheet, Separator, ConfirmDialog, ErrorBoundary, Working, ThemeToggle
  lib/
    storage/        delegations (IDB-lite via localStorage)
    wallet/         connection, sign
    utils/          cn helper
  pages/
    _app.tsx, _document.tsx, index.tsx, sitemap.xml.ts
    app/            index.tsx
    inspect/        index.tsx, [id].tsx
    docs/           *.mdx (9 pages)
    api/            og.tsx
  styles/           globals.css
public/             favicon.svg, robots.txt

License

MIT. See LICENSE in the oc-agent-protocol repository for the specification license.