@vue-solana/vue 2.1.0 → 2.2.0

package/README.md

@@ -164,6 +164,22 @@ const { balance, loading, error, refresh } = useBalance(address);
 </template>
 ```
 
+### Airdrop on Test Networks
+
+`useAirdrop()` sends SOL to an account on devnet, testnet, or a local validator. It requires an airdrop capability on the Kit client, installed with `createClient().use(solanaRpcConnection({ ... })).use(rpcAirdrop())` from `@solana/kit-plugin-rpc`.
+
+```ts
+import { lamports } from "@solana/kit";
+import { useAirdrop } from "@vue-solana/vue/useAirdrop";
+
+const { data, status, error, dispatch } = useAirdrop();
+await dispatch(address, lamports(1_000_000_000)); // 1 SOL
+```
+
+Each `dispatch(address, amount)` runs a fresh airdrop and aborts the previous in-flight call. `data` resolves to the transaction `Signature`, or to `undefined` when the network applies the airdrop without a transaction (some local validators, e.g. LiteSVM).
+
+Airdrops to a single address are rate-limited (public devnets commonly return HTTP 429, and 1 SOL requires enough devnet balance); wait before dispatching again or use a fresh address. Errors surface through `error` / the `error` state.
+
 ## Read Account Data
 
 ```ts
@@ -341,6 +357,39 @@ import { useRequestSwr } from "@vue-solana/vue/swr";
 const balance = useRequestSwr(["balance", address], () => client.rpc.getBalance(address).send());
 ```
 
+### Cancellation & Timeouts
+
+`useRequest()`, `useSubscription()`, and `useTrackedData()` accept a `getAbortSignal` option — a factory called once per attempt (request) or connection (subscription/tracked data). It is the natural place for a timeout:
+
+```ts
+const { data, refresh } = useRequest(source, {
+  getAbortSignal: (attempt) => AbortSignal.timeout(10_000),
+});
+
+await refresh({ abortSignal: AbortSignal.timeout(2_000) });
+```
+
+The factory is read fresh from the latest render on every attempt, so inline closures work without `useCallback`-style wrapping. Each manual refresh or reconnect can instead pass a single `{ abortSignal }` override that replaces the factory for that attempt; pass `AbortSignal` explicitly as `undefined` to skip caller cancellation entirely. Aborting the composed signal fails only that attempt — previous `data` is kept and `status` drops back to `error`.
+
+To kill the data hook entirely, set its source to `null` (status becomes `disabled` and in-flight work is cancelled) or unmount the component that owns it.
+
+### Actions with `useAction`
+
+`useAction()` and its derivatives (`useAirdrop()`, `useSignAndSendTransaction()` themes) manage one async action at a time:
+
+```ts
+const { data, status, error, dispatch } = useAction(async (signal, input) => {
+  /* ... */
+});
+
+dispatch(inputA); // runs
+await dispatch(inputB); // aborts dispatch(inputA) before starting
+```
+
+- `useAction` keeps the handler in a ref — every `dispatch` runs the latest closure, so there is no deps array to keep in sync. In-flight calls keep running with the closure they started with.
+- `dispatch` returns a `Promise<TResult>`. If a newer dispatch supersedes it, the older promise rejects with an abort error; awaiters should treat that as "superseded", not a failure, and fresh awaits win.
+- Calling `dispatch` again aborts the prior in-flight call with a fresh `AbortSignal`, and resets state to `idle` before the new run starts.
+
 ### Sign In With Solana
 
 `useSignIn()` triggers the SIWS flow when the connected wallet supports the `solana:signIn` feature:
@@ -420,6 +469,7 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 | `useWallets()`                                                                             | Returns discovered browser extension wallets, Android MWA wallets, iOS browser wallet links, and wallet selection actions. |
 | `useSignMessage()`                                                                         | Signs arbitrary message bytes through the connected wallet when message signing is supported.                              |
 | `useBalance(address, commitment?)`                                                         | Loads lamport balance for an address string.                                                                               |
+| `useAirdrop()`                                                                             | Airdrops SOL on devnet/testnet/localnets; `data` is the `Signature`, or `undefined` when applied directly.                 |
 | `useAccountInfo(address, options?)`                                                        | Loads normalized account info (executable, lamports, owner, space, data bytes).                                            |
 | `useProgramAccounts(programId, config?)`                                                   | Loads accounts owned by a program with optional filters, commitment, and `dataSlice`.                                      |
 | `useTransaction(handler, options?)`                                                        | Generic async transaction state helper with optional timeout settings.                                                     |
@@ -452,6 +502,7 @@ Direct composable subpaths:
 - `@vue-solana/vue/useRpc`
 - `@vue-solana/vue/useConnection`
 - `@vue-solana/vue/useAccountInfo`
+- `@vue-solana/vue/useAirdrop`
 - `@vue-solana/vue/useBalance`
 - `@vue-solana/vue/useProgramAccounts`
 - `@vue-solana/vue/useWallet`

package/dist/index.cjs

@@ -2,13 +2,14 @@
 
 const useAccountInfo = require('./shared/vue.D-qi8PSL.cjs');
 const useAction = require('./shared/vue.CoaIWGPT.cjs');
+const useAirdrop = require('./shared/vue.CTqPbvz3.cjs');
 const useBalance = require('./shared/vue.E_npPFoV.cjs');
 const useClientCapability = require('./shared/vue.BY0qpgYr.cjs');
 const useConnection = require('./shared/vue.BVaMoz9y.cjs');
 const usePlanTransaction = require('./shared/vue.B4-LEdSE.cjs');
 const useProgramAccounts = require('./shared/vue.Di7yjJ-R.cjs');
 const usePayer = require('./shared/vue.g8fnm_ca.cjs');
-const useRequest = require('./shared/vue.B8pLQ8P4.cjs');
+const useRequest = require('./shared/vue.ZuUCEEab.cjs');
 const useRpc = require('./shared/vue.FiMmnMHr.cjs');
 const SelectedWalletAccountProvider = require('./shared/vue.DDbVk0Zh.cjs');
 const useSignMessage = require('./shared/vue.B6ainw2G.cjs');
@@ -19,10 +20,10 @@ const useSignatureStatus = require('./shared/vue.CIs8QhCw.cjs');
 const useSignIn = require('./shared/vue.9TPxZPMf.cjs');
 const useSolana = require('./shared/vue.DE3emjSF.cjs');
 const useSolanaClient = require('./shared/vue.BIxphCAq.cjs');
-const useSubscription = require('./shared/vue.BVj9lWBK.cjs');
+const useSubscription = require('./shared/vue.l3UCdN7z.cjs');
 const useTokenAccounts = require('./shared/vue.Bwd1sGAM.cjs');
 const useTokenBalance = require('./shared/vue.DAg5wC1G.cjs');
-const useTrackedData = require('./shared/vue.DtCbCcPd.cjs');
+const useTrackedData = require('./shared/vue.DxM45azl.cjs');
 const useTransaction = require('./shared/vue.Bk5xjlUx.cjs');
 const useTransactionConfirmation = require('./shared/vue.Sbbm9JSu.cjs');
 const useWallet = require('./shared/vue.BGxz4dru.cjs');
@@ -386,6 +387,7 @@ const VueSolana = createSolanaPlugin;
 
 exports.useAccountInfo = useAccountInfo.useAccountInfo;
 exports.useAction = useAction.useAction;
+exports.useAirdrop = useAirdrop.useAirdrop;
 exports.useBalance = useBalance.useBalance;
 exports.MissingClientCapabilityError = useClientCapability.MissingClientCapabilityError;
 exports.useClientCapability = useClientCapability.useClientCapability;

package/dist/index.d.cts

@@ -1,12 +1,13 @@
 export { AccountInfo, UseAccountInfoOptions, useAccountInfo } from './useAccountInfo.cjs';
 export { UseActionOptions, UseActionReturn, UseActionStatus, useAction } from './useAction.cjs';
+export { useAirdrop } from './useAirdrop.cjs';
 export { BalanceInput, useBalance } from './useBalance.cjs';
 export { MissingClientCapabilityError, UseClientCapabilityOptions, useClientCapability } from './useClientCapability.cjs';
 export { useConnection } from './useConnection.cjs';
 export { PlanTransactionConfig, PlanTransactionStatus, usePlanTransaction, usePlanTransactions } from './usePlanTransaction.cjs';
 export { ProgramAccount, ProgramAccountDataSizeFilter, ProgramAccountDataSlice, ProgramAccountFilter, ProgramAccountMemcmpEncoding, ProgramAccountMemcmpFilter, UseProgramAccountsOptions, useProgramAccounts } from './useProgramAccounts.cjs';
 export { useIdentity, usePayer } from './usePayer.cjs';
-export { UseRequestOptions, UseRequestReturn, UseRequestSource, UseRequestStatus, useRequest } from './useRequest.cjs';
+export { UseRequestOptions, UseRequestRefresherOptions, UseRequestReturn, UseRequestSource, UseRequestStatus, useRequest } from './useRequest.cjs';
 export { useRpc } from './useRpc.cjs';
 export { SelectedWalletAccount, SelectedWalletAccountContext, SelectedWalletAccountOptions, SelectedWalletAccountProvider, WalletAccountFilter, createSelectedWalletAccountContext, provideSelectedWalletAccount, selectedWalletAccountInjectionKey, useSelectedWalletAccount } from './useSelectedWalletAccount.cjs';
 export { SignMessageStatus, useSignMessage } from './useSignMessage.cjs';
@@ -17,10 +18,10 @@ export { SignatureStatus, UseSignatureStatusOptions, useSignatureStatus } from '
 export { SignInStatus, useSignIn } from './useSignIn.cjs';
 export { tryUseSolana, useSolana } from './useSolana.cjs';
 export { useSolanaClient } from './useSolanaClient.cjs';
-export { UseSubscriptionOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus, useSubscription } from './useSubscription.cjs';
+export { UseSubscriptionOptions, UseSubscriptionReconnectOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus, useSubscription } from './useSubscription.cjs';
 export { UseTokenAccountsOptions, useTokenAccounts } from './useTokenAccounts.cjs';
 export { useTokenBalance } from './useTokenBalance.cjs';
-export { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource, useTrackedData } from './useTrackedData.cjs';
+export { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataRefresherOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource, useTrackedData } from './useTrackedData.cjs';
 export { UseTransactionOptions, useTransaction } from './useTransaction.cjs';
 export { TransactionConfirmationStatus, getConfirmedTransactionStatus, useTransactionConfirmation } from './useTransactionConfirmation.cjs';
 export { useWallet } from './useWallet.cjs';

package/dist/index.d.mts

@@ -1,12 +1,13 @@
 export { AccountInfo, UseAccountInfoOptions, useAccountInfo } from './useAccountInfo.mjs';
 export { UseActionOptions, UseActionReturn, UseActionStatus, useAction } from './useAction.mjs';
+export { useAirdrop } from './useAirdrop.mjs';
 export { BalanceInput, useBalance } from './useBalance.mjs';
 export { MissingClientCapabilityError, UseClientCapabilityOptions, useClientCapability } from './useClientCapability.mjs';
 export { useConnection } from './useConnection.mjs';
 export { PlanTransactionConfig, PlanTransactionStatus, usePlanTransaction, usePlanTransactions } from './usePlanTransaction.mjs';
 export { ProgramAccount, ProgramAccountDataSizeFilter, ProgramAccountDataSlice, ProgramAccountFilter, ProgramAccountMemcmpEncoding, ProgramAccountMemcmpFilter, UseProgramAccountsOptions, useProgramAccounts } from './useProgramAccounts.mjs';
 export { useIdentity, usePayer } from './usePayer.mjs';
-export { UseRequestOptions, UseRequestReturn, UseRequestSource, UseRequestStatus, useRequest } from './useRequest.mjs';
+export { UseRequestOptions, UseRequestRefresherOptions, UseRequestReturn, UseRequestSource, UseRequestStatus, useRequest } from './useRequest.mjs';
 export { useRpc } from './useRpc.mjs';
 export { SelectedWalletAccount, SelectedWalletAccountContext, SelectedWalletAccountOptions, SelectedWalletAccountProvider, WalletAccountFilter, createSelectedWalletAccountContext, provideSelectedWalletAccount, selectedWalletAccountInjectionKey, useSelectedWalletAccount } from './useSelectedWalletAccount.mjs';
 export { SignMessageStatus, useSignMessage } from './useSignMessage.mjs';
@@ -17,10 +18,10 @@ export { SignatureStatus, UseSignatureStatusOptions, useSignatureStatus } from '
 export { SignInStatus, useSignIn } from './useSignIn.mjs';
 export { tryUseSolana, useSolana } from './useSolana.mjs';
 export { useSolanaClient } from './useSolanaClient.mjs';
-export { UseSubscriptionOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus, useSubscription } from './useSubscription.mjs';
+export { UseSubscriptionOptions, UseSubscriptionReconnectOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus, useSubscription } from './useSubscription.mjs';
 export { UseTokenAccountsOptions, useTokenAccounts } from './useTokenAccounts.mjs';
 export { useTokenBalance } from './useTokenBalance.mjs';
-export { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource, useTrackedData } from './useTrackedData.mjs';
+export { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataRefresherOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource, useTrackedData } from './useTrackedData.mjs';
 export { UseTransactionOptions, useTransaction } from './useTransaction.mjs';
 export { TransactionConfirmationStatus, getConfirmedTransactionStatus, useTransactionConfirmation } from './useTransactionConfirmation.mjs';
 export { useWallet } from './useWallet.mjs';

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 export { AccountInfo, UseAccountInfoOptions, useAccountInfo } from './useAccountInfo.js';
 export { UseActionOptions, UseActionReturn, UseActionStatus, useAction } from './useAction.js';
+export { useAirdrop } from './useAirdrop.js';
 export { BalanceInput, useBalance } from './useBalance.js';
 export { MissingClientCapabilityError, UseClientCapabilityOptions, useClientCapability } from './useClientCapability.js';
 export { useConnection } from './useConnection.js';
 export { PlanTransactionConfig, PlanTransactionStatus, usePlanTransaction, usePlanTransactions } from './usePlanTransaction.js';
 export { ProgramAccount, ProgramAccountDataSizeFilter, ProgramAccountDataSlice, ProgramAccountFilter, ProgramAccountMemcmpEncoding, ProgramAccountMemcmpFilter, UseProgramAccountsOptions, useProgramAccounts } from './useProgramAccounts.js';
 export { useIdentity, usePayer } from './usePayer.js';
-export { UseRequestOptions, UseRequestReturn, UseRequestSource, UseRequestStatus, useRequest } from './useRequest.js';
+export { UseRequestOptions, UseRequestRefresherOptions, UseRequestReturn, UseRequestSource, UseRequestStatus, useRequest } from './useRequest.js';
 export { useRpc } from './useRpc.js';
 export { SelectedWalletAccount, SelectedWalletAccountContext, SelectedWalletAccountOptions, SelectedWalletAccountProvider, WalletAccountFilter, createSelectedWalletAccountContext, provideSelectedWalletAccount, selectedWalletAccountInjectionKey, useSelectedWalletAccount } from './useSelectedWalletAccount.js';
 export { SignMessageStatus, useSignMessage } from './useSignMessage.js';
@@ -17,10 +18,10 @@ export { SignatureStatus, UseSignatureStatusOptions, useSignatureStatus } from '
 export { SignInStatus, useSignIn } from './useSignIn.js';
 export { tryUseSolana, useSolana } from './useSolana.js';
 export { useSolanaClient } from './useSolanaClient.js';
-export { UseSubscriptionOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus, useSubscription } from './useSubscription.js';
+export { UseSubscriptionOptions, UseSubscriptionReconnectOptions, UseSubscriptionReturn, UseSubscriptionSource, UseSubscriptionStatus, useSubscription } from './useSubscription.js';
 export { UseTokenAccountsOptions, useTokenAccounts } from './useTokenAccounts.js';
 export { useTokenBalance } from './useTokenBalance.js';
-export { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource, useTrackedData } from './useTrackedData.js';
+export { UseTrackedDataInitialSource, UseTrackedDataOptions, UseTrackedDataRefresherOptions, UseTrackedDataReturn, UseTrackedDataSource, UseTrackedDataStatus, UseTrackedDataStreamSource, useTrackedData } from './useTrackedData.js';
 export { UseTransactionOptions, useTransaction } from './useTransaction.js';
 export { TransactionConfirmationStatus, getConfirmedTransactionStatus, useTransactionConfirmation } from './useTransactionConfirmation.js';
 export { useWallet } from './useWallet.js';

package/dist/index.mjs

@@ -1,12 +1,13 @@
 export { u as useAccountInfo } from './shared/vue.BQRpjwKl.mjs';
 export { u as useAction } from './shared/vue.DYk0Xfr3.mjs';
+export { u as useAirdrop } from './shared/vue.BSfiHqwj.mjs';
 export { u as useBalance } from './shared/vue.BINkrA8h.mjs';
 export { M as MissingClientCapabilityError, u as useClientCapability } from './shared/vue.B8LptjZP.mjs';
 export { u as useConnection } from './shared/vue.CpkwC8Th.mjs';
 export { u as usePlanTransaction, a as usePlanTransactions } from './shared/vue.C5FVoEZT.mjs';
 export { u as useProgramAccounts } from './shared/vue.C13umiQi.mjs';
 export { u as useIdentity, a as usePayer } from './shared/vue.CATOh_9G.mjs';
-export { u as useRequest } from './shared/vue.DImwKTwJ.mjs';
+export { u as useRequest } from './shared/vue.B8VvC8d2.mjs';
 export { u as useRpc } from './shared/vue.BsGwt78R.mjs';
 export { S as SelectedWalletAccountProvider, c as createSelectedWalletAccountContext, p as provideSelectedWalletAccount, s as selectedWalletAccountInjectionKey, u as useSelectedWalletAccount } from './shared/vue.DXQVIRZA.mjs';
 export { u as useSignMessage } from './shared/vue.JUWqu6kD.mjs';
@@ -17,10 +18,10 @@ export { u as useSignatureStatus } from './shared/vue.CXB4NEMA.mjs';
 export { u as useSignIn } from './shared/vue.ByxbBC3y.mjs';
 export { t as tryUseSolana, u as useSolana } from './shared/vue.CQh3AUE8.mjs';
 export { u as useSolanaClient } from './shared/vue.Mxc8w6Qk.mjs';
-export { u as useSubscription } from './shared/vue.B8ub540p.mjs';
+export { u as useSubscription } from './shared/vue.BDNOyiGZ.mjs';
 export { u as useTokenAccounts } from './shared/vue.BOpgWr43.mjs';
 export { u as useTokenBalance } from './shared/vue.BD6Gm1nl.mjs';
-export { u as useTrackedData } from './shared/vue.CogzzQXM.mjs';
+export { u as useTrackedData } from './shared/vue.CbJFnho-.mjs';
 export { u as useTransaction } from './shared/vue.5euWd6-V.mjs';
 export { g as getConfirmedTransactionStatus, u as useTransactionConfirmation } from './shared/vue.D3Y0PWbF.mjs';
 export { u as useWallet } from './shared/vue.D218Ow7t.mjs';

package/dist/shared/{vue.DImwKTwJ.mjs → vue.B8VvC8d2.mjs}

@@ -9,24 +9,22 @@ function useRequest(source, options = {}) {
   const status = shallowRef("fetching");
   let disposed = false;
   let attempt = 0;
-  const store = createSolanaActionStore(
-    async (signal, resolved) => {
-      attempt += 1;
-      const callerSignal = options.getAbortSignal?.(attempt);
-      const composedSignal = callerSignal ? AbortSignal.any([signal, callerSignal]) : signal;
-      let pending;
-      if (isSendSource(resolved)) {
-        pending = Promise.resolve(resolved.send({ abortSignal: composedSignal }));
-      } else if (typeof resolved === "function") {
-        pending = Promise.resolve(resolved(composedSignal)).then(
-          (result) => isSendSource(result) ? result.send({ abortSignal: composedSignal }) : result
-        );
-      } else {
-        throw new Error("useRequest source did not resolve to a request function");
-      }
-      return getAbortablePromise(pending, composedSignal);
+  const store = createSolanaActionStore(async (signal, resolved, override) => {
+    attempt += 1;
+    const callerSignal = override ? override.abortSignal : options.getAbortSignal?.(attempt);
+    const composedSignal = callerSignal ? AbortSignal.any([signal, callerSignal]) : signal;
+    let pending;
+    if (isSendSource(resolved)) {
+      pending = Promise.resolve(resolved.send({ abortSignal: composedSignal }));
+    } else if (typeof resolved === "function") {
+      pending = Promise.resolve(resolved(composedSignal)).then(
+        (result) => isSendSource(result) ? result.send({ abortSignal: composedSignal }) : result
+      );
+    } else {
+      throw new Error("useRequest source did not resolve to a request function");
     }
-  );
+    return getAbortablePromise(pending, composedSignal);
+  });
   const unsubscribe = store.subscribe(() => {
     const next = store.getState();
     if (next.status === "success") {
@@ -51,7 +49,7 @@ function useRequest(source, options = {}) {
     }
     return source;
   }
-  async function run() {
+  async function run(override) {
     if (disposed) {
       return void 0;
     }
@@ -65,7 +63,7 @@ function useRequest(source, options = {}) {
     }
     status.value = "fetching";
     try {
-      return await store.dispatchAsync(resolved);
+      return await store.dispatchAsync(resolved, override);
     } catch (cause) {
       if (store.getState().status !== "error") {
         return void 0;
@@ -73,7 +71,7 @@ function useRequest(source, options = {}) {
       throw normalizeSolanaError(cause, "RPC_FAILURE");
     }
   }
-  const refresh = () => run();
+  const refresh = (options2) => run(options2);
   watch(
     () => isRef(source) ? source.value : source,
     () => {

package/dist/shared/{vue.B8ub540p.mjs → vue.BDNOyiGZ.mjs}

@@ -27,11 +27,11 @@ function useSubscription(source, options = {}) {
       status.value = "loading";
     }
   }
-  function openConnection(store) {
+  function openConnection(store, override) {
     activeStore = store;
     connectionCount += 1;
     const connection = connectionCount;
-    const callerSignal = options.getAbortSignal?.(connection);
+    const callerSignal = override ? override.abortSignal : options.getAbortSignal?.(connection);
     applyState(store.getState());
     disposables.push(
       store.subscribe(() => {
@@ -59,7 +59,7 @@ function useSubscription(source, options = {}) {
     }
     activeSource = void 0;
   }
-  function connectCurrent() {
+  function connectCurrent(override) {
     if (disposed) {
       return;
     }
@@ -72,12 +72,12 @@ function useSubscription(source, options = {}) {
       return;
     }
     if (activeSource === resolved && activeStore) {
-      openConnection(activeStore);
+      openConnection(activeStore, override);
       return;
     }
     disconnect();
     activeSource = resolved;
-    openConnection(resolved.reactiveStore());
+    openConnection(resolved.reactiveStore(), override);
   }
   watch(
     () => isRef(source) ? source.value : source,
@@ -99,8 +99,8 @@ function useSubscription(source, options = {}) {
   return {
     data: computed(() => data.value),
     error: computed(() => error.value),
-    reconnect: () => {
-      connectCurrent();
+    reconnect: (options2) => {
+      connectCurrent(options2);
     },
     status: computed(() => status.value)
   };

package/dist/shared/vue.BSfiHqwj.mjs

@@ -0,0 +1,34 @@
+import { u as useAction } from './vue.DYk0Xfr3.mjs';
+import { u as useClientCapability } from './vue.B8LptjZP.mjs';
+import { u as useSolanaClient } from './vue.Mxc8w6Qk.mjs';
+
+function toReadableAirdropError(error) {
+  if (error instanceof Error) {
+    const httpStatus = error.context?.statusCode;
+    const isThrottled = httpStatus === 429 || error.message.startsWith("JSON-RPC error: Internal JSON-RPC error (Internal error)");
+    if (!isThrottled) {
+      throw error;
+    }
+    throw new Error(
+      `${error.message} This likely means the network's airdrop faucet is rate-limited or out of test SOL. Retry later, use https://faucet.solana.com, or point the client at a local validator.`,
+      { cause: error }
+    );
+  }
+  throw new Error(`Airdrop failed: ${String(error)}`);
+}
+function useAirdrop() {
+  useClientCapability("airdrop", {
+    hookName: "useAirdrop",
+    providerHint: "Install it by adding the airdrop capability with `createClient().use(solanaRpcConnection({ ... })).use(rpcAirdrop())` from `@solana/kit-plugin-rpc`."
+  });
+  const { client } = useSolanaClient();
+  return useAction((abortSignal, address, amount) => {
+    const airdrop = client.airdrop;
+    if (!airdrop) {
+      throw new Error("useAirdrop requires the `airdrop` capability on the Solana client.");
+    }
+    return airdrop(address, amount, abortSignal).catch(toReadableAirdropError);
+  });
+}
+
+export { useAirdrop as u };

package/dist/shared/vue.CTqPbvz3.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+const useAction = require('./vue.CoaIWGPT.cjs');
+const useClientCapability = require('./vue.BY0qpgYr.cjs');
+const useSolanaClient = require('./vue.BIxphCAq.cjs');
+
+function toReadableAirdropError(error) {
+  if (error instanceof Error) {
+    const httpStatus = error.context?.statusCode;
+    const isThrottled = httpStatus === 429 || error.message.startsWith("JSON-RPC error: Internal JSON-RPC error (Internal error)");
+    if (!isThrottled) {
+      throw error;
+    }
+    throw new Error(
+      `${error.message} This likely means the network's airdrop faucet is rate-limited or out of test SOL. Retry later, use https://faucet.solana.com, or point the client at a local validator.`,
+      { cause: error }
+    );
+  }
+  throw new Error(`Airdrop failed: ${String(error)}`);
+}
+function useAirdrop() {
+  useClientCapability.useClientCapability("airdrop", {
+    hookName: "useAirdrop",
+    providerHint: "Install it by adding the airdrop capability with `createClient().use(solanaRpcConnection({ ... })).use(rpcAirdrop())` from `@solana/kit-plugin-rpc`."
+  });
+  const { client } = useSolanaClient.useSolanaClient();
+  return useAction.useAction((abortSignal, address, amount) => {
+    const airdrop = client.airdrop;
+    if (!airdrop) {
+      throw new Error("useAirdrop requires the `airdrop` capability on the Solana client.");
+    }
+    return airdrop(address, amount, abortSignal).catch(toReadableAirdropError);
+  });
+}
+
+exports.useAirdrop = useAirdrop;

package/dist/shared/{vue.CogzzQXM.mjs → vue.CbJFnho-.mjs}

@@ -28,7 +28,7 @@ function useTrackedData(source, options = {}) {
       error.value = null;
     }
   }
-  function buildAndConnect() {
+  function buildAndConnect(override) {
     if (disposed) {
       return;
     }
@@ -104,7 +104,7 @@ function useTrackedData(source, options = {}) {
     }
     connectionCount += 1;
     const connection = connectionCount;
-    const callerSignal = options.getAbortSignal?.(connection);
+    const callerSignal = override ? override.abortSignal : options.getAbortSignal?.(connection);
     const store = createReactiveStoreWithInitialValueAndSlotTracking({
       initialValueMapper: source.rpcValueMapper,
       initialValueSource: rpcRequest,
@@ -158,8 +158,8 @@ function useTrackedData(source, options = {}) {
   return {
     data: computed(() => data.value),
     error: computed(() => error.value),
-    refresh: () => {
-      buildAndConnect();
+    refresh: (options2) => {
+      buildAndConnect(options2);
     },
     status: computed(() => status.value)
   };

package/dist/shared/{vue.DtCbCcPd.cjs → vue.DxM45azl.cjs}

@@ -30,7 +30,7 @@ function useTrackedData(source, options = {}) {
       error.value = null;
     }
   }
-  function buildAndConnect() {
+  function buildAndConnect(override) {
     if (disposed) {
       return;
     }
@@ -106,7 +106,7 @@ function useTrackedData(source, options = {}) {
     }
     connectionCount += 1;
     const connection = connectionCount;
-    const callerSignal = options.getAbortSignal?.(connection);
+    const callerSignal = override ? override.abortSignal : options.getAbortSignal?.(connection);
     const store = kit.createReactiveStoreWithInitialValueAndSlotTracking({
       initialValueMapper: source.rpcValueMapper,
       initialValueSource: rpcRequest,
@@ -160,8 +160,8 @@ function useTrackedData(source, options = {}) {
   return {
     data: vue.computed(() => data.value),
     error: vue.computed(() => error.value),
-    refresh: () => {
-      buildAndConnect();
+    refresh: (options2) => {
+      buildAndConnect(options2);
     },
     status: vue.computed(() => status.value)
   };

package/dist/shared/{vue.B8pLQ8P4.cjs → vue.ZuUCEEab.cjs}

@@ -11,24 +11,22 @@ function useRequest(source, options = {}) {
   const status = vue.shallowRef("fetching");
   let disposed = false;
   let attempt = 0;
-  const store = action.createSolanaActionStore(
-    async (signal, resolved) => {
-      attempt += 1;
-      const callerSignal = options.getAbortSignal?.(attempt);
-      const composedSignal = callerSignal ? AbortSignal.any([signal, callerSignal]) : signal;
-      let pending;
-      if (isSendSource(resolved)) {
-        pending = Promise.resolve(resolved.send({ abortSignal: composedSignal }));
-      } else if (typeof resolved === "function") {
-        pending = Promise.resolve(resolved(composedSignal)).then(
-          (result) => isSendSource(result) ? result.send({ abortSignal: composedSignal }) : result
-        );
-      } else {
-        throw new Error("useRequest source did not resolve to a request function");
-      }
-      return kit.getAbortablePromise(pending, composedSignal);
+  const store = action.createSolanaActionStore(async (signal, resolved, override) => {
+    attempt += 1;
+    const callerSignal = override ? override.abortSignal : options.getAbortSignal?.(attempt);
+    const composedSignal = callerSignal ? AbortSignal.any([signal, callerSignal]) : signal;
+    let pending;
+    if (isSendSource(resolved)) {
+      pending = Promise.resolve(resolved.send({ abortSignal: composedSignal }));
+    } else if (typeof resolved === "function") {
+      pending = Promise.resolve(resolved(composedSignal)).then(
+        (result) => isSendSource(result) ? result.send({ abortSignal: composedSignal }) : result
+      );
+    } else {
+      throw new Error("useRequest source did not resolve to a request function");
     }
-  );
+    return kit.getAbortablePromise(pending, composedSignal);
+  });
   const unsubscribe = store.subscribe(() => {
     const next = store.getState();
     if (next.status === "success") {
@@ -53,7 +51,7 @@ function useRequest(source, options = {}) {
     }
     return source;
   }
-  async function run() {
+  async function run(override) {
     if (disposed) {
       return void 0;
     }
@@ -67,7 +65,7 @@ function useRequest(source, options = {}) {
     }
     status.value = "fetching";
     try {
-      return await store.dispatchAsync(resolved);
+      return await store.dispatchAsync(resolved, override);
     } catch (cause) {
       if (store.getState().status !== "error") {
         return void 0;
@@ -75,7 +73,7 @@ function useRequest(source, options = {}) {
       throw errors.normalizeSolanaError(cause, "RPC_FAILURE");
     }
   }
-  const refresh = () => run();
+  const refresh = (options2) => run(options2);
   vue.watch(
     () => vue.isRef(source) ? source.value : source,
     () => {

package/dist/shared/{vue.BVj9lWBK.cjs → vue.l3UCdN7z.cjs}

@@ -29,11 +29,11 @@ function useSubscription(source, options = {}) {
       status.value = "loading";
     }
   }
-  function openConnection(store) {
+  function openConnection(store, override) {
     activeStore = store;
     connectionCount += 1;
     const connection = connectionCount;
-    const callerSignal = options.getAbortSignal?.(connection);
+    const callerSignal = override ? override.abortSignal : options.getAbortSignal?.(connection);
     applyState(store.getState());
     disposables.push(
       store.subscribe(() => {
@@ -61,7 +61,7 @@ function useSubscription(source, options = {}) {
     }
     activeSource = void 0;
   }
-  function connectCurrent() {
+  function connectCurrent(override) {
     if (disposed) {
       return;
     }
@@ -74,12 +74,12 @@ function useSubscription(source, options = {}) {
       return;
     }
     if (activeSource === resolved && activeStore) {
-      openConnection(activeStore);
+      openConnection(activeStore, override);
       return;
     }
     disconnect();
     activeSource = resolved;
-    openConnection(resolved.reactiveStore());
+    openConnection(resolved.reactiveStore(), override);
   }
   vue.watch(
     () => vue.isRef(source) ? source.value : source,
@@ -101,8 +101,8 @@ function useSubscription(source, options = {}) {
   return {
     data: vue.computed(() => data.value),
     error: vue.computed(() => error.value),
-    reconnect: () => {
-      connectCurrent();
+    reconnect: (options2) => {
+      connectCurrent(options2);
     },
     status: vue.computed(() => status.value)
   };

package/dist/swr.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
 const vue = require('vue');
-const useRequest = require('./shared/vue.B8pLQ8P4.cjs');
-const useSubscription = require('./shared/vue.BVj9lWBK.cjs');
-const useTrackedData = require('./shared/vue.DtCbCcPd.cjs');
+const useRequest = require('./shared/vue.ZuUCEEab.cjs');
+const useSubscription = require('./shared/vue.l3UCdN7z.cjs');
+const useTrackedData = require('./shared/vue.DxM45azl.cjs');
 require('@vue-solana/core/action');
 require('@vue-solana/core/kit');
 require('@vue-solana/core/errors');

package/dist/swr.mjs

@@ -1,7 +1,7 @@
 import { watch, computed } from 'vue';
-import { u as useRequest } from './shared/vue.DImwKTwJ.mjs';
-import { u as useSubscription } from './shared/vue.B8ub540p.mjs';
-import { u as useTrackedData } from './shared/vue.CogzzQXM.mjs';
+import { u as useRequest } from './shared/vue.B8VvC8d2.mjs';
+import { u as useSubscription } from './shared/vue.BDNOyiGZ.mjs';
+import { u as useTrackedData } from './shared/vue.CbJFnho-.mjs';
 import '@vue-solana/core/action';
 import '@vue-solana/core/kit';
 import '@vue-solana/core/errors';

package/dist/useAirdrop.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+const useAirdrop = require('./shared/vue.CTqPbvz3.cjs');
+require('./shared/vue.CoaIWGPT.cjs');
+require('@vue-solana/core/action');
+require('vue');
+require('./shared/vue.BY0qpgYr.cjs');
+require('./shared/vue.BIxphCAq.cjs');
+require('./shared/vue.DE3emjSF.cjs');
+require('./shared/vue.DEHxNvUX.cjs');
+
+
+
+exports.useAirdrop = useAirdrop.useAirdrop;