# What changed in @metamask/utils

> 12 changes in @metamask/utils 11 to 12 from its official release notes, upgrade guides and advisories: 3 breaking, 7 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/npm/@metamask/utils/

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

## @metamask/utils 12

### Breaking changes

- The package now ships ES2022 code, requiring a compatible modern environment or bundler configuration to consume. (12.0.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v12.0.0)
- The package is now ESM-only; CommonJS projects can use require(esm) in Node.js 22+ or dynamic imports in older Node.js versions. (12.0.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v12.0.0)
- Support for Node 18 and 20 has been dropped. (12.0.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v12.0.0)

### Behavior and default changes

- The deprecated method now returns LegacyTxData rather than TxData; the shapes are the same, so implementations do not need changing. (12.0.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v12.0.0)

## @metamask/utils 11

### New APIs and options

- Converts a mnemonic string into little-endian Uint16 wordlist indices encoded as a Uint8Array. (11.12.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.12.0)
- Adds an optimized sha384 utility function. (11.12.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.12.0)
- Adds an optimized sha512 utility function. (11.12.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.12.0)
- Converts little-endian Uint16 English BIP-39 wordlist indices into a mnemonic string. (11.12.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.12.0)
- Adds the Stellar CAIP namespace. (11.11.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.11.0)
- Adds a utility for converting unknown values to error. (11.10.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.10.0)
- Adds the sha256 utility function for use by developers. (11.9.0) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.9.0)

### Fixes and other changes

- Fixed ESM compatibility for the BIP-39 mnemonic utilities. (11.12.1) — [release notes](https://github.com/MetaMask/utils/releases/tag/v11.12.1)
