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

{wayfinder_paths-0.1.3.dist-info → wayfinder_paths-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wayfinder-paths
-Version: 0.1.3
+Version: 0.1.5
 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
 
@@ -42,8 +42,9 @@ curl -sSL https://install.python-poetry.org | python3 -
 poetry install
 
 # ⚠️ Generate test wallets FIRST (required!)
-# This creates wallets.json with live wallets for local testing
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault
+# This creates wallets.json with a main wallet for local testing
+just create-wallets
+# Or manually: poetry run python wayfinder_paths/scripts/make_wallets.py -n 1
 
 # Copy and configure
 cp wayfinder_paths/config.example.json config.json
@@ -67,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
@@ -108,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`
@@ -124,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`)
@@ -137,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
@@ -167,16 +167,18 @@ cd wayfinder-paths
 poetry install
 
 # 3. Generate test wallets (required before testing!)
-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
 
 # 4. Create a new strategy (recommended - automatically creates wallet)
 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)
 
@@ -187,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
@@ -225,12 +227,12 @@ 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
 schema_version: "0.1"
-entrypoint: "vaults.adapters.my_adapter.adapter.MyAdapter"
+entrypoint: "adapters.my_adapter.adapter.MyAdapter"
 capabilities:
   - "pool.read"
   - "pool.analytics"
@@ -245,10 +247,10 @@ 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: "vaults.adapters.pool_adapter.adapter.PoolAdapter"
+entrypoint: "adapters.pool_adapter.adapter.PoolAdapter"
 capabilities:
   - "pool.read"
   - "pool.analytics"
@@ -263,12 +265,12 @@ 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
 schema_version: "0.1"
-entrypoint: "vaults.strategies.my_strategy.strategy.MyStrategy"
+entrypoint: "strategies.my_strategy.strategy.MyStrategy"
 permissions:
   policy: "(wallet.id == 'FORMAT_WALLET_ID') && (eth.tx.to == '0x...')"
 adapters:
@@ -287,10 +289,10 @@ 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: "vaults.strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy"
+entrypoint: "strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy"
 permissions:
   policy: "(wallet.id == 'FORMAT_WALLET_ID') && ((eth.tx.data[0..10] == '0x095ea7b3' && eth.tx.data[34..74] == 'f75584ef6673ad213a685a1b58cc0330b8ea22cf') || (eth.tx.to == '0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf'))"
 adapters:
@@ -328,7 +330,7 @@ The `validate_manifests.py` script performs multi-stage validation:
 1. **Schema Validation** (via Pydantic models):
    - Loads YAML file and validates against `AdapterManifest` or `StrategyManifest` schema
    - Checks required fields, types, and basic constraints (e.g., capabilities cannot be empty)
-   - Validates entrypoint format (must be full import path like `"vaults.adapters.pool_adapter.adapter.PoolAdapter"`)
+   - Validates entrypoint format (must be full import path like `"adapters.pool_adapter.adapter.PoolAdapter"`)
 
 2. **Entrypoint Verification**:
    - **For Adapters**: Imports the entrypoint class and verifies it's a subclass of `BaseAdapter`
@@ -354,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.
 
@@ -378,14 +380,14 @@ 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:
 
 **Option A: Pass to Strategy Constructor**
 ```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={...},
@@ -411,7 +413,9 @@ export WAYFINDER_API_KEY="sk_live_abc123..."
 }
 ```
 
-**Priority Order:** Constructor parameter > `config.json` > `WAYFINDER_API_KEY` environment variable
+**Priority Order:** Constructor parameter > `config.json` (user.api_key or system.api_key) > `WAYFINDER_API_KEY` environment variable
+
+**Note:** API keys in `config.json` are loaded directly by `WayfinderClient` via `_load_config_credentials()`, not through the `UserConfig` or `SystemConfig` dataclasses. This allows flexible credential loading.
 
 #### 2. Personal Access Authentication (OAuth)
 For standalone SDK users with username/password:
@@ -431,6 +435,7 @@ For standalone SDK users with username/password:
 - When an API key is available, it's used for all API requests (including public endpoints) for rate limiting
 - If no API key is found, the system falls back to OAuth authentication
 - All clients created by adapters automatically inherit the API key discovery mechanism
+- API keys in `config.json` are loaded directly by `WayfinderClient._load_config_credentials()` from `user.api_key` or `system.api_key`, not stored in the `UserConfig` or `SystemConfig` dataclasses
 
 See [CONFIG_GUIDE.md](wayfinder_paths/CONFIG_GUIDE.md) for detailed authentication documentation.
 
@@ -439,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
 
@@ -469,10 +474,10 @@ 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.vaults.adapters.balance_adapter.adapter import BalanceAdapter
+from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
 
 
 class MyStrategy(Strategy):
@@ -495,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")
 
@@ -518,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),
@@ -529,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.
 
@@ -546,14 +551,16 @@ Each strategy manifest declares which adapters it needs and which capabilities i
 
 ```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. Run smoke tests
 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
@@ -577,7 +584,9 @@ cd wayfinder-paths
 poetry install
 
 # Generate test wallets (essential!)
-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
 
 # Copy and configure
 cp wayfinder_paths/config.example.json config.json
@@ -598,14 +607,17 @@ poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --de
 **Before running any strategies, generate test wallets.** This creates `wallets.json` in the repository root with throwaway wallets for local testing:
 
 ```bash
-# Essential: Create default and vault wallets for testing
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault
+# Essential: Create main wallet for testing
+just create-wallets
+# Or manually: poetry run python wayfinder_paths/scripts/make_wallets.py -n 1
 ```
 
 This creates:
-- `default` wallet - your main wallet for testing
+- `main` wallet - your main wallet for testing (labeled "main" in wallets.json)
 - `wallets.json` - wallet addresses and private keys for local testing
 
+**Note:** Strategy-specific wallets are automatically created when you use `just create-strategy "Strategy Name"`. For manual creation, use `just create-wallet "strategy_name"` or `poetry run python wayfinder_paths/scripts/make_wallets.py --label "strategy_name"`.
+
 **Important:** These wallets are for testing only. Never use them with real funds or on mainnet.
 
 **Per-Strategy Wallets:** Each strategy should have its own dedicated wallet. When you create a new strategy using `just create-strategy`, a wallet is automatically generated with a label matching the strategy directory name. The system automatically uses this wallet when running the strategy. See [CONFIG_GUIDE.md](wayfinder_paths/CONFIG_GUIDE.md) for details.
@@ -613,14 +625,14 @@ This creates:
 Additional options:
 
 ```bash
-# Add 3 extra unlabeled wallets for multi-account testing
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault -n 3
+# Add 3 extra wallets for multi-account testing
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 3
 
-# Generate keystore files (for geth/web3 compatibility)
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault --keystore-password "my-password"
+# 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"
 
-# Replace existing wallets (if you need fresh test wallets)
-poetry run python wayfinder_paths/scripts/make_wallets.py --default --vault --override
+# Generate keystore files (for geth/web3 compatibility)
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 1 --keystore-password "my-password"
 ```
 
 ### Configuration
@@ -645,6 +657,65 @@ cp wayfinder_paths/config.example.json config.json
 poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --config config.json
 ```
 
+## 📦 Versioning
+
+This package follows [Semantic Versioning](https://semver.org/) (SemVer) and is published to PyPI as a public package.
+
+### Version Format: MAJOR.MINOR.PATCH
+
+- **MAJOR** (X.0.0): Breaking changes that require code updates
+- **MINOR** (0.X.0): New features, backward compatible
+- **PATCH** (0.0.X): Bug fixes, backward compatible
+
+### Version Bumping Rules
+
+- **PATCH**: Bug fixes, security patches, documentation updates
+- **MINOR**: New adapters, new strategies, new features (backward compatible)
+- **MAJOR**: Breaking API changes, removed features, incompatible changes
+
+### Important Notes
+
+- **Versions are immutable**: Once published to PyPI, a version cannot be changed or deleted
+- **Versions must be unique**: Each release must have a new, unique version number
+- **Publishing is restricted**: Only publish from the `main` branch to prevent accidental releases
+
+### Publishing Workflow and Order of Operations
+
+**Critical**: Changes must follow this strict order:
+
+1. **Merge to main**: All changes must be merged to the `main` branch first
+2. **Publish to PyPI**: The new version must be published to PyPI from `main` branch
+3. **Dependent changes**: Only after publishing can dependent changes be merged in other applications
+
+**Why this order matters:**
+- Other applications depend on this package from PyPI
+- They cannot merge changes that depend on new versions until those versions are available on PyPI
+- Publishing from `main` ensures the published version matches what's in the repository
+- This prevents dependency resolution failures in downstream applications
+
+**Example workflow:**
+```bash
+# 1. Make changes in a feature branch
+git checkout -b feature/new-adapter
+# ... make changes ...
+git commit -m "Add new adapter"
+
+# 2. Merge to main
+git checkout main
+git merge feature/new-adapter
+
+# 3. Bump version in pyproject.toml (e.g., 0.1.3 → 0.2.0)
+# Edit pyproject.toml: version = "0.2.0"
+git commit -m "Bump version to 0.2.0"
+git push origin main
+
+# 4. Publish to PyPI (must be on main branch)
+just publish
+
+# 5. Now dependent applications can update their dependencies
+# pip install wayfinder-paths==0.2.0
+```
+
 ## 📦 Publishing
 
 Publish to PyPI:
@@ -654,6 +725,12 @@ export PUBLISH_TOKEN="your_pypi_token"
 just publish
 ```
 
+**Important:**
+- ⚠️ **Publishing is only allowed from the `main` branch** - the publish command will fail if run from any other branch
+- ⚠️ **Versions must be unique** - ensure the version in `pyproject.toml` has been bumped and is unique
+- ⚠️ **Follow the order of operations** - see [Versioning](#-versioning) section above for the required workflow
+- ⚠️ **Versions are immutable** - once published, a version cannot be changed or deleted from PyPI
+
 Install the published package:
 
 ```bash

wayfinder_paths-0.1.5.dist-info/RECORD

@@ -0,0 +1,126 @@
+wayfinder_paths/CONFIG_GUIDE.md,sha256=PN2ClAZ8FCF16_sstaUxbfvQkVAyXdtRvTrrj-qJPuk,13397
+wayfinder_paths/__init__.py,sha256=JKuLfydWVBIb3fH9o-KBdEdq_7nLt0jAq2y4Al7veMU,404
+wayfinder_paths/abis/generic/erc20.json,sha256=geyzVzdTNt3u1XHKxi4seszP_GIWIzPTl0FYgiftRnM,9336
+wayfinder_paths/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wayfinder_paths/adapters/balance_adapter/README.md,sha256=g5LXIJ-_6mM6FRwvEJp3jLJeUXfHxauiNRfnYRhJbps,4046
+wayfinder_paths/adapters/balance_adapter/adapter.py,sha256=5-zN_DXypnshpLbMTLEKqG5XI3D0xNKbhWQUxNdnCWA,8991
+wayfinder_paths/adapters/balance_adapter/examples.json,sha256=3R1M4B_VsIy29viAuFT9nQbnQShWl8ZbU-rnSNWUW9U,129
+wayfinder_paths/adapters/balance_adapter/manifest.yaml,sha256=vp2VoQJf-TxFxgkTsUJ1AEeeOoImM_QjrGYCmjyEQYI,189
+wayfinder_paths/adapters/balance_adapter/test_adapter.py,sha256=MzwElYxtdffIJnk9xtWCJml8HG1n8Z0omJY2X9MVmDg,2873
+wayfinder_paths/adapters/brap_adapter/README.md,sha256=euWkSBR6OkYtebhvdNR_PL64sKbzKD5bg5hrYTIWZ1c,7905
+wayfinder_paths/adapters/brap_adapter/__init__.py,sha256=jpqxZ-Bv_8kBo-lhgO_QCWaVZNq_WwlkNBHD4RsqOJg,90
+wayfinder_paths/adapters/brap_adapter/adapter.py,sha256=9Nr_pUhIf5ik98pTg-6pidDtnxH_vt_ZkQHchpAG3oE,26778
+wayfinder_paths/adapters/brap_adapter/examples.json,sha256=KWuAklUspd2uvk0s2ey8gczg4nbzhdwxQqzhascyMiQ,5287
+wayfinder_paths/adapters/brap_adapter/manifest.yaml,sha256=bJ8o4j9ZPjfnLxXxHfekoXKUHoBkXmWQ3nokTH1aya4,240
+wayfinder_paths/adapters/brap_adapter/test_adapter.py,sha256=36ixuv11Ql3pWgImmoVuE1EqVpsvT5dToGvN9LjpWpE,10874
+wayfinder_paths/adapters/hyperlend_adapter/__init__.py,sha256=DsWOnEn-Tlu9ZoIoGaFeSqOYI3b4lXGVK3_FTntWpLw,139
+wayfinder_paths/adapters/hyperlend_adapter/adapter.py,sha256=QevMiOrztvTRHx7vA_dAQGX3ioUFdLY4aVOfsT-DXX8,10555
+wayfinder_paths/adapters/hyperlend_adapter/manifest.yaml,sha256=Ugc0jNf3txAQRGAXlVvTN3Mbdc4-fUMS1yVs0SZcBwI,259
+wayfinder_paths/adapters/hyperlend_adapter/test_adapter.py,sha256=ZnEiJxHRlcI4ijDfwmL2KEsL6A8dcWDYNhhxCEezWI4,9330
+wayfinder_paths/adapters/ledger_adapter/README.md,sha256=OIFbJIlck91K3kBKbkPfOWUDx7tJgDjwCAcBLm7FNK4,4104
+wayfinder_paths/adapters/ledger_adapter/__init__.py,sha256=DK9GShIUiQ57YKSqhCKoS43GCweBxi0lzkUQ9sYVxUA,96
+wayfinder_paths/adapters/ledger_adapter/adapter.py,sha256=6Fjxltvn9iXp_-CZtN7lDz1Xt0lWaNQX2drx6lgeryw,10260
+wayfinder_paths/adapters/ledger_adapter/examples.json,sha256=DdqTSe4vnBrfIycQVQQ_JZom7fBGHbL7MR4ppK9ljCY,3936
+wayfinder_paths/adapters/ledger_adapter/manifest.yaml,sha256=121VPXNpx13vO9qoBww47Wvpi29JLn5WoIFnudCkDYs,271
+wayfinder_paths/adapters/ledger_adapter/test_adapter.py,sha256=F5L7YYbYIH1HUGkR-Dra2XU2AdSvx-kfO2qDYzW3xKw,7425
+wayfinder_paths/adapters/pool_adapter/README.md,sha256=rF7KYEtxu6BmDa9gi505-IFUddk6BDaMOQPB4YjeOLc,5863
+wayfinder_paths/adapters/pool_adapter/__init__.py,sha256=rv56pYzz2Gqiz33uoPJktCQRe3CRt8U9ry5GbjVgK3A,90
+wayfinder_paths/adapters/pool_adapter/adapter.py,sha256=jXGq5F-xHXF42JN5R0Hd6LEGDds1qAiwOCGQ4etzuPE,9642
+wayfinder_paths/adapters/pool_adapter/examples.json,sha256=hLH74Oy6WlrEvAIOjwqsjpcCDxC-N0efWeLa_-TbntM,3202
+wayfinder_paths/adapters/pool_adapter/manifest.yaml,sha256=z-OQYBsl2RdV6M34RZzqtQTAFHtQod0po_JD_-9ElNM,217
+wayfinder_paths/adapters/pool_adapter/test_adapter.py,sha256=QiEYyLFo0S6gKJuk7j9Md0-mN6yNY5heKDQ_Sm1Yln8,7721
+wayfinder_paths/adapters/token_adapter/README.md,sha256=d2tMJte6HBu62CCYXdjS8GHZXj5f2fU03uZAO6pscBI,2698
+wayfinder_paths/adapters/token_adapter/__init__.py,sha256=nEmxrvffEygn3iKH3cZTNLkhnUUhlUAEtshmrFRAjq8,62
+wayfinder_paths/adapters/token_adapter/adapter.py,sha256=JEb7A8wJYHxENFhJ6upAgnQAbPZeVfYi6OGs1hiHxnA,3432
+wayfinder_paths/adapters/token_adapter/examples.json,sha256=RW-3xazj4wbTPl-AVrzduRH1NCXx8m7-06bRMOUJ-lc,3626
+wayfinder_paths/adapters/token_adapter/manifest.yaml,sha256=KQgbHAUaJ6JYjTlOJ9HGeRxwmICXVV01qRwW8wJPKMM,143
+wayfinder_paths/adapters/token_adapter/test_adapter.py,sha256=xnJ-nglMnCFqYnH9D-xcnIy-pmPZK6_puNZ9hPthIMI,4701
+wayfinder_paths/config.example.json,sha256=gDvS7W-cbaNe2IV7Q72di_PYpCDKODojELaXdd77Gx4,605
+wayfinder_paths/conftest.py,sha256=pqDNijXn9_zmbAdkt_2a18UQLjtsDkNTBJVTgC6H2nA,1136
+wayfinder_paths/core/__init__.py,sha256=tcpxajbeBGbxFDtI5N05BOV7cMzduuwRbKh3O-DjiRI,358
+wayfinder_paths/core/adapters/BaseAdapter.py,sha256=bzc3ER7aKOsmk9cxyoJxGdI54eibbpcMC8nGYJUrsp0,2033
+wayfinder_paths/core/adapters/__init__.py,sha256=ZqzkliXm5RjWxYJyJR88XHb3npZFiThk7HoVZe3JF60,108
+wayfinder_paths/core/adapters/base.py,sha256=j10cZ5NwqaAhN2mH_j24tG8r7_7NWtx8F6S7sJ9wOi8,100
+wayfinder_paths/core/adapters/models.py,sha256=cQEZMjKZtUz_M29ijBXhZeIfR7FSYlunxov8pMIuUxs,913
+wayfinder_paths/core/clients/AuthClient.py,sha256=scz8GvnabNYAQq_XYDcLP2lf2LZqurQOixA7MMAfbCY,2796
+wayfinder_paths/core/clients/BRAPClient.py,sha256=AtTYNk1FuCS59xj5FFgv2fIts44BQK19Kv0IeXlcPtw,3700
+wayfinder_paths/core/clients/ClientManager.py,sha256=2p8oEFnCxKCH_TBMKo9gMLAwzwLgeotdgFod8wpoa04,8135
+wayfinder_paths/core/clients/HyperlendClient.py,sha256=6yAhojEbjrRC7YLckwGL_2z5lwI4xnrRVNzxspqKSTg,6173
+wayfinder_paths/core/clients/LedgerClient.py,sha256=c-RSBlf8jSOFWbK-Yr_n91bz5kNNLexEsaiMDGf5g4M,14627
+wayfinder_paths/core/clients/PoolClient.py,sha256=s4fg-OPPxq7tfy8Fbk_QtGCkzkiRCx-P8UwANUfJpE0,4070
+wayfinder_paths/core/clients/SimulationClient.py,sha256=ViQmXCQKwhpnZA-YkfIgArrpxGr1U11lZNlbBIak1MU,6364
+wayfinder_paths/core/clients/TokenClient.py,sha256=zg39K-uA1ObkNEcxoXviA1QYSd-fxQXxjBHFOeClY9E,2788
+wayfinder_paths/core/clients/TransactionClient.py,sha256=APs-8lMdgBnE40wOn5L8_lEdJ3DddTZFcQbW0tIfJWg,2040
+wayfinder_paths/core/clients/WalletClient.py,sha256=Hx4iz41ieEQyUcS16_qgw7LdQMrG5UX-KUDCMgZ3jYc,3677
+wayfinder_paths/core/clients/WayfinderClient.py,sha256=lLdmD58gAyx5N4yYN4-IYjvRDVzwE3K408XuI07g6g4,10724
+wayfinder_paths/core/clients/__init__.py,sha256=oNq6fQW8hUnpkuIZxdbOTLPayJRLA6S-k8e7wqsH_7c,1581
+wayfinder_paths/core/clients/protocols.py,sha256=p6Juadsi3jVVp6WyWNmT3O8qr6TRmWOrsWVMH5RgWPE,8339
+wayfinder_paths/core/clients/sdk_example.py,sha256=Y6mSyHfsWcOje6E-geNI0C4CQ6uyZaD3V9Q8kPM53eo,2969
+wayfinder_paths/core/config.py,sha256=A--KQp_EDLXhtituvk3WXPUP2SJv45IcNcm4G_nFMc0,16890
+wayfinder_paths/core/constants/__init__.py,sha256=KH-TtfNBJgp0WfKIxvHnvS521odH8RS3Qhl8cQhr4Ys,663
+wayfinder_paths/core/constants/base.py,sha256=9XEcgsT_0EMkCoMMdEkvQjjEW9G_8SM3chOBxPpWj00,1169
+wayfinder_paths/core/constants/erc20_abi.py,sha256=3ljIyUl6FesoEa4uprwNo-nF0Q5s73M9WEqXLw6ONI4,3214
+wayfinder_paths/core/constants/hyperlend_abi.py,sha256=nIaqsfMl5-_InYN82pjz0FIKsT-AnNkwz0DIc9VrZSc,4331
+wayfinder_paths/core/engine/StrategyJob.py,sha256=DqwkPu5JHp00xkDmj7kyUqs9U-VP0k-OBlVipjEzk14,7257
+wayfinder_paths/core/engine/__init__.py,sha256=WZ2KWnmOZnBocYrqdwq6EUHp6lmTyrKyXgHSHyQswnU,108
+wayfinder_paths/core/engine/manifest.py,sha256=rkrALipqwqR61lZu_lF1jJj1aqJk6ZskuXokcB1g0HI,3146
+wayfinder_paths/core/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wayfinder_paths/core/services/base.py,sha256=Ip7fkRPvCibLs67n-0_ESrDR0t9lffGqY-4K2pJfoG8,5585
+wayfinder_paths/core/services/local_evm_txn.py,sha256=n0LJOH9-Gy9JDjMvz16Lk1PD9gpsuiw2EEW7PNmkzTI,16982
+wayfinder_paths/core/services/local_token_txn.py,sha256=S9RJq2_fm1sqmJmn83vMo69-GQLeCkQ-20rrv0ezU1g,8049
+wayfinder_paths/core/services/web3_service.py,sha256=_8sEpkWzSzp7dQR5OCwScypyOsEv5s2BeuO8TqB_H-w,1558
+wayfinder_paths/core/settings.py,sha256=VqNOU84OsX_6KAWr9JdPfyxtV14yTH1uZl2zuKeiJ3g,1921
+wayfinder_paths/core/strategies/Strategy.py,sha256=eGgiILhtqk2-AsAFW3i3basDKn1F_K-datITW66DeEQ,9281
+wayfinder_paths/core/strategies/__init__.py,sha256=2NjvvDw6sIQGUFV4Qo1olXTxUOY3GmCM8Ivz_J1FSmc,157
+wayfinder_paths/core/strategies/base.py,sha256=-s0qeiGZl5CHTUL2PavGXM7ACkNlaa0c4jeZR_4DuBM,155
+wayfinder_paths/core/strategies/descriptors.py,sha256=yZ9vnaZo5xYUpHfdJTumxYdDkIY8odp2fiezf_v0Cro,1622
+wayfinder_paths/core/utils/__init__.py,sha256=TEylMYHnG37Z3mizSmw28bUm0vyNBFzf0Nc8dB_7l1A,73
+wayfinder_paths/core/utils/evm_helpers.py,sha256=sJUGpwbc3jD9h1BaaYC4mPDs25S3YKyoY1NfvHq9BBg,6491
+wayfinder_paths/core/utils/wallets.py,sha256=tGgVxDW2ZvkvJIb6yow1cirrqhQ67_X9IqxZocBEy2k,2438
+wayfinder_paths/core/wallets/README.md,sha256=gwzFapFnpArdIyUz0NdYOq5Nm9_uqDYuFddKAZJ0Ss4,3745
+wayfinder_paths/core/wallets/WalletManager.py,sha256=sptj0Dya9iM87BDzUktrYM_Mw33xyVJNrRUTVfBjHGw,1870
+wayfinder_paths/core/wallets/__init__.py,sha256=hIuhy64pJOs_8mAP7Zup28goXbT8qjBeeVYMkbqlyu8,315
+wayfinder_paths/policies/enso.py,sha256=oytco04eeGjiRbZPGFE1YpH4NxvV0tfVM14QmlyzjkY,428
+wayfinder_paths/policies/erc20.py,sha256=cmiG03gz82LRUgwf7BD_yoZ9QTiIvIURL40y48NwaFo,958
+wayfinder_paths/policies/evm.py,sha256=8fJpjAl6XVxr51sVMw_VkWmIaI_lj2T7qrLcR8_sWgs,713
+wayfinder_paths/policies/hyper_evm.py,sha256=wLkrE158rPaDjfU5q-PyRXuQ6KA67VcqWo484UHsLb8,649
+wayfinder_paths/policies/hyperlend.py,sha256=4u0NP80t7rpHlw_nvParUN90sIXypWyXACfE0OPqFys,370
+wayfinder_paths/policies/hyperliquid.py,sha256=hAxNtWdxavwf_a-AnlXMOmEYakkNBkrPTrvprIQqBDQ,796
+wayfinder_paths/policies/moonwell.py,sha256=sKWLbruMKiW7Yh1DhXdVPRe0JBP-nooNybRz0G9PgvA,1605
+wayfinder_paths/policies/prjx.py,sha256=6kfZ6OQFroFHYJl4vSWT-svwwfvoHlS_ZrcHt8nmZMU,743
+wayfinder_paths/policies/util.py,sha256=r8xQLPvE3kU21_LG6VbkFI9sUSYltcsKunryZdHOUDA,912
+wayfinder_paths/run_strategy.py,sha256=HRj5iY2AFWaxRKXukKUKPxaXcz4YN-fb6anSLHJaeDg,14502
+wayfinder_paths/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wayfinder_paths/scripts/create_strategy.py,sha256=rp2kkGXsmcAbOt1eZthV1iZ2yM6wAbjn4R10IATulOw,6275
+wayfinder_paths/scripts/make_wallets.py,sha256=oP3i8MdU9HJT1QWUfkP7XAv2rDuZg_tbawJ-EJg3b5c,5997
+wayfinder_paths/scripts/validate_manifests.py,sha256=sTJhCVTb8X0SFYozArVbX4AMAEv-0R1Imp4dpHfAuHE,7075
+wayfinder_paths/strategies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wayfinder_paths/strategies/config.py,sha256=5dv-8tWwoxH3Sxd9jtiw90shrLipEe3UlU-IYUBfciM,2762
+wayfinder_paths/strategies/hyperlend_stable_yield_strategy/README.md,sha256=8mjDUBkBEYp_GWkM0knbFIbJ2Nmb-63pNR09ztZ67qo,4596
+wayfinder_paths/strategies/hyperlend_stable_yield_strategy/examples.json,sha256=i1OZXRmjRYXgmGk-_VqXR1hq7VuP6h40j-PWS1W3j-A,413
+wayfinder_paths/strategies/hyperlend_stable_yield_strategy/manifest.yaml,sha256=__YWl6MEeTBLbNWwUyZjQky0ok1T8B1m8dHPQWtW454,240
+wayfinder_paths/strategies/hyperlend_stable_yield_strategy/strategy.py,sha256=VqHuuULeXZ5bA8g7cK9oD1kgXrK87N8Hxu8bnDBR1Cc,88820
+wayfinder_paths/strategies/hyperlend_stable_yield_strategy/test_strategy.py,sha256=_7q9pFrqCUdf8eraK9tINs-6qyOCoX4-2AdL0z18wCY,12205
+wayfinder_paths/strategies/stablecoin_yield_strategy/README.md,sha256=Qj1b2bU5606pbZXsPf1WOtsx0erfBaXpRygxIDGVIgE,5211
+wayfinder_paths/strategies/stablecoin_yield_strategy/examples.json,sha256=pL1DNFEvYvXKK7xXD5oQYFPQj3Cm1ocKnk6r_iZk0IY,423
+wayfinder_paths/strategies/stablecoin_yield_strategy/manifest.yaml,sha256=rBb7-Fmub8twfKJgbBIiCWbwI2nLnuqBNyAJs36WhIg,750
+wayfinder_paths/strategies/stablecoin_yield_strategy/strategy.py,sha256=uYmXBjbTET8zFL3WLkcMWvJIbEJMzHezChKqlBGyLFY,70502
+wayfinder_paths/strategies/stablecoin_yield_strategy/test_strategy.py,sha256=PzBaUJf4HR7QV2fvt5QNIgLrwNocAd32k7q6dt7B40I,13074
+wayfinder_paths/templates/adapter/README.md,sha256=QcJ0cwXqqtj1VRK1wAs-unUphTPHdJwoIrIoSU4hTmA,3550
+wayfinder_paths/templates/adapter/adapter.py,sha256=8wdqcEwqb7XGUxl2gQvGnbFwhPi1h15ZJhB2lgtZieI,814
+wayfinder_paths/templates/adapter/examples.json,sha256=KLHy3AgPIplAaZN0qY2A-HBMa1xXkMhIyusORovTD9w,79
+wayfinder_paths/templates/adapter/manifest.yaml,sha256=Xr46INOnH-R9ambF7GvzhTSZgxW3qPlOtt_04xH0_50,134
+wayfinder_paths/templates/adapter/test_adapter.py,sha256=ENjaZH-LMPGYUUbqsfXtvUQep51XjPQNv52i47rkaNk,1525
+wayfinder_paths/templates/strategy/README.md,sha256=c7iKlgkz0FPQC3xjMlXqYaDIwC_EKr0wJ6pCLfr2Oik,5664
+wayfinder_paths/templates/strategy/examples.json,sha256=s8UdlD5uxLITQrRMCqgiaAP0IE0tdnnLfX-Zn-OChIc,135
+wayfinder_paths/templates/strategy/manifest.yaml,sha256=Q13sIhfE7u0wMwa8oFwMZr_twwVMprMV4c_JEQNhkz8,289
+wayfinder_paths/templates/strategy/strategy.py,sha256=dso2jhVphsdKNd17JPwnFAFzU01-1kHlWrKPAKIKSWw,2024
+wayfinder_paths/templates/strategy/test_strategy.py,sha256=-ktqbtJ-lXr0CVGgjFkleWmdZeT2nsyL_zt7Hq1aC1g,7692
+wayfinder_paths/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wayfinder_paths/tests/test_smoke_manifest.py,sha256=YjVzHTWys5o6Ae2cUuuJPhk-QgKxT1InDFHLjpouRiY,1267
+wayfinder_paths/tests/test_test_coverage.py,sha256=9NrZeVmP02D4W7Qc0XjciC05bhvdTCVibYjTGfa_GQk,7893
+wayfinder_paths/tests/test_utils.py,sha256=pxHT0QKFlyJeJo8bFnKXzWcOdi6t8rbJ0JFCBaFCBRQ,2112
+wayfinder_paths-0.1.5.dist-info/LICENSE,sha256=dYKnlkC_xosBAEQNUvB6cHMuhFgcUtN0oBR7E8_aR2Y,1066
+wayfinder_paths-0.1.5.dist-info/METADATA,sha256=RcIPhwnOY1-nifh2nPVoUHWeo1b1lYyZDULOZ-nWVbg,31321
+wayfinder_paths-0.1.5.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+wayfinder_paths-0.1.5.dist-info/RECORD,,

wayfinder_paths/vaults/adapters/hyperlend_adapter/__init__.py

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

wayfinder_paths/vaults/adapters/ledger_adapter/manifest.yaml

@@ -1,11 +0,0 @@
-schema_version: "0.1"
-entrypoint: "vaults.adapters.ledger_adapter.adapter.LedgerAdapter"
-capabilities:
-  - "ledger.read"
-  - "ledger.write"
-  - "vault.transactions"
-  - "vault.deposits"
-  - "vault.withdrawals"
-  - "vault.operations"
-dependencies:
-  - "LedgerClient"