@vue-solana/core 0.1.2 → 0.2.0

package/README.md

@@ -14,9 +14,9 @@ Official Solana docs:
 
 Full Vue Solana docs:
 
-- [`@vue-solana/core`](https://github.com/vue-solana/vue-solana/tree/main/apps/docs/content/packages/core.md)
-- [Getting Started](https://github.com/vue-solana/vue-solana/tree/main/apps/docs/content/getting-started.md)
-- [Troubleshooting](https://github.com/vue-solana/vue-solana/tree/main/apps/docs/content/troubleshooting.md)
+- [`@vue-solana/core`](https://vue-solana-docs.vercel.app/packages/core)
+- [Getting Started](https://vue-solana-docs.vercel.app/getting-started)
+- [Troubleshooting](https://vue-solana-docs.vercel.app/troubleshooting)
 
 ## Install
 
@@ -31,29 +31,29 @@ npm install @vue-solana/core @solana/web3-compat
 ## Quick Start
 
 ```ts
-import { createSolanaContext } from '@vue-solana/core'
+import { createSolanaContext } from "@vue-solana/core";
 
 const solana = createSolanaContext({
-  cluster: 'devnet'
-})
+  cluster: "devnet",
+});
 
-const { blockhash } = await solana.connection.getLatestBlockhash()
+const { blockhash } = await solana.connection.getLatestBlockhash();
 
-console.log(solana.endpoint, blockhash)
+console.log(solana.endpoint, blockhash);
 ```
 
 ## Configuration
 
 ```ts
-import type { SolanaConfig } from '@vue-solana/core'
+import type { SolanaConfig } from "@vue-solana/core";
 
 const config: SolanaConfig = {
-  cluster: 'devnet',
-  endpoint: 'https://api.devnet.solana.com',
-  wsEndpoint: 'wss://api.devnet.solana.com',
-  commitment: 'confirmed',
-  autoConnect: false
-}
+  cluster: "devnet",
+  endpoint: "https://api.devnet.solana.com",
+  wsEndpoint: "wss://api.devnet.solana.com",
+  commitment: "confirmed",
+  autoConnect: false,
+};
 ```
 
 Supported clusters are `mainnet-beta`, `testnet`, `devnet`, and `localnet`. If `endpoint` is omitted, the package uses the public Solana RPC endpoint for the selected cluster. If `wsEndpoint` is omitted, it is derived from the RPC endpoint.
@@ -82,25 +82,25 @@ https://faucet.solana.com
 ## Wallet Interface
 
 ```ts
-import type { SolanaWallet } from '@vue-solana/core'
+import type { SolanaWallet } from "@vue-solana/core";
 
 const wallet: SolanaWallet = {
   publicKey: null,
   connected: false,
   connect: async () => {},
   disconnect: async () => {},
-  signTransaction: async transaction => transaction
-}
+  signTransaction: async (transaction) => transaction,
+};
 ```
 
-Browser wallet discovery is not included yet. If you need wallet connection or transaction signing today, provide an object that implements `SolanaWallet`.
+Browser wallets discovered through the Solana Wallet Standard are adapted into `SolanaWallet`. You can also provide a custom object that implements `SolanaWallet` for tests or custom adapters.
 
 ## Examples
 
 For complete runnable Vue and Nuxt examples that use this package through the framework integrations, see:
 
-- [`examples/vue-vite`](https://github.com/vue-solana/vue-solana/tree/main/examples/vue-vite)
-- [`examples/nuxt`](https://github.com/vue-solana/vue-solana/tree/main/examples/nuxt)
+- [`examples/vue-vite`](https://vue-solana-docs.vercel.app/examples/vue-vite)
+- [`examples/nuxt`](https://vue-solana-docs.vercel.app/examples/nuxt)
 
 ## Known TypeScript Issue
 
@@ -109,12 +109,8 @@ For complete runnable Vue and Nuxt examples that use this package through the fr
 If TypeScript cannot resolve `@solana/web3-compat`, add `types/web3-compat.d.ts` to your app:
 
 ```ts
-declare module '@solana/web3-compat' {
-  export type {
-    Commitment,
-    SendOptions,
-    TransactionSignature
-  } from '@solana/web3.js'
+declare module "@solana/web3-compat" {
+  export type { Commitment, SendOptions, TransactionSignature } from "@solana/web3.js";
   export {
     Connection,
     Keypair,
@@ -122,8 +118,8 @@ declare module '@solana/web3-compat' {
     SystemProgram,
     Transaction,
     TransactionInstruction,
-    VersionedTransaction
-  } from '@solana/web3.js'
+    VersionedTransaction,
+  } from "@solana/web3.js";
 }
 ```
 
@@ -131,4 +127,4 @@ Make sure your `tsconfig.json` includes `types/**/*.d.ts` or another pattern tha
 
 ## Status
 
-This package is early-stage. RPC helpers and transaction primitives are usable; first-class browser wallet adapter support is planned.
+This package is early-stage. RPC helpers, wallet primitives, and transaction helpers are usable.

package/dist/index.cjs

@@ -1,6 +1,14 @@
 'use strict';
 
 const web3Compat = require('@solana/web3-compat');
+const app = require('@wallet-standard/app');
+const features = require('@wallet-standard/features');
+const walletStandardFeatures = require('@solana/wallet-standard-features');
+const bs58 = require('bs58');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const bs58__default = /*#__PURE__*/_interopDefaultCompat(bs58);
 
 const DEFAULT_CLUSTER = "devnet";
 const CLUSTER_ENDPOINTS = {
@@ -82,13 +90,214 @@ async function signAndSendTransaction(connection, wallet, transaction, options)
   return connection.sendRawTransaction(rawTransaction, options);
 }
 
+const SOLANA_CHAINS = [
+  "solana:mainnet",
+  "solana:testnet",
+  "solana:devnet",
+  "solana:localnet"
+];
+function getSolanaChain(cluster) {
+  if (cluster === "mainnet-beta") {
+    return "solana:mainnet";
+  }
+  return `solana:${cluster}`;
+}
+function isSolanaStandardWallet(wallet) {
+  return features.StandardConnect in wallet.features && features.StandardDisconnect in wallet.features && wallet.chains.some((chain) => SOLANA_CHAINS.includes(chain));
+}
+function getRegisteredSolanaWallets() {
+  if (typeof window === "undefined") {
+    return [];
+  }
+  return app.getWallets().get().filter(isSolanaStandardWallet).map(createSolanaWalletInfo);
+}
+function subscribeSolanaWallets(listener) {
+  if (typeof window === "undefined") {
+    return () => {
+    };
+  }
+  const wallets = app.getWallets();
+  const offRegister = wallets.on("register", listener);
+  const offUnregister = wallets.on("unregister", listener);
+  return () => {
+    offRegister();
+    offUnregister();
+  };
+}
+function adaptSolanaStandardWallet(walletInfo, options = {}) {
+  const wallet = walletInfo.wallet;
+  let accounts = wallet.accounts;
+  let account = options.account;
+  let allowAccountUpdates = Boolean(options.account);
+  let connecting = false;
+  let disconnecting = false;
+  let manuallyDisconnected = false;
+  const eventsFeature = wallet.features[features.StandardEvents];
+  eventsFeature?.on("change", (properties) => {
+    if (properties.accounts) {
+      accounts = properties.accounts;
+      account = allowAccountUpdates && !manuallyDisconnected ? getSolanaAccount(accounts, options.chain) : void 0;
+      options.onChange?.();
+    }
+  });
+  return {
+    get publicKey() {
+      return account ? new web3Compat.PublicKey(account.publicKey) : null;
+    },
+    get connected() {
+      return Boolean(account);
+    },
+    get connecting() {
+      return connecting;
+    },
+    get disconnecting() {
+      return disconnecting;
+    },
+    async connect() {
+      connecting = true;
+      manuallyDisconnected = false;
+      options.onChange?.();
+      try {
+        const feature = wallet.features[features.StandardConnect];
+        const result = await feature.connect();
+        accounts = result.accounts;
+        allowAccountUpdates = true;
+        account = getSolanaAccount(accounts, options.chain);
+        if (!account) {
+          throw new Error("Solana wallet did not authorize a Solana account");
+        }
+      } finally {
+        connecting = false;
+        options.onChange?.();
+      }
+    },
+    async disconnect() {
+      const feature = wallet.features[features.StandardDisconnect];
+      disconnecting = true;
+      manuallyDisconnected = true;
+      allowAccountUpdates = false;
+      account = void 0;
+      options.onChange?.();
+      try {
+        await feature.disconnect();
+        accounts = [];
+        account = void 0;
+      } catch (error) {
+        manuallyDisconnected = false;
+        allowAccountUpdates = true;
+        account = getSolanaAccount(accounts, options.chain);
+        throw error;
+      } finally {
+        disconnecting = false;
+        options.onChange?.();
+      }
+    },
+    signTransaction: hasSignTransaction(wallet) ? async (transaction) => {
+      const activeAccount = getActiveAccount(account);
+      const [result] = await wallet.features[walletStandardFeatures.SolanaSignTransaction].signTransaction({
+        account: activeAccount,
+        transaction: serializeTransaction(transaction),
+        chain: options.chain
+      });
+      if (!result) {
+        throw new Error("Solana wallet did not return a signed transaction");
+      }
+      return deserializeTransaction(transaction, result.signedTransaction);
+    } : void 0,
+    signAllTransactions: hasSignTransaction(wallet) ? async (transactions) => {
+      const activeAccount = getActiveAccount(account);
+      const results = await wallet.features[walletStandardFeatures.SolanaSignTransaction].signTransaction(
+        ...transactions.map((transaction) => ({
+          account: activeAccount,
+          transaction: serializeTransaction(transaction),
+          chain: options.chain
+        }))
+      );
+      return results.map(
+        (result, index) => deserializeTransaction(transactions[index], result.signedTransaction)
+      );
+    } : void 0,
+    signAndSendTransaction: hasSignAndSendTransaction(wallet) ? async (transaction, sendOptions) => {
+      const activeAccount = getActiveAccount(account);
+      const [result] = await wallet.features[walletStandardFeatures.SolanaSignAndSendTransaction].signAndSendTransaction({
+        account: activeAccount,
+        transaction: serializeTransaction(transaction),
+        chain: options.chain ?? getSolanaAccountChain(activeAccount),
+        options: sendOptions
+      });
+      if (!result) {
+        throw new Error("Solana wallet did not return a transaction signature");
+      }
+      return { signature: bs58__default.encode(result.signature) };
+    } : void 0
+  };
+}
+function createSolanaWalletInfo(wallet) {
+  return {
+    name: wallet.name,
+    icon: wallet.icon,
+    chains: wallet.chains,
+    accounts: wallet.accounts.map((account) => ({
+      address: account.address,
+      publicKey: Uint8Array.from(account.publicKey),
+      chains: account.chains,
+      label: account.label,
+      icon: account.icon
+    })),
+    wallet
+  };
+}
+function getSolanaAccount(accounts, chain) {
+  return accounts.find((account) => account.chains.some((accountChain) => accountChain === chain)) ?? accounts.find(
+    (account) => account.chains.some((accountChain) => SOLANA_CHAINS.includes(accountChain))
+  );
+}
+function getActiveAccount(account) {
+  if (!account) {
+    throw new Error("Solana wallet is not connected");
+  }
+  return account;
+}
+function getSolanaAccountChain(account) {
+  const chain = account.chains.find(
+    (accountChain) => SOLANA_CHAINS.includes(accountChain)
+  );
+  if (!chain) {
+    throw new Error("Solana wallet account does not support a Solana chain");
+  }
+  return chain;
+}
+function hasSignTransaction(wallet) {
+  return walletStandardFeatures.SolanaSignTransaction in wallet.features;
+}
+function hasSignAndSendTransaction(wallet) {
+  return walletStandardFeatures.SolanaSignAndSendTransaction in wallet.features;
+}
+function serializeTransaction(transaction) {
+  if (transaction instanceof web3Compat.Transaction) {
+    return transaction.serialize({ requireAllSignatures: false, verifySignatures: false });
+  }
+  return transaction.serialize();
+}
+function deserializeTransaction(source, bytes) {
+  if (source instanceof web3Compat.Transaction) {
+    return web3Compat.Transaction.from(bytes);
+  }
+  return web3Compat.VersionedTransaction.deserialize(bytes);
+}
+
 exports.DEFAULT_CLUSTER = DEFAULT_CLUSTER;
+exports.adaptSolanaStandardWallet = adaptSolanaStandardWallet;
 exports.assertWalletCanSign = assertWalletCanSign;
 exports.assertWalletConnected = assertWalletConnected;
 exports.createSolanaConnection = createSolanaConnection;
 exports.createSolanaContext = createSolanaContext;
 exports.getClusterEndpoint = getClusterEndpoint;
 exports.getClusterWebSocketEndpoint = getClusterWebSocketEndpoint;
+exports.getRegisteredSolanaWallets = getRegisteredSolanaWallets;
+exports.getSolanaChain = getSolanaChain;
 exports.getWebSocketEndpoint = getWebSocketEndpoint;
+exports.isSolanaStandardWallet = isSolanaStandardWallet;
 exports.isWalletConnected = isWalletConnected;
 exports.signAndSendTransaction = signAndSendTransaction;
+exports.subscribeSolanaWallets = subscribeSolanaWallets;

package/dist/index.d.cts

@@ -1,6 +1,8 @@
 import { SendOptions, Commitment, Connection, Transaction, VersionedTransaction, PublicKey, TransactionSignature } from '@solana/web3-compat';
+import { WalletAccount, Wallet } from '@wallet-standard/base';
 
-type SolanaCluster = 'mainnet-beta' | 'testnet' | 'devnet' | 'localnet';
+type SolanaCluster = "mainnet-beta" | "testnet" | "devnet" | "localnet";
+type SolanaChain = "solana:mainnet" | "solana:testnet" | "solana:devnet" | "solana:localnet";
 interface SolanaConfig {
     cluster?: SolanaCluster;
     endpoint?: string;
@@ -19,6 +21,7 @@ interface SolanaWallet {
     publicKey: PublicKey | null;
     connected: boolean;
     connecting?: boolean;
+    disconnecting?: boolean;
     connect: () => Promise<void>;
     disconnect: () => Promise<void>;
     signTransaction?: <T extends SolanaTransaction>(transaction: T) => Promise<T>;
@@ -27,6 +30,19 @@ interface SolanaWallet {
         signature: TransactionSignature;
     }>;
 }
+interface SolanaWalletInfo {
+    name: string;
+    icon: string;
+    chains: readonly string[];
+    accounts: readonly {
+        address: string;
+        publicKey: Uint8Array;
+        chains: readonly string[];
+        label?: string;
+        icon?: string;
+    }[];
+    wallet: unknown;
+}
 interface SendTransactionOptions extends SendOptions {
     skipPreflight?: boolean;
 }
@@ -41,11 +57,22 @@ declare function createSolanaContext(config?: SolanaConfig): SolanaContext;
 
 declare function signAndSendTransaction(connection: Connection, wallet: SolanaWallet, transaction: SolanaTransaction, options?: SendTransactionOptions): Promise<TransactionSignature>;
 
-declare function isWalletConnected(wallet: Pick<SolanaWallet, 'connected' | 'publicKey'> | null | undefined): boolean;
+declare function isWalletConnected(wallet: Pick<SolanaWallet, "connected" | "publicKey"> | null | undefined): boolean;
 declare function assertWalletConnected(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & {
-    publicKey: NonNullable<SolanaWallet['publicKey']>;
+    publicKey: NonNullable<SolanaWallet["publicKey"]>;
 };
-declare function assertWalletCanSign(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & Required<Pick<SolanaWallet, 'signTransaction'>>;
+declare function assertWalletCanSign(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & Required<Pick<SolanaWallet, "signTransaction">>;
+
+interface AdaptSolanaWalletOptions {
+    chain?: SolanaChain;
+    account?: WalletAccount;
+    onChange?: () => void;
+}
+declare function getSolanaChain(cluster: SolanaCluster): SolanaChain;
+declare function isSolanaStandardWallet(wallet: Wallet): boolean;
+declare function getRegisteredSolanaWallets(): SolanaWalletInfo[];
+declare function subscribeSolanaWallets(listener: () => void): () => void;
+declare function adaptSolanaStandardWallet(walletInfo: SolanaWalletInfo, options?: AdaptSolanaWalletOptions): SolanaWallet;
 
-export { DEFAULT_CLUSTER, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getWebSocketEndpoint, isWalletConnected, signAndSendTransaction };
-export type { SendTransactionOptions, SolanaCluster, SolanaConfig, SolanaContext, SolanaTransaction, SolanaWallet };
+export { DEFAULT_CLUSTER, adaptSolanaStandardWallet, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getRegisteredSolanaWallets, getSolanaChain, getWebSocketEndpoint, isSolanaStandardWallet, isWalletConnected, signAndSendTransaction, subscribeSolanaWallets };
+export type { AdaptSolanaWalletOptions, SendTransactionOptions, SolanaChain, SolanaCluster, SolanaConfig, SolanaContext, SolanaTransaction, SolanaWallet, SolanaWalletInfo };

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 import { SendOptions, Commitment, Connection, Transaction, VersionedTransaction, PublicKey, TransactionSignature } from '@solana/web3-compat';
+import { WalletAccount, Wallet } from '@wallet-standard/base';
 
-type SolanaCluster = 'mainnet-beta' | 'testnet' | 'devnet' | 'localnet';
+type SolanaCluster = "mainnet-beta" | "testnet" | "devnet" | "localnet";
+type SolanaChain = "solana:mainnet" | "solana:testnet" | "solana:devnet" | "solana:localnet";
 interface SolanaConfig {
     cluster?: SolanaCluster;
     endpoint?: string;
@@ -19,6 +21,7 @@ interface SolanaWallet {
     publicKey: PublicKey | null;
     connected: boolean;
     connecting?: boolean;
+    disconnecting?: boolean;
     connect: () => Promise<void>;
     disconnect: () => Promise<void>;
     signTransaction?: <T extends SolanaTransaction>(transaction: T) => Promise<T>;
@@ -27,6 +30,19 @@ interface SolanaWallet {
         signature: TransactionSignature;
     }>;
 }
+interface SolanaWalletInfo {
+    name: string;
+    icon: string;
+    chains: readonly string[];
+    accounts: readonly {
+        address: string;
+        publicKey: Uint8Array;
+        chains: readonly string[];
+        label?: string;
+        icon?: string;
+    }[];
+    wallet: unknown;
+}
 interface SendTransactionOptions extends SendOptions {
     skipPreflight?: boolean;
 }
@@ -41,11 +57,22 @@ declare function createSolanaContext(config?: SolanaConfig): SolanaContext;
 
 declare function signAndSendTransaction(connection: Connection, wallet: SolanaWallet, transaction: SolanaTransaction, options?: SendTransactionOptions): Promise<TransactionSignature>;
 
-declare function isWalletConnected(wallet: Pick<SolanaWallet, 'connected' | 'publicKey'> | null | undefined): boolean;
+declare function isWalletConnected(wallet: Pick<SolanaWallet, "connected" | "publicKey"> | null | undefined): boolean;
 declare function assertWalletConnected(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & {
-    publicKey: NonNullable<SolanaWallet['publicKey']>;
+    publicKey: NonNullable<SolanaWallet["publicKey"]>;
 };
-declare function assertWalletCanSign(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & Required<Pick<SolanaWallet, 'signTransaction'>>;
+declare function assertWalletCanSign(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & Required<Pick<SolanaWallet, "signTransaction">>;
+
+interface AdaptSolanaWalletOptions {
+    chain?: SolanaChain;
+    account?: WalletAccount;
+    onChange?: () => void;
+}
+declare function getSolanaChain(cluster: SolanaCluster): SolanaChain;
+declare function isSolanaStandardWallet(wallet: Wallet): boolean;
+declare function getRegisteredSolanaWallets(): SolanaWalletInfo[];
+declare function subscribeSolanaWallets(listener: () => void): () => void;
+declare function adaptSolanaStandardWallet(walletInfo: SolanaWalletInfo, options?: AdaptSolanaWalletOptions): SolanaWallet;
 
-export { DEFAULT_CLUSTER, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getWebSocketEndpoint, isWalletConnected, signAndSendTransaction };
-export type { SendTransactionOptions, SolanaCluster, SolanaConfig, SolanaContext, SolanaTransaction, SolanaWallet };
+export { DEFAULT_CLUSTER, adaptSolanaStandardWallet, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getRegisteredSolanaWallets, getSolanaChain, getWebSocketEndpoint, isSolanaStandardWallet, isWalletConnected, signAndSendTransaction, subscribeSolanaWallets };
+export type { AdaptSolanaWalletOptions, SendTransactionOptions, SolanaChain, SolanaCluster, SolanaConfig, SolanaContext, SolanaTransaction, SolanaWallet, SolanaWalletInfo };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { SendOptions, Commitment, Connection, Transaction, VersionedTransaction, PublicKey, TransactionSignature } from '@solana/web3-compat';
+import { WalletAccount, Wallet } from '@wallet-standard/base';
 
-type SolanaCluster = 'mainnet-beta' | 'testnet' | 'devnet' | 'localnet';
+type SolanaCluster = "mainnet-beta" | "testnet" | "devnet" | "localnet";
+type SolanaChain = "solana:mainnet" | "solana:testnet" | "solana:devnet" | "solana:localnet";
 interface SolanaConfig {
     cluster?: SolanaCluster;
     endpoint?: string;
@@ -19,6 +21,7 @@ interface SolanaWallet {
     publicKey: PublicKey | null;
     connected: boolean;
     connecting?: boolean;
+    disconnecting?: boolean;
     connect: () => Promise<void>;
     disconnect: () => Promise<void>;
     signTransaction?: <T extends SolanaTransaction>(transaction: T) => Promise<T>;
@@ -27,6 +30,19 @@ interface SolanaWallet {
         signature: TransactionSignature;
     }>;
 }
+interface SolanaWalletInfo {
+    name: string;
+    icon: string;
+    chains: readonly string[];
+    accounts: readonly {
+        address: string;
+        publicKey: Uint8Array;
+        chains: readonly string[];
+        label?: string;
+        icon?: string;
+    }[];
+    wallet: unknown;
+}
 interface SendTransactionOptions extends SendOptions {
     skipPreflight?: boolean;
 }
@@ -41,11 +57,22 @@ declare function createSolanaContext(config?: SolanaConfig): SolanaContext;
 
 declare function signAndSendTransaction(connection: Connection, wallet: SolanaWallet, transaction: SolanaTransaction, options?: SendTransactionOptions): Promise<TransactionSignature>;
 
-declare function isWalletConnected(wallet: Pick<SolanaWallet, 'connected' | 'publicKey'> | null | undefined): boolean;
+declare function isWalletConnected(wallet: Pick<SolanaWallet, "connected" | "publicKey"> | null | undefined): boolean;
 declare function assertWalletConnected(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & {
-    publicKey: NonNullable<SolanaWallet['publicKey']>;
+    publicKey: NonNullable<SolanaWallet["publicKey"]>;
 };
-declare function assertWalletCanSign(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & Required<Pick<SolanaWallet, 'signTransaction'>>;
+declare function assertWalletCanSign(wallet: SolanaWallet | null | undefined): asserts wallet is SolanaWallet & Required<Pick<SolanaWallet, "signTransaction">>;
+
+interface AdaptSolanaWalletOptions {
+    chain?: SolanaChain;
+    account?: WalletAccount;
+    onChange?: () => void;
+}
+declare function getSolanaChain(cluster: SolanaCluster): SolanaChain;
+declare function isSolanaStandardWallet(wallet: Wallet): boolean;
+declare function getRegisteredSolanaWallets(): SolanaWalletInfo[];
+declare function subscribeSolanaWallets(listener: () => void): () => void;
+declare function adaptSolanaStandardWallet(walletInfo: SolanaWalletInfo, options?: AdaptSolanaWalletOptions): SolanaWallet;
 
-export { DEFAULT_CLUSTER, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getWebSocketEndpoint, isWalletConnected, signAndSendTransaction };
-export type { SendTransactionOptions, SolanaCluster, SolanaConfig, SolanaContext, SolanaTransaction, SolanaWallet };
+export { DEFAULT_CLUSTER, adaptSolanaStandardWallet, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getRegisteredSolanaWallets, getSolanaChain, getWebSocketEndpoint, isSolanaStandardWallet, isWalletConnected, signAndSendTransaction, subscribeSolanaWallets };
+export type { AdaptSolanaWalletOptions, SendTransactionOptions, SolanaChain, SolanaCluster, SolanaConfig, SolanaContext, SolanaTransaction, SolanaWallet, SolanaWalletInfo };

package/dist/index.mjs

@@ -1,4 +1,8 @@
-import { Connection } from '@solana/web3-compat';
+import { Connection, PublicKey, Transaction, VersionedTransaction } from '@solana/web3-compat';
+import { getWallets } from '@wallet-standard/app';
+import { StandardEvents, StandardDisconnect, StandardConnect } from '@wallet-standard/features';
+import { SolanaSignAndSendTransaction, SolanaSignTransaction } from '@solana/wallet-standard-features';
+import bs58 from 'bs58';
 
 const DEFAULT_CLUSTER = "devnet";
 const CLUSTER_ENDPOINTS = {
@@ -80,4 +84,200 @@ async function signAndSendTransaction(connection, wallet, transaction, options)
   return connection.sendRawTransaction(rawTransaction, options);
 }
 
-export { DEFAULT_CLUSTER, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getWebSocketEndpoint, isWalletConnected, signAndSendTransaction };
+const SOLANA_CHAINS = [
+  "solana:mainnet",
+  "solana:testnet",
+  "solana:devnet",
+  "solana:localnet"
+];
+function getSolanaChain(cluster) {
+  if (cluster === "mainnet-beta") {
+    return "solana:mainnet";
+  }
+  return `solana:${cluster}`;
+}
+function isSolanaStandardWallet(wallet) {
+  return StandardConnect in wallet.features && StandardDisconnect in wallet.features && wallet.chains.some((chain) => SOLANA_CHAINS.includes(chain));
+}
+function getRegisteredSolanaWallets() {
+  if (typeof window === "undefined") {
+    return [];
+  }
+  return getWallets().get().filter(isSolanaStandardWallet).map(createSolanaWalletInfo);
+}
+function subscribeSolanaWallets(listener) {
+  if (typeof window === "undefined") {
+    return () => {
+    };
+  }
+  const wallets = getWallets();
+  const offRegister = wallets.on("register", listener);
+  const offUnregister = wallets.on("unregister", listener);
+  return () => {
+    offRegister();
+    offUnregister();
+  };
+}
+function adaptSolanaStandardWallet(walletInfo, options = {}) {
+  const wallet = walletInfo.wallet;
+  let accounts = wallet.accounts;
+  let account = options.account;
+  let allowAccountUpdates = Boolean(options.account);
+  let connecting = false;
+  let disconnecting = false;
+  let manuallyDisconnected = false;
+  const eventsFeature = wallet.features[StandardEvents];
+  eventsFeature?.on("change", (properties) => {
+    if (properties.accounts) {
+      accounts = properties.accounts;
+      account = allowAccountUpdates && !manuallyDisconnected ? getSolanaAccount(accounts, options.chain) : void 0;
+      options.onChange?.();
+    }
+  });
+  return {
+    get publicKey() {
+      return account ? new PublicKey(account.publicKey) : null;
+    },
+    get connected() {
+      return Boolean(account);
+    },
+    get connecting() {
+      return connecting;
+    },
+    get disconnecting() {
+      return disconnecting;
+    },
+    async connect() {
+      connecting = true;
+      manuallyDisconnected = false;
+      options.onChange?.();
+      try {
+        const feature = wallet.features[StandardConnect];
+        const result = await feature.connect();
+        accounts = result.accounts;
+        allowAccountUpdates = true;
+        account = getSolanaAccount(accounts, options.chain);
+        if (!account) {
+          throw new Error("Solana wallet did not authorize a Solana account");
+        }
+      } finally {
+        connecting = false;
+        options.onChange?.();
+      }
+    },
+    async disconnect() {
+      const feature = wallet.features[StandardDisconnect];
+      disconnecting = true;
+      manuallyDisconnected = true;
+      allowAccountUpdates = false;
+      account = void 0;
+      options.onChange?.();
+      try {
+        await feature.disconnect();
+        accounts = [];
+        account = void 0;
+      } catch (error) {
+        manuallyDisconnected = false;
+        allowAccountUpdates = true;
+        account = getSolanaAccount(accounts, options.chain);
+        throw error;
+      } finally {
+        disconnecting = false;
+        options.onChange?.();
+      }
+    },
+    signTransaction: hasSignTransaction(wallet) ? async (transaction) => {
+      const activeAccount = getActiveAccount(account);
+      const [result] = await wallet.features[SolanaSignTransaction].signTransaction({
+        account: activeAccount,
+        transaction: serializeTransaction(transaction),
+        chain: options.chain
+      });
+      if (!result) {
+        throw new Error("Solana wallet did not return a signed transaction");
+      }
+      return deserializeTransaction(transaction, result.signedTransaction);
+    } : void 0,
+    signAllTransactions: hasSignTransaction(wallet) ? async (transactions) => {
+      const activeAccount = getActiveAccount(account);
+      const results = await wallet.features[SolanaSignTransaction].signTransaction(
+        ...transactions.map((transaction) => ({
+          account: activeAccount,
+          transaction: serializeTransaction(transaction),
+          chain: options.chain
+        }))
+      );
+      return results.map(
+        (result, index) => deserializeTransaction(transactions[index], result.signedTransaction)
+      );
+    } : void 0,
+    signAndSendTransaction: hasSignAndSendTransaction(wallet) ? async (transaction, sendOptions) => {
+      const activeAccount = getActiveAccount(account);
+      const [result] = await wallet.features[SolanaSignAndSendTransaction].signAndSendTransaction({
+        account: activeAccount,
+        transaction: serializeTransaction(transaction),
+        chain: options.chain ?? getSolanaAccountChain(activeAccount),
+        options: sendOptions
+      });
+      if (!result) {
+        throw new Error("Solana wallet did not return a transaction signature");
+      }
+      return { signature: bs58.encode(result.signature) };
+    } : void 0
+  };
+}
+function createSolanaWalletInfo(wallet) {
+  return {
+    name: wallet.name,
+    icon: wallet.icon,
+    chains: wallet.chains,
+    accounts: wallet.accounts.map((account) => ({
+      address: account.address,
+      publicKey: Uint8Array.from(account.publicKey),
+      chains: account.chains,
+      label: account.label,
+      icon: account.icon
+    })),
+    wallet
+  };
+}
+function getSolanaAccount(accounts, chain) {
+  return accounts.find((account) => account.chains.some((accountChain) => accountChain === chain)) ?? accounts.find(
+    (account) => account.chains.some((accountChain) => SOLANA_CHAINS.includes(accountChain))
+  );
+}
+function getActiveAccount(account) {
+  if (!account) {
+    throw new Error("Solana wallet is not connected");
+  }
+  return account;
+}
+function getSolanaAccountChain(account) {
+  const chain = account.chains.find(
+    (accountChain) => SOLANA_CHAINS.includes(accountChain)
+  );
+  if (!chain) {
+    throw new Error("Solana wallet account does not support a Solana chain");
+  }
+  return chain;
+}
+function hasSignTransaction(wallet) {
+  return SolanaSignTransaction in wallet.features;
+}
+function hasSignAndSendTransaction(wallet) {
+  return SolanaSignAndSendTransaction in wallet.features;
+}
+function serializeTransaction(transaction) {
+  if (transaction instanceof Transaction) {
+    return transaction.serialize({ requireAllSignatures: false, verifySignatures: false });
+  }
+  return transaction.serialize();
+}
+function deserializeTransaction(source, bytes) {
+  if (source instanceof Transaction) {
+    return Transaction.from(bytes);
+  }
+  return VersionedTransaction.deserialize(bytes);
+}
+
+export { DEFAULT_CLUSTER, adaptSolanaStandardWallet, assertWalletCanSign, assertWalletConnected, createSolanaConnection, createSolanaContext, getClusterEndpoint, getClusterWebSocketEndpoint, getRegisteredSolanaWallets, getSolanaChain, getWebSocketEndpoint, isSolanaStandardWallet, isWalletConnected, signAndSendTransaction, subscribeSolanaWallets };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vue-solana/core",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Framework-agnostic primitives for Vue Solana libraries.",
   "license": "MIT",
   "keywords": [
@@ -38,7 +38,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@solana/web3-compat": "^0.0.21"
+    "@solana/wallet-standard-features": "^1.3.0",
+    "@solana/web3-compat": "^0.0.21",
+    "@wallet-standard/app": "^1.1.1",
+    "@wallet-standard/base": "^1.1.1",
+    "@wallet-standard/features": "^1.1.1",
+    "bs58": "^6.0.0"
   },
   "devDependencies": {
     "typescript": "^5.8.3",