Skip to content

Commit e86de73

Browse files
authored
feat: era section in docs (#468)
# Description - Creates new ZKsync Era section - Cleans up SDKs pages - Moves Ecosystem inside ZKsync Era section (includes redirects) ## Linked Issues General re org ## Additional context
1 parent 4b30c79 commit e86de73

73 files changed

Lines changed: 457 additions & 682 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

content/00.zksync-network/00.index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ ZKsync chains are built to provide a similar developer experience as Ethereum.
6363

6464
:check-icon Smart contracts can be written in Solidity or Vyper.
6565

66-
:check-icon Use standard `solc` and `vyper` compilers for EVM bytecode execution via [the EVM Interpreter](../zksync-network/unique-features/evm-interpreter/evm-interpreter).
66+
:check-icon Use standard `solc` and `vyper` compilers for EVM bytecode execution via [the EVM Interpreter](/zksync-network/zksync-era/unique-features).
6767

6868
:check-icon Use custom compilers **[zksolc and
6969
zkvyper](/zksync-protocol/era-vm/compiler/toolchain)** to compile contracts to native EraVM bytecode for more efficient execution.
@@ -94,5 +94,5 @@ On **ZKsync chains**:
9494
- Support for existing Ethereum-based wallets like Metamask, TrustWallet, Zerion, Rabby, etc.
9595

9696
::callout{icon="i-heroicons-cube-transparent-solid" color="blue"}
97-
To add ZKsync Era to your wallet, see [Connect to ZKsync Era](/zksync-network/environment/zksync-era).
97+
To add ZKsync Era to your wallet, see [Connect to ZKsync Era](/zksync-network/zksync-era/network-details).
9898
::

content/00.zksync-network/10.guides/10.quick-start/1.index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ to help you learn as quickly and efficiently as possible.
1515

1616
## Get started
1717

18-
- If you haven't already added ZKsync Era to your wallet, follow the instructions in [Connect ZKsync Era to your wallet](/zksync-network/environment/zksync-era).
18+
- If you haven't already added ZKsync Era to your wallet, follow the instructions in [Connect ZKsync Era to your wallet](/zksync-network/zksync-era/network-details).
1919
- Continue to [Deploy your first contract](/zksync-network/guides/quick-start/deploy-your-first-contract)
2020
to learn how to use Remix to deploy a contract onto ZKsync Era.
2121
- If you are familiar with ZKsync Era and want to develop using `zksync-cli` locally

content/00.zksync-network/10.guides/10.quick-start/3.deploy-your-first-contract.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ By default, this guide uses ZKsync Era, but you can run it on any chain in the Z
2222

2323
1. Before you start, make sure that
2424
[you’ve configured the %%zk_testnet_name%% in your wallet](/zksync-network/environment).
25-
2. Have at least 0.05 %%zk_testnet_name%% ETH. If you need more, use [one of the faucets](/zksync-network/ecosystem/network-faucets).
25+
2. Have at least 0.05 %%zk_testnet_name%% ETH. If you need more, use [one of the faucets](/zksync-network/zksync-era/ecosystem/network-faucets).
2626

2727
## Review the smart contract code
2828

content/00.zksync-network/10.guides/10.quick-start/4.erc20-token.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@ By default, this guide uses ZKsync Era, but you can run it on any chain in the Z
1818
## Prerequisites
1919

2020
1. Before you start, make sure that
21-
[you’ve configured the %%zk_testnet_name%% in your wallet](/zksync-network/environment/zksync-era).
22-
2. Have at least 0.05 %%zk_testnet_name%% ETH. If you need more, use [one of the faucets](/zksync-network/ecosystem/network-faucets).
21+
[you’ve configured the %%zk_testnet_name%% in your wallet](/zksync-network/zksync-era/network-details).
22+
2. Have at least 0.05 %%zk_testnet_name%% ETH. If you need more, use [one of the faucets](/zksync-network/zksync-era/ecosystem/network-faucets).
2323

2424
## Custom ERC20 token code
2525

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: "About ZKsync Era"
3+
description: "Understand the role of ZKsync Era within the ZKsync ecosystem, its architecture, and developer experience."
4+
---
5+
6+
ZKsync Era is a Layer 2 rollup built with the **ZK Stack**, designed to scale Ethereum using zero-knowledge proofs while preserving its security.
7+
It was the first chain launched with the ZK Stack and the first member of the **Elastic Network**, which now includes [over 15 interconnected ZK chains](/zksync-network/environment).
8+
9+
## Architecture
10+
11+
ZKsync Era operates as a **zero-knowledge rollup (ZK rollup)**. It executes transactions off-chain, aggregates them into batches, and generates
12+
a succinct **zero-knowledge validity proof** to verify all state changes. This proof is then submitted to Ethereum, ensuring
13+
correctness and finality while reducing gas costs.
14+
15+
Era uses the **EraVM**, a high-performance virtual machine that is compatible with the Ethereum Virtual Machine (EVM).
16+
Developers can deploy existing Solidity or Vyper contracts on Era with minimal or no changes.
17+
18+
### Core Components
19+
20+
- **Sequencer** — Orders and executes transactions off-chain to produce state updates.
21+
- **Prover** — ZKsync Era uses the Boojum prover. It generates validity proofs for batches of transactions.
22+
- **Verifier** — A smart contract on Ethereum that verifies proofs and finalizes state transitions.
23+
- **EraVM** — Executes smart contracts bytecode with additional optimizations for ZK proof generation.
24+
25+
## Position in the Ecosystem
26+
27+
ZKsync Era forms the foundation of the **Elastic Network**, a growing set of ZKsync chains that interoperate through shared proofs and trustless bridging.
28+
As the first ZKsync chain, it serves as the main hub for the ecosystem’s activity and infrastructure.
29+
30+
Era is where the **ZK token** was initially deployed and where **on-chain governance** takes place, making it the coordination layer for protocol
31+
upgrades and community decision-making. Because of its early launch and adoption, ZKsync Era integrates with major exchanges, infrastructure
32+
providers such as **Chainlink** and **Tenderly**, and hosts deployments from many leading **DeFi protocols**.
33+
34+
These integrations, assets, and tools will be accessible to other ZKsync chains through [**ZKsync Connect**](/zksync-network/unique-features/zksync-connect/),
35+
ensuring that all chains in the Elastic Network benefit from access to the same liquidity, infrastructure,
36+
and ecosystem support while maintaining independent execution environments.
37+
38+
## Developer Experience
39+
40+
ZKsync Era provides an Ethereum-equivalent development environment, making it straightforward to build, test, and deploy applications
41+
thanks to the [EVM Bytecode Interpreter](/zksync-network/zksync-era/unique-features#evm-bytecode-interpreter).
42+
43+
Common Ethereum development tools—such as Hardhat, Foundry, and Remix—work out of the box.
44+
Developers can interact with Era through the same JSON-RPC interface, enabling integration with wallets, SDKs, and dApps without special configurations.
45+
46+
## User Experience
47+
48+
For end users, transactions on ZKsync Era offer faster confirmations and significantly lower fees compared to Ethereum mainnet.
49+
Era also supports [**native account abstraction**](/zksync-network/zksync-era/unique-features#native-account-abstraction), enabling smart wallets,
50+
flexible fee payments using ERC-20 tokens,
51+
and features like paymasters for gas sponsorship.

content/00.zksync-network/20.environment/03.zksync-era.md renamed to content/00.zksync-network/25.zksync-era/01.network-details.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ To manually add ZKsync Era as a custom network in your wallet, follow these step
2626
## Get testnet funds for your wallet
2727

2828
Once you have your wallet connected to a ZKsync Era environment,
29-
you can get testnet funds from one of many [testnet faucets](/zksync-network/ecosystem/network-faucets)
29+
you can get testnet funds from one of many [testnet faucets](/zksync-network/zksync-era/ecosystem/network-faucets)
3030
to use with [deploying your first smart contract](/zksync-network/guides).
3131

3232
<!-- TODO: Add link to API overview -->
Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
title: "Features"
3+
description: "Learn about ZKsync Era’s special features, including native Account Abstraction, Paymasters, and the EVM Bytecode Interpreter"
4+
---
5+
6+
ZKsync Era introduces several protocol-level features that extend Ethereum’s capabilities while maintaining compatibility with existing tools and workflows.
7+
These include **native Account Abstraction**, **Paymasters**, and an **EVM Bytecode Interpreter** for seamless integration with the Ethereum ecosystem.
8+
9+
## Native Account Abstraction
10+
11+
ZKsync Era natively supports **Account Abstraction (AA)**, allowing accounts to include custom logic at the protocol level.
12+
This enables smart accounts that can define how transactions are authorized and executed, unlocking use cases such as:
13+
14+
- Account recovery and social recovery mechanisms
15+
- Native multisignature accounts
16+
- Session keys and programmable spending rules
17+
18+
To learn more about Account Abstraction design, see the [protocol documentation](/zksync-protocol/era-vm/account-abstraction).
19+
20+
If you prefer a practical approach, explore these tutorials:
21+
22+
- [Native multisig smart account](https://code.zksync.io/tutorials/native-aa-multisig)
23+
- [Daily spending limit account](https://code.zksync.io/tutorials/daily-spend-limit-account)
24+
25+
## Paymasters
26+
27+
ZKsync Era also includes native support for **Paymasters**, an extension of the Account Abstraction model introduced
28+
in [EIP-4337](https://eips.ethereum.org/EIPS/eip-4337#extension-paymasters).
29+
Paymasters act as an intermediate layer in transaction processing, controlling how fees are paid or sponsored.
30+
31+
Common use cases include:
32+
33+
- Paying transaction fees in ERC-20 or NFT tokens
34+
- Subsidizing transactions for onboarding or promotions
35+
- Managing fee payments for a predefined set of accounts
36+
37+
For details on Paymaster design, see the [protocol documentation](/zksync-protocol/era-vm/account-abstraction/paymasters).
38+
39+
### Testnet Paymaster
40+
41+
To simplify testing, %%zk_testnet_name%% provides a built-in **testnet paymaster** that supports ERC-20 fee payments.
42+
43+
**Key details**
44+
45+
- **Address**: `0x3cb2b87d10ac01736a65688f3e0fb1b070b3eea3` ([View on explorer](https://sepolia.explorer.zksync.io/address/0x3cb2b87d10ac01736a65688f3e0fb1b070b3eea3))
46+
- **Chain**: %%zk_testnet_name%%
47+
- **Exchange rate**: 1:1 with ETH (1 token unit = 1 wei)
48+
- **Flow type**: Approval-based
49+
- **Usage requirements**:
50+
- `token`: must match the ERC-20 token used for fee payment
51+
- `minimalAllowance`: at least `tx.maxFeePerGas * tx.gasLimit`
52+
- `innerInput`: must be empty (`0x`)
53+
54+
**Example usage**
55+
56+
```ts
57+
const paymasterParams = {
58+
paymaster: "0x3cb2b87d10ac01736a65688f3e0fb1b070b3eea3",
59+
paymasterInput: {
60+
type: "ApprovalBased",
61+
token: "<ERC20_TOKEN_ADDRESS>",
62+
minimalAllowance: tx.maxFeePerGas * tx.gasLimit,
63+
innerInput: "0x",
64+
},
65+
};
66+
```
67+
68+
This setup lets developers simulate ERC-20-based fee payments in a testnet environment without deploying a custom paymaster.
69+
70+
### Paymaster Tutorials
71+
72+
- [Build an ERC20 custom paymaster](https://code.zksync.io/tutorials/erc20-paymaster)
73+
- [Dapp with gated NFT paymaster](https://code.zksync.io/tutorials/dapp-nft-paymaster)
74+
- [Frontend Quickstart with a Paymaster](https://code.zksync.io/tutorials/frontend-paymaster)
75+
- [Integrate permissionless multi-signer paymaster](https://code.zksync.io/tutorials/permissionless-paymaster)
76+
77+
## EVM Bytecode Interpreter
78+
79+
The **EVM Bytecode Interpreter** in ZKsync Era provides runtime compatibility for Ethereum smart contracts.
80+
It translates EVM instructions into EraVM instructions during execution, allowing developers to deploy contracts compiled with standard
81+
Ethereum toolchains—without using ZKsync-specific compilers (`zksolc`, `zkvyper`).
82+
83+
This enables development with **Foundry**, **Hardhat**, or **Remix** directly,
84+
without requiring [plugins](/zksync-network/tooling/hardhat/plugins/hardhat-zksync) or [custom versions](/zksync-network/tooling/foundry/overview).
85+
86+
### Main Features
87+
88+
- **EVM Bytecode Support** — Run unmodified EVM bytecode without recompilation.
89+
- **Tooling Compatibility** — Use standard Ethereum development tools out of the box.
90+
- **Address Derivation Consistency**`create` and `create2` behave identically to the EVM.
91+
- **Predeployed Contracts** — Includes `create2`, `multicall3`, and `singletonFactory` (ERC-2470).
92+
See the [protocol documentation](/zksync-protocol/era-vm/evm-interpreter/pre-deployed-contracts) for a complete list.
93+
94+
### Limitations
95+
96+
- **Debugging** — EVM-compatible debugging tools are not yet supported due to EraVM-specific internals.
97+
- **Gas Model** — EVM gas rules are emulated; actual costs follow the EraVM model. See [EVM gas interpretation](/zksync-protocol/era-vm/evm-interpreter/evm-gas-interpretation).
98+
- **Unsupported Opcodes** — The same opcodes as in EraVM remain unsupported: `CALLCODE`, `SELFDESTRUCT`, `BLOBHASH`, `BLOBBASEFEE`.
99+
- **Transaction Costs** — Bytecode translation introduces overhead, typically increasing costs by 1.5×–4× depending on execution complexity.
100+
101+
Learn more about [differences from Ethereum (Cancun)](/zksync-protocol/era-vm/evm-interpreter/evm-differences).
102+
103+
### Considerations for Developers
104+
105+
The EVM interpreter allows developers to use familiar workflows without custom compilers or plugins.
106+
However, the translated execution model incurs higher gas costs. For production deployments, compiling
107+
contracts to native EraVM bytecode using `zksolc` or `zkvyper` is recommended for optimal performance and efficiency.

content/00.zksync-network/60.ecosystem/00.index.md renamed to content/00.zksync-network/25.zksync-era/60.ecosystem/00.index.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,71 +12,71 @@ To see a wider list of the ecosystem, check out [ZKsync Era on DappRadar](https:
1212
---
1313
title: Wallets
1414
icon: i-heroicons-wallet-solid
15-
to: /zksync-network/ecosystem/wallets
15+
to: /zksync-network/zksync-era/ecosystem/wallets
1616
---
1717
Access and manage your assets seamlessly with secure and interoperable wallets.
1818
::
1919
::card
2020
---
2121
title: Data Indexers
2222
icon: i-heroicons-circle-stack-solid
23-
to: /zksync-network/ecosystem/data-indexers
23+
to: /zksync-network/zksync-era/ecosystem/data-indexers
2424
---
2525
Harness the power of enhanced data retrieval to facilitate rich query capabilities.
2626
::
2727
::card
2828
---
2929
title: Node Providers
3030
icon: i-heroicons-server-solid
31-
to: /zksync-network/ecosystem/node-providers
31+
to: /zksync-network/zksync-era/ecosystem/node-providers
3232
---
3333
Connect to ZKsync Era reliably with robust and scalable node services.
3434
::
3535
::card
3636
---
3737
title: Marketplaces
3838
icon: i-heroicons-shopping-bag-solid
39-
to: /zksync-network/ecosystem/nft-marketplaces
39+
to: /zksync-network/zksync-era/ecosystem/nft-marketplaces
4040
---
4141
Explore digital goods with dynamic NFT marketplaces, fostering unique collectible exchanges.
4242
::
4343
::card
4444
---
4545
title: Oracles
4646
icon: i-heroicons-adjustments-horizontal-solid
47-
to: /zksync-network/ecosystem/oracles
47+
to: /zksync-network/zksync-era/ecosystem/oracles
4848
---
4949
Integrate real-world data securely to enhance application functionalities.
5050
::
5151
::card
5252
---
5353
title: Bridges
5454
icon: i-heroicons-cursor-arrow-ripple-16-solid
55-
to: /zksync-network/ecosystem/bridges
55+
to: /zksync-network/zksync-era/ecosystem/bridges
5656
---
5757
Experience seamless asset transfers between different blockchain ecosystems
5858
::
5959
::card
6060
---
6161
title: Faucets
6262
icon: i-heroicons-currency-dollar-solid
63-
to: /zksync-network/ecosystem/network-faucets
63+
to: /zksync-network/zksync-era/ecosystem/network-faucets
6464
---
6565
Get free test tokens for development purposes in the ZKsync test network.
6666
::
6767
::card
6868
---
6969
title: Monitoring
7070
icon: i-heroicons-chart-bar-solid
71-
to: /zksync-network/ecosystem/monitoring
71+
to: /zksync-network/zksync-era/ecosystem/monitoring
7272
---
7373
Keep track of network operations with our comprehensive monitoring tools.
7474
::
7575
::card
7676
---
7777
title: Paymaster Service
7878
icon: i-heroicons-banknotes-16-solid
79-
to: /zksync-network/ecosystem/paymasters
79+
to: /zksync-network/zksync-era/ecosystem/paymasters
8080
---
8181
Discover the paymasters solutions available on ZKsync.
8282
::

content/00.zksync-network/60.ecosystem/10.bridges.md renamed to content/00.zksync-network/25.zksync-era/60.ecosystem/10.bridges.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,6 @@ Bridges are pivotal in enhancing interoperability between different networks or
77
data transfer. In this section, we delve into various bridge solutions integrated within the ZKsync ecosystem, providing
88
developers and users with diverse options for cross-chain or cross-layer interactions.
99

10-
::callout{icon="i-heroicons-information-circle-16-solid" color="green"}
11-
For an extended list of bridging options within
12-
the ZKsync ecosystem, feel free to explore the
13-
[bridges](https://zksync.dappradar.com/ecosystem?category=defi_bridge&page=1)
14-
category on Dappradar.
15-
::
16-
1710
## ZKsync Portal Bridge
1811

1912
The [Portal Bridge](https://bridge.zksync.io/) on ZKsync provides a gateway for assets between Ethereum and the ZKsync

content/00.zksync-network/60.ecosystem/100.wallets.md renamed to content/00.zksync-network/25.zksync-era/60.ecosystem/100.wallets.md

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,25 +7,13 @@ The following wallets are known for their robustness, ease of use, and compatibi
77
Era. These wallets offer various features including, but not limited to, DeFi, NFT management,
88
and multiple chain support.
99

10-
::callout{icon="i-heroicons-information-circle-16-solid" color="green"}
11-
For an extended list of wallets within the ZKsync ecosystem, feel free to explore the
12-
[wallets](https://zksync.dappradar.com/ecosystem?category=non_dapps_wallets&page=1)
13-
category on Dappradar.
14-
::
15-
1610
## BlockWallet
1711

1812
[BlockWallet](https://blockwallet.io/networks/zksync-wallet) is designed for ZKsync users seeking
1913
a decentralized wallet in a user-friendly package.
2014

2115
**Availability**: Chrome extension
2216

23-
## Clave
24-
25-
[Clave](https://getclave.io/) is a ZKsync native non-custodial smart wallet powered by account
26-
abstraction and the hardware-level security elements to simplify the onchain experience for the
27-
next billions.
28-
2917
**Availability**: App Store (IOS and MacOS), Google Play Store
3018

3119
## Echoo

0 commit comments

Comments
 (0)