@metamask/connect-multichain 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.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))
+- Redact logs ([#191](https://github.com/MetaMask/connect-monorepo/pull/191]))
+- Pin eciesjs to exact version 0.4.17 ([#188](https://github.com/MetaMask/connect-monorepo/pull/188))
+
+### Fixed
+
+- Fix uncaught exception in `parseWalletError` when the wallet returns error codes outside the EIP-1193 provider range (1000–4999), such as standard JSON-RPC codes like `-32603` (Internal error). This prevented Solana request rejections from being handled gracefully. ([#189](https://github.com/MetaMask/connect-monorepo/pull/189))
+
 ## [0.6.0]
 
 ### Added
@@ -15,6 +27,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Normalize non-http(s) dapp URLs to valid https URLs on React Native to prevent RPC middleware crashes ([#190](https://github.com/MetaMask/connect-monorepo/pull/190))
 - **BREAKING** `createMultichainClient()` now returns a singleton. Any incoming constructor params on subsequent calls to `createMultichainClient()` will be applied to the existing singleton instance except for the `dapp`, `storage`, and `ui.factory` param options. ([#157](https://github.com/MetaMask/connect-monorepo/pull/157))
 - **BREAKING** `ConnectMultichain.openDeeplinkIfNeeded()` is renamed to `openSimpleDeeplinkIfNeeded()` ([#176](https://github.com/MetaMask/connect-monorepo/pull/176))
 - `ConnectMultichain.connect()` now throws an `'Existing connection is pending. Please check your MetaMask Mobile app to continue.'` error if there is already an pending connection attempt. Previously it would abort that ongoing connection in favor of a new one. ([#157](https://github.com/MetaMask/connect-monorepo/pull/157))
@@ -157,7 +170,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.6.0...HEAD
+[Unreleased]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.7.0...HEAD
+[0.7.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.6.0...@metamask/connect-multichain@0.7.0
 [0.6.0]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.5.3...@metamask/connect-multichain@0.6.0
 [0.5.3]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.5.2...@metamask/connect-multichain@0.5.3
 [0.5.2]: https://github.com/MetaMask/connect-monorepo/compare/@metamask/connect-multichain@0.5.1...@metamask/connect-multichain@0.5.2

package/README.md

@@ -134,26 +134,28 @@ This package is written in TypeScript and includes full type definitions. No add
 
 Factory function to create a new Multichain SDK instance.
 
+> **Singleton:** `createMultichainClient` returns a single shared instance per global context. Calling it a second time with different options will merge the new `api.supportedNetworks`, `ui.*`, `mobile.*`, `transport.extensionId`, and `debug` values into the existing instance rather than creating a new one. The `dapp` value is never overwritten on subsequent calls.
+
 #### Parameters
 
-| Option                      | Type                                          | Required | Description                                    |
-| --------------------------- | --------------------------------------------- | -------- | ---------------------------------------------- |
-| `dapp.name`                 | `string`                                      | Yes      | Name of your dApp                              |
-| `api.supportedNetworks`     | `RpcUrlsMap`                                  | Yes      | Map of CAIP chain IDs to RPC URLs              |
-| `dapp.url`                  | `string`                                      | No       | URL of your dApp                               |
-| `dapp.iconUrl`              | `string`                                      | No       | Icon URL for your dApp                         |
-| `dapp.base64Icon`           | `string`                                      | No       | Base64-encoded icon (alternative to iconUrl)   |
-| `storage`                   | `StoreClient`                                 | No       | Custom storage adapter                         |
-| `ui.factory`                | `BaseModalFactory`                            | No       | Custom modal factory                           |
-| `ui.headless`               | `boolean`                                     | No       | Run without UI (for custom QR implementations) |
-| `ui.preferExtension`        | `boolean`                                     | No       | Prefer browser extension (default: true)       |
-| `ui.showInstallModal`       | `boolean`                                     | No       | Show installation modal                        |
-| `mobile.preferredOpenLink`  | `(deeplink: string, target?: string) => void` | No       | Custom deeplink handler                        |
-| `mobile.useDeeplink`        | `boolean`                                     | No       | Use `metamask://` instead of universal links   |
-| `analytics.integrationType` | `string`                                      | No       | Integration type for analytics                 |
-| `transport.extensionId`     | `string`                                      | No       | Custom extension ID                            |
-| `transport.onNotification`  | `(notification: unknown) => void`             | No       | Notification handler                           |
-| `debug`                     | `boolean`                                     | No       | Enable debug logging                           |
+| Option                      | Type                                          | Required | Description                                                                   |
+| --------------------------- | --------------------------------------------- | -------- | ----------------------------------------------------------------------------- |
+| `dapp.name`                 | `string`                                      | Yes      | Name of your dApp                                                             |
+| `api.supportedNetworks`     | `RpcUrlsMap`                                  | Yes      | Map of [CAIP-2 chain IDs](https://chainagnostic.org/CAIPs/caip-2) to RPC URLs |
+| `dapp.url`                  | `string`                                      | No       | URL of your dApp                                                              |
+| `dapp.iconUrl`              | `string`                                      | No       | Icon URL for your dApp                                                        |
+| `dapp.base64Icon`           | `string`                                      | No       | Base64-encoded icon (alternative to iconUrl)                                  |
+| `storage`                   | `StoreClient`                                 | No       | Custom storage adapter                                                        |
+| `ui.factory`                | `BaseModalFactory`                            | No       | Custom modal factory                                                          |
+| `ui.headless`               | `boolean`                                     | No       | Run without UI (for custom QR implementations)                                |
+| `ui.preferExtension`        | `boolean`                                     | No       | Prefer browser extension (default: true)                                      |
+| `ui.showInstallModal`       | `boolean`                                     | No       | Show installation modal                                                       |
+| `mobile.preferredOpenLink`  | `(deeplink: string, target?: string) => void` | No       | Custom deeplink handler                                                       |
+| `mobile.useDeeplink`        | `boolean`                                     | No       | Use `metamask://` instead of universal links                                  |
+| `analytics.integrationType` | `string`                                      | No       | Integration type for analytics                                                |
+| `transport.extensionId`     | `string`                                      | No       | Custom extension ID                                                           |
+| `transport.onNotification`  | `(notification: unknown) => void`             | No       | Notification handler                                                          |
+| `debug`                     | `boolean`                                     | No       | Enable debug logging                                                          |
 
 #### Returns
 
@@ -347,7 +349,7 @@ Generates Infura RPC URLs for common networks keyed by CAIP Chain ID.
 
 **Returns**
 
-A map of hex chain IDs to Infura RPC URLs. See https://docs.metamask.io/services
+A map of [CAIP-2 chain IDs](https://chainagnostic.org/CAIPs/caip-2) to Infura RPC URLs. See https://docs.metamask.io/services
 
 ```typescript
 import { getInfuraRpcUrls } from '@metamask/connect-multichain';

package/dist/browser/es/connect-multichain.d.mts

@@ -369,6 +369,8 @@ declare function hasExtension(): Promise<boolean>;
 type DappSettings = {
     name: string;
     url?: string;
+    /** The original non-http(s) URL before normalization on React Native platforms */
+    nativeScheme?: string;
 } & ({
     iconUrl?: string;
 } | {

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

@@ -781,6 +781,21 @@ function getOptionalScopes(scopes) {
     {}
   );
 }
+function normalizeNativeUrl(url) {
+  var _a3;
+  const httpPattern = /^https?:\/\//u;
+  if (httpPattern.test(url)) {
+    return void 0;
+  }
+  const schemeMatch = url.match(/^([^:]*):\/\//u);
+  const rawScheme = (_a3 = schemeMatch == null ? void 0 : schemeMatch[1]) != null ? _a3 : url;
+  const sanitized = rawScheme.toLowerCase().replace(/[^a-z0-9-]/gu, "-").replace(/^-+|-+$/gu, "");
+  const subdomain = (sanitized || "unknown").slice(0, 63).replace(/-+$/u, "");
+  return {
+    url: `https://${subdomain}.rn.dapp.local`,
+    nativeScheme: url
+  };
+}
 function setupDappMetadata(options) {
   var _a3, _b;
   const platform = getPlatformType();
@@ -796,6 +811,18 @@ function setupDappMetadata(options) {
   if (!((_b = options.dapp) == null ? void 0 : _b.url)) {
     throw new Error("You must provide dapp url");
   }
+  if (platform === "react-native" /* ReactNative */ && options.dapp.url) {
+    const normalized = normalizeNativeUrl(options.dapp.url);
+    if (normalized) {
+      console.info(
+        `Normalizing dapp URL for React Native: "${options.dapp.url}" -> "${normalized.url}"`
+      );
+      options.dapp = __spreadProps(__spreadValues({}, options.dapp), {
+        url: normalized.url,
+        nativeScheme: normalized.nativeScheme
+      });
+    }
+  }
   const BASE_64_ICON_MAX_LENGTH = 163400;
   const urlPattern = /^(http|https):\/\/[^\s]*$/u;
   if (options.dapp) {
@@ -1878,7 +1905,6 @@ _notificationCallbacks2 = new WeakMap();
 _MultichainApiClientWrapperTransport_instances = new WeakSet();
 walletCreateSession_fn = function(request) {
   return __async(this, null, function* () {
-    console.log("\u{1F4DA} #walletCreateSession", request);
     const createSessionParams = request.params;
     const scopes = Object.keys(__spreadValues(__spreadValues({}, createSessionParams.optionalScopes), createSessionParams.requiredScopes));
     const scopeAccounts = [];
@@ -1959,7 +1985,7 @@ import { SessionStore } from "@metamask/mobile-wallet-protocol-core";
 import {
   TransportTimeoutError
 } from "@metamask/multichain-api-client";
-import { providerErrors as providerErrors2, rpcErrors } from "@metamask/rpc-errors";
+import { JsonRpcError, providerErrors as providerErrors2, rpcErrors } from "@metamask/rpc-errors";
 
 // src/multichain/transports/constants.ts
 var MULTICHAIN_PROVIDER_STREAM_NAME = "metamask-multichain-provider";
@@ -2062,10 +2088,11 @@ var MWPTransport = class {
   parseWalletError(errorPayload) {
     const errorData = errorPayload;
     if (typeof errorData.code === "number" && typeof errorData.message === "string") {
-      return providerErrors2.custom({
-        code: errorData.code,
-        message: errorData.message
-      });
+      const { code, message: message2 } = errorData;
+      if (code >= 1e3 && code <= 4999) {
+        return providerErrors2.custom({ code, message: message2 });
+      }
+      return new JsonRpcError(code, message2);
     }
     const message = errorPayload instanceof Error ? errorPayload.message : JSON.stringify(errorPayload);
     return rpcErrors.internal({ message });
@@ -2229,7 +2256,11 @@ var MWPTransport = class {
       const { dappClient } = this;
       const session = yield this.getActiveSession();
       if (session) {
-        logger("active session found", session);
+        logger("active session found", {
+          id: session.id,
+          channel: session.channel,
+          expiresAt: session.expiresAt
+        });
       }
       const storedSessionRequestBeforeConnectionAttempt = yield this.getStoredPendingSessionRequest();
       let timeout;