Protocol compatibility

This page is the source of truth for the compatibility guarantees provided by ZKsync OS scripts across different protocol versions.

Using proper versions

When using the scripts, ensure that you check out the appropriate branches of the repositories as per the protocol version you are targeting.

Compatibility between server, contracts, and zkstack CLI

protocolserverera-contractszksync-era (zkstack_cli)
v30.2mainzksync-os-stablezkstack-for-zksync-os
v31.0maindraft-v31-with-zksync-osdraft-v31

Compatibility for foundry versions

protocolfoundry-zksyncanvil version
v30.2nightly-ae913af65381734ad46c044a9495b67310bc77c41.5.1
v31.01.3.5-foundry-zksync-v0.1.51.5.1