wayfinder-paths 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

wayfinder_paths/CONFIG_GUIDE.md

@@ -6,7 +6,9 @@ This guide explains how to configure your vault strategies for local testing.
 
 ```bash
 # 1. Generate test wallets (required!)
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault
+# Creates a main wallet (or use 'just create-strategy' which auto-creates wallets)
+just create-wallets
+# Or manually: poetry run python wayfinder_paths/scripts/make_wallets.py -n 1
 
 # 2. Create your config file
 cp wayfinder_paths/config.example.json config.json
@@ -25,11 +27,11 @@ cp wayfinder_paths/config.example.json config.json
     "username": "your_username",      // OPTIONAL: For OAuth authentication
     "password": "your_password",      // OPTIONAL: For OAuth authentication
     "refresh_token": null,            // OPTIONAL: Alternative to username/password
-    "api_key": "sk_live_abc123..."    // OPTIONAL: For service account authentication
+    "api_key": "sk_live_abc123..."    // OPTIONAL: For service account authentication (loaded directly by clients, not stored in UserConfig)
   },
   "system": {
     "api_base_url": "https://wayfinder.ai/api/v1",
-    "api_key": "sk_live_abc123...",   // OPTIONAL: System-level API key (alternative to user.api_key)
+    "api_key": "sk_live_abc123...",   // OPTIONAL: System-level API key (alternative to user.api_key, loaded directly by clients)
     "wallets_path": "wallets.json"    // Path to your generated wallets.json
   },
   "strategy": {
@@ -48,11 +50,13 @@ cp wayfinder_paths/config.example.json config.json
 **Authentication (choose one method):**
 
 **Option 1: Service Account (API Key) - Recommended for Production**
-- `user.api_key` - Your Wayfinder API key for service account authentication
-- OR `system.api_key` - System-level API key (alternative location)
+- `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.
+
 **Option 2: Personal Access (OAuth) - For Development**
 - `user.username` - Your Wayfinder backend username
 - `user.password` - Your Wayfinder backend password
@@ -93,24 +97,24 @@ Individual strategies may have their own configuration parameters. Check the str
 Use the built-in script to generate test wallets for local development:
 
 ```bash
-# Generate default and vault wallets (recommended)
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault
+# Generate main wallet (recommended for initial setup)
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 1
 
 # Add additional wallets for multi-account testing
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault -n 3
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 3
 
-# Replace existing wallets
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault --override
+# Create a wallet with a specific label (e.g., for a strategy)
+poetry run python wayfinder_paths/scripts/make_wallets.py --label "my_strategy_name"
 
 # Generate keystore files (for geth/web3 compatibility)
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault --keystore-password "your-password"
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 1 --keystore-password "your-password"
 ```
 
 This creates `wallets.json` in the repository root with:
-- **default** wallet - your main wallet for testing
-- Additional unlabeled wallets if specified
+- **main** wallet - your main wallet for testing (labeled "main")
+- Additional wallets with labels if specified
 
-**Note:** Generated wallets are for testing only. Wallet addresses are automatically loaded from `wallets.json` when not explicitly set in config.
+**Note:** Generated wallets are for testing only. Wallet addresses are automatically loaded from `wallets.json` when not explicitly set in config. Strategy-specific wallets are automatically created when you use `just create-strategy "Strategy Name"`.
 
 ## Per-Strategy Wallets
 
@@ -147,7 +151,7 @@ Wallets in `wallets.json` are stored with labels that match strategy directory n
   {
     "address": "0x...",
     "private_key_hex": "...",
-    "label": "default"
+    "label": "main"
   },
   {
     "address": "0x...",
@@ -235,7 +239,7 @@ No code changes are required - existing strategies continue to work.
 To use a custodial wallet provider (e.g., Privy, Turnkey), inject it directly into adapters:
 
 ```python
-from vaults.adapters.evm_transaction_adapter.adapter import EvmTransactionAdapter
+from adapters.evm_transaction_adapter.adapter import EvmTransactionAdapter
 from my_privy_integration import PrivyWalletProvider
 
 # Create your custom wallet provider
@@ -270,7 +274,7 @@ API keys provide service account authentication and are automatically discovered
 
 #### Option A: Strategy Constructor (Programmatic)
 ```python
-from wayfinder_paths.vaults.strategies.stablecoin_yield_strategy.strategy import StablecoinYieldStrategy
+from wayfinder_paths.strategies.stablecoin_yield_strategy.strategy import StablecoinYieldStrategy
 
 strategy = StablecoinYieldStrategy(
     config={...},
@@ -301,10 +305,11 @@ export WAYFINDER_API_KEY="sk_live_abc123..."
 - 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 `_load_config_credentials()`)
+  - `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
 
 ### 2. Personal Access Authentication (OAuth)
 

wayfinder_paths/{vaults/adapters → adapters}/balance_adapter/README.md

@@ -2,7 +2,7 @@
 
 Adapter that exposes wallet, token, and pool balances backed by `WalletClient`/`TokenClient` and now orchestrates transfers between the configured main/vault wallets (with ledger bookkeeping).
 
-- Entrypoint: `vaults.adapters.balance_adapter.adapter.BalanceAdapter`
+- Entrypoint: `adapters.balance_adapter.adapter.BalanceAdapter`
 - Manifest: `manifest.yaml`
 - Tests: `test_adapter.py`
 
@@ -14,7 +14,7 @@ The adapter declares both `wallet_read` and `wallet_transfer` capabilities in it
 
 ```python
 from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
-from wayfinder_paths.vaults.adapters.balance_adapter.adapter import BalanceAdapter
+from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
 
 web3_service = DefaultWeb3Service(config)
 balance = BalanceAdapter(config, web3_service=web3_service)

wayfinder_paths/{vaults/adapters → adapters}/balance_adapter/adapter.py

@@ -1,13 +1,13 @@
 from typing import Any
 
+from wayfinder_paths.adapters.ledger_adapter.adapter import LedgerAdapter
+from wayfinder_paths.adapters.token_adapter.adapter import TokenAdapter
 from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
 from wayfinder_paths.core.clients.TokenClient import TokenClient
 from wayfinder_paths.core.clients.WalletClient import WalletClient
 from wayfinder_paths.core.services.base import Web3Service
 from wayfinder_paths.core.settings import settings
 from wayfinder_paths.core.utils.evm_helpers import resolve_chain_id
-from wayfinder_paths.vaults.adapters.ledger_adapter.adapter import LedgerAdapter
-from wayfinder_paths.vaults.adapters.token_adapter.adapter import TokenAdapter
 
 
 class BalanceAdapter(BaseAdapter):

wayfinder_paths/{vaults/adapters → adapters}/balance_adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.balance_adapter.adapter.BalanceAdapter"
+entrypoint: "adapters.balance_adapter.adapter.BalanceAdapter"
 capabilities:
   - "wallet_read"
   - "wallet_transfer"

wayfinder_paths/{vaults/adapters → adapters}/balance_adapter/test_adapter.py

@@ -2,7 +2,7 @@ from unittest.mock import AsyncMock, patch
 
 import pytest
 
-from wayfinder_paths.vaults.adapters.balance_adapter.adapter import BalanceAdapter
+from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
 
 
 class TestBalanceAdapter:
@@ -21,19 +21,25 @@ class TestBalanceAdapter:
         return mock_client
 
     @pytest.fixture
-    def adapter(self, mock_wallet_client, mock_token_client):
+    def mock_web3_service(self):
+        """Mock TokenClient for testing"""
+        mock_client = AsyncMock()
+        return mock_client
+
+    @pytest.fixture
+    def adapter(self, mock_wallet_client, mock_token_client, mock_web3_service):
         """Create a BalanceAdapter instance with mocked clients for testing"""
         with (
             patch(
-                "wayfinder_paths.vaults.adapters.balance_adapter.adapter.WalletClient",
+                "wayfinder_paths.adapters.balance_adapter.adapter.WalletClient",
                 return_value=mock_wallet_client,
             ),
             patch(
-                "wayfinder_paths.vaults.adapters.balance_adapter.adapter.TokenClient",
+                "wayfinder_paths.adapters.balance_adapter.adapter.TokenClient",
                 return_value=mock_token_client,
             ),
         ):
-            return BalanceAdapter(config={})
+            return BalanceAdapter(config={}, web3_service=mock_web3_service)
 
     @pytest.mark.asyncio
     async def test_health_check(self, adapter):
@@ -68,7 +74,7 @@ class TestBalanceAdapter:
             return_value=(True, mock_response)
         )
 
-        success, data = await adapter.get_all_enriched_token_balances_for_wallet(
+        success, data = await adapter.get_all_balances(
             wallet_address="0x1234567890123456789012345678901234567890",
             enrich=True,
         )

wayfinder_paths/{vaults/adapters → adapters}/brap_adapter/README.md

@@ -26,7 +26,7 @@ The BRAPClient will automatically:
 
 ```python
 from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
-from wayfinder_paths.vaults.adapters.brap_adapter.adapter import BRAPAdapter
+from wayfinder_paths.adapters.brap_adapter.adapter import BRAPAdapter
 
 web3_service = DefaultWeb3Service(config)
 adapter = BRAPAdapter(web3_service=web3_service)

wayfinder_paths/{vaults/adapters → adapters}/brap_adapter/adapter.py

@@ -2,6 +2,8 @@ from typing import Any
 
 from eth_utils import to_checksum_address
 
+from wayfinder_paths.adapters.ledger_adapter.adapter import LedgerAdapter
+from wayfinder_paths.adapters.token_adapter.adapter import TokenAdapter
 from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
 from wayfinder_paths.core.clients.BRAPClient import BRAPClient
 from wayfinder_paths.core.clients.SimulationClient import SimulationClient
@@ -9,8 +11,6 @@ from wayfinder_paths.core.clients.TokenClient import TokenClient
 from wayfinder_paths.core.constants import DEFAULT_SLIPPAGE
 from wayfinder_paths.core.services.base import Web3Service
 from wayfinder_paths.core.settings import settings
-from wayfinder_paths.vaults.adapters.ledger_adapter.adapter import LedgerAdapter
-from wayfinder_paths.vaults.adapters.token_adapter.adapter import TokenAdapter
 
 _NEEDS_CLEAR_APPROVAL = {
     (1, "0xdac17f958d2ee523a2206206994597c13d831ec7"),

wayfinder_paths/{vaults/adapters → adapters}/brap_adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.brap_adapter.adapter.BRAPAdapter"
+entrypoint: "adapters.brap_adapter.adapter.BRAPAdapter"
 capabilities:
   - "swap.quote"
   - "swap.execute"

wayfinder_paths/{vaults/adapters → adapters}/brap_adapter/test_adapter.py

@@ -3,7 +3,7 @@ from unittest.mock import AsyncMock, patch
 
 import pytest
 
-from wayfinder_paths.vaults.adapters.brap_adapter.adapter import BRAPAdapter
+from wayfinder_paths.adapters.brap_adapter.adapter import BRAPAdapter
 
 
 class TestBRAPAdapter:
@@ -34,7 +34,7 @@ class TestBRAPAdapter:
     def adapter(self, mock_brap_client, mock_web3_service):
         """Create a BRAPAdapter instance with mocked client for testing"""
         with patch(
-            "vaults.adapters.brap_adapter.adapter.BRAPClient",
+            "adapters.brap_adapter.adapter.BRAPClient",
             return_value=mock_brap_client,
         ):
             return BRAPAdapter(web3_service=mock_web3_service)

wayfinder_paths/adapters/hyperlend_adapter/__init__.py

@@ -0,0 +1,7 @@
+"""
+Hyperlend Adapter
+"""
+
+from wayfinder_paths.adapters.hyperlend_adapter.adapter import HyperlendAdapter
+
+__all__ = ["HyperlendAdapter"]

wayfinder_paths/{vaults/adapters → adapters}/hyperlend_adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.hyperlend_adapter.adapter.HyperlendAdapter"
+entrypoint: "adapters.hyperlend_adapter.adapter.HyperlendAdapter"
 capabilities:
   - "hyperlend.stable_markets.read"
   - "hyperlend.markets.query"

wayfinder_paths/{vaults/adapters → adapters}/hyperlend_adapter/test_adapter.py

@@ -2,7 +2,7 @@ from unittest.mock import AsyncMock, patch
 
 import pytest
 
-from wayfinder_paths.vaults.adapters.hyperlend_adapter.adapter import HyperlendAdapter
+from wayfinder_paths.adapters.hyperlend_adapter.adapter import HyperlendAdapter
 
 
 class TestHyperlendAdapter:
@@ -18,7 +18,7 @@ class TestHyperlendAdapter:
     def adapter(self, mock_hyperlend_client):
         """Create a HyperlendAdapter instance with mocked client for testing"""
         with patch(
-            "wayfinder_paths.vaults.adapters.hyperlend_adapter.adapter.HyperlendClient",
+            "wayfinder_paths.adapters.hyperlend_adapter.adapter.HyperlendClient",
             return_value=mock_hyperlend_client,
         ):
             return HyperlendAdapter()

wayfinder_paths/{vaults/adapters → adapters}/ledger_adapter/README.md

@@ -25,7 +25,7 @@ The LedgerClient will automatically:
 ### Initialize the Adapter
 
 ```python
-from wayfinder_paths.vaults.adapters.ledger_adapter.adapter import LedgerAdapter
+from wayfinder_paths.adapters.ledger_adapter.adapter import LedgerAdapter
 
 # No configuration needed - uses LedgerClient with automatic settings
 adapter = LedgerAdapter()

wayfinder_paths/{vaults/adapters → adapters}/ledger_adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.ledger_adapter.adapter.LedgerAdapter"
+entrypoint: "adapters.ledger_adapter.adapter.LedgerAdapter"
 capabilities:
   - "ledger.read"
   - "ledger.write"

wayfinder_paths/{vaults/adapters → adapters}/ledger_adapter/test_adapter.py

@@ -2,7 +2,7 @@ from unittest.mock import AsyncMock, patch
 
 import pytest
 
-from wayfinder_paths.vaults.adapters.ledger_adapter.adapter import LedgerAdapter
+from wayfinder_paths.adapters.ledger_adapter.adapter import LedgerAdapter
 
 
 class TestLedgerAdapter:
@@ -18,7 +18,7 @@ class TestLedgerAdapter:
     def adapter(self, mock_ledger_client):
         """Create a LedgerAdapter instance with mocked client for testing"""
         with patch(
-            "vaults.adapters.ledger_adapter.adapter.LedgerClient",
+            "adapters.ledger_adapter.adapter.LedgerClient",
             return_value=mock_ledger_client,
         ):
             return LedgerAdapter()

wayfinder_paths/{vaults/adapters → adapters}/pool_adapter/README.md

@@ -24,7 +24,7 @@ The PoolClient will automatically:
 ### Initialize the Adapter
 
 ```python
-from wayfinder_paths.vaults.adapters.pool_adapter.adapter import PoolAdapter
+from wayfinder_paths.adapters.pool_adapter.adapter import PoolAdapter
 
 # No configuration needed - uses PoolClient with automatic settings
 adapter = PoolAdapter()

wayfinder_paths/{vaults/adapters → adapters}/pool_adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.pool_adapter.adapter.PoolAdapter"
+entrypoint: "adapters.pool_adapter.adapter.PoolAdapter"
 capabilities:
   - "pool.read"
   - "pool.analytics"

wayfinder_paths/{vaults/adapters → adapters}/pool_adapter/test_adapter.py

@@ -2,7 +2,7 @@ from unittest.mock import AsyncMock, patch
 
 import pytest
 
-from wayfinder_paths.vaults.adapters.pool_adapter.adapter import PoolAdapter
+from wayfinder_paths.adapters.pool_adapter.adapter import PoolAdapter
 
 
 class TestPoolAdapter:
@@ -18,7 +18,7 @@ class TestPoolAdapter:
     def adapter(self, mock_pool_client):
         """Create a PoolAdapter instance with mocked client for testing"""
         with patch(
-            "vaults.adapters.pool_adapter.adapter.PoolClient",
+            "adapters.pool_adapter.adapter.PoolClient",
             return_value=mock_pool_client,
         ):
             return PoolAdapter()

wayfinder_paths/{vaults/adapters → adapters}/token_adapter/README.md

@@ -20,7 +20,7 @@ The TokenClient will automatically:
 ### Initialize the Adapter
 
 ```python
-from wayfinder_paths.vaults.adapters.token_adapter.adapter import TokenAdapter
+from wayfinder_paths.adapters.token_adapter.adapter import TokenAdapter
 
 # No configuration needed - uses TokenClient with automatic settings
 adapter = TokenAdapter()

wayfinder_paths/adapters/token_adapter/examples.json

@@ -0,0 +1,26 @@
+{
+  "basic_usage": {
+    "description": "Basic usage of TokenAdapter to get token information",
+    "code": "from adapters.token_adapter.adapter import TokenAdapter\n\n# Initialize adapter (no config needed)\nadapter = TokenAdapter()\n\n# Get token by address\nsuccess, data = await adapter.get_token_by_address(\"0x1234567890abcdef1234567890abcdef12345678\")\nif success:\n    print(f\"Token symbol: {data.get('symbol')}\")\n    print(f\"Token name: {data.get('name')}\")\n    print(f\"Decimals: {data.get('decimals')}\")\nelse:\n    print(f\"Error: {data}\")"
+  },
+  "get_by_token_id": {
+    "description": "Get token information using token ID",
+    "code": "from adapters.token_adapter.adapter import TokenAdapter\n\n# Initialize adapter (no config needed)\nadapter = TokenAdapter()\n\n# Get token by ID\nsuccess, data = await adapter.get_token_by_id(\"token-12345\")\nif success:\n    print(f\"Token data: {data}\")\nelse:\n    print(f\"Error: {data}\")"
+  },
+  "flexible_lookup": {
+    "description": "Use flexible get_token method that tries both address and token_id",
+    "code": "from adapters.token_adapter.adapter import TokenAdapter\n\n# Initialize adapter (no config needed)\nadapter = TokenAdapter()\n\n# Try both address and token_id\nsuccess, data = await adapter.get_token(\n    address=\"0x1234567890abcdef1234567890abcdef12345678\",\n    token_id=\"token-12345\"\n)\nif success:\n    print(f\"Found token: {data}\")\nelse:\n    print(f\"Token not found: {data}\")"
+  },
+  "error_handling": {
+    "description": "Proper error handling for various scenarios",
+    "code": "from adapters.token_adapter.adapter import TokenAdapter\n\n# Initialize adapter (no config needed)\nadapter = TokenAdapter()\n\n# Handle missing parameters\ntry:\n    success, data = await adapter.get_token()\n    if not success:\n        print(f\"Error: {data}\")\nexcept Exception as e:\n    print(f\"Unexpected error: {e}\")\n\n# Handle API errors\nsuccess, data = await adapter.get_token_by_address(\"invalid-address\")\nif not success:\n    print(f\"API error: {data}\")\nelse:\n    print(f\"Token found: {data}\")"
+  },
+  "health_check": {
+    "description": "Check adapter health and connectivity",
+    "code": "from adapters.token_adapter.adapter import TokenAdapter\n\n# Initialize adapter (no config needed)\nadapter = TokenAdapter()\n\n# Check health\nhealth = await adapter.health_check()\nprint(f\"Adapter status: {health['status']}\")\nprint(f\"Connected: {health['connected']}\")\nprint(f\"Adapter type: {health['adapter']}\")\n\nif health['status'] == 'healthy':\n    print(\"Adapter is ready to use\")\nelse:\n    print(f\"Adapter has issues: {health.get('error', 'Unknown error')}\")"
+  },
+  "batch_operations": {
+    "description": "Perform multiple token lookups efficiently",
+    "code": "from adapters.token_adapter.adapter import TokenAdapter\nimport asyncio\n\n# Initialize adapter (no config needed)\nadapter = TokenAdapter()\n\n# List of token addresses to lookup\ntoken_addresses = [\n    \"0x1234567890abcdef1234567890abcdef12345678\",\n    \"0xabcdef1234567890abcdef1234567890abcdef12\",\n    \"0x9876543210fedcba9876543210fedcba98765432\"\n]\n\n# Batch lookup\ntoken_data = {}\nfor address in token_addresses:\n    success, data = await adapter.get_token_by_address(address)\n    if success:\n        token_data[address] = data\n    else:\n        print(f\"Failed to get token for {address}: {data}\")\n\nprint(f\"Successfully retrieved {len(token_data)} tokens\")\nfor address, data in token_data.items():\n    print(f\"{address}: {data.get('symbol', 'Unknown')} - {data.get('name', 'Unknown')}\")"
+  }
+}

wayfinder_paths/{vaults/adapters → adapters}/token_adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.token_adapter.adapter.TokenAdapter"
+entrypoint: "adapters.token_adapter.adapter.TokenAdapter"
 capabilities:
   - "token.read"
 dependencies:

wayfinder_paths/{vaults/adapters → adapters}/token_adapter/test_adapter.py

@@ -2,7 +2,7 @@ from unittest.mock import patch
 
 import pytest
 
-from wayfinder_paths.vaults.adapters.token_adapter.adapter import TokenAdapter
+from wayfinder_paths.adapters.token_adapter.adapter import TokenAdapter
 
 
 class TestTokenAdapter:

wayfinder_paths/config.example.json

@@ -2,10 +2,12 @@
     "user": {
       "username": "your_username",
       "password": "your_password",
-      "refresh_token": null
+      "refresh_token": null,
+      "api_key": "sk_live_abc123..."
     },
     "system": {
       "api_base_url": "https://wayfinder.ai/api/v1",
+      "api_key": "sk_live_abc123...",
       "wallets_path": "wallets.json"
     },
     "strategy": {

wayfinder_paths/core/engine/manifest.py

@@ -40,7 +40,7 @@ class StrategyManifest(BaseModel):
     schema_version: str = Field(default="0.1")
     entrypoint: str = Field(
         ...,
-        description="Python path to class, e.g. vaults.strategies.funding_rate_strategy.FundingRateStrategy",
+        description="Python path to class, e.g. strategies.funding_rate_strategy.FundingRateStrategy",
     )
     name: str | None = Field(
         default=None,

wayfinder_paths/{vaults/policies → policies}/enso.py

@@ -1,4 +1,4 @@
-from wayfinder_paths.vaults.policies.util import allow_functions
+from wayfinder_paths.policies.util import allow_functions
 
 ENSO_ROUTER = "0xf75584ef6673ad213a685a1b58cc0330b8ea22cf"
 

wayfinder_paths/{vaults/policies → policies}/hyper_evm.py

@@ -1,5 +1,5 @@
-from wayfinder_paths.vaults.policies.evm import native_transfer
-from wayfinder_paths.vaults.policies.util import allow_functions
+from wayfinder_paths.policies.evm import native_transfer
+from wayfinder_paths.policies.util import allow_functions
 
 WHYPE_TOKEN = "0x5555555555555555555555555555555555555555"
 HYPERCORE_SENTINEL_ADDRESS = "0x2222222222222222222222222222222222222222"

wayfinder_paths/{vaults/policies → policies}/hyperlend.py

@@ -1,4 +1,4 @@
-from wayfinder_paths.vaults.policies.util import allow_functions
+from wayfinder_paths.policies.util import allow_functions
 
 HYPERLEND_POOL = "0x00A89d7a5A02160f20150EbEA7a2b5E4879A1A8b"
 

wayfinder_paths/{vaults/policies → policies}/moonwell.py

@@ -1,4 +1,4 @@
-from wayfinder_paths.vaults.policies.util import allow_functions
+from wayfinder_paths.policies.util import allow_functions
 
 WETH = "0x4200000000000000000000000000000000000006"
 

wayfinder_paths/{vaults/policies → policies}/prjx.py

@@ -1,4 +1,4 @@
-from wayfinder_paths.vaults.policies.util import allow_functions
+from wayfinder_paths.policies.util import allow_functions
 
 PRJX_ROUTER = "0x1ebdfc75ffe3ba3de61e7138a3e8706ac841af9b"
 PRJX_NPM = "0xeAd19AE861c29bBb2101E834922B2FEee69B9091"

wayfinder_paths/run_strategy.py

@@ -28,7 +28,7 @@ def load_strategy(
     Dynamically load a strategy by name using its manifest
 
     Args:
-        strategy_name: Name of the strategy to load (directory name in vaults/strategies/)
+        strategy_name: Name of the strategy to load (directory name in strategies/)
         strategy_config: Configuration dict for the strategy
         simulation: Enable simulation mode for testing
         api_key: Optional API key for service account authentication
@@ -37,7 +37,7 @@ def load_strategy(
         Strategy instance
     """
     # Find strategy manifest by scanning for manifest.yaml in the strategy directory
-    strategies_dir = Path(__file__).parent / "vaults" / "strategies"
+    strategies_dir = Path(__file__).parent / "strategies"
     strategy_dir = strategies_dir / strategy_name
     manifest_path = strategy_dir / "manifest.yaml"
 
@@ -120,7 +120,7 @@ async def run_strategy(
             # Extract directory name from manifest path for wallet lookup
             # Use the directory name (strategy identifier) for wallet lookup
             manifest_dir = Path(manifest_path).parent
-            strategies_dir = Path(__file__).parent / "vaults" / "strategies"
+            strategies_dir = Path(__file__).parent / "strategies"
             try:
                 # Try to get relative path - if it's under strategies_dir, use directory name
                 rel_path = manifest_dir.relative_to(strategies_dir)

wayfinder_paths/scripts/create_strategy.py

@@ -64,13 +64,13 @@ def main():
     parser.add_argument(
         "--template-dir",
         type=Path,
-        default=Path(__file__).parent.parent / "vaults" / "templates" / "strategy",
+        default=Path(__file__).parent.parent / "templates" / "strategy",
         help="Path to strategy template directory",
     )
     parser.add_argument(
         "--strategies-dir",
         type=Path,
-        default=Path(__file__).parent.parent / "vaults" / "strategies",
+        default=Path(__file__).parent.parent / "strategies",
         help="Path to strategies directory",
     )
     parser.add_argument(
@@ -136,7 +136,7 @@ def main():
         print(f"  Updated strategy.py with class name: {class_name}")
 
     # Generate entrypoint path
-    entrypoint = f"vaults.strategies.{dir_name}.strategy.{class_name}"
+    entrypoint = f"strategies.{dir_name}.strategy.{class_name}"
 
     # Update manifest with name (using directory name) and entrypoint
     manifest_path = strategy_dir / "manifest.yaml"

wayfinder_paths/scripts/validate_manifests.py

@@ -138,7 +138,7 @@ def validate_strategy_manifest(manifest_path: str) -> tuple[bool, list[str]]:
 def find_adapter_manifests() -> list[Path]:
     """Find all adapter manifest files."""
     manifests = []
-    adapter_dir = Path(__file__).parent.parent / "vaults" / "adapters"
+    adapter_dir = Path(__file__).parent.parent / "adapters"
     if adapter_dir.exists():
         for adapter_path in adapter_dir.iterdir():
             manifest_path = adapter_path / "manifest.yaml"
@@ -150,7 +150,7 @@ def find_adapter_manifests() -> list[Path]:
 def find_strategy_manifests() -> list[Path]:
     """Find all strategy manifest files."""
     manifests = []
-    strategy_dir = Path(__file__).parent.parent / "vaults" / "strategies"
+    strategy_dir = Path(__file__).parent.parent / "strategies"
     if strategy_dir.exists():
         for strategy_path in strategy_dir.iterdir():
             manifest_path = strategy_path / "manifest.yaml"

wayfinder_paths/{vaults/strategies → strategies}/hyperlend_stable_yield_strategy/README.md

@@ -1,6 +1,6 @@
 # Hyperlend Stable Yield Strategy
 
-- Entrypoint: `vaults.strategies.hyperlend_stable_yield_strategy.strategy.HyperlendStableYieldStrategy`
+- Entrypoint: `strategies.hyperlend_stable_yield_strategy.strategy.HyperlendStableYieldStrategy`
 - Manifest: `manifest.yaml`
 - Examples: `examples.json`
 - Tests: `test_strategy.py`
@@ -75,8 +75,9 @@ The manifest policy simply locks transactions to the vault wallet ID:
 # Install dependencies
 poetry install
 
-# Generate default + vault wallets (writes wallets.json)
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault
+# Generate main wallet (writes wallets.json)
+# Creates a main wallet (or use 'just create-strategy' which auto-creates wallets)
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 1
 
 # Copy config and edit credentials (or rely on env vars)
 cp wayfinder_paths/config.example.json config.json

wayfinder_paths/{vaults/strategies → strategies}/hyperlend_stable_yield_strategy/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.strategies.hyperlend_stable_yield_strategy.strategy.HyperlendStableYieldStrategy"
+entrypoint: "strategies.hyperlend_stable_yield_strategy.strategy.HyperlendStableYieldStrategy"
 permissions:
   policy: "(wallet.id == 'FORMAT_WALLET_ID')"
 adapters: