add jsdocs

Author: adonesky1

packages/network-controller/src/NetworkController.ts

@@ -650,8 +650,8 @@ export class NetworkController extends BaseController<
 
   /**
    * Accesses the provider and block tracker for the currently selected network.
-   *
    * @returns The proxy and block tracker proxies.
+   * @deprecated This method has been replaced by `getSelectedNetworkClient` (which has a more easily used return type) and will be removed in a future release.
    */
   getProviderAndBlockTracker(): {
     provider: SwappableProxy<ProxyWithAccessibleTarget<Provider>> | undefined;
@@ -665,6 +665,11 @@ export class NetworkController extends BaseController<
     };
   }
 
+  /**
+   * Accesses the provider and block tracker for the currently selected network.
+   *
+   * @returns an object with the provider and block tracker proxies for the currently selected network.
+   */
   getSelectedNetworkClient():
     | {
         provider: SwappableProxy<ProxyWithAccessibleTarget<Provider>>;

packages/selected-network-controller/src/SelectedNetworkController.ts

@@ -231,6 +231,12 @@ export class SelectedNetworkController extends BaseController<
     });
   }
 
+  /**
+   * This method is used when a domain is removed from the PermissionsController.
+   * It will remove repoint the network proxy to the globally selected network in the domainProxyMap or, if no globally selected network client is available, delete the proxy.
+   *
+   * @param domain - The domain for which to unset the network client ID.
+   */
   #unsetNetworkClientIdForDomain(domain: Domain) {
     const globallySelectedNetworkClient = this.messagingSystem.call(
       'NetworkController:getSelectedNetworkClient',