Skip to content

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

Open
alexander-sei wants to merge 1 commit into
mainfrom
docs/giga-whitepaper-v2-rework
Open

docs(giga): rework Sei Giga pages for whitepaper v2.0#42
alexander-sei wants to merge 1 commit 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 auth impact; risk is mainly editorial accuracy and keeping operator config examples in sync with sei-chain releases.

Overview
This PR replaces the prior high-level / “current vs upcoming” Giga docs with whitepaper v2.0–aligned content: an answer-first overview (learn/sei-giga), a full protocol spec (learn/sei-giga-specs), and a builder-focused delta guide (learn/sei-giga-developers) covering dual finality, no mempool, three-part fees, BUD proofs, MEV/merge rules, roadmap status, and a sei-chain v6.6 implementation snapshot.

It adds snippets/giga-diagrams.jsx with 14 theme-aware inline SVG diagrams wired into those pages (consensus lanes, async pipeline, tx journey, OCC, storage/BUD, fees, etc.).

Smaller corrections: home/Learn teasers and brand copy use gigagas / multi-concurrent proposer (MCP) wording; scripts/generate-llms.mjs matches; node/node-operators.mdx drops the incorrect evmone executor description, removes obsolete evm-ss-write-mode / evm-ss-read-mode examples in favor of evm-ss-split, and documents [giga_executor] defaults (off through v6.5.x, on with OCC from v6.6).

Reviewed by Cursor Bugbot for commit e3ec145. 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.

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