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

wayfinder_paths/vaults/policies/moonwell.py

@@ -0,0 +1,54 @@
+from wayfinder_paths.vaults.policies.util import allow_functions
+
+WETH = "0x4200000000000000000000000000000000000006"
+
+M_USDC = "0xEdc817A28E8B93B03976FBd4a3dDBc9f7D176c22"
+M_WETH = "0x628ff693426583D9a7FB391E54366292F509D457"
+M_WSTETH = "0x627Fe393Bc6EdDA28e99AE648fD6fF362514304b"
+
+COMPTROLLER = "0xfbb21d0380bee3312b33c4353c8936a0f13ef26c"
+
+
+async def weth_deposit():
+    return await allow_functions(
+        policy_name="Allow WETH Deposit",
+        abi_chain_id=8453,
+        address=WETH,
+        function_names=["deposit"],
+    )
+
+
+async def musdc_mint_or_approve_or_redeem():
+    return await allow_functions(
+        policy_name="Allow MUSDC Mint or Approve or Redeem",
+        abi_chain_id=8453,
+        address=M_USDC,
+        function_names=["mint", "approve", "redeem"],
+    )
+
+
+async def mweth_approve_or_borrow_or_repay():
+    return await allow_functions(
+        policy_name="Allow MWETH Approve or Borrow or Repay",
+        abi_chain_id=8453,
+        address=M_WETH,
+        function_names=["approve", "borrow", "repayBorrow"],
+    )
+
+
+async def mwsteth_approve_or_mint_or_redeem():
+    return await allow_functions(
+        policy_name="Allow MWSTETH Approve or Mint or Redeem",
+        abi_chain_id=8453,
+        address=M_WSTETH,
+        function_names=["approve", "mint", "redeem"],
+    )
+
+
+async def moonwell_comptroller_enter_markets_or_claim_rewards():
+    return await allow_functions(
+        policy_name="Allow Moonwell Comptroller Enter Markets or Claim Rewards",
+        abi_chain_id=8453,
+        address=COMPTROLLER,
+        function_names=["enterMarkets", "claimReward"],
+    )

wayfinder_paths/vaults/policies/prjx.py

@@ -0,0 +1,30 @@
+from wayfinder_paths.vaults.policies.util import allow_functions
+
+PRJX_ROUTER = "0x1ebdfc75ffe3ba3de61e7138a3e8706ac841af9b"
+PRJX_NPM = "0xeAd19AE861c29bBb2101E834922B2FEee69B9091"
+
+
+async def prjx_swap():
+    return await allow_functions(
+        policy_name="Allow PRJX Swap",
+        abi_chain_id=999,
+        address=PRJX_ROUTER,
+        function_names=[
+            "exactInput",
+            "exactInputSingle",
+            "exactOutput",
+            "exactOutputSingle",
+        ],
+    )
+
+
+async def prjx_npm():
+    return await allow_functions(
+        policy_name="Allow PRJX NPM",
+        abi_chain_id=999,
+        address=PRJX_NPM,
+        function_names=[
+            "increaseLiquidity",
+            "decreaseLiquidity",
+        ],
+    )

wayfinder_paths/vaults/policies/util.py

@@ -0,0 +1,27 @@
+from wayfinder_paths.core.utils.evm_helpers import get_abi_filtered
+
+
+async def allow_functions(
+    policy_name: str, abi_chain_id: int, address: str, function_names: list[str]
+):
+    # Note: ChainID is just for fetching ABI, doesn't appear in the final policy. Doesn't bind a strict chain.
+    return {
+        "name": policy_name,
+        "method": "eth_signTransaction",
+        "action": "ALLOW",
+        "conditions": [
+            {
+                "field_source": "ethereum_transaction",
+                "field": "to",
+                "operator": "eq",
+                "value": address,
+            },
+            {
+                "field_source": "ethereum_calldata",
+                "field": "function_name",
+                "abi": await get_abi_filtered(abi_chain_id, address, function_names),
+                "operator": "in",
+                "value": function_names,
+            },
+        ],
+    }

wayfinder_paths/vaults/strategies/hyperlend_stable_yield_strategy/strategy.py

@@ -17,6 +17,14 @@ 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
@@ -24,6 +32,21 @@ 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.vaults.policies.enso import ENSO_ROUTER, enso_swap
+from wayfinder_paths.vaults.policies.erc20 import erc20_spender_for_any_token
+from wayfinder_paths.vaults.policies.hyper_evm import (
+    hypecore_sentinel_deposit,
+    whype_deposit_and_withdraw,
+)
+from wayfinder_paths.vaults.policies.hyperlend import (
+    HYPERLEND_POOL,
+    hyperlend_supply_and_withdraw,
+)
+from wayfinder_paths.vaults.policies.hyperliquid import (
+    any_hyperliquid_l1_payload,
+    any_hyperliquid_user_payload,
+)
+from wayfinder_paths.vaults.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/stablecoin_yield_strategy/strategy.py

@@ -11,6 +11,14 @@ 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
@@ -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-0.1.1.dist-info → wayfinder_paths-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wayfinder-paths
-Version: 0.1.1
+Version: 0.1.3
 Summary: Wayfinder Path: strategies and adapters
 Author: Wayfinder
 Author-email: dev@wayfinder.ai
@@ -647,55 +647,27 @@ poetry run python wayfinder_paths/run_strategy.py stablecoin_yield_strategy --co
 
 ## 📦 Publishing
 
-This package is published to [PyPI](https://pypi.org/project/wayfinder-paths/) (Python Package Index).
-
-### How PyPI Works
-
-- **Public by default**: Once published, anyone can download and install your package with `pip install wayfinder-paths` (no authentication required)
-- **Who can update**: Only package owners and maintainers can publish new versions
-- **Version control**: Version numbers must be unique and incrementing (you cannot overwrite a published version)
-- **Access control**: You control who can publish by adding collaborators on PyPI (project owners can add maintainers)
-
-### Publishing a New Version
-
-1. **Update the version** in `pyproject.toml`:
-   ```toml
-   [tool.poetry]
-   version = "0.1.2"  # Must be higher than previous version
-   ```
-
-2. **Set your PyPI token**:
-   ```bash
-   export PUBLISH_TOKEN="your_pypi_token_here"
-   # Or add to .env file: PUBLISH_TOKEN=your_pypi_token_here
-   ```
-   
-   Get your PyPI token from: https://pypi.org/manage/account/token/
-   
-   **Note**: PyPI requires 2FA (two-factor authentication) for all accounts.
-
-3. **Publish**:
-   ```bash
-   just publish
-   ```
-   
-   This will:
-   - Build the package (wheel and source distribution)
-   - Publish to PyPI
-   - Make it publicly available for installation
-
-### Installing the Published Package
-
-Anyone can install the published package with:
+Publish to PyPI:
+
 ```bash
-pip install wayfinder-paths
+export PUBLISH_TOKEN="your_pypi_token"
+just publish
 ```
 
-Or with Poetry:
+Install the published package:
+
 ```bash
+pip install wayfinder-paths
+# or
 poetry add wayfinder-paths
 ```
 
+Install from Git (development):
+
+```bash
+pip install git+https://github.com/wayfinder-ai/wayfinder-paths.git
+```
+
 ### Managing Package Access
 
 To add collaborators who can publish updates: