wayfinder-paths 0.1.15__py3-none-any.whl → 0.1.16__py3-none-any.whl

wayfinder_paths/core/wallets/README.md

@@ -1,88 +0,0 @@
-# Wallet Abstraction Layer
-
-Wayfinder strategies interact with blockchains through a single abstraction: the `EvmTxn` interface defined in `wayfinder_paths/core/services/base.py`. The default implementation (`LocalEvmTxn`) signs transactions with private keys pulled from config.json or config.json, while `WalletManager` resolves which provider to use at runtime.
-
-## Pieces
-
-1. **`EvmTxn` (interface)** – describes balance lookups, ERC-20 approvals, raw transaction broadcasting, and AsyncWeb3 access.
-2. **`LocalEvmTxn`** – the built-in provider that signs transactions locally via `eth_account`. It handles RPC resolution, nonce management, gas estimation, and status checks.
-3. **`WalletManager`** – light factory that reads `wallet_type` from strategy config and returns the appropriate `EvmTxn`. Today it always returns `LocalEvmTxn` unless you inject your own provider.
-4. **`DefaultWeb3Service`** – convenience wrapper that bundles an `EvmTxn` (wallet provider) with a `LocalTokenTxnService` (transaction builders used by adapters).
-
-## Using the defaults
-
-```python
-from wayfinder_paths.core.services.web3_service import DefaultWeb3Service
-from wayfinder_paths.core.wallets.WalletManager import WalletManager
-
-config = {...}  # contains main_wallet / strategy_wallet entries
-wallet_provider = WalletManager.get_provider(config)
-web3_service = DefaultWeb3Service(config, wallet_provider=wallet_provider)
-
-# Strategies typically pass web3_service.evm_transactions into adapters that require wallet access.
-balance_adapter = BalanceAdapter(config, web3_service=web3_service)
-```
-
-If you want to provide a custom wallet provider (e.g., Privy, Turnkey, Fireblocks), implement the `EvmTxn` interface and hand it to `DefaultWeb3Service`/adapters directly—`WalletManager` is purely a helper.
-
-## Implementing a custom provider
-
-Subclass `EvmTxn` and implement every abstract method:
-
-```python
-from typing import Any
-from web3 import AsyncWeb3
-
-from wayfinder_paths.core.services.base import EvmTxn
-
-
-class PrivyWallet(EvmTxn):
-    def __init__(self, privy_client):
-        self._client = privy_client
-
-    async def get_balance(self, address: str, token_address: str | None, chain_id: int) -> tuple[bool, Any]:
-        ...
-
-    async def read_erc20_allowance(self, chain_id: int, token_address: str, owner_address: str, spender_address: str) -> tuple[bool, Any]:
-        ...
-
-    async def broadcast_transaction(...):
-        ...
-
-    async def transaction_succeeded(self, tx_hash: str, chain_id: int, timeout: int = 120) -> bool:
-        ...
-
-    def get_web3(self, chain_id: int) -> AsyncWeb3:
-        ...
-```
-
-Methods should mirror `LocalEvmTxn`’s behavior: return `(True, payload)` on success, `(False, "reason")` on failure, and expose AsyncWeb3 instances tied to the requested chain.
-
-Once implemented:
-
-```python
-custom_wallet = PrivyWallet(privy_client)
-web3_service = DefaultWeb3Service(config, wallet_provider=custom_wallet)
-```
-
-## Configuration hints
-
-`WalletManager.get_provider` looks for `wallet_type` on the top-level config, `main_wallet`, and `strategy_wallet`. Example:
-
-```json
-{
-  "strategy": {
-    "wallet_type": "local",
-    "main_wallet": { "address": "0x...", "wallet_type": "local" },
-    "strategy_wallet": { "address": "0x..." }
-  }
-}
-```
-
-Currently only `"local"` is supported through configuration—the custom path is injection.
-
-## Why this layer?
-
-- Strategies never touch raw `AsyncWeb3`; they call adapters, which call clients, which call a wallet provider.
-- Alternate signing backends can be plugged in without modifying strategy code.
-- Tests can patch `WalletManager.get_provider` or inject stub `EvmTxn` implementations to avoid real RPC calls.

wayfinder_paths/core/wallets/WalletManager.py

@@ -1,56 +0,0 @@
-"""
-Wallet Manager
-
-Factory class for resolving and instantiating wallet providers based on configuration.
-Provides convenience methods for config-based wallet provider resolution.
-"""
-
-from typing import Any
-
-from loguru import logger
-
-from wayfinder_paths.core.services.base import EvmTxn
-from wayfinder_paths.core.services.local_evm_txn import LocalEvmTxn
-
-
-class WalletManager:
-    """
-    Factory class for wallet providers.
-
-    Resolves appropriate wallet provider based on config, defaulting to LocalWalletProvider.
-    This is a convenience helper - adapters support direct injection, making this optional.
-    """
-
-    @staticmethod
-    def get_provider(config: dict[str, Any] | None = None) -> EvmTxn:
-        """
-        Get wallet provider based on configuration.
-
-        Args:
-            config: Configuration dictionary. May contain wallet_type in wallet configs.
-
-        Returns:
-            WalletProvider instance. Defaults to LocalWalletProvider if no type specified.
-        """
-        config = config or {}
-        wallet_type = config.get("wallet_type")
-
-        if not wallet_type:
-            main_wallet = config.get("main_wallet")
-            if isinstance(main_wallet, dict):
-                wallet_type = main_wallet.get("wallet_type")
-
-        if not wallet_type:
-            strategy_wallet = config.get("strategy_wallet")
-            if isinstance(strategy_wallet, dict):
-                wallet_type = strategy_wallet.get("wallet_type")
-
-        if not wallet_type or wallet_type == "local":
-            logger.debug("Using LocalWalletProvider (default)")
-            return LocalEvmTxn(config)
-
-        logger.warning(
-            f"Unknown wallet_type '{wallet_type}', defaulting to LocalWalletProvider. "
-            "To use custom wallet providers, inject them directly into adapters."
-        )
-        return LocalEvmTxn(config)

wayfinder_paths/core/wallets/__init__.py

@@ -1,7 +0,0 @@
-"""Wallet abstraction layer for supporting multiple wallet types."""
-
-from wayfinder_paths.core.services.base import EvmTxn
-from wayfinder_paths.core.services.local_evm_txn import LocalEvmTxn
-from wayfinder_paths.core.wallets.WalletManager import WalletManager
-
-__all__ = ["EvmTxn", "LocalEvmTxn", "WalletManager"]

wayfinder_paths/scripts/run_strategy.py

@@ -1,152 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import asyncio
-import json
-from pathlib import Path
-from typing import Any
-
-
-def _load_wallets(path: Path) -> list[dict[str, Any]]:
-    data = json.loads(path.read_text(encoding="utf-8"))
-    if not isinstance(data, list):
-        raise ValueError(f"Expected a list in {path}")
-    return [w for w in data if isinstance(w, dict)]
-
-
-def _load_config(path: Path) -> dict[str, Any]:
-    if not path.exists():
-        return {}
-    data = json.loads(path.read_text(encoding="utf-8"))
-    if not isinstance(data, dict):
-        raise ValueError(f"Expected a dict in {path}")
-    return data
-
-
-def _find_wallet(wallets: list[dict[str, Any]], label: str) -> dict[str, Any]:
-    for w in wallets:
-        if w.get("label") == label:
-            return w
-    raise ValueError(f"Wallet label not found in config.json: {label}")
-
-
-def _get_strategy_class(strategy: str):
-    if strategy == "basis_trading_strategy":
-        from wayfinder_paths.strategies.basis_trading_strategy.strategy import (
-            BasisTradingStrategy,
-        )
-
-        return BasisTradingStrategy
-
-    if strategy == "hyperlend_stable_yield_strategy":
-        from wayfinder_paths.strategies.hyperlend_stable_yield_strategy.strategy import (
-            HyperlendStableYieldStrategy,
-        )
-
-        return HyperlendStableYieldStrategy
-
-    if strategy == "moonwell_wsteth_loop_strategy":
-        from wayfinder_paths.strategies.moonwell_wsteth_loop_strategy.strategy import (
-            MoonwellWstethLoopStrategy,
-        )
-
-        return MoonwellWstethLoopStrategy
-
-    raise ValueError(f"Unknown strategy: {strategy}")
-
-
-async def _run(args: argparse.Namespace) -> int:
-    repo_root = Path(__file__).resolve().parents[2]
-    wallets_path = (
-        Path(args.wallets).resolve() if args.wallets else repo_root / "config.json"
-    )
-    config_path = (
-        Path(args.config).resolve() if args.config else repo_root / "config.json"
-    )
-
-    wallets = _load_wallets(wallets_path)
-    config = _load_config(config_path)
-
-    main_wallet = _find_wallet(wallets, args.main_wallet_label)
-    strategy_wallet = _find_wallet(wallets, args.strategy_wallet_label)
-
-    # Merge config with wallet info
-    strategy_config = {
-        "main_wallet": main_wallet,
-        "strategy_wallet": strategy_wallet,
-        **config.get("strategy", {}),
-    }
-
-    strategy_class = _get_strategy_class(args.strategy)
-    s = strategy_class(strategy_config)
-
-    await s.setup()
-
-    if args.command == "deposit":
-        ok, msg = await s.deposit(
-            main_token_amount=float(args.usdc), gas_token_amount=float(args.eth)
-        )
-        print(msg)
-        return 0 if ok else 1
-
-    if args.command == "update":
-        ok, msg = await s.update()
-        print(msg)
-        return 0 if ok else 1
-
-    if args.command == "withdraw":
-        ok, msg = await s.withdraw(
-            amount=float(args.amount) if args.amount is not None else None
-        )
-        print(msg)
-        return 0 if ok else 1
-
-    if args.command == "status":
-        st = await s.status()
-        print(json.dumps(st, indent=2, sort_keys=True))
-        return 0
-
-    raise ValueError(f"Unknown command: {args.command}")
-
-
-def main() -> int:
-    p = argparse.ArgumentParser(
-        description="Run a strategy locally (deposit/update/withdraw/status)."
-    )
-    p.add_argument(
-        "--strategy",
-        default="basis_trading_strategy",
-        choices=[
-            "basis_trading_strategy",
-            "hyperlend_stable_yield_strategy",
-            "moonwell_wsteth_loop_strategy",
-        ],
-    )
-    p.add_argument(
-        "--wallets", default=None, help="Path to config.json (default: repo root)"
-    )
-    p.add_argument(
-        "--config", default=None, help="Path to config.json (default: repo root)"
-    )
-    p.add_argument("--main-wallet-label", default="main")
-    p.add_argument("--strategy-wallet-label", default="basis_trading_strategy")
-
-    sub = p.add_subparsers(dest="command", required=True)
-
-    dep = sub.add_parser("deposit")
-    dep.add_argument("--usdc", required=True, type=float)
-    dep.add_argument("--eth", default=0.0, type=float)
-
-    sub.add_parser("update")
-
-    wd = sub.add_parser("withdraw")
-    wd.add_argument("--amount", default=None, type=float)
-
-    sub.add_parser("status")
-
-    args = p.parse_args()
-    return asyncio.run(_run(args))
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

wayfinder_paths/strategies/config.py

@@ -1,85 +0,0 @@
-"""
-Configuration for community strategies
-Each strategy can define its own configuration parameters
-"""
-
-from typing import Any
-
-# Funding Rate Strategy Configuration
-FUNDING_RATE_CONFIG = {
-    "min_deposit": 30,  # USDC
-    "lookback_days": 90,
-    "confidence": 0.9999,
-    "min_open_interest": 50_000,
-    "min_daily_volume": 100_000,
-    "max_leverage": 3,
-    "liquidation_threshold": 0.75,
-    "rebalance_threshold": 0.05,
-    "hyperliquid_system_address": "0x2Df1c51E09aECF9cacB7bc98cB1742757f163dF7",
-    "supported_chains": ["arbitrum"],
-}
-
-
-# Stablecoin Yield Strategy Configuration
-STABLECOIN_YIELD_CONFIG = {
-    "min_deposit": 50,  # USDC
-    "min_tvl": 1_000_000,  # $1M minimum TVL for safety
-    "min_apy": 0.01,  # 1% minimum APY
-    "rebalance_days": 7,  # Days until rebalance is profitable
-    "search_depth": 10,  # Number of pools to evaluate
-    "gas_buffer": 0.001,  # ETH for gas
-    "supported_chains": ["base", "arbitrum"],
-    "supported_tokens": ["USDC", "DAI", "USDT"],
-    "excluded_protocols": [],  # Protocols to avoid
-}
-
-
-# Moonwell wstETH Loop Strategy Configuration (example for advanced strategies)
-MOONWELL_LOOP_CONFIG = {
-    "min_deposit": 200,  # USDC
-    "max_loops": 30,
-    "leverage_limit": 10,
-    "contracts": {
-        "m_usdc": "0xedc817a28e8b93b03976fbd4a3ddbc9f7d176c22",
-        "m_weth": "0x628ff693426583D9a7FB391E54366292F509D457",
-        "m_wsteth": "0x627fe393bc6edda28e99ae648fd6ff362514304b",
-        "reward_distributor": "0xe9005b078701e2a0948d2eac43010d35870ad9d2",
-        "comptroller": "0xfbb21d0380bee3312b33c4353c8936a0f13ef26c",
-    },
-    "supported_chains": ["base"],
-}
-
-
-# Global adapter configurations
-ADAPTER_CONFIGS = {
-    "hyperliquid": {
-        "api_url": "https://api.hyperliquid.xyz",
-        "testnet_url": "https://api.hyperliquid-testnet.xyz",
-        "rate_limit": 10,  # requests per second
-        "timeout": 30,  # seconds
-        "slippage": 0.05,  # 5% default slippage for market orders
-    },
-    "enso": {
-        "router_address": "0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf",
-        "supported_chains": ["ethereum", "base", "arbitrum", "polygon"],
-    },
-    "moonwell": {
-        "supported_chains": ["base"],
-        "protocol_fee": 0.001,  # 0.1%
-    },
-}
-
-
-def get_strategy_config(strategy_name: str) -> dict[str, Any]:
-    """Get configuration for a specific strategy"""
-    configs = {
-        "funding_rate": FUNDING_RATE_CONFIG,
-        "stablecoin_yield": STABLECOIN_YIELD_CONFIG,
-        "moonwell_loop": MOONWELL_LOOP_CONFIG,
-    }
-    return configs.get(strategy_name.lower(), {})
-
-
-def get_adapter_config(adapter_name: str) -> dict[str, Any]:
-    """Get configuration for a specific adapter"""
-    return ADAPTER_CONFIGS.get(adapter_name.lower(), {})