@vue-solana/vue 0.6.1 → 0.8.0

package/README.md

@@ -2,7 +2,7 @@
 
 Vue plugin and composables for Solana applications.
 
-Use this package in Vue 3 apps that need Solana RPC access, balance reads, wallet state, and transaction helper state.
+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:
 
@@ -68,6 +68,7 @@ The root export remains supported. For composables, prefer direct subpath import
 ```ts
 import { useRpc } from "@vue-solana/vue/useRpc";
 import { useWallet } from "@vue-solana/vue/useWallet";
+import { useSignMessage } from "@vue-solana/vue/useSignMessage";
 ```
 
 For development, use `devnet` and request free test SOL from the official faucet:
@@ -146,7 +147,7 @@ import { useWallet } from "@vue-solana/vue/useWallet";
 import { useWallets } from "@vue-solana/vue/useWallets";
 
 const { wallets, selectedWallet, selectWallet, refreshWallets } = useWallets();
-const { publicKey, connected, connecting, connect, disconnect } = useWallet();
+const { publicKey, connected, connecting, canSignMessage, connect, disconnect } = useWallet();
 </script>
 
 <template>
@@ -163,6 +164,7 @@ const { publicKey, connected, connecting, connect, disconnect } = useWallet();
     <p>Selected: {{ selectedWallet?.name ?? "None" }}</p>
     <p>Connected: {{ connected }}</p>
     <p>Public key: {{ publicKey?.toBase58() }}</p>
+    <p>Can sign messages: {{ canSignMessage }}</p>
     <p v-if="connecting">Connecting...</p>
     <button type="button" :disabled="!selectedWallet || connected || connecting" @click="connect">
       Connect
@@ -180,6 +182,38 @@ Desktop native app wallet adapters are planned but not implemented yet.
 
 Composables return inert SSR-safe state when no plugin context is available. Real RPC and wallet operations still require the plugin-provided client context.
 
+## Message Signing
+
+```vue
+<script setup lang="ts">
+import { computed } from "vue";
+import { useSignMessage } from "@vue-solana/vue/useSignMessage";
+import { useWallet } from "@vue-solana/vue/useWallet";
+
+const { connected, canSignMessage } = useWallet();
+const { signature, status, error, execute } = useSignMessage();
+
+const message = computed(() => new TextEncoder().encode("Sign in to My Vue Solana App"));
+
+async function signIn() {
+  await execute(message.value);
+}
+</script>
+
+<template>
+  <section>
+    <button type="button" :disabled="!connected || !canSignMessage" @click="signIn">
+      Sign message
+    </button>
+    <p>Status: {{ status }}</p>
+    <p v-if="signature">Signature bytes: {{ signature.length }}</p>
+    <pre v-if="error">{{ error.message }}</pre>
+  </section>
+</template>
+```
+
+Message signing proves wallet ownership for flows like authentication challenges. It does not sign, submit, or authorize Solana transactions. For authentication, issue a server-generated nonce, include domain and expiration details in the message, and verify the returned signature server-side.
+
 ## Transaction State
 
 ```ts
@@ -241,6 +275,7 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 - `useConnection()`: returns the Solana `Connection`.
 - `useWallet()`: returns wallet refs, computed connection state, and wallet actions.
 - `useWallets()`: returns discovered browser extension wallets, Android Mobile Wallet Adapter 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 a `PublicKey` or address string.
 - `useAccountInfo(address, options?)`: loads account info and can subscribe to account changes with `watch: true`.
 - `useProgramAccounts(programId, config?)`: loads accounts owned by a program with optional filters, commitment, and `dataSlice`.
@@ -259,6 +294,7 @@ Direct composable subpaths:
 - `@vue-solana/vue/useProgramAccounts`
 - `@vue-solana/vue/useWallet`
 - `@vue-solana/vue/useWallets`
+- `@vue-solana/vue/useSignMessage`
 - `@vue-solana/vue/useTransaction`
 - `@vue-solana/vue/useTransactionConfirmation`
 - `@vue-solana/vue/useSignatureStatus`
@@ -297,4 +333,4 @@ Make sure your `tsconfig.json` includes `types/**/*.d.ts` or another pattern tha
 
 ## Status
 
-This package is early-stage. RPC, balance, browser extension wallet, Android mobile wallet, and transaction composables are usable.
+This package is early-stage. RPC, balance, browser extension wallet, Android mobile wallet, iOS browser wallet, message signing, and transaction composables are usable.

package/dist/index.cjs

@@ -1,51 +1,62 @@
 'use strict';
 
-const useAccountInfo = require('./shared/vue.BPnK_lsh.cjs');
-const useBalance = require('./shared/vue.D_AM1Nl8.cjs');
+const useAccountInfo = require('./shared/vue.BBoDTIfF.cjs');
+const useBalance = require('./shared/vue.NFoc_-Kt.cjs');
 const useConnection = require('./shared/vue.CwhEmATP.cjs');
-const useProgramAccounts = require('./shared/vue.dmuispJ3.cjs');
+const useProgramAccounts = require('./shared/vue.D1JtJ2lD.cjs');
 const useRpc = require('./shared/vue.COyyrsQU.cjs');
-const useSignAndSendTransaction = require('./shared/vue.DEQJ23UM.cjs');
-const useSignatureStatus = require('./shared/vue.DUufwq8y.cjs');
+const useSignMessage = require('./shared/vue.DuI_Jm5P.cjs');
+const useSignAndSendTransaction = require('./shared/vue.BnSjOzvb.cjs');
+const useSignatureStatus = require('./shared/vue.DRlaqQCL.cjs');
 const useSolana = require('./shared/vue.C4tLiG3R.cjs');
-const useTransaction = require('./shared/vue.DQi38JeF.cjs');
-const useTransactionConfirmation = require('./shared/vue.DHVYJk8P.cjs');
-const useWallet = require('./shared/vue.CwPjPFN6.cjs');
+const useTransaction = require('./shared/vue.CE5i8KZZ.cjs');
+const useTransactionConfirmation = require('./shared/vue.BeA8WQ2g.cjs');
+const useWallet = require('./shared/vue.DfeKj9vL.cjs');
 const useWallets = require('./shared/vue.P9tgeC5S.cjs');
+const errors = require('@vue-solana/core/errors');
 const rpc = require('@vue-solana/core/rpc');
+const timeout = require('@vue-solana/core/timeout');
 const walletStandard = require('@vue-solana/core/wallet-standard');
 const vue = require('vue');
 const iosWallet = require('@vue-solana/core/ios-wallet');
 require('@vue-solana/core/address');
-require('@solana/web3-compat');
+require('@vue-solana/core/wallet');
 require('@vue-solana/core/transaction');
 require('bs58');
 
 const SELECTED_WALLET_STORAGE_KEY = "vue-solana:selected-wallet";
 function readSelectedWallet() {
-  const storage = getLocalStorage();
-  if (!storage) {
-    return null;
+  const { storage, error } = getLocalStorage();
+  if (error || !storage) {
+    return { wallet: null, error };
   }
   try {
     const value = storage.getItem(SELECTED_WALLET_STORAGE_KEY);
     if (!value) {
-      return null;
+      return { wallet: null, error: null };
     }
     const wallet = JSON.parse(value);
-    return typeof wallet.name === "string" ? {
-      name: wallet.name,
-      platform: wallet.platform,
-      source: wallet.source
-    } : null;
-  } catch {
-    return null;
+    return {
+      wallet: typeof wallet.name === "string" ? {
+        name: wallet.name,
+        platform: wallet.platform,
+        source: wallet.source
+      } : null,
+      error: null
+    };
+  } catch (cause) {
+    return {
+      wallet: null,
+      error: errors.createSolanaError("STORAGE_FAILURE", "Unable to read the selected Solana wallet", {
+        cause
+      })
+    };
   }
 }
 function writeSelectedWallet(wallet) {
-  const storage = getLocalStorage();
-  if (!storage) {
-    return;
+  const { storage, error } = getLocalStorage();
+  if (error || !storage) {
+    return error;
   }
   try {
     if (wallet) {
@@ -53,7 +64,11 @@ function writeSelectedWallet(wallet) {
     } else {
       storage.removeItem(SELECTED_WALLET_STORAGE_KEY);
     }
-  } catch {
+    return null;
+  } catch (cause) {
+    return errors.createSolanaError("STORAGE_FAILURE", "Unable to persist the selected Solana wallet", {
+      cause
+    });
   }
 }
 function stringifySelectedWallet(wallet) {
@@ -68,12 +83,17 @@ function stringifySelectedWallet(wallet) {
 }
 function getLocalStorage() {
   if (typeof window === "undefined") {
-    return null;
+    return { storage: null, error: null };
   }
   try {
-    return window.localStorage;
-  } catch {
-    return null;
+    return { storage: window.localStorage, error: null };
+  } catch (cause) {
+    return {
+      storage: null,
+      error: errors.createSolanaError("STORAGE_FAILURE", "Unable to read the selected Solana wallet", {
+        cause
+      })
+    };
   }
 }
 
@@ -201,10 +221,12 @@ function createSolanaPlugin(options = {}) {
           wsEndpoint: context.wsEndpoint
         });
         try {
-          const blockhash = await useTransaction.withTimeout(
+          const blockhash = await timeout.withTimeout(
             context.connection.getLatestBlockhash(),
             RPC_CHECK_TIMEOUT_MS,
-            `RPC connection check timed out after ${RPC_CHECK_TIMEOUT_MS / 1e3} seconds.`
+            () => new Error(
+              `RPC connection check timed out after ${RPC_CHECK_TIMEOUT_MS / 1e3} seconds.`
+            )
           );
           if (checkId !== rpcCheckId) {
             return;
@@ -222,7 +244,7 @@ function createSolanaPlugin(options = {}) {
             return;
           }
           status.value = "error";
-          error.value = cause instanceof Error ? cause.message : String(cause);
+          error.value = errors.normalizeSolanaError(cause, "RPC_FAILURE");
           console.error("[Vue Solana] Connection failed", cause);
         }
       }
@@ -238,7 +260,13 @@ function createSolanaPlugin(options = {}) {
           }
         } else if (!options.wallet) {
           const persistedWallet = readSelectedWallet();
-          restoredWallet = persistedWallet ? wallets.value.find((nextWallet) => isSameWallet(nextWallet, persistedWallet)) ?? null : null;
+          if (persistedWallet.error) {
+            error.value = persistedWallet.error;
+            console.error("[Vue Solana] Selected wallet restoration failed", persistedWallet.error);
+          }
+          restoredWallet = persistedWallet.wallet ? wallets.value.find(
+            (nextWallet) => isSameWallet(nextWallet, persistedWallet.wallet)
+          ) ?? null : null;
           if (restoredWallet) {
             selectedWallet.value = restoredWallet;
             wallet.value = walletRegistry.getAdaptedWallet(restoredWallet);
@@ -267,7 +295,11 @@ function createSolanaPlugin(options = {}) {
       function selectWallet(nextWallet) {
         selectedWallet.value = nextWallet;
         wallet.value = nextWallet ? walletRegistry.getAdaptedWallet(nextWallet) : options.wallet ?? null;
-        writeSelectedWallet(nextWallet);
+        const storageError = writeSelectedWallet(nextWallet);
+        if (storageError) {
+          error.value = storageError;
+          console.error("[Vue Solana] Selected wallet persistence failed", storageError);
+        }
       }
       function autoConnectWallet(walletInfo) {
         if (!options.autoConnect) {
@@ -299,7 +331,11 @@ function createSolanaPlugin(options = {}) {
         setWallet(nextWallet) {
           selectedWallet.value = null;
           wallet.value = nextWallet;
-          writeSelectedWallet(null);
+          const storageError = writeSelectedWallet(null);
+          if (storageError) {
+            error.value = storageError;
+            console.error("[Vue Solana] Selected wallet persistence failed", storageError);
+          }
         }
       };
       app.provide(useSolana.solanaInjectionKey, vueContext);
@@ -326,6 +362,7 @@ exports.useBalance = useBalance.useBalance;
 exports.useConnection = useConnection.useConnection;
 exports.useProgramAccounts = useProgramAccounts.useProgramAccounts;
 exports.useRpc = useRpc.useRpc;
+exports.useSignMessage = useSignMessage.useSignMessage;
 exports.useSignAndSendTransaction = useSignAndSendTransaction.useSignAndSendTransaction;
 exports.useSignatureStatus = useSignatureStatus.useSignatureStatus;
 exports.solanaInjectionKey = useSolana.solanaInjectionKey;

package/dist/index.d.cts

@@ -3,6 +3,7 @@ export { useBalance } from './useBalance.cjs';
 export { useConnection } from './useConnection.cjs';
 export { ProgramAccount, ProgramAccountDataSizeFilter, ProgramAccountDataSlice, ProgramAccountFilter, ProgramAccountMemcmpEncoding, ProgramAccountMemcmpFilter, UseProgramAccountsOptions, useProgramAccounts } from './useProgramAccounts.cjs';
 export { useRpc } from './useRpc.cjs';
+export { SignMessageStatus, useSignMessage } from './useSignMessage.cjs';
 export { SignAndSendTransactionOptions, SignAndSendTransactionStatus, useSignAndSendTransaction } from './useSignAndSendTransaction.cjs';
 export { UseSignatureStatusOptions, useSignatureStatus } from './useSignatureStatus.cjs';
 export { tryUseSolana, useSolana } from './useSolana.cjs';
@@ -10,12 +11,13 @@ export { UseTransactionOptions, useTransaction } from './useTransaction.cjs';
 export { TransactionConfirmationStatus, getConfirmedTransactionStatus, useTransactionConfirmation } from './useTransactionConfirmation.cjs';
 export { useWallet } from './useWallet.cjs';
 export { useWallets } from './useWallets.cjs';
-export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DGhodYJh.cjs';
+export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DL3z5PxP.cjs';
 import { GetSolanaIosWalletsOptions } from '@vue-solana/core/ios-wallet';
 import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
 import '@vue-solana/core/address';
+import '@vue-solana/core/errors';
 import '@solana/web3-compat';
 
 interface VueSolanaPluginOptions extends SolanaConfig {

package/dist/index.d.mts

@@ -3,6 +3,7 @@ export { useBalance } from './useBalance.mjs';
 export { useConnection } from './useConnection.mjs';
 export { ProgramAccount, ProgramAccountDataSizeFilter, ProgramAccountDataSlice, ProgramAccountFilter, ProgramAccountMemcmpEncoding, ProgramAccountMemcmpFilter, UseProgramAccountsOptions, useProgramAccounts } from './useProgramAccounts.mjs';
 export { useRpc } from './useRpc.mjs';
+export { SignMessageStatus, useSignMessage } from './useSignMessage.mjs';
 export { SignAndSendTransactionOptions, SignAndSendTransactionStatus, useSignAndSendTransaction } from './useSignAndSendTransaction.mjs';
 export { UseSignatureStatusOptions, useSignatureStatus } from './useSignatureStatus.mjs';
 export { tryUseSolana, useSolana } from './useSolana.mjs';
@@ -10,12 +11,13 @@ export { UseTransactionOptions, useTransaction } from './useTransaction.mjs';
 export { TransactionConfirmationStatus, getConfirmedTransactionStatus, useTransactionConfirmation } from './useTransactionConfirmation.mjs';
 export { useWallet } from './useWallet.mjs';
 export { useWallets } from './useWallets.mjs';
-export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DGhodYJh.mjs';
+export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DL3z5PxP.mjs';
 import { GetSolanaIosWalletsOptions } from '@vue-solana/core/ios-wallet';
 import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
 import '@vue-solana/core/address';
+import '@vue-solana/core/errors';
 import '@solana/web3-compat';
 
 interface VueSolanaPluginOptions extends SolanaConfig {

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { useBalance } from './useBalance.js';
 export { useConnection } from './useConnection.js';
 export { ProgramAccount, ProgramAccountDataSizeFilter, ProgramAccountDataSlice, ProgramAccountFilter, ProgramAccountMemcmpEncoding, ProgramAccountMemcmpFilter, UseProgramAccountsOptions, useProgramAccounts } from './useProgramAccounts.js';
 export { useRpc } from './useRpc.js';
+export { SignMessageStatus, useSignMessage } from './useSignMessage.js';
 export { SignAndSendTransactionOptions, SignAndSendTransactionStatus, useSignAndSendTransaction } from './useSignAndSendTransaction.js';
 export { UseSignatureStatusOptions, useSignatureStatus } from './useSignatureStatus.js';
 export { tryUseSolana, useSolana } from './useSolana.js';
@@ -10,12 +11,13 @@ export { UseTransactionOptions, useTransaction } from './useTransaction.js';
 export { TransactionConfirmationStatus, getConfirmedTransactionStatus, useTransactionConfirmation } from './useTransactionConfirmation.js';
 export { useWallet } from './useWallet.js';
 export { useWallets } from './useWallets.js';
-export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DGhodYJh.js';
+export { S as SolanaConnectionStatus, V as VueSolanaContext, s as solanaInjectionKey } from './shared/vue.DL3z5PxP.js';
 import { GetSolanaIosWalletsOptions } from '@vue-solana/core/ios-wallet';
 import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
 import '@vue-solana/core/address';
+import '@vue-solana/core/errors';
 import '@solana/web3-compat';
 
 interface VueSolanaPluginOptions extends SolanaConfig {

package/dist/index.mjs

@@ -1,51 +1,61 @@
-export { u as useAccountInfo } from './shared/vue.7TzeDJZX.mjs';
-export { u as useBalance } from './shared/vue.DQhHHVu6.mjs';
+export { u as useAccountInfo } from './shared/vue.Cl3hXlXK.mjs';
+export { u as useBalance } from './shared/vue.BDl2vVkp.mjs';
 export { u as useConnection } from './shared/vue.DlEAL2G8.mjs';
-export { u as useProgramAccounts } from './shared/vue.CUTLu1Gf.mjs';
+export { u as useProgramAccounts } from './shared/vue.CzTu_DPr.mjs';
 export { u as useRpc } from './shared/vue.BqDzSepb.mjs';
-export { u as useSignAndSendTransaction } from './shared/vue.RQ9fETnm.mjs';
-export { u as useSignatureStatus } from './shared/vue.JC5FdU2O.mjs';
+export { u as useSignMessage } from './shared/vue.PTQ2iRAi.mjs';
+export { u as useSignAndSendTransaction } from './shared/vue.BlfFUgC-.mjs';
+export { u as useSignatureStatus } from './shared/vue.BzopW_4m.mjs';
 import { s as solanaInjectionKey } from './shared/vue.1M_c5FWA.mjs';
 export { t as tryUseSolana, u as useSolana } from './shared/vue.1M_c5FWA.mjs';
-import { w as withTimeout } from './shared/vue.gLqkzJY4.mjs';
-export { u as useTransaction } from './shared/vue.gLqkzJY4.mjs';
-export { g as getConfirmedTransactionStatus, u as useTransactionConfirmation } from './shared/vue.jOsz34kz.mjs';
-export { u as useWallet } from './shared/vue.DYf_CRDv.mjs';
+export { u as useTransaction } from './shared/vue.C4d2JA8U.mjs';
+export { g as getConfirmedTransactionStatus, u as useTransactionConfirmation } from './shared/vue.CxMrojxC.mjs';
+export { u as useWallet } from './shared/vue.5sF8eKgx.mjs';
 export { u as useWallets } from './shared/vue.h-uS8MXN.mjs';
+import { createSolanaError, normalizeSolanaError } from '@vue-solana/core/errors';
 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 { shallowRef, ref, triggerRef } from 'vue';
 import { handleSolanaIosWalletCallback, getSolanaIosWallets, isSolanaIosWalletInfo, adaptSolanaIosWallet } from '@vue-solana/core/ios-wallet';
 import '@vue-solana/core/address';
-import '@solana/web3-compat';
+import '@vue-solana/core/wallet';
 import '@vue-solana/core/transaction';
 import 'bs58';
 
 const SELECTED_WALLET_STORAGE_KEY = "vue-solana:selected-wallet";
 function readSelectedWallet() {
-  const storage = getLocalStorage();
-  if (!storage) {
-    return null;
+  const { storage, error } = getLocalStorage();
+  if (error || !storage) {
+    return { wallet: null, error };
   }
   try {
     const value = storage.getItem(SELECTED_WALLET_STORAGE_KEY);
     if (!value) {
-      return null;
+      return { wallet: null, error: null };
     }
     const wallet = JSON.parse(value);
-    return typeof wallet.name === "string" ? {
-      name: wallet.name,
-      platform: wallet.platform,
-      source: wallet.source
-    } : null;
-  } catch {
-    return null;
+    return {
+      wallet: typeof wallet.name === "string" ? {
+        name: wallet.name,
+        platform: wallet.platform,
+        source: wallet.source
+      } : null,
+      error: null
+    };
+  } catch (cause) {
+    return {
+      wallet: null,
+      error: createSolanaError("STORAGE_FAILURE", "Unable to read the selected Solana wallet", {
+        cause
+      })
+    };
   }
 }
 function writeSelectedWallet(wallet) {
-  const storage = getLocalStorage();
-  if (!storage) {
-    return;
+  const { storage, error } = getLocalStorage();
+  if (error || !storage) {
+    return error;
   }
   try {
     if (wallet) {
@@ -53,7 +63,11 @@ function writeSelectedWallet(wallet) {
     } else {
       storage.removeItem(SELECTED_WALLET_STORAGE_KEY);
     }
-  } catch {
+    return null;
+  } catch (cause) {
+    return createSolanaError("STORAGE_FAILURE", "Unable to persist the selected Solana wallet", {
+      cause
+    });
   }
 }
 function stringifySelectedWallet(wallet) {
@@ -68,12 +82,17 @@ function stringifySelectedWallet(wallet) {
 }
 function getLocalStorage() {
   if (typeof window === "undefined") {
-    return null;
+    return { storage: null, error: null };
   }
   try {
-    return window.localStorage;
-  } catch {
-    return null;
+    return { storage: window.localStorage, error: null };
+  } catch (cause) {
+    return {
+      storage: null,
+      error: createSolanaError("STORAGE_FAILURE", "Unable to read the selected Solana wallet", {
+        cause
+      })
+    };
   }
 }
 
@@ -204,7 +223,9 @@ function createSolanaPlugin(options = {}) {
           const blockhash = await withTimeout(
             context.connection.getLatestBlockhash(),
             RPC_CHECK_TIMEOUT_MS,
-            `RPC connection check timed out after ${RPC_CHECK_TIMEOUT_MS / 1e3} seconds.`
+            () => new Error(
+              `RPC connection check timed out after ${RPC_CHECK_TIMEOUT_MS / 1e3} seconds.`
+            )
           );
           if (checkId !== rpcCheckId) {
             return;
@@ -222,7 +243,7 @@ function createSolanaPlugin(options = {}) {
             return;
           }
           status.value = "error";
-          error.value = cause instanceof Error ? cause.message : String(cause);
+          error.value = normalizeSolanaError(cause, "RPC_FAILURE");
           console.error("[Vue Solana] Connection failed", cause);
         }
       }
@@ -238,7 +259,13 @@ function createSolanaPlugin(options = {}) {
           }
         } else if (!options.wallet) {
           const persistedWallet = readSelectedWallet();
-          restoredWallet = persistedWallet ? wallets.value.find((nextWallet) => isSameWallet(nextWallet, persistedWallet)) ?? null : null;
+          if (persistedWallet.error) {
+            error.value = persistedWallet.error;
+            console.error("[Vue Solana] Selected wallet restoration failed", persistedWallet.error);
+          }
+          restoredWallet = persistedWallet.wallet ? wallets.value.find(
+            (nextWallet) => isSameWallet(nextWallet, persistedWallet.wallet)
+          ) ?? null : null;
           if (restoredWallet) {
             selectedWallet.value = restoredWallet;
             wallet.value = walletRegistry.getAdaptedWallet(restoredWallet);
@@ -267,7 +294,11 @@ function createSolanaPlugin(options = {}) {
       function selectWallet(nextWallet) {
         selectedWallet.value = nextWallet;
         wallet.value = nextWallet ? walletRegistry.getAdaptedWallet(nextWallet) : options.wallet ?? null;
-        writeSelectedWallet(nextWallet);
+        const storageError = writeSelectedWallet(nextWallet);
+        if (storageError) {
+          error.value = storageError;
+          console.error("[Vue Solana] Selected wallet persistence failed", storageError);
+        }
       }
       function autoConnectWallet(walletInfo) {
         if (!options.autoConnect) {
@@ -299,7 +330,11 @@ function createSolanaPlugin(options = {}) {
         setWallet(nextWallet) {
           selectedWallet.value = null;
           wallet.value = nextWallet;
-          writeSelectedWallet(null);
+          const storageError = writeSelectedWallet(null);
+          if (storageError) {
+            error.value = storageError;
+            console.error("[Vue Solana] Selected wallet persistence failed", storageError);
+          }
         }
       };
       app.provide(solanaInjectionKey, vueContext);

package/dist/shared/{vue.DYf_CRDv.mjs → vue.5sF8eKgx.mjs}

@@ -1,3 +1,5 @@
+import { normalizeSolanaError } from '@vue-solana/core/errors';
+import { createNoWalletSelectedError } from '@vue-solana/core/wallet';
 import { ref, computed, triggerRef } from 'vue';
 import { u as useSolana } from './vue.1M_c5FWA.mjs';
 
@@ -9,7 +11,7 @@ function useWallet() {
   async function connect() {
     const activeWallet = wallet.value;
     if (!activeWallet) {
-      throw new Error("No Solana wallet is configured");
+      throw createNoWalletSelectedError();
     }
     connecting.value = true;
     try {
@@ -21,9 +23,10 @@ function useWallet() {
         publicKey: activeWallet.publicKey?.toBase58() ?? null
       });
     } catch (error) {
+      const normalizedError = normalizeSolanaError(error, "RPC_FAILURE");
       triggerRef(wallet);
-      console.error("[Vue Solana] Wallet connection failed", error);
-      throw error;
+      console.error("[Vue Solana] Wallet connection failed", normalizedError);
+      throw normalizedError;
     } finally {
       connecting.value = false;
     }
@@ -40,9 +43,10 @@ function useWallet() {
       triggerRef(wallet);
       console.info("[Vue Solana] Wallet disconnected", { publicKey });
     } catch (error) {
+      const normalizedError = normalizeSolanaError(error, "RPC_FAILURE");
       triggerRef(wallet);
-      console.error("[Vue Solana] Wallet disconnection failed", error);
-      throw error;
+      console.error("[Vue Solana] Wallet disconnection failed", normalizedError);
+      throw normalizedError;
     } finally {
       disconnecting.value = false;
     }
@@ -51,6 +55,20 @@ function useWallet() {
   const isDisconnecting = computed(
     () => Boolean(disconnecting.value || wallet.value?.disconnecting)
   );
+  const canConnect = computed(() => Boolean(wallet.value?.connect));
+  const canDisconnect = computed(() => Boolean(wallet.value?.disconnect));
+  const canSignMessage = computed(() => Boolean(wallet.value?.signMessage));
+  const canSignTransaction = computed(() => Boolean(wallet.value?.signTransaction));
+  const canSignAllTransactions = computed(() => Boolean(wallet.value?.signAllTransactions));
+  const canSignAndSendTransaction = computed(() => Boolean(wallet.value?.signAndSendTransaction));
+  const capabilities = computed(() => ({
+    connect: canConnect.value,
+    disconnect: canDisconnect.value,
+    signMessage: canSignMessage.value,
+    signTransaction: canSignTransaction.value,
+    signAllTransactions: canSignAllTransactions.value,
+    signAndSendTransaction: canSignAndSendTransaction.value
+  }));
   return {
     wallet,
     publicKey: computed(() => wallet.value?.publicKey ?? null),
@@ -58,6 +76,13 @@ function useWallet() {
     connecting: isConnecting,
     disconnecting: isDisconnecting,
     loading: computed(() => isConnecting.value || isDisconnecting.value),
+    capabilities,
+    canConnect,
+    canDisconnect,
+    canSignMessage,
+    canSignTransaction,
+    canSignAllTransactions,
+    canSignAndSendTransaction,
     setWallet: solana.setWallet,
     connect,
     disconnect

package/dist/shared/{vue.BPnK_lsh.cjs → vue.BBoDTIfF.cjs}

@@ -1,6 +1,7 @@
 'use strict';
 
 const address = require('@vue-solana/core/address');
+const errors = require('@vue-solana/core/errors');
 const vue = require('vue');
 const useConnection = require('./vue.CwhEmATP.cjs');
 const useSolana = require('./vue.C4tLiG3R.cjs');
@@ -38,11 +39,12 @@ function useAccountInfo(address$1, options = {}) {
       }
       return nextAccountInfo;
     } catch (cause) {
+      const normalizedError = errors.normalizeSolanaError(cause, "RPC_FAILURE");
       if (requestId === refreshId) {
         accountInfo.value = null;
-        error.value = cause;
+        error.value = normalizedError;
       }
-      throw cause;
+      throw normalizedError;
     } finally {
       if (requestId === refreshId) {
         loading.value = false;
@@ -63,7 +65,7 @@ function useAccountInfo(address$1, options = {}) {
     try {
       await connection.removeAccountChangeListener(currentSubscriptionId);
     } catch (cause) {
-      error.value = cause;
+      error.value = errors.normalizeSolanaError(cause, "RPC_FAILURE");
     }
   }
   async function startWatching() {
@@ -98,7 +100,7 @@ function useAccountInfo(address$1, options = {}) {
       subscriptionId = nextSubscriptionId;
     } catch (cause) {
       if (requestId === watchId) {
-        error.value = cause;
+        error.value = errors.normalizeSolanaError(cause, "RPC_FAILURE");
       }
     }
   }