tonutils 2.0.1b5__py3-none-any.whl → 2.0.1b6__py3-none-any.whl

tonutils/tools/block_scanner/__init__.py

@@ -1,16 +1,9 @@
-from .events import (
-    BlockEvent,
-    TransactionEvent,
-    TransactionsEvent,
-)
+from .events import BlockEvent, ErrorEvent, TransactionsEvent
 from .scanner import BlockScanner
-from .where import Where
-
 
 __all__ = [
     "BlockScanner",
     "BlockEvent",
-    "TransactionEvent",
+    "ErrorEvent",
     "TransactionsEvent",
-    "Where",
 ]

tonutils/tools/block_scanner/events.py

@@ -8,24 +8,65 @@ from tonutils.clients import LiteBalancer, LiteClient
 
 
 @dataclass(frozen=True, slots=True)
-class EventBase:
+class _BaseEvent:
+    """Base event for BlockScanner.
+
+    Attributes:
+        client: Lite client/balancer.
+        mc_block: Masterchain block being processed.
+        context: Shared user context.
+    """
+
     client: t.Union[LiteBalancer, LiteClient]
     mc_block: BlockIdExt
-    context: t.Dict[str, t.Any]
+    context: t.Mapping[str, t.Any]
 
 
 @dataclass(frozen=True, slots=True)
-class BlockEvent(EventBase):
-    block: BlockIdExt
+class ErrorEvent(_BaseEvent):
+    """Error raised during scanning or handler execution.
+
+    Attributes:
+        client: Lite client/balancer.
+        mc_block: Masterchain block being processed.
+        context: Shared user context.
+        error: Raised exception.
+        event: Related event (if any).
+        handler: Handler/callable that raised (if any).
+        block: Related shard block (if any).
+    """
+
+    error: BaseException
+    event: t.Any = None
+    handler: t.Any = None
+    block: t.Optional[BlockIdExt] = None
 
 
 @dataclass(frozen=True, slots=True)
-class TransactionEvent(EventBase):
+class BlockEvent(_BaseEvent):
+    """Shard block event.
+
+    Attributes:
+        client: Lite client/balancer.
+        mc_block: Masterchain block being processed.
+        context: Shared user context.
+        block: Shard block identifier.
+    """
+
     block: BlockIdExt
-    transaction: Transaction
 
 
 @dataclass(frozen=True, slots=True)
-class TransactionsEvent(EventBase):
+class TransactionsEvent(_BaseEvent):
+    """Transactions event for a shard block.
+
+    Attributes:
+        client: Lite client/balancer.
+        mc_block: Masterchain block being processed.
+        context: Shared user context.
+        block: Shard block identifier.
+        transactions: Transactions from this block.
+    """
+
     block: BlockIdExt
     transactions: t.List[Transaction] = field(default_factory=list)