wayfinder-paths 0.1.11__py3-none-any.whl → 0.1.14__py3-none-any.whl

wayfinder_paths/core/clients/protocols.py

@@ -4,7 +4,7 @@ Protocol definitions for API clients.
 These protocols define the interface that all client implementations must satisfy.
 When used as an SDK, users can provide custom implementations that match these protocols.
 
-Note: AuthClient is excluded as SDK users handle their own authentication.
+Note: Authentication is handled via X-API-KEY header in WayfinderClient base class.
 """
 
 from __future__ import annotations
@@ -12,20 +12,19 @@ from __future__ import annotations
 from typing import TYPE_CHECKING, Any, Protocol
 
 if TYPE_CHECKING:
-    from wayfinder_paths.core.clients.BRAPClient import BRAPQuote
+    from wayfinder_paths.core.clients.BRAPClient import BRAPQuoteResponse
     from wayfinder_paths.core.clients.HyperlendClient import (
         AssetsView,
         LendRateHistory,
         MarketEntry,
-        StableMarket,
+        StableMarketsHeadroomResponse,
     )
     from wayfinder_paths.core.clients.LedgerClient import (
         StrategyTransactionList,
         TransactionRecord,
     )
     from wayfinder_paths.core.clients.PoolClient import (
-        LlamaMatch,
-        LlamaReport,
+        LlamaMatchesResponse,
         PoolList,
     )
     from wayfinder_paths.core.clients.TokenClient import (
@@ -33,8 +32,7 @@ if TYPE_CHECKING:
         TokenDetails,
     )
     from wayfinder_paths.core.clients.WalletClient import (
-        PoolBalance,
-        TokenBalance,
+        AddressBalance,
     )
 
 
@@ -42,7 +40,10 @@ class TokenClientProtocol(Protocol):
     """Protocol for token-related operations"""
 
     async def get_token_details(
-        self, token_id: str, force_refresh: bool = False
+        self,
+        query: str,
+        market_data: bool = True,
+        chain_id: int | None = None,
     ) -> TokenDetails:
         """Get token data including price from the token-details endpoint"""
         ...
@@ -58,19 +59,16 @@ class HyperlendClientProtocol(Protocol):
     async def get_stable_markets(
         self,
         *,
-        chain_id: int,
         required_underlying_tokens: float | None = None,
         buffer_bps: int | None = None,
         min_buffer_tokens: float | None = None,
-        is_stable_symbol: bool | None = None,
-    ) -> list[StableMarket]:
-        """Fetch stable markets from Hyperlend"""
+    ) -> StableMarketsHeadroomResponse:
+        """Fetch stable markets headroom from Hyperlend"""
         ...
 
     async def get_assets_view(
         self,
         *,
-        chain_id: int,
         user_address: str,
     ) -> AssetsView:
         """Fetch assets view for a user address from Hyperlend"""
@@ -79,8 +77,7 @@ class HyperlendClientProtocol(Protocol):
     async def get_market_entry(
         self,
         *,
-        chain_id: int,
-        token_address: str,
+        token: str,
     ) -> MarketEntry:
         """Fetch market entry from Hyperlend"""
         ...
@@ -88,9 +85,9 @@ class HyperlendClientProtocol(Protocol):
     async def get_lend_rate_history(
         self,
         *,
-        chain_id: int,
-        token_address: str,
+        token: str,
         lookback_hours: int,
+        force_refresh: bool | None = None,
     ) -> LendRateHistory:
         """Fetch lend rate history from Hyperlend"""
         ...
@@ -162,25 +159,14 @@ class LedgerClientProtocol(Protocol):
 class WalletClientProtocol(Protocol):
     """Protocol for wallet-related operations"""
 
-    async def get_token_balance_for_wallet(
+    async def get_token_balance_for_address(
         self,
         *,
-        token_id: str,
         wallet_address: str,
-        human_readable: bool = True,
-    ) -> TokenBalance:
-        """Fetch a single token balance for an explicit wallet address"""
-        ...
-
-    async def get_pool_balance_for_wallet(
-        self,
-        *,
-        pool_address: str,
-        chain_id: int,
-        user_address: str,
-        human_readable: bool = True,
-    ) -> PoolBalance:
-        """Fetch a wallet's LP/share balance for a given pool address and chain"""
+        query: str,
+        chain_id: int | None = None,
+    ) -> AddressBalance:
+        """Fetch a balance for an address + chain + query (supports compound query formats)"""
         ...
 
 
@@ -190,18 +176,18 @@ class PoolClientProtocol(Protocol):
     async def get_pools_by_ids(
         self,
         *,
-        pool_ids: str,
-        merge_external: bool | None = None,
+        pool_ids: list[str] | str,
     ) -> PoolList:
-        """Fetch pools by comma-separated pool ids"""
+        """Fetch pools by pool IDs (list or comma-separated string)"""
         ...
 
-    async def get_llama_matches(self) -> dict[str, LlamaMatch]:
-        """Fetch Llama matches for pools"""
-        ...
-
-    async def get_llama_reports(self, *, identifiers: str) -> dict[str, LlamaReport]:
-        """Fetch Llama reports using identifiers"""
+    async def get_pools(
+        self,
+        *,
+        chain_id: int | None = None,
+        project: str | None = None,
+    ) -> LlamaMatchesResponse:
+        """Fetch pools (optionally filtered by chain_id and project)"""
         ...
 
 
@@ -211,16 +197,13 @@ class BRAPClientProtocol(Protocol):
     async def get_quote(
         self,
         *,
-        from_token_address: str,
-        to_token_address: str,
-        from_chain_id: int,
-        to_chain_id: int,
-        from_address: str,
-        to_address: str,
-        amount1: str,
-        slippage: float | None = None,
-        wayfinder_fee: float | None = None,
-    ) -> BRAPQuote:
+        from_token: str,
+        to_token: str,
+        from_chain: int,
+        to_chain: int,
+        from_wallet: str,
+        from_amount: str,
+    ) -> BRAPQuoteResponse:
         """Get a quote for a bridge/swap operation"""
         ...
 

wayfinder_paths/core/clients/sdk_example.py

@@ -38,59 +38,74 @@ class MockHyperlendClient:
     async def get_stable_markets(
         self,
         *,
-        chain_id: int,
         required_underlying_tokens: float | None = None,
         buffer_bps: int | None = None,
         min_buffer_tokens: float | None = None,
-        is_stable_symbol: bool | None = None,
     ) -> dict[str, Any]:
         return {
-            "markets": [
-                {
-                    "chain_id": chain_id,
-                    "token_address": "0xMockToken",
+            "markets": {
+                "0xMockToken": {
                     "symbol": "USDC",
-                    "lend_rate": 0.05,
-                    "available_liquidity": 1000000.0,
+                    "symbol_canonical": "usdc",
+                    "display_symbol": "USDC",
+                    "reserve": {},
+                    "decimals": 6,
+                    "headroom": 1000000000000,
+                    "supply_cap": 5000000000000,
                 }
-            ]
+            },
+            "notes": [],
         }
 
     async def get_assets_view(
         self,
         *,
-        chain_id: int,
         user_address: str,
     ) -> dict[str, Any]:
         return {
-            "user_address": user_address,
-            "chain_id": chain_id,
+            "block_number": 12345,
+            "user": user_address,
+            "native_balance_wei": 0,
+            "native_balance": 0.0,
             "assets": [],
+            "account_data": {
+                "total_collateral_base": 0,
+                "total_debt_base": 0,
+                "available_borrows_base": 0,
+                "current_liquidation_threshold": 0,
+                "ltv": 0,
+                "health_factor_wad": 0,
+                "health_factor": 0.0,
+            },
+            "base_currency_info": {
+                "marketReferenceCurrencyUnit": 100000000,
+                "marketReferenceCurrencyPriceInUsd": 100000000,
+                "networkBaseTokenPriceInUsd": 0,
+                "networkBaseTokenPriceDecimals": 8,
+            },
         }
 
     async def get_market_entry(
         self,
         *,
-        chain_id: int,
-        token_address: str,
+        token: str,
     ) -> dict[str, Any]:
         return {
-            "chain_id": chain_id,
-            "token_address": token_address,
-            "market_data": {},
+            "symbol": "USDC",
+            "symbol_canonical": "usdc",
+            "display_symbol": "USDC",
+            "reserve": {},
         }
 
     async def get_lend_rate_history(
         self,
         *,
-        chain_id: int,
-        token_address: str,
+        token: str,
         lookback_hours: int,
+        force_refresh: bool | None = None,
     ) -> dict[str, Any]:
         return {
-            "chain_id": chain_id,
-            "token_address": token_address,
-            "rates": [],
+            "history": [],
         }