update docstrings, fix bug

Author: Roman

bittensor/core/async_subtensor.py

@@ -127,7 +127,7 @@ def __init__(
             network (str): The network name or type to connect to.
             config (Optional[Config]): Configuration object for the AsyncSubtensor instance.
             log_verbose (bool): Enables or disables verbose logging.
-            fallback_chains (list): List of fallback chains to use if no network is specified. Defaults to `None`.
+            fallback_chains (list): List of fallback chains endpoints to use if no network is specified. Defaults to `None`.
             retry_forever (bool): Whether to retry forever on connection errors. Defaults to `False`.
             _mock: Whether this is a mock instance. Mainly just for use in testing.
 
@@ -148,14 +148,6 @@ def __init__(
             f"Connecting to network: [blue]{self.network}[/blue], "
             f"chain_endpoint: [blue]{self.chain_endpoint}[/blue]..."
         )
-        self.substrate = AsyncSubstrateInterface(
-            url=self.chain_endpoint,
-            ss58_format=SS58_FORMAT,
-            type_registry=TYPE_REGISTRY,
-            use_remote_preset=True,
-            chain_name="Bittensor",
-            _mock=_mock,
-        )
         self.substrate = self._get_substrate(
             fallback_chains=fallback_chains, retry_forever=retry_forever, _mock=_mock
         )
@@ -300,7 +292,7 @@ def _get_substrate(
         """Creates the Substrate instance based on provided arguments.
 
         Arguments:
-            fallback_chains (list): List of fallback chains to use if no network is specified. Defaults to `None`.
+            fallback_chains (list): List of fallback chains endpoints to use if no network is specified. Defaults to `None`.
             retry_forever (bool): Whether to retry forever on connection errors. Defaults to `False`.
             _mock: Whether this is a mock instance. Mainly just for use in testing.
 

bittensor/core/subtensor.py

@@ -129,7 +129,7 @@ def __init__(
             network (str): The network name or type to connect to.
             config (Optional[Config]): Configuration object for the AsyncSubtensor instance.
             log_verbose (bool): Enables or disables verbose logging.
-            fallback_chains (list): List of fallback chains to use if no network is specified. Defaults to `None`.
+            fallback_chains (list): List of fallback chains endpoints to use if no network is specified. Defaults to `None`.
             retry_forever (bool): Whether to retry forever on connection errors. Defaults to `False`.
             _mock: Whether this is a mock instance. Mainly just for use in testing.
 
@@ -175,7 +175,7 @@ def _get_substrate(
         """Creates the Substrate instance based on provided arguments.
 
         Arguments:
-            fallback_chains (list): List of fallback chains to use if no network is specified. Defaults to `None`.
+            fallback_chains (list): List of fallback chains endpoints to use if no network is specified. Defaults to `None`.
             retry_forever (bool): Whether to retry forever on connection errors. Defaults to `False`.
             _mock: Whether this is a mock instance. Mainly just for use in testing.
 

bittensor/core/subtensor_api/__init__.py

@@ -53,6 +53,11 @@ class SubtensorApi:
 
         subtensor = bt.SubtensorApi(legacy_methods=True)
         print(subtensor.bonds(0))
+
+        # using `fallback_chains` or `retry_forever`
+        import bittensor as bt
+
+
     """
 
     def __init__(
@@ -123,6 +128,12 @@ def _get_subtensor(self) -> Union["_Subtensor", "_AsyncSubtensor"]:
                 _mock=self._mock,
             )
 
+    def _determine_chain_endpoint(self) -> str:
+        """Determines the connection and mock flag."""
+        if self._mock:
+            return "Mock"
+        return self.substrate.url
+
     def __str__(self):
         return (
             f"<Network: {self.network}, "
@@ -145,12 +156,6 @@ async def __aenter__(self):
     async def __aexit__(self, exc_type, exc_val, exc_tb):
         await self.substrate.close()
 
-    def _determine_chain_endpoint(self) -> str:
-        """Determines the connection and mock flag."""
-        if self._mock:
-            return "Mock"
-        return self.substrate.url
-
     @property
     def block(self):
         """Returns current chain block number."""