pytonapi 0.3.4__tar.gz → 0.3.6__tar.gz

{pytonapi-0.3.4 → pytonapi-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytonapi
-Version: 0.3.4
+Version: 0.3.6
 Summary: Provide access to indexed TON blockchain.
 Home-page: https://github.com/tonkeeper/pytonapi/
 Author: nessshon

{pytonapi-0.3.4 → pytonapi-0.3.6}/pytonapi/async_tonapi/methods/sse.py

@@ -1,8 +1,8 @@
 import json
-from typing import List, Callable, Any, Awaitable, Tuple, Optional
+from typing import List, Callable, Any, Awaitable, Tuple, Optional, Union
 
 from pytonapi.async_tonapi.client import AsyncTonapiClient
-from pytonapi.schema.events import TransactionEventData, TraceEventData, MempoolEventData
+from pytonapi.schema.events import TransactionEventData, TraceEventData, MempoolEventData, BlockEventData
 
 
 class SSEMethod(AsyncTonapiClient):
@@ -81,3 +81,23 @@ class SSEMethod(AsyncTonapiClient):
             result = await handler(event, *args)
             if result is not None:
                 return result
+
+    async def subscribe_to_blocks(
+            self,
+            workchain: Optional[Union[int, None]],
+            handler: Callable[[BlockEventData, Any], Awaitable[Any]],
+            args: Tuple = (),
+    ) -> Any:
+        """
+        Subscribes to blocks SSE events for the specified workchains.
+
+        :handler: A callable function to handle the SSEEvent
+        :workchain: The ID of the workchain to subscribe to. If None, subscribes to all workchains.
+        """
+        method = "v2/sse/blocks"
+        params = {} if workchain is None else {'workchain': workchain}
+        async for data in self._subscribe(method=method, params=params):
+            event = BlockEventData(**json.loads(data))
+            result = await handler(event, *args)
+            if result is not None:
+                return result

{pytonapi-0.3.4 → pytonapi-0.3.6}/pytonapi/schema/events.py

@@ -261,6 +261,14 @@ class TransactionEventData(BaseModel):
     tx_hash: str
 
 
+class BlockEventData(BaseModel):
+    workchain: int
+    shard: str
+    seqno: int
+    root_hash: str
+    file_hash: str
+
+
 class Risk(BaseModel):
     description: Optional[str] = None
     transfer_all_remaining_balance: bool

pytonapi-0.3.6/pytonapi/tonapi/methods/sse.py

@@ -0,0 +1,103 @@
+import json
+from typing import List, Callable, Any, Tuple, Optional, Union
+
+from pytonapi.schema.events import TransactionEventData, TraceEventData, MempoolEventData, BlockEventData
+from pytonapi.tonapi import TonapiClient
+
+
+class SSEMethod(TonapiClient):
+
+    def subscribe_to_transactions(
+            self,
+            accounts: List[str],
+            handler: Callable[[TransactionEventData, Any], Any],
+            operations: Optional[List[str]] = None,
+            args: Tuple = (),
+    ) -> None:
+        """
+        Subscribes to transactions SSE events for the specified accounts.
+
+        :param handler: A callable function to handle the SSEEvent
+        :param accounts: A comma-separated list of account IDs.
+         A special value of "accounts" is ALL. TonAPI will stream transactions for all accounts in this case.
+        :param operations: A comma-separated list of operations, which makes it possible
+         to get transactions based on the `first 4 bytes of a message body of an inbound message(opens in a new tab)
+         <https://docs.ton.org/develop/smart-contracts/guidelines/internal-messages#internal-message-body>`_.
+         Each operation is a string containing either one of the supported names or a hex string
+         representing a message operation opcode which is an unsigned 32-bit integer.
+         A hex string must start with "0x" prefix and have exactly 8 hex digits.
+         An example of "operations" is &operations=JettonTransfer,0x0524c7ae,StonfiSwap.
+         The advantage of using hex strings is that it's possible to get transactions for operations
+         that are not yet present on `the list <https://github.com/tonkeeper/tongo/blob/master/abi/messages.md>`_.
+        :param args: Additional arguments to pass to the handler
+        """
+        method = "v2/sse/accounts/transactions"
+        params = {'accounts': ",".join(accounts)}
+        if operations:
+            params['operations'] = ",".join(operations)
+
+        for data in self._subscribe(method=method, params=params):
+            event = TransactionEventData(**json.loads(data))
+            result = handler(event, *args)
+            if result is not None:
+                return result
+
+    def subscribe_to_traces(
+            self,
+            accounts: List[str],
+            handler: Callable[[TraceEventData, Any], Any],
+            args: Tuple = (),
+    ) -> None:
+        """
+        Subscribes to traces SSE events for the specified accounts.
+
+        :handler: A callable function to handle the SSEEvent
+        :accounts: A list of account addresses to subscribe to
+        """
+        method = "v2/sse/accounts/traces"
+        params = {'accounts': accounts}
+        for data in self._subscribe(method=method, params=params):
+            event = TraceEventData(**json.loads(data))
+            result = handler(event, *args)
+            if result is not None:
+                return result
+
+    def subscribe_to_mempool(
+            self,
+            accounts: List[str],
+            handler: Callable[[MempoolEventData, Any], Any],
+            args: Tuple = (),
+    ) -> None:
+        """
+        Subscribes to mempool SSE events for the specified accounts.
+
+        :handler: A callable function to handle the SSEEvent
+        :accounts: A list of account addresses to subscribe to
+        """
+        method = "v2/sse/mempool"
+        params = {'accounts': ",".join(accounts)}
+        for data in self._subscribe(method=method, params=params):
+            event = MempoolEventData(**json.loads(data))
+            result = handler(event, *args)
+            if result is not None:
+                return result
+
+    def subscribe_to_blocks(
+            self,
+            workchain: Optional[Union[int, None]],
+            handler: Callable[[BlockEventData, Any], Any],
+            args: Tuple = (),
+    ) -> Any:
+        """
+        Subscribes to blocks SSE events for the specified workchains.
+
+        :handler: A callable function to handle the SSEEvent
+        :workchain: The ID of the workchain to subscribe to. If None, subscribes to all workchains.
+        """
+        method = "v2/sse/blocks"
+        params = {} if workchain is None else {'workchain': workchain}
+        for data in self._subscribe(method=method, params=params):
+            event = BlockEventData(**json.loads(data))
+            result = handler(event, *args)
+            if result is not None:
+                return result

{pytonapi-0.3.4 → pytonapi-0.3.6}/pytonapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytonapi
-Version: 0.3.4
+Version: 0.3.6
 Summary: Provide access to indexed TON blockchain.
 Home-page: https://github.com/tonkeeper/pytonapi/
 Author: nessshon

{pytonapi-0.3.4 → pytonapi-0.3.6}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setuptools.setup(
     name="pytonapi",
-    version="0.3.4",
+    version="0.3.6",
     author="nessshon",
     description="Provide access to indexed TON blockchain.",
     long_description=long_description,

pytonapi-0.3.4/pytonapi/tonapi/methods/sse.py

@@ -1,72 +0,0 @@
-import json
-from typing import List, Callable, Any, Tuple
-
-from pytonapi.schema.events import TransactionEventData, TraceEventData, MempoolEventData
-from pytonapi.tonapi import TonapiClient
-
-
-class SSEMethod(TonapiClient):
-
-    def subscribe_to_transactions(
-            self,
-            accounts: List[str],
-            handler: Callable[[TransactionEventData, List[Any]], Any],
-            args: Tuple[Any, ...] = (),
-    ) -> None:
-        """
-        Subscribes to transactions SSE events for the specified accounts.
-
-        :param handler: A callable function to handle the SSEEvent
-        :param accounts: A list of account addresses to subscribe to
-        :param args: Additional arguments to pass to the handler
-        """
-        method = "v2/sse/accounts/transactions"
-        params = {'accounts': accounts}
-        for data in self._subscribe(method=method, params=params):
-            event = TransactionEventData(**json.loads(data))
-            result = handler(event, *args)
-            if result is not None:
-                return result
-
-    def subscribe_to_traces(
-            self,
-            accounts: List[str],
-            handler: Callable[[TraceEventData, List[Any]], Any],
-            args: Tuple[Any, ...] = (),
-    ) -> None:
-        """
-        Subscribes to traces SSE events for the specified accounts.
-
-        :handler: A callable function to handle the SSEEvent
-        :accounts: A list of account addresses to subscribe to
-
-        Returns:
-            None
-        """
-        method = "v2/sse/accounts/traces"
-        params = {'accounts': accounts}
-        for data in self._subscribe(method=method, params=params):
-            event = TraceEventData(**json.loads(data))
-            result = handler(event, *args)
-            if result is not None:
-                return result
-
-    def subscribe_to_mempool(
-            self,
-            accounts: List[str],
-            handler: Callable[[MempoolEventData, List[Any]], Any],
-            args: Tuple[Any, ...] = (),
-    ) -> None:
-        """
-        Subscribes to mempool SSE events for the specified accounts.
-
-        :handler: A callable function to handle the SSEEvent
-        :accounts: A list of account addresses to subscribe to
-        """
-        method = "v2/sse/mempool"
-        params = {'accounts': accounts}
-        for data in self._subscribe(method=method, params=params):
-            event = MempoolEventData(**json.loads(data))
-            result = handler(event, *args)
-            if result is not None:
-                return result