solana-go v2.2.0 was published on October 19, 2026. It matches the v1.25.0 line and fixes two bugs where the library built instructions that did not mean what the code said. If you write Solana transactions from Go, read the encoding section first. This is a stable release, not a prerelease.
The full release notes and downloads are on the GitHub release page.
Instruction encoding bugs that reached the chain ¶
These two fixes matter most. Both produce valid looking transactions that the program interprets differently from what the caller intended.
The first is in confidential mint burn. The constants ConfidentialMintBurn_RotateSupplyElGamalPubkey and _UpdateDecryptableSupply had each other’s values since the extension was introduced. Building one instruction executed the other on chain. The fix is in #504.
The second is in the optional extension addresses of Token 2022. MetadataPointer, TransferHook, GroupPointer, GroupMemberPointer, InterestBearingMint and ScaledUiAmount wrote a one byte tag followed by 32 bytes. That layout is neither COption<Pubkey> nor OptionalNonZeroPubkey. The encoder now matches what the program expects (#507).
Who is affected: anyone who built these instructions with an earlier tag. Transactions already sent were encoded with the old layout. The notes do not say how to audit past transactions, so treat that as your own review item if you issued these instructions in production.
Confidential extension client API ¶
The release adds instruction builders for ConfidentialTransferFeeExtension and ConfidentialMintBurnExtension, then a client API for ConfidentialMintBurn and ConfidentialTransferFee on top of them (#511). The release notes list the builders under #504. The client API landed on main after the v1.25.0 tag, so v2.2.0 carries slightly more than v1.25.0.
The notes do not describe the method signatures. Check the package docs before wiring this into an indexer or a transaction pipeline.
Errors instead of panics on malformed instruction data ¶
A smaller change with real operational value: malformed instruction data now returns an error instead of panicking (#501). If you decode instructions from arbitrary blocks or transaction streams, a bad payload used to be able to take down the decoding goroutine, and with it the process unless you had a recover. Returning an error lets the caller skip the record, log it, and continue.
A related cleanup removes duplicate confidential AccountInfo helpers to break an import cycle (#500). That is internal structure work. Most users will not notice it, but if you imported those helpers directly, check that your build still resolves them.
Upgrade notes ¶
The notes say there are no module path or Go version changes since v2.1.0, and that upgrading needs no code edits. The module still requires Go 1.25 or later.
go get github.com/solana-foundation/solana-go/[email protected]
If you are staying on v1, the v1 line continues from main at github.com/gagliardetto/solana-go, latest v1.25.0. It carries both encoding fixes. The v2 line differs from v1 only by the module path, the breaking changes in the v2.0.0 release notes, and the VoteAccountsResult.EpochCredits type change from v2.1.0.
The comparison with the previous tag is at v2.1.0 to v2.2.0.
Where to get it ¶
- Release page: https://github.com/solana-foundation/solana-go/releases/tag/v2.2.0
- Repository: https://github.com/gagliardetto/solana-go
- Tag:
v2.2.0