Protocol Versions and Migrations

The protocol version is the count of upgrades applied to a network, starting at 0 at genesis. Genesis is immutable — it is the network's identity — so every change to CVM semantics after launch arrives as a scheduled migration that increments the version by exactly 1.

Full design: convex-core/docs/UPGRADE.md. Read it before authoring a migration; this skill is orientation and conventions.

Write Against v1

v1 is the target. It is the first upgrade, it bundles every bug known at genesis, and it is what networks will be running. Unless you are specifically reasoning about live or historical behaviour, v1 semantics are the semantics.

This is the project's own test convention — three state roles, each answering a different question: