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

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:

wayfinder_paths/{vaults/strategies → strategies}/hyperlend_stable_yield_strategy/strategy.py

@@ -11,19 +11,42 @@ import pandas as pd
 from loguru import logger
 from web3 import Web3
 
+from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
+from wayfinder_paths.adapters.brap_adapter.adapter import BRAPAdapter
+from wayfinder_paths.adapters.hyperlend_adapter.adapter import HyperlendAdapter
+from wayfinder_paths.adapters.ledger_adapter.adapter import LedgerAdapter
+from wayfinder_paths.adapters.token_adapter.adapter import TokenAdapter
 from wayfinder_paths.core.constants.base import DEFAULT_SLIPPAGE
 from wayfinder_paths.core.services.base import Web3Service
 from wayfinder_paths.core.services.local_token_txn import (
     LocalTokenTxnService,
 )
 from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
+from wayfinder_paths.core.strategies.descriptors import (
+    Complexity,
+    Directionality,
+    Frequency,
+    StratDescriptor,
+    TokenExposure,
+    Volatility,
+)
 from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
 from wayfinder_paths.core.wallets.WalletManager import WalletManager
-from wayfinder_paths.vaults.adapters.balance_adapter.adapter import BalanceAdapter
-from wayfinder_paths.vaults.adapters.brap_adapter.adapter import BRAPAdapter
-from wayfinder_paths.vaults.adapters.hyperlend_adapter.adapter import HyperlendAdapter
-from wayfinder_paths.vaults.adapters.ledger_adapter.adapter import LedgerAdapter
-from wayfinder_paths.vaults.adapters.token_adapter.adapter import TokenAdapter
+from wayfinder_paths.policies.enso import ENSO_ROUTER, enso_swap
+from wayfinder_paths.policies.erc20 import erc20_spender_for_any_token
+from wayfinder_paths.policies.hyper_evm import (
+    hypecore_sentinel_deposit,
+    whype_deposit_and_withdraw,
+)
+from wayfinder_paths.policies.hyperlend import (
+    HYPERLEND_POOL,
+    hyperlend_supply_and_withdraw,
+)
+from wayfinder_paths.policies.hyperliquid import (
+    any_hyperliquid_l1_payload,
+    any_hyperliquid_user_payload,
+)
+from wayfinder_paths.policies.prjx import PRJX_ROUTER, prjx_swap
 
 SYMBOL_TRANSLATION_TABLE = str.maketrans(
     {
@@ -36,7 +59,7 @@ WRAPPED_HYPE_ADDRESS = "0x5555555555555555555555555555555555555555"
 
 
 class HyperlendStableYieldStrategy(Strategy):
-    name = "Hyperland Stable Yield Strategy"
+    name = "HyperLend Stable Optimizer"
 
     # Strategy parameters
     APY_SHORT_CIRCUIT_THRESHOLD = None
@@ -61,82 +84,110 @@ class HyperlendStableYieldStrategy(Strategy):
     P_BEST_ROTATION_THRESHOLD = 0.4
     MAX_CANDIDATES = 5
     MIN_STABLE_SWAP_TOKENS = 1e-3
-
-    description = f"""Multi-strategy allocator that converts USDT0 into the most consistently rewarding HyperLend stablecoin and continuously checks if a rotation is justified.
-        **What it does:** Pulls USDT0 from the main wallet, ensures a small HYPE safety buffer for gas, swaps the remaining stable balance into candidate markets, and supplies
-        liquidity to HyperLend. Hourly rate histories are aggregated into a 7-day panel and routed through a block-bootstrap tournament (horizon {HORIZON_HOURS}h, block length {BLOCK_LEN}, {TRIALS:,}
-        trials, {HALFLIFE_DAYS}-day half-life weighting) to estimate which asset has the highest probability of outperforming peers. USDT0 is the LayerZero bridgable stablecoin for USDT.
-        **Exposure type:** Market-neutral stablecoin lending on HyperEVM with automated rotation into whichever pool offers the strongest risk-adjusted lending yield.
-        **Chains:** HyperEVM only (HyperLend pool suite).
-        **Deposit/Withdrawal:** Deposits move USDT0 from the main wallet into the strategy wallet, top up a minimal HYPE gas buffer, rotate into the selected stable, and lend it via HyperLend.
-        Withdrawals unwind the lend position, convert balances back to USDT, and return funds (plus residual HYPE) to the main wallet.
-        **Gas**: Requires HYPE on HypeEVM. Arbitrary amount of funding gas is accepted via vault wallet transfers.
-        """
-    summary = (
-        "Recency-weighted HyperLend stablecoin optimizer that bootstraps 7-day rate history "
-        f"(horizon {HORIZON_HOURS}h, {BLOCK_LEN}-hour blocks, {TRIALS:,} simulations) to pick the top "
-        "performer, funds with USDT0, tops up a small HYPE gas buffer, and defaults to a hysteresis "
-        f"rotation band (dwell={HYSTERESIS_DWELL_HOURS}h, z={HYSTERESIS_Z:.2f}) to avoid churn while still "
-        "short-circuiting when yield gaps are extreme."
-    )
-
-    config = {
-        "deposit": {
-            "description": "Move USDT0 into the vault, ensure a small HYPE gas buffer, and supply the best HyperLend stable.",
-            "parameters": {
-                "main_token_amount": {
-                    "type": "float",
-                    "unit": "USDT0 tokens",
-                    "description": "Amount of USDT0 to allocate to HyperLend.",
-                    "minimum": 1.0,  # TODO: 10
-                    "examples": ["100.0", "250.5"],
-                },
-                "gas_token_amount": {
-                    "type": "float",
-                    "unit": "HYPE tokens",
-                    "description": "Amount of HYPE to top up into the vault wallet to cover gas costs.",
-                    "minimum": 0.0,
-                    "maximum": GAS_MAXIMUM,
-                    "recommended": GAS_MAXIMUM,
+    MAX_GAS = 0.1  # hype float
+
+    INFO = StratDescriptor(
+        description=f"""Multi-strategy allocator that converts USDT0 into the most consistently rewarding HyperLend stablecoin and continuously checks if a rotation is justified.
+            **What it does:** Pulls USDT0 from the main wallet, ensures a small HYPE safety buffer for gas, swaps the remaining stable balance into candidate markets, and supplies
+            liquidity to HyperLend. Hourly rate histories are aggregated into a 7-day panel and routed through a block-bootstrap tournament (horizon {HORIZON_HOURS}h, block length {BLOCK_LEN}, {TRIALS:,}
+            trials, {HALFLIFE_DAYS}-day half-life weighting) to estimate which asset has the highest probability of outperforming peers. USDT0 is the LayerZero bridgable stablecoin for USDT.
+            **Exposure type:** Market-neutral stablecoin lending on HyperEVM with automated rotation into whichever pool offers the strongest risk-adjusted lending yield.
+            **Chains:** HyperEVM only (HyperLend pool suite).
+            **Deposit/Withdrawal:** Deposits move USDT0 from the main wallet into the strategy wallet, top up a minimal HYPE gas buffer, rotate into the selected stable, and lend it via HyperLend.
+            Withdrawals unwind the lend position, convert balances back to USDT, and return funds (plus residual HYPE) to the main wallet.
+            **Gas**: Requires HYPE on HypeEVM. Arbitrary amount of funding gas is accepted via vault wallet transfers.
+            """,
+        summary=(
+            "Recency-weighted HyperLend stablecoin optimizer that bootstraps 7-day rate history "
+            f"(horizon {HORIZON_HOURS}h, {BLOCK_LEN}-hour blocks, {TRIALS:,} simulations) to pick the top "
+            "performer, funds with USDT0, tops up a small HYPE gas buffer, and defaults to a hysteresis "
+            f"rotation band (dwell={HYSTERESIS_DWELL_HOURS}h, z={HYSTERESIS_Z:.2f}) to avoid churn while still "
+            "short-circuiting when yield gaps are extreme."
+        ),
+        gas_token_symbol="HYPE",
+        gas_token_id="hyperliquid-hyperevm",
+        deposit_token_id="usdt0-hyperevm",
+        minimum_net_deposit=10,
+        gas_maximum=MAX_GAS,  # hype float
+        gas_threshold=MAX_GAS / 3,
+        # risk indicators
+        volatility=Volatility.LOW,
+        volatility_description_short=(
+            "Pure HyperLend stablecoin lending keeps NAV steady aside from rate drift."
+        ),
+        directionality=Directionality.MARKET_NEUTRAL,
+        directionality_description=(
+            "Rotates capital between USD stables so exposure stays market neutral."
+        ),
+        complexity=Complexity.LOW,
+        complexity_description="Agent handles optimal pool finding, swaps, and lend transactions automatically.",
+        token_exposure=TokenExposure.STABLECOINS,
+        token_exposure_description=(
+            "Only HyperEVM USD stables (USDT0 and peers), no volatile tokens."
+        ),
+        frequency=Frequency.LOW,
+        frequency_description=(
+            "Updates every 2 hours; rotations infrequent (weekly cooldowns)."
+        ),
+        return_drivers=["lend APY", "pool yield"],
+        config={
+            "deposit": {
+                "description": "Move USDT0 into the vault, ensure a small HYPE gas buffer, and supply the best HyperLend stable.",
+                "parameters": {
+                    "main_token_amount": {
+                        "type": "float",
+                        "unit": "USDT0 tokens",
+                        "description": "Amount of USDT0 to allocate to HyperLend.",
+                        "minimum": 1.0,  # TODO: 10
+                        "examples": ["100.0", "250.5"],
+                    },
+                    "gas_token_amount": {
+                        "type": "float",
+                        "unit": "HYPE tokens",
+                        "description": "Amount of HYPE to top up into the vault wallet to cover gas costs.",
+                        "minimum": 0.0,
+                        "maximum": GAS_MAXIMUM,
+                        "recommended": GAS_MAXIMUM,
+                    },
                 },
+                "result": "USDT0 converted into the top-performing HyperLend stablecoin and supplied on-chain.",
+            },
+            "withdraw": {
+                "description": "Unwinds the position, converts balances to USDT0, and returns funds (plus HYPE buffer) to the main wallet.",
+                "parameters": {},
+                "result": "Principal and accrued gains returned in USDT0; residual HYPE buffer swept home.",
+            },
+            "update": {
+                "description": (
+                    "Evaluates tournament projections and rotates when the hysteresis band is breached "
+                    f"(dwell={HYSTERESIS_DWELL_HOURS}h, z={HYSTERESIS_Z:.2f}) or when a short-circuit gap is hit "
+                    "(set HYPERLEND_ROTATION_POLICY=cooldown to restore the legacy threshold/cooldown rule)."
+                ),
+                "parameters": {},
+            },
+            "status": {
+                "description": "Summarises current lend position, APY, and chosen asset.",
+                "provides": [
+                    "lent_asset",
+                    "lent_balance",
+                    "current_apy",
+                    "best_candidate",
+                    "best_candidate_apy",
+                ],
+            },
+            "points": {
+                "description": "Fetch the HyperLend points account snapshot for this vault wallet using a signed login.",
+                "parameters": {},
+                "result": "Returns the HyperLend points API payload for the strategy wallet.",
+            },
+            "technical_details": {
+                "rotation_policy": ROTATION_POLICY.lower(),
+                "hysteresis_dwell_hours": HYSTERESIS_DWELL_HOURS,
+                "hysteresis_z": HYSTERESIS_Z,
+                "rotation_tx_cost": ROTATION_TX_COST,
             },
-            "result": "USDT0 converted into the top-performing HyperLend stablecoin and supplied on-chain.",
-        },
-        "withdraw": {
-            "description": "Unwinds the position, converts balances to USDT0, and returns funds (plus HYPE buffer) to the main wallet.",
-            "parameters": {},
-            "result": "Principal and accrued gains returned in USDT0; residual HYPE buffer swept home.",
-        },
-        "update": {
-            "description": (
-                "Evaluates tournament projections and rotates when the hysteresis band is breached "
-                f"(dwell={HYSTERESIS_DWELL_HOURS}h, z={HYSTERESIS_Z:.2f}) or when a short-circuit gap is hit "
-                "(set HYPERLEND_ROTATION_POLICY=cooldown to restore the legacy threshold/cooldown rule)."
-            ),
-            "parameters": {},
-        },
-        "status": {
-            "description": "Summarises current lend position, APY, and chosen asset.",
-            "provides": [
-                "lent_asset",
-                "lent_balance",
-                "current_apy",
-                "best_candidate",
-                "best_candidate_apy",
-            ],
-        },
-        "points": {
-            "description": "Fetch the HyperLend points account snapshot for this vault wallet using a signed login.",
-            "parameters": {},
-            "result": "Returns the HyperLend points API payload for the strategy wallet.",
-        },
-        "technical_details": {
-            "rotation_policy": ROTATION_POLICY.lower(),
-            "hysteresis_dwell_hours": HYSTERESIS_DWELL_HOURS,
-            "hysteresis_z": HYSTERESIS_Z,
-            "rotation_tx_cost": ROTATION_TX_COST,
         },
-    }
+    )
 
     def __init__(
         self,
@@ -2323,6 +2374,17 @@ class HyperlendStableYieldStrategy(Strategy):
         }
 
     @staticmethod
-    def policies() -> list[str]:
+    async def policies() -> list[str]:
         """Return policy strings used to scope on-chain permissions."""
-        return []
+        return [
+            any_hyperliquid_l1_payload(),
+            any_hyperliquid_user_payload(),
+            hypecore_sentinel_deposit(),
+            await whype_deposit_and_withdraw(),
+            erc20_spender_for_any_token(HYPERLEND_POOL),
+            await hyperlend_supply_and_withdraw(),
+            erc20_spender_for_any_token(ENSO_ROUTER),
+            await enso_swap(),
+            erc20_spender_for_any_token(PRJX_ROUTER),
+            await prjx_swap(),
+        ]

wayfinder_paths/{vaults/strategies → strategies}/hyperlend_stable_yield_strategy/test_strategy.py

@@ -4,7 +4,7 @@ from unittest.mock import AsyncMock
 
 # Ensure wayfinder-paths is on path for tests.test_utils import
 # This is a workaround until conftest loading order is resolved
-_wayfinder_path_dir = Path(__file__).parent.parent.parent.parent.resolve()
+_wayfinder_path_dir = Path(__file__).parent.parent.parent.resolve()
 _wayfinder_path_str = str(_wayfinder_path_dir)
 if _wayfinder_path_str not in sys.path:
     sys.path.insert(0, _wayfinder_path_str)
@@ -29,7 +29,7 @@ except ImportError:
     get_canonical_examples = test_utils.get_canonical_examples
     load_strategy_examples = test_utils.load_strategy_examples
 
-from wayfinder_paths.vaults.strategies.hyperlend_stable_yield_strategy.strategy import (  # noqa: E402
+from wayfinder_paths.strategies.hyperlend_stable_yield_strategy.strategy import (  # noqa: E402
     HyperlendStableYieldStrategy,
 )
 
@@ -244,6 +244,8 @@ async def test_smoke(strategy):
     examples = load_strategy_examples(Path(__file__))
     smoke_data = examples["smoke"]
 
+    await strategy.setup()
+
     st = await strategy.status()
     assert isinstance(st, dict)
     assert "portfolio_value" in st or "net_deposit" in st or "strategy_status" in st

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

@@ -1,6 +1,6 @@
 # Stablecoin Yield Strategy
 
-- Entrypoint: `vaults.strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy`
+- Entrypoint: `strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy`
 - Manifest: `manifest.yaml`
 - Examples: `examples.json`
 - Tests: `test_strategy.py`
@@ -72,8 +72,9 @@ Transactions are scoped to the vault wallet and Enso Router approval/swap calls:
 # 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 the example config and set credentials if needed
 cp wayfinder_paths/config.example.json config.json

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

@@ -1,5 +1,5 @@
 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:

wayfinder_paths/{vaults/strategies → strategies}/stablecoin_yield_strategy/strategy.py

@@ -6,18 +6,26 @@ from typing import Any
 
 from loguru import logger
 
+from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
+from wayfinder_paths.adapters.brap_adapter.adapter import BRAPAdapter
+from wayfinder_paths.adapters.ledger_adapter.adapter import LedgerAdapter
+from wayfinder_paths.adapters.pool_adapter.adapter import PoolAdapter
+from wayfinder_paths.adapters.token_adapter.adapter import TokenAdapter
 from wayfinder_paths.core.constants.base import DEFAULT_SLIPPAGE
 from wayfinder_paths.core.services.local_token_txn import (
     LocalTokenTxnService,
 )
 from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
+from wayfinder_paths.core.strategies.descriptors import (
+    Complexity,
+    Directionality,
+    Frequency,
+    StratDescriptor,
+    TokenExposure,
+    Volatility,
+)
 from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
 from wayfinder_paths.core.wallets.WalletManager import WalletManager
-from wayfinder_paths.vaults.adapters.balance_adapter.adapter import BalanceAdapter
-from wayfinder_paths.vaults.adapters.brap_adapter.adapter import BRAPAdapter
-from wayfinder_paths.vaults.adapters.ledger_adapter.adapter import LedgerAdapter
-from wayfinder_paths.vaults.adapters.pool_adapter.adapter import PoolAdapter
-from wayfinder_paths.vaults.adapters.token_adapter.adapter import TokenAdapter
 
 
 class StablecoinYieldStrategy(Strategy):
@@ -33,84 +41,113 @@ class StablecoinYieldStrategy(Strategy):
     SUPPORTED_NETWORK_CODES = {"base"}
     ROTATION_MIN_INTERVAL = timedelta(days=14)
     MINIMUM_APY_IMPROVEMENT = 0.01
-    GAS_MAXIMUM = 0.02
-
-    description = (
-        "An automated yield optimization strategy that maximizes returns on USDC deposits on Base.\n\n"
-        "What it does: Continuously scans and evaluates yield opportunities across Base-based DeFi protocols to find the "
-        "highest-yielding, low-risk positions for USDC. Automatically rebalances positions when better opportunities "
-        "emerge to maintain optimal yield generation.\n\n"
-        "Exposure type: Stable USD-denominated exposure with minimal impermanent loss risk. Focuses exclusively on USDC "
-        "and operations on the Base network to preserve capital and maximize yield.\n\n"
-        "Chains: Operates solely on the Base network.\n\n"
-        f"Deposit/Withdrawal: Accepts deposits only in USDC on Base with a minimum of {MIN_AMOUNT_USDC} USDC. Gas: Requires Base ETH "
-        "for gas fees during position entry, rebalancing, and exit (~0.001-0.02 ETH per rebalance cycle). Strategy automatically "
-        "deploys funds to an optimal yield farming position on Base. Withdrawals exit current positions and return USDC to the "
-        "user wallet.\n\n"
-        f"Risks: Primary risks include smart contract vulnerabilities in underlying Base DeFi protocols, temporary yield fluctuations, "
-        f"gas costs during rebalancing, and potential brief capital lock-up during protocol transitions. Strategy filters for a minimum TVL of ${MIN_TVL:,}."
-    )
-    summary = (
-        "Automated stablecoin yield farming across DeFi protocols on Base. "
-        f"Continuously optimizes positions for maximum stable yield while avoiding impermanent loss. "
-        f"Min: {MIN_AMOUNT_USDC} USDC + ETH gas. Filters for ${MIN_TVL:,}+ TVL protocols."
-    )
-
-    # config metadata for UIs/agents
-    config = {
-        "deposit": {
-            "parameters": {
-                "main_token_amount": {
-                    "type": "float",
-                    "description": "amount of Base USDC (token id: usd-coin-base) to deposit",
-                },
-                "gas_token_amount": {
-                    "type": "float",
-                    "description": "amount of Base ETH (token id: ethereum-base) to deposit for gas fees",
-                    "minimum": 0,
-                    "maximum": GAS_MAXIMUM,
+    GAS_MAXIMUM = 10e-4  # ethereum float
+    GAS_SAFETY_FRACTION = 1 / 3
+
+    INFO = StratDescriptor(
+        description=(
+            "An automated yield optimization strategy that maximizes returns on USDC deposits on Base.\n\n"
+            "What it does: Continuously scans and evaluates yield opportunities across Base-based DeFi protocols to find the "
+            "highest-yielding, low-risk positions for USDC. Automatically rebalances positions when better opportunities "
+            "emerge to maintain optimal yield generation.\n\n"
+            "Exposure type: Stable USD-denominated exposure with minimal impermanent loss risk. Focuses exclusively on USDC "
+            "and operations on the Base network to preserve capital and maximize yield.\n\n"
+            "Chains: Operates solely on the Base network.\n\n"
+            f"Deposit/Withdrawal: Accepts deposits only in USDC on Base with a minimum of {MIN_AMOUNT_USDC} USDC. Gas: Requires Base ETH "
+            "for gas fees during position entry, rebalancing, and exit (~0.001-0.02 ETH per rebalance cycle). Strategy automatically "
+            "deploys funds to an optimal yield farming position on Base. Withdrawals exit current positions and return USDC to the "
+            "user wallet.\n\n"
+            f"Risks: Primary risks include smart contract vulnerabilities in underlying Base DeFi protocols, temporary yield fluctuations, "
+            f"gas costs during rebalancing, and potential brief capital lock-up during protocol transitions. Strategy filters for a minimum TVL of ${MIN_TVL:,}."
+        ),
+        summary=(
+            "Automated stablecoin yield farming across DeFi protocols on Base. "
+            f"Continuously optimizes positions for maximum stable yield while avoiding impermanent loss. "
+            f"Min: {MIN_AMOUNT_USDC} USDC + ETH gas. Filters for ${MIN_TVL:,}+ TVL protocols."
+        ),
+        gas_token_symbol="ETH",
+        gas_token_id="ethereum-base",
+        deposit_token_id="usd-coin-base",
+        minimum_net_deposit=50,
+        gas_maximum=GAS_MAXIMUM,
+        # Anything below this level triggers a gas top-up
+        gas_threshold=GAS_MAXIMUM * GAS_SAFETY_FRACTION,
+        # risk indicators
+        volatility=Volatility.LOW,
+        volatility_description_short=(
+            "Capital sits in Base stablecoin lending pools, so price swings are minimal."
+        ),
+        directionality=Directionality.MARKET_NEUTRAL,
+        directionality_description=(
+            "Fully USD-denominated yield farming with no directional crypto beta."
+        ),
+        complexity=Complexity.LOW,
+        complexity_description="Agent handles optimal pool finding and rebalancing",
+        token_exposure=TokenExposure.STABLECOINS,
+        token_exposure_description=(
+            "Only Base USDC (and occasional stable swaps) with no volatile assets."
+        ),
+        frequency=Frequency.LOW,
+        frequency_description=(
+            "Updates every 2 hours; rebalances infrequent (bi-weekly cooldowns)."
+        ),
+        return_drivers=["pool yield"],
+        # config metadata for UIs/agents
+        config={
+            "deposit": {
+                "parameters": {
+                    "main_token_amount": {
+                        "type": "float",
+                        "description": "amount of Base USDC (token id: usd-coin-base) to deposit",
+                    },
+                    "gas_token_amount": {
+                        "type": "float",
+                        "description": "amount of Base ETH (token id: ethereum-base) to deposit for gas fees",
+                        "minimum": 0,
+                        "maximum": GAS_MAXIMUM,
+                    },
                 },
+                "process": "Deposits USDC on Base and searches for the highest yield opportunities among Base-based DeFi protocols",
+                "requirements": [
+                    "Sufficient USDC balance on Base",
+                    "Base ETH available for gas",
+                ],
+                "result": "Funds deployed to a yield farming position on Base",
+            },
+            "withdraw": {
+                "parameters": {},
+                "process": "Exits yield positions on Base and returns USDC to the user wallet",
+                "requirements": [
+                    "Active positions to exit",
+                    "Gas for transactions on Base",
+                ],
+                "result": "USDC returned to wallet and positions closed on Base",
+            },
+            "update": {
+                "parameters": {},
+                "process": "Scans for better yield opportunities on Base and rebalances positions automatically",
+                "frequency": "Call daily or when significant yield changes occur",
+                "requirements": [
+                    "Active strategy positions on Base",
+                    "Sufficient Base gas for rebalancing",
+                ],
+                "result": "Positions optimized for maximum yield on Base",
+            },
+            "technical_details": {
+                "wallet_structure": "Uses strategy subwallet for isolation",
+                "chains": ["Base"],
+                "protocols": ["Various Base DeFi yield protocols"],
+                "tokens": ["USDC"],
+                "gas_requirements": "~0.001-0.02 ETH per rebalance on Base",
+                "search_depth": SEARCH_DEPTH,
+                "minimum_tvl": MIN_TVL,
+                "dust_apy_threshold": DUST_APY,
+                "minimum_apy_edge": MINIMUM_APY_IMPROVEMENT,
+                "rotation_cooldown_days": ROTATION_MIN_INTERVAL.days,
+                "profit_horizon_days": MINIMUM_DAYS_UNTIL_PROFIT,
             },
-            "process": "Deposits USDC on Base and searches for the highest yield opportunities among Base-based DeFi protocols",
-            "requirements": [
-                "Sufficient USDC balance on Base",
-                "Base ETH available for gas",
-            ],
-            "result": "Funds deployed to a yield farming position on Base",
-        },
-        "withdraw": {
-            "parameters": {},
-            "process": "Exits yield positions on Base and returns USDC to the user wallet",
-            "requirements": [
-                "Active positions to exit",
-                "Gas for transactions on Base",
-            ],
-            "result": "USDC returned to wallet and positions closed on Base",
-        },
-        "update": {
-            "parameters": {},
-            "process": "Scans for better yield opportunities on Base and rebalances positions automatically",
-            "frequency": "Call daily or when significant yield changes occur",
-            "requirements": [
-                "Active strategy positions on Base",
-                "Sufficient Base gas for rebalancing",
-            ],
-            "result": "Positions optimized for maximum yield on Base",
-        },
-        "technical_details": {
-            "wallet_structure": "Uses strategy subwallet for isolation",
-            "chains": ["Base"],
-            "protocols": ["Various Base DeFi yield protocols"],
-            "tokens": ["USDC"],
-            "gas_requirements": "~0.001-0.02 ETH per rebalance on Base",
-            "search_depth": SEARCH_DEPTH,
-            "minimum_tvl": MIN_TVL,
-            "dust_apy_threshold": DUST_APY,
-            "minimum_apy_edge": MINIMUM_APY_IMPROVEMENT,
-            "rotation_cooldown_days": ROTATION_MIN_INTERVAL.days,
-            "profit_horizon_days": MINIMUM_DAYS_UNTIL_PROFIT,
         },
-    }
+    )
 
     def __init__(
         self,

wayfinder_paths/{vaults/strategies → strategies}/stablecoin_yield_strategy/test_strategy.py

@@ -4,7 +4,7 @@ from unittest.mock import AsyncMock
 
 # Ensure wayfinder-paths is on path for tests.test_utils import
 # This is a workaround until conftest loading order is resolved
-_wayfinder_path_dir = Path(__file__).parent.parent.parent.parent.resolve()
+_wayfinder_path_dir = Path(__file__).parent.parent.parent.resolve()
 _wayfinder_path_str = str(_wayfinder_path_dir)
 if _wayfinder_path_str not in sys.path:
     sys.path.insert(0, _wayfinder_path_str)
@@ -29,7 +29,7 @@ except ImportError:
     get_canonical_examples = test_utils.get_canonical_examples
     load_strategy_examples = test_utils.load_strategy_examples
 
-from wayfinder_paths.vaults.strategies.stablecoin_yield_strategy.strategy import (  # noqa: E402
+from wayfinder_paths.strategies.stablecoin_yield_strategy.strategy import (  # noqa: E402
     StablecoinYieldStrategy,
 )
 

wayfinder_paths/{vaults/templates → templates}/adapter/README.md

@@ -8,7 +8,7 @@ Adapters expose protocol-specific capabilities to strategies. They should be thi
    ```
    cp -r wayfinder_paths/vaults/templates/adapter wayfinder_paths/vaults/adapters/my_adapter
    ```
-2. Rename `MyAdapter` in `adapter.py` and update `manifest.yaml` so the `entrypoint` matches (`vaults.adapters.my_adapter.adapter.MyAdapter`).
+2. Rename `MyAdapter` in `adapter.py` and update `manifest.yaml` so the `entrypoint` matches (`adapters.my_adapter.adapter.MyAdapter`).
 3. Declare the capabilities your adapter will provide and list any client dependencies (e.g., `PoolClient`, `LedgerClient`).
 4. Implement the public methods that fulfill those capabilities.
 
@@ -63,7 +63,7 @@ Every adapter needs a manifest describing its import path, declared capabilities
 
 ```yaml
 schema_version: "0.1"
-entrypoint: "vaults.adapters.my_adapter.adapter.MyAdapter"
+entrypoint: "adapters.my_adapter.adapter.MyAdapter"
 capabilities:
   - "pool.read"
 dependencies:
@@ -80,13 +80,13 @@ The `dependencies` list is informational today but helps reviewers understand wh
 import pytest
 from unittest.mock import AsyncMock, patch
 
-from wayfinder_paths.vaults.adapters.my_adapter.adapter import MyAdapter
+from wayfinder_paths.adapters.my_adapter.adapter import MyAdapter
 
 
 @pytest.mark.asyncio
 async def test_get_pools():
     with patch(
-        "wayfinder_paths.vaults.adapters.my_adapter.adapter.PoolClient",
+        "wayfinder_paths.adapters.my_adapter.adapter.PoolClient",
         return_value=AsyncMock(
             get_pools_by_ids=AsyncMock(return_value={"pools": []})
         ),

wayfinder_paths/{vaults/templates → templates}/adapter/manifest.yaml

@@ -1,5 +1,5 @@
 schema_version: "0.1"
-entrypoint: "vaults.adapters.my_adapter.adapter.MyAdapter"
+entrypoint: "adapters.my_adapter.adapter.MyAdapter"
 capabilities:
   - "example.op"
 dependencies: