@metamask/connect-solana 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -7,11 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0]
+
+### Changed
+
+- Correct README documentation across `connect-solana`, `connect-evm`, and `connect-multichain` to match actual API behaviour. ([#194](https://github.com/MetaMask/connect-monorepo/pull/194))
+- Add missing changelogs from Release/17.0.0 ([#186](https://github.com/MetaMask/connect-monorepo/pull/186))
+
+### Fixed
+
+- Explicitly disconnect only Solana scopes when calling `SolanaClient.disconnect()`. Previously calling this function would result in the wallet connection being terminated entirely even if other ecosystems (evm, bitcoin, etc) were still connected ([#193](https://github.com/MetaMask/connect-monorepo/pull/193))
+
+## [0.2.0]
+
+### Added
+
+- Add node.js builds [#169](https://github.com/MetaMask/connect-monorepo/pull/169)
+
+### Changed
+
+- **BREAKING:** Automatically register as MetaMask to Solana Wallet Standard registry upon instantiation - with option to skip auto-registration [#178](https://github.com/MetaMask/connect-monorepo/pull/178)
+- **BREAKING** `getWallet()` no longer accepts a `walletName` argument and now always returns the `"MetaMask Connect"` wallet instance. ([#178](https://github.com/MetaMask/connect-monorepo/pull/178))
+- **BREAKING** `registerWallet()` no longer accepts a `walletName` argument. Wallet naming is now fixed to `"MetaMask Connect"`. ([#178](https://github.com/MetaMask/connect-monorepo/pull/178))
+- `registerWallet()` is now effectively a no-op when auto-registration is enabled (default). Use `skipAutoRegister: true` for manual registration control. ([#178](https://github.com/MetaMask/connect-monorepo/pull/178))
+
 ## [0.1.0]
 
 ### Added
 
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-solana@0.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-solana@0.3.0...HEAD
+[0.3.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-solana@0.2.0...@metamask/connect-solana@0.3.0
+[0.2.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-solana@0.1.0...@metamask/connect-solana@0.2.0
 [0.1.0]: https://github.com/MetaMask/connect-monorepo/releases/tag/@metamask/connect-solana@0.1.0

package/README.md

@@ -8,7 +8,7 @@
 
 - **Wallet Standard Compatible** - Automatically registers MetaMask with the wallet-standard registry
 - **Seamless Integration** - Works with `@solana/wallet-adapter-react` out of the box
-- **Session Management** - Handles session creation and revocation internally
+- **Session Management** - Handles session creation internally; disconnect revokes only Solana scopes
 - **Cross-Platform Support** - Works with browser extensions and mobile applications
 
 ## Installation
@@ -29,16 +29,13 @@ npm install @metamask/connect-solana
 import { createSolanaClient } from '@metamask/connect-solana';
 
 // Create a Solana client
+// MetaMask is automatically registered with the wallet-standard registry on creation
 const client = await createSolanaClient({
   dapp: {
     name: 'My Solana DApp',
     url: 'https://mydapp.com',
   },
 });
-
-// Register MetaMask with the wallet-standard registry
-// This makes MetaMask automatically discoverable by Solana dapps
-await client.registerWallet();
 ```
 
 ## Usage with Solana Wallet Adapter
@@ -61,14 +58,12 @@ import '@solana/wallet-adapter-react-ui/styles.css';
 
 function App() {
   useEffect(() => {
-    // Register MetaMask wallet on app initialization
+    // MetaMask is automatically registered with the wallet-standard registry on creation
     createSolanaClient({
       dapp: {
         name: 'My Solana DApp',
         url: window.location.origin,
       },
-    }).then((client) => {
-      client.registerWallet();
     });
   }, []);
 
@@ -85,28 +80,86 @@ function App() {
 }
 ```
 
+### ⚠️ Wallet Adapter support
+
+> **Note:** There is a known issue with `@solana/wallet-adapter-react` that prevents connecting to MetaMask when using the Wallet Standard provider from `@metamask/connect-solana` in Chrome on Android.
+>
+> See this [patch file](../../.yarn/patches/@solana-wallet-adapter-react-npm-0.15.39-86277fdcc0.patch) for details.
+
 ## API Reference
 
 ### `createSolanaClient(options)`
 
-Creates a new Solana client instance.
+Creates a new Solana client instance. By default, the wallet is automatically registered with the wallet-standard registry on creation.
 
 #### Parameters
 
-- `options.dapp.name` (required) - The name of your dapp
-- `options.dapp.url` (optional) - The URL of your dapp
-- `options.dapp.iconUrl` (optional) - The icon URL of your dapp
-- `options.api.supportedNetworks` (optional) - Map of CAIP chain IDs to RPC URLs
-- `options.debug` (optional) - Enable debug logging
+| Option                  | Type                      | Required | Description                                                               |
+| ----------------------- | ------------------------- | -------- | ------------------------------------------------------------------------- |
+| `dapp.name`             | `string`                  | Yes      | Name of your dApp                                                         |
+| `dapp.url`              | `string`                  | No       | URL of your dApp                                                          |
+| `dapp.iconUrl`          | `string`                  | No       | Icon URL for your dApp                                                    |
+| `api.supportedNetworks` | `SolanaSupportedNetworks` | No       | Map of network names (`mainnet`, `devnet`, `testnet`) to RPC URLs         |
+| `debug`                 | `boolean`                 | No       | Reserved for future use; not currently forwarded to the underlying client |
+| `skipAutoRegister`      | `boolean`                 | No       | Skip auto-registering the wallet during creation (defaults to `false`)    |
 
 #### Returns
 
-A `SolanaClient` object with:
+`Promise<SolanaClient>`
+
+---
+
+### `SolanaClient`
+
+The object returned by `createSolanaClient`.
+
+#### Properties
+
+| Property | Type             | Description                            |
+| -------- | ---------------- | -------------------------------------- |
+| `core`   | `MultichainCore` | The underlying MultichainCore instance |
+
+#### Methods
+
+##### `getWallet()`
+
+Returns a wallet-standard compatible MetaMask wallet instance.
+
+**Returns**
+
+`Wallet` - A [wallet-standard](https://github.com/wallet-standard/wallet-standard) compatible wallet.
+
+##### `registerWallet()`
+
+Registers the MetaMask wallet with the wallet-standard registry. This is a no-op if the wallet was already auto-registered during creation (i.e., `skipAutoRegister` was not set to `true`).
 
-- `core` - The underlying MultichainCore instance
-- `getWallet(walletName?)` - Returns a wallet-standard compatible wallet
-- `registerWallet(walletName?)` - Registers the wallet with the wallet-standard registry
-- `disconnect()` - Disconnects and revokes the session
+**Returns**
+
+`Promise<void>`
+
+##### `disconnect()`
+
+Disconnects all Solana scopes from MetaMask. This only revokes the Solana-specific scopes (`mainnet`, `devnet`, `testnet`); it does not terminate the broader multichain session.
+
+**Returns**
+
+`Promise<void>`
+
+---
+
+### Types
+
+#### `SolanaNetwork`
+
+```typescript
+type SolanaNetwork = 'mainnet' | 'devnet' | 'testnet';
+```
+
+#### `SolanaSupportedNetworks`
+
+```typescript
+type SolanaSupportedNetworks = Partial<Record<SolanaNetwork, string>>;
+```
 
 ## TypeScript
 

package/dist/browser/es/connect-solana.mjs

@@ -1,3 +1,4 @@
+/* Browser ES build */
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -20,7 +21,9 @@ var __async = (__this, __arguments, generator) => {
 };
 
 // src/connect.ts
-import { createMultichainClient } from "@metamask/connect-multichain";
+import {
+  createMultichainClient
+} from "@metamask/connect-multichain";
 import {
   getWalletStandard,
   registerSolanaWalletStandard
@@ -48,12 +51,13 @@ function convertNetworksToCAIP(networks) {
 // src/connect.ts
 function createSolanaClient(options) {
   return __async(this, null, function* () {
-    var _a, _b;
+    var _a, _b, _c;
     const defaultNetworks = {
       mainnet: "https://api.mainnet-beta.solana.com"
     };
+    const skipAutoRegister = (_a = options.skipAutoRegister) != null ? _a : false;
     const supportedNetworks = convertNetworksToCAIP(
-      (_b = (_a = options.api) == null ? void 0 : _a.supportedNetworks) != null ? _b : defaultNetworks
+      (_c = (_b = options.api) == null ? void 0 : _b.supportedNetworks) != null ? _c : defaultNetworks
     );
     const core = yield createMultichainClient({
       dapp: options.dapp,
@@ -62,14 +66,21 @@ function createSolanaClient(options) {
       }
     });
     const client = core.provider;
+    const walletName = "MetaMask Connect";
+    if (!skipAutoRegister) {
+      yield registerSolanaWalletStandard({ client, walletName });
+    }
     return {
       core,
-      getWallet: (walletName) => getWalletStandard({ client, walletName }),
-      registerWallet: (walletName = "MetaMask Connect") => __async(null, null, function* () {
-        return registerSolanaWalletStandard({ client, walletName });
+      getWallet: () => getWalletStandard({ client, walletName }),
+      registerWallet: () => __async(null, null, function* () {
+        if (!skipAutoRegister) {
+          return;
+        }
+        yield registerSolanaWalletStandard({ client, walletName });
       }),
       disconnect: () => __async(null, null, function* () {
-        return yield core.disconnect();
+        return yield core.disconnect(Object.values(SOLANA_CAIP_IDS));
       })
     };
   });

package/dist/browser/es/connect-solana.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/connect.ts","../../../src/networks.ts"],"sourcesContent":["import { createMultichainClient } from '@metamask/connect-multichain';\nimport {\n  getWalletStandard,\n  registerSolanaWalletStandard,\n} from '@metamask/solana-wallet-standard';\n\nimport { convertNetworksToCAIP } from './networks';\nimport type {\n  SolanaClient,\n  SolanaConnectOptions,\n  SolanaSupportedNetworks,\n} from './types';\n\n/**\n * Creates a new Solana client for connecting to MetaMask via wallet-standard.\n *\n * This function initializes the MultichainSDK and provides methods to get or register\n * a wallet-standard compatible wallet. The wallet handles session creation internally\n * when users connect through the Solana wallet adapter UI.\n *\n * @param options - Configuration options for the Solana client\n * @param options.dapp - Dapp identification and branding settings\n * @param options.api - Optional API configuration with supported networks\n * @param options.api.supportedNetworks - Record mapping network names (mainnet, devnet, testnet) to RPC URLs\n * @param options.debug - Enable debug logging\n * @returns A promise that resolves to the Solana client instance\n *\n * @example\n * ```typescript\n * import { createSolanaClient } from '@metamask/connect-solana';\n *\n * const client = await createSolanaClient({\n *   dapp: {\n *     name: 'My Solana DApp',\n *     url: 'https://mydapp.com',\n *   },\n *   api: {\n *     supportedNetworks: {\n *       mainnet: 'https://api.mainnet-beta.solana.com',\n *       devnet: 'https://api.devnet.solana.com',\n *     },\n *   },\n * });\n *\n * // Register the wallet to make it discoverable by Solana dapps\n * await client.registerWallet();\n *\n * // Or get the wallet instance directly\n * const wallet = client.getWallet();\n * ```\n */\nexport async function createSolanaClient(\n  options: SolanaConnectOptions,\n): Promise<SolanaClient> {\n  const defaultNetworks: SolanaSupportedNetworks = {\n    mainnet: 'https://api.mainnet-beta.solana.com',\n  };\n\n  const supportedNetworks = convertNetworksToCAIP(\n    options.api?.supportedNetworks ?? defaultNetworks,\n  );\n\n  const core = await createMultichainClient({\n    dapp: options.dapp,\n    api: {\n      supportedNetworks,\n    },\n  });\n\n  const client = core.provider;\n\n  return {\n    core,\n    getWallet: (walletName?: string) =>\n      getWalletStandard({ client, walletName }),\n    registerWallet: async (walletName = 'MetaMask Connect') =>\n      registerSolanaWalletStandard({ client, walletName }),\n    disconnect: async () => await core.disconnect(),\n  };\n}\n","import type { SolanaNetwork, SolanaSupportedNetworks } from './types';\n\n/**\n * CAIP-2 chain IDs for Solana networks.\n * The reference is the first 32 characters of the Base58-encoded genesis hash.\n */\nexport const SOLANA_CAIP_IDS: Record<SolanaNetwork, string> = {\n  mainnet: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  devnet: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',\n  testnet: 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',\n};\n\n/**\n * Converts a record of network names to RPC URLs into a record of CAIP IDs to RPC URLs.\n *\n * @param networks - A record of network names to RPC URLs\n * @returns A record of CAIP IDs to RPC URLs\n */\nexport function convertNetworksToCAIP(\n  networks: SolanaSupportedNetworks,\n): Record<string, string> {\n  return Object.entries(networks).reduce<Record<string, string>>(\n    (acc, [network, rpcUrl]) => {\n      const caipId = SOLANA_CAIP_IDS[network as SolanaNetwork];\n      if (caipId && rpcUrl) {\n        acc[caipId] = rpcUrl;\n      }\n      return acc;\n    },\n    {},\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,OACK;;;ACEA,IAAM,kBAAiD;AAAA,EAC5D,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AACX;AAQO,SAAS,sBACd,UACwB;AACxB,SAAO,OAAO,QAAQ,QAAQ,EAAE;AAAA,IAC9B,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM;AAC1B,YAAM,SAAS,gBAAgB,OAAwB;AACvD,UAAI,UAAU,QAAQ;AACpB,YAAI,MAAM,IAAI;AAAA,MAChB;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;;;ADoBA,SAAsB,mBACpB,SACuB;AAAA;AArDzB;AAsDE,UAAM,kBAA2C;AAAA,MAC/C,SAAS;AAAA,IACX;AAEA,UAAM,oBAAoB;AAAA,OACxB,mBAAQ,QAAR,mBAAa,sBAAb,YAAkC;AAAA,IACpC;AAEA,UAAM,OAAO,MAAM,uBAAuB;AAAA,MACxC,MAAM,QAAQ;AAAA,MACd,KAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,SAAS,KAAK;AAEpB,WAAO;AAAA,MACL;AAAA,MACA,WAAW,CAAC,eACV,kBAAkB,EAAE,QAAQ,WAAW,CAAC;AAAA,MAC1C,gBAAgB,CAAO,aAAa,uBAAoB;AACtD,4CAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA;AAAA,MACrD,YAAY,MAAS;AAAG,qBAAM,KAAK,WAAW;AAAA;AAAA,IAChD;AAAA,EACF;AAAA;","names":[]}
+{"version":3,"sources":["../../../src/connect.ts","../../../src/networks.ts"],"sourcesContent":["import {\n  createMultichainClient,\n  type Scope,\n} from '@metamask/connect-multichain';\nimport {\n  getWalletStandard,\n  registerSolanaWalletStandard,\n} from '@metamask/solana-wallet-standard';\n\nimport { convertNetworksToCAIP, SOLANA_CAIP_IDS } from './networks';\nimport type {\n  SolanaClient,\n  SolanaConnectOptions,\n  SolanaSupportedNetworks,\n} from './types';\n\n/**\n * Creates a new Solana client for connecting to MetaMask via wallet-standard.\n *\n * This function initializes the MultichainSDK and provides methods to get or register\n * a wallet-standard compatible wallet. The wallet handles session creation internally\n * when users connect through the Solana wallet adapter UI.\n *\n * @param options - Configuration options for the Solana client\n * @param options.dapp - Dapp identification and branding settings\n * @param options.api - Optional API configuration with supported networks\n * @param options.api.supportedNetworks - Record mapping network names (mainnet, devnet, testnet) to RPC URLs\n * @param options.debug - Enable debug logging\n * @param options.skipAutoRegister - Skip auto-registering the wallet during creation (defaults to false)\n * @returns A promise that resolves to the Solana client instance\n *\n * @example\n * ```typescript\n * import { createSolanaClient } from '@metamask/connect-solana';\n *\n * // Wallet is auto-registered and ready to use\n * const client = await createSolanaClient({\n *   dapp: {\n *     name: 'My Solana DApp',\n *     url: 'https://mydapp.com',\n *   },\n *   api: {\n *     supportedNetworks: {\n *       mainnet: 'https://api.mainnet-beta.solana.com',\n *       devnet: 'https://api.devnet.solana.com',\n *     },\n *   },\n * });\n *\n * // Get the wallet instance directly\n * const wallet = client.getWallet();\n * ```\n */\nexport async function createSolanaClient(\n  options: SolanaConnectOptions,\n): Promise<SolanaClient> {\n  const defaultNetworks: SolanaSupportedNetworks = {\n    mainnet: 'https://api.mainnet-beta.solana.com',\n  };\n\n  const skipAutoRegister = options.skipAutoRegister ?? false;\n\n  const supportedNetworks = convertNetworksToCAIP(\n    options.api?.supportedNetworks ?? defaultNetworks,\n  );\n\n  const core = await createMultichainClient({\n    dapp: options.dapp,\n    api: {\n      supportedNetworks,\n    },\n  });\n\n  const client = core.provider;\n\n  const walletName = 'MetaMask Connect';\n\n  if (!skipAutoRegister) {\n    await registerSolanaWalletStandard({ client, walletName });\n  }\n\n  return {\n    core,\n    getWallet: () => getWalletStandard({ client, walletName }),\n    registerWallet: async (): Promise<void> => {\n      if (!skipAutoRegister) {\n        return;\n      }\n      await registerSolanaWalletStandard({ client, walletName });\n    },\n    disconnect: async () =>\n      await core.disconnect(Object.values(SOLANA_CAIP_IDS) as Scope[]),\n  };\n}\n","import type { SolanaNetwork, SolanaSupportedNetworks } from './types';\n\n/**\n * CAIP-2 chain IDs for Solana networks.\n * The reference is the first 32 characters of the Base58-encoded genesis hash.\n */\nexport const SOLANA_CAIP_IDS: Record<SolanaNetwork, string> = {\n  mainnet: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  devnet: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',\n  testnet: 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',\n};\n\n/**\n * Converts a record of network names to RPC URLs into a record of CAIP IDs to RPC URLs.\n *\n * @param networks - A record of network names to RPC URLs\n * @returns A record of CAIP IDs to RPC URLs\n */\nexport function convertNetworksToCAIP(\n  networks: SolanaSupportedNetworks,\n): Record<string, string> {\n  return Object.entries(networks).reduce<Record<string, string>>(\n    (acc, [network, rpcUrl]) => {\n      const caipId = SOLANA_CAIP_IDS[network as SolanaNetwork];\n      if (caipId && rpcUrl) {\n        acc[caipId] = rpcUrl;\n      }\n      return acc;\n    },\n    {},\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;;;ACDA,IAAM,kBAAiD;AAAA,EAC5D,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AACX;AAQO,SAAS,sBACd,UACwB;AACxB,SAAO,OAAO,QAAQ,QAAQ,EAAE;AAAA,IAC9B,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM;AAC1B,YAAM,SAAS,gBAAgB,OAAwB;AACvD,UAAI,UAAU,QAAQ;AACpB,YAAI,MAAM,IAAI;AAAA,MAChB;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;;;ADsBA,SAAsB,mBACpB,SACuB;AAAA;AAvDzB;AAwDE,UAAM,kBAA2C;AAAA,MAC/C,SAAS;AAAA,IACX;AAEA,UAAM,oBAAmB,aAAQ,qBAAR,YAA4B;AAErD,UAAM,oBAAoB;AAAA,OACxB,mBAAQ,QAAR,mBAAa,sBAAb,YAAkC;AAAA,IACpC;AAEA,UAAM,OAAO,MAAM,uBAAuB;AAAA,MACxC,MAAM,QAAQ;AAAA,MACd,KAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,SAAS,KAAK;AAEpB,UAAM,aAAa;AAEnB,QAAI,CAAC,kBAAkB;AACrB,YAAM,6BAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA,IAC3D;AAEA,WAAO;AAAA,MACL;AAAA,MACA,WAAW,MAAM,kBAAkB,EAAE,QAAQ,WAAW,CAAC;AAAA,MACzD,gBAAgB,MAA2B;AACzC,YAAI,CAAC,kBAAkB;AACrB;AAAA,QACF;AACA,cAAM,6BAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA,MAC3D;AAAA,MACA,YAAY,MAAS;AACnB,qBAAM,KAAK,WAAW,OAAO,OAAO,eAAe,CAAY;AAAA;AAAA,IACnE;AAAA,EACF;AAAA;","names":[]}

package/dist/node/cjs/connect-solana.js

@@ -0,0 +1,112 @@
+/* Node.js CJS build */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  createSolanaClient: () => createSolanaClient
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/connect.ts
+var import_connect_multichain = require("@metamask/connect-multichain");
+var import_solana_wallet_standard = require("@metamask/solana-wallet-standard");
+
+// src/networks.ts
+var SOLANA_CAIP_IDS = {
+  mainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+  testnet: "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z"
+};
+function convertNetworksToCAIP(networks) {
+  return Object.entries(networks).reduce(
+    (acc, [network, rpcUrl]) => {
+      const caipId = SOLANA_CAIP_IDS[network];
+      if (caipId && rpcUrl) {
+        acc[caipId] = rpcUrl;
+      }
+      return acc;
+    },
+    {}
+  );
+}
+
+// src/connect.ts
+function createSolanaClient(options) {
+  return __async(this, null, function* () {
+    var _a, _b, _c;
+    const defaultNetworks = {
+      mainnet: "https://api.mainnet-beta.solana.com"
+    };
+    const skipAutoRegister = (_a = options.skipAutoRegister) != null ? _a : false;
+    const supportedNetworks = convertNetworksToCAIP(
+      (_c = (_b = options.api) == null ? void 0 : _b.supportedNetworks) != null ? _c : defaultNetworks
+    );
+    const core = yield (0, import_connect_multichain.createMultichainClient)({
+      dapp: options.dapp,
+      api: {
+        supportedNetworks
+      }
+    });
+    const client = core.provider;
+    const walletName = "MetaMask Connect";
+    if (!skipAutoRegister) {
+      yield (0, import_solana_wallet_standard.registerSolanaWalletStandard)({ client, walletName });
+    }
+    return {
+      core,
+      getWallet: () => (0, import_solana_wallet_standard.getWalletStandard)({ client, walletName }),
+      registerWallet: () => __async(null, null, function* () {
+        if (!skipAutoRegister) {
+          return;
+        }
+        yield (0, import_solana_wallet_standard.registerSolanaWalletStandard)({ client, walletName });
+      }),
+      disconnect: () => __async(null, null, function* () {
+        return yield core.disconnect(Object.values(SOLANA_CAIP_IDS));
+      })
+    };
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSolanaClient
+});
+//# sourceMappingURL=connect-solana.js.map

package/dist/node/cjs/connect-solana.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/index.ts","../../../src/connect.ts","../../../src/networks.ts"],"sourcesContent":["export { createSolanaClient } from './connect';\nexport type {\n  SolanaClient,\n  SolanaConnectOptions,\n  SolanaNetwork,\n  SolanaSupportedNetworks,\n} from './types';\n","import {\n  createMultichainClient,\n  type Scope,\n} from '@metamask/connect-multichain';\nimport {\n  getWalletStandard,\n  registerSolanaWalletStandard,\n} from '@metamask/solana-wallet-standard';\n\nimport { convertNetworksToCAIP, SOLANA_CAIP_IDS } from './networks';\nimport type {\n  SolanaClient,\n  SolanaConnectOptions,\n  SolanaSupportedNetworks,\n} from './types';\n\n/**\n * Creates a new Solana client for connecting to MetaMask via wallet-standard.\n *\n * This function initializes the MultichainSDK and provides methods to get or register\n * a wallet-standard compatible wallet. The wallet handles session creation internally\n * when users connect through the Solana wallet adapter UI.\n *\n * @param options - Configuration options for the Solana client\n * @param options.dapp - Dapp identification and branding settings\n * @param options.api - Optional API configuration with supported networks\n * @param options.api.supportedNetworks - Record mapping network names (mainnet, devnet, testnet) to RPC URLs\n * @param options.debug - Enable debug logging\n * @param options.skipAutoRegister - Skip auto-registering the wallet during creation (defaults to false)\n * @returns A promise that resolves to the Solana client instance\n *\n * @example\n * ```typescript\n * import { createSolanaClient } from '@metamask/connect-solana';\n *\n * // Wallet is auto-registered and ready to use\n * const client = await createSolanaClient({\n *   dapp: {\n *     name: 'My Solana DApp',\n *     url: 'https://mydapp.com',\n *   },\n *   api: {\n *     supportedNetworks: {\n *       mainnet: 'https://api.mainnet-beta.solana.com',\n *       devnet: 'https://api.devnet.solana.com',\n *     },\n *   },\n * });\n *\n * // Get the wallet instance directly\n * const wallet = client.getWallet();\n * ```\n */\nexport async function createSolanaClient(\n  options: SolanaConnectOptions,\n): Promise<SolanaClient> {\n  const defaultNetworks: SolanaSupportedNetworks = {\n    mainnet: 'https://api.mainnet-beta.solana.com',\n  };\n\n  const skipAutoRegister = options.skipAutoRegister ?? false;\n\n  const supportedNetworks = convertNetworksToCAIP(\n    options.api?.supportedNetworks ?? defaultNetworks,\n  );\n\n  const core = await createMultichainClient({\n    dapp: options.dapp,\n    api: {\n      supportedNetworks,\n    },\n  });\n\n  const client = core.provider;\n\n  const walletName = 'MetaMask Connect';\n\n  if (!skipAutoRegister) {\n    await registerSolanaWalletStandard({ client, walletName });\n  }\n\n  return {\n    core,\n    getWallet: () => getWalletStandard({ client, walletName }),\n    registerWallet: async (): Promise<void> => {\n      if (!skipAutoRegister) {\n        return;\n      }\n      await registerSolanaWalletStandard({ client, walletName });\n    },\n    disconnect: async () =>\n      await core.disconnect(Object.values(SOLANA_CAIP_IDS) as Scope[]),\n  };\n}\n","import type { SolanaNetwork, SolanaSupportedNetworks } from './types';\n\n/**\n * CAIP-2 chain IDs for Solana networks.\n * The reference is the first 32 characters of the Base58-encoded genesis hash.\n */\nexport const SOLANA_CAIP_IDS: Record<SolanaNetwork, string> = {\n  mainnet: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  devnet: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',\n  testnet: 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',\n};\n\n/**\n * Converts a record of network names to RPC URLs into a record of CAIP IDs to RPC URLs.\n *\n * @param networks - A record of network names to RPC URLs\n * @returns A record of CAIP IDs to RPC URLs\n */\nexport function convertNetworksToCAIP(\n  networks: SolanaSupportedNetworks,\n): Record<string, string> {\n  return Object.entries(networks).reduce<Record<string, string>>(\n    (acc, [network, rpcUrl]) => {\n      const caipId = SOLANA_CAIP_IDS[network as SolanaNetwork];\n      if (caipId && rpcUrl) {\n        acc[caipId] = rpcUrl;\n      }\n      return acc;\n    },\n    {},\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,gCAGO;AACP,oCAGO;;;ACDA,IAAM,kBAAiD;AAAA,EAC5D,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AACX;AAQO,SAAS,sBACd,UACwB;AACxB,SAAO,OAAO,QAAQ,QAAQ,EAAE;AAAA,IAC9B,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM;AAC1B,YAAM,SAAS,gBAAgB,OAAwB;AACvD,UAAI,UAAU,QAAQ;AACpB,YAAI,MAAM,IAAI;AAAA,MAChB;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;;;ADsBA,SAAsB,mBACpB,SACuB;AAAA;AAvDzB;AAwDE,UAAM,kBAA2C;AAAA,MAC/C,SAAS;AAAA,IACX;AAEA,UAAM,oBAAmB,aAAQ,qBAAR,YAA4B;AAErD,UAAM,oBAAoB;AAAA,OACxB,mBAAQ,QAAR,mBAAa,sBAAb,YAAkC;AAAA,IACpC;AAEA,UAAM,OAAO,UAAM,kDAAuB;AAAA,MACxC,MAAM,QAAQ;AAAA,MACd,KAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,SAAS,KAAK;AAEpB,UAAM,aAAa;AAEnB,QAAI,CAAC,kBAAkB;AACrB,gBAAM,4DAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA,IAC3D;AAEA,WAAO;AAAA,MACL;AAAA,MACA,WAAW,UAAM,iDAAkB,EAAE,QAAQ,WAAW,CAAC;AAAA,MACzD,gBAAgB,MAA2B;AACzC,YAAI,CAAC,kBAAkB;AACrB;AAAA,QACF;AACA,kBAAM,4DAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA,MAC3D;AAAA,MACA,YAAY,MAAS;AACnB,qBAAM,KAAK,WAAW,OAAO,OAAO,eAAe,CAAY;AAAA;AAAA,IACnE;AAAA,EACF;AAAA;","names":[]}

package/dist/node/es/connect-solana.mjs

@@ -0,0 +1,91 @@
+/* Node.js ES build */
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/connect.ts
+import {
+  createMultichainClient
+} from "@metamask/connect-multichain";
+import {
+  getWalletStandard,
+  registerSolanaWalletStandard
+} from "@metamask/solana-wallet-standard";
+
+// src/networks.ts
+var SOLANA_CAIP_IDS = {
+  mainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+  devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+  testnet: "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z"
+};
+function convertNetworksToCAIP(networks) {
+  return Object.entries(networks).reduce(
+    (acc, [network, rpcUrl]) => {
+      const caipId = SOLANA_CAIP_IDS[network];
+      if (caipId && rpcUrl) {
+        acc[caipId] = rpcUrl;
+      }
+      return acc;
+    },
+    {}
+  );
+}
+
+// src/connect.ts
+function createSolanaClient(options) {
+  return __async(this, null, function* () {
+    var _a, _b, _c;
+    const defaultNetworks = {
+      mainnet: "https://api.mainnet-beta.solana.com"
+    };
+    const skipAutoRegister = (_a = options.skipAutoRegister) != null ? _a : false;
+    const supportedNetworks = convertNetworksToCAIP(
+      (_c = (_b = options.api) == null ? void 0 : _b.supportedNetworks) != null ? _c : defaultNetworks
+    );
+    const core = yield createMultichainClient({
+      dapp: options.dapp,
+      api: {
+        supportedNetworks
+      }
+    });
+    const client = core.provider;
+    const walletName = "MetaMask Connect";
+    if (!skipAutoRegister) {
+      yield registerSolanaWalletStandard({ client, walletName });
+    }
+    return {
+      core,
+      getWallet: () => getWalletStandard({ client, walletName }),
+      registerWallet: () => __async(null, null, function* () {
+        if (!skipAutoRegister) {
+          return;
+        }
+        yield registerSolanaWalletStandard({ client, walletName });
+      }),
+      disconnect: () => __async(null, null, function* () {
+        return yield core.disconnect(Object.values(SOLANA_CAIP_IDS));
+      })
+    };
+  });
+}
+export {
+  createSolanaClient
+};
+//# sourceMappingURL=connect-solana.mjs.map

package/dist/node/es/connect-solana.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/connect.ts","../../../src/networks.ts"],"sourcesContent":["import {\n  createMultichainClient,\n  type Scope,\n} from '@metamask/connect-multichain';\nimport {\n  getWalletStandard,\n  registerSolanaWalletStandard,\n} from '@metamask/solana-wallet-standard';\n\nimport { convertNetworksToCAIP, SOLANA_CAIP_IDS } from './networks';\nimport type {\n  SolanaClient,\n  SolanaConnectOptions,\n  SolanaSupportedNetworks,\n} from './types';\n\n/**\n * Creates a new Solana client for connecting to MetaMask via wallet-standard.\n *\n * This function initializes the MultichainSDK and provides methods to get or register\n * a wallet-standard compatible wallet. The wallet handles session creation internally\n * when users connect through the Solana wallet adapter UI.\n *\n * @param options - Configuration options for the Solana client\n * @param options.dapp - Dapp identification and branding settings\n * @param options.api - Optional API configuration with supported networks\n * @param options.api.supportedNetworks - Record mapping network names (mainnet, devnet, testnet) to RPC URLs\n * @param options.debug - Enable debug logging\n * @param options.skipAutoRegister - Skip auto-registering the wallet during creation (defaults to false)\n * @returns A promise that resolves to the Solana client instance\n *\n * @example\n * ```typescript\n * import { createSolanaClient } from '@metamask/connect-solana';\n *\n * // Wallet is auto-registered and ready to use\n * const client = await createSolanaClient({\n *   dapp: {\n *     name: 'My Solana DApp',\n *     url: 'https://mydapp.com',\n *   },\n *   api: {\n *     supportedNetworks: {\n *       mainnet: 'https://api.mainnet-beta.solana.com',\n *       devnet: 'https://api.devnet.solana.com',\n *     },\n *   },\n * });\n *\n * // Get the wallet instance directly\n * const wallet = client.getWallet();\n * ```\n */\nexport async function createSolanaClient(\n  options: SolanaConnectOptions,\n): Promise<SolanaClient> {\n  const defaultNetworks: SolanaSupportedNetworks = {\n    mainnet: 'https://api.mainnet-beta.solana.com',\n  };\n\n  const skipAutoRegister = options.skipAutoRegister ?? false;\n\n  const supportedNetworks = convertNetworksToCAIP(\n    options.api?.supportedNetworks ?? defaultNetworks,\n  );\n\n  const core = await createMultichainClient({\n    dapp: options.dapp,\n    api: {\n      supportedNetworks,\n    },\n  });\n\n  const client = core.provider;\n\n  const walletName = 'MetaMask Connect';\n\n  if (!skipAutoRegister) {\n    await registerSolanaWalletStandard({ client, walletName });\n  }\n\n  return {\n    core,\n    getWallet: () => getWalletStandard({ client, walletName }),\n    registerWallet: async (): Promise<void> => {\n      if (!skipAutoRegister) {\n        return;\n      }\n      await registerSolanaWalletStandard({ client, walletName });\n    },\n    disconnect: async () =>\n      await core.disconnect(Object.values(SOLANA_CAIP_IDS) as Scope[]),\n  };\n}\n","import type { SolanaNetwork, SolanaSupportedNetworks } from './types';\n\n/**\n * CAIP-2 chain IDs for Solana networks.\n * The reference is the first 32 characters of the Base58-encoded genesis hash.\n */\nexport const SOLANA_CAIP_IDS: Record<SolanaNetwork, string> = {\n  mainnet: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n  devnet: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',\n  testnet: 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',\n};\n\n/**\n * Converts a record of network names to RPC URLs into a record of CAIP IDs to RPC URLs.\n *\n * @param networks - A record of network names to RPC URLs\n * @returns A record of CAIP IDs to RPC URLs\n */\nexport function convertNetworksToCAIP(\n  networks: SolanaSupportedNetworks,\n): Record<string, string> {\n  return Object.entries(networks).reduce<Record<string, string>>(\n    (acc, [network, rpcUrl]) => {\n      const caipId = SOLANA_CAIP_IDS[network as SolanaNetwork];\n      if (caipId && rpcUrl) {\n        acc[caipId] = rpcUrl;\n      }\n      return acc;\n    },\n    {},\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;;;ACDA,IAAM,kBAAiD;AAAA,EAC5D,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AACX;AAQO,SAAS,sBACd,UACwB;AACxB,SAAO,OAAO,QAAQ,QAAQ,EAAE;AAAA,IAC9B,CAAC,KAAK,CAAC,SAAS,MAAM,MAAM;AAC1B,YAAM,SAAS,gBAAgB,OAAwB;AACvD,UAAI,UAAU,QAAQ;AACpB,YAAI,MAAM,IAAI;AAAA,MAChB;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;;;ADsBA,SAAsB,mBACpB,SACuB;AAAA;AAvDzB;AAwDE,UAAM,kBAA2C;AAAA,MAC/C,SAAS;AAAA,IACX;AAEA,UAAM,oBAAmB,aAAQ,qBAAR,YAA4B;AAErD,UAAM,oBAAoB;AAAA,OACxB,mBAAQ,QAAR,mBAAa,sBAAb,YAAkC;AAAA,IACpC;AAEA,UAAM,OAAO,MAAM,uBAAuB;AAAA,MACxC,MAAM,QAAQ;AAAA,MACd,KAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,SAAS,KAAK;AAEpB,UAAM,aAAa;AAEnB,QAAI,CAAC,kBAAkB;AACrB,YAAM,6BAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA,IAC3D;AAEA,WAAO;AAAA,MACL;AAAA,MACA,WAAW,MAAM,kBAAkB,EAAE,QAAQ,WAAW,CAAC;AAAA,MACzD,gBAAgB,MAA2B;AACzC,YAAI,CAAC,kBAAkB;AACrB;AAAA,QACF;AACA,cAAM,6BAA6B,EAAE,QAAQ,WAAW,CAAC;AAAA,MAC3D;AAAA,MACA,YAAY,MAAS;AACnB,qBAAM,KAAK,WAAW,OAAO,OAAO,eAAe,CAAY;AAAA;AAAA,IACnE;AAAA,EACF;AAAA;","names":[]}

package/dist/types/index.d.ts

@@ -32,6 +32,8 @@ type SolanaConnectOptions = Pick<MultichainOptions, 'dapp'> & {
     };
     /** Enable debug logging */
     debug?: boolean;
+    /** Skip auto-registering the wallet during creation. Defaults to false. Set to true for manual control. */
+    skipAutoRegister?: boolean;
 };
 /**
  * The Solana client instance returned by createSolanaClient.
@@ -40,19 +42,16 @@ type SolanaClient = {
     /** The underlying MultichainCore instance */
     core: MultichainCore;
     /**
-     * Gets a wallet-standard compatible wallet instance.
+     * Gets the wallet-standard compatible MetaMask wallet instance.
      *
-     * @param walletName - Optional custom name for the wallet
      * @returns The wallet instance
      */
-    getWallet: (walletName?: string) => Wallet;
+    getWallet: () => Wallet;
     /**
      * Registers the MetaMask wallet with the wallet-standard registry.
      * This makes MetaMask automatically discoverable by Solana dapps.
-     *
-     * @param walletName - Optional custom name for the wallet
      */
-    registerWallet: (walletName?: string) => Promise<void>;
+    registerWallet: () => Promise<void>;
     /**
      * Disconnects from the wallet and revokes the session.
      */
@@ -71,12 +70,14 @@ type SolanaClient = {
  * @param options.api - Optional API configuration with supported networks
  * @param options.api.supportedNetworks - Record mapping network names (mainnet, devnet, testnet) to RPC URLs
  * @param options.debug - Enable debug logging
+ * @param options.skipAutoRegister - Skip auto-registering the wallet during creation (defaults to false)
  * @returns A promise that resolves to the Solana client instance
  *
  * @example
  * ```typescript
  * import { createSolanaClient } from '@metamask/connect-solana';
  *
+ * // Wallet is auto-registered and ready to use
  * const client = await createSolanaClient({
  *   dapp: {
  *     name: 'My Solana DApp',
@@ -90,10 +91,7 @@ type SolanaClient = {
  *   },
  * });
  *
- * // Register the wallet to make it discoverable by Solana dapps
- * await client.registerWallet();
- *
- * // Or get the wallet instance directly
+ * // Get the wallet instance directly
  * const wallet = client.getWallet();
  * ```
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/connect-solana",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Solana Layer for MetaMask Connect",
   "keywords": [
     "MetaMask",
@@ -18,19 +18,23 @@
   "sideEffects": false,
   "exports": {
     ".": {
+      "browser": {
+        "types": "./dist/types/index.d.ts",
+        "import": "./dist/browser/es/connect-solana.mjs"
+      },
       "import": {
         "types": "./dist/types/index.d.ts",
-        "default": "./dist/browser/es/connect-solana.mjs"
+        "default": "./dist/node/es/connect-solana.mjs"
       },
       "require": {
         "types": "./dist/types/index.d.ts",
-        "default": "./dist/browser/es/connect-solana.mjs"
+        "default": "./dist/node/cjs/connect-solana.js"
       },
-      "default": "./dist/browser/es/connect-solana.mjs"
+      "default": "./dist/node/cjs/connect-solana.js"
     },
     "./package.json": "./package.json"
   },
-  "main": "./dist/browser/es/connect-solana.mjs",
+  "main": "./dist/node/cjs/connect-solana.js",
   "module": "./dist/browser/es/connect-solana.mjs",
   "browser": "./dist/browser/es/connect-solana.mjs",
   "types": "./dist/types/index.d.ts",
@@ -54,7 +58,7 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@metamask/connect-multichain": "^0.5.3",
+    "@metamask/connect-multichain": "^0.7.0",
     "@metamask/solana-wallet-standard": "^0.6.0",
     "@wallet-standard/base": "^1.1.0"
   },