docs(cookbook): use explicit solanaRpc URLs in kit examples

Replace solanaLocalRpc() with solanaRpc({ rpcUrl, rpcSubscriptionsUrl })
+ rpcAirdrop() across all 8 cookbook kit examples so readers can swap
the localhost URL for a surfnet (or any other endpoint) without changing
imports or call shape.

Author: amilz

packages/docs-examples/cookbook/accounts/create-account/kit.ts

@@ -1,6 +1,6 @@
 // #region create
 import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import {
   getCreateAccountInstruction,
@@ -12,7 +12,13 @@ const LAMPORTS_PER_SOL = 1_000_000_000n;
 
 const client = await createClient()
   .use(payer(sender))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(LAMPORTS_PER_SOL)));
 
 const newAccount = await generateKeyPairSigner();

packages/docs-examples/cookbook/tokens/create-token-with-metadata/kit.ts

@@ -1,6 +1,6 @@
 // #region create
 import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer as kitPayer } from "@solana/kit-plugin-signer";
 import {
   getCreateV1InstructionAsync,
@@ -13,7 +13,13 @@ const mint = await generateKeyPairSigner();
 
 const client = await createClient()
   .use(kitPayer(payer))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(1_000_000_000n)));
 
 // Create token with metadata

packages/docs-examples/cookbook/transactions/add-memo/kit.ts

@@ -1,6 +1,6 @@
 // #region memo
 import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import { getAddMemoInstruction } from "@solana-program/memo";
 
@@ -9,7 +9,13 @@ const LAMPORTS_PER_SOL = 1_000_000_000n;
 
 const client = await createClient()
   .use(payer(sender))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(LAMPORTS_PER_SOL)));
 
 const memoInstruction = getAddMemoInstruction({

packages/docs-examples/cookbook/transactions/add-priority-fees/kit.ts

@@ -5,7 +5,7 @@ import {
   lamports,
   type MicroLamports,
 } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import { getAddMemoInstruction } from "@solana-program/memo";
 
@@ -18,13 +18,16 @@ const keypairSigner = await generateKeyPairSigner();
 const client = await createClient()
   .use(payer(keypairSigner))
   .use(
-    solanaLocalRpc({
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
       transactionConfig: {
         microLamportsPerComputeUnit: 5000n as MicroLamports,
         version: "legacy",
       },
     }),
   )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(1_000_000_000n)));
 
 const memoInstruction = getAddMemoInstruction({ memo: "Hello, world!" });

packages/docs-examples/cookbook/transactions/calculate-cost/kit.ts

@@ -19,7 +19,7 @@ import {
   signTransactionMessageWithSigners,
   type TransactionMessageBytesBase64,
 } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import {
   getSetComputeUnitLimitInstruction,
@@ -31,7 +31,13 @@ import { getAddMemoInstruction } from "@solana-program/memo";
 const signer = await generateKeyPairSigner();
 const client = await createClient()
   .use(payer(signer))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(1_000_000_000n)));
 console.log("Create and fund account with address", signer.address);
 

packages/docs-examples/cookbook/transactions/fee-sponsorship/kit.ts

@@ -1,6 +1,6 @@
 // #region sponsor
 import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import {
   fetchToken,
@@ -23,7 +23,13 @@ console.log("Mint Address:", mint.address);
 // Build a Kit client: fee payer (funded with 1 SOL), local RPC, and the token program plugin
 const client = await createClient()
   .use(payer(feePayer))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(1_000_000_000n)))
   .use(tokenProgram());
 

packages/docs-examples/cookbook/transactions/mev-protection/kit.ts

@@ -16,7 +16,7 @@ import {
   type Address,
   type Instruction,
 } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import { getTransferSolInstruction } from "@solana-program/system";
 
@@ -65,7 +65,13 @@ const signer = await generateKeyPairSigner();
 const recipient = await generateKeyPairSigner();
 const client = await createClient()
   .use(payer(signer))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(1_000_000_000n)));
 
 // Build a transfer with dontfront protection

packages/docs-examples/cookbook/transactions/send-sol/kit.ts

@@ -1,6 +1,6 @@
 // #region transfer
 import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
-import { solanaLocalRpc } from "@solana/kit-plugin-rpc";
+import { rpcAirdrop, solanaRpc } from "@solana/kit-plugin-rpc";
 import { airdropPayer, payer } from "@solana/kit-plugin-signer";
 import { getTransferSolInstruction } from "@solana-program/system";
 
@@ -12,7 +12,13 @@ const transferAmount = lamports(LAMPORTS_PER_SOL / 100n); // 0.01 SOL
 
 const client = await createClient()
   .use(payer(sender))
-  .use(solanaLocalRpc())
+  .use(
+    solanaRpc({
+      rpcUrl: "http://localhost:8899",
+      rpcSubscriptionsUrl: "ws://localhost:8900",
+    }),
+  )
+  .use(rpcAirdrop())
   .use(airdropPayer(lamports(LAMPORTS_PER_SOL)));
 
 const transferInstruction = getTransferSolInstruction({