Renamed SubstrateNodeExtension

Updated extensions docs

docs/extensions/index.md

@@ -7,16 +7,15 @@ It allows for the integration of third-party search indices, which can be easily
 other data sources that provide the same functionality, as long as they adhere to standardized naming conventions in
 the extension registry.
 
-## Search extensions
+## Available extensions
 
-At present, the only type of extension that has been implemented is the search extension. While other types of 
-extensions may be developed in the future, the current implementation provides a fallback option that uses only 
-existing Substrate RPC methods. 
+| Name                                           | Maintained by        | Code                                                                              |
+|------------------------------------------------|----------------------|-----------------------------------------------------------------------------------|
+| [SubstrateNodeExtension](./substrate-node-extension) | Polkascan Foundation | [Github](https://github.com/polkascan/py-substrate-interface)                     |
+| [PolkascanExtension](./polkascan-extension.md) | Polkascan Foundation | [Github](https://github.com/polkascan/py-substrate-interface-extension-polkascan) |
 
-However, it is important to note that this fallback implementation is significantly 
-inefficient, and it is encouraged to utilize third-party search indices where possible for optimal search performance.
 
-### Available extension calls
+## Available extension calls
 
 |                 |                                                                                                                         |
 |-----------------|-------------------------------------------------------------------------------------------------------------------------|

docs/extensions/polkascan-extension.md

@@ -1,4 +1,4 @@
-# PolkascanSearchExtension
+# PolkascanExtension
 
 This extension enables indexes provided by [Polkascan Explorer API](https://github.com/polkascan/explorer#explorer-api-component).
 
@@ -13,11 +13,11 @@ pip install substrate-interface-polkascan
 
 ```python
 from substrateinterface import SubstrateInterface 
-from substrateinterface_polkascan.extensions import PolkascanSearchExtension
+from substrateinterface_polkascan.extensions import PolkascanExtension
 
 substrate = SubstrateInterface(url="ws://127.0.0.1:9944")
 
-substrate.register_extension(PolkascanSearchExtension(url='http://127.0.0.1:8000/graphql/'))
+substrate.register_extension(PolkascanExtension(url='http://127.0.0.1:8000/graphql/'))
 ```
 
 ## Implemented extension calls

docs/extensions/substrate-node-extension.md

@@ -1,4 +1,4 @@
-# SubstrateNodeSearchExtension
+# SubstrateNodeExtension
 
 This extensions is meant as a fallback option that uses only existing Substrate RPC methods. 
 However, it is important to note that this fallback implementation is significantly inefficient, and it is encouraged to utilize third-party search indices where possible for optimal search performance.
@@ -8,7 +8,7 @@ However, it is important to note that this fallback implementation is significan
 ```python
 substrate = SubstrateInterface(url="ws://127.0.0.1:9944")
 # Provide maximum block range (bigger range descreases performance) 
-substrate.register_extension(SubstrateNodeSearchExtension(max_block_range=100))
+substrate.register_extension(SubstrateNodeExtension(max_block_range=100))
 ```
 
 ## Implemented extension calls
@@ -34,3 +34,10 @@ block_datetime = datetime(2020, 7, 12, 0, 0, 0)
 
 block_number = substrate.extensions.search_block_number(block_datetime=block_datetime)
 ```
+
+### get_block_timestamp
+
+```python
+# Get timestamp for specific block number
+block_timestamp = substrate.extensions.get_block_timestamp(block_number)
+```

docs/usage/extensions.md

@@ -1,3 +1,3 @@
 # Extensions
 
-[Moved to extensions section](/extensions/)
+Moved to main section "Extensions" 

examples/extensions.py

@@ -1,14 +1,14 @@
 from datetime import datetime, timedelta
 
 from substrateinterface import SubstrateInterface
-from substrateinterface.extensions import SubstrateNodeSearchExtension
+from substrateinterface.extensions import SubstrateNodeExtension
 
 import logging
 logging.basicConfig(level=logging.DEBUG)
 
 substrate = SubstrateInterface(url="wss://rpc.polkadot.io")
 
-substrate.register_extension(SubstrateNodeSearchExtension(max_block_range=100))
+substrate.register_extension(SubstrateNodeExtension(max_block_range=100))
 
 # Search for block number corresponding a specific datetime
 block_datetime = datetime(2022, 1, 1, 0, 0, 0)

substrateinterface/extensions.py

@@ -18,7 +18,7 @@
 import math
 from datetime import datetime, timedelta
 
-__all__ = ['Extension', 'SearchExtension', 'SubstrateNodeSearchExtension']
+__all__ = ['Extension', 'SearchExtension', 'SubstrateNodeExtension']
 
 if TYPE_CHECKING:
     from .base import SubstrateInterface
@@ -135,7 +135,7 @@ def get_block_timestamp(self, block_number: int) -> int:
         raise NotImplementedError()
 
 
-class SubstrateNodeSearchExtension(SearchExtension):
+class SubstrateNodeExtension(SearchExtension):
     """
     Implementation of `SearchExtension` using only Substrate RPC methods. Could be significant inefficient.
     """
@@ -268,3 +268,8 @@ def search_block_number(self, block_datetime: datetime, block_time: int = 6, **k
         self.debug_message(f"Accepted prediction #{predicted_block_number}")
 
         return predicted_block_number
+
+
+# Backwards compatibility
+class SubstrateNodeSearchExtension(SubstrateNodeExtension):
+    pass

test/test_extension_interface.py

@@ -20,7 +20,7 @@
 
 from substrateinterface import SubstrateInterface
 from substrateinterface.exceptions import ExtensionCallNotFound
-from substrateinterface.extensions import SubstrateNodeSearchExtension
+from substrateinterface.extensions import SubstrateNodeExtension
 from test import settings
 
 
@@ -31,7 +31,7 @@ def setUpClass(cls):
         cls.substrate = SubstrateInterface(
             url=settings.POLKADOT_NODE_URL
         )
-        cls.substrate.register_extension(SubstrateNodeSearchExtension(max_block_range=100))
+        cls.substrate.register_extension(SubstrateNodeExtension(max_block_range=100))
 
     def test_search_block_number(self):
         block_datetime = datetime(2020, 7, 12, 0, 0, 0, tzinfo=timezone.utc)
@@ -41,6 +41,10 @@ def test_search_block_number(self):
         self.assertGreaterEqual(block_number, 665270)
         self.assertLessEqual(block_number, 665280)
 
+    def test_search_block_timestamp(self):
+        block_timestamp = self.substrate.extensions.get_block_timestamp(1000)
+        self.assertEqual(1590513426, block_timestamp)
+
     def test_unsupported_extension_call(self):
         with self.assertRaises(ExtensionCallNotFound):
             self.substrate.extensions.unknown()