Skip to content

Commit fa4d2c7

Browse files
authored
feat: mention atlas and other components (#449)
# Description Rewrites ZKsync OS dev preview testnet page to mention all Atlas components. ## Linked Issues N/A ## Additional context Mention Atlas
1 parent cfc0a75 commit fa4d2c7

File tree

6 files changed

+106
-66
lines changed

6 files changed

+106
-66
lines changed

components/ZksyncEraNetworkDetails.vue

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,7 @@ const testnetDetails: NetworkDetail[] = [
156156
];
157157
158158
const zksyncOSTestnetDetails: NetworkDetail[] = [
159-
{ property: 'Network Name', value: 'ZKsync OS Devnet', isCode: true },
159+
{ property: 'Network Name', value: 'ZKsync OS Developer Preview', isCode: true },
160160
{ property: 'RPC URL', value: 'https://zksync-os-testnet-alpha.zksync.dev/', isCopyable: true },
161161
{ property: 'WebSocket URL', value: 'wss://zksync-os-testnet-alpha.zksync.dev/ws', isCopyable: true },
162162
{ property: 'Chain ID', value: '8022833', isCode: true },
Lines changed: 87 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,113 @@
11
---
22
title: Overview
3-
description: Get started learning about ZKsync OS.
3+
description: Learn about the ZKsync OS Developer Preview testnet and its architecture.
44
---
55

6-
ZKsync OS is the modular execution layer of the ZKsync stack. It defines the system-level state transition function of a chain
7-
and supports multiple execution environments (VMs).
6+
The **ZKsync OS Developer Preview** testnet is a new environment that runs on the latest architecture introduced in the [**Atlas upgrade**](https://zksync.mirror.xyz/XrlYJN9SUbOtRn9nyqrfPyaAqot--PlUcnSRK_OF1Bs).
7+
It includes all major components released in that upgrade — **ZKsync OS**, the **new Sequencer**, and the **Airbender prover** — giving developers
8+
early access to the full next-generation ZK Stack.
89

9-
Unlike earlier implementations, ZKsync OS separates execution from proving,
10-
making both layers independently upgradable and easier to optimize. This design improves performance, ensures EVM equivalence, and enables
11-
new execution environments to be added for application-specific use cases.
10+
This testnet allows builders to deploy contracts, profile system performance, and explore how the ZK Stack has
11+
evolved across execution, sequencing, and proving.
1212

13-
## Architecture
14-
15-
The core of the protocol is built around a two-layer architecture:
13+
---
1614

17-
- a modular execution layer,
18-
- and the proving layer.
15+
## Overview
1916

20-
The execution layer defines the logic of execution, memory handling, and IO. It takes block data and an initial state as input
21-
and computes the new state after the block is applied. The proving layer then generates validity proofs of this state transition.
17+
**ZKsync OS** is the new operating system of the ZK Stack.
18+
It defines the system-level state transition function of a chain and supports multiple **Execution Environments (EEs)**.
2219

23-
ZKsync OS is implemented in Rust and compiled to two targets. The **x86 target** is used by the sequencer to run execution directly,
24-
while the **RISC-V target** is provided to the ZKsync Airbender prover to generate proofs of correctness. This ensures consistency between
25-
the sequencer’s runtime behavior and the proof system, while keeping execution and proving cleanly separated.
20+
Unlike earlier implementations, ZKsync OS unifies **execution and proving logic** in one codebase and compiles it to two targets — **x86** for
21+
the sequencer runtime and **RISC-V** for the Airbender proving system.
2622

27-
By isolating these layers, ZKsync OS makes it possible to evolve execution logic independently from the prover.
28-
This separation also shifts focus to the execution layer, an area often neglected in rollup design. While many efforts
29-
in the ecosystem concentrate on prover efficiency, ZKsync OS demonstrates that significant performance gains can also be
30-
achieved by optimizing how execution itself is structured.
23+
The Developer Preview testnet runs **ZKsync OS alongside the new Sequencer and Airbender prover**, providing a complete
24+
environment for testing the latest stack.
3125

32-
## Components of ZKsync OS
26+
---
3327

34-
The main components of ZKsync OS are:
28+
## Architecture
3529

36-
1. **[Bootloader](/zksync-protocol/zksyncos/bootloader):** The entry point program. It initializes the system and then runs transactions using two
37-
components: the system and the execution environment interpreters.
30+
The core protocol is organized into two primary layers:
3831

39-
2. **[Execution Environments](/zksync-protocol/zksyncos/execution-environment):** Regular interpreters that take bytecode,
40-
calldata, resources (similar to gas) and some other call context values as its input. Interpreters are instantiated with some local state to execute
41-
a frame. When an interpreter sees a call to another contract, return/revert from current frame, or contract
42-
creation it triggers special functionality to process it, as a potentially different interpreter should be run.
32+
- **Execution layer:** defines transaction logic, memory handling, and IO. It computes new state from the previous block state and inputs.
33+
- **Proving layer:** generates ZK proofs that attest to the correctness of that state transition.
4334

44-
ZKsync OS will initially only support EVM.
45-
In the future, it will include the following EEs:
35+
ZKsync OS is implemented in **Rust** and compiled to two targets:
4636

47-
- **EVM:** Provides full native EVM-equivalence to ZKsync.
48-
- **WASM:** Allows ZKsync to support contracts written in any language that compiles to WASM (e.g. Rust).
49-
- **Native RISC-V:** User-mode RISC V code execution unlocks highest proving performance due to not having any interpretation overhead.
37+
- **x86:** used by the Sequencer to execute transactions
38+
- **RISC-V:** used by the Airbender prover to generate ZK proofs of correctness
5039

51-
<!-- markdownlint-disable -->
52-
3. **[System](/zksync-protocol/zksyncos/system):** Common for all environments and the bootloader. Provides an abstract interface for low level
53-
handling of IO (storage, events, L1 messages, oracles) and memory management. The system communicates with the
54-
external oracle (non-determinism source), which is needed to read block data, and also for some IO operations,
55-
e.g. to perform the initial read for a storage slot.
40+
This “one program, two targets” model ensures *what you execute is what you prove*, eliminating discrepancies between
41+
runtime and proof generation and reducing the audit surface.
42+
Execution and proving operate as **decoupled services** (sequencer vs. prover) while sharing the exact same program and semantics.
5643

5744
::centered-container
5845
![zksyncOS.png](/images/zksyncos-airbender/zksyncOS.png)
5946
::
6047

61-
This modular design enables us to isolate a minimal interface required to implement an Execution Environment.
62-
In addition, the system abstraction makes the storage model customizable and allows for different instances of the entire system.
48+
---
49+
50+
## Components
51+
52+
### ZKsync OS
53+
54+
The core of the system.
55+
ZKsync OS provides a modular execution framework that supports multiple execution environments and defines the rules for state transitions.
56+
57+
- **[Bootloader](/zksync-protocol/zksyncos/bootloader):** initializes the system and coordinates transaction execution.
58+
- **[Execution Environments](/zksync-protocol/zksyncos/execution-environment):** interpreters that run user contracts and system logic.
59+
- **[System Layer](/zksync-protocol/zksyncos/system):** handles low-level IO (storage, events, L1 messages) and manages memory.
60+
61+
The Developer Preview currently supports a **fully EVM-equivalent environment**, allowing developers to use
62+
existing EVM tools (e.g. Foundry, Hardhat, solc) and deploy contracts without modification.
63+
Future versions may include **EraVM**, **WASM** and **native RISC-V** environments.
64+
65+
Learn [more about ZKsync OS in the protocol documentation](../../zksync-protocol/zksyncos/overview).
66+
67+
---
68+
69+
### Sequencer
70+
71+
The new **Sequencer**, introduced as part of the [Atlas upgrade](https://zksync.mirror.xyz/XrlYJN9SUbOtRn9nyqrfPyaAqot--PlUcnSRK_OF1Bs), is designed for:
72+
73+
- **High throughput** — sustained >15K TPS in ERC-20 transfer benchmarks
74+
- **Low latency** — sub-second inclusion, typically 250–500 ms
75+
- **Modularity** — clear separation of execution, API, and proving layers
76+
77+
It offloads batching and L1 coordination to asynchronous services, simplifying the execution pipeline and improving resilience.
78+
For developers, this means faster transaction processing and easier scaling for custom ZK Stack chains.
79+
80+
---
81+
82+
### Airbender Prover
83+
84+
**Airbender** is the proving system used in the Developer Preview testnet.
85+
It is a general-purpose, open-source RISC-V zkVM integrated directly with ZKsync OS.
86+
87+
Key properties:
88+
89+
- **Efficient hardware utilization** — can run on a single GPU.
90+
- **Low cost** — proving an ERC-20 transfer costs roughly $0.0001.
91+
- **Fast proofs** — Airbender can be scaled horizontally to generate ~1 second block proofs and **minutes-to-Ethereum finality**.
92+
93+
Because both execution and proving compile from the same Rust source, Airbender proves the exact code path executed by ZKsync OS.
94+
This reduces audit complexity and guarantees consistency between runtime and proofs.
95+
96+
Learn [more about Airbender in the protocol documentation](../../zksync-protocol/zksync-airbender/overview).
97+
98+
---
99+
100+
## Developer Preview Testnet
63101

64-
## System Design Goals
102+
The Developer Preview testnet includes:
65103

66-
The design of ZKsync OS focuses on delivering high throughput and low cost.
67-
The Rust implementation enables low-level optimizations for memory access,
68-
IO, and execution paths, ensuring that performance can scale in line with network demands.
104+
- **ZKsync OS** — modular execution layer with full EVM equivalence.
105+
- **New Sequencer** — redesigned high-performance execution engine.
106+
- **Airbender** — integrated real-time RISC-V prover.
69107

70-
ZKsync OS serves as the foundation of the Elastic Network. For builders, it offers full EVM equivalence and tooling,
71-
while also unlocking new programming models through WASM and RISC-V.
108+
Developers can use this testnet to:
72109

73-
For users, ZKsync OS provides a consistent experience across chains, with security underpinned by ZK proofs.
74-
And for the broader ecosystem, its modular design allows for application-specific specialization without fragmentation,
75-
while maintaining interoperability across all ZKsync Stack chains.
110+
- Deploy and test contracts using familiar EVM tooling
111+
- Benchmark transaction throughput and latency
112+
- Integration test for infrastructure tools
113+
- Evaluate how the new architecture supports specific workloads

content/00.zksync-network/65.zksync-os/05.network-details.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,41 @@
11
---
2-
title: ZKsync OS Network
3-
description: Get connected to ZKsync OS Devnet
2+
title: Network Details
3+
description: Connect to ZKsync OS Developer Preview testnet
44
---
55

6-
## Add ZKsync OS Devnet to your MetaMask wallet
6+
## Add ZKsync OS Developer Preview to your MetaMask wallet
77

8-
You can add ZKsync OS Devnet to your MetaMask wallet using the buttons below:
8+
You can add ZKsync OS Developer Preview to your MetaMask wallet using the buttons below:
99

1010
<!-- // cspell: disable -->
1111
:network-adder{ network="ostestnet" }
1212
<!-- // cspell: enable -->
1313

1414
If you are using a different in-browser wallet, the buttons above may also work for them.
1515

16-
## Manually add ZKsync OS Devnet
16+
## Manually add ZKsync OS Developer Preview
1717

18-
To manually add ZKsync OS Devnet as a custom network in your wallet, follow these steps:
18+
To manually add ZKsync OS Developer Preview as a custom network in your wallet, follow these steps:
1919

2020
1. Find the “Add Network” option in your wallet (in MetaMask, you can find this in the networks dropdown).
2121
1. Click on “Add Network" and "Add network manually".
22-
1. Fill in the following details for the ZKsync OS Devnet environment:
22+
1. Fill in the following details for the ZKsync OS Developer Preview testnet:
2323

2424
### Network details
2525

2626
<!-- // cspell: disable -->
2727
:zksync-era-network-details{showzksyncos}
2828
<!-- // cspell: enable -->
2929

30-
## Get devnet funds for your wallet
30+
## Get funds for your wallet
3131

32-
Once you have your wallet connected to the ZKsync OS Devnet environment,
33-
you can bridge testnet ETH from Sepolia Testnet to ZKsync OS Devnet.
32+
Once you have your wallet connected to the ZKsync OS Developer Preview environment,
33+
you can bridge testnet ETH from Sepolia Testnet.
3434
You can get testnet funds from one of many [testnet faucets](/zksync-network/ecosystem/network-faucets#sepolia-faucets).
3535

3636
### Bridging testnet ETH
3737

38-
You can use the [ZKsync OS Portal](https://zksync-os.portal.zksync.io/) to bridge testnet ETH over to the devnet.
38+
You can use the [ZKsync OS Portal](https://zksync-os.portal.zksync.io/) to bridge testnet ETH over.
3939
You can also use `cast` or `zksync-sdk` as shown in the examples below.
4040

4141
#### Bridging with `cast`
@@ -45,7 +45,7 @@ You can also use `cast` or `zksync-sdk` as shown in the examples below.
4545
export BRIDGEHUB_ADDRESS=0xc4fd2580c3487bba18d63f50301020132342fdbd
4646
export CHAIN_ID=8022833
4747
export SEPOLIA_RPC=<YOUR_SEPOLIA_RPC_ENDPOINT>
48-
export ZKOS_DEVNET_RPC=https://zksync-os-testnet-alpha.zksync.dev/
48+
export ZKOS_RPC=https://zksync-os-testnet-alpha.zksync.dev/
4949
export ADDRESS=<YOUR_WALLET_ADDRESS>
5050
export VALUE_TO_BRIDGE=<AMOUNT_TO_BRIDGE_IN_WEI>
5151
```

content/00.zksync-network/65.zksync-os/07.quickstart.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,11 @@
22
title: Developer Quickstart
33
description: Getting starting developing with ZKsync OS
44
---
5-
5+
::callout{icon="i-heroicons-light-bulb"}
66
You can use all standard EVM tooling for ZKsync OS.
7-
You can find instructions for bridging testnet ETH to ZKsync OS devnet in the [Network Details](/zksync-network/zksync-os/network-details) page.
7+
You can find instructions for bridging testnet ETH to ZKsync OS Developer Preview testnet
8+
in the [Network Details](/zksync-network/zksync-os/network-details) page.
9+
::
810

911
To get started with Foundry or Hardhat, follow the steps below:
1012

content/00.zksync-network/65.zksync-os/10.faqs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ However, it may make it easier to move to stages 1 and 2 because improvements to
7171

7272
## Is there a public testnet and mainnet?
7373

74-
A public devnet is live and ready for testing.
74+
A public developer preview testnet is live and ready for testing.
7575
You can find the more information in this section of the docs for the [network details](/zksync-network/zksync-os/network-details)
7676
and [getting started](/zksync-network/zksync-os/quickstart) with development.
7777
Currently there is no public mainnet.

data/chains.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
"onGateway": true
2525
},
2626
{
27-
"name": "ZKsync OS Devnet",
27+
"name": "ZKsync OS Developer Preview",
2828
"chainId": 8022833,
2929
"icon": "https://docs.zksync.io/zksync-icon_150.svg",
3030
"isTestnet": true,

0 commit comments

Comments
 (0)