JS SDKs v0.23

[0.23.0] - 2026-03-24
The release supersedes the 0.23.0-beta.x line and is intended for production use with ZK Compression V2. Upgrade from 0.22.x or any beta version requires addressing the breaking changes listed below.

for a full list of breaking changes and upgrade paths, see:

• token sdk changelog file: link
• stateless.js changelog file: link.

updates include:

• Uses ZK Compression V2 by default
• uses new Light Token Program, with UX and large performance improvements.
• Adds Interface methods for all payment related methods

If you need help migrating, reach out on Discord or via DM.

Devnet program release v2.3.1

Program: light_registry
Program ID: Lighton6oQpVkeewmo2mcPTQQp7kYHr4fWpAgJyEmDX
Deployed on: Devnet

What's Changed

• feat: add fee reimbursement for v2 BatchAppend and BatchUpdateAddressTree by @ananas-block in #2335
• feat: nullify_2 shared proof node and 1-byte discriminator by @ananas-block
• feat: nullify_dedup instruction for 2-4 nullifications with proof deduplication by @ananas-block
• feat: forester dedup integration with min_queue_items threshold, versioned transactions, and tx size fix by @ananas-block
• feat: disable v1 state multi-nullify when queue exceeds 10,000 items by @ananas-block
• fix: reject non-trailing sentinels in count_from_leaf_indices by @ananas-block
• refactor: simplify nullify_state_v1_multi proof dedup encoding by @ananas-block

Full Changelog: light-registry-v2.3.0...light-registry-v2.3.1

Mainnet program release v2.3.0

Program: light_system_program_pinocchio
Program ID: SySTEM1eSU2p4BGQfQpimFEWWSC1XDFeun3Nqzz3rT7
Solana Verify Hash: 581998887c26c6bda44872703b55187a435e3643293c8fd77929d562032fd04b
Deployed on: Devnet

What's Changed

• chore: add v1 tree deprecation msg by @ananas-block in #2329
• fix: batched address tree init assert tree and queue index are the same by @ananas-block in #2318
• fix: system program addresses by @ananas-block in #2298
• chore(libs): bump versions by @ananas-block in #2293
• refactor: max top to be u16::MAX by @ananas-block in #2279
• fix: store_data may cache incorrect owner by @ananas-block in #2277
• fix: v2 tree rollover balance check by @ananas-block in #2278
• fix: enforce canonical bump in ata verification by @ananas-block in #2249
• chore(libs): bump versions by @ananas-block in #2272
• fix(programs): add MintCloseAuthority as restricted extension (M-03) by @ananas-block in #2263
• fix: borsh token account deserialize throw error on invalid account type by @ananas-block in #2236
• feat: compressed mint photon api by @ananas-block in #2198
• chore(libs): bump versions by @ananas-block in #2232
• feat: light account (pinocchio) by @ananas-block in #2230
• feat: account loader. refactor light_program macro by @ananas-block in #2222
• refactor: expose DECOMPRESSED_DISCRIMINATOR and pubkey in decompressed accounts by @ananas-block in #2208
• chore: bump lib versions by @ananas-block in #2203

Full Changelog: light-system-program-v2.2.0...light-system-program-v2.3.0

Devnet program release v2.3.0

Program: light_registry
Program ID: Lighton6oQpVkeewmo2mcPTQQp7kYHr4fWpAgJyEmDX
Deployed on: Devnet

What's Changed

• chore: add v1 tree deprecation msg by @ananas-block in #2329
• chore: limit v1 state tree, v2 state&address tree creations to protocol authority by @ananas-block in #2325
• fix: init v1 tree with custom forester by @ananas-block in #2319
• fix: migrate trees ix preserve work by @ananas-block in #2320

Full Changelog: light-registry-v2.2.1...light-registry-v2.3.0

Mainnet program release v2.4.0

Program: light_compressed_token
Program ID: cTokenmWW8bLPjZEBAUgYy3zKxQZW6VKi7bqNFEVv3m
Solana Verify Hash: ad43a477a97cad48b088a64ab51008c2d27b5798090330a922a588fdecec8ea1
Deployed on: Devnet

What's Changed

• chore: add mint creation fee by @ananas-block in #2309
• refactor: add opt fee payer to revoke and approve instructions by @ananas-block in #2306
• fix: add additional self transfer checks, add rent exemption create token account check, add additional create ata idempotent check by @ananas-block in #2292
• chore(libs): bump versions by @ananas-block in #2293

Full Changelog: light-compressed-token-v2.3.0...light-compressed-token-v2.4.0

Devnet program release v2.2.0

Program: account_compression
Program ID: compr6CUsB5m2jS4Y3831ztGSTnDpnKJTKS95d64XVq
Deployed on: Devnet

What's Changed

• chore: add v1 tree deprecation msg by @ananas-block in #2329
• chore: update tree mainnet default values by @ananas-block in #2124

Full Changelog: account-compression-v2.1.0...account-compression-v2.2.0

Mainnet program release v2.2.1

What's Changed

• feat: allow foresters to register at any time by disabling registration phase time check by @sergeytimoshin in #2321

Full Changelog: light-registry-v2.2.0...light-registry-v2.2.1

photon-api-v0.56.0

What's Changed

• chore: bump lib versions by @ananas-block in #2293

Full Changelog: photon-api-v0.55.0...photon-api-v0.56.0

light-token-v0.23.0

What's Changed

• fix(sdk): align token-sdk authority mutability and wire format with pinocchio by @tilo-14 in #2301
• chore: bump lib versions by @ananas-block in #2296

Full Changelog: light-token-v0.22.1...light-token-v0.23.0

light-token-types-v0.23.0

What's Changed

• chore: bump lib versions by @ananas-block in #2293

Full Changelog: light-token-types-v0.22.0...light-token-types-v0.23.0