Skip to content

Add public genesis receipt proof page and site links#380

Merged
GsCommand merged 1 commit into
mainfrom
codex/add-public-ui-for-genesis-receipt-verification
May 29, 2026
Merged

Add public genesis receipt proof page and site links#380
GsCommand merged 1 commit into
mainfrom
codex/add-public-ui-for-genesis-receipt-verification

Conversation

@GsCommand

Copy link
Copy Markdown
Contributor

Motivation

  • Provide a dedicated public UI for retrieving and cryptographically verifying stored genesis receipts by ID, separate from the existing receipt model and manual verifier pages.
  • Surface the production-proven stored-genesis lookup flow (POST /api/verify-idGET /api/receipts/:id) without changing verification or receipt-generation backend logic.

Description

  • Add a new public page public/genesis-proof.html implementing the verification-by-ID UI with required metadata, hero copy, input (Genesis Receipt ID), submit behavior, visible states (IDLE, LOADING, VERIFIED, INVALID, RECEIPT NOT FOUND, ERROR), copy buttons, and JSON panel; it posts to POST /api/verify-id and on success fetches GET /api/receipts/${encodeURIComponent(receiptId)} to show public receipt JSON.
  • Render only safe verification fields provided by the existing API: status, receipt_id, receipt_type, agent, verb, signer, and verification booleans hash_matches, signature_valid, and ens_resolved, plus public_key_source and key_id when present from POST /api/verify-id responses.
  • Add focused, non-breaking site links/cards pointing to /genesis-proof.html from the verifier (public/verify.html), receipts (public/receipts.html), homepage (public/index.html), docs home (public/docs.html), protocol (public/protocol.html), live proof (public/proof.html), production proof (public/stack-proof-demo.html), and the API reference (public/api.html), and include a compact developer example for POST /api/verify-id in public/api.html.
  • Preserve existing pages (/receipts.html, /verify.html, existing API handlers) and do not alter cryptographic/verification backend code or genesis generation logic.
  • Small site polish fixes (minor CSS/class consistency edits) and ensured canonical/Open Graph metadata for the new page.

Testing

  • Ran npm test and all tests passed (125 tests passed, 0 failures), including api/verify-id and GET /api/receipts/:id contract tests that exercise VERIFIED, INVALID, and RECEIPT_NOT_FOUND flows.
  • Ran npm run check:links and the local link checker reported all local links/assets resolved across the site.
  • Ran cd examples/webhook-auto-verify && npm run check (example checks) and it passed.
  • Performed static assertions on public/genesis-proof.html to check required copy and absence of forbidden admin/payment tokens, and loaded the page via a local static server to confirm it serves correctly (local curl load check succeeded).

Codex Task

@vercel

vercel Bot commented May 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
commandlayer-commandlayer-org Ready Ready Preview, Comment May 29, 2026 1:59am
commandlayer-org Ready Ready Preview, Comment May 29, 2026 1:59am
commandlayer-org111 Ready Ready Preview, Comment May 29, 2026 1:59am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant