defistream 1.1.0__py3-none-any.whl → 1.1.1__py3-none-any.whl

defistream/client.py

@@ -289,6 +289,8 @@ class DeFiStream(BaseClient):
         if response.status_code >= 400:
             self._handle_error_response(response)
         data = response.json()
+        if isinstance(data, list):
+            return data
         return data.get("decoders", [])
 
 
@@ -377,4 +379,6 @@ class AsyncDeFiStream(BaseClient):
         if response.status_code >= 400:
             self._handle_error_response(response)
         data = response.json()
+        if isinstance(data, list):
+            return data
         return data.get("decoders", [])

{defistream-1.1.0.dist-info → defistream-1.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: defistream
-Version: 1.1.0
+Version: 1.1.1
 Summary: Python client for the DeFiStream API
 Project-URL: Homepage, https://defistream.dev
 Project-URL: Documentation, https://docs.defistream.dev
@@ -336,6 +336,21 @@ for transfer in transfers:
 
 > **Note:** `as_dict()` and `as_file("*.json")` use JSON format which has a **10,000 block limit**. For larger block ranges, use `as_df()` or `as_file()` with `.parquet` or `.csv` extensions, which support up to 1,000,000 blocks.
 
+### Context Manager
+
+Both sync and async clients support context managers to automatically close connections:
+
+```python
+# Sync
+with DeFiStream() as client:
+    df = (
+        client.erc20.transfers("USDT")
+        .network("ETH")
+        .block_range(21000000, 21010000)
+        .as_df()
+    )
+```
+
 ### Async Usage
 
 ```python
@@ -355,6 +370,14 @@ async def main():
 asyncio.run(main())
 ```
 
+### List Available Decoders
+
+```python
+client = DeFiStream()
+decoders = client.decoders()
+print(decoders)  # ['native_token', 'erc20', 'aave', 'uniswap', 'lido', 'stader', 'threshold']
+```
+
 ## Configuration
 
 ### Environment Variables
@@ -455,8 +478,11 @@ print(f"Request cost: {client.last_response.request_cost}")
 | Method | Protocols | Description |
 |--------|-----------|-------------|
 | `.token(symbol)` | ERC20 | Token symbol (USDT, USDC) or contract address (required) |
-| `.sender(addr)` | ERC20, Native | Filter by sender address |
-| `.receiver(addr)` | ERC20, Native | Filter by receiver address |
+| `.sender(*addrs)` | ERC20, Native | Filter by sender address (multi-value) |
+| `.receiver(*addrs)` | ERC20, Native | Filter by receiver address (multi-value) |
+| `.involving(*addrs)` | All | Filter by any involved address (multi-value) |
+| `.from_address(*addrs)` | ERC20, Native | Alias for `.sender()` |
+| `.to_address(*addrs)` | ERC20, Native | Alias for `.receiver()` |
 | `.min_amount(amt)` | ERC20, Native | Minimum transfer amount |
 | `.max_amount(amt)` | ERC20, Native | Maximum transfer amount |
 | `.eth_market_type(type)` | AAVE | Market type for ETH: 'Core', 'Prime', 'EtherFi' |
@@ -477,7 +503,7 @@ Filter events by entity names or categories using the labels database. Available
 | `.receiver_label(label)` | ERC20, Native | Filter receiver by label substring |
 | `.receiver_category(cat)` | ERC20, Native | Filter receiver by category |
 
-**Multi-value support:** Comma-separated values are accepted (e.g., `"Binance,Coinbase"`).
+**Multi-value support:** Pass multiple values as separate arguments (e.g., `.sender_label("Binance", "Coinbase")`) or as a comma-separated string (e.g., `.sender_label("Binance,Coinbase")`). Both forms are equivalent.
 
 **Mutual exclusivity:** Within each slot (involving/sender/receiver), only one of address/label/category can be set. `involving*` filters cannot be combined with `sender*`/`receiver*` filters.
 

{defistream-1.1.0.dist-info → defistream-1.1.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
 defistream/__init__.py,sha256=h-ca8lWZyPYPDd-rFTvO9J2ptW_p-SvspvgmgAe_wIc,1089
-defistream/client.py,sha256=Ku8ouDbM6Mx4lVmqvBwNvNt-h2FkvqauPMSjKyPkjU4,12717
+defistream/client.py,sha256=14Md_GOmzijBxhPPKuTRQbm7d7iXyL6OvWR7AQitY88,12835
 defistream/exceptions.py,sha256=_GxZQ18_YvXFtmNHeddWV8fHPIllHgFeP7fP0CmHF1k,1492
 defistream/models.py,sha256=Zw3DHAISxB6pivKybNzyHXR5IcRwvTZl23DHbjfyKwM,622
 defistream/protocols.py,sha256=5_bYd46lDy-mK6LZ8sTGW0Z2IVH4g0cQ5rBbbOXsw0U,15368
 defistream/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 defistream/query.py,sha256=yzrVfeRDZqoTYdQtj7SoYa7yd-NfO8heQ85YxhefU7c,22904
-defistream-1.1.0.dist-info/METADATA,sha256=hO1hUJMZZKkKOyd6B2V-r4sYRkaCmCR32VYfKJ_l3E4,12794
-defistream-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-defistream-1.1.0.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
-defistream-1.1.0.dist-info/RECORD,,
+defistream-1.1.1.dist-info/METADATA,sha256=XznMYpoLXcIf6rn_NqOWpR8lUnFZGwfbLv17zRa1GkE,13657
+defistream-1.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+defistream-1.1.1.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
+defistream-1.1.1.dist-info/RECORD,,