@vue-solana/core 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vue-solana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,130 @@
+# @vue-solana/core
+
+Framework-agnostic Solana primitives used by the Vue Solana packages.
+
+Use this package directly when you want connection helpers, shared wallet types, and transaction helpers without installing the Vue plugin.
+
+`@vue-solana/core` does not replace `@solana/web3-compat`. Use `@solana/web3-compat` for raw Solana primitives like `Connection`, `PublicKey`, and transactions. Use `@vue-solana/core` for Vue Solana shared configuration, cluster endpoint defaults, wallet interfaces, and transaction helpers.
+
+Official Solana docs:
+
+- [Solana Documentation](https://solana.com/docs)
+- [Solana RPC Methods](https://solana.com/docs/rpc)
+- [Solana Clusters](https://solana.com/docs/references/clusters)
+
+Full Vue Solana docs:
+
+- [`@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
+
+```sh
+pnpm add @vue-solana/core @solana/web3-compat
+```
+
+```sh
+npm install @vue-solana/core @solana/web3-compat
+```
+
+## Quick Start
+
+```ts
+import { createSolanaContext } from "@vue-solana/core";
+
+const solana = createSolanaContext({
+  cluster: "devnet",
+});
+
+const { blockhash } = await solana.connection.getLatestBlockhash();
+
+console.log(solana.endpoint, blockhash);
+```
+
+## Configuration
+
+```ts
+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,
+};
+```
+
+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.
+
+Use `mainnet-beta` for Solana mainnet. This is Solana's official cluster name; the package intentionally does not use `mainnet` as an alias.
+
+For development, use `devnet` and request free test SOL from the official faucet:
+
+```txt
+https://faucet.solana.com
+```
+
+## API
+
+- `DEFAULT_CLUSTER`: default cluster, currently `devnet`.
+- `createSolanaConnection(config?)`: creates a `Connection`.
+- `createSolanaContext(config?)`: creates `{ cluster, endpoint, wsEndpoint, connection }`.
+- `getClusterEndpoint(cluster?)`: returns the HTTP RPC endpoint for a cluster.
+- `getClusterWebSocketEndpoint(cluster?)`: returns the WebSocket endpoint for a cluster.
+- `getWebSocketEndpoint(endpoint)`: converts `http`/`https` RPC URLs to `ws`/`wss` URLs.
+- `isWalletConnected(wallet)`: checks whether a wallet is connected and has a public key.
+- `assertWalletConnected(wallet)`: throws if the wallet is not connected.
+- `assertWalletCanSign(wallet)`: throws if the wallet cannot sign transactions.
+- `signAndSendTransaction(connection, wallet, transaction, options?)`: signs and sends a transaction using a configured wallet.
+
+## Wallet Interface
+
+```ts
+import type { SolanaWallet } from "@vue-solana/core";
+
+const wallet: SolanaWallet = {
+  publicKey: null,
+  connected: false,
+  connect: async () => {},
+  disconnect: async () => {},
+  signTransaction: async (transaction) => transaction,
+};
+```
+
+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://vue-solana-docs.vercel.app/examples/vue-vite)
+- [`examples/nuxt`](https://vue-solana-docs.vercel.app/examples/nuxt)
+
+## Known TypeScript Issue
+
+`@solana/web3-compat@0.0.21` currently has broken TypeScript metadata. Runtime imports still use the real package, but TypeScript consumers may need a local declaration shim.
+
+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";
+  export {
+    Connection,
+    Keypair,
+    PublicKey,
+    SystemProgram,
+    Transaction,
+    TransactionInstruction,
+    VersionedTransaction,
+  } from "@solana/web3.js";
+}
+```
+
+Make sure your `tsconfig.json` includes `types/**/*.d.ts` or another pattern that includes the shim.
+
+## Status
+
+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,22 +1,26 @@
 {
   "name": "@vue-solana/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-agnostic primitives for Vue Solana libraries.",
   "license": "MIT",
-  "type": "module",
-  "homepage": "https://github.com/vue-solana/vue-solana#readme",
+  "keywords": [
+    "solana",
+    "vue",
+    "nuxt",
+    "web3",
+    "wallet",
+    "rpc"
+  ],
+  "homepage": "https://vue-solana-docs.vercel.app/packages/core",
+  "bugs": {
+    "url": "https://github.com/vue-solana/vue-solana/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vue-solana/vue-solana.git",
     "directory": "packages/core"
   },
-  "bugs": {
-    "url": "https://github.com/vue-solana/vue-solana/issues"
-  },
-  "keywords": ["solana", "vue", "wallet", "rpc", "web3"],
-  "publishConfig": {
-    "access": "public"
-  },
+  "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -27,18 +31,28 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist"],
-  "scripts": {
-    "build": "unbuild",
-    "dev": "unbuild --stub",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "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",
     "unbuild": "^3.5.0"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
   }
-}
+}