Migrate @solana/react to import from @solana/kit

mcintyre94 · mcintyre94 · commit f0abc4e3e6f6 · 2026-05-28T10:05:22.000Z
Switch the `@solana/react` package to take a single `@solana/kit` workspace dep instead of pinning each consumed sub-package individually. The kit barrel already re-exports `@solana/addresses`, `@solana/errors`, `@solana/keys`, `@solana/plugin-core`, `@solana/signers`, `@solana/transaction-messages`, `@solana/transactions`, `@solana/rpc-types`, and (transitively via `@solana/codecs`) `@solana/codecs-core` — so the granular deps are redundant. `@solana/subscribable` and `@solana/promises` stay as direct deps because they aren't re-exported by Kit.

The migration is mechanical — every `import { … } from '@solana/&lt;sub-package&gt;'` in `src/` becomes `import { … } from '@solana/kit'`. No behavior change; consumers' transitive dep tree is unchanged because `@solana/kit` itself depends on the same sub-packages.

Two wallet-signer tests switched from full-module auto-mocks (`jest.mock('@solana/transactions')` / `jest.mock('@solana/transaction-messages')`) to factory-style mocks (`jest.mock('@solana/kit', () =&gt; ({ ...jest.requireActual('@solana/kit'), getTransactionCodec: jest.fn(), … }))`). The bundled `@solana/kit` output doesn't propagate jest's auto-mock through its `export *` re-exports, so listing the specific functions to stub keeps everything else (notably `SolanaError`, error constants, and `bytesEqual`) as the real implementation.

Positions `@solana/react` symmetrically with how a third-party `@solana/vue` / `@solana/svelte` / etc. binding would depend on Kit: one umbrella dep, one place to import from.
diff --git a/.changeset/purple-readers-obey.md b/.changeset/purple-readers-obey.md
@@ -0,0 +1,5 @@
+---
+'@solana/react': patch
+---
+
+Migrate `@solana/react` to import from `@solana/kit` instead of pinning each consumed sub-package individually. `@solana/subscribable` and `@solana/promises` remain as direct deps because they aren't re-exported by `@solana/kit`.
diff --git a/packages/react/package.json b/packages/react/package.json
@@ -74,15 +74,9 @@
         "maintained node versions"
     ],
     "dependencies": {
-        "@solana/addresses": "workspace:*",
-        "@solana/errors": "workspace:*",
-        "@solana/keys": "workspace:*",
-        "@solana/plugin-core": "workspace:*",
+        "@solana/kit": "workspace:*",
         "@solana/promises": "workspace:*",
-        "@solana/signers": "workspace:*",
         "@solana/subscribable": "workspace:*",
-        "@solana/transaction-messages": "workspace:*",
-        "@solana/transactions": "workspace:*",
         "@solana/wallet-standard-features": "^1.3.0",
         "@wallet-standard/base": "^1.1.0",
         "@wallet-standard/errors": "^0.1.1",
@@ -91,9 +85,7 @@
         "@wallet-standard/ui-registry": "^1.0.1"
     },
     "devDependencies": {
-        "@solana/codecs-core": "workspace:*",
         "@solana/eslint-config": "workspace:*",
-        "@solana/rpc-types": "workspace:*",
         "@testing-library/react": "^16.3.2",
         "@types/react": "^19.2.15",
         "@types/react-dom": "^19.2.3",
diff --git a/packages/react/src/ClientProvider.tsx b/packages/react/src/ClientProvider.tsx
@@ -1,4 +1,4 @@
-import type { Client } from '@solana/plugin-core';
+import type { Client } from '@solana/kit';
 import React from 'react';
 
 import { usePromise } from './usePromise';
diff --git a/packages/react/src/__tests__/ClientProvider-test.browser.tsx b/packages/react/src/__tests__/ClientProvider-test.browser.tsx
@@ -1,12 +1,12 @@
-import { isSolanaError, SOLANA_ERROR__REACT__MISSING_PROVIDER } from '@solana/errors';
-import { Client, createClient } from '@solana/plugin-core';
+import { isSolanaError, SOLANA_ERROR__REACT__MISSING_PROVIDER } from '@solana/kit';
+import { Client, createClient } from '@solana/kit';
 import { act } from '@testing-library/react';
 import React, { Suspense } from 'react';
 import { ErrorBoundary } from 'react-error-boundary';
 
+import { render, renderHook } from '../__test-utils__/render';
 import { ClientProvider } from '../ClientProvider';
 import { useClient } from '../useClient';
-import { render, renderHook } from '../__test-utils__/render';
 
 describe('ClientProvider + useClient', () => {
     it('publishes the client to descendants and returns the same reference across renders', () => {
diff --git a/packages/react/src/__tests__/useAction-test.browser.tsx b/packages/react/src/__tests__/useAction-test.browser.tsx
@@ -4,7 +4,6 @@ import React from 'react';
 import { renderToString } from 'react-dom/server';
 
 import { renderHook } from '../__test-utils__/render';
-
 import { useAction } from '../useAction';
 
 describe('useAction', () => {
diff --git a/packages/react/src/__tests__/useClientCapability-test.browser.tsx b/packages/react/src/__tests__/useClientCapability-test.browser.tsx
@@ -2,14 +2,14 @@ import {
     isSolanaError,
     SOLANA_ERROR__REACT__MISSING_CAPABILITY,
     SOLANA_ERROR__REACT__MISSING_PROVIDER,
-} from '@solana/errors';
-import { createClient } from '@solana/plugin-core';
+} from '@solana/kit';
+import { createClient } from '@solana/kit';
 import React from 'react';
 
+import { renderHook } from '../__test-utils__/render';
 import { ClientProvider } from '../ClientProvider';
 import { useClient } from '../useClient';
 import { useClientCapability } from '../useClientCapability';
-import { renderHook } from '../__test-utils__/render';
 
 type ClientWithFoo = { foo: { hello(): string } };
 
diff --git a/packages/react/src/__tests__/useSubscription-test.browser.tsx b/packages/react/src/__tests__/useSubscription-test.browser.tsx
@@ -1,4 +1,4 @@
-import { SolanaRpcResponse } from '@solana/rpc-types';
+import { SolanaRpcResponse } from '@solana/kit';
 import { createReactiveStoreFromDataPublisherFactory, DataPublisher, ReactiveStreamSource } from '@solana/subscribable';
 import { act } from '@testing-library/react';
 import React from 'react';
diff --git a/packages/react/src/__tests__/useWalletAccountMessageSigner-test.ts b/packages/react/src/__tests__/useWalletAccountMessageSigner-test.ts
@@ -1,5 +1,5 @@
-import { SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED, SolanaError } from '@solana/errors';
-import { SignatureBytes } from '@solana/keys';
+import { SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED, SolanaError } from '@solana/kit';
+import { SignatureBytes } from '@solana/kit';
 import type { UiWalletAccount } from '@wallet-standard/ui';
 
 import { renderHook } from '../test-renderer';
diff --git a/packages/react/src/__tests__/useWalletAccountTransactionSendingSigner-test.ts b/packages/react/src/__tests__/useWalletAccountTransactionSendingSigner-test.ts
@@ -1,16 +1,23 @@
-import { Address } from '@solana/addresses';
-import type { VariableSizeEncoder } from '@solana/codecs-core';
-import { SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED, SolanaError } from '@solana/errors';
-import { SignatureBytes } from '@solana/keys';
-import { Transaction, TransactionMessageBytes } from '@solana/transactions';
-import { getTransactionEncoder } from '@solana/transactions';
+import {
+    Address,
+    getTransactionEncoder,
+    SignatureBytes,
+    SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED,
+    SolanaError,
+    Transaction,
+    TransactionMessageBytes,
+    type VariableSizeEncoder,
+} from '@solana/kit';
 import type { UiWalletAccount } from '@wallet-standard/ui';
 
 import { renderHook } from '../test-renderer';
 import { useSignAndSendTransaction } from '../useSignAndSendTransaction';
 import { useWalletAccountTransactionSendingSigner } from '../useWalletAccountTransactionSendingSigner';
 
-jest.mock('@solana/transactions');
+jest.mock('@solana/kit', () => ({
+    ...jest.requireActual('@solana/kit'),
+    getTransactionEncoder: jest.fn(),
+}));
 jest.mock('../useSignAndSendTransaction');
 
 describe('useWalletAccountTransactionSendingSigner', () => {
diff --git a/packages/react/src/__tests__/useWalletAccountTransactionSigner-test.ts b/packages/react/src/__tests__/useWalletAccountTransactionSigner-test.ts
@@ -1,31 +1,33 @@
-import { Address } from '@solana/addresses';
-import type { VariableSizeCodec, VariableSizeDecoder } from '@solana/codecs-core';
-import {
-    SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED,
-    SOLANA_ERROR__TRANSACTION__NONCE_ACCOUNT_CANNOT_BE_IN_LOOKUP_TABLE,
-    SolanaError,
-} from '@solana/errors';
-import { SignatureBytes } from '@solana/keys';
-import { Blockhash } from '@solana/rpc-types';
 import {
+    Address,
+    Blockhash,
     CompiledTransactionMessage,
     CompiledTransactionMessageWithLifetime,
     getCompiledTransactionMessageDecoder,
-} from '@solana/transaction-messages';
-import {
+    getTransactionCodec,
     getTransactionLifetimeConstraintFromCompiledTransactionMessage,
+    SignatureBytes,
+    SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED,
+    SOLANA_ERROR__TRANSACTION__NONCE_ACCOUNT_CANNOT_BE_IN_LOOKUP_TABLE,
+    SolanaError,
     Transaction,
     TransactionMessageBytes,
-} from '@solana/transactions';
-import { getTransactionCodec } from '@solana/transactions';
+    type VariableSizeCodec,
+    type VariableSizeDecoder,
+} from '@solana/kit';
 import type { UiWalletAccount } from '@wallet-standard/ui';
 
 import { renderHook } from '../test-renderer';
 import { useSignTransaction } from '../useSignTransaction';
 import { useWalletAccountTransactionSigner } from '../useWalletAccountTransactionSigner';
 
-jest.mock('@solana/transaction-messages');
-jest.mock('@solana/transactions');
+jest.mock('@solana/kit', () => ({
+    ...jest.requireActual('@solana/kit'),
+    assertIsTransactionWithinSizeLimit: jest.fn(),
+    getCompiledTransactionMessageDecoder: jest.fn(),
+    getTransactionCodec: jest.fn(),
+    getTransactionLifetimeConstraintFromCompiledTransactionMessage: jest.fn(),
+}));
 jest.mock('../useSignTransaction');
 
 describe('useWalletAccountTransactionSigner', () => {
diff --git a/packages/react/src/__typetests__/useClient-typetest.ts b/packages/react/src/__typetests__/useClient-typetest.ts
@@ -1,6 +1,6 @@
 /* eslint-disable react-hooks/rules-of-hooks */
 
-import type { Client } from '@solana/plugin-core';
+import type { Client } from '@solana/kit';
 
 import { useClient } from '../useClient';
 
diff --git a/packages/react/src/__typetests__/useClientCapability-typetest.ts b/packages/react/src/__typetests__/useClientCapability-typetest.ts
@@ -1,6 +1,6 @@
 /* eslint-disable react-hooks/rules-of-hooks */
 
-import type { Client } from '@solana/plugin-core';
+import type { Client } from '@solana/kit';
 
 import { useClientCapability } from '../useClientCapability';
 
diff --git a/packages/react/src/__typetests__/useSignAndSendTransaction-typetest.ts b/packages/react/src/__typetests__/useSignAndSendTransaction-typetest.ts
@@ -1,6 +1,6 @@
 /* eslint-disable react-hooks/rules-of-hooks */
 
-import { address } from '@solana/addresses';
+import { address } from '@solana/kit';
 import { UiWalletAccount } from '@wallet-standard/ui';
 
 import { useSignAndSendTransaction, useSignAndSendTransactions } from '../useSignAndSendTransaction';
diff --git a/packages/react/src/__typetests__/useSignIn-typetest.ts b/packages/react/src/__typetests__/useSignIn-typetest.ts
@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/no-floating-promises */
 /* eslint-disable react-hooks/rules-of-hooks */
 
-import { address } from '@solana/addresses';
+import { address } from '@solana/kit';
 import { WalletVersion } from '@wallet-standard/base';
 import { UiWalletAccount } from '@wallet-standard/ui';
 
diff --git a/packages/react/src/__typetests__/useSignTransaction-typetest.ts b/packages/react/src/__typetests__/useSignTransaction-typetest.ts
@@ -1,6 +1,6 @@
 /* eslint-disable react-hooks/rules-of-hooks */
 
-import { address } from '@solana/addresses';
+import { address } from '@solana/kit';
 import { UiWalletAccount } from '@wallet-standard/ui';
 
 import { useSignTransaction, useSignTransactions } from '../useSignTransaction';
diff --git a/packages/react/src/__typetests__/useSubscription-typetest.ts b/packages/react/src/__typetests__/useSubscription-typetest.ts
@@ -1,6 +1,6 @@
 /* eslint-disable react-hooks/rules-of-hooks */
 
-import { SolanaRpcResponse } from '@solana/rpc-types';
+import { SolanaRpcResponse } from '@solana/kit';
 import { ReactiveStreamSource } from '@solana/subscribable';
 
 import { SubscriptionResult, useSubscription } from '../useSubscription';
diff --git a/packages/react/src/useClient.ts b/packages/react/src/useClient.ts
@@ -1,5 +1,4 @@
-import { SOLANA_ERROR__REACT__MISSING_PROVIDER, SolanaError } from '@solana/errors';
-import type { Client } from '@solana/plugin-core';
+import { type Client, SOLANA_ERROR__REACT__MISSING_PROVIDER, SolanaError } from '@solana/kit';
 import React from 'react';
 
 import { ClientContext } from './ClientProvider';
diff --git a/packages/react/src/useClientCapability.ts b/packages/react/src/useClientCapability.ts
@@ -1,5 +1,4 @@
-import { SOLANA_ERROR__REACT__MISSING_CAPABILITY, SolanaError } from '@solana/errors';
-import type { Client } from '@solana/plugin-core';
+import { type Client, SOLANA_ERROR__REACT__MISSING_CAPABILITY, SolanaError } from '@solana/kit';
 
 import { useClient } from './useClient';
 
diff --git a/packages/react/src/useSignIn.ts b/packages/react/src/useSignIn.ts
@@ -1,4 +1,4 @@
-import { Address } from '@solana/addresses';
+import { Address } from '@solana/kit';
 import {
     SolanaSignIn,
     SolanaSignInFeature,
diff --git a/packages/react/src/useSubscription.ts b/packages/react/src/useSubscription.ts
@@ -1,4 +1,4 @@
-import { Slot, UnwrapRpcResponse } from '@solana/rpc-types';
+import { Slot, UnwrapRpcResponse } from '@solana/kit';
 import { ReactiveStreamSource } from '@solana/subscribable';
 import { useCallback, useEffect, useMemo, useRef } from 'react';
 
diff --git a/packages/react/src/useSubscriptionResult.ts b/packages/react/src/useSubscriptionResult.ts
@@ -1,4 +1,4 @@
-import { isSolanaRpcResponse, Slot, UnwrapRpcResponse } from '@solana/rpc-types';
+import { isSolanaRpcResponse, Slot, UnwrapRpcResponse } from '@solana/kit';
 import { ReactiveStreamStore } from '@solana/subscribable';
 import { useMemo, useSyncExternalStore } from 'react';
 
diff --git a/packages/react/src/useWalletAccountMessageSigner.ts b/packages/react/src/useWalletAccountMessageSigner.ts
@@ -1,9 +1,14 @@
-import { Address, address } from '@solana/addresses';
-import { bytesEqual } from '@solana/codecs-core';
-import { SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED, SolanaError } from '@solana/errors';
-import { SignatureBytes } from '@solana/keys';
+import {
+    Address,
+    address,
+    bytesEqual,
+    MessageModifyingSigner,
+    SignableMessage,
+    SignatureBytes,
+    SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED,
+    SolanaError,
+} from '@solana/kit';
 import { getAbortablePromise } from '@solana/promises';
-import { MessageModifyingSigner, SignableMessage } from '@solana/signers';
 import type { UiWalletAccount } from '@wallet-standard/ui';
 import { useMemo } from 'react';
 
@@ -21,7 +26,7 @@ import { useSignMessage } from './useSignMessage';
  * @example
  * ```tsx
  * import { useWalletAccountMessageSigner } from '@solana/react';
- * import { createSignableMessage } from '@solana/signers';
+ * import { createSignableMessage } from '@solana/kit';
  *
  * function SignMessageButton({ account, text }) {
  *     const messageSigner = useWalletAccountMessageSigner(account);
diff --git a/packages/react/src/useWalletAccountTransactionSendingSigner.ts b/packages/react/src/useWalletAccountTransactionSendingSigner.ts
@@ -1,9 +1,12 @@
-import { address } from '@solana/addresses';
-import { SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED, SolanaError } from '@solana/errors';
-import { SignatureBytes } from '@solana/keys';
+import {
+    address,
+    getTransactionEncoder,
+    SignatureBytes,
+    SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED,
+    SolanaError,
+    TransactionSendingSigner,
+} from '@solana/kit';
 import { getAbortablePromise } from '@solana/promises';
-import { TransactionSendingSigner } from '@solana/signers';
-import { getTransactionEncoder } from '@solana/transactions';
 import { UiWalletAccount } from '@wallet-standard/ui';
 import { useMemo, useRef } from 'react';
 
diff --git a/packages/react/src/useWalletAccountTransactionSigner.ts b/packages/react/src/useWalletAccountTransactionSigner.ts
@@ -1,17 +1,18 @@
-import { address } from '@solana/addresses';
-import { bytesEqual } from '@solana/codecs-core';
-import { SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED, SolanaError } from '@solana/errors';
-import { getAbortablePromise } from '@solana/promises';
-import { TransactionModifyingSigner } from '@solana/signers';
-import { getCompiledTransactionMessageDecoder } from '@solana/transaction-messages';
 import {
+    address,
     assertIsTransactionWithinSizeLimit,
+    bytesEqual,
+    getCompiledTransactionMessageDecoder,
     getTransactionCodec,
     getTransactionLifetimeConstraintFromCompiledTransactionMessage,
+    SOLANA_ERROR__SIGNER__WALLET_MULTISIGN_UNIMPLEMENTED,
+    SolanaError,
     Transaction,
+    TransactionModifyingSigner,
     TransactionWithinSizeLimit,
     TransactionWithLifetime,
-} from '@solana/transactions';
+} from '@solana/kit';
+import { getAbortablePromise } from '@solana/promises';
 import { UiWalletAccount } from '@wallet-standard/ui';
 import { useMemo, useRef } from 'react';
 
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@solana/react': patch
 +---
++
 +Migrate `@solana/react` to import from `@solana/kit` instead of pinning each consumed sub-package individually. `@solana/subscribable` and `@solana/promises` remain as direct deps because they aren't re-exported by `@solana/kit`.
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-import type { Client } from '@solana/plugin-core';`
	`1`	`+import type { Client } from '@solana/kit';`
`2`	`2`	`import React from 'react';`
`3`	`3`
`4`	`4`	`import { usePromise } from './usePromise';`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-import { SolanaRpcResponse } from '@solana/rpc-types';`
	`1`	`+import { SolanaRpcResponse } from '@solana/kit';`
`2`	`2`	`import { createReactiveStoreFromDataPublisherFactory, DataPublisher, ReactiveStreamSource } from '@solana/subscribable';`
`3`	`3`	`import { act } from '@testing-library/react';`
`4`	`4`	`import React from 'react';`