@vue-solana/nuxt 4.1.0 → 4.1.2

package/README.md

@@ -12,7 +12,9 @@ Nuxt module for Solana wallet, RPC, account, token, message signing, live data,
 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.).
+
 - [`@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.)
 
 This package builds on `@vue-solana/vue` and `@vue-solana/core`; it is the recommended entry point for Nuxt apps.
@@ -22,22 +24,35 @@ Use this package in Nuxt apps that need the Vue Solana plugin installed automati
 New to Solana? Start with the official docs and the project concepts guide:
 
 - [Solana Documentation](https://solana.com/docs)
+
 - [Solana RPC Methods](https://solana.com/docs/rpc)
+
 - [Solana Clusters](https://solana.com/docs/references/clusters)
+
 - [Vue Solana Concepts Guide](https://vue-solana-docs.vercel.app/concepts/solana-for-vue-developers)
+
 - [`@vue-solana/nuxt` docs](https://vue-solana-docs.vercel.app/packages/nuxt)
+
 - [Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
+
 - [Live demo](https://vue-solana-docs.vercel.app/demo)
 
 ## Features
 
 - Installs the Vue Solana plugin automatically.
-- Auto-imports Solana RPC, wallet, account, token, message signing, live data, and transaction composables.
+
+- Auto-imports Solana RPC, wallet, account, token, message signing, Solana Pay and QR, live data, and transaction composables.
+
 - Builds the default client with the official Kit RPC planner and transaction-sending executor; payer secrets are never accepted through public runtime config.
+
 - Uses direct Vue package subpaths to avoid pulling unrelated runtime code into Nuxt bundles.
+
 - Client-only runtime plugin with SSR-safe inert composable state before hydration.
+
 - Unified wallet discovery for browser extensions, Android Mobile Wallet Adapter, and supported iOS browser wallets.
+
 - App-wide selected wallet account context installed by the runtime plugin.
+
 - Nuxt 3 and Nuxt 4 support.
 
 ## Compatibility
@@ -49,6 +64,8 @@ New to Solana? Start with the official docs and the project concepts guide:
 | Solana client | Provided through `@vue-solana/core`                               |
 | Clusters      | `mainnet` (alias `mainnet-beta`), `devnet`, `testnet`, `localnet` |
 
+<br>
+
 ## Install
 
 ```sh
@@ -102,6 +119,8 @@ Nuxt module options are stored in public runtime config, so they must be JSON-se
 | `iosWallet`    | JSON-serializable iOS wallet options or `false`                      | Enabled on iOS browsers              | Configures or disables iOS browser wallet universal links (Phantom, Solflare, Backpack).      |
 | `clientPlugin` | `boolean`                                                            | `true`                               | Set to `false` to skip the module's runtime plugin and install `createSolanaPlugin` yourself. |
 
+<br>
+
 For development, use `devnet` and request free test SOL from the official faucet:
 
 ```txt
@@ -113,42 +132,79 @@ https://faucet.solana.com
 The module auto-imports these composables from direct `@vue-solana/vue/*` subpaths rather than the root Vue package barrel. This keeps Nuxt SSR bundles from pulling in unrelated Solana runtime code just because a page uses one composable.
 
 - `useSolana()`
+
 - `useSolanaClient()`
+
 - `useSolanaRpc()`
+
 - `useSolanaConnection()`
+
 - `useSolanaAccountInfo()`
+
 - `useSolanaAirdrop()`
+
 - `useSolanaBalance()`
+
 - `useSolanaProgramAccounts()`
+
 - `useSolanaTokenAccounts()`
+
 - `useSolanaTokenBalance()`
+
 - `useSolanaWallet()`
+
 - `useSolanaWallets()`
+
 - `useSolanaSignMessage()`
+
 - `useSolanaSignIn()`
+
 - `useSolanaPay()`
+
 - `useSolanaPayConfirmation()`
+
 - `useSolanaQrCode()`
+
 - `useSolanaQrScanner()`
+
 - `useSolanaSignAndSendTransaction()`
+
 - `useSolanaSignTransactions()`
+
 - `useSolanaSignAndSendTransactions()`
+
 - `useSolanaTransactionConfirmation()`
+
 - `useSolanaSignatureStatus()`
+
 - `useSolanaTransaction()`
+
 - `useSolanaAction()`
+
 - `useSolanaRequest()`
+
 - `useSolanaSubscription()`
+
 - `useSolanaTrackedData()`
+
 - `useSolanaRequestSwr()`
+
 - `useSolanaSubscriptionSwr()`
+
 - `useSolanaTrackedDataSwr()`
+
 - `useSolanaSelectedWalletAccount()`
+
 - `useSolanaPayer()`
+
 - `useSolanaIdentity()`
+
 - `useSolanaPlanTransaction()`
+
 - `useSolanaPlanTransactions()`
+
 - `useSolanaSendTransaction()`
+
 - `useSolanaSendTransactions()`
 
 | Composable                           | Purpose                                                                                                                                      |
@@ -167,7 +223,7 @@ The module auto-imports these composables from direct `@vue-solana/vue/*` subpat
 | `useSolanaWallets()`                 | Wallet discovery, selected wallet state, and selection actions.                                                                              |
 | `useSolanaSignMessage()`             | Wallet message signing.                                                                                                                      |
 | `useSolanaSignIn()`                  | Sign In With Solana (SIWS) trigger returning a server-verifiable result.                                                                     |
-| `useSolanaPay()`                     | Builds/parses Solana Pay transfer request URLs and tracks confirmation status by reference.                                                  |
+| `useSolanaPay()`                     | Builds/parses Solana Pay transfer request URLs, generates a reference, and verifies settlement against it.                                   |
 | `useSolanaPayConfirmation()`         | Polls payment status for a Solana Pay reference.                                                                                             |
 | `useSolanaQrCode()`                  | Renders a Solana Pay URL as an SVG QR code.                                                                                                  |
 | `useSolanaQrScanner()`               | Scans Solana Pay QR codes through the camera and `BarcodeDetector`.                                                                          |
@@ -198,6 +254,8 @@ The module auto-imports these composables from direct `@vue-solana/vue/*` subpat
 | `useSolanaSendTransaction()`         | Plans, signs, submits, and confirms one transaction through the client.                                                                      |
 | `useSolanaSendTransactions()`        | Sends a batch of transactions (parallel or sequential) through the client.                                                                   |
 
+<br>
+
 The default client built by the module composes `solanaRpc()` followed by `rpcAirdrop()` when no `commitment` is configured (a configured `commitment` builds the same stack explicitly so it reaches the RPC layer); `solanaRpc()` installs `rpcTransactionPlanner()`, `rpcTransactionPlanSigningExecutor()`, and `rpcTransactionPlanSendingExecutor()` itself. The old custom fallback sender is not used. `useSolanaSendTransaction()` and `useSolanaSendTransactions()` therefore use the official client-sending capability, but the module does not configure a payer because `payer` and `payerSecretKey` are omitted from `ModuleOptions`. Their `sent` status is reached after the official executor completes its send-and-confirm operation at `confirmed` commitment.
 
 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.
@@ -209,6 +267,7 @@ The module also installs the app-wide selected wallet account context, so `useSo
 The package also exposes Solana helper subpaths for Nuxt apps that need Kit re-exports or the browser Buffer polyfill without importing lower-level packages directly:
 
 - `@vue-solana/nuxt/kit`
+
 - `@vue-solana/nuxt/buffer-polyfill`
 
 ## Read RPC State
@@ -357,11 +416,17 @@ Docs: [Vue Solana Agent Skill](https://vue-solana-docs.vercel.app/agent-skill)
 ## Caveats
 
 - The runtime plugin is client-only. Auto-imported composables are SSR-safe, but real RPC and wallet work should run after hydration or in user actions.
+
 - The SWR cache (`useSolanaRequestSwr()`, `useSolanaSubscriptionSwr()`, `useSolanaTrackedDataSwr()`) is module-level and shared across SSR requests. Namespace cache keys per request or call `clearSwrCache()` (auto-imported) at the start of each server request to avoid leaking cached data between requests. The cache is capped at 1024 entries with oldest-first eviction; `deleteSwrKey()` (auto-imported) evicts a single key by its full cache key.
+
 - Nuxt module options are stored in public runtime config, so they must be JSON-serializable.
+
 - Public Solana RPC endpoints are useful for development, but production apps should use dedicated RPC infrastructure.
+
 - Broad `useSolanaProgramAccounts()` scans can be expensive or blocked on public RPC nodes. Prefer narrow filters and `dataSlice`.
+
 - Use `mainnet` for Solana mainnet. This is Solana's official mainnet cluster name; the legacy `mainnet-beta` spelling is still accepted and redirects to the same endpoint.
+
 - Desktop native app wallets are planned but not implemented yet.
 
 ## Status

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/nuxt",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "Nuxt module for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/vue": "4.1.0"
+    "@vue-solana/vue": "4.1.2"
   },
   "peerDependencies": {
     "nuxt": "^3.0.0 || ^4.0.0"