defistream 1.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

defistream/__init__.py

@@ -45,7 +45,7 @@ from .models import (
 )
 from .query import AsyncQueryBuilder, QueryBuilder
 
-__version__ = "1.0.1"
+__version__ = "1.0.2"
 
 __all__ = [
     # Clients

defistream/query.py

@@ -2,13 +2,11 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Generic, TypeVar
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from .client import BaseClient
 
-T = TypeVar("T")
-
 
 class QueryBuilder:
     """
@@ -20,7 +18,7 @@ class QueryBuilder:
     - as_file() - saves to CSV, Parquet, or JSON file
 
     Example:
-        query = client.erc20.transfers("USDT").network("ETH").start_block(24000000).end_block(24100000)
+        query = client.erc20.transfers("USDT").network("ETH").block_range(21000000, 21010000)
         query = query.min_amount(1000).sender("0x...")
         df = query.as_df()  # pandas DataFrame
         df = query.as_df("polars")  # polars DataFrame
@@ -51,7 +49,7 @@ class QueryBuilder:
 
     # Network and block range
     def network(self, network: str) -> "QueryBuilder":
-        """Set the network (ETH, ARB, BASE, OP, etc.)."""
+        """Set the network (ETH, ARB, BASE, OP, POLYGON, etc.)."""
         return self._copy_with(network=network)
 
     def start_block(self, block: int) -> "QueryBuilder":
@@ -79,13 +77,13 @@ class QueryBuilder:
         """Set both start and end times."""
         return self._copy_with(since=start, until=end)
 
-    # Common filters
+    # ERC20 and Native Token filters
     def sender(self, address: str) -> "QueryBuilder":
-        """Filter by sender address."""
+        """Filter by sender address (ERC20, Native Token)."""
         return self._copy_with(sender=address)
 
     def receiver(self, address: str) -> "QueryBuilder":
-        """Filter by receiver address."""
+        """Filter by receiver address (ERC20, Native Token)."""
         return self._copy_with(receiver=address)
 
     def from_address(self, address: str) -> "QueryBuilder":
@@ -97,52 +95,40 @@ class QueryBuilder:
         return self.receiver(address)
 
     def min_amount(self, amount: float) -> "QueryBuilder":
-        """Filter by minimum amount."""
+        """Filter by minimum amount (ERC20, Native Token)."""
         return self._copy_with(min_amount=amount)
 
+    def max_amount(self, amount: float) -> "QueryBuilder":
+        """Filter by maximum amount (ERC20, Native Token)."""
+        return self._copy_with(max_amount=amount)
+
     # ERC20 specific
     def token(self, symbol: str) -> "QueryBuilder":
-        """Set token symbol (for ERC20)."""
+        """Set token symbol or address (ERC20)."""
         return self._copy_with(token=symbol)
 
-    def owner(self, address: str) -> "QueryBuilder":
-        """Filter by owner address (for approvals)."""
-        return self._copy_with(owner=address)
-
-    def spender(self, address: str) -> "QueryBuilder":
-        """Filter by spender address (for approvals)."""
-        return self._copy_with(spender=address)
+    def decimals(self, decimals: int) -> "QueryBuilder":
+        """Set token decimals when using custom address (ERC20). Default: 18."""
+        return self._copy_with(decimals=decimals)
 
     # AAVE specific
-    def user(self, address: str) -> "QueryBuilder":
-        """Filter by user address (for AAVE)."""
-        return self._copy_with(user=address)
-
-    def reserve(self, address: str) -> "QueryBuilder":
-        """Filter by reserve address (for AAVE)."""
-        return self._copy_with(reserve=address)
-
-    def liquidator(self, address: str) -> "QueryBuilder":
-        """Filter by liquidator address (for AAVE liquidations)."""
-        return self._copy_with(liquidator=address)
+    def eth_market_type(self, market_type: str) -> "QueryBuilder":
+        """Set AAVE market type for ETH network: 'Core', 'Prime', or 'EtherFi'. Default: 'Core'."""
+        return self._copy_with(eth_market_type=market_type)
 
     # Uniswap specific
     def symbol0(self, symbol: str) -> "QueryBuilder":
-        """Set first token symbol (for Uniswap)."""
+        """Set first token symbol (Uniswap)."""
         return self._copy_with(symbol0=symbol)
 
     def symbol1(self, symbol: str) -> "QueryBuilder":
-        """Set second token symbol (for Uniswap)."""
+        """Set second token symbol (Uniswap)."""
         return self._copy_with(symbol1=symbol)
 
     def fee(self, fee_tier: int) -> "QueryBuilder":
-        """Set fee tier (for Uniswap): 100, 500, 3000, 10000."""
+        """Set fee tier (Uniswap): 100, 500, 3000, 10000."""
         return self._copy_with(fee=fee_tier)
 
-    def pool(self, address: str) -> "QueryBuilder":
-        """Set pool address (for Uniswap)."""
-        return self._copy_with(pool=address)
-
     # Verbose mode
     def verbose(self, enabled: bool = True) -> "QueryBuilder":
         """Include all metadata fields (tx_hash, tx_id, log_index, network, name)."""
@@ -161,7 +147,7 @@ class QueryBuilder:
         """
         Execute query and return results as list of dictionaries.
 
-        Uses JSON format from API.
+        Uses JSON format from API. Limited to 10,000 blocks.
 
         Returns:
             List of event dictionaries
@@ -253,7 +239,7 @@ class AsyncQueryBuilder:
     - as_file() - saves to CSV, Parquet, or JSON file
 
     Example:
-        query = client.erc20.transfers("USDT").network("ETH").start_block(24000000).end_block(24100000)
+        query = client.erc20.transfers("USDT").network("ETH").block_range(21000000, 21010000)
         df = await query.as_df()  # pandas DataFrame
         df = await query.as_df("polars")  # polars DataFrame
         await query.as_file("transfers.csv")  # save to CSV
@@ -283,7 +269,7 @@ class AsyncQueryBuilder:
 
     # Network and block range
     def network(self, network: str) -> "AsyncQueryBuilder":
-        """Set the network (ETH, ARB, BASE, OP, etc.)."""
+        """Set the network (ETH, ARB, BASE, OP, POLYGON, etc.)."""
         return self._copy_with(network=network)
 
     def start_block(self, block: int) -> "AsyncQueryBuilder":
@@ -311,13 +297,13 @@ class AsyncQueryBuilder:
         """Set both start and end times."""
         return self._copy_with(since=start, until=end)
 
-    # Common filters
+    # ERC20 and Native Token filters
     def sender(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by sender address."""
+        """Filter by sender address (ERC20, Native Token)."""
         return self._copy_with(sender=address)
 
     def receiver(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by receiver address."""
+        """Filter by receiver address (ERC20, Native Token)."""
         return self._copy_with(receiver=address)
 
     def from_address(self, address: str) -> "AsyncQueryBuilder":
@@ -329,52 +315,40 @@ class AsyncQueryBuilder:
         return self.receiver(address)
 
     def min_amount(self, amount: float) -> "AsyncQueryBuilder":
-        """Filter by minimum amount."""
+        """Filter by minimum amount (ERC20, Native Token)."""
         return self._copy_with(min_amount=amount)
 
+    def max_amount(self, amount: float) -> "AsyncQueryBuilder":
+        """Filter by maximum amount (ERC20, Native Token)."""
+        return self._copy_with(max_amount=amount)
+
     # ERC20 specific
     def token(self, symbol: str) -> "AsyncQueryBuilder":
-        """Set token symbol (for ERC20)."""
+        """Set token symbol or address (ERC20)."""
         return self._copy_with(token=symbol)
 
-    def owner(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by owner address (for approvals)."""
-        return self._copy_with(owner=address)
-
-    def spender(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by spender address (for approvals)."""
-        return self._copy_with(spender=address)
+    def decimals(self, decimals: int) -> "AsyncQueryBuilder":
+        """Set token decimals when using custom address (ERC20). Default: 18."""
+        return self._copy_with(decimals=decimals)
 
     # AAVE specific
-    def user(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by user address (for AAVE)."""
-        return self._copy_with(user=address)
-
-    def reserve(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by reserve address (for AAVE)."""
-        return self._copy_with(reserve=address)
-
-    def liquidator(self, address: str) -> "AsyncQueryBuilder":
-        """Filter by liquidator address (for AAVE liquidations)."""
-        return self._copy_with(liquidator=address)
+    def eth_market_type(self, market_type: str) -> "AsyncQueryBuilder":
+        """Set AAVE market type for ETH network: 'Core', 'Prime', or 'EtherFi'. Default: 'Core'."""
+        return self._copy_with(eth_market_type=market_type)
 
     # Uniswap specific
     def symbol0(self, symbol: str) -> "AsyncQueryBuilder":
-        """Set first token symbol (for Uniswap)."""
+        """Set first token symbol (Uniswap)."""
         return self._copy_with(symbol0=symbol)
 
     def symbol1(self, symbol: str) -> "AsyncQueryBuilder":
-        """Set second token symbol (for Uniswap)."""
+        """Set second token symbol (Uniswap)."""
         return self._copy_with(symbol1=symbol)
 
     def fee(self, fee_tier: int) -> "AsyncQueryBuilder":
-        """Set fee tier (for Uniswap): 100, 500, 3000, 10000."""
+        """Set fee tier (Uniswap): 100, 500, 3000, 10000."""
         return self._copy_with(fee=fee_tier)
 
-    def pool(self, address: str) -> "AsyncQueryBuilder":
-        """Set pool address (for Uniswap)."""
-        return self._copy_with(pool=address)
-
     # Verbose mode
     def verbose(self, enabled: bool = True) -> "AsyncQueryBuilder":
         """Include all metadata fields (tx_hash, tx_id, log_index, network, name)."""
@@ -393,7 +367,7 @@ class AsyncQueryBuilder:
         """
         Execute query and return results as list of dictionaries.
 
-        Uses JSON format from API.
+        Uses JSON format from API. Limited to 10,000 blocks.
 
         Returns:
             List of event dictionaries
@@ -405,8 +379,6 @@ class AsyncQueryBuilder:
         """
         Execute query and return results as DataFrame.
 
-        Uses Parquet format from API for efficiency, then converts to DataFrame.
-
         Args:
             library: DataFrame library to use - "pandas" (default) or "polars"
 

{defistream-1.0.1.dist-info → defistream-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: defistream
-Version: 1.0.1
+Version: 1.0.2
 Summary: Python client for the DeFiStream API
 Project-URL: Homepage, https://defistream.dev
 Project-URL: Documentation, https://docs.defistream.dev
@@ -158,12 +158,12 @@ df = (
     .as_df()
 )
 
-# Get liquidations for a specific user
+# Use a specific market type on ETH (Core, Prime, or EtherFi)
 df = (
-    client.aave.liquidations()
+    client.aave.deposits()
     .network("ETH")
     .block_range(21000000, 21010000)
-    .user("0x...")
+    .eth_market_type("Prime")
     .as_df()
 )
 ```
@@ -409,23 +409,20 @@ print(f"Request cost: {client.last_response.request_cost}")
 | `.time_range(start, end)` | Set both start and end times |
 | `.verbose()` | Include all metadata fields |
 
-### Filter Methods
+### Protocol-Specific Parameters
 
 | Method | Protocols | Description |
 |--------|-----------|-------------|
+| `.token(symbol)` | ERC20 | Token symbol (USDT, USDC) or contract address |
+| `.decimals(n)` | ERC20 | Token decimals when using custom address (default: 18) |
 | `.sender(addr)` | ERC20, Native | Filter by sender address |
 | `.receiver(addr)` | ERC20, Native | Filter by receiver address |
-| `.from_address(addr)` | ERC20, Native | Alias for sender |
-| `.to_address(addr)` | ERC20, Native | Alias for receiver |
 | `.min_amount(amt)` | ERC20, Native | Minimum transfer amount |
-| `.token(symbol)` | ERC20 | Token symbol (USDT, USDC, etc.) |
-| `.user(addr)` | AAVE | Filter by user |
-| `.reserve(addr)` | AAVE | Filter by reserve |
-| `.liquidator(addr)` | AAVE Liquidations | Filter by liquidator |
-| `.symbol0(sym)` | Uniswap | First token symbol |
-| `.symbol1(sym)` | Uniswap | Second token symbol |
-| `.fee(tier)` | Uniswap | Fee tier (100, 500, 3000, 10000) |
-| `.pool(addr)` | Uniswap | Pool address |
+| `.max_amount(amt)` | ERC20, Native | Maximum transfer amount |
+| `.eth_market_type(type)` | AAVE | Market type for ETH: 'Core', 'Prime', 'EtherFi' |
+| `.symbol0(sym)` | Uniswap | First token symbol (required) |
+| `.symbol1(sym)` | Uniswap | Second token symbol (required) |
+| `.fee(tier)` | Uniswap | Fee tier: 100, 500, 3000, 10000 (required) |
 
 ### Terminal Methods
 

{defistream-1.0.1.dist-info → defistream-1.0.2.dist-info}/RECORD

@@ -1,11 +1,11 @@
-defistream/__init__.py,sha256=h2xO5tLBCKGkCzw0DTG6g6aDSBZs2qd4oaKnCRLlJR8,1680
+defistream/__init__.py,sha256=RUAlky12Gxi0hYBUeXJ32qkhku-BLs8cOqZCpC6nZE0,1680
 defistream/client.py,sha256=Ku8ouDbM6Mx4lVmqvBwNvNt-h2FkvqauPMSjKyPkjU4,12717
 defistream/exceptions.py,sha256=_GxZQ18_YvXFtmNHeddWV8fHPIllHgFeP7fP0CmHF1k,1492
 defistream/models.py,sha256=JiG4IUq19HIANz9MHQCkaE6onGNyNzXcbdJmosrHsw0,3812
 defistream/protocols.py,sha256=5_bYd46lDy-mK6LZ8sTGW0Z2IVH4g0cQ5rBbbOXsw0U,15368
 defistream/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-defistream/query.py,sha256=73vu8uXBdiFqGKoU0nDHDQ8emLnt1HVJMmvrl--Hzmg,17791
-defistream-1.0.1.dist-info/METADATA,sha256=2yl5LrW4c3sEHzORotGKqmn5FG50oicXUCgttApTn2M,10947
-defistream-1.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-defistream-1.0.1.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
-defistream-1.0.1.dist-info/RECORD,,
+defistream/query.py,sha256=cOGba8MQNFKXTs39csD81vrMW76c9O3-S40R0KAMyCA,17158
+defistream-1.0.2.dist-info/METADATA,sha256=MSChxyWWx6vCUALDfZFybRLcqJsKtyi56N4eY-i2vyE,10950
+defistream-1.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+defistream-1.0.2.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
+defistream-1.0.2.dist-info/RECORD,,