solana_kit_rpc_api 0.9.3

RPC method type definitions for the Solana Kit Dart SDK.

Changelog

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

This changelog is managed by monochange.

0.9.3 - 2026-09-12

Changed

• No package-specific changes were recorded; solana_kit_rpc_api was updated to 0.9.3 as part of group main.

0.9.2 - 2026-09-06

🚀 Feature

Track @solana/kit v8.2.0

The workspace now tracks upstream @solana/kit v8.2.0 and the parity harness passes against it.

• New getAgGenesisCert RPC method returning the Alpenglow genesis certificate (or null), with allowed numeric keypaths that keep blockId, bitmap, and signature byte arrays as numbers while upcasting slot to BigInt.
• isSolanaRequest recognizes getAgGenesisCert and the previously missed getTransactionsForAddress.
• New createTransactionPlanExecutorWithConcurrentLeaves mirroring upstream: every leaf starts concurrently (including across sequential plans), a failed leaf does not cancel siblings, non-divisible sequential plans are supported, and the executor builds results from the shared callback contract — context stored on the mutable map is preserved on failures.

Reference pins refreshed to the latest upstream tags (compute-budget v0.18.1, memo v0.13.1, token v0.16.1, token-2022 v0.16.1, stake v0.9.1, address-lookup-table v0.14.1, system v0.14.1, loader-v3 v0.6.1 — all packaging-only upstream changes), and the Codama renderer dependencies moved to codama 1.10.2 / renderers-core 1.4.0.

Owner: @ifiokjr · Review: PR #239

0.9.1 - 2026-08-30

Changed

• No package-specific changes were recorded; solana_kit_rpc_api was updated to 0.9.1 as part of group main.

0.9.0 - 2026-08-30

📖 Documentation

Unslop package docs and code comments

Rewrote every package README from a reader's perspective with verified, compilable examples, removed AI-tell phrasing from docs and code comments, and added a test that analyzes every Dart block in Markdown so examples cannot drift from the API.

Owner: @ifiokjr · Review: PR #223

0.8.0 - 2026-08-19

Changed

• No package-specific changes were recorded; solana_kit_rpc_api was updated to 0.8.0 as part of group main.

0.7.0 - 2026-08-18

💥 Breaking Change

@solana/kit v7.0.0 upstream sync (foundational breaking changes)

Ports the foundational breaking changes from @solana/kit v7.0.0:

• solana_kit_errors: new transactionIntrospection error domain + codes (transactionFailedToDecompileInstructionAccountIndexOutOfRange, transactionIntrospectionCannotDecodeJsonParsedTransaction, transactionIntrospectionUnrecognizedGetTransactionResponse) and instruction-plans max-instructions codes (instructionPlansInvalidMaxInstructionsPerTransaction, instructionPlansMaxInstructionsPerTransactionExceeded).
• solana_kit_codecs_data_structures: createDependentStructDecoder fluent builder for structs whose later fields depend on earlier decoded values.
• solana_kit_instruction_plans: configurable maxInstructionsPerTransaction (default 16, limit 64) on TransactionPlannerConfig, individual TransactionPlanner invocations, and MessagePacker; invocation-specific planner values take precedence without leaking to later calls.
• solana_kit_rpc_types: isSolanaRpcResponse runtime guard.
• solana_kit: removed the local getMinimumBalanceForRentExemption helper (rent exemption is becoming dynamic; use the RPC method instead).
• solana_kit_subscribable: ReactiveStreamStore v7 rewrite — caller-driven connect()/reset()/withSignal(), starts idle, collapses retrying into loading (stale-while-revalidate), renames getUnifiedState() → getState(); removed retry(), value-only getState(), getError(). ReactiveActionStore now passes a fresh CancellationToken to every action, cancels superseded/reset/disposed dispatches, suppresses late outcomes, exposes caller cancellation through withSignal(), and preserves stale results and errors while running.
• solana_kit_transaction_introspection: new first-class package porting @solana/transaction-introspection — RPC transaction decoding, instruction and inner-instruction extraction, loaded-address resolution, and instruction walking helpers; re-exported from the solana_kit umbrella.
• solana_kit_rpc_parsed_types / solana_kit_rpc_transformers / solana_kit_rpc_api: Agave 4.1.0 parsed-account types — vote commissions/latency as int (not BigInt); rent sysvar union (lamportsPerByte vs deprecated burnPercent/exemptionThreshold/ lamportsPerByteYear); stake warmupCooldownRate optional; config slashPenalty/warmupCooldownRate deprecated; keep vote commissions and latency as int in the numeric-keypath allow-lists.

Migration: getMinimumBalanceForRentExemption(space) → rpc.getMinimumBalanceForRentExemption(space).send(); store.retry() → store.connect(); store.getUnifiedState() → store.getState(); the deprecated ReactiveStore/createReactiveStoreFromStreams → createReactiveStreamStore; reactive actions must migrate from (args) async => result to (signal, args) async => result.

// Before
final lamports = getMinimumBalanceForRentExemption(space);
store.retry();
final state = store.getUnifiedState();

// After
final lamports = await rpc.getMinimumBalanceForRentExemption(space).send();
store.connect();
final state = store.getState();

Owner: @ifiokjr · Review: PR #204

🐛 Fixed

@solana/kit v7.1.0 upstream sync

Ports the @solana/kit v7.1.0 changes into the Dart SDK.

solana_kit_errors

Adds the three new error codes introduced in @solana/kit v7.1.0:

• offchainMessageContentDoesNotMatchExpected (5607018) — from @solana/offchain-messages's new assertOffchainMessageV1Equal helper.
• offchainMessageRequiredSignatoriesDoNotMatchExpected (5607019) — same.
• subscribableStreamClosedWithoutError (8195001) — from @solana/subscribable's new bridgeStoreToAsyncIterable helper.

solana_kit_subscribable

Adds bridgeStoreToAsyncIterable, which adapts a ReactiveStreamStore into a pull-based Stream (the Dart equivalent of the upstream AsyncIterable). It seeds from the store's current snapshot, yields loaded values (latest-wins), throws on error (substituting subscribableStreamClosedWithoutError when the error payload is nullish), and ends cleanly when the CancellationToken fires. The caller owns the store's lifecycle (connect()/reset()).

solana_kit_offchain_messages

Adds assertOffchainMessageV1Equal, which asserts that a version 1 offchain message received from an untrusted signer is the message you expected it to sign. Compares content (reporting UTF-8 byte lengths) and required signatories (order-insensitive, sorted for comparison), throwing offchainMessageContentDoesNotMatchExpected / offchainMessageRequiredSignatoriesDoNotMatchExpected on mismatch.

solana_kit_instruction_plans

createTransactionPlanExecutor's executeTransactionMessage callback may now return the context of a successful result (a map that must include a signature) instead of a Signature or Transaction. The returned context is merged with the mutable context, taking precedence. Returning a Signature or Transaction still behaves as before (stored as context['signature'] / context['transaction'] with the signature derived).

solana_kit_rpc_transformers / solana_kit_rpc_api

• New tokenBalancesConfigs export (accountIndex, uiTokenAmount.decimals, uiTokenAmount.uiAmount).
• getTransaction, getBlock, and simulateTransaction now allow-list uiTokenAmount.uiAmount (previously upcast to BigInt when whole).
• simulateTransaction now allow-lists token-balance accountIndex and uiTokenAmount.decimals.
• getTransaction and getBlock now allow-list the transaction version (previously arrived as 0n while typechecking as 0).
• getTransactionsForAddress allowed-numeric keypaths.

solana_kit

Adds the v7.1.0 client-interface helpers:

• ClientWithGetMinimumBalance and ClientWithFetchAccounts interfaces.
• createClientWithGetMinimumBalanceFromRpc — computes the rent-exempt minimum balance via getMinimumBalanceForRentExemption (with the withoutHeader rate-recovery trick).
• createClientWithFetchAccountsFromRpc — dispatches on address count (getAccountInfo / getMultipleAccounts / empty short-circuit).
• createClientWithInterfacesFromRpc — returns both interfaces.

Also re-exports the @solana/promises helpers as Dart counterparts: isAbortError, getAbortablePromise, and safeRace (adapted to Dart's cancellation model via CancellationToken; AbortError lives in solana_kit_subscribable).

solana_kit_rpc_api

Adds the getTransactionsForAddress RPC method request side: config (commitment, filters, limit, minContextSlot, paginationToken, sortOrder, encoding, maxSupportedTransactionVersion, transactionDetails), filters (blockTime/signature/slot comparisons, status, tokenAccounts), and the params builder.

solana_kit_rpc_types

• Adds the getTransactionsForAddress response types: signatures and full modes (with per-entry base fields, transaction/status variants, and the TransactionDetails enum).
• Adds the shared meta.costUnits field to the transaction meta types.

Already present in the Dart port (no change needed):

• @solana/codecs-data-structures getBitArrayEncoder next-offset fix (offset + size) — the Dart encoder already returns offset + size.
• @solana/transaction-messages compressTransactionMessageUsingAddressLookupTables rejecting v1 transactions — a compile-time-only type narrowing upstream; not expressible in Dart's single-class TransactionMessage model, so no runtime change.

@solana/react changes are not ported (React-only).

Owner: @ifiokjr · Review: PR #206

0.6.0 - 2026-08-12

🚀 Feature

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

🧪 Testing

Improve test coverage to 95%+ across all packages

Added 500+ tests covering equality/hashCode/toString, codec edge cases, error paths, and constructor variants. Removed dead code in fast_stable_stringify. Fixed concurrent modification bug in subscribable.

Owner: Ifiok Jr. · Introduced in: 48216f9 · Last updated in: b7f5419

0.4.0 - 2026-05-30

🚀 Feature

Replace string encoding fields with AccountEncoding

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

📝 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

Improve handwritten test coverage across RPC

Owner: Ifiok Jr. · Introduced in: 68fa2e3 · Last updated in: a526ea3

Expand RPC API test coverage

Expand RPC API test coverage with per-method config/params tests and shared param-builder contract tests.

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

Replace unsafe .cast() with JsonReader

Introduce internal JsonReader helper that replaces unsafe…

Introduce internal JsonReader helper that replaces unsafe .cast<T>() list

casts and bare as casts in all fromJson factories with explicit typed accessors. Parse errors now surface at construction time via a descriptive FormatException that includes the field name, rather than deferring until element access. All ten type files (das_types, enhanced_types, zk_types, wallet_types, webhook_types, rpc_v2_types, auth_types, staking_types, priority_fee_types, smart_transaction_types) have been migrated. The public API is unchanged.

Owner: Ifiok Jr. · Introduced in: 29e8823 · 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 equality to value types

Add == / hashCode / toString to value types across…

Add == / hashCode / toString to value types across rpc_types, rpc_api, rpc_parsed_types, rpc_spec_types, instructions, transaction_messages, and transaction_confirmation.

Owner: Ifiok Jr. · Introduced in: 29e8823 · 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

Align sendTransaction and simulate with 6.9

Align sendTransaction and simulateTransaction behavior…

Align sendTransaction and simulateTransaction behavior with upstream 6.9, including preflight metadata defaults, nullable Agave metadata, BigInt JSON-RPC error code handling, and expanded simulation response metadata types.

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