wayfinder-paths 0.1.8__py3-none-any.whl → 0.1.9__py3-none-any.whl

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/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/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/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/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/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/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/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/adapters/pool_adapter/adapter.py

@@ -86,125 +86,3 @@ class PoolAdapter(BaseAdapter):
         except Exception as e:
             self.logger.error(f"Error fetching Llama reports: {e}")
             return (False, str(e))
-
-    async def find_high_yield_pools(
-        self,
-        min_apy: float = 0.01,
-        min_tvl: float = 1000000,
-        stablecoin_only: bool = True,
-        network_codes: list[str] | None = None,
-    ) -> tuple[bool, Any]:
-        """
-        Find high-yield pools based on criteria.
-
-        Args:
-            min_apy: Minimum APY threshold (as decimal, e.g., 0.01 for 1%)
-            min_tvl: Minimum TVL threshold in USD
-            stablecoin_only: Whether to filter for stablecoin pools only
-            network_codes: List of network codes to filter by
-
-        Returns:
-            Tuple of (success, data) where data is filtered pools or error message
-        """
-        try:
-            # Get Llama matches for yield data
-            success, llama_data = await self.get_llama_matches()
-            if not success:
-                return (False, f"Failed to fetch Llama data: {llama_data}")
-
-            matches = llama_data.get("matches", [])
-            filtered_pools = []
-
-            for pool in matches:
-                # Apply filters
-                if stablecoin_only and not pool.get("llama_stablecoin", False):
-                    continue
-
-                if pool.get("llama_tvl_usd", 0) < min_tvl:
-                    continue
-
-                if (
-                    pool.get("llama_apy_pct", 0) < min_apy * 100
-                ):  # Convert to percentage
-                    continue
-
-                if network_codes and pool.get("network", "").lower() not in [
-                    nc.lower() for nc in network_codes
-                ]:
-                    continue
-
-                filtered_pools.append(pool)
-
-            # Sort by APY descending
-            filtered_pools.sort(key=lambda x: x.get("llama_apy_pct", 0), reverse=True)
-
-            return (
-                True,
-                {
-                    "pools": filtered_pools,
-                    "total_found": len(filtered_pools),
-                    "filters_applied": {
-                        "min_apy": min_apy,
-                        "min_tvl": min_tvl,
-                        "stablecoin_only": stablecoin_only,
-                        "network_codes": network_codes,
-                    },
-                },
-            )
-        except Exception as e:
-            self.logger.error(f"Error finding high yield pools: {e}")
-            return (False, str(e))
-
-    async def get_pool_analytics(self, pool_ids: list[str]) -> tuple[bool, Any]:
-        """
-        Get comprehensive analytics for specific pools.
-
-        Args:
-            pool_ids: List of pool identifiers
-
-        Returns:
-            Tuple of (success, data) where data is pool analytics or error message
-        """
-        try:
-            # Get pool data
-            success, pool_data = await self.get_pools_by_ids(pool_ids)
-            if not success:
-                return (False, f"Failed to fetch pool data: {pool_data}")
-
-            # Get Llama reports
-            success, llama_data = await self.get_llama_reports(pool_ids)
-            if not success:
-                self.logger.warning(f"Failed to fetch Llama data: {llama_data}")
-                llama_data = {}
-
-            pools = pool_data.get("pools", [])
-            llama_reports = llama_data
-
-            # Combine data
-            analytics = []
-            for pool in pools:
-                pool_id = pool.get("id")
-                llama_report = llama_reports.get(pool_id.lower()) if pool_id else None
-
-                analytics.append(
-                    {
-                        "pool": pool,
-                        "llama_data": llama_report,
-                        "combined_apy": (
-                            llama_report.get("llama_combined_apy_pct", 0) / 100
-                            if llama_report
-                            and llama_report.get("llama_combined_apy_pct") is not None
-                            else pool.get("apy", 0)
-                        ),
-                        "tvl_usd": (
-                            llama_report.get("llama_tvl_usd", 0)
-                            if llama_report and llama_report.get("llama_tvl_usd")
-                            else pool.get("tvl", 0)
-                        ),
-                    }
-                )
-
-            return (True, {"analytics": analytics, "total_pools": len(analytics)})
-        except Exception as e:
-            self.logger.error(f"Error getting pool analytics: {e}")
-            return (False, str(e))

wayfinder_paths/adapters/pool_adapter/examples.json

@@ -39,62 +39,5 @@
         ]
       }
     }
-  },
-  "find_high_yield_pools": {
-    "description": "Find high-yield pools based on criteria",
-    "input": {
-      "min_apy": 0.03,
-      "min_tvl": 500000,
-      "stablecoin_only": true,
-      "network_codes": ["base", "ethereum"]
-    },
-    "output": {
-      "success": true,
-      "data": {
-        "pools": [
-          {
-            "id": "pool-123",
-            "llama_apy_pct": 5.2,
-            "llama_tvl_usd": 1000000,
-            "llama_stablecoin": true,
-            "network": "base"
-          }
-        ],
-        "total_found": 1,
-        "filters_applied": {
-          "min_apy": 0.03,
-          "min_tvl": 500000,
-          "stablecoin_only": true,
-          "network_codes": ["base", "ethereum"]
-        }
-      }
-    }
-  },
-  "get_pool_analytics": {
-    "description": "Get comprehensive analytics for specific pools",
-    "input": {
-      "pool_ids": ["pool-123"]
-    },
-    "output": {
-      "success": true,
-      "data": {
-        "analytics": [
-          {
-            "pool": {
-              "id": "pool-123",
-              "name": "USDC/USDT Pool",
-              "symbol": "USDC-USDT"
-            },
-            "llama_data": {
-              "llama_apy_pct": 5.2,
-              "llama_tvl_usd": 1000000
-            },
-            "combined_apy": 0.052,
-            "tvl_usd": 1000000
-          }
-        ],
-        "total_pools": 1
-      }
-    }
   }
 }