Skip to content

feat(docs): technical overview#1313

Merged
kunxian-xia merged 11 commits into
masterfrom
docs/how_it_works
Apr 20, 2026
Merged

feat(docs): technical overview#1313
kunxian-xia merged 11 commits into
masterfrom
docs/how_it_works

Conversation

@kunxian-xia
Copy link
Copy Markdown
Collaborator

@kunxian-xia kunxian-xia commented Apr 16, 2026

Summary

Goal: Add docs to explain our technical design in details.

This should remove the burden to understand Ceno for both developers or AI. These materials will also be helpful for design / review AI agents to have a thorough understanding of our technology.

Contents

topics that're covered:

  1. architecture overview

    • multi-chip architecture (frontend): each instance of each chip can span multiple rows, therefore the witness polynomials are $f_i(r, i)$, we allow
      • same-row constraint/gate $0 = C(f_1(r,i), \ldots, f_w(r,i))$
      • cross-row constraint/gate $0 = C(f_1(r,i), \ldots, f_w(r,i), f_1(r', i), \ldots, f_w(r', i))$.
    • multi-shards workflow
  2. optimizations

    • distributed sumcheck
  3. appendix

    • gkr protocol for tower tree
    • gkr protocol for logup
    • local rotation piop
    • ecc grand sum piop
    PIOP Purpose Sumcheck instances Opening points per committed MLE
    GKR for Grand Product Grand product $\prod_i a_i$ of $N = 2^d$ inputs $d - 1$ Input MLE $a$ at a single point $z \in B_d$
    Local Rotation PIOP Round-to-round state transition for round-based computations (e.g. Keccak-f) $1$ Each $f_j$ at three points $(\mathbf{s}_r, \mathbf{s}_i), (\mathbf{p}_0, \mathbf{s}_i), (\mathbf{p}_1, \mathbf{s}_i) \in B_m \times B_n$
    EC-Sum Quark PIOP Sum $\sum_i P_i$ of EC points on a short-Weierstrass curve $1$ $x, y$ at $(\mathbf{r}, 0), (\mathbf{r}, 1), (1, \mathbf{r}) \in B_{n+1}$; $s$ at $(1, \mathbf{r})$

kunxian-xia and others added 4 commits April 16, 2026 17:09
Convert math formulas from \\(...\\) / \\[...\\] (mdbook-only) to
$...$ / $$...$$ so they render correctly on GitHub.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Create separate technical-overview.md for the parent section page
to avoid using architecture-overview.md twice in SUMMARY.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@kunxian-xia kunxian-xia linked an issue Apr 16, 2026 that may be closed by this pull request
kunxian-xia and others added 7 commits April 16, 2026 18:44
- Add docs/theme/head.hbs to load MathJax 3 with $ / $$ delimiters
- Escape underscores in math as \_ to prevent markdown emphasis mangling
- Remove built-in MathJax 2 (mathjax-support) to avoid conflicts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
New appendix note explaining Ceno's local rotation PIOP — the round-to-round
hand-off PIOP built on HyperPlonk's quadratic generator. Covers the
motivation and naive-unroll cost baseline, the formal zero-constraint, a
squaring example with an SVG of the g-orbit under p_2, the generator
construction on B_m, the linearization trick making f ∘ g multilinear, and
the selector-gated zerocheck reducing to three openings per witness.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
- Add Segmentation section covering control-flow continuity and
  cross-shard memory consistency via EC-based homomorphic multiset
  digest (hash-to-curve over F_{q^7}, shard RAM chip, per-shard
  EC-sum Quark PIOP, verifier-side EC sum). Credit SP1 for the
  design.
- Rewrite Multi-chip Architecture reconciliation to make clear
  the grand-product and LogUp PIOPs run per-chip; global step is
  a small verifier-side check. Motivate the split by prover peak
  memory.
- Add shard RAM chip to multi-chip diagram with Σ_shard output;
  add new segmentation diagram.
- Number top-level sections; number appendix sub-pages.
- Rename "GKR Protocol for Tower Tree" → "GKR Protocol for Grand
  Product" across SUMMARY and appendix table.
- Add empty Prover Workflow page under Technical Overview.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator

@hero78119 hero78119 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 🔥 🔥 🔥

@kunxian-xia kunxian-xia added this pull request to the merge queue Apr 20, 2026
Merged via the queue into master with commit 4b61fec Apr 20, 2026
6 checks passed
@kunxian-xia kunxian-xia deleted the docs/how_it_works branch April 20, 2026 13:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: technical details (how it works)

2 participants