npm / @stacks/clarinet-sdk
@stacks/clarinet-sdk
What changed in @stacks/clarinet-sdk 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-21.
1 breaking2 new APIs and options3 performance6 behavior and defaults1 tooling8 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@stacks/clarinet-sdk 321 changes
Breaking changes 1
The environment variable’s behavior is inverted, changing how hints are disabled.
New APIs and options 2
Event observer configuration supports keyed events.
Simnet adds support for post-conditions.
Performance 3
The lookup algorithm now runs in O(log n).
Formatting UTF-8 strings and @format-ignore blocks no longer incurs O(n²) handling.
Caches wallet key derivation.
Behavior and default changes 6
Definition-only REPL snippets now receive their own contract name.
The table form of a devnet event observer now defaults events_keys.
Genesis sBTC balances are credited directly instead of replaying a deposit per wallet.
Mainnet boot-contract addresses are remapped to testnet addresses in simnet.
Simnet now tracks account nonces.
Contracts are deployed and sBTC is funded when devnet boots from a snapshot.
Tooling 1
Adds a session cache for LSP didsave.
Fixes and other changes 8
Simnet now remaps boot-contract addresses in requirements.
Coverage now counts syntax-only lines in multi-line expressions.
The dependency detector no longer fails on invalid Clarity code.
The formatter now properly handles escaped characters in strings.
Restores the pox-5 testnet admin rewrite.
The linter suppresses unnecessary tuple warnings in print.
Fixes epoch 4 snapshotting in devnet.
Fixes sBTC funding in devnet.