Skip to content

Import Tezos X doc - #436

Merged
skenaja merged 70 commits into
mainfrom
import-tx-doc
Aug 19, 2026
Merged

Import Tezos X doc#436
skenaja merged 70 commits into
mainfrom
import-tx-doc

Conversation

@NicNomadic

@NicNomadic NicNomadic commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

NB: Don't merge before the upgrade is successfully voted, that is, don't merge before the Cooldown period!

Imports the doc prepared in the Tezos X repo into the current repo to keep the exact same old Etherlink style.

To see a detailed history reflecting how the imported content was developed, see the origin MR in the TX repo: https://gitlab.com/tezos/xdocs/-/merge_requests/20

@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs-etherlink Ready Ready Preview Aug 19, 2026 2:44pm

Request Review

Comment thread docs/overview/index.md Outdated
Comment thread docs/overview/index.md Outdated
Comment thread docs/overview/index.md Outdated
Comment thread docs/overview/index.md Outdated
Comment thread docs/overview/index.md
Comment thread docs/evm/get-started/network-information.mdx Outdated
Comment thread docs/overview/get-started.md Outdated
Comment thread docs/overview/accounts-and-aliases.md Outdated
Comment thread docs/overview/accounts-and-aliases.md Outdated
Comment thread docs/overview/accounts-and-aliases.md Outdated
Comment thread docs/overview/architecture.md
This was referenced Aug 13, 2026
@NicNomadic

NicNomadic commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator Author

in response to #436 (comment), part:

The legacy pages weren't reconciled with the new narrative. (Partially done: [...]. Still open ☐: "Etherlink EVM" remains in 41 inherited files next to new pages saying "the EVM interface" — fine as a tracked follow-up sweep.)

Tracked as issue #445

@NicNomadic

Copy link
Copy Markdown
Collaborator Author

Conventions: icon array replaced by a label→icon map (done ✅); still open ☐: filesystem vs sidebar alignment between the two interface sections, a single title/H1 rule, a one-page style guide so the next import doesn't diverge again

Tracked as issue #446

@NicNomadic

Copy link
Copy Markdown
Collaborator Author

Standard L2 pages readers will look for eventually: consolidated Security/Audits, bug bounty, unified contract addresses.

Tracked as issue #447

Comment thread docs/progress/upgrades.md Outdated

## Etherlink 7.0 (Ganesha)

The Etherlink 7.0 upgrade went live on 13 August 2026 through the slow kernel governance process and introduced a series of new features preparing for the launch of Tezos X.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Adjust this line with the definitive date and upgrade type

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.

Adjusted in #450 (second commit, targeting this branch). What actually happened, verified on-chain and on Agora:

  • the slow-governance proposal of 2 August was withdrawn before activation after a security vulnerability was found during continued testing (Mainnet was never exposed);
  • a patched kernel was resubmitted via fast governance on Wednesday 19 August (Agora post); proposal and promotion periods both conclude the same day;
  • the trigger is planned for Thursday 20 August, so the section now reads "went live on 20 August 2026 through the fast kernel governance process", with a short paragraph giving the resubmission context.

Also fixed "Native Atomic Calls" → "Native Atomic Composability (NAC)" for consistency with the rest of the docs.

⚠️ Before merging on Thursday: confirm the trigger_kernel_upgrade actually happened (fast governance contract KT19oUVQPnVLuUBYXrBVd46WJnNAMpqkKSwo) and adjust the date if it slips.

- Michelson runtime exposes the Tezos RPC, not JSON-RPC (matches the
  interface table above)
- L1 node: Etherlink is the Smart Rollup, L1 hosts it; anchor the whole
  chain to L1 with a single edge instead of per-runtime edges
- sequence diagram note: the atomicity unit is the transaction, not the
  block
- comparison table: native tez is not wrapped by the L1<->L2 bridge;
  withdrawal latency is days, not hours
- cosmetic: stray colons/spacing in mermaid labels, 'a unified execution
  layer', 'economic space'

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
saroupille and others added 2 commits August 19, 2026 11:35
The 13-August/slow-governance line was a placeholder. What actually
happened: the slow-governance proposal of 2 August was withdrawn before
activation after a security vulnerability was found during continued
testing (Mainnet was never exposed), and a patched kernel was
resubmitted via fast governance on 19 August, with the upgrade
triggered on 20 August.

Also: 'Native Atomic Calls' -> 'Native Atomic Composability (NAC)'
(terminology used everywhere else in the docs), and a link to the
resubmission Agora post.

Note: the 20 August date assumes the trigger happens as planned on
Thursday morning; re-verify against the actual trigger_kernel_upgrade
operation before merging.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- accounts-and-aliases: 'the the' typo
- fees: quantify the EIP-7702 DA-fee term (125 bytes per authorization,
  matching fees.rs)
- terminology: 'Native Atomic Calls' -> 'Native Atomic Composability
  (NAC)' (bridging.md, network-information.mdx, testnet.mdx)
- testnet.mdx: Previewnet is long-running, not a 'temporary testnet'
  (same fix previewnet.md already received)

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

saroupille commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Merge-readiness recap — updated after write access was granted (cc @skenaja @lthms)

Current state:

  • All fixes are on this branch: Review fixes for the Bridging vs. NAC section (architecture.md) #450's three commits were merged by @lthms, and the fourth (41e4711, Michelson network information: chain ids NetXohUVN5QWR4f/NetXtLrzvQDobza, /tezlink self-hosting prefix, bridge/faucet/indexer) was pushed directly afterwards.
  • 15 of 16 review threads are resolved (all verified against the branch). The one deliberately open thread (progress/upgrades.md) is the Thursday reminder: confirm the trigger_kernel_upgrade happened (fast governance contract KT19oUVQPnVLuUBYXrBVd46WJnNAMpqkKSwo) and adjust the went-live date if it slipped from 20 August — then resolve it.
  • The PR has an approval; the remaining blocker is the stale CHANGES_REQUESTED state from @skenaja's 6-August reviews (all their threads are resolved) — please re-review or dismiss so the PR shows green.

Then merge, and the Vercel preview / production build will carry the full Etherlink 7 doc set.

🤖 Posted with Claude Code on behalf of @saroupille

Network information (Michelson):
- network identifiers: NetXohUVN5QWR4f (Mainnet), NetXtLrzvQDobza
  (Shadownet). Derived per the kernel's derive_michelson_chain_id
  (blake2b-256 of the 32-byte little-endian EVM chain id, first 4
  bytes, base58check); the derivation is validated end-to-end against
  Previewnet (128064 -> NetXY2oPPzkxUW1, matching the live node).
  Confirm with curl <endpoint>/chains/main/chain_id once the public
  endpoints are up.
- self-hosted endpoint path is /tezlink today (verified live on
  Previewnet; /michelson 404s) - noted as a legacy prefix that may be
  renamed.
- indexer: not yet available (no public Michelson indexer today).
- faucet (Shadownet): not yet available; EVM faucet as interim.
- bridge: native tez only; FA tokens stay on the EVM interface by
  design and are used from Michelson via NAC.
- admonition updated: endpoints are decided (option 2 of the infra
  discussion: Michelson-only public RPCs) and being rolled out.

Bridging page: document the design - no FA bridging to the Michelson
interface to avoid two wrapped versions of the same token; the EVM
bridge remains the canonical representation, used via NAC.

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

@francoisthire francoisthire left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Approving: the 4-August review campaign is fully closed — all 14 fix commits verified against the current branch state, the two follow-up threads (NAC diagram section, Etherlink 7.0 date/history) are fixed on the branch (#450 + direct push of 41e4711 for the Michelson network information), and 15/16 threads are resolved.

The one deliberately open thread (progress/upgrades.md) is the Thursday checklist item: confirm the trigger_kernel_upgrade happened before merging, and adjust the went-live date if it slipped from 20 August.

@skenaja — all threads from your 6-August reviews are resolved; the stale CHANGES_REQUESTED state is yours to lift (re-review or dismiss) so the PR shows green for Thursday.

🤖 Review researched with Claude Code on behalf of @saroupille

With the default HTML labels, mermaid sizes node boxes from an
off-screen measurement that comes out ~10% narrower than the final DOM
layout on this site, so every node label was clipped ('Etherlink cha',
'Michelson runtin', ...). The previous diagram source worked around it
with trailing '<br/><br/>' and ' :' padding in every label.

Fix at the root: htmlLabels: false (needed both at the top level and
under flowchart - mermaid 11 reads both), plus fontFamily aligned with
the site's Roboto. Labels become native SVG text that mermaid measures
on the real rendered element, so boxes always fit. Verified locally on
both architecture.md diagrams (the only mermaid usage in the docs).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
saroupille and others added 4 commits August 19, 2026 14:47
Verified against live data (2026-08-19):
- Etherlink ~500ms/50ms preconf and ~6s L1 settlement (Ushuaia 6s
  blocks): up to date, unchanged.
- Optimism ~2s (measured 2.000s over 100 blocks) and ~2min batches
  (batcher measured ~2.5min): unchanged, but the block-time link
  pointed at community.optimism.io which now 301-redirects to an
  unrelated governance page - replaced with optimistic.etherscan.io,
  symmetric with the Arbitrum link.
- Arbitrum ~300ms (measured 0.260s): unchanged; batch cadence is now
  ~3 minutes on arbiscan (was ~7) - updated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The auto-laid-out mermaid flowchart was hard to read (crossing edges,
arbitrary node placement). Replace it with a hand-drawn inline SVG
following the docs' visual language: symmetric three-band layout
(tools -> Etherlink -> Tezos Layer 1), stepped neutral surfaces, mono
uppercase technical labels, and the site green reserved for the NAC
connector alone.

Also materializes the interface notion: each runtime now carries an
outlined 'EVM INTERFACE' / 'MICHELSON INTERFACE' socket bar where the
RPC connectors land, mirroring the Interface/Runtime/RPC table above.

The NAC call-sequence mermaid diagram below is unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
All surfaces, outlines, ink opacities and connectors raised one step -
the diagram sat too dark against the page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Readability rework:
- two color-coded lanes: Etherlink green for the EVM/Ethereum side,
  Tezos blue for the Michelson/Tezos side (top rules, kickers, RPC
  connectors, interface labels) - the eye follows each column and sees
  them meet in the middle
- NAC junction as a solid near-white pill with dark ink (the design
  system's primary-emphasis language): the most contrasted element sits
  on the diagram's message
- interfaces integrated as runtime-card headers (colored label +
  separator) instead of floating outlined bars
- viewBox tightened 760 -> 680 so text renders ~20% larger in the
  content column, type sizes raised across the board

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
add custom Docusaurus plugin generating llms(-full).txt
@saroupille

Copy link
Copy Markdown
Contributor

Heads-up: merging #443 brought this whole branch to main (its branch was based on import-tx-doc), so the Etherlink 7 docs shipped to production today — a day ahead of the planned Thursday merge. Two consequences, both handled in #451: the six diagram commits pushed to this branch after #443 was cut didn't make it to main, and progress/upgrades.md currently tells production that 7.0 "went live on 20 August" while the promotion vote is still running. #451 cherry-picks the diagrams and rewords the date to expected tense — please merge it today, and flip the wording back to past tense once trigger_kernel_upgrade executes tomorrow. @skenaja

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.

5 participants