Upgrades and migrations
Learn about recent upgrades and migrations for ZKsync.
Learn about recent upgrades, breaking changes, and migrations in the ZKsync ecosystem here.
For more details, you can check out the ZKsync governance proposals,
the CHANGELOG.md and
releases for the zksync-era repository.
2025
April 2025
EVM Interpreter Upgrade
- Introduced version 27.
- Added support for EVM contracts, enabling standard EVM tooling for ZKsync.
- Read more details in the official governance proposal.
February 2025
Preparations for ZK Gateway
- Introduced version 26.
- Completed changes necessary to prepare for ZK Gateway.
- Added support for custom DA layers.
- Updated the bridging architecture.
- Read more details in the official governance proposal.
2024
December 2024
Protocol Defense Upgrade
- Introduced version 25.
- Implemented several code quality improvements and gas optimizations.
- Read more details in the official governance proposal.
September 2024
Governance Rights Upgrade
- Patched version 24.2.
- Transferred the authority for upgrades to ZK Nation onchain governance. Read more about how governance works in the ZK Nation blog post.
Shared Bridge Upgrade
- Patched version 24.2.
- Introduced a minor change to the BridgeHub contracts which allows the Admin role to add custom base tokens to the system. Previously only the owner of the contract was able to do this. The upgrade was a required step to distinguish the owner and admin role.
August 2024
Shared Bridge Upgrade
- Patched version 24.2.
- Introduced an admin role in the Shared Bridge contract to advance toward decentralized governance.
- The admin is exclusively responsible for nominating L2 bridge counterparts for newly deployed chains.
Elastic Chain Upgrade
- Patched version 24.2.
- Introduced the new
ChainAdmincontract interface, which has admin rights over:- ZKsync Era Diamond Proxy
- BridgeHub
- State Transition Manager
ChainAdminacts as a “sovereign” wrapper, allowing each ZK Chain to customize configurations like fee parameters and upgrade processes.- The State Transition Manager (STM) contract now emits events with more detailed upgrade data accessible to other ZK Chains.