# What changed in @stacks/clarinet-sdk

> 21 changes in @stacks/clarinet-sdk 3 from its official release notes, upgrade guides and advisories: 1 breaking, 2 new APIs and options. Each one cited. Sources checked 2026-10-21. HTML: https://unstale.sh/npm/@stacks/clarinet-sdk/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @stacks/clarinet-sdk 3

### Breaking changes

- The environment variable’s behavior is inverted, changing how hints are disabled. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)

### New APIs and options

- Event observer configuration supports keyed events. (3.24.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.0)
- Simnet adds support for post-conditions. (3.24.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.0)

### Performance

- The lookup algorithm now runs in O(log n). (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- Formatting UTF-8 strings and @format-ignore blocks no longer incurs O(n²) handling. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- Caches wallet key derivation. (3.24.1) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.1)

### Behavior and default changes

- Definition-only REPL snippets now receive their own contract name. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- The table form of a devnet event observer now defaults events_keys. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- Genesis sBTC balances are credited directly instead of replaying a deposit per wallet. (3.24.1) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.1)
- Mainnet boot-contract addresses are remapped to testnet addresses in simnet. (3.24.1) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.1)
- Simnet now tracks account nonces. (3.24.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.0)
- Contracts are deployed and sBTC is funded when devnet boots from a snapshot. (3.24.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.0)

### Tooling

- Adds a session cache for LSP didsave. (3.24.1) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.1)

### Fixes and other changes

- Simnet now remaps boot-contract addresses in requirements. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- Coverage now counts syntax-only lines in multi-line expressions. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- The dependency detector no longer fails on invalid Clarity code. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- The formatter now properly handles escaped characters in strings. (3.25.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.25.0)
- Restores the pox-5 testnet admin rewrite. (3.24.1) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.1)
- The linter suppresses unnecessary tuple warnings in print. (3.24.1) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.1)
- Fixes epoch 4 snapshotting in devnet. (3.24.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.0)
- Fixes sBTC funding in devnet. (3.24.0) — [release notes](https://github.com/stx-labs/clarinet/releases/tag/v3.24.0)