@metamask/connect-evm 0.1.1 → 0.1.2

package/dist/src/constants.js

@@ -0,0 +1,23 @@
+export const IGNORED_METHODS = [
+    'metamask_getProviderState',
+    'metamask_sendDomainMetadata',
+    'metamask_logWeb3ShimUsage',
+    'wallet_registerOnboarding',
+    'net_version',
+    'wallet_getPermissions',
+];
+export const CONNECT_METHODS = [
+    'wallet_requestPermissions',
+    'eth_requestAccounts',
+];
+export const ACCOUNTS_METHODS = ['eth_accounts', 'eth_coinbase'];
+export const INTERCEPTABLE_METHODS = [
+    ...ACCOUNTS_METHODS,
+    ...IGNORED_METHODS,
+    ...CONNECT_METHODS,
+    // These have bespoke handlers
+    'wallet_revokePermissions',
+    'wallet_switchEthereumChain',
+    'wallet_addEthereumChain',
+];
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,6BAA6B;IAC7B,2BAA2B;IAC3B,2BAA2B;IAC3B,aAAa;IACb,uBAAuB;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,qBAAqB;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,gBAAgB;IACnB,GAAG,eAAe;IAClB,GAAG,eAAe;IAClB,8BAA8B;IAC9B,0BAA0B;IAC1B,4BAA4B;IAC5B,yBAAyB;CAC1B,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export { getInfuraRpcUrls } from '@metamask/connect-multichain';
+export { createMetamaskConnectEVM, type MetamaskConnectEVM } from './connect';
+export type { EIP1193Provider } from './provider';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,mBAAmB,SAAS,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { getInfuraRpcUrls } from '@metamask/connect-multichain';
+export { createMetamaskConnectEVM } from './connect';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAA2B,MAAM,WAAW,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,3 @@
+export declare const logger: import("debug").Debugger;
+export declare const enableDebug: (debugEnabled?: boolean) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM,0BAAgC,CAAC;AAEpD,eAAO,MAAM,WAAW,GAAI,eAAc,OAAe,KAAG,IAK3D,CAAC"}

package/dist/src/logger.js

@@ -0,0 +1,11 @@
+import { createLogger, enableDebug as debug, } from '@metamask/connect-multichain';
+const namespace = 'metamask-connect:evm';
+// @ts-expect-error logger needs to be typed properly
+export const logger = createLogger(namespace, '63');
+export const enableDebug = (debugEnabled = false) => {
+    if (debugEnabled) {
+        // @ts-expect-error logger needs to be typed properly
+        debug(namespace);
+    }
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,IAAI,KAAK,GACrB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,SAAS,GAAG,sBAAsB,CAAC;AAEzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,eAAwB,KAAK,EAAQ,EAAE;IACjE,IAAI,YAAY,EAAE,CAAC;QACjB,qDAAqD;QACrD,KAAK,CAAC,SAAS,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/provider.d.ts

@@ -0,0 +1,23 @@
+import type { MultichainCore } from '@metamask/connect-multichain';
+import { EventEmitter } from '@metamask/connect-multichain';
+import type { Address, EIP1193ProviderEvents, Hex, ProviderRequest, ProviderRequestInterceptor } from './types';
+/**
+ * EIP-1193 Provider wrapper around the Multichain SDK.
+ */
+export declare class EIP1193Provider extends EventEmitter<EIP1193ProviderEvents> {
+    #private;
+    constructor(core: MultichainCore, interceptor: ProviderRequestInterceptor);
+    /**
+     * Performs a EIP-1193 request.
+     *
+     * @param request - The request object containing the method and params
+     * @returns The result of the request
+     */
+    request(request: ProviderRequest): Promise<unknown>;
+    get selectedAccount(): Address | undefined;
+    set accounts(accounts: Address[]);
+    get accounts(): Address[];
+    get selectedChainId(): Hex | undefined;
+    set selectedChainId(chainId: Hex | number | undefined);
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAK5D,OAAO,KAAK,EACV,OAAO,EACP,qBAAqB,EACrB,GAAG,EACH,eAAe,EACf,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;;gBAa1D,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,0BAA0B;IAMzE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAyCzD,IAAW,eAAe,IAAI,OAAO,GAAG,SAAS,CAEhD;IAED,IAAW,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAEtC;IAED,IAAW,QAAQ,IAAI,OAAO,EAAE,CAE/B;IAED,IAAW,eAAe,IAAI,GAAG,GAAG,SAAS,CAE5C;IAED,IAAW,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,EAU3D;CACF"}

package/dist/src/provider.js

@@ -0,0 +1,105 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _EIP1193Provider_core, _EIP1193Provider_requestInterceptor, _EIP1193Provider_accounts, _EIP1193Provider_selectedChainId;
+import { EventEmitter } from '@metamask/connect-multichain';
+import { hexToNumber, numberToHex } from '@metamask/utils';
+import { INTERCEPTABLE_METHODS } from './constants';
+import { logger } from './logger';
+/**
+ * EIP-1193 Provider wrapper around the Multichain SDK.
+ */
+export class EIP1193Provider extends EventEmitter {
+    constructor(core, interceptor) {
+        super();
+        /** The core instance of the Multichain SDK */
+        _EIP1193Provider_core.set(this, void 0);
+        /** Interceptor function to handle specific methods */
+        _EIP1193Provider_requestInterceptor.set(this, void 0);
+        /** The currently permitted accounts */
+        _EIP1193Provider_accounts.set(this, []);
+        /** The currently selected chain ID on the wallet */
+        _EIP1193Provider_selectedChainId.set(this, void 0);
+        __classPrivateFieldSet(this, _EIP1193Provider_core, core, "f");
+        __classPrivateFieldSet(this, _EIP1193Provider_requestInterceptor, interceptor, "f");
+    }
+    /**
+     * Performs a EIP-1193 request.
+     *
+     * @param request - The request object containing the method and params
+     * @returns The result of the request
+     */
+    request(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            logger(`request: ${request.method} - chainId: ${this.selectedChainId}`, request.params);
+            /* Some methods require special handling, so we intercept them here
+             * and handle them in MetamaskConnectEVM.requestInterceptor method.  */
+            if (INTERCEPTABLE_METHODS.includes(request.method)) {
+                return (_a = __classPrivateFieldGet(this, _EIP1193Provider_requestInterceptor, "f")) === null || _a === void 0 ? void 0 : _a.call(this, request);
+            }
+            if (!__classPrivateFieldGet(this, _EIP1193Provider_selectedChainId, "f")) {
+                // TODO: replace with a better error
+                throw new Error('No chain ID selected');
+            }
+            const chainId = hexToNumber(__classPrivateFieldGet(this, _EIP1193Provider_selectedChainId, "f"));
+            const scope = `eip155:${chainId}`;
+            // Validate that the chain is configured in supportedNetworks
+            // This check is performed here to provide better error messages
+            // The RpcClient will also validate, but this gives us a chance to provide
+            // a clearer error message before the request is routed
+            const coreOptions = __classPrivateFieldGet(this, _EIP1193Provider_core, "f").options; // TODO: options is `protected readonly` property, this needs to be refactored so `any` type assertion is not necessary
+            const supportedNetworks = (_c = (_b = coreOptions === null || coreOptions === void 0 ? void 0 : coreOptions.api) === null || _b === void 0 ? void 0 : _b.supportedNetworks) !== null && _c !== void 0 ? _c : {};
+            if (!supportedNetworks[scope]) {
+                throw new Error(`Chain ${scope} is not configured in supportedNetworks. Requests cannot be made to chains not explicitly configured in supportedNetworks.`);
+            }
+            return __classPrivateFieldGet(this, _EIP1193Provider_core, "f").invokeMethod({
+                scope,
+                request: {
+                    method: request.method,
+                    params: request.params,
+                },
+            });
+        });
+    }
+    // Getters and setters
+    get selectedAccount() {
+        return this.accounts[0];
+    }
+    set accounts(accounts) {
+        __classPrivateFieldSet(this, _EIP1193Provider_accounts, accounts, "f");
+    }
+    get accounts() {
+        return __classPrivateFieldGet(this, _EIP1193Provider_accounts, "f");
+    }
+    get selectedChainId() {
+        return __classPrivateFieldGet(this, _EIP1193Provider_selectedChainId, "f");
+    }
+    set selectedChainId(chainId) {
+        const hexChainId = chainId && typeof chainId === 'number' ? numberToHex(chainId) : chainId;
+        // Don't overwrite the selected chain ID with an undefined value
+        if (!hexChainId) {
+            return;
+        }
+        __classPrivateFieldSet(this, _EIP1193Provider_selectedChainId, hexChainId, "f");
+    }
+}
+_EIP1193Provider_core = new WeakMap(), _EIP1193Provider_requestInterceptor = new WeakMap(), _EIP1193Provider_accounts = new WeakMap(), _EIP1193Provider_selectedChainId = new WeakMap();
+//# sourceMappingURL=provider.js.map

package/dist/src/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,98 @@
+import type { MultichainCore } from '@metamask/connect-multichain';
+export type Hex = `0x${string}`;
+export type Address = Hex;
+export type CaipAccountId = `${string}:${string}:${string}`;
+export type CaipChainId = `${string}:${string}`;
+export type EIP1193ProviderEvents = {
+    connect: [{
+        chainId: string;
+    }];
+    disconnect: [];
+    accountsChanged: [Address[]];
+    chainChanged: [Hex];
+    message: [{
+        type: string;
+        data: unknown;
+    }];
+    connectAndSign: [
+        {
+            accounts: readonly Address[];
+            chainId: number;
+            signResponse: string;
+        }
+    ];
+    connectWith: [
+        {
+            accounts: readonly Address[];
+            chainId: number;
+            connectWithResponse: unknown;
+        }
+    ];
+};
+export type EventHandlers = {
+    connect: (result: {
+        chainId: string;
+        accounts: Address[];
+    }) => void;
+    disconnect: () => void;
+    accountsChanged: (accounts: Address[]) => void;
+    chainChanged: (chainId: Hex) => void;
+    connectAndSign: (result: {
+        accounts: readonly Address[];
+        chainId: number;
+        signResponse: string;
+    }) => void;
+    connectWith: (result: {
+        accounts: readonly Address[];
+        chainId: number;
+        connectWithResponse: unknown;
+    }) => void;
+};
+export type MetamaskConnectEVMOptions = {
+    core: MultichainCore;
+    eventHandlers?: Partial<EventHandlers>;
+    notificationQueue?: unknown[];
+    supportedNetworks?: Record<CaipChainId, string>;
+};
+export type AddEthereumChainParameter = {
+    chainId?: string;
+    chainName?: string;
+    nativeCurrency?: {
+        name?: string;
+        symbol?: string;
+        decimals?: number;
+    };
+    rpcUrls?: string[];
+    blockExplorerUrls?: string[];
+    iconUrls?: string[];
+};
+type ConnectRequest = {
+    method: 'wallet_requestPermissions' | 'eth_requestAccounts';
+    params: [chainId?: number, account?: string];
+};
+type RevokePermissionsRequest = {
+    method: 'wallet_revokePermissions';
+    params: unknown[];
+};
+type SwitchEthereumChainRequest = {
+    method: 'wallet_switchEthereumChain';
+    params: [{
+        chainId: string;
+    }];
+};
+type AddEthereumChainRequest = {
+    method: 'wallet_addEthereumChain';
+    params: [AddEthereumChainParameter];
+};
+type AccountsRequest = {
+    method: 'eth_accounts' | 'eth_coinbase';
+    params: [];
+};
+type GenericProviderRequest = {
+    method: Exclude<string, 'wallet_requestPermissions' | 'eth_requestAccounts' | 'eth_accounts' | 'eth_coinbase' | 'wallet_revokePermissions' | 'wallet_switchEthereumChain' | 'wallet_addEthereumChain'>;
+    params?: unknown;
+};
+export type ProviderRequest = ConnectRequest | RevokePermissionsRequest | SwitchEthereumChainRequest | AddEthereumChainRequest | AccountsRequest | GenericProviderRequest;
+export type ProviderRequestInterceptor = (req: ProviderRequest) => Promise<unknown>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/utils/caip.d.ts

@@ -0,0 +1,18 @@
+import type { SessionData } from '@metamask/connect-multichain';
+import type { Address, Hex } from '../types';
+/**
+ * Get the Ethereum accounts from the session data
+ *
+ * @param sessionScopes - The session scopes
+ * @returns The Ethereum accounts
+ */
+export declare const getEthAccounts: (sessionScopes: SessionData["sessionScopes"] | undefined) => Address[];
+/**
+ * Get the permitted Ethereum chain IDs from the session scopes.
+ * Wrapper around getPermittedEthChainIds from @metamask/chain-agnostic-permission
+ *
+ * @param sessionScopes - The session scopes
+ * @returns The permitted Ethereum chain IDs
+ */
+export declare const getPermittedEthChainIds: (sessionScopes: SessionData["sessionScopes"] | undefined) => Hex[];
+//# sourceMappingURL=caip.d.ts.map

package/dist/src/utils/caip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.ts","sourceRoot":"","sources":["../../../src/utils/caip.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,eAAe,WAAW,CAAC,eAAe,CAAC,GAAG,SAAS,KACtD,OAAO,EAST,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,eAAe,WAAW,CAAC,eAAe,CAAC,GAAG,SAAS,KACtD,GAAG,EASL,CAAC"}

package/dist/src/utils/caip.js

@@ -0,0 +1,33 @@
+import { getPermittedEthChainIds as _getPermittedEthChainIds, getEthAccounts as _getEthAccounts, } from '@metamask/chain-agnostic-permission';
+/**
+ * Get the Ethereum accounts from the session data
+ *
+ * @param sessionScopes - The session scopes
+ * @returns The Ethereum accounts
+ */
+export const getEthAccounts = (sessionScopes) => {
+    if (!sessionScopes) {
+        return [];
+    }
+    return _getEthAccounts({
+        requiredScopes: sessionScopes,
+        optionalScopes: sessionScopes,
+    });
+};
+/**
+ * Get the permitted Ethereum chain IDs from the session scopes.
+ * Wrapper around getPermittedEthChainIds from @metamask/chain-agnostic-permission
+ *
+ * @param sessionScopes - The session scopes
+ * @returns The permitted Ethereum chain IDs
+ */
+export const getPermittedEthChainIds = (sessionScopes) => {
+    if (!sessionScopes) {
+        return [];
+    }
+    return _getPermittedEthChainIds({
+        requiredScopes: sessionScopes,
+        optionalScopes: sessionScopes,
+    });
+};
+//# sourceMappingURL=caip.js.map

package/dist/src/utils/caip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.js","sourceRoot":"","sources":["../../../src/utils/caip.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,IAAI,wBAAwB,EACnD,cAAc,IAAI,eAAe,GAClC,MAAM,qCAAqC,CAAC;AAK7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,aAAuD,EAC5C,EAAE;IACb,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,eAAe,CAAC;QACrB,cAAc,EAAE,aAAqC;QACrD,cAAc,EAAE,aAAqC;KACtD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,aAAuD,EAChD,EAAE;IACT,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,wBAAwB,CAAC;QAC9B,cAAc,EAAE,aAAqC;QACrD,cAAc,EAAE,aAAqC;KACtD,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/src/utils/type-guards.d.ts

@@ -0,0 +1,50 @@
+import type { ProviderRequest } from '../types';
+/**
+ * Type guard for connect-like requests:
+ * - wallet_requestPermissions
+ * - eth_requestAccounts
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a connect-like request, false otherwise
+ */
+export declare function isConnectRequest(req: ProviderRequest): req is Extract<ProviderRequest, {
+    method: 'wallet_requestPermissions' | 'eth_requestAccounts';
+}>;
+/**
+ * Type guard for wallet_switchEthereumChain request.
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a wallet_switchEthereumChain request, false otherwise
+ */
+export declare function isSwitchChainRequest(req: ProviderRequest): req is Extract<ProviderRequest, {
+    method: 'wallet_switchEthereumChain';
+}>;
+/**
+ * Type guard for wallet_addEthereumChain request.
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a wallet_addEthereumChain request, false otherwise
+ */
+export declare function isAddChainRequest(req: ProviderRequest): req is Extract<ProviderRequest, {
+    method: 'wallet_addEthereumChain';
+}>;
+/**
+ * Type guard for generic accounts request:
+ * - eth_accounts
+ * - eth_coinbase
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a generic accounts request, false otherwise
+ */
+export declare function isAccountsRequest(req: ProviderRequest): req is Extract<ProviderRequest, {
+    method: 'eth_accounts' | 'eth_coinbase';
+}>;
+/**
+ * Validates that all values in a Record are valid URLs.
+ *
+ * @param record - The record to validate (e.g., supportedNetworks)
+ * @param recordName - The name of the record for error messages
+ * @throws Error if any values are invalid URLs
+ */
+export declare function validSupportedChainsUrls(record: Record<string, string>, recordName: string): void;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/src/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,IAAI,OAAO,CACpE,eAAe,EACf;IACE,MAAM,EAAE,2BAA2B,GAAG,qBAAqB,CAAC;CAC7D,CACF,CAKA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,eAAe,GACnB,GAAG,IAAI,OAAO,CAAC,eAAe,EAAE;IAAE,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,GACnB,GAAG,IAAI,OAAO,CAAC,eAAe,EAAE;IAAE,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC,CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,GACnB,GAAG,IAAI,OAAO,CACf,eAAe,EACf;IAAE,MAAM,EAAE,cAAc,GAAG,cAAc,CAAA;CAAE,CAC5C,CAEA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,UAAU,EAAE,MAAM,GACjB,IAAI,CAgBN"}

package/dist/src/utils/type-guards.js

@@ -0,0 +1,64 @@
+/**
+ * Type guard for connect-like requests:
+ * - wallet_requestPermissions
+ * - eth_requestAccounts
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a connect-like request, false otherwise
+ */
+export function isConnectRequest(req) {
+    return (req.method === 'wallet_requestPermissions' ||
+        req.method === 'eth_requestAccounts');
+}
+/**
+ * Type guard for wallet_switchEthereumChain request.
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a wallet_switchEthereumChain request, false otherwise
+ */
+export function isSwitchChainRequest(req) {
+    return req.method === 'wallet_switchEthereumChain';
+}
+/**
+ * Type guard for wallet_addEthereumChain request.
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a wallet_addEthereumChain request, false otherwise
+ */
+export function isAddChainRequest(req) {
+    return req.method === 'wallet_addEthereumChain';
+}
+/**
+ * Type guard for generic accounts request:
+ * - eth_accounts
+ * - eth_coinbase
+ *
+ * @param req - The request object to check
+ * @returns True if the request is a generic accounts request, false otherwise
+ */
+export function isAccountsRequest(req) {
+    return req.method === 'eth_accounts' || req.method === 'eth_coinbase';
+}
+/**
+ * Validates that all values in a Record are valid URLs.
+ *
+ * @param record - The record to validate (e.g., supportedNetworks)
+ * @param recordName - The name of the record for error messages
+ * @throws Error if any values are invalid URLs
+ */
+export function validSupportedChainsUrls(record, recordName) {
+    const invalidUrls = [];
+    for (const [key, url] of Object.entries(record)) {
+        try {
+            // eslint-disable-next-line no-new
+            new URL(url);
+        }
+        catch (_a) {
+            invalidUrls.push(`${key}: ${url}`);
+        }
+    }
+    if (invalidUrls.length > 0) {
+        throw new Error(`${recordName} contains invalid URLs:\n${invalidUrls.join('\n')}`);
+    }
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/src/utils/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../../src/utils/type-guards.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAoB;IAMnD,OAAO,CACL,GAAG,CAAC,MAAM,KAAK,2BAA2B;QAC1C,GAAG,CAAC,MAAM,KAAK,qBAAqB,CACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAoB;IAEpB,OAAO,GAAG,CAAC,MAAM,KAAK,4BAA4B,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAoB;IAEpB,OAAO,GAAG,CAAC,MAAM,KAAK,yBAAyB,CAAC;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAoB;IAKpB,OAAO,GAAG,CAAC,MAAM,KAAK,cAAc,IAAI,GAAG,CAAC,MAAM,KAAK,cAAc,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAA8B,EAC9B,UAAkB;IAElB,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,kCAAkC;YAClC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QAAC,WAAM,CAAC;YACP,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,4BAA4B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/types/index.d.ts

@@ -117,6 +117,15 @@ declare class EIP1193Provider extends EventEmitter<EIP1193ProviderEvents> {
     set selectedChainId(chainId: Hex | number | undefined);
 }
 
+/** The options for the connect method */
+type ConnectOptions = {
+    /** The account to connect to */
+    account?: string | undefined;
+    /** Whether to force a request regardless of an existing session */
+    forceRequest?: boolean;
+    /** All available chain IDs in the dapp */
+    chainIds: number[];
+};
 /**
  * The MetamaskConnectEVM class provides an EIP-1193 compatible interface for connecting
  * to MetaMask and interacting with Ethereum Virtual Machine (EVM) networks.
@@ -158,43 +167,44 @@ declare class MetamaskConnectEVM {
      * Connects to the wallet with the specified chain ID and optional account.
      *
      * @param options - The connection options
-     * @param options.chainId - The chain ID to connect to (defaults to 1 for mainnet)
      * @param options.account - Optional specific account to connect to
      * @param options.forceRequest - Wwhether to force a request regardless of an existing session
+     * @param options.chainIds - Array of chain IDs to connect to
      * @returns A promise that resolves with the connected accounts and chain ID
      */
-    connect({ chainId, account, forceRequest, }?: {
-        chainId: number;
-        account?: string | undefined;
-        forceRequest?: boolean;
-    }): Promise<{
+    connect({ account, forceRequest, chainIds }?: ConnectOptions): Promise<{
         accounts: Address[];
         chainId: number;
     }>;
     /**
      * Connects to the wallet and signs a message using personal_sign.
      *
-     * @param message - The message to sign
+     * @param options - The connection options
+     * @param options.message - The message to sign after connecting
+     * @param options.chainIds - Optional chain IDs to connect to (defaults to ethereum mainnet if not provided)
      * @returns A promise that resolves with the signature
      * @throws Error if the selected account is not available after timeout
      */
-    connectAndSign(message: string): Promise<string>;
+    connectAndSign({ message, chainIds, }: {
+        message: string;
+        chainIds?: number[];
+    }): Promise<string>;
     /**
      * Connects to the wallet and invokes a method with specified parameters.
      *
      * @param options - The options for connecting and invoking the method
      * @param options.method - The method name to invoke
      * @param options.params - The parameters to pass to the method, or a function that receives the account and returns params
-     * @param options.chainId - Optional chain ID to connect to (defaults to mainnet)
+     * @param options.chainIds - Optional chain IDs to connect to (defaults to ethereum mainnet if not provided)
      * @param options.account - Optional specific account to connect to
      * @param options.forceRequest - Whether to force a request regardless of an existing session
      * @returns A promise that resolves with the result of the method invocation
      * @throws Error if the selected account is not available after timeout (for methods that require an account)
      */
-    connectWith({ method, params, chainId, account, forceRequest, }: {
+    connectWith({ method, params, chainIds, account, forceRequest, }: {
         method: string;
         params: unknown[] | ((account: Address) => unknown[]);
-        chainId?: number;
+        chainIds?: number[];
         account?: string | undefined;
         forceRequest?: boolean;
     }): Promise<unknown>;

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@metamask/connect-evm",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "EVM Layer for MetaMask Connect",
   "keywords": [
     "MetaMask",
     "Ethereum"
   ],
-  "homepage": "https://github.com/MetaMask/metamask-connect-monorepo/tree/main/packages/connect-evm#readme",
+  "homepage": "https://github.com/MetaMask/connect-monorepo/tree/main/packages/connect-evm#readme",
   "bugs": {
     "url": ""
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/MetaMask/metamask-connect-monorepo.git"
+    "url": "https://github.com/MetaMask/connect-monorepo.git"
   },
   "license": "MIT",
   "sideEffects": false,
@@ -56,7 +56,7 @@
   "dependencies": {
     "@metamask/analytics": "^0.2.0",
     "@metamask/chain-agnostic-permission": "^1.2.2",
-    "@metamask/connect-multichain": "^0.3.2",
+    "@metamask/connect-multichain": "^0.4.0",
     "@metamask/utils": "^11.8.1"
   },
   "devDependencies": {
@@ -68,11 +68,11 @@
     "tsup": "^8.4.0",
     "typedoc": "^0.28.14",
     "typedoc-plugin-missing-exports": "^4.1.2",
-    "typescript": "~5.9.2",
+    "typescript": "^5.9.3",
     "vitest": "^3.1.2"
   },
   "engines": {
-    "node": "^18.18 || >=20"
+    "node": ">=20.19.0"
   },
   "publishConfig": {
     "access": "public",