Skip to content

docs(giga): rework Sei Giga pages for whitepaper v2.0#42

Open
alexander-sei wants to merge 2 commits into
mainfrom
docs/giga-whitepaper-v2-rework
Open

docs(giga): rework Sei Giga pages for whitepaper v2.0#42
alexander-sei wants to merge 2 commits into
mainfrom
docs/giga-whitepaper-v2-rework

Conversation

@alexander-sei

Copy link
Copy Markdown
Collaborator

Summary

Full rework of the Sei Giga documentation.

Pages rewritten

  • learn/sei-giga: answer-first overview — architecture in four stages, transaction lifecycle, MEV and fee design, the 11-milestone roadmap with statuses, dated performance table
  • learn/sei-giga-specs: complete protocol spec — Autobahn (lanes, f+1 Proofs of Availability, cut-of-tips ordering, 1.5 round trips), the two finality notions, Block-STM OCC, flat storage with LtHash divergence digests, BUD/SuperBUD proofs, Sedna, merge rule and socialised tips, post-quantum path, implementation snapshot, glossary, references
  • learn/sei-giga-developers: what changes for builders — which finality signal per use case, mempool-free submission, three-part fees, parallel-friendly contract patterns, precompile fast-path caveat, prepare-today checklist

New diagrams

  • snippets/giga-diagrams.jsx: 14 theme-aware inline SVG components (proposer comparison, async pipeline, transaction journey, roadmap track, lanes and cuts, slot pipelining, attestation flow, OCC, storage stack, BUD windows, merge rule, finality signals, fee split, parallelism contrast), each with a caption and aria-label

Corrections elsewhere

  • node/node-operators.mdx: removed the incorrect "evmone-based executor" description (the engine is Sei's go-ethereum fork; evmone is optional and unused in production), removed the stale Giga Storage app.toml example whose evm-ss-write-mode/evm-ss-read-mode keys no longer exist (superseded by evm-ss-split), and version-scoped the [giga_executor] defaults (false through v6.5.x; true with OCC from the v6.6 release line)
  • Home and Learn teasers updated to current numbers; brand kit and llms generator config aligned on multi-concurrent proposer (MCP) terminology

Verification

  • mint broken-links passes; every in-page anchor verified
  • All 14 diagrams render in light and dark themes (browser-verified), scroll horizontally on mobile, and produce no console errors

Post-merge note: trigger the regenerate-llms.yml workflow so llms.txt/llms-full.txt pick up the new pages.

🤖 Generated with Claude Code

- Rewrite learn/sei-giga, sei-giga-specs, and sei-giga-developers from
  primary sources: Giga whitepaper v2.0 (arXiv 2505.14914v3), the
  giga.seilabs.io roadmap, and the sei-chain v6.6 release line
- Add snippets/giga-diagrams.jsx with 14 theme-aware SVG diagrams
- Correct stale Giga executor/storage claims in node/node-operators.mdx
  (evmone wording, dead evm-ss-* keys, version-scoped defaults)
- Update Giga teasers on the home and Learn landing pages, align MCP
  terminology in the brand kit and llms.txt generator config

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@cursor

cursor Bot commented Jul 11, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Documentation-only changes with no runtime or contract impact; operator config edits clarify accurate sei-chain defaults and migration keys.

Overview
This PR reworks Sei Giga documentation around whitepaper v2.0 and July 2026 / sei-chain v6.6 implementation notes, framing Giga as in-place upgrades to live Sei (Multi-Proposer EVM L1) rather than a separate chain.

learn/sei-giga, learn/sei-giga-specs, and learn/sei-giga-developers are largely rewritten: answer-first overview (roadmap, tx lifecycle, MEV/fees, dated performance), full protocol spec (Autobahn lanes/PoA/cuts, two finality notions, Block-STM, LtHash/BUDs, Sedna, merge rule, glossary), and a builder-focused guide (what stays the same vs five EVM exceptions, finality/mempool/fees/proofs, parallel contract patterns, precompile fast-path caveat).

New snippets/giga-diagrams.jsx adds 14 theme-aware inline SVG components wired into those pages.

Corrections elsewhere: node/node-operators.mdx drops the incorrect evmone executor story, replaces stale evm-ss-write-mode/read-mode with evm-ss-split, and documents [giga_executor] defaults (off through v6.5.x; on with OCC from v6.6). Home/Learn teasers, brand kit, and scripts/generate-llms.mjs align on Multi-Proposer / gigagas wording.

Reviewed by Cursor Bugbot for commit 22d7e43. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
sei-docs 🟢 Ready View Preview Jul 11, 2026, 7:14 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Edit documentation and snippets to adopt future-oriented wording for Sei Giga and unify terminology. Replaces present-tense claims with conditional/future phrasing (use of “will”), renames “Multi-concurrent proposer” to “Multi-Proposer” across pages and diagrams, clarifies Sedna as a private dissemination layer (no traditional public mempool), and tweaks related copy, keywords, and alt text. Also updates the LLMS generator intro and several snippet captions/ARIA labels to match the new phrasing. These are editorial/content updates only.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

A large, well-structured documentation rework of the Sei Giga pages plus 14 new theme-aware inline SVG diagram components; internal links/anchors, referenced pages, CSS variables, and the snippet import convention all check out, and cross-doc config keys are consistent. No blocking issues found; a few non-blocking verification and polish notes remain.

Findings: 0 blocking | 6 non-blocking | 0 posted inline

Blockers

  • None at the file/PR level.

Non-blocking

  • Review-tooling note: REVIEW_GUIDELINES.md is empty (no repo-specific standards to apply), and both codex-review.md and cursor-review.md are empty — the Codex and Cursor passes produced no output, so this synthesis reflects only my own review.
  • External references are unverified: several cited arXiv IDs are future-dated (Sedna 2512.17045, PIVOT-K 2603.17614, Ambulance 2606.25099). mint broken-links typically validates internal links only, so please confirm every external URL (arXiv, blog.sei.io, seiresearch.io, giga.seilabs.io) resolves and points to the intended paper before publishing.
  • In learn/sei-giga.mdx the roadmap table links both the "Giga whitepaper v1" and "Giga whitepaper v2" rows to the same arXiv abstract (2505.14914); a reader clicking v1 lands on v2. Consider linking /abs/2505.14914v1 for the v1 row (or dropping that link) to avoid confusion.
  • snippets/giga-diagrams.jsx GigaMergeRule: the dup: true field on V1's tx e is defined but never used — the dedup result is hardcoded in the executable-sequence array. Harmless dead data; either drive the strikethrough from it or drop the field.
  • Brand consistency check: the 14 diagrams use --sei-maroon-50 as a recurring accent throughout. The brand kit (updated in this same PR) restricts maroon/gold to emphasis/legacy use. The usage here reads as emphasis so it's likely fine, but worth a quick design review to confirm it aligns with the stated palette guidance.
  • Consider a follow-up to run the regenerate-llms workflow post-merge (already called out in the PR description) so llms.txt/llms-full.txt pick up the reworked pages.

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.

1 participant