Versioning scheme for the Substrate API and SDKs

When backwards-incompatible changes are made to the API, we release a new API version, in the form of a date string, and update the Changelog.

Each Substrate SDK release is pinned to an API version. SDK versions follow semantic versioning (opens in a new tab) with the following components:


020240101.3.2 is an example SDK version string with 4 components:

  • 0SDK_MAJOR – backwards-incompatible SDK changes
  • 20240101API_VERSION – backwards-incompatible API changes
  • 3SDK_MINOR – backwards-compatible SDK changes
  • 1SDK_PATCH – minor SDK changes