wayfinder-paths 0.1.28__py3-none-any.whl → 0.1.29__py3-none-any.whl

wayfinder_paths/mcp/tools/discovery.py

@@ -6,12 +6,12 @@ from wayfinder_paths.mcp.utils import err, ok, read_text_excerpt, read_yaml, rep
 
 
 async def discover(
-    kind: Literal["adapters", "strategies"],
+    kind: Literal["adapter", "strategy"],
     detail: Literal["summary", "full"] = "summary",
 ) -> dict[str, Any]:
     root = repo_root()
     base = (
-        root / "wayfinder_paths" / ("adapters" if kind == "adapters" else "strategies")
+        root / "wayfinder_paths" / ("adapters" if kind == "adapter" else "strategies")
     )
     if not base.exists():
         return err("not_found", f"Directory not found: {base}")
@@ -26,7 +26,7 @@ async def discover(
         manifest = read_yaml(manifest_path)
         rel_manifest = str(manifest_path.relative_to(root))
 
-        if kind == "adapters":
+        if kind == "adapter":
             item = {
                 "name": child.name,
                 "entrypoint": manifest.get("entrypoint"),
@@ -58,75 +58,11 @@ async def discover(
     return ok({"kind": kind, "items": items})
 
 
-def _default_claude_notes_for_adapter(name: str) -> dict[str, Any] | None:
-    # Keep this deliberately small; the real docs live in .claude/skills.
-    if name == "brap_adapter":
-        return {
-            "reads": [
-                {
-                    "name": "quote_swap (via mcp__wayfinder__quote_swap)",
-                    "summary": "Get best BRAP route + fees; no on-chain effects.",
-                }
-            ],
-            "writes": [
-                {
-                    "name": "swap (via mcp__wayfinder__execute kind=swap)",
-                    "risk": "funds",
-                    "summary": "May submit ERC20 approvals and a swap/bridge tx.",
-                }
-            ],
-            "gotchas": [
-                "USDT-style tokens may require setting allowance to 0 before approve.",
-                "Cross-chain swaps still broadcast a tx on the source chain.",
-            ],
-        }
-    if name == "balance_adapter":
-        return {
-            "reads": [
-                {
-                    "name": "balances (via mcp__wayfinder__balances)",
-                    "summary": "Read token/pool balances via Wayfinder API.",
-                }
-            ],
-            "writes": [
-                {
-                    "name": "send (via mcp__wayfinder__execute kind=send)",
-                    "risk": "funds",
-                    "summary": "Native/ERC20 sends from a local wallet.",
-                }
-            ],
-            "gotchas": ["Prefer DRY_RUN=1 until ready to broadcast."],
-        }
-    if name == "hyperliquid_adapter":
-        return {
-            "reads": [
-                {
-                    "name": "hyperliquid (via mcp__wayfinder__hyperliquid)",
-                    "summary": "User state + market reads (no signing).",
-                }
-            ],
-            "writes": [
-                {
-                    "name": "hyperliquid_execute (via mcp__wayfinder__hyperliquid_execute)",
-                    "risk": "funds",
-                    "summary": "Perp orders/leverage/withdraw with local signing (gated by review prompt).",
-                }
-            ],
-            "gotchas": [
-                "Perp coins are mapped to asset_id (<10000).",
-                "Builder fees are attributed to 0xaA1D89f333857eD78F8434CC4f896A9293EFE65c and use tenths-of-bp units.",
-                "Prefer DRY_RUN=1 until ready to execute.",
-            ],
-        }
-    return None
-
-
 async def describe(
     kind: Literal["adapter", "strategy"],
     name: str,
     include_manifest: bool = True,
     include_readme_excerpt: bool = True,
-    include_claude_notes: bool = True,
 ) -> dict[str, Any]:
     root = repo_root()
     base = (
@@ -150,9 +86,4 @@ async def describe(
         if readme:
             out["readme_excerpt"] = readme
 
-    if include_claude_notes and kind == "adapter":
-        notes = _default_claude_notes_for_adapter(name)
-        if notes:
-            out["claude_notes"] = notes
-
     return ok(out)

wayfinder_paths/mcp/tools/execute.py

@@ -38,7 +38,7 @@ from wayfinder_paths.mcp.utils import (
 
 class ExecutionRequest(BaseModel):
     kind: Literal["swap", "send", "hyperliquid_deposit"]
-    wallet_label: str = Field(..., description="wallets.json label (e.g. main)")
+    wallet_label: str = Field(..., description="config.json wallet label (e.g. main)")
 
     # Shared
     amount: str = Field(..., description="Human units as a string (e.g. '1000')")
@@ -257,8 +257,10 @@ def _compact_quote(
     """Create a compact summary of quote data, stripping verbose nested structures."""
     result: dict[str, Any] = {}
 
-    # Extract provider list from all_quotes
-    all_quotes = quote_data.get("quotes", {}).get("all_quotes", [])
+    # Extract provider list from quotes (API returns quotes as a list at top level)
+    all_quotes = quote_data.get("quotes", [])
+    if not isinstance(all_quotes, list):
+        all_quotes = []
     if isinstance(all_quotes, list):
         result["providers"] = list(
             {
@@ -439,7 +441,7 @@ async def execute(
     if not sender or not pk:
         response = err(
             "invalid_wallet",
-            "Wallet must include address and private_key_hex in wallets.json (local dev only)",
+            "Wallet must include address and private_key_hex in config.json (local dev only)",
             {"wallet_label": req.wallet_label},
         )
         store.put(key, tool_input, response)
@@ -530,6 +532,8 @@ async def execute(
         swap_tx = dict(calldata)
         swap_tx["chainId"] = int(from_chain_id)
         swap_tx["from"] = to_checksum_address(sender)
+        if "value" in swap_tx:
+            swap_tx["value"] = int(swap_tx["value"])
 
         token_addr = from_token_addr
         spender = swap_tx.get("to")

wayfinder_paths/mcp/tools/hyperliquid.py

@@ -382,7 +382,7 @@ async def hyperliquid_execute(
     if not sender or not pk:
         response = err(
             "invalid_wallet",
-            "Wallet must include address and private_key_hex in wallets.json (local dev only)",
+            "Wallet must include address and private_key_hex in config.json (local dev only)",
             {"wallet_label": want},
         )
         store.put(key, tool_input, response)

wayfinder_paths/mcp/tools/quotes.py

@@ -205,14 +205,13 @@ async def quote_swap(
     except Exception as exc:  # noqa: BLE001
         return err("quote_error", str(exc))
 
-    quotes_data = data.get("quotes", {}) if isinstance(data, dict) else {}
-    if not isinstance(quotes_data, dict):
-        quotes_data = {}
-    all_quotes = quotes_data.get("all_quotes", [])
-    if not isinstance(all_quotes, list):
-        all_quotes = []
-    best_quote = quotes_data.get("best_quote")
-    quote_count = quotes_data.get("quote_count", len(all_quotes))
+    # API returns {"quotes": [...], "best_quote": {...}} at top level
+    raw_quotes = data.get("quotes", []) if isinstance(data, dict) else []
+    if not isinstance(raw_quotes, list):
+        raw_quotes = []
+    all_quotes = raw_quotes
+    best_quote = data.get("best_quote") if isinstance(data, dict) else None
+    quote_count = len(all_quotes)
 
     providers: list[str] = []
     seen: set[str] = set()

wayfinder_paths/mcp/tools/wallets.py

@@ -14,7 +14,6 @@ from wayfinder_paths.mcp.utils import (
     normalize_address,
     ok,
     repo_root,
-    wallets_path,
 )
 
 PROTOCOL_ADAPTERS: dict[str, dict[str, Any]] = {
@@ -146,9 +145,7 @@ async def wallets(
     parallel: bool = False,
     include_zero_positions: bool = False,
 ) -> dict[str, Any]:
-    p = wallets_path()
     root = repo_root()
-    rel = str(p.relative_to(root)) if p.is_absolute() and root in p.parents else str(p)
     store = WalletProfileStore.default()
 
     if action == "list":
@@ -164,7 +161,7 @@ async def wallets(
             else:
                 view["protocols"] = []
             wallet_list.append(view)
-        return ok({"wallets_path": rel, "wallets": wallet_list})
+        return ok({"config_path": "config.json", "wallets": wallet_list})
 
     if action == "create":
         existing = load_wallets()
@@ -178,7 +175,7 @@ async def wallets(
             if str(w.get("label", "")).strip() == want:
                 return ok(
                     {
-                        "wallets_path": rel,
+                        "config_path": "config.json",
                         "wallets": [_public_wallet_view(x) for x in existing],
                         "created": _public_wallet_view(w),
                         "note": "Wallet label already existed; returning existing wallet.",
@@ -187,12 +184,12 @@ async def wallets(
 
         w = make_random_wallet()
         w["label"] = want
-        write_wallet_to_json(w, out_dir=p.parent, filename=p.name)
+        write_wallet_to_json(w, out_dir=root, filename="config.json")
 
         refreshed = load_wallets()
         return ok(
             {
-                "wallets_path": rel,
+                "config_path": "config.json",
                 "wallets": [_public_wallet_view(x) for x in refreshed],
                 "created": _public_wallet_view(w),
             }

wayfinder_paths/mcp/utils.py

@@ -64,32 +64,10 @@ def load_config_json() -> dict[str, Any]:
     return parsed if isinstance(parsed, dict) else {}
 
 
-def wallets_path() -> Path:
-    cfg = load_config_json()
-    system = cfg.get("system") if isinstance(cfg.get("system"), dict) else {}
-    candidate = (
-        (system or {}).get("wallets_path")
-        or os.getenv("WALLETS_PATH")
-        or "wallets.json"
-    )
-    p = Path(candidate)
-    if not p.is_absolute():
-        p = repo_root() / p
-    return p
-
-
 def load_wallets() -> list[dict[str, Any]]:
     cfg = load_config_json()
     if isinstance(cfg.get("wallets"), list):
         return [w for w in cfg["wallets"] if isinstance(w, dict)]
-
-    p = wallets_path()
-    if p.exists():
-        parsed = load_json_file(p)
-        if isinstance(parsed, list):
-            return [w for w in parsed if isinstance(w, dict)]
-        if isinstance(parsed, dict) and isinstance(parsed.get("wallets"), list):
-            return [w for w in parsed["wallets"] if isinstance(w, dict)]
     return []
 
 

wayfinder_paths/policies/lifi.py

@@ -1,7 +1,10 @@
+from wayfinder_paths.core.constants.contracts import (
+    LIFI_GENERIC,
+    LIFI_ROUTER_HYPEREVM,
+)
 from wayfinder_paths.policies.util import allow_functions
 
-LIFI_ROUTERS: dict[int:str] = {999: "0x0a0758d937d1059c356D4714e57F5df0239bce1A"}
-LIFI_GENERIC = "0x31a9b1835864706Af10103b31Ea2b79bdb995F5F"
+LIFI_ROUTERS: dict[int:str] = {999: LIFI_ROUTER_HYPEREVM}
 
 
 async def lifi_swap(chain_id):

wayfinder_paths/policies/moonwell.py

@@ -5,6 +5,7 @@ from wayfinder_paths.core.constants.contracts import (
     MOONWELL_M_WETH,
     MOONWELL_M_WSTETH,
 )
+from wayfinder_paths.core.constants.moonwell_abi import COMPTROLLER_ABI
 from wayfinder_paths.policies.util import allow_functions
 
 WETH = BASE_WETH
@@ -52,8 +53,9 @@ async def mwsteth_approve_or_mint_or_redeem():
 
 async def moonwell_comptroller_enter_markets_or_claim_rewards():
     return await allow_functions(
-        policy_name="Allow Moonwell Comptroller Enter Markets or Claim Rewards",
+        policy_name="Allow lend and claimReward",
         abi_chain_id=8453,
         address=COMPTROLLER,
         function_names=["enterMarkets", "claimReward"],
+        manual_abi=COMPTROLLER_ABI,
     )

wayfinder_paths/policies/util.py

@@ -6,7 +6,8 @@ async def allow_functions(
     abi_chain_id: int,
     address: str,
     function_names: list[str],
-    abi_address_override=None,
+    abi_address_override: str = None,
+    manual_abi: dict = None,
 ):
     # Note: ChainID is just for fetching ABI, doesn't appear in the final policy. Doesn't bind a strict chain.
     return {
@@ -23,7 +24,8 @@ async def allow_functions(
             {
                 "field_source": "ethereum_calldata",
                 "field": "function_name",
-                "abi": await get_abi_filtered(
+                "abi": manual_abi
+                or await get_abi_filtered(
                     abi_chain_id, abi_address_override or address, function_names
                 ),
                 "operator": "in",

wayfinder_paths/strategies/basis_trading_strategy/strategy.py

@@ -48,7 +48,7 @@ from wayfinder_paths.core.analytics import (
 from wayfinder_paths.core.analytics import (
     z_from_conf as analytics_z_from_conf,
 )
-from wayfinder_paths.core.constants.contracts import HYPERLIQUID_BRIDGE
+from wayfinder_paths.core.constants.contracts import HYPE_FEE_WALLET, HYPERLIQUID_BRIDGE
 from wayfinder_paths.core.strategies.descriptors import (
     Complexity,
     Directionality,
@@ -111,7 +111,6 @@ class BasisTradingStrategy(BasisSnapshotMixin, Strategy):
     # Rotation cooldown
     ROTATION_MIN_INTERVAL_DAYS = 14
 
-    HYPE_FEE_WALLET: str = "0xaA1D89f333857eD78F8434CC4f896A9293EFE65c"
     HYPE_PRO_FEE: int = 30
     DEFAULT_BUILDER_FEE: dict[str, Any] = {"b": HYPE_FEE_WALLET, "f": HYPE_PRO_FEE}
 

wayfinder_paths/strategies/boros_hype_strategy/constants.py

@@ -1,3 +1,24 @@
+from wayfinder_paths.core.constants.contracts import (
+    HYPE_OFT_ADDRESS,
+    KHYPE_ADDRESS,
+    KHYPE_STAKING_ACCOUNTANT,
+    LHYPE_ACCOUNTANT,
+    LOOPED_HYPE_ADDRESS,
+)
+from wayfinder_paths.core.constants.contracts import (
+    HYPEREVM_WHYPE as WHYPE_ADDRESS,
+)
+
+# Re-export addresses for use by strategy modules
+__all__ = [
+    "HYPE_OFT_ADDRESS",
+    "WHYPE_ADDRESS",
+    "KHYPE_ADDRESS",
+    "KHYPE_STAKING_ACCOUNTANT",
+    "LHYPE_ACCOUNTANT",
+    "LOOPED_HYPE_ADDRESS",
+]
+
 # ─────────────────────────────────────────────────────────────────────────────
 # TOKEN IDS (wayfinder token identifiers)
 # ─────────────────────────────────────────────────────────────────────────────
@@ -14,20 +35,6 @@ KHYPE_LST = "kinetic-staked-hype-hyperevm"
 LOOPED_HYPE = "looped-hype-hyperevm"
 USDC_HYPE = "usd-coin-hyperevm"
 
-
-# ─────────────────────────────────────────────────────────────────────────────
-# CONTRACT ADDRESSES
-# ─────────────────────────────────────────────────────────────────────────────
-
-# HyperEVM token addresses
-KHYPE_ADDRESS = "0xfD739d4e423301CE9385c1fb8850539D657C296D"
-LOOPED_HYPE_ADDRESS = "0x5748ae796AE46A4F1348a1693de4b50560485562"
-WHYPE_ADDRESS = "0x5555555555555555555555555555555555555555"
-
-# Accountant contracts for exchange rate calculations
-KHYPE_STAKING_ACCOUNTANT = "0x9209648Ec9D448EF57116B73A2f081835643dc7A"
-LHYPE_ACCOUNTANT = "0xcE621a3CA6F72706678cFF0572ae8d15e5F001c3"
-
 # Chain IDs
 HYPEREVM_CHAIN_ID = 999
 ARBITRUM_CHAIN_ID = 42161
@@ -100,8 +107,8 @@ BOROS_MIN_DEPOSIT_HYPE = 0.4
 BOROS_MIN_TENOR_DAYS = 3  # Roll to new market if < 3 days to expiry
 BOROS_ENABLE_MIN_TOTAL_USD = 80.0  # Skip Boros if capital below this
 
-# LayerZero OFT bridge (HyperEVM native HYPE → Arbitrum OFT HYPE)
-HYPE_OFT_ADDRESS = "0x007C26Ed5C33Fe6fEF62223d4c363A01F1b1dDc1"
+# LayerZero OFT bridge (HyperEVM native HYPE -> Arbitrum OFT HYPE)
+# HYPE_OFT_ADDRESS imported from contracts.py
 LZ_EID_ARBITRUM = 30110
 
 # Minimal IOFT ABI for quoting + sending.

wayfinder_paths/strategies/boros_hype_strategy/strategy.py

@@ -23,7 +23,6 @@ from loguru import logger
 
 from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
 from wayfinder_paths.adapters.boros_adapter import BorosAdapter, BorosMarketQuote
-from wayfinder_paths.adapters.boros_adapter.client import BorosClient
 from wayfinder_paths.adapters.brap_adapter.adapter import BRAPAdapter
 from wayfinder_paths.adapters.hyperliquid_adapter.adapter import (
     HyperliquidAdapter,
@@ -273,75 +272,37 @@ class BorosHypeStrategy(
             user_address=user_address,
         )
 
-        # Verify Boros connection
-        try:
-            connected = await self.boros_adapter.connect()
-        except Exception as e:
-            connected = False
-            logger.warning(f"Boros adapter connection failed: {e}")
-        if not connected:
-            logger.warning(
-                "Boros adapter connection failed - some features may not work"
-            )
-
-        # Initialize Hyperliquid adapter for market data and perp trading
-        # The adapter will create Exchange internally with local signer from config
-        # if no sign_callback is provided (and not in simulation mode).
-        try:
-            self.hyperliquid_adapter = HyperliquidAdapter(
-                config=self._config,
-                simulation=self.simulation,
-                sign_callback=self.strategy_sign_typed_data,
-            )
-            try:
-                hl_connected = await self.hyperliquid_adapter.connect()
-            except Exception as e:
-                hl_connected = False
-                logger.warning(f"Hyperliquid adapter connection failed: {e}")
-            if not hl_connected:
-                logger.warning("Hyperliquid adapter connection failed")
-        except Exception as e:
-            logger.warning(f"Hyperliquid adapter not available: {e}")
-            self.hyperliquid_adapter = None
-
-        # Initialize BalanceAdapter for on-chain balance reads
-        try:
-            self.balance_adapter = BalanceAdapter(
-                config=self._config,
-                main_wallet_signing_callback=main_sign_callback,
-                strategy_wallet_signing_callback=self._sign_callback,
-            )
-            logger.debug("BalanceAdapter initialized for on-chain balance reads")
-        except Exception as e:
-            logger.warning(f"BalanceAdapter initialization failed: {e}")
-            self.balance_adapter = None
+        self.hyperliquid_adapter = HyperliquidAdapter(
+            config=self._config,
+            simulation=self.simulation,
+            sign_callback=self.strategy_sign_typed_data,
+        )
 
-        # Initialize BRAP adapter for swaps and bridging
-        try:
-            self.brap_adapter = BRAPAdapter(
-                config=self._config,
-                strategy_wallet_signing_callback=self._sign_callback,
-            )
-            logger.debug("BRAPAdapter initialized for swaps")
-        except Exception as e:
-            logger.warning(f"BRAPAdapter initialization failed: {e}")
-            self.brap_adapter = None
+        self.balance_adapter = BalanceAdapter(
+            config=self._config,
+            main_wallet_signing_callback=main_sign_callback,
+            strategy_wallet_signing_callback=self._sign_callback,
+        )
+        self.brap_adapter = BRAPAdapter(
+            config=self._config,
+            strategy_wallet_signing_callback=self._sign_callback,
+        )
 
-        # Initialize ledger adapter for transaction recording
-        try:
-            self.ledger_adapter = LedgerAdapter()
-            logger.debug("LedgerAdapter initialized")
-        except Exception as e:
-            logger.warning(f"LedgerAdapter initialization failed: {e}")
-            self.ledger_adapter = None
+        self.ledger_adapter = LedgerAdapter()
 
         logger.info(f"BorosHypeStrategy setup complete (simulation={self.simulation})")
 
     async def analyze(self, deposit_usdc: float = 1000.0) -> dict[str, Any]:
         # Read-only market analysis returning Boros fixed-rate markets for HYPE
-        client = (
-            self.boros_adapter.boros_client if self.boros_adapter else BorosClient()
-        )
+        # Client ownership: BorosAdapter owns the client; we require adapter to be set up
+        if not self.boros_adapter:
+            return {
+                "success": False,
+                "error": "BorosAdapter not initialized - call setup() first",
+                "deposit_usdc": float(deposit_usdc),
+                "hype_markets": [],
+            }
+        client = self.boros_adapter.boros_client
         try:
             markets = await client.list_markets(is_whitelisted=True, skip=0, limit=250)
         except Exception as exc:  # noqa: BLE001

wayfinder_paths/strategies/stablecoin_yield_strategy/strategy.py

@@ -12,6 +12,7 @@ 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.contracts import ENSO_ROUTER
 from wayfinder_paths.core.strategies.descriptors import (
     Complexity,
     Directionality,
@@ -1591,7 +1592,7 @@ class StablecoinYieldStrategy(Strategy):
 
     @staticmethod
     def policies() -> list[str]:
-        enso_router = "0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf".lower()
+        enso_router = ENSO_ROUTER.lower()
         approve_enso = (
             "eth.tx.data[0..10] == '0x095ea7b3' && "
             f"eth.tx.data[34..74] == '{enso_router[2:]}'"

{wayfinder_paths-0.1.28.dist-info → wayfinder_paths-0.1.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: wayfinder-paths
-Version: 0.1.28
+Version: 0.1.29
 Summary: Wayfinder Path: strategies and adapters
 Author: Wayfinder
 Author-email: dev@wayfinder.ai