@vue-solana/nuxt 0.5.0 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 Nuxt module for Solana applications.
 
-Use this package in Nuxt apps that need the Vue Solana plugin installed automatically plus auto-imported composables.
+Use this package in Nuxt apps that need the Vue Solana plugin installed automatically plus auto-imported composables for RPC, wallet state, message signing, and transactions.
 
 New to Solana? Start with the official docs and the project concepts guide:
 
@@ -65,10 +65,14 @@ The module auto-imports these composables from direct `@vue-solana/vue/*` subpat
 - `useSolana()`
 - `useSolanaRpc()`
 - `useSolanaConnection()`
+- `useSolanaAccountInfo()`
 - `useSolanaWallet()`
 - `useSolanaWallets()`
 - `useSolanaBalance()`
+- `useSolanaProgramAccounts()`
 - `useSolanaTransactionConfirmation()`
+- `useSolanaSignatureStatus()`
+- `useSolanaSignMessage()`
 - `useSolanaSignAndSendTransaction()`
 
 The runtime plugin is client-only. Auto-imported composables can be called during SSR and return inert state until hydration provides the real client context. Trigger RPC and wallet work from client lifecycle hooks or user actions.
@@ -111,12 +115,31 @@ const { balance, loading, error, refresh } = useSolanaBalance(address);
 </template>
 ```
 
+## Read Account Data
+
+```vue
+<script setup lang="ts">
+const address = ref("PASTE_A_SOLANA_ADDRESS");
+const programId = ref("PASTE_A_SOLANA_PROGRAM_ID");
+const signature = ref("PASTE_A_TRANSACTION_SIGNATURE");
+
+const account = useSolanaAccountInfo(address, { watch: true });
+const programAccounts = useSolanaProgramAccounts(programId, {
+  dataSlice: { offset: 0, length: 32 },
+  filters: [{ dataSize: 165 }],
+});
+const signatureStatus = useSolanaSignatureStatus(signature, { pollIntervalMs: 2_000 });
+</script>
+```
+
+Use `useSolanaProgramAccounts()` carefully on public RPC nodes. Prefer narrow filters, use `dataSlice` for partial reads, and avoid polling broad scans.
+
 ## Wallet State
 
 ```vue
 <script setup lang="ts">
 const { wallets, selectedWallet, selectWallet, refreshWallets } = useSolanaWallets();
-const { publicKey, connected, connect, disconnect } = useSolanaWallet();
+const { publicKey, connected, canSignMessage, connect, disconnect } = useSolanaWallet();
 </script>
 
 <template>
@@ -133,6 +156,7 @@ const { publicKey, connected, connect, disconnect } = useSolanaWallet();
     <p>Selected: {{ selectedWallet?.name ?? "None" }}</p>
     <p>Connected: {{ connected }}</p>
     <p>Public key: {{ publicKey?.toBase58() }}</p>
+    <p>Can sign messages: {{ canSignMessage }}</p>
     <button type="button" :disabled="!selectedWallet || connected" @click="connect">Connect</button>
     <button type="button" :disabled="!connected" @click="disconnect">Disconnect</button>
   </section>
@@ -143,6 +167,33 @@ Browser extension wallets are discovered through the Solana Wallet Standard. And
 
 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. Set `solana.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.
 
+## Message Signing
+
+```vue
+<script setup lang="ts">
+const { connected, canSignMessage } = useSolanaWallet();
+const { signature, status, error, execute } = useSolanaSignMessage();
+
+async function signIn() {
+  const message = new TextEncoder().encode("Sign in to My Nuxt Solana App");
+  await execute(message);
+}
+</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 is for wallet ownership or authentication challenges. It is separate from transaction signing and does not authorize on-chain activity. For auth flows, use a server-issued nonce and verify the returned signature server-side.
+
 ## Example App
 
 This README includes small snippets for quick reference. For a complete runnable Nuxt flow, see the example app:
@@ -174,10 +225,12 @@ If TypeScript cannot resolve `@solana/web3-compat`, add `types/web3-compat.d.ts`
 ```ts
 declare module "@solana/web3-compat" {
   export type {
+    AccountInfo,
     Commitment,
     RpcResponseAndContext,
     SendOptions,
     SignatureResult,
+    SignatureStatus,
     TransactionSignature,
   } from "@solana/web3.js";
   export {
@@ -196,4 +249,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 in Nuxt apps.
+This package is early-stage. RPC, balance, browser extension wallet, Android mobile wallet, iOS browser wallet, message signing, and transaction composables are usable in Nuxt apps.

package/dist/module.cjs

@@ -3,6 +3,26 @@
 const kit = require('@nuxt/kit');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+const SOLANA_COMPOSABLE_IMPORTS = [
+  ["useAccountInfo", "useSolanaAccountInfo"],
+  ["useBalance", "useSolanaBalance"],
+  ["useConnection", "useSolanaConnection"],
+  ["useProgramAccounts", "useSolanaProgramAccounts"],
+  ["useRpc", "useSolanaRpc"],
+  ["useSignMessage", "useSolanaSignMessage"],
+  ["useSignAndSendTransaction", "useSolanaSignAndSendTransaction"],
+  ["useSignatureStatus", "useSolanaSignatureStatus"],
+  ["useSolana", "useSolana"],
+  ["useTransactionConfirmation", "useSolanaTransactionConfirmation"],
+  ["useWallet", "useSolanaWallet"],
+  ["useWallets", "useSolanaWallets"]
+];
+const SOLANA_IMPORTS = SOLANA_COMPOSABLE_IMPORTS.map(([name, as]) => ({
+  name,
+  as,
+  from: `@vue-solana/vue/${name}`
+}));
+
 const VITE_OPTIMIZE_DEPS = [
   "@solana/web3-compat",
   "@solana/web3.js",
@@ -50,24 +70,7 @@ const module$1 = kit.defineNuxtModule({
       src: resolver.resolve("./runtime/plugin"),
       mode: "client"
     });
-    kit.addImports([
-      { name: "useBalance", as: "useSolanaBalance", from: "@vue-solana/vue/useBalance" },
-      { name: "useConnection", as: "useSolanaConnection", from: "@vue-solana/vue/useConnection" },
-      { name: "useRpc", as: "useSolanaRpc", from: "@vue-solana/vue/useRpc" },
-      {
-        name: "useSignAndSendTransaction",
-        as: "useSolanaSignAndSendTransaction",
-        from: "@vue-solana/vue/useSignAndSendTransaction"
-      },
-      { name: "useSolana", as: "useSolana", from: "@vue-solana/vue/useSolana" },
-      {
-        name: "useTransactionConfirmation",
-        as: "useSolanaTransactionConfirmation",
-        from: "@vue-solana/vue/useTransactionConfirmation"
-      },
-      { name: "useWallet", as: "useSolanaWallet", from: "@vue-solana/vue/useWallet" },
-      { name: "useWallets", as: "useSolanaWallets", from: "@vue-solana/vue/useWallets" }
-    ]);
+    kit.addImports(SOLANA_IMPORTS);
   }
 });
 function toPublicSolanaConfig(options) {

package/dist/module.mjs

@@ -1,5 +1,25 @@
 import { defineNuxtModule, createResolver, addPlugin, addImports } from '@nuxt/kit';
 
+const SOLANA_COMPOSABLE_IMPORTS = [
+  ["useAccountInfo", "useSolanaAccountInfo"],
+  ["useBalance", "useSolanaBalance"],
+  ["useConnection", "useSolanaConnection"],
+  ["useProgramAccounts", "useSolanaProgramAccounts"],
+  ["useRpc", "useSolanaRpc"],
+  ["useSignMessage", "useSolanaSignMessage"],
+  ["useSignAndSendTransaction", "useSolanaSignAndSendTransaction"],
+  ["useSignatureStatus", "useSolanaSignatureStatus"],
+  ["useSolana", "useSolana"],
+  ["useTransactionConfirmation", "useSolanaTransactionConfirmation"],
+  ["useWallet", "useSolanaWallet"],
+  ["useWallets", "useSolanaWallets"]
+];
+const SOLANA_IMPORTS = SOLANA_COMPOSABLE_IMPORTS.map(([name, as]) => ({
+  name,
+  as,
+  from: `@vue-solana/vue/${name}`
+}));
+
 const VITE_OPTIMIZE_DEPS = [
   "@solana/web3-compat",
   "@solana/web3.js",
@@ -47,24 +67,7 @@ const module$1 = defineNuxtModule({
       src: resolver.resolve("./runtime/plugin"),
       mode: "client"
     });
-    addImports([
-      { name: "useBalance", as: "useSolanaBalance", from: "@vue-solana/vue/useBalance" },
-      { name: "useConnection", as: "useSolanaConnection", from: "@vue-solana/vue/useConnection" },
-      { name: "useRpc", as: "useSolanaRpc", from: "@vue-solana/vue/useRpc" },
-      {
-        name: "useSignAndSendTransaction",
-        as: "useSolanaSignAndSendTransaction",
-        from: "@vue-solana/vue/useSignAndSendTransaction"
-      },
-      { name: "useSolana", as: "useSolana", from: "@vue-solana/vue/useSolana" },
-      {
-        name: "useTransactionConfirmation",
-        as: "useSolanaTransactionConfirmation",
-        from: "@vue-solana/vue/useTransactionConfirmation"
-      },
-      { name: "useWallet", as: "useSolanaWallet", from: "@vue-solana/vue/useWallet" },
-      { name: "useWallets", as: "useSolanaWallets", from: "@vue-solana/vue/useWallets" }
-    ]);
+    addImports(SOLANA_IMPORTS);
   }
 });
 function toPublicSolanaConfig(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/nuxt",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Nuxt module for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -38,8 +38,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/core": "0.5.0",
-    "@vue-solana/vue": "0.6.0"
+    "@vue-solana/core": "0.6.0",
+    "@vue-solana/vue": "0.7.0"
   },
   "peerDependencies": {
     "@solana/web3-compat": "^0.0.21",