wayfinder-paths 0.1.8__tar.gz → 0.1.9__tar.gz

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wayfinder-paths
-Version: 0.1.8
+Version: 0.1.9
 Summary: Wayfinder Path: strategies and adapters
 Author: Wayfinder
 Author-email: dev@wayfinder.ai
@@ -54,9 +54,6 @@ cp wayfinder_paths/config.example.json config.json
 # Run a strategy locally (one-shot status check)
 poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --action status --config config.json
 
-export WAYFINDER_API_KEY="sk_live_abc123..."
-poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --config config.json
-
 # Run continuously (production mode)
 poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --config config.json
 ```
@@ -213,7 +210,7 @@ The platform uses a unified client system for all API interactions. Clients are
 
 ### Clients vs Adapters
 
-- **Clients**: Low-level, reusable service wrappers that talk to networks and external APIs. They handle auth, headers, retries, and response parsing, and expose generic capabilities (e.g., token info, tx building). Examples: `TokenClient`, `TransactionClient`, `WalletClient`.
+- **Clients**: Low-level, reusable service wrappers that talk to networks and external APIs. They handle auth, headers, retries, and response parsing, and expose generic capabilities (e.g., token info, tx building). Examples: `TokenClient`, `WalletClient`.
 - **Adapters**: Strategy-facing integrations for a specific exchange/protocol. They compose one or more clients to implement a manifest of capabilities (e.g., `supply`, `borrow`, `place_order`). Adapters encapsulate protocol-specific semantics and raise `NotImplementedError` for unsupported ops.
 
 Recommended usage:
@@ -415,14 +412,7 @@ strategy = StablecoinYieldStrategy(
 )
 ```
 
-**Option B: Set Environment Variable**
-
-```bash
-export WAYFINDER_API_KEY="sk_live_abc123..."
-# All clients will automatically discover and use this
-```
-
-**Option C: Add to config.json**
+**Option B: Add to config.json**
 
 ```json
 {
@@ -435,7 +425,7 @@ export WAYFINDER_API_KEY="sk_live_abc123..."
 }
 ```
 
-**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key) > `WAYFINDER_API_KEY` environment variable
+**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key)
 
 **Note:** API keys in `config.json` are loaded directly by `WayfinderClient` via `_load_config_credentials()`, not through the `UserConfig` or `SystemConfig` dataclasses. This allows flexible credential loading.
 
@@ -516,7 +506,7 @@ class MyStrategy(Strategy):
         super().__init__(api_key=api_key)  # Pass to base class for auto-discovery
         self.config = config or {}
         web3_service = DefaultWeb3Service(self.config)
-        # Adapters automatically discover API key from env var (set by Strategy.__init__)
+        # Adapters automatically discover API key from constructor or config.json
         balance_adapter = BalanceAdapter(self.config, web3_service=web3_service)
         self.register_adapters([balance_adapter])
         self.balance_adapter = balance_adapter

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/README.md

@@ -31,9 +31,6 @@ cp wayfinder_paths/config.example.json config.json
 # Run a strategy locally (one-shot status check)
 poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --action status --config config.json
 
-export WAYFINDER_API_KEY="sk_live_abc123..."
-poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --config config.json
-
 # Run continuously (production mode)
 poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --config config.json
 ```
@@ -190,7 +187,7 @@ The platform uses a unified client system for all API interactions. Clients are
 
 ### Clients vs Adapters
 
-- **Clients**: Low-level, reusable service wrappers that talk to networks and external APIs. They handle auth, headers, retries, and response parsing, and expose generic capabilities (e.g., token info, tx building). Examples: `TokenClient`, `TransactionClient`, `WalletClient`.
+- **Clients**: Low-level, reusable service wrappers that talk to networks and external APIs. They handle auth, headers, retries, and response parsing, and expose generic capabilities (e.g., token info, tx building). Examples: `TokenClient`, `WalletClient`.
 - **Adapters**: Strategy-facing integrations for a specific exchange/protocol. They compose one or more clients to implement a manifest of capabilities (e.g., `supply`, `borrow`, `place_order`). Adapters encapsulate protocol-specific semantics and raise `NotImplementedError` for unsupported ops.
 
 Recommended usage:
@@ -392,14 +389,7 @@ strategy = StablecoinYieldStrategy(
 )
 ```
 
-**Option B: Set Environment Variable**
-
-```bash
-export WAYFINDER_API_KEY="sk_live_abc123..."
-# All clients will automatically discover and use this
-```
-
-**Option C: Add to config.json**
+**Option B: Add to config.json**
 
 ```json
 {
@@ -412,7 +402,7 @@ export WAYFINDER_API_KEY="sk_live_abc123..."
 }
 ```
 
-**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key) > `WAYFINDER_API_KEY` environment variable
+**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key)
 
 **Note:** API keys in `config.json` are loaded directly by `WayfinderClient` via `_load_config_credentials()`, not through the `UserConfig` or `SystemConfig` dataclasses. This allows flexible credential loading.
 
@@ -493,7 +483,7 @@ class MyStrategy(Strategy):
         super().__init__(api_key=api_key)  # Pass to base class for auto-discovery
         self.config = config or {}
         web3_service = DefaultWeb3Service(self.config)
-        # Adapters automatically discover API key from env var (set by Strategy.__init__)
+        # Adapters automatically discover API key from constructor or config.json
         balance_adapter = BalanceAdapter(self.config, web3_service=web3_service)
         self.register_adapters([balance_adapter])
         self.balance_adapter = balance_adapter

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "wayfinder-paths"
-version = "0.1.8"
+version = "0.1.9"
 description = "Wayfinder Path: strategies and adapters"
 readme = "README.md"
 authors = ["Wayfinder <dev@wayfinder.ai>"]

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/CONFIG_GUIDE.md

@@ -52,7 +52,6 @@ cp wayfinder_paths/config.example.json config.json
 **Option 1: Service Account (API Key) - Recommended for Production**
 - `user.api_key` - Your Wayfinder API key for service account authentication (loaded directly by clients from config.json)
 - OR `system.api_key` - System-level API key (alternative location, loaded directly by clients)
-- OR set `WAYFINDER_API_KEY` environment variable
 - OR pass `api_key` parameter to strategy constructor
 
 **Note:** API keys in `config.json` are loaded directly by `WayfinderClient` via `_load_config_credentials()`, not through the `UserConfig` or `SystemConfig` dataclasses. This is intentional to allow flexible credential loading.
@@ -229,7 +228,6 @@ The strategy system supports multiple wallet types through a wallet abstraction
 
 By default, adapters use `LocalWalletProvider` which resolves private keys from:
 - `wallets.json` (matched by address)
-- Environment variables (`PRIVATE_KEY`, `PRIVATE_KEY_STRATEGY`)
 - Wallet config in `config.json`
 
 No code changes are required - existing strategies continue to work.
@@ -270,7 +268,7 @@ Wayfinder Paths supports **dual authentication** for different use cases:
 
 **Best for:** Backend services, automated systems, and production deployments with higher rate limits.
 
-API keys provide service account authentication and are automatically discovered by all clients. You can provide an API key in three ways:
+API keys provide service account authentication and are automatically discovered by all clients. You can provide an API key in two ways:
 
 #### Option A: Strategy Constructor (Programmatic)
 ```python
@@ -278,16 +276,11 @@ from wayfinder_paths.strategies.stablecoin_yield_strategy.strategy import Stable
 
 strategy = StablecoinYieldStrategy(
     config={...},
-    api_key="sk_live_abc123..."  # Sets WAYFINDER_API_KEY env var automatically
+    api_key="sk_live_abc123..."  # API key is auto-discovered by all clients
 )
 ```
 
-#### Option B: Environment Variable
-```bash
-export WAYFINDER_API_KEY="sk_live_abc123..."
-```
-
-#### Option C: config.json
+#### Option B: config.json
 ```json
 {
   "user": {
@@ -299,14 +292,12 @@ export WAYFINDER_API_KEY="sk_live_abc123..."
 }
 ```
 
-**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key) > `WAYFINDER_API_KEY` environment variable
+**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key)
 
 **How It Works:**
-- When a strategy receives an `api_key`, it sets `os.environ["WAYFINDER_API_KEY"]`
 - All clients created by adapters automatically discover the API key from:
   - Constructor parameter (if passed)
   - `config.json` (via `WayfinderClient._load_config_credentials()` which reads `user.api_key` or `system.api_key`)
-  - `WAYFINDER_API_KEY` environment variable
 - API keys are included in **all** API requests (including public endpoints) for rate limiting
 - No need to pass API keys explicitly to adapters or clients—they auto-discover it
 - **Note:** API keys in `config.json` are loaded directly by clients, not stored in the `UserConfig` or `SystemConfig` dataclasses
@@ -379,7 +370,7 @@ To use custom RPC endpoints, update the `strategy.rpc_urls` section in `config.j
 **Issue:** "Authentication failed"
 - **If using API key:**
   - Verify API key is correct and not expired
-  - Check that API key is set in one of: constructor parameter, `config.json` (user.api_key or system.api_key), or `WAYFINDER_API_KEY` env var
+  - Check that API key is set in one of: constructor parameter or `config.json` (user.api_key or system.api_key)
   - Ensure API key has proper permissions for the operations you're performing
 - **If using OAuth:**
   - Check that `username` and `password` are correct in `config.json`

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/brap_adapter/README.md

@@ -17,7 +17,7 @@ The adapter uses the BRAPClient which automatically handles authentication and A
 
 The BRAPClient will automatically:
 - Use the WAYFINDER_API_URL from settings
-- Handle authentication via environment variables or config.json
+- Handle authentication via config.json
 - Manage token refresh and retry logic
 
 ## Usage

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/brap_adapter/adapter.py

@@ -10,10 +10,6 @@ from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
 from wayfinder_paths.core.adapters.models import SWAP
 from wayfinder_paths.core.clients.BRAPClient import BRAPClient, BRAPQuote
 from wayfinder_paths.core.clients.LedgerClient import TransactionRecord
-from wayfinder_paths.core.clients.SimulationClient import (
-    SimulationClient,
-    SimulationResult,
-)
 from wayfinder_paths.core.clients.TokenClient import TokenClient
 from wayfinder_paths.core.constants import DEFAULT_SLIPPAGE
 from wayfinder_paths.core.constants.base import DEFAULT_TRANSACTION_TIMEOUT
@@ -45,7 +41,6 @@ class BRAPAdapter(BaseAdapter):
         config: dict[str, Any] | None = None,
         *,
         web3_service: Web3Service,
-        simulation: bool = False,
     ):
         super().__init__("brap_adapter", config)
         self.brap_client = BRAPClient()
@@ -55,8 +50,6 @@ class BRAPAdapter(BaseAdapter):
         self.web3_service = web3_service
         self.wallet_provider = web3_service.evm_transactions
         self.token_transactions = web3_service.token_transactions
-        self.simulation = simulation
-        self.simulation_client = SimulationClient() if simulation else None
 
     async def get_swap_quote(
         self,
@@ -367,12 +360,6 @@ class BRAPAdapter(BaseAdapter):
             if not approve_success:
                 return (False, approve_response)
 
-        if self.simulation:
-            simulation = await self._simulate_swap(
-                from_token, to_token, from_address, chain_id, quote
-            )
-            return (True, {"quote": quote, "simulation": simulation})
-
         broadcast_success, broadcast_response = await self._broadcast_transaction(
             transaction
         )
@@ -677,44 +664,6 @@ class BRAPAdapter(BaseAdapter):
             / 10 ** int(decimals)
         )
 
-    async def _simulate_swap(
-        self,
-        from_token: dict[str, Any],
-        to_token: dict[str, Any],
-        from_address: str,
-        chain_id: int,
-        quote: dict[str, Any],
-    ) -> SimulationResult:
-        client = await self._get_simulation_client()
-        initial_balances = {"native": "5000000000000000000"}
-        if from_token.get("address"):
-            initial_balances[from_token.get("address")] = "1000000000000000000000000"
-
-        slippage = quote.get("slippage") or quote.get("slippage_percent")
-        if isinstance(slippage, str):
-            try:
-                slippage = float(slippage)
-            except ValueError:
-                slippage = DEFAULT_SLIPPAGE
-        slippage = slippage or DEFAULT_SLIPPAGE
-
-        amount = quote.get("input_amount") or quote.get("inputAmount") or "0"
-        return await client.simulate_swap(
-            from_token_address=from_token.get("address"),
-            to_token_address=to_token.get("address"),
-            from_chain_id=chain_id,
-            to_chain_id=chain_id,
-            amount=str(amount),
-            from_address=from_address,
-            slippage=float(slippage),
-            initial_balances=initial_balances,
-        )
-
-    async def _get_simulation_client(self) -> SimulationClient:
-        if not self.simulation_client:
-            self.simulation_client = SimulationClient()
-        return self.simulation_client
-
     def _chain_id(self, chain: Any) -> int:
         if isinstance(chain, dict):
             chain_id = chain.get("id") or chain.get("chain_id")

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/hyperlend_adapter/adapter.py

@@ -12,7 +12,6 @@ from wayfinder_paths.core.clients.HyperlendClient import (
     MarketEntry,
     StableMarket,
 )
-from wayfinder_paths.core.clients.SimulationClient import SimulationClient
 from wayfinder_paths.core.constants.base import DEFAULT_TRANSACTION_TIMEOUT
 from wayfinder_paths.core.constants.hyperlend_abi import (
     POOL_ABI,
@@ -37,16 +36,12 @@ class HyperlendAdapter(BaseAdapter):
         self,
         config: dict[str, Any],
         web3_service: Web3Service,
-        simulation: bool = False,
     ) -> None:
         super().__init__("hyperlend_adapter", config)
         cfg = config or {}
         adapter_cfg = cfg.get("hyperlend_adapter") or {}
 
         self.hyperlend_client = HyperlendClient()
-        self.simulation = simulation
-        self.simulation_client = SimulationClient() if simulation else None
-
         self.web3 = web3_service
         self.token_txn_service = web3_service.token_transactions
 
@@ -237,8 +232,6 @@ class HyperlendAdapter(BaseAdapter):
         return await self._broadcast_transaction(approve_tx)
 
     async def _execute(self, tx: dict[str, Any]) -> tuple[bool, Any]:
-        if self.simulation:
-            return True, {"simulation": tx}
         return await self.web3.broadcast_transaction(
             tx, wait_for_receipt=True, timeout=DEFAULT_TRANSACTION_TIMEOUT
         )

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/hyperliquid_adapter/adapter.py

@@ -74,7 +74,6 @@ class HyperliquidAdapter(BaseAdapter):
         self,
         config: dict[str, Any] | None = None,
         *,
-        simulation: bool = False,
         executor: HyperliquidExecutor | None = None,
     ) -> None:
         super().__init__("hyperliquid_adapter", config)
@@ -85,7 +84,6 @@ class HyperliquidAdapter(BaseAdapter):
                 "Install with: poetry add hyperliquid"
             )
 
-        self.simulation = simulation
         self._cache = SimpleCache()
         self._executor = executor
 
@@ -481,13 +479,6 @@ class HyperliquidAdapter(BaseAdapter):
         Returns:
             (success, response_data or error_message)
         """
-        if self.simulation:
-            self.logger.info(
-                f"[SIMULATION] place_market_order: asset={asset_id}, "
-                f"is_buy={is_buy}, size={size}, address={address}"
-            )
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError(
                 "No Hyperliquid executor configured. "
@@ -525,12 +516,6 @@ class HyperliquidAdapter(BaseAdapter):
         Returns:
             (success, response_data or error_message)
         """
-        if self.simulation:
-            self.logger.info(
-                f"[SIMULATION] cancel_order: asset={asset_id}, oid={order_id}"
-            )
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError(
                 "No Hyperliquid executor configured. "
@@ -565,12 +550,6 @@ class HyperliquidAdapter(BaseAdapter):
         Returns:
             (success, response_data or error_message)
         """
-        if self.simulation:
-            self.logger.info(
-                f"[SIMULATION] update_leverage: asset={asset_id}, leverage={leverage}"
-            )
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 
@@ -590,10 +569,6 @@ class HyperliquidAdapter(BaseAdapter):
         address: str,
     ) -> tuple[bool, dict[str, Any]]:
         """Transfer USDC from spot to perp balance."""
-        if self.simulation:
-            self.logger.info(f"[SIMULATION] transfer_spot_to_perp: {amount} USDC")
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 
@@ -611,10 +586,6 @@ class HyperliquidAdapter(BaseAdapter):
         address: str,
     ) -> tuple[bool, dict[str, Any]]:
         """Transfer USDC from perp to spot balance."""
-        if self.simulation:
-            self.logger.info(f"[SIMULATION] transfer_perp_to_spot: {amount} USDC")
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 
@@ -647,13 +618,6 @@ class HyperliquidAdapter(BaseAdapter):
         Returns:
             (success, response_data or error_message)
         """
-        if self.simulation:
-            self.logger.info(
-                f"[SIMULATION] place_stop_loss: asset={asset_id}, "
-                f"trigger={trigger_price}, size={size}"
-            )
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 
@@ -758,10 +722,6 @@ class HyperliquidAdapter(BaseAdapter):
 
         Note: This is an L1 withdrawal handled by the Hyperliquid executor (signing required).
         """
-        if self.simulation:
-            self.logger.info(f"[SIMULATION] withdraw: {amount} USDC")
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 
@@ -856,13 +816,6 @@ class HyperliquidAdapter(BaseAdapter):
         Returns:
             (success, response_data or error_message)
         """
-        if self.simulation:
-            self.logger.info(
-                f"[SIMULATION] approve_builder_fee: builder={builder}, "
-                f"rate={max_fee_rate}, address={address}"
-            )
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 
@@ -903,13 +856,6 @@ class HyperliquidAdapter(BaseAdapter):
         Returns:
             (success, response_data or error_message)
         """
-        if self.simulation:
-            self.logger.info(
-                f"[SIMULATION] place_limit_order: asset={asset_id}, "
-                f"is_buy={is_buy}, price={price}, size={size}"
-            )
-            return True, {"simulation": True, "status": "ok"}
-
         if not self._executor:
             raise NotImplementedError("No Hyperliquid executor configured.")
 

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/hyperliquid_adapter/test_adapter_live.py

@@ -17,7 +17,7 @@ from wayfinder_paths.adapters.hyperliquid_adapter.adapter import HyperliquidAdap
 @pytest.fixture
 def live_adapter():
     """Create adapter connected to real Hyperliquid API."""
-    return HyperliquidAdapter(config={}, simulation=True)
+    return HyperliquidAdapter(config={})
 
 
 class TestSpotAssetIDs:

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/ledger_adapter/README.md

@@ -17,7 +17,7 @@ The adapter uses the LedgerClient which automatically handles authentication and
 
 The LedgerClient will automatically:
 - Use the WAYFINDER_API_URL from settings
-- Handle authentication via environment variables or config.json
+- Handle authentication via config.json
 - Manage token refresh and retry logic
 
 ## Usage

{wayfinder_paths-0.1.8 → wayfinder_paths-0.1.9}/wayfinder_paths/adapters/pool_adapter/README.md

@@ -17,7 +17,7 @@ The adapter uses the PoolClient which automatically handles authentication and A
 The PoolClient will automatically:
 
 - Use the WAYFINDER_API_URL from settings
-- Handle authentication via environment variables or config.json
+- Handle authentication via config.json
 - Manage token refresh and retry logic
 
 ## Usage
@@ -45,41 +45,6 @@ else:
     print(f"Error: {data}")
 ```
 
-### Find High Yield Pools
-
-```python
-success, data = await adapter.find_high_yield_pools(
-    min_apy=0.03,  # 3% minimum APY
-    min_tvl=500000,  # $500k minimum TVL
-    stablecoin_only=True,
-    network_codes=["base", "ethereum"]
-)
-if success:
-    pools = data.get("pools", [])
-    print(f"Found {len(pools)} high-yield pools")
-    for pool in pools:
-        print(f"Pool: {pool.get('id')} - APY: {pool.get('llama_apy_pct')}%")
-else:
-    print(f"Error: {data}")
-```
-
-### Get Pool Analytics
-
-```python
-success, data = await adapter.get_pool_analytics(
-    pool_ids=["pool-123", "pool-456"]
-)
-if success:
-    analytics = data.get("analytics", [])
-    for pool_analytics in analytics:
-        pool = pool_analytics.get("pool", {})
-        combined_apy = pool_analytics.get("combined_apy", 0)
-        tvl_usd = pool_analytics.get("tvl_usd", 0)
-        print(f"Pool: {pool.get('name')} - APY: {combined_apy:.2%} - TVL: ${tvl_usd:,.0f}")
-else:
-    print(f"Error: {data}")
-```
-
 ### Get Llama Matches
 
 ```python
@@ -110,47 +75,6 @@ else:
 
 ## Advanced Usage
 
-### Filtering High Yield Pools
-
-The `find_high_yield_pools` method provides powerful filtering capabilities:
-
-```python
-# Find stablecoin pools with high yield on specific networks
-success, data = await adapter.find_high_yield_pools(
-    min_apy=0.05,  # 5% minimum APY
-    min_tvl=1000000,  # $1M minimum TVL
-    stablecoin_only=True,  # Only stablecoin pools
-    network_codes=["base", "arbitrum"]  # Specific networks
-)
-
-if success:
-    pools = data.get("pools", [])
-    # Pools are automatically sorted by APY (highest first)
-    best_pool = pools[0] if pools else None
-    if best_pool:
-        print(f"Best pool: {best_pool.get('id')} - APY: {best_pool.get('llama_apy_pct')}%")
-```
-
-### Comprehensive Pool Analysis
-
-```python
-# Get detailed analytics for specific pools
-success, data = await adapter.get_pool_analytics(["pool-123"])
-
-if success:
-    analytics = data.get("analytics", [])
-    for pool_analytics in analytics:
-        pool = pool_analytics.get("pool", {})
-        llama_data = pool_analytics.get("llama_data", {})
-
-        print(f"Pool: {pool.get('name')}")
-        print(f"  Combined APY: {pool_analytics.get('combined_apy', 0):.2%}")
-        print(f"  TVL: ${pool_analytics.get('tvl_usd', 0):,.0f}")
-        print(f"  Llama APY: {llama_data.get('llama_apy_pct', 0)}%")
-        print(f"  Stablecoin: {llama_data.get('llama_stablecoin', False)}")
-        print(f"  IL Risk: {llama_data.get('llama_il_risk', 'unknown')}")
-```
-
 ## API Endpoints
 
 The adapter uses the following Wayfinder API endpoints:

wayfinder_paths-0.1.9/wayfinder_paths/adapters/pool_adapter/adapter.py

@@ -0,0 +1,88 @@
+from typing import Any
+
+from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
+from wayfinder_paths.core.clients.PoolClient import (
+    LlamaMatch,
+    LlamaReport,
+    PoolClient,
+    PoolList,
+)
+
+
+class PoolAdapter(BaseAdapter):
+    """
+    Pool adapter for DeFi pool data and analytics operations.
+
+    Provides high-level operations for:
+    - Fetching pool information and metadata
+    - Getting pool analytics and reports
+    - Accessing Llama protocol data
+    - Pool discovery and filtering
+    """
+
+    adapter_type: str = "POOL"
+
+    def __init__(
+        self,
+        config: dict[str, Any] | None = None,
+        pool_client: PoolClient | None = None,
+    ):
+        super().__init__("pool_adapter", config)
+        self.pool_client = pool_client or PoolClient()
+
+    async def get_pools_by_ids(
+        self, pool_ids: list[str], merge_external: bool | None = None
+    ) -> tuple[bool, PoolList | str]:
+        """
+        Get pool information by pool IDs.
+
+        Args:
+            pool_ids: List of pool identifiers
+            merge_external: Whether to merge external data
+
+        Returns:
+            Tuple of (success, data) where data is pool information or error message
+        """
+        try:
+            pool_ids_str = ",".join(pool_ids)
+            data = await self.pool_client.get_pools_by_ids(
+                pool_ids=pool_ids_str, merge_external=merge_external
+            )
+            return (True, data)
+        except Exception as e:
+            self.logger.error(f"Error fetching pools by IDs: {e}")
+            return (False, str(e))
+
+    async def get_llama_matches(self) -> tuple[bool, dict[str, LlamaMatch] | str]:
+        """
+        Get Llama protocol matches for pools.
+
+        Returns:
+            Tuple of (success, data) where data is Llama matches or error message
+        """
+        try:
+            data = await self.pool_client.get_llama_matches()
+            return (True, data)
+        except Exception as e:
+            self.logger.error(f"Error fetching Llama matches: {e}")
+            return (False, str(e))
+
+    async def get_llama_reports(
+        self, identifiers: list[str]
+    ) -> tuple[bool, dict[str, LlamaReport] | str]:
+        """
+        Get Llama reports for specific identifiers.
+
+        Args:
+            identifiers: List of identifiers (token IDs, addresses, pool IDs)
+
+        Returns:
+            Tuple of (success, data) where data is Llama reports or error message
+        """
+        try:
+            identifiers_str = ",".join(identifiers)
+            data = await self.pool_client.get_llama_reports(identifiers=identifiers_str)
+            return (True, data)
+        except Exception as e:
+            self.logger.error(f"Error fetching Llama reports: {e}")
+            return (False, str(e))