Road to Clarinet 3.0

[hugocaillard]

Context

A new major version of Clarinet is planned for Q1 or early Q2 2025

The major version bump is mostly motivated by the breaking changes in Stacks.js v7 that we want to support in the Clarinet SDK.
Here is a list of other changes that should make it to the release.

Note that many if the changes are not breaking changes in could be continuously shipped in 2.0.
They are listed here in order address them before 3.0.

Changes to anticipate

• feat: support stacks.js v7 #1605 (breaking change)
• epoch update fixes in simnet (breaking change)
  • make it impossible to update to a lower epoch
  • always advance of 1 burn block on epoch changes
• use vitest 3.x in Clarienet project (might contain breaking, but will try to ship in 2.x if not)
• improve clarinet requirement handling #1655 (transparent breaking change that could be shipped in 2.x)
  • remove the need for explicit requirements in Clarinet projects
• to be confirmed: stop bundling clarinet-sdk to cjs (the esm version should be support in cjs project as of node 22.12)
• Remove clarinet-sdk bin script that was used to migrate from 1.x to 2.x

It will also include stable releases and improvements to features that are currently being shipped in 2.x, especially:

• mainnet transaction simulation improvements #1646
• Clarinet format #1609

A few know bug (or improvements) should be addressed, included but not only

• On Simnet, in at-block, burn-block-height returns the highest latest value, not the value on that block #1615
• Support: Clarinet Requirements to automatically add the Trait Dependencies #1651
• Inconsistent block height output #1653
• The VSCode extension does not download requirements when opening a project #1656
• Refactor wasm target and clarity-vm handling #1647