solana_kit 0.6.0

Umbrella package re-exporting all Solana Kit Dart SDK packages.

Changelog

All notable changes to this project will be documented in this file.

This changelog is managed by monochange.

0.6.0 - 2026-08-12

💥 Breaking Change

Remove deprecated APIs across the SDK

Breaking change. Clears every remove_deprecations_in_breaking_versions lint warning by deleting deprecated members and migrating call sites to their documented replacements. No deprecations are suppressed; each deprecated declaration is removed.

createEmptyClient (solana_kit)

Removed the deprecated createEmptyClient alias. Use createClient instead.

// Before
final client = createEmptyClient({'ready': true});
// After
final client = createClient({'ready': true});

Deprecated fixed-point rounding modes (solana_kit_fixed_points)

Removed the deprecated FixedPointRoundingMode values down, up, and halfUp. The surviving modes are strict, floor, ceil, trunc, round.

• down was a duplicate of trunc — use FixedPointRoundingMode.trunc.
• halfUp was a duplicate of round — use FixedPointRoundingMode.round.
• up ("round away from zero") has no single replacement. Use floor or ceil depending on the sign of the value, or round for nearest.

Deprecated Pipe extension (solana_kit_functional)

Removed the deprecated Pipe extension from solana_kit_functional. Pipe is re-exported from solana_kit_transaction_messages and the solana_kit umbrella. Switch imports accordingly:

// Before
import 'package:solana_kit_functional/solana_kit_functional.dart';
// After
import 'package:solana_kit_transaction_messages/solana_kit_transaction_messages.dart';

solana_kit no longer depends on solana_kit_functional. The solana_kit_functional package is now an empty placeholder pending full retirement.

Deprecated subscriptions compatibility APIs

The deprecated AbortSignal/AbortController and DataPublisher/WritableDataPublisher/createDataPublisher compatibility APIs were the core transport substrate of the subscriptions stack, not a thin compatibility layer. They are replaced by stream-native and cancellation-token equivalents.

Cancellation

• AbortSignal → CancellationToken (from solana_kit_subscribable)
• AbortController → CancellationTokenSource (from solana_kit_subscribable)
• controller.signal → source.token
• controller.abort([reason]) → source.cancel([reason])
• signal.isAborted → token.isCancelled
• signal.reason → token.reason
• signal.future → token.future

Public field/parameter names that held an AbortSignal (e.g. abortSignal, signal) are kept; only their type changed to CancellationToken. CancellationToken and CancellationTokenSource are re-exported from solana_kit_rpc_subscriptions and solana_kit_rpc_subscriptions_channel_websocket so consumers do not need a direct solana_kit_subscribable dependency.

AbortError, isAbortError, getAbortableFuture, and normalClosureCode remain in solana_kit_rpc_subscriptions_channel_websocket (behavior unchanged; their AbortSignal? params are now CancellationToken?).

DataPublisher → NotificationStreams

• The transport contract changed from Future<DataPublisher> to Future<NotificationStreams>.
• RpcSubscriptionsChannel now exposes NotificationStreams get streams instead of the on(channelName, subscriber) method.
• createDataPublisher(), WritableDataPublisher, DataPublisher, and the DataPublisherStreams extension are removed.
• The *FromDataPublisher helpers are removed: createStreamFromDataPublisher, StreamFromDataPublisherConfig, createAsyncIterableFromDataPublisher, demultiplexDataPublisher, createReactiveStoreFromDataPublisher, createReactiveStreamStoreFromDataPublisher.
• The stream-native helpers are kept: ChannelStreamController, createStreamFromDataAndErrorStreams, demultiplexStream, createReactiveStoreFromStreams, ReactiveStore, ReactiveStreamStore, createReactiveStreamStore.

Public subscription APIs

PendingRpcSubscriptionsRequest.subscribe() and .reactive() still return Future<Stream<T>> and Future<ReactiveStore<T>> respectively. Internally they now consume NotificationStreams.notifications / .errors instead of DataPublisher channels.

Migration

// Before
final controller = AbortController();
final stream = await pending.subscribe(
  RpcSubscribeOptions(abortSignal: controller.signal),
);
controller.abort();

// After
final source = CancellationTokenSource();
final stream = await pending.subscribe(
  RpcSubscribeOptions(abortSignal: source.token),
);
source.cancel();

Owner: Ifiok Jr. · Introduced in: 3901c24 · Last updated in: 7d98d00

🐛 Fixed

Upstream @solana/kit 6.10.0 parity

Updates core packages to match upstream @solana/kit 6.10.0:

• solana_kit_errors: Adds 6 new error codes from @solana/errors 6.10: JSON_RPC__SERVER_ERROR_NO_SLOT_HISTORY (-32021), JSON_RPC__SERVER_ERROR_FILTER_TRANSACTION_NOT_FOUND (-32020), TRANSACTION__FAILED_TO_ESTIMATE_LOADED_ACCOUNTS_DATA_SIZE_LIMIT (5663036), TRANSACTION__FAILED_WHEN_SIMULATING_TO_ESTIMATE_RESOURCE_LIMITS (5663037), SUBSCRIBABLE__RETRY_NOT_SUPPORTED (8195000), WALLET__ACCOUNT_NOT_AVAILABLE (8900003). Adds subscribable and wallet error domains. Updates unwrapSimulationError to treat resource-limit simulation failures as simulation errors.

• solana_kit_subscribable: Adds ReactiveActionStore<TArgs, TResult> with idle/running/success/error states, dispatch/dispatchAsync/reset. Adds ReactiveStreamStore<T> with loading/loaded/error/retrying states, getUnifiedState and retry. Mirrors upstream @solana/subscribable 6.10.

• solana_kit_rpc_spec: Adds PendingRpcRequest.reactiveStore() returning a ReactiveActionStore for reactive request dispatch.

• solana_kit_rpc_api: Adds clientId to ClusterNode. Documents tpu and tpuForwards as deprecated in favor of QUIC fields.

• solana_kit_transaction_messages: Adds resource-limit estimation helpers: ResourceLimitsEstimate, estimateResourceLimitsFactory, estimateAndSetResourceLimitsFactory, fillTransactionMessageProvisoryResourceLimits, getTransactionMessageLoadedAccountsDataSizeLimit, setTransactionMessageLoadedAccountsDataSizeLimit.

Owner: @ifiokjr · Review: PR #195

📖 Documentation

Centralize package version documentation

Centralize package version metadata in versions.json and render package installation snippets from the shared MDT data source. Published package behavior is unchanged.

Owner: @ifiokjr · Review: PR #188

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

0.5.0 - 2026-06-01

💥 Breaking Change

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

0.4.0 - 2026-05-30

🚀 Feature

Trim program exports from umbrella

Remove program-specific package exports from the…

Remove program-specific package exports from the solana_kit umbrella package so program clients remain explicit imports.

Owner: Ifiok Jr. · Introduced in: 8285b34 · Last updated in: 0ee3d60

📝 Changed

Restructure release groups

Move program-specific and domain-specific packages out of the main release group into standalone release schedules with independent versioning. Core SDK packages remain synchronized in the main group.

Owner: Ifiok Jr. · Introduced in: fccec7f · Last updated in: 93b3cd3

🐛 Fixed

Add per-package coverage badges

Add codecov flags and per-package coverage badges to all package READMEs.

Owner: Ifiok Jr. · Introduced in: bed1b1f · Last updated in: 93b3cd3

Add integration tests CI job

Add SurfPool integration test CI job and devenv command for running integration tests.

Owner: Ifiok Jr. · Introduced in: 7983fb5 · Last updated in: 93b3cd3

Add per-package codecov flags

Add Codecov patch coverage and package-level coverage…

Add Codecov patch coverage and package-level coverage flags for Dart and renderer packages.

Owner: Ifiok Jr. · Introduced in: 30e1d19 · Last updated in: 0ee3d60

Fix duplicate ecosystems.dart section in monochange.toml

Merge duplicate [ecosystem.dart] and [ecosystems.dart] TOML sections into a single [ecosystems.dart] section.

Owner: Ifiok Jr. · Introduced in: d5765af

Deploy docs from main pushes

Deploy the docs site from main pushes instead of…

Deploy the docs site from main pushes instead of release-tag events so GitHub Pages deployments comply with the repository's github-pages environment branch policy.

Owner: Ifiok Jr. · Introduced in: 8543d72 · Last updated in: 0ee3d60

Add shared test fixtures and coverage gates

Add shared workspace test fixtures plus risk-tier package…

Add shared workspace test fixtures plus risk-tier package coverage gates so high-risk Solana Kit packages stay above 90% line coverage in CI.

Owner: Ifiok Jr. · Introduced in: ba96efb · Last updated in: 0ee3d60

Expand MDT doc callouts

Expand MDT-backed documentation callouts for preferred…

Expand MDT-backed documentation callouts for preferred Dart paths, compatibility notes, parity status, security guidance, and Android-only Mobile Wallet Adapter platform messaging across the workspace docs and package surfaces.

Owner: Ifiok Jr. · Introduced in: 53acc17 · Last updated in: 0ee3d60

Replace dynamic with Object?

Replace dynamic with Object? across lib source files; remaining dynamic usage is only in test matcher API signatures required by the test package.

Owner: Ifiok Jr. · Introduced in: fe249a4 · Last updated in: 0ee3d60

Add barrel-file re-export tests

Add barrel-file re-export tests for solana_kit and solana_kit_codecs umbrella packages.

Owner: Ifiok Jr. · Introduced in: 29e8823 · Last updated in: 0ee3d60

Expand coverage thresholds to 26 packages

Expand per-package coverage thresholds from 5 packages to…

Expand per-package coverage thresholds from 5 packages to 26 packages; core packages at 80%+, high-risk at 60%+.

Owner: Ifiok Jr. · Introduced in: fe249a4 · Last updated in: 0ee3d60

Add SurfPool integration test directory

Add integration test directory with basic RPC tests…

Add integration test directory with basic RPC tests designed for SurfPool local validator; not run in CI automatically.

Owner: Ifiok Jr. · Introduced in: fe249a4 · Last updated in: 0ee3d60

Enable public_member_api_docs lint

Enable public_member_api_docs lint rule with file-level suppressions for incremental backfill.

Owner: Ifiok Jr. · Introduced in: 29e8823 · Last updated in: 0ee3d60

Add examples/ directory with 26 scripts

Add a top-level examples/ directory with 26 standalone…

Add a top-level examples/ directory with 26 standalone Dart example scripts and a README covering addresses, keys, codecs, structs, options, errors, sysvars, offchain messages, transaction building/signing/confirmation, RPC, subscriptions, accounts, Helius DAS/priority-fees, functional pipe, fast-stable-stringify, address comparator, union codecs, and transaction serialisation.

Owner: Ifiok Jr. · Introduced in: 29e8823 · Last updated in: 0ee3d60

Add solana-program reference repos

Add solana-program/ reference repos to clone:repos with…

Add solana-program/* reference repos to clone:repos with pinned version tracking for all 11 program repos.

Owner: Ifiok Jr. · Introduced in: 0d394fb · Last updated in: 0ee3d60

Add transaction execution boundary

Add a higher-level transaction execution boundary that…

Add a higher-level transaction execution boundary that combines instruction-plan planning, signing, and sending into a single structured outcome, with a signer-based convenience wrapper for common app flows.

Owner: Ifiok Jr. · Introduced in: 69db7ef · Last updated in: 0ee3d60

Add account client and RPC response models

Add a higher-level Solana account client plus typed RPC…

Add a higher-level Solana account client plus typed RPC response wrappers for common account, balance, blockhash, and multi-account request flows.

Owner: Ifiok Jr. · Introduced in: aa54336 · Last updated in: 0ee3d60

Add upstream parity test harness

Add an executable upstream parity harness that compares…

Add an executable upstream parity harness that compares selected Solana Kit Dart behaviors against the tracked @solana/kit release in CI and local development.

Owner: Ifiok Jr. · Introduced in: bf0f168 · Last updated in: 0ee3d60

Expose upstream-compatible client helpers

Expose the new upstream-compatible convenience surface…

Expose the new upstream-compatible convenience surface from the umbrella package. This re-exports the fixed-point helpers, functional helpers, compute-unit estimation helpers, Dart-native client/plugin composition APIs, identity and payer capability interfaces, and slot-tracking stream/reactive-store helpers used to combine an initial RPC value with live subscription updates.

Owner: Ifiok Jr. · Introduced in: 9ee2e44 · Last updated in: 0ee3d60

Fix MDT product callout rendering so preferred-path

Owner: Ifiok Jr. · Introduced in: a7355ff · Last updated in: a526ea3

Move reference repos to config JSON

Move reference repo pins out of devenv.nix into…

Move reference repo pins out of devenv.nix into config/reference-repos.json, and teach clone:repos to read that config and report repo status.

Owner: Ifiok Jr. · Introduced in: 731da8d · Last updated in: 0ee3d60