wayfinder-paths 0.1.4__tar.gz → 0.1.6__tar.gz

{wayfinder_paths-0.1.4 → wayfinder_paths-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wayfinder-paths
-Version: 0.1.4
+Version: 0.1.6
 Summary: Wayfinder Path: strategies and adapters
 Author: Wayfinder
 Author-email: dev@wayfinder.ai
@@ -20,13 +20,13 @@ Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
 Requires-Dist: web3 (>=7.13.0,<8.0.0)
 Description-Content-Type: text/markdown
 
-# 🔐 Wayfinder Vaults
+# 🔐 Wayfinder Paths
 
 [![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/)
 [![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](https://www.docker.com/)
 [![Discord](https://img.shields.io/badge/discord-join-7289da.svg)](https://discord.gg/fUVwGMXjm3)
 
-Open-source platform for community-contributed crypto trading strategies and adapters. Build, test, and deploy automated trading vaults with direct wallet integration.
+Open-source platform for community-contributed crypto trading strategies and adapters. Build, test, and deploy automated trading strategies with direct wallet integration.
 
 ## 🚀 Quick Start
 
@@ -68,27 +68,26 @@ wayfinder_paths/
 │   ├── core/                      # Core engine (maintained by team)
 │   │   ├── clients/              # API client managers
 │   │   ├── adapters/             # Base adapter interfaces
-│   │   ├── engine/               # Trading engine & VaultJob
+│   │   ├── engine/               # Trading engine & StrategyJob
 │   │   ├── strategies/           # Base strategy classes
 │   │   └── config.py             # Configuration system
-│   ├── vaults/                   # Community contributions (each artifact in its own folder)
-│   │   ├── adapters/             # Your exchange/protocol integrations
-│   │   │   ├── balance_adapter/
-│   │   │   │   ├── adapter.py        # Adapter implementation
-│   │   │   │   ├── manifest.yaml     # Adapter manifest (caps, entrypoint)
-│   │   │   │   ├── examples.json     # Example inputs for smoke
-│   │   │   │   ├── README.md         # Local notes
-│   │   │   │   └── test_adapter.py   # Local smoke test
-│   │   │   ├── brap_adapter/
-│   │   │   └── ...
-│   │   └── strategies/           # Your trading strategies
-│   │       ├── stablecoin_yield_strategy/
-│   │       │   ├── strategy.py       # Strategy implementation
-│   │       │   ├── manifest.yaml     # Strategy manifest
-│   │       │   ├── examples.json     # Example inputs
-│   │       │   ├── README.md         # Local notes
-│   │       │   └── test_strategy.py  # Local smoke test
-│   │       └── ...
+│   ├── adapters/                 # Your exchange/protocol integrations (community contributions)
+│   │   ├── balance_adapter/
+│   │   │   ├── adapter.py        # Adapter implementation
+│   │   │   ├── manifest.yaml     # Adapter manifest (caps, entrypoint)
+│   │   │   ├── examples.json     # Example inputs for smoke
+│   │   │   ├── README.md         # Local notes
+│   │   │   └── test_adapter.py   # Local smoke test
+│   │   ├── brap_adapter/
+│   │   └── ...
+│   ├── strategies/               # Your trading strategies (community contributions)
+│   │   ├── stablecoin_yield_strategy/
+│   │   │   ├── strategy.py       # Strategy implementation
+│   │   │   ├── manifest.yaml     # Strategy manifest
+│   │   │   ├── examples.json     # Example inputs
+│   │   │   ├── README.md         # Local notes
+│   │   │   └── test_strategy.py  # Local smoke test
+│   │   └── ...
 │   ├── tests/                    # Test suite
 │   ├── CONFIG_GUIDE.md           # Configuration documentation
 │   ├── config.example.json       # Example configuration
@@ -109,8 +108,8 @@ We welcome contributions! This is an open-source project where community members
 1. **Fork the repository** and clone your fork
 2. **Create a feature branch**: `git checkout -b feature/my-strategy`
 3. **Copy a template** to get started:
-   - **For adapters**: Copy `wayfinder_paths/vaults/templates/adapter/` to `wayfinder_paths/vaults/adapters/my_adapter/`
-   - **For strategies**: Copy `wayfinder_paths/vaults/templates/strategy/` to `wayfinder_paths/vaults/strategies/my_strategy/`
+   - **For adapters**: Copy `wayfinder_paths/templates/adapter/` to `wayfinder_paths/adapters/my_adapter/`
+   - **For strategies**: Copy `wayfinder_paths/templates/strategy/` to `wayfinder_paths/strategies/my_strategy/`
 4. **Customize** the template (rename classes, update manifest, implement methods)
 5. **Test your code** thoroughly using the provided test framework
 6. **Validate manifests**: Run `just validate-manifests`
@@ -125,9 +124,9 @@ We welcome contributions! This is an open-source project where community members
 ### Contributor Guidelines
 
 #### For Adapters
-- **Start from the template**: Copy `wayfinder_paths/vaults/templates/adapter/` as a starting point
+- **Start from the template**: Copy `wayfinder_paths/templates/adapter/` as a starting point
 - Extend `BaseAdapter` from `wayfinder_paths/core/adapters/BaseAdapter.py`
-- Create a `manifest.yaml` (template at `wayfinder_paths/vaults/templates/adapter/manifest.yaml`) with:
+- Create a `manifest.yaml` (template at `wayfinder_paths/templates/adapter/manifest.yaml`) with:
   - `entrypoint`: Full import path to your adapter class
   - `capabilities`: List of capabilities your adapter provides
   - `dependencies`: List of required client classes (e.g., `PoolClient`, `TokenClient`)
@@ -138,9 +137,9 @@ We welcome contributions! This is an open-source project where community members
 - Validate your manifest: `just validate-manifests`
 
 #### For Strategies
-- **Start from the template**: Use `just create-strategy "Strategy Name"` to create a new strategy with its own wallet, or copy `wayfinder_paths/vaults/templates/strategy/` manually
+- **Start from the template**: Use `just create-strategy "Strategy Name"` to create a new strategy with its own wallet, or copy `wayfinder_paths/templates/strategy/` manually
 - Extend `Strategy` from `wayfinder_paths/core/strategies/Strategy.py`
-- Create a `manifest.yaml` (template at `wayfinder_paths/vaults/templates/strategy/manifest.yaml`) with:
+- Create a `manifest.yaml` (template at `wayfinder_paths/templates/strategy/manifest.yaml`) with:
   - `entrypoint`: Full import path to your strategy class
   - `name`: Strategy directory name (used for wallet lookup)
   - `permissions.policy`: Security policy for transaction permissions
@@ -177,9 +176,9 @@ just create-strategy "My Strategy Name"
 
 # Or manually copy a template:
 # For adapters:
-cp -r wayfinder_paths/vaults/templates/adapter wayfinder_paths/vaults/adapters/my_adapter
+cp -r wayfinder_paths/templates/adapter wayfinder_paths/adapters/my_adapter
 # For strategies:
-cp -r wayfinder_paths/vaults/templates/strategy wayfinder_paths/vaults/strategies/my_strategy
+cp -r wayfinder_paths/templates/strategy wayfinder_paths/strategies/my_strategy
 
 # 5. Customize the template (see template README.md files for details)
 
@@ -190,8 +189,8 @@ just validate-manifests
 poetry run pytest -k smoke -v
 
 # Or test your specific contribution
-poetry run pytest wayfinder_paths/vaults/strategies/your_strategy/ -v
-poetry run pytest wayfinder_paths/vaults/adapters/your_adapter/ -v
+poetry run pytest wayfinder_paths/strategies/your_strategy/ -v
+poetry run pytest wayfinder_paths/adapters/your_adapter/ -v
 
 # 8. Test your contribution locally
 poetry run python wayfinder_paths/run_strategy.py your_strategy --action status
@@ -228,7 +227,7 @@ Every adapter and strategy requires a `manifest.yaml` file that declares its met
 
 Adapter manifests declare the capabilities an adapter provides and the clients it depends on.
 
-**Template:** Copy `wayfinder_paths/vaults/templates/adapter/manifest.yaml` as a starting point.
+**Template:** Copy `wayfinder_paths/templates/adapter/manifest.yaml` as a starting point.
 
 **Schema:**
 ```yaml
@@ -248,7 +247,7 @@ dependencies:
 - `capabilities`: List of abstract capabilities this adapter provides (required, non-empty)
 - `dependencies`: List of client class names from `core.clients` that this adapter requires (required, non-empty)
 
-**Example** (`vaults/adapters/pool_adapter/manifest.yaml`):
+**Example** (`wayfinder_paths/adapters/pool_adapter/manifest.yaml`):
 ```yaml
 schema_version: "0.1"
 entrypoint: "adapters.pool_adapter.adapter.PoolAdapter"
@@ -266,7 +265,7 @@ dependencies:
 
 Strategy manifests declare permissions and required adapters with their capabilities.
 
-**Template:** Copy `wayfinder_paths/vaults/templates/strategy/manifest.yaml` as a starting point.
+**Template:** Copy `wayfinder_paths/templates/strategy/manifest.yaml` as a starting point.
 
 **Schema:**
 ```yaml
@@ -290,7 +289,7 @@ adapters:
   - `name`: Adapter type identifier (e.g., "POOL", "BRAP")
   - `capabilities`: List of capabilities required from this adapter
 
-**Example** (`vaults/strategies/stablecoin_yield_strategy/manifest.yaml`):
+**Example** (`wayfinder_paths/strategies/stablecoin_yield_strategy/manifest.yaml`):
 ```yaml
 schema_version: "0.1"
 entrypoint: "strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy"
@@ -357,8 +356,8 @@ For each manifest file:
 ```
 
 The script automatically discovers all manifests by scanning:
-- `wayfinder_paths/vaults/adapters/*/manifest.yaml` for adapter manifests
-- `wayfinder_paths/vaults/strategies/*/manifest.yaml` for strategy manifests
+- `wayfinder_paths/adapters/*/manifest.yaml` for adapter manifests
+- `wayfinder_paths/strategies/*/manifest.yaml` for strategy manifests
 
 All errors are collected and reported at the end, with the script exiting with code 1 if any validation fails.
 
@@ -381,7 +380,7 @@ See [CONFIG_GUIDE.md](wayfinder_paths/CONFIG_GUIDE.md) for details.
 
 ### Authentication
 
-Wayfinder Vaults supports two authentication methods:
+Wayfinder Paths supports two authentication methods:
 
 #### 1. Service Account Authentication (API Key)
 For backend services and automated systems with higher rate limits:
@@ -445,7 +444,7 @@ See [CONFIG_GUIDE.md](wayfinder_paths/CONFIG_GUIDE.md) for detailed authenticati
 Adapters connect to exchanges and DeFi protocols using the client system.
 
 ```python
-# wayfinder_paths/vaults/adapters/my_adapter/adapter.py
+# wayfinder_paths/adapters/my_adapter/adapter.py
 from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
 from wayfinder_paths.core.clients.PoolClient import PoolClient
 
@@ -475,7 +474,7 @@ class MyAdapter(BaseAdapter):
 Strategies implement trading logic using adapters and the unified client system.
 
 ```python
-# wayfinder_paths/vaults/strategies/my_strategy/strategy.py
+# wayfinder_paths/strategies/my_strategy/strategy.py
 from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
 from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
 from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
@@ -501,7 +500,7 @@ class MyStrategy(Strategy):
     async def deposit(
         self, main_token_amount: float = 0.0, gas_token_amount: float = 0.0
     ) -> StatusTuple:
-        """Move funds from main wallet into the vault wallet."""
+        """Move funds from main wallet into the strategy wallet."""
         if main_token_amount <= 0:
             return (False, "Nothing to deposit")
 
@@ -524,7 +523,7 @@ class MyStrategy(Strategy):
         """Report balances back to the runner"""
         success, balance = await self.balance_adapter.get_balance(
             token_id=self.config.get("token_id"),
-            wallet_address=self.config.get("vault_wallet", {}).get("address"),
+            wallet_address=self.config.get("strategy_wallet", {}).get("address"),
         )
         return {
             "portfolio_value": float(balance or 0),
@@ -535,10 +534,10 @@ class MyStrategy(Strategy):
 
 ### Built-in adapters
 
-- **BALANCE (BalanceAdapter)**: wraps `WalletClient`/`TokenClient` to read wallet, token, and pool balances and now orchestrates transfers between the main/vault wallets with ledger bookkeeping. Requires a `Web3Service` so it can share the same wallet provider as the strategy.
+- **BALANCE (BalanceAdapter)**: wraps `WalletClient`/`TokenClient` to read wallet, token, and pool balances and now orchestrates transfers between the main/strategy wallets with ledger bookkeeping. Requires a `Web3Service` so it can share the same wallet provider as the strategy.
 - **POOL (PoolAdapter)**: composes `PoolClient` to fetch pools, llama analytics, combined reports, high-yield searches, and search helpers.
 - **BRAP (BRAPAdapter)**: integrates the cross-chain quote service for swaps/bridges, including fee breakdowns, route comparisons, validation helpers, and swap execution/ledger recording when provided a `Web3Service`.
-- **LEDGER (LedgerAdapter)**: records deposits, withdrawals, custom operations, and cashflows via `LedgerClient`, and can read vault transaction summaries.
+- **LEDGER (LedgerAdapter)**: records deposits, withdrawals, custom operations, and cashflows via `LedgerClient`, and can read strategy transaction summaries.
 - **TOKEN (TokenAdapter)**: lightweight wrapper around `TokenClient` for token metadata, live price snapshots, and gas token lookups.
 - **HYPERLEND (HyperlendAdapter)**: connects to `HyperlendClient` for lending/supply caps inside the HyperLend strategy.
 
@@ -560,8 +559,8 @@ just create-wallets
 poetry run pytest -k smoke -v
 
 # 3. Test your specific contribution
-poetry run pytest wayfinder_paths/vaults/strategies/my_strategy/ -v     # Strategy
-poetry run pytest wayfinder_paths/vaults/adapters/my_adapter/ -v       # Adapter
+poetry run pytest wayfinder_paths/strategies/my_strategy/ -v     # Strategy
+poetry run pytest wayfinder_paths/adapters/my_adapter/ -v       # Adapter
 ```
 
 ### Testing Your Contribution

{wayfinder_paths-0.1.4 → wayfinder_paths-0.1.6}/README.md

@@ -1,10 +1,10 @@
-# 🔐 Wayfinder Vaults
+# 🔐 Wayfinder Paths
 
 [![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/)
 [![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](https://www.docker.com/)
 [![Discord](https://img.shields.io/badge/discord-join-7289da.svg)](https://discord.gg/fUVwGMXjm3)
 
-Open-source platform for community-contributed crypto trading strategies and adapters. Build, test, and deploy automated trading vaults with direct wallet integration.
+Open-source platform for community-contributed crypto trading strategies and adapters. Build, test, and deploy automated trading strategies with direct wallet integration.
 
 ## 🚀 Quick Start
 
@@ -46,27 +46,26 @@ wayfinder_paths/
 │   ├── core/                      # Core engine (maintained by team)
 │   │   ├── clients/              # API client managers
 │   │   ├── adapters/             # Base adapter interfaces
-│   │   ├── engine/               # Trading engine & VaultJob
+│   │   ├── engine/               # Trading engine & StrategyJob
 │   │   ├── strategies/           # Base strategy classes
 │   │   └── config.py             # Configuration system
-│   ├── vaults/                   # Community contributions (each artifact in its own folder)
-│   │   ├── adapters/             # Your exchange/protocol integrations
-│   │   │   ├── balance_adapter/
-│   │   │   │   ├── adapter.py        # Adapter implementation
-│   │   │   │   ├── manifest.yaml     # Adapter manifest (caps, entrypoint)
-│   │   │   │   ├── examples.json     # Example inputs for smoke
-│   │   │   │   ├── README.md         # Local notes
-│   │   │   │   └── test_adapter.py   # Local smoke test
-│   │   │   ├── brap_adapter/
-│   │   │   └── ...
-│   │   └── strategies/           # Your trading strategies
-│   │       ├── stablecoin_yield_strategy/
-│   │       │   ├── strategy.py       # Strategy implementation
-│   │       │   ├── manifest.yaml     # Strategy manifest
-│   │       │   ├── examples.json     # Example inputs
-│   │       │   ├── README.md         # Local notes
-│   │       │   └── test_strategy.py  # Local smoke test
-│   │       └── ...
+│   ├── adapters/                 # Your exchange/protocol integrations (community contributions)
+│   │   ├── balance_adapter/
+│   │   │   ├── adapter.py        # Adapter implementation
+│   │   │   ├── manifest.yaml     # Adapter manifest (caps, entrypoint)
+│   │   │   ├── examples.json     # Example inputs for smoke
+│   │   │   ├── README.md         # Local notes
+│   │   │   └── test_adapter.py   # Local smoke test
+│   │   ├── brap_adapter/
+│   │   └── ...
+│   ├── strategies/               # Your trading strategies (community contributions)
+│   │   ├── stablecoin_yield_strategy/
+│   │   │   ├── strategy.py       # Strategy implementation
+│   │   │   ├── manifest.yaml     # Strategy manifest
+│   │   │   ├── examples.json     # Example inputs
+│   │   │   ├── README.md         # Local notes
+│   │   │   └── test_strategy.py  # Local smoke test
+│   │   └── ...
 │   ├── tests/                    # Test suite
 │   ├── CONFIG_GUIDE.md           # Configuration documentation
 │   ├── config.example.json       # Example configuration
@@ -87,8 +86,8 @@ We welcome contributions! This is an open-source project where community members
 1. **Fork the repository** and clone your fork
 2. **Create a feature branch**: `git checkout -b feature/my-strategy`
 3. **Copy a template** to get started:
-   - **For adapters**: Copy `wayfinder_paths/vaults/templates/adapter/` to `wayfinder_paths/vaults/adapters/my_adapter/`
-   - **For strategies**: Copy `wayfinder_paths/vaults/templates/strategy/` to `wayfinder_paths/vaults/strategies/my_strategy/`
+   - **For adapters**: Copy `wayfinder_paths/templates/adapter/` to `wayfinder_paths/adapters/my_adapter/`
+   - **For strategies**: Copy `wayfinder_paths/templates/strategy/` to `wayfinder_paths/strategies/my_strategy/`
 4. **Customize** the template (rename classes, update manifest, implement methods)
 5. **Test your code** thoroughly using the provided test framework
 6. **Validate manifests**: Run `just validate-manifests`
@@ -103,9 +102,9 @@ We welcome contributions! This is an open-source project where community members
 ### Contributor Guidelines
 
 #### For Adapters
-- **Start from the template**: Copy `wayfinder_paths/vaults/templates/adapter/` as a starting point
+- **Start from the template**: Copy `wayfinder_paths/templates/adapter/` as a starting point
 - Extend `BaseAdapter` from `wayfinder_paths/core/adapters/BaseAdapter.py`
-- Create a `manifest.yaml` (template at `wayfinder_paths/vaults/templates/adapter/manifest.yaml`) with:
+- Create a `manifest.yaml` (template at `wayfinder_paths/templates/adapter/manifest.yaml`) with:
   - `entrypoint`: Full import path to your adapter class
   - `capabilities`: List of capabilities your adapter provides
   - `dependencies`: List of required client classes (e.g., `PoolClient`, `TokenClient`)
@@ -116,9 +115,9 @@ We welcome contributions! This is an open-source project where community members
 - Validate your manifest: `just validate-manifests`
 
 #### For Strategies
-- **Start from the template**: Use `just create-strategy "Strategy Name"` to create a new strategy with its own wallet, or copy `wayfinder_paths/vaults/templates/strategy/` manually
+- **Start from the template**: Use `just create-strategy "Strategy Name"` to create a new strategy with its own wallet, or copy `wayfinder_paths/templates/strategy/` manually
 - Extend `Strategy` from `wayfinder_paths/core/strategies/Strategy.py`
-- Create a `manifest.yaml` (template at `wayfinder_paths/vaults/templates/strategy/manifest.yaml`) with:
+- Create a `manifest.yaml` (template at `wayfinder_paths/templates/strategy/manifest.yaml`) with:
   - `entrypoint`: Full import path to your strategy class
   - `name`: Strategy directory name (used for wallet lookup)
   - `permissions.policy`: Security policy for transaction permissions
@@ -155,9 +154,9 @@ just create-strategy "My Strategy Name"
 
 # Or manually copy a template:
 # For adapters:
-cp -r wayfinder_paths/vaults/templates/adapter wayfinder_paths/vaults/adapters/my_adapter
+cp -r wayfinder_paths/templates/adapter wayfinder_paths/adapters/my_adapter
 # For strategies:
-cp -r wayfinder_paths/vaults/templates/strategy wayfinder_paths/vaults/strategies/my_strategy
+cp -r wayfinder_paths/templates/strategy wayfinder_paths/strategies/my_strategy
 
 # 5. Customize the template (see template README.md files for details)
 
@@ -168,8 +167,8 @@ just validate-manifests
 poetry run pytest -k smoke -v
 
 # Or test your specific contribution
-poetry run pytest wayfinder_paths/vaults/strategies/your_strategy/ -v
-poetry run pytest wayfinder_paths/vaults/adapters/your_adapter/ -v
+poetry run pytest wayfinder_paths/strategies/your_strategy/ -v
+poetry run pytest wayfinder_paths/adapters/your_adapter/ -v
 
 # 8. Test your contribution locally
 poetry run python wayfinder_paths/run_strategy.py your_strategy --action status
@@ -206,7 +205,7 @@ Every adapter and strategy requires a `manifest.yaml` file that declares its met
 
 Adapter manifests declare the capabilities an adapter provides and the clients it depends on.
 
-**Template:** Copy `wayfinder_paths/vaults/templates/adapter/manifest.yaml` as a starting point.
+**Template:** Copy `wayfinder_paths/templates/adapter/manifest.yaml` as a starting point.
 
 **Schema:**
 ```yaml
@@ -226,7 +225,7 @@ dependencies:
 - `capabilities`: List of abstract capabilities this adapter provides (required, non-empty)
 - `dependencies`: List of client class names from `core.clients` that this adapter requires (required, non-empty)
 
-**Example** (`vaults/adapters/pool_adapter/manifest.yaml`):
+**Example** (`wayfinder_paths/adapters/pool_adapter/manifest.yaml`):
 ```yaml
 schema_version: "0.1"
 entrypoint: "adapters.pool_adapter.adapter.PoolAdapter"
@@ -244,7 +243,7 @@ dependencies:
 
 Strategy manifests declare permissions and required adapters with their capabilities.
 
-**Template:** Copy `wayfinder_paths/vaults/templates/strategy/manifest.yaml` as a starting point.
+**Template:** Copy `wayfinder_paths/templates/strategy/manifest.yaml` as a starting point.
 
 **Schema:**
 ```yaml
@@ -268,7 +267,7 @@ adapters:
   - `name`: Adapter type identifier (e.g., "POOL", "BRAP")
   - `capabilities`: List of capabilities required from this adapter
 
-**Example** (`vaults/strategies/stablecoin_yield_strategy/manifest.yaml`):
+**Example** (`wayfinder_paths/strategies/stablecoin_yield_strategy/manifest.yaml`):
 ```yaml
 schema_version: "0.1"
 entrypoint: "strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy"
@@ -335,8 +334,8 @@ For each manifest file:
 ```
 
 The script automatically discovers all manifests by scanning:
-- `wayfinder_paths/vaults/adapters/*/manifest.yaml` for adapter manifests
-- `wayfinder_paths/vaults/strategies/*/manifest.yaml` for strategy manifests
+- `wayfinder_paths/adapters/*/manifest.yaml` for adapter manifests
+- `wayfinder_paths/strategies/*/manifest.yaml` for strategy manifests
 
 All errors are collected and reported at the end, with the script exiting with code 1 if any validation fails.
 
@@ -359,7 +358,7 @@ See [CONFIG_GUIDE.md](wayfinder_paths/CONFIG_GUIDE.md) for details.
 
 ### Authentication
 
-Wayfinder Vaults supports two authentication methods:
+Wayfinder Paths supports two authentication methods:
 
 #### 1. Service Account Authentication (API Key)
 For backend services and automated systems with higher rate limits:
@@ -423,7 +422,7 @@ See [CONFIG_GUIDE.md](wayfinder_paths/CONFIG_GUIDE.md) for detailed authenticati
 Adapters connect to exchanges and DeFi protocols using the client system.
 
 ```python
-# wayfinder_paths/vaults/adapters/my_adapter/adapter.py
+# wayfinder_paths/adapters/my_adapter/adapter.py
 from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
 from wayfinder_paths.core.clients.PoolClient import PoolClient
 
@@ -453,7 +452,7 @@ class MyAdapter(BaseAdapter):
 Strategies implement trading logic using adapters and the unified client system.
 
 ```python
-# wayfinder_paths/vaults/strategies/my_strategy/strategy.py
+# wayfinder_paths/strategies/my_strategy/strategy.py
 from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
 from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
 from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
@@ -479,7 +478,7 @@ class MyStrategy(Strategy):
     async def deposit(
         self, main_token_amount: float = 0.0, gas_token_amount: float = 0.0
     ) -> StatusTuple:
-        """Move funds from main wallet into the vault wallet."""
+        """Move funds from main wallet into the strategy wallet."""
         if main_token_amount <= 0:
             return (False, "Nothing to deposit")
 
@@ -502,7 +501,7 @@ class MyStrategy(Strategy):
         """Report balances back to the runner"""
         success, balance = await self.balance_adapter.get_balance(
             token_id=self.config.get("token_id"),
-            wallet_address=self.config.get("vault_wallet", {}).get("address"),
+            wallet_address=self.config.get("strategy_wallet", {}).get("address"),
         )
         return {
             "portfolio_value": float(balance or 0),
@@ -513,10 +512,10 @@ class MyStrategy(Strategy):
 
 ### Built-in adapters
 
-- **BALANCE (BalanceAdapter)**: wraps `WalletClient`/`TokenClient` to read wallet, token, and pool balances and now orchestrates transfers between the main/vault wallets with ledger bookkeeping. Requires a `Web3Service` so it can share the same wallet provider as the strategy.
+- **BALANCE (BalanceAdapter)**: wraps `WalletClient`/`TokenClient` to read wallet, token, and pool balances and now orchestrates transfers between the main/strategy wallets with ledger bookkeeping. Requires a `Web3Service` so it can share the same wallet provider as the strategy.
 - **POOL (PoolAdapter)**: composes `PoolClient` to fetch pools, llama analytics, combined reports, high-yield searches, and search helpers.
 - **BRAP (BRAPAdapter)**: integrates the cross-chain quote service for swaps/bridges, including fee breakdowns, route comparisons, validation helpers, and swap execution/ledger recording when provided a `Web3Service`.
-- **LEDGER (LedgerAdapter)**: records deposits, withdrawals, custom operations, and cashflows via `LedgerClient`, and can read vault transaction summaries.
+- **LEDGER (LedgerAdapter)**: records deposits, withdrawals, custom operations, and cashflows via `LedgerClient`, and can read strategy transaction summaries.
 - **TOKEN (TokenAdapter)**: lightweight wrapper around `TokenClient` for token metadata, live price snapshots, and gas token lookups.
 - **HYPERLEND (HyperlendAdapter)**: connects to `HyperlendClient` for lending/supply caps inside the HyperLend strategy.
 
@@ -538,8 +537,8 @@ just create-wallets
 poetry run pytest -k smoke -v
 
 # 3. Test your specific contribution
-poetry run pytest wayfinder_paths/vaults/strategies/my_strategy/ -v     # Strategy
-poetry run pytest wayfinder_paths/vaults/adapters/my_adapter/ -v       # Adapter
+poetry run pytest wayfinder_paths/strategies/my_strategy/ -v     # Strategy
+poetry run pytest wayfinder_paths/adapters/my_adapter/ -v       # Adapter
 ```
 
 ### Testing Your Contribution

{wayfinder_paths-0.1.4 → wayfinder_paths-0.1.6}/pyproject.toml

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

{wayfinder_paths-0.1.4 → wayfinder_paths-0.1.6}/wayfinder_paths/CONFIG_GUIDE.md

@@ -1,6 +1,6 @@
 # Configuration Guide
 
-This guide explains how to configure your vault strategies for local testing.
+This guide explains how to configure your strategies for local testing.
 
 ## Quick Setup
 
@@ -64,7 +64,7 @@ cp wayfinder_paths/config.example.json config.json
 
 **Other Optional fields:**
 - `user.main_wallet_address` - Override auto-loaded main wallet
-- `user.vault_wallet_address` - Override auto-loaded vault wallet
+- `user.strategy_wallet_address` - Override auto-loaded strategy wallet
 
 **Security Note:** Never commit `config.json` to version control. Add it to `.gitignore`.
 
@@ -74,7 +74,7 @@ These are managed automatically by Wayfinder:
 - `api_base_url` - Wayfinder backend API endpoint
 - `wallets_path` - Location of generated wallets.json
 - `job_id` - Auto-generated by Wayfinder
-- `job_type` - Set to "vault"
+- `job_type` - Set to "strategy"
 
 ## Strategy Configuration
 
@@ -125,8 +125,8 @@ Each strategy should have its own dedicated wallet for isolation and security. T
 When you run a strategy:
 1. The system uses the strategy directory name (e.g., `hyperlend_stable_yield_strategy`) to look up a wallet
 2. It searches `wallets.json` for a wallet with a matching `label`
-3. If found, that wallet is used as the strategy's `vault_wallet`
-4. Falls back to `vault_wallet_address` from config if explicitly provided
+3. If found, that wallet is used as the strategy's dedicated wallet
+4. Falls back to `strategy_wallet_address` from config if explicitly provided
 
 ### Creating a Strategy with Wallet
 
@@ -188,11 +188,11 @@ Strategies access wallets the same way as before:
 
 ```python
 # In strategy code
-vault_address = self.config.get("vault_wallet").get("address")
+strategy_address = self.config.get("strategy_wallet").get("address")
 main_address = self.config.get("main_wallet").get("address")
 ```
 
-The `vault_wallet` is automatically populated from the wallet with label matching the strategy directory name.
+The strategy wallet is automatically populated from the wallet with label matching the strategy directory name.
 
 ## Loading Configuration
 
@@ -206,14 +206,14 @@ For programmatic use:
 
 ```python
 from pathlib import Path
-from core.config import VaultConfig
+from core.config import StrategyJobConfig
 import json
 
 # Load from file
 with open("config.json") as f:
     config_data = json.load(f)
 
-config = VaultConfig.from_dict(config_data)
+config = StrategyJobConfig.from_dict(config_data)
 
 # Configuration now has:
 # - config.user.username & password (for Wayfinder backend)
@@ -223,13 +223,13 @@ config = VaultConfig.from_dict(config_data)
 
 ## Wallet Abstraction
 
-The vault system supports multiple wallet types through a wallet abstraction layer. By default, adapters use local private keys (self-custodial wallets), but you can inject custom wallet providers for custodial wallets like Privy or Turnkey.
+The strategy system supports multiple wallet types through a wallet abstraction layer. By default, adapters use local private keys (self-custodial wallets), but you can inject custom wallet providers for custodial wallets like Privy or Turnkey.
 
 ### Default Behavior (Local Wallets)
 
 By default, adapters use `LocalWalletProvider` which resolves private keys from:
 - `wallets.json` (matched by address)
-- Environment variables (`PRIVATE_KEY`, `PRIVATE_KEY_VAULT`)
+- Environment variables (`PRIVATE_KEY`, `PRIVATE_KEY_STRATEGY`)
 - Wallet config in `config.json`
 
 No code changes are required - existing strategies continue to work.
@@ -264,7 +264,7 @@ See `core/wallets/README.md` for details on implementing custom wallet providers
 
 ## Authentication with Wayfinder Backend
 
-Wayfinder Vaults supports **dual authentication** for different use cases:
+Wayfinder Paths supports **dual authentication** for different use cases:
 
 ### 1. Service Account Authentication (API Key)
 
@@ -318,7 +318,7 @@ export WAYFINDER_API_KEY="sk_live_abc123..."
 The `username` and `password` in your config authenticate with the Wayfinder backend to access:
 - Wallet management
 - Transaction signing services
-- Vault execution services
+- Strategy execution services
 
 ```json
 {
@@ -343,7 +343,7 @@ The `username` and `password` in your config authenticate with the Wayfinder bac
 
 ## Configuration in Strategies
 
-Strategies receive configuration automatically through VaultJob:
+Strategies receive configuration automatically through StrategyJob:
 
 ```python
 from core.strategies.Strategy import Strategy

{wayfinder_paths-0.1.4 → wayfinder_paths-0.1.6}/wayfinder_paths/__init__.py

@@ -1,14 +1,15 @@
-"""Wayfinder Path - Trading strategies and adapters for automated vault management"""
+"""Wayfinder Path - Trading strategies and adapters for automated strategy management"""
 
 __version__ = "0.1.0"
 
 # Re-export commonly used items for convenience
 from wayfinder_paths.core import (
     BaseAdapter,
+    LiquidationResult,
     StatusDict,
     StatusTuple,
     Strategy,
-    VaultJob,
+    StrategyJob,
 )
 
 __all__ = [
@@ -17,5 +18,5 @@ __all__ = [
     "Strategy",
     "StatusDict",
     "StatusTuple",
-    "VaultJob",
+    "StrategyJob",
 ]