Skip to content

Commit 2b28b24

Browse files
committed
chore(docs): general refinements based on comments
1 parent 9a84f1d commit 2b28b24

File tree

7 files changed

+63
-145
lines changed

7 files changed

+63
-145
lines changed

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -386,7 +386,7 @@
386386

387387
### Features
388388

389-
* **docs-site:** structure docs and add Gwyneth docs ([#18894](https://github.com/taikoxyz/taiko-mono/issues/18894)) ([8a542cd](https://github.com/taikoxyz/taiko-mono/commit/8a542cdf797ceeeef8c159713885499e0172e363))
389+
* **docs-site:** structure protocol docs ([#18894](https://github.com/taikoxyz/taiko-mono/issues/18894)) ([8a542cd](https://github.com/taikoxyz/taiko-mono/commit/8a542cdf797ceeeef8c159713885499e0172e363))
390390

391391
## [1.23.3](https://github.com/taikoxyz/taiko-mono/compare/docs-site-v1.23.2...docs-site-v1.23.3) (2025-02-18)
392392

docs/pages/protocol/booster-rollups.mdx

Lines changed: 0 additions & 27 deletions
This file was deleted.

docs/pages/protocol/inception-layers.mdx

Lines changed: 0 additions & 57 deletions
This file was deleted.

docs/pages/protocol/overview.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -71,19 +71,13 @@ The Pacaya fork (live since May 2025) introduced several important changes to th
7171
- **ComposeVerifier** orchestrates multi-proof verification
7272
- **ForcedInclusionStore** preserves censorship resistance during the preconfirmation rollout
7373

74-
:::info
75-
**What's next: Gwyneth.** Taiko Gwyneth is the next-generation protocol design, introducing booster rollups and native cross-chain composability. It represents Taiko's long-term vision for Ethereum scaling.
76-
:::
77-
7874
## Further Reading
7975

8076
- [Based Rollups](/protocol/based-rollups) -- how L1-sequenced block ordering works
81-
- [Inception Layers](/protocol/inception-layers) -- how recursive and parallel Taiko rollups fit together
8277
- [Pacaya Fork](/protocol/pacaya-fork) -- the shift to batch-based proposing and multi-proof verification
8378
- [Proving System](/protocol/proving-system) -- multi-proof verification architecture
8479
- [Bridging](/protocol/bridging) -- cross-chain messaging and asset transfers
8580
- [Economics](/protocol/economics) -- fees, bonds, and token utility
8681
- [Preconfirmations](/protocol/preconfirmations) -- faster transaction finality via based preconfirmations
8782
- [Account Abstraction](/protocol/account-abstraction) -- ERC-4337 support on Taiko
8883
- [Node Architecture](/protocol/node-architecture) -- how taiko-geth and taiko-client work together
89-
- [Taiko Gwyneth](/protocol/taiko-gwyneth) -- Taiko's longer-term horizontal scaling design
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Shasta Fork [The protocol changes introduced by Taiko's Shasta upgrade.]
2+
3+
Shasta is the next major protocol step after **Pacaya**. It keeps Pacaya's blob-based, proof-driven architecture, but reworks the protocol around a separate inbox, proposal-based derivation, and explicit L1/L2 routing for checkpoints and anchoring.
4+
5+
## Proposal-Based Derivation
6+
7+
Shasta organizes L2 block construction around **proposals** rather than the older batch terminology.
8+
9+
Under this model:
10+
11+
- proposals are identified by sequential proposal IDs
12+
- proposal data is carried in blob-backed derivation sources
13+
- forced inclusions are processed first and the proposer's source is appended last
14+
15+
This keeps forced inclusion inside the normal proposal pipeline rather than treating it as a side path.
16+
17+
## Sequential Finalization with Checkpoints
18+
19+
Shasta keeps proving on Ethereum L1, but finalization becomes more explicitly checkpoint-driven.
20+
21+
In practice:
22+
23+
- `ShastaInbox` accepts proposals and proofs for contiguous proposal ranges
24+
- successful proving advances finalization in order
25+
- finalization writes a checkpoint into the signal service
26+
27+
This gives the rest of the protocol a fresh L1-backed checkpoint as Shasta proposals finalize.
28+
29+
## L1/L2 Routing and Anchoring
30+
31+
Shasta also changes how L1 state is reflected on L2.
32+
33+
- `Anchor` stores anchored L1 checkpoints on L2 and records metadata used by the preconfirmation flow
34+
- `SignalServiceForkRouter` switches signal-service behavior across the Pacaya/Shasta fork boundary
35+
- the fork routing model lets Pacaya-era and Shasta-era logic coexist cleanly during transition
36+
37+
This is one of the main architectural differences from the simpler Pacaya overview.
38+
39+
## Preconfirmation-Oriented Permissioning
40+
41+
Shasta is built to support the staged preconfirmation rollout.
42+
43+
It introduces:
44+
45+
- proposer authorization through `PreconfWhitelist`
46+
- prover whitelisting with permissionless fallback after delay
47+
- permissionless proposal fallback when forced inclusions stay too old
48+
49+
These controls keep the fast path structured without removing the protocol's escape hatches.
50+
51+
## Key Contract Changes
52+
53+
Shasta introduces or elevates several contracts:
54+
55+
- `ShastaInbox` becomes the Shasta L1 protocol entry point
56+
- `Anchor` becomes the Shasta L2 anchoring contract
57+
- `PreconfWhitelist` controls proposer authorization
58+
- `ProverWhitelist` controls early proving access
59+
- `SignalServiceForkRouter` handles cross-fork signal-service routing
60+
61+
See [Preconfirmations](/protocol/preconfirmations), [Proving System](/protocol/proving-system), and [Contract Addresses](/network/contract-addresses) for related details.

docs/pages/protocol/taiko-gwyneth.mdx

Lines changed: 0 additions & 51 deletions
This file was deleted.

vocs.config.ts

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -71,16 +71,14 @@ export default defineConfig({
7171
items: [
7272
{ text: 'Overview', link: '/protocol/overview' },
7373
{ text: 'Based Rollups', link: '/protocol/based-rollups' },
74-
{ text: 'Inception Layers', link: '/protocol/inception-layers' },
7574
{ text: 'Pacaya Fork', link: '/protocol/pacaya-fork' },
75+
{ text: 'Shasta Fork', link: '/protocol/shasta-fork' },
7676
{ text: 'Proving System', link: '/protocol/proving-system' },
7777
{ text: 'Bridging', link: '/protocol/bridging' },
7878
{ text: 'Economics', link: '/protocol/economics' },
7979
{ text: 'Preconfirmations', link: '/protocol/preconfirmations' },
8080
{ text: 'Account Abstraction', link: '/protocol/account-abstraction' },
8181
{ text: 'Node Architecture', link: '/protocol/node-architecture' },
82-
{ text: 'Taiko Gwyneth', link: '/protocol/taiko-gwyneth' },
83-
{ text: 'Booster Rollups', link: '/protocol/booster-rollups' },
8482
],
8583
},
8684
{

0 commit comments

Comments
 (0)