@vue-solana/vue 4.0.0-rc.0 → 4.0.0

package/README.md

@@ -7,6 +7,16 @@
 
 Solana wallet, RPC, account, message signing, and transaction composables for Vue 3.
 
+## Related packages
+
+This package is part of the Vue Solana family. Choose based on your app framework:
+
+- [`@vue-solana/core`](https://www.npmjs.com/package/@vue-solana/core) — framework-agnostic Solana primitives: Kit RPC client helpers, wallet types, Android MWA registration, iOS browser wallet helpers, message signing, token account reads, and transaction helpers. **Use this directly** when you want shared RPC/wallet/transaction helpers without installing a Vue plugin (non-Vue apps, server/relayer code, or your own framework integration).
+- [`@vue-solana/vue`](https://www.npmjs.com/package/@vue-solana/vue) — Vue 3 plugin plus composables for RPC, account, balance, wallet, message signing, live data, and transactions. **Use this** in plain Vue 3 apps (Vite, etc.). (This package.)
+- [`@vue-solana/nuxt`](https://www.npmjs.com/package/@vue-solana/nuxt) — Nuxt module that installs the Vue plugin and auto-imports the composables. **Use this** in Nuxt 3/4 apps.
+
+This package builds on `@vue-solana/core`; install `@vue-solana/vue` for plain Vue apps and `@vue-solana/nuxt` for Nuxt apps.
+
 Use this package in Vue 3 apps that need Solana RPC access, balance reads, wallet state, message signing, and transaction helper state.
 
 New to Solana? Start with the official docs and the project concepts guide:
@@ -64,20 +74,22 @@ import { createApp } from "vue";
 import { createSolanaPlugin } from "@vue-solana/vue";
 import App from "./App.vue";
 
-createApp(App)
-  .use(
-    createSolanaPlugin({
-      cluster: "devnet",
-      mobileWallet: {
-        appIdentity: {
-          name: "My Vue Solana App",
-          uri: "https://example.com",
-          icon: "favicon.ico",
-        },
-      },
-    }),
-  )
-  .mount("#app");
+const solana = createSolanaPlugin({
+  cluster: "devnet",
+  mobileWallet: {
+    appIdentity: {
+      name: "My Vue Solana App",
+      uri: "https://example.com",
+      icon: "favicon.ico",
+    },
+  },
+});
+
+createApp(App).use(solana).mount("#app");
+
+// On teardown:
+// app.unmount();
+// solana.dispose();
 ```
 
 Android Mobile Wallet Adapter registration is enabled by default on supported Android Chrome clients. Pass `mobileWallet` options to customize the MWA app identity, or pass `mobileWallet: false` to disable Android mobile wallet registration.
@@ -227,6 +239,8 @@ const signatureStatus = useSignatureStatus(signature, {
 });
 ```
 
+There is no per-call `commitment` option for `useSignatureStatus()`; `getSignatureStatuses` takes no per-call commitment, so reads use the commitment baked into the endpoint. Polling uses chained timeouts and `stopPolling()` prevents further ticks until the watched signature changes (which restarts polling). Invalid `pollIntervalMs` values return an `RPC_FAILURE` `SolanaError`.
+
 Read SPL token accounts and balances through Kit RPC `jsonParsed`:
 
 ```ts
@@ -276,6 +290,8 @@ const { publicKey, connected, connecting, canSignMessage, connect, disconnect }
 
 Browser extension wallets are discovered through the Solana Wallet Standard. Android Mobile Wallet Adapter wallets are registered through `@solana-mobile/wallet-standard-mobile` and exposed through the same `useWallets()` list on supported Android Chrome clients. iOS Phantom, Solflare, and Backpack entries are exposed through wallet-specific universal links on iOS browsers. `connect()` works after selecting a discovered wallet or configuring a custom `SolanaWallet`.
 
+Connecting a wallet also disconnects every other discovered wallet through its `standard:disconnect` feature, so only one wallet stays authorized for the app. An extension the user authorized in an earlier page session can otherwise keep answering signing requests, which is the usual cause of the wrong wallet prompting for a `signMessage` confirmation. A wallet that fails or never answers its disconnect is ignored after a 2 second timeout, and `connect()` resolves only after the sweep finishes.
+
 Selected discovered wallets are persisted under `localStorage["vue-solana:selected-wallet"]` as non-sensitive identity metadata: `name`, and `platform`/`source` when available. On reload, Vue Solana restores the selected wallet if the same wallet is discovered again. Pass `autoConnect: true` to opt into calling `connect()` for that restored wallet; arbitrary installed wallets are never auto-connected. Calling `selectWallet(null)` or `setWallet(customWallet)` clears the stored selection.
 
 Desktop native app wallet adapters are planned but not implemented yet.
@@ -488,7 +504,7 @@ import { useRequestSwr } from "@vue-solana/vue/swr";
 const balance = useRequestSwr(["balance", address], () => client.rpc.getBalance(address).send());
 ```
 
-The SWR cache is module-level and shared across the whole app, including across SSR requests. Namespace cache keys per request (for example by including a request or session id) or call `clearSwrCache()` at the start of each server request to avoid leaking one request's cached data into another. On the client the cache is intentionally shared for stale-while-revalidate seeding.
+The SWR cache is module-level and shared across the whole app, including across SSR requests. Namespace cache keys per request (for example by including a request or session id) or call `clearSwrCache()` at the start of each server request to avoid leaking one request's cached data into another. On the client the cache is intentionally shared for stale-while-revalidate seeding. It is capped at 1024 entries with oldest-first eviction. Use `deleteSwrKey(key)` to evict a single entry by its full cache key (including the adapter prefix like `request:`).
 
 ### Cancellation & Timeouts
 
@@ -592,9 +608,9 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 
 | API                                                                                        | Description                                                                                                                              |
 | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `createSolanaPlugin(options?)`                                                             | Installs the Vue Solana context.                                                                                                         |
+| `createSolanaPlugin(options?)`                                                             | Installs the Vue Solana context and returns `{ install, context, dispose }`. `dispose()` stops wallet discovery/subscriptions.           |
 | `VueSolana`                                                                                | Alias for `createSolanaPlugin`.                                                                                                          |
-| `useSolana()`                                                                              | Returns the full injected Solana context; throws when no plugin context is available.                                                    |
+| `useSolana()`                                                                              | Returns the full injected Solana context; throws when no plugin context is available (SSR fallback uses a fresh inert context per call). |
 | `tryUseSolana()`                                                                           | Returns the injected Solana context or `null` when no plugin context is available (SSR-safe).                                            |
 | `MissingClientCapabilityError`                                                             | Thrown by `useClientCapability()` (and client-sent composables) when the configured client lacks a required capability.                  |
 | `useRpc()`                                                                                 | Returns cluster, endpoint, connection status, latest blockhash, the Kit `client`, and `checkConnection()`.                               |
@@ -619,12 +635,14 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 | `useTrackedData(source, options?)`                                                         | Slot-deduplicated fetch plus subscription over Kit's slot-tracking store.                                                                |
 | `useRequestSwr(key, ...)` / `useSubscriptionSwr(key, ...)` / `useTrackedDataSwr(key, ...)` | Cache-keyed SWR adapters seeding fresh mounts from the last-known result.                                                                |
 | `clearSwrCache()`                                                                          | Clears every cached SWR entry.                                                                                                           |
+| `deleteSwrKey(key)`                                                                        | Removes a single cached SWR entry by full cache key (including adapter prefix).                                                          |
 | `useSignIn(input?)`                                                                        | Sign In With Solana (SIWS) trigger returning `{ account, signedMessage, signature }` for server-side verification.                       |
 | `useSelectedWalletAccount()`                                                               | App-wide selected wallet account context: `[selectedAccount, setSelectedAccount, filteredWallets]`.                                      |
 | `SelectedWalletAccountProvider`                                                            | Component that provides the selected wallet account context to its subtree.                                                              |
 | `useSignTransactions()`                                                                    | Batch-signs transactions through the wallet, preferring `signTransactions` and falling back to `signAllTransactions`.                    |
 | `useSignAndSendTransactions()`                                                             | Signs and sends multiple transactions, returning one signature each, with a singular sequential fallback.                                |
 | `useClientCapability(capability, options?)`                                                | Fails fast with a clear error when the configured Solana client lacks a requested capability.                                            |
+| `tryUseSolana()`                                                                           | Returns the injected Solana context or `null` when no plugin context is available (SSR-safe).                                            |
 | `usePayer()`                                                                               | Reactive Kit client `payer` signer ref. The default client exposes a configured payer when supplied.                                     |
 | `useIdentity()`                                                                            | Reactive Kit client `identity` signer ref (requires an identity signer on a custom client).                                              |
 | `usePlanTransaction()`                                                                     | Plans a single transaction message from instruction inputs without signing or sending; the default client includes the official planner. |

package/dist/index.mjs

@@ -11,12 +11,12 @@ export { u as useRequest } from './shared/vue.B8VvC8d2.mjs';
 export { u as useRpc } from './shared/vue.D8zNWw2t.mjs';
 export { S as SelectedWalletAccountProvider, c as createSelectedWalletAccountContext, p as provideSelectedWalletAccount, s as selectedWalletAccountInjectionKey, u as useSelectedWalletAccount } from './shared/vue.BngCaeXJ.mjs';
 export { u as useSendTransaction, a as useSendTransactions } from './shared/vue.CLAqNcLp.mjs';
-export { u as useSignMessage } from './shared/vue.DbJG4-ku.mjs';
-export { u as useSignAndSendTransaction } from './shared/vue.4ne5EBD9.mjs';
-export { u as useSignTransactions } from './shared/vue.CW-1AuSO.mjs';
-export { P as PartialSignAndSendError, u as useSignAndSendTransactions } from './shared/vue.UrCjmf0T.mjs';
+export { u as useSignMessage } from './shared/vue.Ddf_Cdjx.mjs';
+export { u as useSignAndSendTransaction } from './shared/vue.BTD4usyi.mjs';
+export { u as useSignTransactions } from './shared/vue.BHBifdbc.mjs';
+export { P as PartialSignAndSendError, u as useSignAndSendTransactions } from './shared/vue.C-7v1l8q.mjs';
 export { u as useSignatureStatus } from './shared/vue.Bu2cQ690.mjs';
-export { u as useSignIn } from './shared/vue.BBN9aU6D.mjs';
+export { u as useSignIn } from './shared/vue.SeuJipQ8.mjs';
 export { t as tryUseSolana, u as useSolana } from './shared/vue.CcOZ9858.mjs';
 export { u as useSolanaClient } from './shared/vue.CZApWQAY.mjs';
 export { u as useSubscription } from './shared/vue.D5pqR5Fa.mjs';
@@ -25,7 +25,7 @@ export { u as useTokenBalance } from './shared/vue.FehFeE3w.mjs';
 export { u as useTrackedData } from './shared/vue.BNJTXSnQ.mjs';
 export { u as useTransaction } from './shared/vue.5euWd6-V.mjs';
 export { g as getConfirmedTransactionStatus, u as useTransactionConfirmation } from './shared/vue.DPwdqRO_.mjs';
-export { u as useWallet } from './shared/vue.DY9VadLH.mjs';
+export { u as useWallet } from './shared/vue.Bc_Kbwr5.mjs';
 export { u as useWallets } from './shared/vue.DyLgoSbX.mjs';
 import { s as solanaInjectionKey } from './shared/vue.D_P5SqqD.mjs';
 import { createSolanaError, normalizeSolanaError } from '@vue-solana/core/errors';
@@ -33,7 +33,7 @@ export { SolanaError, isSolanaError } from '@vue-solana/core/errors';
 import { isSolanaMobileWalletSupported } from '@vue-solana/core/mobile-wallet-support';
 import { createSolanaContext } from '@vue-solana/core/rpc';
 import { withTimeout } from '@vue-solana/core/timeout';
-import { getRegisteredSolanaWallets, getSolanaChain, adaptSolanaStandardWallet, subscribeSolanaWallets } from '@vue-solana/core/wallet-standard';
+import { getRegisteredSolanaWallets, getSolanaChain, adaptSolanaStandardWallet, disconnectSolanaStandardWallet, subscribeSolanaWallets } from '@vue-solana/core/wallet-standard';
 import { shallowRef, ref, triggerRef } from 'vue';
 import { handleSolanaIosWalletCallback, getSolanaIosWallets, isSolanaIosWalletInfo, adaptSolanaIosWallet } from '@vue-solana/core/ios-wallet';
 export * from '@vue-solana/core/types';
@@ -112,6 +112,7 @@ function getLocalStorage() {
   }
 }
 
+const DISCONNECT_TIMEOUT_MS = 2e3;
 function createSolanaWalletRegistry(options) {
   const adaptedWallets = /* @__PURE__ */ new WeakMap();
   const adaptedPrimitiveWallets = /* @__PURE__ */ new Map();
@@ -126,25 +127,31 @@ function createSolanaWalletRegistry(options) {
       if (cachedIosWallet) {
         return cachedIosWallet;
       }
-      const iosAdapter = adaptSolanaIosWallet(walletInfo, {
-        chain: getSolanaChain(options.cluster),
-        cluster: options.cluster,
-        onChange: options.onWalletChange,
-        ...options.iosWallet || {}
-      });
+      const iosAdapter = makeConnectExclusive(
+        adaptSolanaIosWallet(walletInfo, {
+          chain: getSolanaChain(options.cluster),
+          cluster: options.cluster,
+          onChange: options.onWalletChange,
+          ...options.iosWallet || {}
+        }),
+        walletInfo
+      );
       adaptedWallets.set(walletInfo.wallet, iosAdapter);
       return trackAdapter(iosAdapter);
     }
     if (!isObject(walletInfo.wallet)) {
-      const primitiveKey = `${walletInfo.name}::${String(walletInfo.wallet)}`;
+      const primitiveKey = getPrimitiveWalletKey(walletInfo);
       const cachedPrimitiveWallet = adaptedPrimitiveWallets.get(primitiveKey);
       if (cachedPrimitiveWallet) {
         return cachedPrimitiveWallet;
       }
-      const primitiveAdapter = adaptSolanaStandardWallet(walletInfo, {
-        chain: getSolanaChain(options.cluster),
-        onChange: options.onWalletChange
-      });
+      const primitiveAdapter = makeConnectExclusive(
+        adaptSolanaStandardWallet(walletInfo, {
+          chain: getSolanaChain(options.cluster),
+          onChange: options.onWalletChange
+        }),
+        walletInfo
+      );
       adaptedPrimitiveWallets.set(primitiveKey, primitiveAdapter);
       return trackAdapter(primitiveAdapter);
     }
@@ -152,30 +159,19 @@ function createSolanaWalletRegistry(options) {
     if (cachedWallet) {
       return cachedWallet;
     }
-    const adaptedWallet = adaptSolanaStandardWallet(walletInfo, {
-      chain: getSolanaChain(options.cluster),
-      onChange: options.onWalletChange
-    });
-    const cachedAdapter = new Proxy(adaptedWallet, {
-      get(target, property) {
-        if (property === "connect") {
-          return connectAndDisconnectOthers;
-        }
-        const value = Reflect.get(target, property);
-        return typeof value === "function" ? value.bind(target) : value;
-      }
-    });
-    async function connectAndDisconnectOthers() {
-      await adaptedWallet.connect();
-      await Promise.all(
-        Array.from(getCachedWallets()).map(
-          (otherWallet) => otherWallet !== cachedAdapter && otherWallet.connected ? otherWallet.disconnect() : void 0
-        )
-      );
-    }
+    const cachedAdapter = makeConnectExclusive(
+      adaptSolanaStandardWallet(walletInfo, {
+        chain: getSolanaChain(options.cluster),
+        onChange: options.onWalletChange
+      }),
+      walletInfo
+    );
     adaptedWallets.set(walletInfo.wallet, cachedAdapter);
     return trackAdapter(cachedAdapter);
   }
+  function getCachedAdapter(walletInfo) {
+    return isObject(walletInfo.wallet) ? adaptedWallets.get(walletInfo.wallet) : adaptedPrimitiveWallets.get(getPrimitiveWalletKey(walletInfo));
+  }
   function getDiscoveredWallets() {
     return [
       ...getRegisteredSolanaWallets(),
@@ -190,17 +186,41 @@ function createSolanaWalletRegistry(options) {
     try {
       handleSolanaIosWalletCallback({ clearUrl: true });
     } catch (cause) {
+      options.onError?.(cause);
     }
   }
-  function* getCachedWallets() {
-    for (const walletInfo of options.getWalletInfos()) {
-      if (isObject(walletInfo.wallet)) {
-        const cachedWallet = adaptedWallets.get(walletInfo.wallet);
-        if (cachedWallet) {
-          yield cachedWallet;
+  function makeConnectExclusive(adapter, walletInfo) {
+    const connect = adapter.connect.bind(adapter);
+    adapter.connect = async () => {
+      await connect();
+      await disconnectOtherWallets(walletInfo, adapter);
+    };
+    return adapter;
+  }
+  async function disconnectOtherWallets(currentWallet, currentAdapter) {
+    await Promise.all(
+      options.getWalletInfos().map(async (walletInfo) => {
+        const cachedWallet = getCachedAdapter(walletInfo);
+        if (cachedWallet === currentAdapter || isSameWalletInfo(walletInfo, currentWallet)) {
+          return;
         }
-      }
+        try {
+          await withTimeout(
+            disconnectWallet(walletInfo, cachedWallet),
+            DISCONNECT_TIMEOUT_MS,
+            () => new Error(`Solana wallet "${walletInfo.name}" did not disconnect within its timeout`)
+          );
+        } catch {
+        }
+      })
+    );
+  }
+  async function disconnectWallet(walletInfo, cachedWallet) {
+    if (cachedWallet) {
+      await cachedWallet.disconnect();
+      return;
     }
+    await disconnectSolanaStandardWallet(walletInfo);
   }
   function disposeAllAdaptedWallets() {
     for (const adapter of trackedAdapters) {
@@ -217,6 +237,12 @@ function createSolanaWalletRegistry(options) {
 function isObject(value) {
   return typeof value === "object" && value !== null || typeof value === "function";
 }
+function getPrimitiveWalletKey(walletInfo) {
+  return `${walletInfo.name}::${String(walletInfo.wallet)}`;
+}
+function isSameWalletInfo(a, b) {
+  return a.wallet === b.wallet || a.name === b.name && a.source === b.source;
+}
 
 const RPC_CHECK_TIMEOUT_MS = 1e4;
 function createSolanaPlugin(options = {}) {
@@ -235,7 +261,11 @@ function createSolanaPlugin(options = {}) {
         cluster: context.cluster,
         iosWallet: options.iosWallet,
         getWalletInfos: () => wallets.value,
-        onWalletChange: () => triggerRef(wallet)
+        onWalletChange: () => triggerRef(wallet),
+        onError: (cause) => {
+          error.value = normalizeSolanaError(cause, "WALLET_FAILURE");
+          logDevError("Failed to handle Solana iOS wallet callback", cause);
+        }
       });
       let unsubscribeWallets = null;
       let mobileWalletRegistrationPromise = null;
@@ -267,6 +297,7 @@ function createSolanaPlugin(options = {}) {
           }
           status.value = "error";
           error.value = normalizeSolanaError(cause, "RPC_FAILURE");
+          logDevError("Connection failed", cause);
         }
       }
       function refreshWallets() {
@@ -286,6 +317,7 @@ function createSolanaPlugin(options = {}) {
           const persistedWallet = readSelectedWallet();
           if (persistedWallet.error) {
             error.value = persistedWallet.error;
+            logDevError("Failed to read the persisted Solana wallet", persistedWallet.error);
           }
           restoredWallet = persistedWallet.wallet ? wallets.value.find(
             (nextWallet) => isSameWallet(nextWallet, persistedWallet.wallet)
@@ -316,6 +348,8 @@ function createSolanaPlugin(options = {}) {
           });
           refreshWallets();
         }).catch((cause) => {
+          error.value = normalizeSolanaError(cause, "WALLET_FAILURE");
+          logDevError("Failed to register Solana mobile wallet", cause);
         }).finally(() => {
           mobileWalletRegistrationPromise = null;
         });
@@ -326,6 +360,7 @@ function createSolanaPlugin(options = {}) {
         const storageError = writeSelectedWallet(nextWallet);
         if (storageError) {
           error.value = storageError;
+          logDevError("Failed to persist the selected Solana wallet", storageError);
         }
       }
       function autoConnectWallet(walletInfo) {
@@ -339,6 +374,8 @@ function createSolanaPlugin(options = {}) {
         }
         attemptedAutoConnectWallet = storageValue;
         void activeWallet.connect().catch((cause) => {
+          error.value = normalizeSolanaError(cause, "WALLET_FAILURE");
+          logDevError("Failed to auto-connect Solana wallet", cause);
         }).finally(() => {
           triggerRef(wallet);
         });
@@ -360,6 +397,7 @@ function createSolanaPlugin(options = {}) {
           const storageError = writeSelectedWallet(null);
           if (storageError) {
             error.value = storageError;
+            logDevError("Failed to clear the persisted Solana wallet", storageError);
           }
         }
       };
@@ -378,11 +416,13 @@ function createSolanaPlugin(options = {}) {
       };
       if (typeof window !== "undefined") {
         bootstrapId = window.setTimeout(() => {
+          void checkConnection();
           try {
             refreshWallets();
           } catch (cause) {
+            error.value = normalizeSolanaError(cause, "WALLET_FAILURE");
+            logDevError("Failed to refresh Solana wallets", cause);
           }
-          void checkConnection();
         }, 0);
       }
     },
@@ -395,6 +435,24 @@ function createSolanaPlugin(options = {}) {
 function isSameWallet(wallet, selectedWallet) {
   return wallet.name === selectedWallet?.name && wallet.source === selectedWallet.source && wallet.platform === selectedWallet.platform;
 }
+function isDevEnvironment() {
+  try {
+    if (import.meta.env?.DEV === true) {
+      return true;
+    }
+  } catch {
+  }
+  if (typeof process === "undefined") {
+    return false;
+  }
+  const mode = process.env?.NODE_ENV;
+  return mode === "development" || mode === "test";
+}
+function logDevError(message, cause) {
+  if (isDevEnvironment()) {
+    console.error(`[Vue Solana] ${message}`, cause);
+  }
+}
 const VueSolana = createSolanaPlugin;
 
 export { VueSolana, createSolanaPlugin, solanaInjectionKey };

package/dist/shared/{vue.CW-1AuSO.mjs → vue.BHBifdbc.mjs}

@@ -1,7 +1,7 @@
 import { createNoWalletSelectedError, assertWalletCanSignTransactions } from '@vue-solana/core/wallet';
 import { shallowRef } from 'vue';
 import { u as useExecution } from './vue.BiKE9Xuv.mjs';
-import { u as useWallet } from './vue.DY9VadLH.mjs';
+import { u as useWallet } from './vue.Bc_Kbwr5.mjs';
 
 function useSignTransactions() {
   const { wallet } = useWallet();

package/dist/shared/{vue.4ne5EBD9.mjs → vue.BTD4usyi.mjs}

@@ -4,7 +4,7 @@ import { signAndSendTransaction, confirmTransactionSignature } from '@vue-solana
 import { createNoWalletSelectedError } from '@vue-solana/core/wallet';
 import { ref, computed } from 'vue';
 import { u as useSolanaClient } from './vue.CZApWQAY.mjs';
-import { u as useWallet } from './vue.DY9VadLH.mjs';
+import { u as useWallet } from './vue.Bc_Kbwr5.mjs';
 import { g as getConfirmedTransactionStatus } from './vue.DPwdqRO_.mjs';
 
 const SIGN_AND_SEND_TIMEOUT_MS = 12e4;

package/dist/shared/{vue.DY9VadLH.mjs → vue.Bc_Kbwr5.mjs}

@@ -8,6 +8,12 @@ function useWallet() {
   const wallet = solana.wallet;
   const connecting = ref(false);
   const disconnecting = ref(false);
+  function clearWalletError() {
+    const current = solana.error.value;
+    if (current?.code === "WALLET_FAILURE" || current?.code === "USER_REJECTED") {
+      solana.error.value = null;
+    }
+  }
   async function connect() {
     if (connecting.value || wallet.value?.connecting) {
       return;
@@ -22,9 +28,10 @@ function useWallet() {
       triggerRef(wallet);
       await connection;
       assertWalletConnected(activeWallet);
+      clearWalletError();
       triggerRef(wallet);
     } catch (error) {
-      const normalizedError = normalizeSolanaError(error, "RPC_FAILURE");
+      const normalizedError = normalizeSolanaError(error, "WALLET_FAILURE");
       triggerRef(wallet);
       throw normalizedError;
     } finally {
@@ -39,9 +46,10 @@ function useWallet() {
     disconnecting.value = true;
     try {
       await activeWallet.disconnect();
+      clearWalletError();
       triggerRef(wallet);
     } catch (error) {
-      const normalizedError = normalizeSolanaError(error, "RPC_FAILURE");
+      const normalizedError = normalizeSolanaError(error, "WALLET_FAILURE");
       triggerRef(wallet);
       throw normalizedError;
     } finally {

package/dist/shared/{vue.UrCjmf0T.mjs → vue.C-7v1l8q.mjs}

@@ -3,7 +3,7 @@ import { withSolanaTimeout } from '@vue-solana/core/timeout';
 import { createNoWalletSelectedError, assertWalletCanSignAndSendTransactions } from '@vue-solana/core/wallet';
 import { shallowRef } from 'vue';
 import { u as useExecution } from './vue.BiKE9Xuv.mjs';
-import { u as useWallet } from './vue.DY9VadLH.mjs';
+import { u as useWallet } from './vue.Bc_Kbwr5.mjs';
 
 const SIGN_AND_SEND_TIMEOUT_MS = 12e4;
 class PartialSignAndSendError extends SolanaError {

package/dist/shared/{vue.DbJG4-ku.mjs → vue.Ddf_Cdjx.mjs}

@@ -1,7 +1,7 @@
 import { createNoWalletSelectedError, assertWalletCanSignMessage } from '@vue-solana/core/wallet';
 import { ref } from 'vue';
 import { u as useExecution } from './vue.BiKE9Xuv.mjs';
-import { u as useWallet } from './vue.DY9VadLH.mjs';
+import { u as useWallet } from './vue.Bc_Kbwr5.mjs';
 
 function useSignMessage() {
   const { wallet } = useWallet();

package/dist/shared/{vue.BBN9aU6D.mjs → vue.SeuJipQ8.mjs}

@@ -1,7 +1,7 @@
 import { createNoWalletSelectedError, assertWalletCanSignIn } from '@vue-solana/core/wallet';
 import { shallowRef } from 'vue';
 import { u as useExecution } from './vue.BiKE9Xuv.mjs';
-import { u as useWallet } from './vue.DY9VadLH.mjs';
+import { u as useWallet } from './vue.Bc_Kbwr5.mjs';
 
 function useSignIn() {
   const { wallet } = useWallet();

package/dist/useSignAndSendTransaction.mjs

@@ -1 +1 @@
-export { u as useSignAndSendTransaction } from './shared/vue.4ne5EBD9.mjs';
+export { u as useSignAndSendTransaction } from './shared/vue.BTD4usyi.mjs';

package/dist/useSignAndSendTransactions.mjs

@@ -1 +1 @@
-export { P as PartialSignAndSendError, u as useSignAndSendTransactions } from './shared/vue.UrCjmf0T.mjs';
+export { P as PartialSignAndSendError, u as useSignAndSendTransactions } from './shared/vue.C-7v1l8q.mjs';

package/dist/useSignIn.mjs

@@ -1 +1 @@
-export { u as useSignIn } from './shared/vue.BBN9aU6D.mjs';
+export { u as useSignIn } from './shared/vue.SeuJipQ8.mjs';

package/dist/useSignMessage.mjs

@@ -1 +1 @@
-export { u as useSignMessage } from './shared/vue.DbJG4-ku.mjs';
+export { u as useSignMessage } from './shared/vue.Ddf_Cdjx.mjs';

package/dist/useSignTransactions.mjs

@@ -1 +1 @@
-export { u as useSignTransactions } from './shared/vue.CW-1AuSO.mjs';
+export { u as useSignTransactions } from './shared/vue.BHBifdbc.mjs';

package/dist/useWallet.mjs

@@ -1 +1 @@
-export { u as useWallet } from './shared/vue.DY9VadLH.mjs';
+export { u as useWallet } from './shared/vue.Bc_Kbwr5.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/vue",
-  "version": "4.0.0-rc.0",
+  "version": "4.0.0",
   "description": "Vue plugin and composables for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -178,7 +178,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/core": "4.0.0-rc.0"
+    "@vue-solana/core": "4.0.0"
   },
   "peerDependencies": {
     "vue": "^3.5.0"