tinybot-eth 0.1.0__tar.gz → 0.2.0__tar.gz

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinybot-eth
-Version: 0.1.0
+Version: 0.2.0
 Summary: Minimal Python framework for building crypto bots
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -29,7 +29,14 @@ pip install tinybot-eth
 | `PRIVATE_KEY` | No | Private key for onchain execution |
 
 ## Quick Start
+```python
+bot = TinyBot(rpc_url, name="my bot")
+
+bot.listen(event="AuctionKicked", handler=on_kick, ...)
+bot.every(180, check_expired)
 
+await bot.run()
+```
 ```python
 import asyncio
 import os
@@ -60,16 +67,14 @@ async def main():
     )
 
     bot.listen(
-        name="transfers",
         event="Transfer",
         addresses=["0x..."],
         abi=ERC20_ABI,
         handler=on_transfer,
         poll_interval=180,
-        notify_errors=True,
     )
 
-    bot.every(3600, check_and_tend, notify_errors=True)
+    bot.every(3600, check_and_tend)
 
     await bot.run()
 
@@ -97,14 +102,14 @@ Register an event listener.
 
 ```python
 bot.listen(
-    name="kicks",            # unique name
     event="AuctionKicked",   # event name (must exist in ABI)
     addresses=["0x..."],     # contracts to monitor
     abi=[...],               # ABI containing the event
     handler=on_kick,         # async fn(bot, log)
+    name="kicks",            # defaults to handler.__name__ (optional)
     poll_interval=180,       # seconds between polls (default: 180)
     block_buffer=5,          # re-scan buffer in blocks (default: 5)
-    notify_errors=True,      # send errors to Telegram (default: False)
+    notify_errors=True,      # send errors to Telegram (default: True)
 )
 ```
 
@@ -115,12 +120,12 @@ The event signature is derived from the ABI at registration time. Raises `ValueE
 
 ---
 
-### `bot.every(interval, handler, name="", notify_errors=False) -> PeriodicTask`
+### `bot.every(interval, handler, name="", notify_errors=True) -> PeriodicTask`
 
 Register a periodic task.
 
 ```python
-bot.every(3600, check_expired, notify_errors=True)
+bot.every(3600, check_expired)
 ```
 
 Handler signature: `async fn(bot)`
@@ -231,4 +236,4 @@ Access `bot.w3`, `bot.state`, `bot.executor`, and `bot.get_listener()` from any
 
 ## Error Handling
 
-When `notify_errors=True`, exceptions are caught and sent to `DEV_GROUP_CHAT_ID` as `[name] error message`. The bot continues running.
+Enabled by default. Exceptions are caught and sent to `DEV_GROUP_CHAT_ID` as `[name] error message`. The bot continues running. Set `notify_errors=False` to disable.

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/README.md

@@ -18,7 +18,14 @@ pip install tinybot-eth
 | `PRIVATE_KEY` | No | Private key for onchain execution |
 
 ## Quick Start
+```python
+bot = TinyBot(rpc_url, name="my bot")
+
+bot.listen(event="AuctionKicked", handler=on_kick, ...)
+bot.every(180, check_expired)
 
+await bot.run()
+```
 ```python
 import asyncio
 import os
@@ -49,16 +56,14 @@ async def main():
     )
 
     bot.listen(
-        name="transfers",
         event="Transfer",
         addresses=["0x..."],
         abi=ERC20_ABI,
         handler=on_transfer,
         poll_interval=180,
-        notify_errors=True,
     )
 
-    bot.every(3600, check_and_tend, notify_errors=True)
+    bot.every(3600, check_and_tend)
 
     await bot.run()
 
@@ -86,14 +91,14 @@ Register an event listener.
 
 ```python
 bot.listen(
-    name="kicks",            # unique name
     event="AuctionKicked",   # event name (must exist in ABI)
     addresses=["0x..."],     # contracts to monitor
     abi=[...],               # ABI containing the event
     handler=on_kick,         # async fn(bot, log)
+    name="kicks",            # defaults to handler.__name__ (optional)
     poll_interval=180,       # seconds between polls (default: 180)
     block_buffer=5,          # re-scan buffer in blocks (default: 5)
-    notify_errors=True,      # send errors to Telegram (default: False)
+    notify_errors=True,      # send errors to Telegram (default: True)
 )
 ```
 
@@ -104,12 +109,12 @@ The event signature is derived from the ABI at registration time. Raises `ValueE
 
 ---
 
-### `bot.every(interval, handler, name="", notify_errors=False) -> PeriodicTask`
+### `bot.every(interval, handler, name="", notify_errors=True) -> PeriodicTask`
 
 Register a periodic task.
 
 ```python
-bot.every(3600, check_expired, notify_errors=True)
+bot.every(3600, check_expired)
 ```
 
 Handler signature: `async fn(bot)`
@@ -220,4 +225,4 @@ Access `bot.w3`, `bot.state`, `bot.executor`, and `bot.get_listener()` from any
 
 ## Error Handling
 
-When `notify_errors=True`, exceptions are caught and sent to `DEV_GROUP_CHAT_ID` as `[name] error message`. The bot continues running.
+Enabled by default. Exceptions are caught and sent to `DEV_GROUP_CHAT_ID` as `[name] error message`. The bot continues running. Set `notify_errors=False` to disable.

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tinybot-eth"
-version = "0.1.0"
+version = "0.2.0"
 description = "Minimal Python framework for building crypto bots"
 readme = "README.md"
 requires-python = ">=3.12"

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/tinybot/bot.py

@@ -27,18 +27,19 @@ class TinyBot:
 
     def listen(
         self,
-        name: str,
         event: str,
         addresses: list[str],
         abi: list[dict[str, Any]],
         handler: EventHandler,
+        name: str = "",
         poll_interval: int = 180,
         block_buffer: int = 5,
-        notify_errors: bool = False,
+        notify_errors: bool = True,
     ) -> EventListener:
+        name = name or handler.__name__
         if not addresses:
             raise ValueError(f"listener '{name}': addresses cannot be empty")
-        if any(l.name == name for l in self._listeners):
+        if any(listener.name == name for listener in self._listeners):
             raise ValueError(f"listener '{name}' already registered")
 
         signature = event_signature(abi, event)
@@ -62,10 +63,13 @@ class TinyBot:
         interval: int,
         handler: TaskHandler,
         name: str = "",
-        notify_errors: bool = False,
+        notify_errors: bool = True,
     ) -> PeriodicTask:
+        name = name or handler.__name__
+        if any(task.name == name for task in self._tasks):
+            raise ValueError(f"task '{name}' already registered")
         task = PeriodicTask(
-            name=name or handler.__name__,
+            name=name,
             interval=interval,
             handler=handler,
             notify_errors=notify_errors,
@@ -78,9 +82,9 @@ class TinyBot:
     # -------------------------------------------------------------------------
 
     def get_listener(self, name: str) -> EventListener:
-        for l in self._listeners:
-            if l.name == name:
-                return l
+        for listener in self._listeners:
+            if listener.name == name:
+                return listener
         raise ValueError(f"listener '{name}' not found")
 
     # -------------------------------------------------------------------------
@@ -107,12 +111,14 @@ class TinyBot:
         decoder = self.w3.eth.contract(address=listener.addresses[0], abi=listener.abi)
         event_name = listener.signature.split("(")[0]
 
-        raw_logs = self.w3.eth.get_logs({
-            "fromBlock": from_block,
-            "toBlock": to_block,
-            "address": listener.addresses,
-            "topics": [topic],
-        })
+        raw_logs = self.w3.eth.get_logs(
+            {
+                "fromBlock": from_block,
+                "toBlock": to_block,
+                "address": listener.addresses,
+                "topics": [topic],
+            }
+        )
 
         for raw_log in raw_logs:
             event = getattr(decoder.events, event_name)()

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/tinybot/executor.py

@@ -1,6 +1,6 @@
-from web3 import Web3
 from eth_account import Account
 from eth_account.signers.local import LocalAccount
+from web3 import Web3
 
 
 class Executor:
@@ -24,14 +24,16 @@ class Executor:
         max_priority_fee_gwei: int = 3,
         value: int = 0,
     ) -> str:
-        tx = call.build_transaction({
-            "from": self._account.address,
-            "nonce": self._w3.eth.get_transaction_count(self._account.address),
-            "gas": gas_limit,
-            "maxFeePerGas": self._w3.to_wei(max_fee_gwei, "gwei"),
-            "maxPriorityFeePerGas": self._w3.to_wei(max_priority_fee_gwei, "gwei"),
-            "value": value,
-        })
+        tx = call.build_transaction(
+            {
+                "from": self._account.address,
+                "nonce": self._w3.eth.get_transaction_count(self._account.address),
+                "gas": gas_limit,
+                "maxFeePerGas": self._w3.to_wei(max_fee_gwei, "gwei"),
+                "maxPriorityFeePerGas": self._w3.to_wei(max_priority_fee_gwei, "gwei"),
+                "value": value,
+            }
+        )
         signed = self._w3.eth.account.sign_transaction(tx, self._account.key)
         tx_hash = self._w3.eth.send_raw_transaction(signed.raw_transaction)
         return tx_hash.hex()

tinybot_eth-0.2.0/tinybot/multicall.py

@@ -0,0 +1,46 @@
+from eth_abi import decode as decode_abi
+from web3 import Web3
+
+# Multicall3 — same address on all chains
+MULTICALL3 = Web3.to_checksum_address("0xcA11bde05977b3631167028862bE2a173976CA11")
+MULTICALL3_ABI = [
+    {
+        "name": "aggregate3",
+        "type": "function",
+        "stateMutability": "payable",
+        "inputs": [
+            {
+                "name": "calls",
+                "type": "tuple[]",
+                "components": [
+                    {"name": "target", "type": "address"},
+                    {"name": "allowFailure", "type": "bool"},
+                    {"name": "callData", "type": "bytes"},
+                ],
+            }
+        ],
+        "outputs": [
+            {
+                "name": "returnData",
+                "type": "tuple[]",
+                "components": [
+                    {"name": "success", "type": "bool"},
+                    {"name": "returnData", "type": "bytes"},
+                ],
+            }
+        ],
+    }
+]
+
+
+def multicall(w3: Web3, calls: list) -> list:
+    """Batch contract calls. calls = list of ContractFunction objects."""
+    mc = w3.eth.contract(address=MULTICALL3, abi=MULTICALL3_ABI)
+    encoded = [(call.address, False, call._encode_transaction_data()) for call in calls]
+    results = mc.functions.aggregate3(encoded).call()
+    decoded = []
+    for call, (_, data) in zip(calls, results):
+        types = [o["type"] for o in call.abi["outputs"]]
+        result = decode_abi(types, data)
+        decoded.append(result[0] if len(result) == 1 else result)
+    return decoded

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/tinybot/types.py

@@ -22,7 +22,7 @@ class EventListener:
     handler: EventHandler
     poll_interval: int = 180
     block_buffer: int = 5
-    notify_errors: bool = False
+    notify_errors: bool = True
     _last_run: float = 0
     _w3: Web3 | None = None
 
@@ -42,5 +42,5 @@ class PeriodicTask:
     name: str
     interval: int
     handler: TaskHandler
-    notify_errors: bool = False
+    notify_errors: bool = True
     _last_run: float = 0

{tinybot_eth-0.1.0 → tinybot_eth-0.2.0}/tinybot_eth.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinybot-eth
-Version: 0.1.0
+Version: 0.2.0
 Summary: Minimal Python framework for building crypto bots
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -29,7 +29,14 @@ pip install tinybot-eth
 | `PRIVATE_KEY` | No | Private key for onchain execution |
 
 ## Quick Start
+```python
+bot = TinyBot(rpc_url, name="my bot")
+
+bot.listen(event="AuctionKicked", handler=on_kick, ...)
+bot.every(180, check_expired)
 
+await bot.run()
+```
 ```python
 import asyncio
 import os
@@ -60,16 +67,14 @@ async def main():
     )
 
     bot.listen(
-        name="transfers",
         event="Transfer",
         addresses=["0x..."],
         abi=ERC20_ABI,
         handler=on_transfer,
         poll_interval=180,
-        notify_errors=True,
     )
 
-    bot.every(3600, check_and_tend, notify_errors=True)
+    bot.every(3600, check_and_tend)
 
     await bot.run()
 
@@ -97,14 +102,14 @@ Register an event listener.
 
 ```python
 bot.listen(
-    name="kicks",            # unique name
     event="AuctionKicked",   # event name (must exist in ABI)
     addresses=["0x..."],     # contracts to monitor
     abi=[...],               # ABI containing the event
     handler=on_kick,         # async fn(bot, log)
+    name="kicks",            # defaults to handler.__name__ (optional)
     poll_interval=180,       # seconds between polls (default: 180)
     block_buffer=5,          # re-scan buffer in blocks (default: 5)
-    notify_errors=True,      # send errors to Telegram (default: False)
+    notify_errors=True,      # send errors to Telegram (default: True)
 )
 ```
 
@@ -115,12 +120,12 @@ The event signature is derived from the ABI at registration time. Raises `ValueE
 
 ---
 
-### `bot.every(interval, handler, name="", notify_errors=False) -> PeriodicTask`
+### `bot.every(interval, handler, name="", notify_errors=True) -> PeriodicTask`
 
 Register a periodic task.
 
 ```python
-bot.every(3600, check_expired, notify_errors=True)
+bot.every(3600, check_expired)
 ```
 
 Handler signature: `async fn(bot)`
@@ -231,4 +236,4 @@ Access `bot.w3`, `bot.state`, `bot.executor`, and `bot.get_listener()` from any
 
 ## Error Handling
 
-When `notify_errors=True`, exceptions are caught and sent to `DEV_GROUP_CHAT_ID` as `[name] error message`. The bot continues running.
+Enabled by default. Exceptions are caught and sent to `DEV_GROUP_CHAT_ID` as `[name] error message`. The bot continues running. Set `notify_errors=False` to disable.

tinybot_eth-0.1.0/tinybot/multicall.py

@@ -1,32 +0,0 @@
-from eth_abi import decode as decode_abi
-from web3 import Web3
-
-# Multicall3 — same address on all chains
-MULTICALL3 = Web3.to_checksum_address("0xcA11bde05977b3631167028862bE2a173976CA11")
-MULTICALL3_ABI = [{
-    "name": "aggregate3",
-    "type": "function",
-    "stateMutability": "payable",
-    "inputs": [{"name": "calls", "type": "tuple[]", "components": [
-        {"name": "target", "type": "address"},
-        {"name": "allowFailure", "type": "bool"},
-        {"name": "callData", "type": "bytes"},
-    ]}],
-    "outputs": [{"name": "returnData", "type": "tuple[]", "components": [
-        {"name": "success", "type": "bool"},
-        {"name": "returnData", "type": "bytes"},
-    ]}],
-}]
-
-
-def multicall(w3: Web3, calls: list) -> list:
-    """Batch contract calls. calls = list of ContractFunction objects."""
-    mc = w3.eth.contract(address=MULTICALL3, abi=MULTICALL3_ABI)
-    encoded = [(call.address, False, call._encode_transaction_data()) for call in calls]
-    results = mc.functions.aggregate3(encoded).call()
-    decoded = []
-    for call, (_, data) in zip(calls, results):
-        types = [o["type"] for o in call.abi["outputs"]]
-        result = decode_abi(types, data)
-        decoded.append(result[0] if len(result) == 1 else result)
-    return decoded