anza-xyz · lorisleiva · Apr 14, 2026 · Apr 12, 2026
diff --git a/.changeset/strong-bananas-attend.md b/.changeset/strong-bananas-attend.md
@@ -0,0 +1,5 @@
+---
+'@solana/kit-plugin-rpc': minor
+---
+
+Add granular `rpcConnection`, `rpcSubscriptionsConnection`, `solanaRpcConnection`, and `solanaRpcSubscriptionsConnection` plugins. Deprecate `rpc` and `localhostRpc` in favor of the new granular alternatives.
diff --git a/README.md b/README.md
@@ -89,12 +89,19 @@ None of the ready-to-use clients fit your needs? No worries! You can **build you
 
 ```ts
 import { createClient } from '@solana/kit';
-import { rpc, rpcAirdrop, rpcTransactionPlanner, rpcTransactionPlanExecutor } from '@solana/kit-plugin-rpc';
+import {
+    solanaRpcConnection,
+    solanaRpcSubscriptionsConnection,
+    rpcAirdrop,
+    rpcTransactionPlanner,
+    rpcTransactionPlanExecutor,
+} from '@solana/kit-plugin-rpc';
 import { payerFromFile } from '@solana/kit-plugin-payer';
 import { planAndSendTransactions } from '@solana/kit-plugin-instruction-plan';
 
 const client = await createClient() // An empty client with a `use` method to install plugins.
-    .use(rpc('https://api.devnet.solana.com')) // Adds `client.rpc` and `client.rpcSubscriptions`.
+    .use(solanaRpcConnection('https://api.devnet.solana.com')) // Adds `client.rpc`.
+    .use(solanaRpcSubscriptionsConnection('wss://api.devnet.solana.com')) // Adds `client.rpcSubscriptions`.
     .use(payerFromFile('path/to/keypair.json')) // Adds `client.payer` using a local keypair file.
     .use(rpcAirdrop()) // Adds `client.airdrop` to request SOL from faucets.
     .use(rpcTransactionPlanner()) // Adds `client.transactionPlanner`.
@@ -119,12 +126,12 @@ _Do you know any? Please open a PR to add them here!_
 
 This repo provides the following individual plugin packages. You can learn more about each package by following the links to their READMEs below.
 
-| Package                                                                         | Version                                                                                                                                                      | Description                        | Plugins                                                                                                                |
-| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| [`@solana/kit-plugin-rpc`](./packages/kit-plugin-rpc)                           | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-rpc.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-rpc)                           | Connect to Solana clusters         | `rpc`, `localhostRpc`, `rpcAirdrop`, `rpcGetMinimumBalance`, `rpcTransactionPlanner`, `rpcTransactionPlanExecutor`     |
-| [`@solana/kit-plugin-payer`](./packages/kit-plugin-payer)                       | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-payer.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-payer)                       | Manage transaction fee payers      | `payer`, `payerFromFile`, `generatedPayer`, `generatedPayerWithSol`                                                    |
-| [`@solana/kit-plugin-litesvm`](./packages/kit-plugin-litesvm)                   | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-litesvm.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-litesvm)                   | LiteSVM support                    | `litesvm`, `litesvmAirdrop`, `litesvmGetMinimumBalance`, `litesvmTransactionPlanner`, `litesvmTransactionPlanExecutor` |
-| [`@solana/kit-plugin-instruction-plan`](./packages/kit-plugin-instruction-plan) | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-instruction-plan.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-instruction-plan) | Transaction planning and execution | `transactionPlanner`, `transactionPlanExecutor`, `planAndSendTransactions`                                             |
+| Package                                                                         | Version                                                                                                                                                      | Description                        | Plugins                                                                                                                                                                                               |
+| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`@solana/kit-plugin-rpc`](./packages/kit-plugin-rpc)                           | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-rpc.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-rpc)                           | Connect to Solana clusters         | `rpcConnection`, `rpcSubscriptionsConnection`, `solanaRpcConnection`, `solanaRpcSubscriptionsConnection`, `rpcAirdrop`, `rpcGetMinimumBalance`, `rpcTransactionPlanner`, `rpcTransactionPlanExecutor` |
+| [`@solana/kit-plugin-payer`](./packages/kit-plugin-payer)                       | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-payer.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-payer)                       | Manage transaction fee payers      | `payer`, `payerFromFile`, `generatedPayer`, `generatedPayerWithSol`                                                                                                                                   |
+| [`@solana/kit-plugin-litesvm`](./packages/kit-plugin-litesvm)                   | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-litesvm.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-litesvm)                   | LiteSVM support                    | `litesvm`, `litesvmAirdrop`, `litesvmGetMinimumBalance`, `litesvmTransactionPlanner`, `litesvmTransactionPlanExecutor`                                                                                |
+| [`@solana/kit-plugin-instruction-plan`](./packages/kit-plugin-instruction-plan) | [![npm](https://img.shields.io/npm/v/@solana/kit-plugin-instruction-plan.svg?style=flat)](https://www.npmjs.com/package/@solana/kit-plugin-instruction-plan) | Transaction planning and execution | `transactionPlanner`, `transactionPlanExecutor`, `planAndSendTransactions`                                                                                                                            |
 
 ## Community Plugins
 

diff --git a/packages/kit-plugin-payer/README.md b/packages/kit-plugin-payer/README.md
@@ -67,12 +67,14 @@ Note that this plugin requires an airdrop plugin to be installed on the client b
 
 ```ts
 import { createClient } from '@solana/kit';
-import { localhostRpc, rpcAirdrop } from '@solana/kit-plugin-rpc';
+import { solanaRpcConnection, solanaRpcSubscriptionsConnection, rpcAirdrop } from '@solana/kit-plugin-rpc';
 import { generatedPayerWithSol } from '@solana/kit-plugin-payer';
 
 const client = await createClient()
-    .use(localhostRpc()) // or .use(litesvm()).use(litesvmAirdrop())
+    .use(solanaRpcConnection('http://127.0.0.1:8899'))
+    .use(solanaRpcSubscriptionsConnection('ws://127.0.0.1:8900'))
     .use(rpcAirdrop())
+    // or .use(litesvm()).use(litesvmAirdrop())
     .use(generatedPayerWithSol(lamports(10_000_000_000n))); // 10 SOL
 ```
 
@@ -90,16 +92,18 @@ When no explicit payer is given, this plugin requires an airdrop plugin to be in
 
 ```ts
 import { createClient } from '@solana/kit';
-import { localhostRpc, rpcAirdrop } from '@solana/kit-plugin-rpc';
+import { solanaRpcConnection, solanaRpcSubscriptionsConnection, rpcAirdrop } from '@solana/kit-plugin-rpc';
 import { payerOrGeneratedPayer } from '@solana/kit-plugin-payer';
 
 // With an explicit payer — no airdrop needed.
 const client = await createClient().use(payerOrGeneratedPayer(mySigner));
 
 // Without a payer — generates one and airdrops 100 SOL.
 const client = await createClient()
-    .use(localhostRpc()) // or .use(litesvm()).use(litesvmAirdrop())
+    .use(solanaRpcConnection('http://127.0.0.1:8899'))
+    .use(solanaRpcSubscriptionsConnection('ws://127.0.0.1:8900'))
     .use(rpcAirdrop())
+    // or .use(litesvm()).use(litesvmAirdrop())
     .use(payerOrGeneratedPayer(undefined));
 ```
 

diff --git a/packages/kit-plugin-payer/src/index.ts b/packages/kit-plugin-payer/src/index.ts
@@ -133,15 +133,16 @@ export function payerFromFile(path: string) {
  * @example
  * ```ts
  * import { createClient } from '@solana/kit';
- * import { localhostRpc, rpcAirdrop } from '@solana/kit-plugin-rpc';
+ * import { solanaRpcConnection, solanaRpcSubscriptionsConnection, rpcAirdrop } from '@solana/kit-plugin-rpc';
  * import { payerOrGeneratedPayer } from '@solana/kit-plugin-payer';
  *
  * // With an explicit payer.
  * const client = await createClient().use(payerOrGeneratedPayer(mySigner));
  *
  * // Without a payer — generates one and airdrops 100 SOL.
  * const client = await createClient()
- *     .use(localhostRpc())
+ *     .use(solanaRpcConnection('http://127.0.0.1:8899'))
+ *     .use(solanaRpcSubscriptionsConnection('ws://127.0.0.1:8900'))
  *     .use(rpcAirdrop())
  *     .use(payerOrGeneratedPayer(undefined));
  * ```

diff --git a/packages/kit-plugin-rpc/README.md b/packages/kit-plugin-rpc/README.md
@@ -15,39 +15,70 @@ This package provides plugins that add RPC functionality to your Kit clients.
 pnpm install @solana/kit-plugin-rpc
 ```
 
-## `rpc` plugin
+## `rpcConnection` plugin
 
-The RPC plugin adds `rpc` and `rpcSubscriptions` objects to your Kit client, allowing you to call RPC methods and subscribe to RPC notifications.
+The `rpcConnection` plugin sets a provided `Rpc` instance on the client. This is the generic variant that works with any RPC API.
 
 ### Installation
 
-To use the `rpc` plugin, you must provide the URL of your desired Solana RPC endpoint.
+```ts
+import { createClient, createSolanaRpc } from '@solana/kit';
+import { rpcConnection } from '@solana/kit-plugin-rpc';
+
+const myRpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
+const client = createClient().use(rpcConnection(myRpc));
+```
+
+### Features
+
+- `rpc`: Call any RPC method using type-safe methods.
+    ```ts
+    const { value: latestBlockhash } = await client.rpc.getLatestBlockhash().send();
+    ```
+
+## `rpcSubscriptionsConnection` plugin
+
+The `rpcSubscriptionsConnection` plugin sets a provided `RpcSubscriptions` instance on the client. This is the generic variant that works with any RPC Subscriptions API.
+
+### Installation
 
 ```ts
-import { createClient } from '@solana/kit';
-import { rpc } from '@solana/kit-plugin-rpc';
+import { createClient, createSolanaRpcSubscriptions } from '@solana/kit';
+import { rpcSubscriptionsConnection } from '@solana/kit-plugin-rpc';
 
-const client = createClient().use(rpc('https://api.mainnet-beta.solana.com'));
+const myRpcSubscriptions = createSolanaRpcSubscriptions('wss://api.mainnet-beta.solana.com');
+const client = createClient().use(rpcSubscriptionsConnection(myRpcSubscriptions));
 ```
 
-Note that you may wrap your RPC URL using the `mainnet`, `devnet`, or `testnet` helpers from `@solana/kit`. When you do, the returned RPC API will be adjusted to match the selected cluster since some RPC features are not available on all clusters.
+### Features
+
+- `rpcSubscriptions`: Subscribe to RPC notifications using async iterators.
+    ```ts
+    const slotNotifications = await client.rpcSubscriptions.slotNotifications({ commitment: 'confirmed' }).subscribe();
+    for await (const slotNotification of slotNotifications) {
+        console.log('Got a slot notification', slotNotification);
+    }
+    ```
+
+## `solanaRpcConnection` plugin
+
+The `solanaRpcConnection` plugin creates a Solana RPC from a cluster URL and sets it on the client.
+
+### Installation
 
 ```ts
-import { mainnet } from '@solana/kit';
+import { createClient } from '@solana/kit';
+import { solanaRpcConnection } from '@solana/kit-plugin-rpc';
 
-const client = createClient().use(rpc(mainnet('https://api.mainnet-beta.solana.com')));
+const client = createClient().use(solanaRpcConnection('https://api.mainnet-beta.solana.com'));
 ```
 
-By default, the WebSocket URL is derived from the RPC's HTTP URL but you may configure it explicitly using the second parameter. This config object can also be used to customize other aspects of RPC Subscriptions behavior.
+You may wrap your RPC URL using the `mainnet`, `devnet`, or `testnet` helpers from `@solana/kit`. When you do, the returned RPC API will be adjusted to match the selected cluster since some RPC features are not available on all clusters.
 
 ```ts
-const client = createClient().use(
-    rpc('https://my-rpc-url.com', {
-        url: 'wss://my-rpc-ws-url.com',
-        minChannels: 5,
-        maxSubscriptionsPerChannel: 50,
-    }),
-);
+import { mainnet } from '@solana/kit';
+
+const client = createClient().use(solanaRpcConnection(mainnet('https://api.mainnet-beta.solana.com')));
 ```
 
 ### Features
@@ -56,30 +87,29 @@ const client = createClient().use(
     ```ts
     const { value: latestBlockhash } = await client.rpc.getLatestBlockhash().send();
     ```
-- `rpcSubscriptions`: Subscribe to Solana RPC notifications using async iterators.
-    ```ts
-    const slotNotifications = await client.rpcSubscriptions.slotNotifications({ commitment: 'confirmed' }).subscribe();
-    for await (const slotNotification of slotNotifications) {
-        console.log('Got a slot notification', slotNotification);
-    }
-    ```
 
-## `localhostRpc` plugin
+## `solanaRpcSubscriptionsConnection` plugin
 
-This plugin is an alias for the `rpc` plugin pre-configured to connect to a local Solana validator.
+The `solanaRpcSubscriptionsConnection` plugin creates Solana RPC Subscriptions from a cluster URL and sets them on the client.
 
 ### Installation
 
 ```ts
 import { createClient } from '@solana/kit';
-import { localhostRpc } from '@solana/kit-plugin-rpc';
+import { solanaRpcSubscriptionsConnection } from '@solana/kit-plugin-rpc';
 
-const client = createClient().use(localhostRpc());
+const client = createClient().use(solanaRpcSubscriptionsConnection('wss://api.mainnet-beta.solana.com'));
 ```
 
 ### Features
 
-_See the `rpc` plugin for available features_.
+- `rpcSubscriptions`: Subscribe to Solana RPC notifications using async iterators.
+    ```ts
+    const slotNotifications = await client.rpcSubscriptions.slotNotifications({ commitment: 'confirmed' }).subscribe();
+    for await (const slotNotification of slotNotifications) {
+        console.log('Got a slot notification', slotNotification);
+    }
+    ```
 
 ## `rpcAirdrop` plugin
 
@@ -94,9 +124,12 @@ The client must have `rpc` and `rpcSubscriptions` installed before applying this
 
 ```ts
 import { createClient } from '@solana/kit';
-import { localhostRpc, rpcAirdrop } from '@solana/kit-plugin-rpc';
+import { solanaRpcConnection, solanaRpcSubscriptionsConnection, rpcAirdrop } from '@solana/kit-plugin-rpc';
 
-const client = createClient().use(localhostRpc()).use(rpcAirdrop());
+const client = createClient()
+    .use(solanaRpcConnection('http://127.0.0.1:8899'))
+    .use(solanaRpcSubscriptionsConnection('ws://127.0.0.1:8900'))
+    .use(rpcAirdrop());
 ```
 
 ### Features
@@ -116,9 +149,11 @@ The client must have `rpc` installed before applying this plugin.
 
 ```ts
 import { createClient } from '@solana/kit';
-import { rpc, rpcGetMinimumBalance } from '@solana/kit-plugin-rpc';
+import { solanaRpcConnection, rpcGetMinimumBalance } from '@solana/kit-plugin-rpc';
 
-const client = createClient().use(rpc('https://api.mainnet-beta.solana.com')).use(rpcGetMinimumBalance());
+const client = createClient()
+    .use(solanaRpcConnection('https://api.mainnet-beta.solana.com'))
+    .use(rpcGetMinimumBalance());
 ```
 
 ### Features
@@ -143,11 +178,17 @@ This plugin requires a payer to be set on the client or passed as an option.
 
 ```ts
 import { createClient } from '@solana/kit';
-import { rpc, rpcTransactionPlanner, rpcTransactionPlanExecutor } from '@solana/kit-plugin-rpc';
+import {
+    solanaRpcConnection,
+    solanaRpcSubscriptionsConnection,
+    rpcTransactionPlanner,
+    rpcTransactionPlanExecutor,
+} from '@solana/kit-plugin-rpc';
 import { generatedPayer } from '@solana/kit-plugin-payer';
 
 const client = await createClient()
-    .use(rpc('https://api.mainnet-beta.solana.com'))
+    .use(solanaRpcConnection('https://api.mainnet-beta.solana.com'))
+    .use(solanaRpcSubscriptionsConnection('wss://api.mainnet-beta.solana.com'))
     .use(generatedPayer())
     .use(rpcTransactionPlanner())
     .use(rpcTransactionPlanExecutor());
@@ -175,11 +216,17 @@ This plugin requires `rpc` and `rpcSubscriptions` to be configured on the client
 
 ```ts
 import { createClient } from '@solana/kit';
-import { rpc, rpcTransactionPlanner, rpcTransactionPlanExecutor } from '@solana/kit-plugin-rpc';
+import {
+    solanaRpcConnection,
+    solanaRpcSubscriptionsConnection,
+    rpcTransactionPlanner,
+    rpcTransactionPlanExecutor,
+} from '@solana/kit-plugin-rpc';
 import { generatedPayer } from '@solana/kit-plugin-payer';
 
 const client = await createClient()
-    .use(rpc('https://api.mainnet-beta.solana.com'))
+    .use(solanaRpcConnection('https://api.mainnet-beta.solana.com'))
+    .use(solanaRpcSubscriptionsConnection('wss://api.mainnet-beta.solana.com'))
     .use(generatedPayer())
     .use(rpcTransactionPlanner())
     .use(rpcTransactionPlanExecutor());

diff --git a/packages/kit-plugin-rpc/src/airdrop.ts b/packages/kit-plugin-rpc/src/airdrop.ts
@@ -10,24 +10,25 @@ type RpcClient = {
  * RPC and RPC Subscriptions transports.
  *
  * The client must already have `rpc` and `rpcSubscriptions` installed
- * (e.g. via the {@link rpc} or {@link localhostRpc} plugins). A
- * TypeScript error is raised when a mainnet RPC is used because
+ * (e.g. via {@link solanaRpcConnection} and {@link solanaRpcSubscriptionsConnection}).
+ * A TypeScript error is raised when a mainnet RPC is used because
  * airdrop methods are not available on mainnet.
  *
  * @example
  * ```ts
  * import { createClient } from '@solana/kit';
- * import { localhostRpc, rpcAirdrop } from '@solana/kit-plugin-rpc';
+ * import { solanaRpcConnection, solanaRpcSubscriptionsConnection, rpcAirdrop } from '@solana/kit-plugin-rpc';
  *
  * const client = createClient()
- *     .use(localhostRpc())
+ *     .use(solanaRpcConnection('http://127.0.0.1:8899'))
+ *     .use(solanaRpcSubscriptionsConnection('ws://127.0.0.1:8900'))
  *     .use(rpcAirdrop());
  *
  * await client.airdrop(myAddress, lamports(1_000_000_000n));
  * ```
  *
- * @see {@link rpc}
- * @see {@link localhostRpc}
+ * @see {@link solanaRpcConnection}
+ * @see {@link solanaRpcSubscriptionsConnection}
  */
 export function rpcAirdrop() {
     return <T extends RpcClient>(client: T) => {

diff --git a/packages/kit-plugin-rpc/src/get-minimum-balance.ts b/packages/kit-plugin-rpc/src/get-minimum-balance.ts
@@ -12,23 +12,21 @@ import {
  * A plugin that adds a `getMinimumBalance` method to the client using
  * the `getMinimumBalanceForRentExemption` RPC method.
  *
- * The client must already have `rpc` installed (e.g. via the {@link rpc}
- * or {@link localhostRpc} plugins).
+ * The client must already have `rpc` installed (e.g. via {@link solanaRpcConnection}).
  *
  * @example
  * ```ts
  * import { createClient } from '@solana/kit';
- * import { rpc, rpcGetMinimumBalance } from '@solana/kit-plugin-rpc';
+ * import { solanaRpcConnection, rpcGetMinimumBalance } from '@solana/kit-plugin-rpc';
  *
  * const client = createClient()
- *     .use(rpc('https://api.mainnet-beta.solana.com'))
+ *     .use(solanaRpcConnection('https://api.mainnet-beta.solana.com'))
  *     .use(rpcGetMinimumBalance());
  *
  * const balance = await client.getMinimumBalance(100);
  * ```
  *
- * @see {@link rpc}
- * @see {@link localhostRpc}
+ * @see {@link solanaRpcConnection}
  */
 export function rpcGetMinimumBalance() {
     return <T extends ClientWithRpc<GetMinimumBalanceForRentExemptionApi>>(client: T) => {

diff --git a/packages/kit-plugin-rpc/src/index.ts b/packages/kit-plugin-rpc/src/index.ts
@@ -1,5 +1,6 @@
 export * from './airdrop';
 export * from './get-minimum-balance';
 export * from './rpc';
+export * from './solana-rpc';
 export * from './transaction-plan-executor';
 export * from './transaction-planner';