@vue-solana/vue 0.6.1 → 0.7.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

@@ -5,12 +5,13 @@ const useBalance = require('./shared/vue.D_AM1Nl8.cjs');
 const useConnection = require('./shared/vue.CwhEmATP.cjs');
 const useProgramAccounts = require('./shared/vue.dmuispJ3.cjs');
 const useRpc = require('./shared/vue.COyyrsQU.cjs');
-const useSignAndSendTransaction = require('./shared/vue.DEQJ23UM.cjs');
+const useSignMessage = require('./shared/vue.D1knFN3X.cjs');
+const useSignAndSendTransaction = require('./shared/vue.DWiQYhb8.cjs');
 const useSignatureStatus = require('./shared/vue.DUufwq8y.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 useWallet = require('./shared/vue.BwipRa1w.cjs');
 const useWallets = require('./shared/vue.P9tgeC5S.cjs');
 const rpc = require('@vue-solana/core/rpc');
 const walletStandard = require('@vue-solana/core/wallet-standard');
@@ -18,6 +19,7 @@ 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');
 
@@ -326,6 +328,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';

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';

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';

package/dist/index.mjs

@@ -3,14 +3,15 @@ export { u as useBalance } from './shared/vue.DQhHHVu6.mjs';
 export { u as useConnection } from './shared/vue.DlEAL2G8.mjs';
 export { u as useProgramAccounts } from './shared/vue.CUTLu1Gf.mjs';
 export { u as useRpc } from './shared/vue.BqDzSepb.mjs';
-export { u as useSignAndSendTransaction } from './shared/vue.RQ9fETnm.mjs';
+export { u as useSignMessage } from './shared/vue.BeuIPLGM.mjs';
+export { u as useSignAndSendTransaction } from './shared/vue.CM6qb_s8.mjs';
 export { u as useSignatureStatus } from './shared/vue.JC5FdU2O.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 useWallet } from './shared/vue.CGVdFmYI.mjs';
 export { u as useWallets } from './shared/vue.h-uS8MXN.mjs';
 import { createSolanaContext } from '@vue-solana/core/rpc';
 import { getRegisteredSolanaWallets, getSolanaChain, adaptSolanaStandardWallet, subscribeSolanaWallets } from '@vue-solana/core/wallet-standard';
@@ -18,6 +19,7 @@ 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';
 

package/dist/shared/vue.BeuIPLGM.mjs

@@ -0,0 +1,63 @@
+import { assertWalletCanSignMessage } from '@vue-solana/core/wallet';
+import { ref } from 'vue';
+import { u as useWallet } from './vue.CGVdFmYI.mjs';
+
+function useSignMessage() {
+  const { wallet } = useWallet();
+  const signedMessage = ref(null);
+  const signature = ref(null);
+  const status = ref("idle");
+  const loading = ref(false);
+  const error = ref(null);
+  let executionId = 0;
+  async function execute(message) {
+    const currentExecutionId = ++executionId;
+    status.value = "signing";
+    loading.value = true;
+    error.value = null;
+    signedMessage.value = null;
+    signature.value = null;
+    const activeWallet = wallet.value;
+    if (!activeWallet) {
+      const cause = new Error("No Solana wallet is configured");
+      error.value = cause;
+      status.value = "error";
+      loading.value = false;
+      throw cause;
+    }
+    try {
+      assertWalletCanSignMessage(activeWallet);
+      const result = await activeWallet.signMessage(message);
+      if (currentExecutionId === executionId) {
+        signedMessage.value = result.signedMessage;
+        signature.value = result.signature;
+        status.value = "signed";
+      }
+      return result;
+    } catch (cause) {
+      const normalizedError = normalizeError(cause);
+      if (currentExecutionId === executionId) {
+        error.value = normalizedError;
+        status.value = "error";
+      }
+      throw normalizedError;
+    } finally {
+      if (currentExecutionId === executionId) {
+        loading.value = false;
+      }
+    }
+  }
+  return {
+    signedMessage,
+    signature,
+    status,
+    loading,
+    error,
+    execute
+  };
+}
+function normalizeError(cause) {
+  return cause instanceof Error ? cause : new Error(String(cause));
+}
+
+export { useSignMessage as u };

package/dist/shared/{vue.CwPjPFN6.cjs → vue.BwipRa1w.cjs}

@@ -53,6 +53,20 @@ function useWallet() {
   const isDisconnecting = vue.computed(
     () => Boolean(disconnecting.value || wallet.value?.disconnecting)
   );
+  const canConnect = vue.computed(() => Boolean(wallet.value?.connect));
+  const canDisconnect = vue.computed(() => Boolean(wallet.value?.disconnect));
+  const canSignMessage = vue.computed(() => Boolean(wallet.value?.signMessage));
+  const canSignTransaction = vue.computed(() => Boolean(wallet.value?.signTransaction));
+  const canSignAllTransactions = vue.computed(() => Boolean(wallet.value?.signAllTransactions));
+  const canSignAndSendTransaction = vue.computed(() => Boolean(wallet.value?.signAndSendTransaction));
+  const capabilities = vue.computed(() => ({
+    connect: canConnect.value,
+    disconnect: canDisconnect.value,
+    signMessage: canSignMessage.value,
+    signTransaction: canSignTransaction.value,
+    signAllTransactions: canSignAllTransactions.value,
+    signAndSendTransaction: canSignAndSendTransaction.value
+  }));
   return {
     wallet,
     publicKey: vue.computed(() => wallet.value?.publicKey ?? null),
@@ -60,6 +74,13 @@ function useWallet() {
     connecting: isConnecting,
     disconnecting: isDisconnecting,
     loading: vue.computed(() => isConnecting.value || isDisconnecting.value),
+    capabilities,
+    canConnect,
+    canDisconnect,
+    canSignMessage,
+    canSignTransaction,
+    canSignAllTransactions,
+    canSignAndSendTransaction,
     setWallet: solana.setWallet,
     connect,
     disconnect

package/dist/shared/{vue.DYf_CRDv.mjs → vue.CGVdFmYI.mjs}

@@ -51,6 +51,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 +72,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.RQ9fETnm.mjs → vue.CM6qb_s8.mjs}

@@ -1,7 +1,7 @@
 import { signAndSendTransaction, confirmTransactionSignature } from '@vue-solana/core/transaction';
 import { ref } from 'vue';
 import { u as useConnection } from './vue.DlEAL2G8.mjs';
-import { u as useWallet } from './vue.DYf_CRDv.mjs';
+import { u as useWallet } from './vue.CGVdFmYI.mjs';
 import { g as getConfirmedTransactionStatus } from './vue.jOsz34kz.mjs';
 
 const SIGN_AND_SEND_TIMEOUT_MS = 12e4;
@@ -22,12 +22,17 @@ function useSignAndSendTransaction() {
     loading.value = true;
     error.value = null;
     confirmation.value = null;
+    const activeWallet = wallet.value;
+    if (!activeWallet) {
+      const cause = new Error("No Solana wallet is configured");
+      error.value = cause;
+      status.value = "error";
+      loading.value = false;
+      throw cause;
+    }
     try {
-      if (!wallet.value) {
-        throw new Error("No Solana wallet is configured");
-      }
       const nextSignature = await withWalletTransactionTimeout(
-        signAndSendTransaction(connection, wallet.value, transaction, transactionOptions)
+        signAndSendTransaction(connection, activeWallet, transaction, transactionOptions)
       );
       if (currentExecutionId === executionId) {
         signature.value = nextSignature;

package/dist/shared/vue.D1knFN3X.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+const wallet = require('@vue-solana/core/wallet');
+const vue = require('vue');
+const useWallet = require('./vue.BwipRa1w.cjs');
+
+function useSignMessage() {
+  const { wallet: wallet$1 } = useWallet.useWallet();
+  const signedMessage = vue.ref(null);
+  const signature = vue.ref(null);
+  const status = vue.ref("idle");
+  const loading = vue.ref(false);
+  const error = vue.ref(null);
+  let executionId = 0;
+  async function execute(message) {
+    const currentExecutionId = ++executionId;
+    status.value = "signing";
+    loading.value = true;
+    error.value = null;
+    signedMessage.value = null;
+    signature.value = null;
+    const activeWallet = wallet$1.value;
+    if (!activeWallet) {
+      const cause = new Error("No Solana wallet is configured");
+      error.value = cause;
+      status.value = "error";
+      loading.value = false;
+      throw cause;
+    }
+    try {
+      wallet.assertWalletCanSignMessage(activeWallet);
+      const result = await activeWallet.signMessage(message);
+      if (currentExecutionId === executionId) {
+        signedMessage.value = result.signedMessage;
+        signature.value = result.signature;
+        status.value = "signed";
+      }
+      return result;
+    } catch (cause) {
+      const normalizedError = normalizeError(cause);
+      if (currentExecutionId === executionId) {
+        error.value = normalizedError;
+        status.value = "error";
+      }
+      throw normalizedError;
+    } finally {
+      if (currentExecutionId === executionId) {
+        loading.value = false;
+      }
+    }
+  }
+  return {
+    signedMessage,
+    signature,
+    status,
+    loading,
+    error,
+    execute
+  };
+}
+function normalizeError(cause) {
+  return cause instanceof Error ? cause : new Error(String(cause));
+}
+
+exports.useSignMessage = useSignMessage;

package/dist/shared/{vue.DEQJ23UM.cjs → vue.DWiQYhb8.cjs}

@@ -3,7 +3,7 @@
 const transaction = require('@vue-solana/core/transaction');
 const vue = require('vue');
 const useConnection = require('./vue.CwhEmATP.cjs');
-const useWallet = require('./vue.CwPjPFN6.cjs');
+const useWallet = require('./vue.BwipRa1w.cjs');
 const useTransactionConfirmation = require('./vue.DHVYJk8P.cjs');
 
 const SIGN_AND_SEND_TIMEOUT_MS = 12e4;
@@ -24,12 +24,17 @@ function useSignAndSendTransaction() {
     loading.value = true;
     error.value = null;
     confirmation.value = null;
+    const activeWallet = wallet.value;
+    if (!activeWallet) {
+      const cause = new Error("No Solana wallet is configured");
+      error.value = cause;
+      status.value = "error";
+      loading.value = false;
+      throw cause;
+    }
     try {
-      if (!wallet.value) {
-        throw new Error("No Solana wallet is configured");
-      }
       const nextSignature = await withWalletTransactionTimeout(
-        transaction.signAndSendTransaction(connection, wallet.value, transaction$1, transactionOptions)
+        transaction.signAndSendTransaction(connection, activeWallet, transaction$1, transactionOptions)
       );
       if (currentExecutionId === executionId) {
         signature.value = nextSignature;

package/dist/useSignAndSendTransaction.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-const useSignAndSendTransaction = require('./shared/vue.DEQJ23UM.cjs');
+const useSignAndSendTransaction = require('./shared/vue.DWiQYhb8.cjs');
 require('@vue-solana/core/transaction');
 require('vue');
 require('./shared/vue.CwhEmATP.cjs');
 require('./shared/vue.COyyrsQU.cjs');
 require('./shared/vue.C4tLiG3R.cjs');
-require('./shared/vue.CwPjPFN6.cjs');
+require('./shared/vue.BwipRa1w.cjs');
 require('./shared/vue.DHVYJk8P.cjs');
 
 

package/dist/useSignAndSendTransaction.mjs

@@ -1,8 +1,8 @@
-export { u as useSignAndSendTransaction } from './shared/vue.RQ9fETnm.mjs';
+export { u as useSignAndSendTransaction } from './shared/vue.CM6qb_s8.mjs';
 import '@vue-solana/core/transaction';
 import 'vue';
 import './shared/vue.DlEAL2G8.mjs';
 import './shared/vue.BqDzSepb.mjs';
 import './shared/vue.1M_c5FWA.mjs';
-import './shared/vue.DYf_CRDv.mjs';
+import './shared/vue.CGVdFmYI.mjs';
 import './shared/vue.jOsz34kz.mjs';

package/dist/useSignMessage.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+const useSignMessage = require('./shared/vue.D1knFN3X.cjs');
+require('@vue-solana/core/wallet');
+require('vue');
+require('./shared/vue.BwipRa1w.cjs');
+require('./shared/vue.C4tLiG3R.cjs');
+
+
+
+exports.useSignMessage = useSignMessage.useSignMessage;