Upgrades and migrations

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

June 2025

Precompiles Upgrade

• Introduced version 28.
• Added more efficient versions of ecMul, ecAdd and ecParing precompiles.
• New modexp precompile.
• Read more details in the official governance proposal.

Gateway

• Enable ZKsync Gateway as an optional aggregation layer for ZKsync Chains.
• Read more details in the official governance proposal.

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 ZKsync Gateway

• Introduced version 26.
• Completed changes necessary to prepare for ZKsync 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 ZKsync Nation onchain governance. Read more about how governance works in the ZKsync 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 ChainAdmin contract interface, which has admin rights over:
  • ZKsync Era Diamond Proxy
  • BridgeHub
  • State Transition Manager
• ChainAdmin acts as a “sovereign” wrapper, allowing each ZKsync 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 ZKsync Chains.