@dynamic-labs/wallet-connector-core 3.0.0-alpha.3 → 3.0.0-alpha.30

package/src/lib/WalletConnector.cjs

@@ -6,6 +6,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _tslib = require('../../_virtual/_tslib.cjs');
 var EventEmitter = require('eventemitter3');
 var walletBook = require('@dynamic-labs/wallet-book');
+var utils = require('@dynamic-labs/utils');
+var logger = require('../utils/logger.cjs');
+var getMobileExperience = require('../utils/getMobileExperience/getMobileExperience.cjs');
 var WalletBookSingleton = require('./WalletBookSingleton.cjs');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -77,21 +80,11 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
          */
         this.canConnectViaSocial = false;
         /**
-         * @deprecated getWeb3Provider has been renamed to getWalletClient
-         * If you would like to still get the ethers web3Provider,
-         *  see our docs for enabling ethers: https://docs.dynamic.xyz/ethers
+         * Flag if connector/provider is available
          *
-         * Get the wallet provider
-         */
-        this.getWeb3Provider = this.getWalletClient;
-        /**
-         * @deprecated getRpcProvider has been renamed to getPublicClient
-         * If you would like to still get the ethers rpcProvider,
-         *  see our docs for enabling ethers: https://docs.dynamic.xyz/ethers
-         *
-         * Get the rpc provider
+         * @default true
          */
-        this.getRpcProvider = this.getPublicClient;
+        this.isAvailable = true;
         /**
          * If the wallet generated by a valid embedded wallet provider
          * For example: magic wallets
@@ -134,6 +127,11 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
         if (_tslib.__classPrivateFieldGet(this, _WalletConnectorBase_registeredExtensions, "f").includes(extension.name)) {
             throw new Error(`You can only register a single extension of: ${extension.name}`);
         }
+        if (extension.name === 'global-wallet-extension') {
+            // only allow global wallet extension for evm embedded wallets
+            if (!this.isEmbeddedWallet || !this.supportedChains.includes('EVM'))
+                return;
+        }
         _tslib.__classPrivateFieldGet(this, _WalletConnectorBase_registeredExtensions, "f").push(extension.name);
         extension.extend(this);
     }
@@ -159,6 +157,13 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
             return false;
         }
     }
+    get mobileExperience() {
+        return getMobileExperience.getMobileExperience({
+            mobileExperienceProp: this.constructorProps.mobileExperience,
+            walletBook: this.walletBook,
+            walletKey: this.key,
+        });
+    }
     connect() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             yield this.getAddress();
@@ -182,6 +187,25 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
     getAddress(opts) {
         return Promise.resolve(undefined);
     }
+    /**
+     * Parses a public address to ensure it follows a correct format.
+     *
+     * For instance, with EVM wallets, this might ensure it follows the EIP 55 format.
+     *
+     * @default string
+     */
+    parseAddress(address) {
+        return address;
+    }
+    /**
+     * Whether this wallet connector is targeting a testnet.
+     * So far only supported for EVM connectors.
+     *
+     * @default Promise<false>
+     */
+    isTestnet() {
+        return Promise.resolve(false);
+    }
     /**
      * Gets the additional addresses of the wallet, given the main address
      *
@@ -203,7 +227,7 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
      *
      * @default Promise<undefined>
      */
-    getBalance() {
+    getBalance(address) {
         return Promise.resolve(undefined);
     }
     /**
@@ -230,7 +254,7 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
      *
      * @default Promise<undefined>
      */
-    getNameService() {
+    getNameService(address) {
         return Promise.resolve(undefined);
     }
     getPublicClient() {
@@ -327,6 +351,41 @@ class WalletConnectorBase extends EventEmitter__default["default"] {
     setVerifiedCredentials(verifiedCredentials) {
         return;
     }
+    /**
+     * Validates if the address is connected and active in the wallet app
+     *
+     * @throws {WalletAddressMismatchError} If the active address does not match the expected address.
+     * @returns {Promise<void>} A promise that resolves if the active address matches the expected address,
+     * otherwise rejects with an error.
+     */
+    validateActiveWallet(expectedAddress) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const [activeAddress] = yield this.getConnectedAccounts();
+            const isWalletActive = activeAddress === expectedAddress;
+            logger.logger.debug(`validateActiveWallet - wallet ${isWalletActive ? 'is' : 'is not'} active`, {
+                activeAddress,
+                expectedAddress,
+            });
+            const walletUiUtils = this.constructorProps
+                .walletUiUtils;
+            if (isWalletActive) {
+                return;
+            }
+            if (!walletUiUtils) {
+                throw new utils.WalletAddressMismatchError(`Wallet ${expectedAddress !== null && expectedAddress !== void 0 ? expectedAddress : ''} is not currently active in ${(_a = this.name) !== null && _a !== void 0 ? _a : this.key}.`, {
+                    activeAddress,
+                    expectedAddress,
+                    walletName: (_b = this.name) !== null && _b !== void 0 ? _b : this.key,
+                });
+            }
+            return walletUiUtils.syncWallet({
+                activeAddress,
+                expectedAddress,
+                walletConnector: this,
+            });
+        });
+    }
 }
 _WalletConnectorBase_registeredExtensions = new WeakMap();
 

package/src/lib/WalletConnector.d.ts

@@ -2,6 +2,7 @@ import EventEmitter from 'eventemitter3';
 import { WalletBookSchema, WalletSchema } from '@dynamic-labs/wallet-book';
 import type { JwtVerifiedCredential, WalletAdditionalAddress } from '@dynamic-labs/sdk-api-core';
 import { IChainRpcProviders } from '@dynamic-labs/rpc-providers';
+import { MobileExperience } from '@dynamic-labs/types';
 import { WalletBookSingleton } from './WalletBookSingleton';
 import { WalletConnectorExtension } from './WalletConnectorExtension';
 import { WalletConnectorCore } from './types';
@@ -70,6 +71,7 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
     initEventListener(): void;
     get walletBook(): WalletBookSchema;
     filter(): boolean;
+    get mobileExperience(): MobileExperience | undefined;
     /**
      * This flag corresponds to whether this wallet connector also requires its own email otp outside dynamic
      * @default false
@@ -120,6 +122,21 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
      * @default Promise<undefined>
      */
     getAddress(opts?: GetAddressOpts): Promise<string | undefined>;
+    /**
+     * Parses a public address to ensure it follows a correct format.
+     *
+     * For instance, with EVM wallets, this might ensure it follows the EIP 55 format.
+     *
+     * @default string
+     */
+    parseAddress(address: string): string;
+    /**
+     * Whether this wallet connector is targeting a testnet.
+     * So far only supported for EVM connectors.
+     *
+     * @default Promise<false>
+     */
+    isTestnet(): Promise<boolean>;
     /**
      * Gets the additional addresses of the wallet, given the main address
      *
@@ -137,7 +154,7 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
      *
      * @default Promise<undefined>
      */
-    getBalance(): Promise<string | undefined>;
+    getBalance(address: string): Promise<string | undefined>;
     /**
      * Get the address silently
      *
@@ -161,7 +178,7 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
      *
      * @default Promise<undefined>
      */
-    getNameService(): Promise<NameServiceData | undefined>;
+    getNameService(address: string): Promise<NameServiceData | undefined>;
     /**
      * Get the RPC provider for the wallet
      *
@@ -169,28 +186,6 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
      */
     getPublicClient(): Promise<unknown>;
     getPublicClient<T>(): Promise<T>;
-    /**
-     * @deprecated getWeb3Provider has been renamed to getWalletClient
-     * If you would like to still get the ethers web3Provider,
-     *  see our docs for enabling ethers: https://docs.dynamic.xyz/ethers
-     *
-     * Get the wallet provider
-     */
-    getWeb3Provider: {
-        (chainId?: string): unknown;
-        <T>(chainId?: string): T;
-    };
-    /**
-     * @deprecated getRpcProvider has been renamed to getPublicClient
-     * If you would like to still get the ethers rpcProvider,
-     *  see our docs for enabling ethers: https://docs.dynamic.xyz/ethers
-     *
-     * Get the rpc provider
-     */
-    getRpcProvider: {
-        (): Promise<unknown>;
-        <T>(): Promise<T>;
-    };
     /**
      * Get the session for the wallet
      * @default Promise<undefined>
@@ -217,6 +212,12 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
      * @default Promise<void>
      */
     init(): Promise<void>;
+    /**
+     * Flag if connector/provider is available
+     *
+     * @default true
+     */
+    isAvailable: boolean;
     /**
      * If the wallet generated by a valid embedded wallet provider
      * For example: magic wallets
@@ -316,4 +317,12 @@ export declare abstract class WalletConnectorBase extends EventEmitter<WalletCon
      * Receive the user verified credentials
      */
     setVerifiedCredentials(verifiedCredentials: JwtVerifiedCredential[]): void;
+    /**
+     * Validates if the address is connected and active in the wallet app
+     *
+     * @throws {WalletAddressMismatchError} If the active address does not match the expected address.
+     * @returns {Promise<void>} A promise that resolves if the active address matches the expected address,
+     * otherwise rejects with an error.
+     */
+    validateActiveWallet(expectedAddress: string): Promise<void>;
 }

package/src/lib/WalletConnector.js

@@ -2,6 +2,9 @@
 import { __classPrivateFieldGet, __awaiter } from '../../_virtual/_tslib.js';
 import EventEmitter from 'eventemitter3';
 import { getWalletBookWallet } from '@dynamic-labs/wallet-book';
+import { WalletAddressMismatchError } from '@dynamic-labs/utils';
+import { logger } from '../utils/logger.js';
+import { getMobileExperience } from '../utils/getMobileExperience/getMobileExperience.js';
 import { WalletBookSingleton } from './WalletBookSingleton.js';
 
 /* eslint-disable @typescript-eslint/triple-slash-reference */
@@ -69,21 +72,11 @@ class WalletConnectorBase extends EventEmitter {
          */
         this.canConnectViaSocial = false;
         /**
-         * @deprecated getWeb3Provider has been renamed to getWalletClient
-         * If you would like to still get the ethers web3Provider,
-         *  see our docs for enabling ethers: https://docs.dynamic.xyz/ethers
+         * Flag if connector/provider is available
          *
-         * Get the wallet provider
-         */
-        this.getWeb3Provider = this.getWalletClient;
-        /**
-         * @deprecated getRpcProvider has been renamed to getPublicClient
-         * If you would like to still get the ethers rpcProvider,
-         *  see our docs for enabling ethers: https://docs.dynamic.xyz/ethers
-         *
-         * Get the rpc provider
+         * @default true
          */
-        this.getRpcProvider = this.getPublicClient;
+        this.isAvailable = true;
         /**
          * If the wallet generated by a valid embedded wallet provider
          * For example: magic wallets
@@ -126,6 +119,11 @@ class WalletConnectorBase extends EventEmitter {
         if (__classPrivateFieldGet(this, _WalletConnectorBase_registeredExtensions, "f").includes(extension.name)) {
             throw new Error(`You can only register a single extension of: ${extension.name}`);
         }
+        if (extension.name === 'global-wallet-extension') {
+            // only allow global wallet extension for evm embedded wallets
+            if (!this.isEmbeddedWallet || !this.supportedChains.includes('EVM'))
+                return;
+        }
         __classPrivateFieldGet(this, _WalletConnectorBase_registeredExtensions, "f").push(extension.name);
         extension.extend(this);
     }
@@ -151,6 +149,13 @@ class WalletConnectorBase extends EventEmitter {
             return false;
         }
     }
+    get mobileExperience() {
+        return getMobileExperience({
+            mobileExperienceProp: this.constructorProps.mobileExperience,
+            walletBook: this.walletBook,
+            walletKey: this.key,
+        });
+    }
     connect() {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.getAddress();
@@ -174,6 +179,25 @@ class WalletConnectorBase extends EventEmitter {
     getAddress(opts) {
         return Promise.resolve(undefined);
     }
+    /**
+     * Parses a public address to ensure it follows a correct format.
+     *
+     * For instance, with EVM wallets, this might ensure it follows the EIP 55 format.
+     *
+     * @default string
+     */
+    parseAddress(address) {
+        return address;
+    }
+    /**
+     * Whether this wallet connector is targeting a testnet.
+     * So far only supported for EVM connectors.
+     *
+     * @default Promise<false>
+     */
+    isTestnet() {
+        return Promise.resolve(false);
+    }
     /**
      * Gets the additional addresses of the wallet, given the main address
      *
@@ -195,7 +219,7 @@ class WalletConnectorBase extends EventEmitter {
      *
      * @default Promise<undefined>
      */
-    getBalance() {
+    getBalance(address) {
         return Promise.resolve(undefined);
     }
     /**
@@ -222,7 +246,7 @@ class WalletConnectorBase extends EventEmitter {
      *
      * @default Promise<undefined>
      */
-    getNameService() {
+    getNameService(address) {
         return Promise.resolve(undefined);
     }
     getPublicClient() {
@@ -319,6 +343,41 @@ class WalletConnectorBase extends EventEmitter {
     setVerifiedCredentials(verifiedCredentials) {
         return;
     }
+    /**
+     * Validates if the address is connected and active in the wallet app
+     *
+     * @throws {WalletAddressMismatchError} If the active address does not match the expected address.
+     * @returns {Promise<void>} A promise that resolves if the active address matches the expected address,
+     * otherwise rejects with an error.
+     */
+    validateActiveWallet(expectedAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const [activeAddress] = yield this.getConnectedAccounts();
+            const isWalletActive = activeAddress === expectedAddress;
+            logger.debug(`validateActiveWallet - wallet ${isWalletActive ? 'is' : 'is not'} active`, {
+                activeAddress,
+                expectedAddress,
+            });
+            const walletUiUtils = this.constructorProps
+                .walletUiUtils;
+            if (isWalletActive) {
+                return;
+            }
+            if (!walletUiUtils) {
+                throw new WalletAddressMismatchError(`Wallet ${expectedAddress !== null && expectedAddress !== void 0 ? expectedAddress : ''} is not currently active in ${(_a = this.name) !== null && _a !== void 0 ? _a : this.key}.`, {
+                    activeAddress,
+                    expectedAddress,
+                    walletName: (_b = this.name) !== null && _b !== void 0 ? _b : this.key,
+                });
+            }
+            return walletUiUtils.syncWallet({
+                activeAddress,
+                expectedAddress,
+                walletConnector: this,
+            });
+        });
+    }
 }
 _WalletConnectorBase_registeredExtensions = new WeakMap();
 

package/src/lib/index.d.ts

@@ -13,3 +13,4 @@ export * from './IWalletConnectConnector';
 export * from './ISendBalanceWalletConnector';
 export * from './ISessionKeyCompatibleWalletConnector';
 export * from './ISMSWalletConnector';
+export * from './wallets';

package/src/lib/wallets/Wallet/Wallet.cjs

@@ -0,0 +1,160 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../_virtual/_tslib.cjs');
+var types = require('@dynamic-labs/types');
+var logger = require('../../../utils/logger.cjs');
+require('@dynamic-labs/utils');
+require('@dynamic-labs/wallet-book');
+
+var _Wallet_connector;
+class Wallet extends types.BaseWallet {
+    constructor(_a) {
+        var { connector } = _a, props = _tslib.__rest(_a, ["connector"]);
+        super(props);
+        _Wallet_connector.set(this, void 0);
+        _tslib.__classPrivateFieldSet(this, _Wallet_connector, connector, "f");
+    }
+    /**
+     * Gets the wallet connector.
+     */
+    get connector() {
+        return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f");
+    }
+    /**
+     * Retrieves the balance of the wallet.
+     * @returns A promise that resolves to the balance of the wallet as a string,
+     * or undefined if the balance cannot be retrieved.
+     */
+    getBalance() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getBalance(this.address);
+        });
+    }
+    /**
+     * Retrieves the name service data associated with the wallet.
+     * @returns A promise that resolves to the name service data of the wallet,
+     * or undefined if the data cannot be retrieved.
+     */
+    getNameService() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getNameService(this.address);
+        });
+    }
+    /**
+     * Retrieves the network that the wallet is connected to.
+     * @returns A promise that resolves to the network value as a string or number,
+     * or undefined if the network cannot be retrieved.
+     */
+    getNetwork() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getNetwork();
+        });
+    }
+    /**
+     * Retrieves the rpc provider for the wallet.
+     * @returns A promise that resolves to the provider,
+     * or undefined if the provider cannot be retrieved.
+     */
+    getPublicClient() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getPublicClient();
+        });
+    }
+    /**
+     * Retrieves the signer for the wallet.
+     * @returns A promise that resolves to the signer,
+     * or undefined if the signer cannot be retrieved.
+     */
+    getSigner() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this.sync();
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getSigner();
+        });
+    }
+    /**
+     * Retrieves the wallet client.
+     * @param chainId - (optional) Chain id to be used by the wallet client.
+     * @returns A promise that resolves to the wallet client,
+     * or undefined if the wallet client cannot be retrieved.
+     */
+    getWalletClient(chainId) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this.sync();
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getWalletClient(chainId);
+        });
+    }
+    /**
+     * If the wallet is availble to use. A wallet is available if its provider is available.
+     * @returns True if the wallet is available, false otherwise.
+     */
+    isAvailable() {
+        return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").isAvailable;
+    }
+    /**
+     * If the wallet is connected.
+     * @returns A promise that resolves to true the wallet is connected or false if it's not connected.
+     */
+    isConnected() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const connectedAccounts = yield _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").getConnectedAccounts();
+                return connectedAccounts.includes(this.address);
+            }
+            catch (error) {
+                logger.logger.error('[Wallet] isConnected - Error detecting if wallet is connected', error);
+                return false;
+            }
+        });
+    }
+    /**
+     * Proves ownership of the wallet by signing a message.
+     * @param messageToSign - The message to sign.
+     * @returns A promise that resolves to the signature of the message as a string,
+     *  or undefined if the message cannot be signed.
+     */
+    proveOwnership(messageToSign) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this.sync();
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").proveOwnership(messageToSign);
+        });
+    }
+    /**
+     * Signs a message using the wallet.
+     * @param messageToSign - The message to sign.
+     * @returns A promise that resolves to the signature of the message as a string,
+     * or undefined if the message cannot be signed.
+     */
+    signMessage(messageToSign) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this.sync();
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").signMessage(messageToSign);
+        });
+    }
+    /**
+     * Switches the network that the wallet is connected to.
+     * @param networkChainId - The chain id of the network to switch to.
+     * @returns A promise that resolves when the network is switched.
+     */
+    switchNetwork(networkChainId) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").switchNetwork({
+                networkChainId,
+            });
+        });
+    }
+    /**
+     * Synchronizes the wallet with the connector.
+     * @returns A promise that resolves when the wallet is connected and active.
+     */
+    sync() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            return _tslib.__classPrivateFieldGet(this, _Wallet_connector, "f").validateActiveWallet(this.address);
+        });
+    }
+}
+_Wallet_connector = new WeakMap();
+
+exports.Wallet = Wallet;

package/src/lib/wallets/Wallet/Wallet.d.ts

@@ -0,0 +1,87 @@
+import type { BaseWalletProps } from '@dynamic-labs/types';
+import { BaseWallet } from '@dynamic-labs/types';
+import { NameServiceData, WalletConnector } from '../../';
+type WalletProps = BaseWalletProps & {
+    connector: WalletConnector;
+};
+export declare class Wallet extends BaseWallet {
+    #private;
+    constructor({ connector, ...props }: WalletProps);
+    /**
+     * Gets the wallet connector.
+     */
+    get connector(): WalletConnector;
+    /**
+     * Retrieves the balance of the wallet.
+     * @returns A promise that resolves to the balance of the wallet as a string,
+     * or undefined if the balance cannot be retrieved.
+     */
+    getBalance(): Promise<string | undefined>;
+    /**
+     * Retrieves the name service data associated with the wallet.
+     * @returns A promise that resolves to the name service data of the wallet,
+     * or undefined if the data cannot be retrieved.
+     */
+    getNameService(): Promise<NameServiceData | undefined>;
+    /**
+     * Retrieves the network that the wallet is connected to.
+     * @returns A promise that resolves to the network value as a string or number,
+     * or undefined if the network cannot be retrieved.
+     */
+    getNetwork(): Promise<string | number | undefined>;
+    /**
+     * Retrieves the rpc provider for the wallet.
+     * @returns A promise that resolves to the provider,
+     * or undefined if the provider cannot be retrieved.
+     */
+    getPublicClient<T>(): Promise<T>;
+    /**
+     * Retrieves the signer for the wallet.
+     * @returns A promise that resolves to the signer,
+     * or undefined if the signer cannot be retrieved.
+     */
+    getSigner<T>(): Promise<T>;
+    /**
+     * Retrieves the wallet client.
+     * @param chainId - (optional) Chain id to be used by the wallet client.
+     * @returns A promise that resolves to the wallet client,
+     * or undefined if the wallet client cannot be retrieved.
+     */
+    getWalletClient<T>(chainId?: string): Promise<T>;
+    /**
+     * If the wallet is availble to use. A wallet is available if its provider is available.
+     * @returns True if the wallet is available, false otherwise.
+     */
+    isAvailable(): boolean;
+    /**
+     * If the wallet is connected.
+     * @returns A promise that resolves to true the wallet is connected or false if it's not connected.
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Proves ownership of the wallet by signing a message.
+     * @param messageToSign - The message to sign.
+     * @returns A promise that resolves to the signature of the message as a string,
+     *  or undefined if the message cannot be signed.
+     */
+    proveOwnership(messageToSign: string): Promise<string | undefined>;
+    /**
+     * Signs a message using the wallet.
+     * @param messageToSign - The message to sign.
+     * @returns A promise that resolves to the signature of the message as a string,
+     * or undefined if the message cannot be signed.
+     */
+    signMessage(messageToSign: string): Promise<string | undefined>;
+    /**
+     * Switches the network that the wallet is connected to.
+     * @param networkChainId - The chain id of the network to switch to.
+     * @returns A promise that resolves when the network is switched.
+     */
+    switchNetwork(networkChainId: number | string): Promise<void>;
+    /**
+     * Synchronizes the wallet with the connector.
+     * @returns A promise that resolves when the wallet is connected and active.
+     */
+    sync(): Promise<void>;
+}
+export {};