Add granular RPC connection plugins and deprecate rpc/localhostRpc

[lorisleiva]

This PR introduces four new granular plugins for setting up RPC and RPC Subscriptions connections independently: rpcConnection, rpcSubscriptionsConnection, solanaRpcConnection, and solanaRpcSubscriptionsConnection. The existing rpc and localhostRpc plugins, which inject both RPC and RPC Subscriptions in one go, are deprecated in favor of the new alternatives. Docblocks with migration snippets are included on the deprecated functions.

[changeset-bot]

🦋 Changeset detected

Latest commit: 6ffdfe5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@solana/kit-plugin-rpc	Minor
@solana/kit-client-rpc	Minor
@solana/kit-plugins	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[lorisleiva]

• Deprecate kit-plugin-payer in favor of kit-plugin-signer #190
• Add kit-plugin-signer package with payer and identity plugins #189
• Deprecate client packages in favor of all-in-one plugins #188
• Add all-in-one litesvm plugin #187
• Rename litesvm plugin to litesvmConnection #186
• Add all-in-one Solana RPC plugins #185
• Add granular RPC connection plugins and deprecate rpc/localhostRpc #184 👈 (View in Graphite)
• Bump @solana/kit peer dependency to ^6.8.0 #183 : 1 other dependent PR (#173 )
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[lorisleiva]

@trevor-cortex

[trevor-cortex]

Summary

This PR introduces four new granular plugins — rpcConnection, rpcSubscriptionsConnection, solanaRpcConnection, and solanaRpcSubscriptionsConnection — that let users set up RPC and RPC Subscriptions connections independently. The existing rpc and localhostRpc plugins are deprecated (with migration snippets in their docblocks) and moved to the new solana-rpc.ts file alongside the Solana-specific convenience plugins. All docs, examples, and tests are updated to use the new API.

Clean separation of concerns: rpc.ts now holds the generic plugins (accept any Rpc/RpcSubscriptions instance), while solana-rpc.ts holds the Solana-specific URL-based helpers and the deprecated functions. Nice layering with the solana* variants delegating to the generic ones.

LGTM — this is a well-structured change. One minor nit inline.

Things to watch out for

1. Unused import — extendClient is imported in solana-rpc.ts but never used there (the deprecated functions use it, but they could also delegate to the generic plugins like the new functions do). Not a big deal since the deprecated code is a direct move, but it's a minor cleanup opportunity.

2. Re-export collision — Both rpc.ts and solana-rpc.ts are re-exported via index.ts. Since rpc.ts no longer exports rpc or localhostRpc, and those now live in solana-rpc.ts, there's no name collision. Just worth verifying this stays clean.

3. Tests for deprecated functions removed — The old rpc and localhostRpc tests were replaced with tests for the new plugins. There are no remaining tests for the deprecated functions themselves. This is probably fine since they're just moved code, but a reviewer might want to consider whether a smoke test for backwards compat is worth keeping.

Notes for subsequent reviewers

• The deprecated rpc() function in solana-rpc.ts still does its own createSolanaRpc + createSolanaRpcSubscriptions + extendClient inline rather than delegating to solanaRpcConnection/solanaRpcSubscriptionsConnection. This is intentional to preserve exact behavior (single .use() call installing both), but worth noting.
• Docs and examples are comprehensive and consistently updated across all packages.
• The changeset correctly marks this as a minor for @solana/kit-plugin-rpc.

[mcintyre94]

The new plugins look correct, but I'm a bit unclear why we're changing this as part of the current changes. Bundling RPC and subscriptions with a default transform from one URL to the other that works for most cases seemed reasonable to me.

Edit: I see the upstack PR adds a plugin that combines them and that logic moves there, works for me!

[lorisleiva]

Merge activity

• Apr 14, 5:32 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Apr 14, 5:33 PM UTC: Graphite rebased this pull request as part of a merge.
• Apr 14, 5:34 PM UTC: @lorisleiva merged this pull request with Graphite.