@vue-solana/vue 0.2.3 → 0.3.1

package/README.md

@@ -16,11 +16,11 @@ New to Solana? Start with the official docs and the project concepts guide:
 ## Install
 
 ```sh
-pnpm add @vue-solana/vue @vue-solana/core @solana/web3-compat
+pnpm add @vue-solana/vue @vue-solana/core @solana/web3-compat buffer
 ```
 
 ```sh
-npm install @vue-solana/vue @vue-solana/core @solana/web3-compat
+npm install @vue-solana/vue @vue-solana/core @solana/web3-compat buffer
 ```
 
 ## Plugin Setup
@@ -34,11 +34,20 @@ createApp(App)
   .use(
     createSolanaPlugin({
       cluster: "devnet",
+      mobileWallet: {
+        appIdentity: {
+          name: "My Vue Solana App",
+          uri: "https://example.com",
+          icon: "favicon.ico",
+        },
+      },
     }),
   )
   .mount("#app");
 ```
 
+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.
+
 You can also pass a custom RPC endpoint:
 
 ```ts
@@ -142,7 +151,9 @@ const { publicKey, connected, connecting, connect, disconnect } = useWallet();
 </template>
 ```
 
-Browser wallets are discovered through the Solana Wallet Standard. `connect()` works after selecting a discovered wallet or configuring a custom `SolanaWallet`.
+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. `connect()` works after selecting a discovered wallet or configuring a custom `SolanaWallet`.
+
+iOS browser wallet adapters and 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.
 
@@ -180,6 +191,7 @@ Live demo: [vue-solana-docs.vercel.app/demo](https://vue-solana-docs.vercel.app/
 - `useRpc()`: returns cluster, endpoint, connection status, latest blockhash, and `checkConnection()`.
 - `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, and wallet selection actions.
 - `useBalance(address, commitment?)`: loads lamport balance for a `PublicKey` or address string.
 - `useTransaction(handler)`: generic async transaction state helper.
 - `useSignAndSendTransaction()`: signs and sends a transaction through the configured wallet.
@@ -220,4 +232,4 @@ Make sure your `tsconfig.json` includes `types/**/*.d.ts` or another pattern tha
 
 ## Status
 
-This package is early-stage. RPC, balance, wallet, and transaction composables are usable.
+This package is early-stage. RPC, balance, browser extension wallet, Android mobile wallet, and transaction composables are usable.

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const useBalance = require('./shared/vue.CjKm-Cw1.cjs');
+const useBalance = require('./shared/vue.CNkyBND6.cjs');
 const useConnection = require('./shared/vue.CwhEmATP.cjs');
 const useRpc = require('./shared/vue.COyyrsQU.cjs');
 const useSignAndSendTransaction = require('./shared/vue.CTM6XQ47.cjs');
@@ -26,6 +26,7 @@ function createSolanaPlugin(options = {}) {
       const latestBlockhash = vue.ref(null);
       const adaptedWallets = /* @__PURE__ */ new WeakMap();
       let unsubscribeWallets = null;
+      let mobileWalletRegistrationPromise = null;
       let rpcCheckId = 0;
       async function checkConnection() {
         const checkId = ++rpcCheckId;
@@ -71,6 +72,22 @@ function createSolanaPlugin(options = {}) {
             wallet.value = options.wallet ?? null;
           }
         }
+        if (options.mobileWallet !== false) {
+          registerMobileWallets();
+        }
+      }
+      function registerMobileWallets() {
+        mobileWalletRegistrationPromise ??= import('@vue-solana/core/mobile-wallet').then(({ registerSolanaMobileWallet }) => {
+          registerSolanaMobileWallet({
+            chains: [walletStandard.getSolanaChain(context.cluster)],
+            ...options.mobileWallet || {}
+          });
+          wallets.value = walletStandard.getRegisteredSolanaWallets();
+        }).catch((cause) => {
+          console.error("[Vue Solana] Mobile wallet registration failed", cause);
+        }).finally(() => {
+          mobileWalletRegistrationPromise = null;
+        });
       }
       function selectWallet(nextWallet) {
         selectedWallet.value = nextWallet;
@@ -148,7 +165,9 @@ function createSolanaPlugin(options = {}) {
       };
       app.provide(useSolana.solanaInjectionKey, vueContext);
       if (typeof window !== "undefined") {
-        void checkConnection();
+        window.setTimeout(() => {
+          void checkConnection();
+        }, 0);
       }
     }
   };

package/dist/index.d.cts

@@ -7,12 +7,14 @@ export { useTransaction } from './useTransaction.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';
+import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
 import '@solana/web3-compat';
 
 interface VueSolanaPluginOptions extends SolanaConfig {
     wallet?: SolanaWallet | null;
+    mobileWallet?: false | RegisterSolanaMobileWalletOptions;
 }
 declare function createSolanaPlugin(options?: VueSolanaPluginOptions): {
     install(app: App): void;

package/dist/index.d.mts

@@ -7,12 +7,14 @@ export { useTransaction } from './useTransaction.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';
+import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
 import '@solana/web3-compat';
 
 interface VueSolanaPluginOptions extends SolanaConfig {
     wallet?: SolanaWallet | null;
+    mobileWallet?: false | RegisterSolanaMobileWalletOptions;
 }
 declare function createSolanaPlugin(options?: VueSolanaPluginOptions): {
     install(app: App): void;

package/dist/index.d.ts

@@ -7,12 +7,14 @@ export { useTransaction } from './useTransaction.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';
+import { RegisterSolanaMobileWalletOptions } from '@vue-solana/core/mobile-wallet';
 import { SolanaConfig, SolanaWallet } from '@vue-solana/core/types';
 import { App } from 'vue';
 import '@solana/web3-compat';
 
 interface VueSolanaPluginOptions extends SolanaConfig {
     wallet?: SolanaWallet | null;
+    mobileWallet?: false | RegisterSolanaMobileWalletOptions;
 }
 declare function createSolanaPlugin(options?: VueSolanaPluginOptions): {
     install(app: App): void;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { u as useBalance } from './shared/vue.D81obqiN.mjs';
+export { u as useBalance } from './shared/vue.CgR3nGpz.mjs';
 export { u as useConnection } from './shared/vue.DlEAL2G8.mjs';
 export { u as useRpc } from './shared/vue.BqDzSepb.mjs';
 export { u as useSignAndSendTransaction } from './shared/vue.PoQ8Vpmy.mjs';
@@ -25,6 +25,7 @@ function createSolanaPlugin(options = {}) {
       const latestBlockhash = ref(null);
       const adaptedWallets = /* @__PURE__ */ new WeakMap();
       let unsubscribeWallets = null;
+      let mobileWalletRegistrationPromise = null;
       let rpcCheckId = 0;
       async function checkConnection() {
         const checkId = ++rpcCheckId;
@@ -70,6 +71,22 @@ function createSolanaPlugin(options = {}) {
             wallet.value = options.wallet ?? null;
           }
         }
+        if (options.mobileWallet !== false) {
+          registerMobileWallets();
+        }
+      }
+      function registerMobileWallets() {
+        mobileWalletRegistrationPromise ??= import('@vue-solana/core/mobile-wallet').then(({ registerSolanaMobileWallet }) => {
+          registerSolanaMobileWallet({
+            chains: [getSolanaChain(context.cluster)],
+            ...options.mobileWallet || {}
+          });
+          wallets.value = getRegisteredSolanaWallets();
+        }).catch((cause) => {
+          console.error("[Vue Solana] Mobile wallet registration failed", cause);
+        }).finally(() => {
+          mobileWalletRegistrationPromise = null;
+        });
       }
       function selectWallet(nextWallet) {
         selectedWallet.value = nextWallet;
@@ -147,7 +164,9 @@ function createSolanaPlugin(options = {}) {
       };
       app.provide(solanaInjectionKey, vueContext);
       if (typeof window !== "undefined") {
-        void checkConnection();
+        window.setTimeout(() => {
+          void checkConnection();
+        }, 0);
       }
     }
   };

package/dist/shared/{vue.CjKm-Cw1.cjs → vue.CNkyBND6.cjs}

@@ -29,12 +29,14 @@ function useBalance(address, commitment) {
       loading.value = false;
     }
   }
+  vue.onMounted(() => {
+    void refresh().catch(() => void 0);
+  });
   vue.watch(
     () => vue.toValue(address),
     () => {
       void refresh().catch(() => void 0);
-    },
-    { immediate: true }
+    }
   );
   return {
     balance,

package/dist/shared/{vue.D81obqiN.mjs → vue.CgR3nGpz.mjs}

@@ -1,4 +1,4 @@
-import { ref, watch, toValue } from 'vue';
+import { ref, onMounted, watch, toValue } from 'vue';
 import { u as useConnection } from './vue.DlEAL2G8.mjs';
 import { t as tryUseSolana } from './vue.1M_c5FWA.mjs';
 
@@ -27,12 +27,14 @@ function useBalance(address, commitment) {
       loading.value = false;
     }
   }
+  onMounted(() => {
+    void refresh().catch(() => void 0);
+  });
   watch(
     () => toValue(address),
     () => {
       void refresh().catch(() => void 0);
-    },
-    { immediate: true }
+    }
   );
   return {
     balance,

package/dist/useBalance.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const useBalance = require('./shared/vue.CjKm-Cw1.cjs');
+const useBalance = require('./shared/vue.CNkyBND6.cjs');
 require('vue');
 require('./shared/vue.CwhEmATP.cjs');
 require('./shared/vue.COyyrsQU.cjs');

package/dist/useBalance.mjs

@@ -1,4 +1,4 @@
-export { u as useBalance } from './shared/vue.D81obqiN.mjs';
+export { u as useBalance } from './shared/vue.CgR3nGpz.mjs';
 import 'vue';
 import './shared/vue.DlEAL2G8.mjs';
 import './shared/vue.BqDzSepb.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/vue",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Vue plugin and composables for Solana applications.",
   "license": "MIT",
   "keywords": [
@@ -78,7 +78,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@vue-solana/core": "0.2.1"
+    "@vue-solana/core": "0.3.1"
   },
   "peerDependencies": {
     "@solana/web3-compat": "^0.0.21",