wayfinder-paths 0.1.7__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,
@@ -147,8 +140,7 @@ class BRAPAdapter(BaseAdapter):
             )
 
             # Extract best quote from response
-            quotes = data.get("quotes", {})
-            best_quote = quotes.get("best_quote")
+            best_quote = data["best_route"]
 
             if not best_quote:
                 return (False, "No quotes available")
@@ -368,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
         )
@@ -678,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/brap_adapter/test_adapter.py

@@ -81,12 +81,10 @@ class TestBRAPAdapter:
     async def test_get_best_quote_success(self, adapter, mock_brap_client):
         """Test successful best quote retrieval"""
         mock_response = {
-            "quotes": {
-                "best_quote": {
-                    "input_amount": "1000000000000000000",
-                    "output_amount": "995000000000000000",
-                    "total_fee": "8000000000000000",
-                }
+            "best_route": {
+                "input_amount": "1000000000000000000",
+                "output_amount": "995000000000000000",
+                "total_fee": "8000000000000000",
             }
         }
         mock_brap_client.get_quote = AsyncMock(return_value=mock_response)
@@ -108,7 +106,7 @@ class TestBRAPAdapter:
     @pytest.mark.asyncio
     async def test_get_best_quote_no_quotes(self, adapter, mock_brap_client):
         """Test best quote retrieval when no quotes available"""
-        mock_response = {"quotes": {}}
+        mock_response = {"best_route": None}
         mock_brap_client.get_quote = AsyncMock(return_value=mock_response)
 
         success, data = await adapter.get_best_quote(

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/ledger_adapter/test_adapter.py

@@ -159,12 +159,15 @@ class TestLedgerAdapter:
 
         # Test
         operation_data = SWAP(
+            adapter="TestAdapter",
             from_token_id="0xA0b86a33E6441c8C06DdD4D4c4c4c4c4c4c4c4c4c",
             to_token_id="0xB1c97a44F7552d9Dd5e5e5e5e5e5e5e5e5e5e5e5e5e",
             from_amount="1000000000000000000",
             to_amount="995000000000000000",
             from_amount_usd=1000.0,
             to_amount_usd=995.0,
+            transaction_hash="0x123abc",
+            transaction_chain_id=8453,
         )
 
         success, data = await adapter.record_operation(

wayfinder_paths/adapters/pool_adapter/README.md

@@ -15,8 +15,9 @@ A Wayfinder adapter that provides high-level operations for DeFi pool data and a
 The adapter uses the PoolClient which automatically handles authentication and API configuration through the Wayfinder settings. No additional configuration is required.
 
 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
@@ -44,68 +45,6 @@ else:
     print(f"Error: {data}")
 ```
 
-### Get All Pools
-
-```python
-success, data = await adapter.get_all_pools(merge_external=False)
-if success:
-    pools = data.get("pools", [])
-    print(f"Total pools available: {len(pools)}")
-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}")
-```
-
-### Search Pools
-
-```python
-success, data = await adapter.search_pools(
-    query="USDC",
-    limit=10
-)
-if success:
-    pools = data.get("pools", [])
-    print(f"Found {len(pools)} pools matching 'USDC'")
-    for pool in pools:
-        print(f"Pool: {pool.get('name')} - {pool.get('symbol')}")
-else:
-    print(f"Error: {data}")
-```
-
 ### Get Llama Matches
 
 ```python
@@ -136,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:
@@ -189,6 +87,7 @@ The adapter uses the following Wayfinder API endpoints:
 ## Error Handling
 
 All methods return a tuple of `(success: bool, data: Any)` where:
+
 - `success` is `True` if the operation succeeded
 - `data` contains the response data on success or error message on failure