solana_kit_loader 0.5.0

BPF Loader v3 (Upgradeable) and Loader v4 instructions, accounts, and helpers for Solana Kit.

Changelog

solana_kit_loader 0.1.0 (2026-06-01)

💥 Breaking Change

Add Loader program package

Add a new loader package with BPF Loader v3 (Upgradeable) and Loader v4 program addresses, instruction builders, account header codecs, and deployment/upgrade instruction plan helpers.

import 'package:solana_kit_loader/solana_kit_loader.dart';

final instruction = getUpgradeInstruction(
  programDataAddress: programDataAddress,
  programAddress: programAddress,
  authority: authorityAddress,
  buffer: bufferAddress,
);

Owner: Ifiok Jr. · Introduced in: 34c93b9 · Last updated in: 2a9ae80

Raise minimum Dart SDK to 3.12

Raise the minimum supported Dart SDK constraint to ^3.12.0 across public Dart packages.

This is a breaking change because consumers must use Dart 3.12 or newer. Flutter consumers must use a Flutter SDK that bundles Dart 3.12 or newer.

environment:
  sdk: ^3.12.0

Owner: Ifiok Jr. · Introduced in: 32d5d36

🐛 Fixed

Add well-known program, sysvar, SPL, Metaplex, and token mint address constants

Add centralized address constants to solana_kit_addresses so that any package can reference well-known on-chain addresses without importing the full domain package or hardcoding strings.

New exports:

• program_addresses.dart — All Agave/Solana native program addresses (system, ALT, BPF loaders, compute budget, config, stake, vote, etc.)
• sysvar_addresses.dart — All sysvar addresses (clock, rent, recentBlockhashes, fees, rewards, etc.) plus the sysvar owner address
• spl_addresses.dart — SPL program addresses (Token, Token-2022, ATA, Memo, Memo Legacy)
• metaplex_addresses.dart — Metaplex program addresses (Token Metadata, Bubblegum, Auth Rules, Core, SPL Account Compression, Noop)
• well_known_addresses.dart — Well-known token mint addresses (Wrapped SOL, USDC, USDT)

Also re-exports from solana_kit_address (Address type, codecs, comparator, PublicKey) and solana_kit_address_constants (well-known address constants).

Owner: Ifiok Jr. · Introduced in: 3f596ef · Last updated in: 4643648

solana_kit_loader 0.1.1 (2026-08-12)

🐛 Fixed

Bump program reference pins to latest upstream tags

Updates config/reference-repos.json and docs to track the latest upstream tags for program packages whose IDLs are unchanged or tooling-only:

• Token: js@v0.13.0 → js@v0.14.0
• Address Lookup Table: js@v0.11.0 → js@v0.12.1
• Memo: js@v0.11.1 → js@v0.11.2
• Compute Budget: js@v0.15.0 → js@v0.16.0
• Stake: js@v0.6.1 → js@v0.7.2
• Loader v3: js@v0.3.0 → js@v0.4.0

No generated Dart API changes for these packages — IDL comparison confirmed semantic equivalence. Updates are reference pin and documentation only.

Owner: @ifiokjr · Review: PR #195

📖 Documentation

Point package README website badges at package docs

Updated package README website badges to link directly to each package's docs catalog entry and added missing package entries to the documentation website catalog/index.

Owner: @ifiokjr · Review: PR #192

solana_kit_loader 0.3.0 (2026-08-18)

💥 Breaking Change

Regenerated program packages from upstream v7 IDLs

Regenerated all 8 generated program packages from their latest upstream Codama IDLs:

• solana_kit_system: js@v0.12.2 → v0.13.0
• solana_kit_token: js@v0.14.0 → v0.15.0
• solana_kit_token_2022: js@v0.12.0 → v0.14.1
• solana_kit_address_lookup_table: js@v0.12.1 → v0.13.0
• solana_kit_memo: js@v0.11.2 → v0.12.0
• solana_kit_compute_budget: js@v0.16.0 → v0.17.0
• solana_kit_stake: js@v0.7.2 → v0.8.0; applied the upstream Stake Codama preprocessing before rendering so generated defined-type imports resolve to Dart files
• solana_kit_loader: loader-v3 js@v0.4.0 → v0.5.0; migrated planning helpers to the generated v0.5 API and retained the handwritten Loader v3 account codecs and Loader v4 client surface

Generated using node scripts/generate_program_packages.mjs — a new generator script that runs the Codama renderer against upstream IDLs.

// Generated clients now match newer upstream IDLs, e.g. the system program:
final instruction = getCreateAccountInstruction(
  payer: payer.address,
  newAccount: newAccount.address,
  lamports: lamports,
  space: space,
  owner: owner,
);

Owner: @ifiokjr · Review: PR #204

solana_kit_loader 0.3.1 (2026-08-19)

Changed

• No package-specific changes were recorded; solana_kit_loader was updated to 0.3.1.

solana_kit_loader 0.4.0 (2026-08-30)

🐛 Fixed

Refresh upstream reference pins for solana-program/* and mpl-bubblegum

• Tracks the latest upstream references in config/reference-repos.json: solana-program/system js@v0.14.0 (was js@v0.13.0), solana-program/token js@v0.16.0 (was js@v0.15.0), solana-program/token-2022 js@v0.16.0 (was js@v0.14.1), solana-program/address-lookup-table js@v0.14.0 (was js@v0.13.0), solana-program/memo js@v0.13.0 (was js@v0.12.0), solana-program/compute-budget js@v0.18.0 (was js@v0.17.0), solana-program/stake js@v0.9.0 (was js@v0.8.0), solana-program/loader-v3 js@v0.6.0 (was js@v0.5.0), solana-program/loader-v4 commit 4f62fb2e (was commit 1d6335be), and mpl-bubblegum commit 6a6a77e3 (was commit 68e4bc20).
• All of the js releases are @solana/kit ^7 → ^8 dependency bumps with no instructions, accounts, types, or wire-format changes; the IDL additions are Codama display metadata, which the Dart renderer does not render. Regenerating every affected client from the old and new pins produced byte-identical Dart output, so the generated clients are unchanged. The mpl-bubblegum new commit only re-exports the JS mintV2 helpers and the loader-v4 new commit only bumps its JS client to @solana/kit v8; both IDLs are unchanged. The token-2022 pin supersedes the stale PR #222 (js@v0.15.0).
• solana-program/stake restructured its IDL to the Codama v1.8.0 format (program metadata block, lockupParams argument links renamed from lockupArgs, IDL program node renamed from solanaStakeInterface to stake). scripts/generate_program_packages.mjs now maps both argument link names and keeps the solanaStakeInterface renderer-facing program name, so the generated APIs (flattened setLockup/setLockupChecked/authorizeWithSeed argument fields, SolanaStakeInterface identifiers) stay stable. No generated Dart code changed.
• Package READMEs now cite the refreshed upstream versions they mirror.

Owner: @ifiokjr · Review: PR #226 · Related issues: #222, #225

solana_kit_loader 0.4.1 (2026-08-30)

Changed

• No package-specific changes were recorded; solana_kit_loader was updated to 0.4.1.

solana_kit_loader 0.4.2 (2026-09-06)

🐛 Fixed

Fix multi-transaction loader uploads

Allow deploy and upgrade plans to upload program buffers across sequential transactions before finalizing, making normal program binaries executable with the standard transaction planner and executor.

Owner: @ifiokjr · Review: PR #238

solana_kit_loader 0.4.3 (2026-09-12)

Changed

• No package-specific changes were recorded; solana_kit_loader was updated to 0.4.3.

solana_kit_loader 0.5.0 (2026-09-21)

Breaking changes

Raise the Dart and Flutter baseline

The workspace now builds against Dart 3.13.3 and Flutter 3.47.4, and every package declares that floor instead of the previous Dart 3.12 range. Consumers on older SDKs can no longer resolve these packages, so this release is breaking even though no Dart API changed.

The Flutter floor rises from 3.44 to 3.47 for solana_kit_mobile_wallet_adapter, solana_kit_mobile_wallet_adapter_protocol, and solana_kit_wallet_adapter, matching the floor solana_kit_wallet_ui already required. solana_kit_lints ships the raised floor to consumers, so it carries the same breaking bump. Every other package raises only the Dart SDK floor.

Raising the language version also switches dart format to the tall style, so 83 files across library, test, script, and Codama-generated trees are reflowed. The renderer pipes generated output through dart format, so regenerating stays consistent.

Align your own SDK constraint with the workspace:

environment:
  sdk: ^3.13.0
  # Omit for pure Dart packages; required for the Flutter packages above.
  flutter: ">=3.47.0"

Owner: Ifiok Jr. · Introduced in: 5f5fe01 · Last updated in: 19932db

0.0.0

Placeholder publication.