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

wayfinder_paths/abis/generic/erc20.json

@@ -1,383 +0,0 @@
-[
-    {
-        "constant": true,
-        "inputs": [
-            {
-                "name": "owner",
-                "type": "address"
-            },
-            {
-                "name": "spender",
-                "type": "address"
-            }
-        ],
-        "name": "allowance",
-        "outputs": [
-            {
-                "name": "",
-                "type": "uint256"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "constant": true,
-        "inputs": [
-            {
-                "name": "account",
-                "type": "address"
-            }
-        ],
-        "name": "balanceOf",
-        "outputs": [
-            {
-                "name": "",
-                "type": "uint256"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "constant": true,
-        "inputs": [],
-        "name": "decimals",
-        "outputs": [
-            {
-                "name": "",
-                "type": "uint8"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "constant": true,
-        "inputs": [],
-        "name": "name",
-        "outputs": [
-            {
-                "name": "",
-                "type": "string"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "constant": true,
-        "inputs": [],
-        "name": "symbol",
-        "outputs": [
-            {
-                "name": "",
-                "type": "string"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "constant": false,
-        "inputs": [
-            {
-                "name": "recipient",
-                "type": "address"
-            },
-            {
-                "name": "amount",
-                "type": "uint256"
-            }
-        ],
-        "name": "transfer",
-        "outputs": [
-            {
-                "name": "",
-                "type": "bool"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "constant": false,
-        "inputs": [
-            {
-                "name": "spender",
-                "type": "address"
-            },
-            {
-                "name": "amount",
-                "type": "uint256"
-            }
-        ],
-        "name": "approve",
-        "outputs": [
-            {
-                "name": "",
-                "type": "bool"
-            }
-        ],
-        "type": "function"
-    },
-    {
-        "inputs": [
-            {
-                "internalType": "address",
-                "name": "tokenA",
-                "type": "address"
-            },
-            {
-                "internalType": "address",
-                "name": "tokenB",
-                "type": "address"
-            },
-            {
-                "internalType": "bool",
-                "name": "stable",
-                "type": "bool"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountADesired",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountBDesired",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountAMin",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountBMin",
-                "type": "uint256"
-            },
-            {
-                "internalType": "address",
-                "name": "to",
-                "type": "address"
-            },
-            {
-                "internalType": "uint256",
-                "name": "deadline",
-                "type": "uint256"
-            }
-        ],
-        "name": "addLiquidity",
-        "outputs": [
-            {
-                "internalType": "uint256",
-                "name": "amountA",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountB",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "liquidity",
-                "type": "uint256"
-            }
-        ],
-        "stateMutability": "nonpayable",
-        "type": "function"
-    },
-    {
-        "inputs": [
-            {
-                "internalType": "address",
-                "name": "tokenA",
-                "type": "address"
-            },
-            {
-                "internalType": "address",
-                "name": "tokenB",
-                "type": "address"
-            },
-            {
-                "internalType": "bool",
-                "name": "stable",
-                "type": "bool"
-            },
-            {
-                "internalType": "address",
-                "name": "_factory",
-                "type": "address"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountADesired",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountBDesired",
-                "type": "uint256"
-            }
-        ],
-        "name": "quoteAddLiquidity",
-        "outputs": [
-            {
-                "internalType": "uint256",
-                "name": "amountA",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountB",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "liquidity",
-                "type": "uint256"
-            }
-        ],
-        "stateMutability": "view",
-        "type": "function"
-    },
-    {
-        "inputs": [],
-        "name": "defaultFactory",
-        "outputs": [
-            {
-                "internalType": "address",
-                "name": "",
-                "type": "address"
-            }
-        ],
-        "stateMutability": "view",
-        "type": "function"
-    },
-    {
-        "inputs": [
-            {
-                "internalType": "address",
-                "name": "tokenA",
-                "type": "address"
-            },
-            {
-                "internalType": "address",
-                "name": "tokenB",
-                "type": "address"
-            },
-            {
-                "internalType": "bool",
-                "name": "stable",
-                "type": "bool"
-            },
-            {
-                "internalType": "address",
-                "name": "_factory",
-                "type": "address"
-            },
-            {
-                "internalType": "uint256",
-                "name": "liquidity",
-                "type": "uint256"
-            }
-        ],
-        "name": "quoteRemoveLiquidity",
-        "outputs": [
-            {
-                "internalType": "uint256",
-                "name": "amountA",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountB",
-                "type": "uint256"
-            }
-        ],
-        "stateMutability": "view",
-        "type": "function"
-    },
-    {
-        "inputs": [
-            {
-                "internalType": "address",
-                "name": "tokenA",
-                "type": "address"
-            },
-            {
-                "internalType": "address",
-                "name": "tokenB",
-                "type": "address"
-            },
-            {
-                "internalType": "bool",
-                "name": "stable",
-                "type": "bool"
-            },
-            {
-                "internalType": "uint256",
-                "name": "liquidity",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountAMin",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountBMin",
-                "type": "uint256"
-            },
-            {
-                "internalType": "address",
-                "name": "to",
-                "type": "address"
-            },
-            {
-                "internalType": "uint256",
-                "name": "deadline",
-                "type": "uint256"
-            }
-        ],
-        "name": "removeLiquidity",
-        "outputs": [
-            {
-                "internalType": "uint256",
-                "name": "amountA",
-                "type": "uint256"
-            },
-            {
-                "internalType": "uint256",
-                "name": "amountB",
-                "type": "uint256"
-            }
-        ],
-        "stateMutability": "nonpayable",
-        "type": "function"
-    },
-    {
-        "inputs": [
-            {
-                "internalType": "uint256",
-                "name": "_amount",
-                "type": "uint256"
-            }
-        ],
-        "name": "deposit",
-        "outputs": [],
-        "stateMutability": "nonpayable",
-        "type": "function"
-    },
-    {
-        "inputs": [
-            {
-                "internalType": "uint256",
-                "name": "_shares",
-                "type": "uint256"
-            }
-        ],
-        "name": "withdraw",
-        "outputs": [],
-        "stateMutability": "nonpayable",
-        "type": "function"
-    }
-]

wayfinder_paths/core/clients/sdk_example.py

@@ -1,125 +0,0 @@
-"""
-SDK Usage Examples
-
-Demonstrates how to use the SDK with custom client implementations.
-Use cases: mocks for testing, caching layers, alternative endpoints, rate limiting.
-"""
-
-from typing import Any
-
-from wayfinder_paths.core.clients.ClientManager import ClientManager
-from wayfinder_paths.core.clients.TokenClient import TokenClient
-
-
-class CachedTokenClient:
-    """Token client with in-memory caching"""
-
-    def __init__(self):
-        self._cache: dict[str, dict[str, Any]] = {}
-        self._default_client = TokenClient()
-
-    async def get_token_details(
-        self, token_id: str, force_refresh: bool = False
-    ) -> dict[str, Any]:
-        cache_key = f"token_{token_id}"
-        if not force_refresh and cache_key in self._cache:
-            return self._cache[cache_key]
-        data = await self._default_client.get_token_details(token_id, force_refresh)
-        self._cache[cache_key] = data
-        return data
-
-    async def get_gas_token(self, chain_code: str) -> dict[str, Any]:
-        return await self._default_client.get_gas_token(chain_code)
-
-
-class MockHyperlendClient:
-    """Mock client for testing"""
-
-    async def get_stable_markets(
-        self,
-        *,
-        required_underlying_tokens: float | None = None,
-        buffer_bps: int | None = None,
-        min_buffer_tokens: float | None = None,
-    ) -> dict[str, Any]:
-        return {
-            "markets": {
-                "0xMockToken": {
-                    "symbol": "USDC",
-                    "symbol_canonical": "usdc",
-                    "display_symbol": "USDC",
-                    "reserve": {},
-                    "decimals": 6,
-                    "headroom": 1000000000000,
-                    "supply_cap": 5000000000000,
-                }
-            },
-            "notes": [],
-        }
-
-    async def get_assets_view(
-        self,
-        *,
-        user_address: str,
-    ) -> dict[str, Any]:
-        return {
-            "block_number": 12345,
-            "user": user_address,
-            "native_balance_wei": 0,
-            "native_balance": 0.0,
-            "assets": [],
-            "account_data": {
-                "total_collateral_base": 0,
-                "total_debt_base": 0,
-                "available_borrows_base": 0,
-                "current_liquidation_threshold": 0,
-                "ltv": 0,
-                "health_factor_wad": 0,
-                "health_factor": 0.0,
-            },
-            "base_currency_info": {
-                "marketReferenceCurrencyUnit": 100000000,
-                "marketReferenceCurrencyPriceInUsd": 100000000,
-                "networkBaseTokenPriceInUsd": 0,
-                "networkBaseTokenPriceDecimals": 8,
-            },
-        }
-
-    async def get_market_entry(
-        self,
-        *,
-        token: str,
-    ) -> dict[str, Any]:
-        return {
-            "symbol": "USDC",
-            "symbol_canonical": "usdc",
-            "display_symbol": "USDC",
-            "reserve": {},
-        }
-
-    async def get_lend_rate_history(
-        self,
-        *,
-        token: str,
-        lookback_hours: int,
-        force_refresh: bool | None = None,
-    ) -> dict[str, Any]:
-        return {
-            "history": [],
-        }
-
-
-async def example_sdk_usage():
-    """Direct client injection - inject only what you customize"""
-
-    custom_token_client = CachedTokenClient()
-    custom_hyperlend_client = MockHyperlendClient()
-
-    ClientManager(
-        clients={
-            "token": custom_token_client,
-            "hyperlend": custom_hyperlend_client,
-        },
-        skip_auth=True,
-    )
-    pass

wayfinder_paths/core/engine/__init__.py

@@ -1,5 +0,0 @@
-"""Core Engine Module"""
-
-from .StrategyJob import StrategyJob
-
-__all__ = ["StrategyJob", "GLOBAL_IMPORTS"]

wayfinder_paths/core/services/base.py

@@ -1,130 +0,0 @@
-from abc import ABC, abstractmethod
-from typing import Any
-
-from web3 import AsyncWeb3
-
-from wayfinder_paths.core.constants.base import DEFAULT_TRANSACTION_TIMEOUT
-
-
-class TokenTxn(ABC):
-    """Interface describing high-level EVM transaction builders."""
-
-    @abstractmethod
-    async def build_send(
-        self,
-        *,
-        token_id: str,
-        amount: float,
-        from_address: str,
-        to_address: str,
-        token_info: dict[str, Any] | None = None,
-    ) -> tuple[bool, dict[str, Any] | str]:
-        """Build raw transaction data for sending tokens."""
-
-    @abstractmethod
-    def build_erc20_approve(
-        self,
-        *,
-        chain_id: int,
-        token_address: str,
-        from_address: str,
-        spender: str,
-        amount: int,
-    ) -> tuple[bool, dict[str, Any] | str]:
-        """Build raw ERC20 approve transaction data."""
-
-    @abstractmethod
-    async def read_erc20_allowance(
-        self, chain: Any, token_address: str, from_address: str, spender_address: str
-    ) -> dict[str, Any]:
-        """Read allowance granted for a spender."""
-
-
-class EvmTxn(ABC):
-    """
-    Abstract base class for wallet providers.
-
-    This interface abstracts all blockchain interactions needed by adapters so the
-    rest of the codebase never touches raw web3 primitives. Implementations
-    are responsible for RPC resolution, gas estimation, signing, broadcasting and
-    transaction confirmations.
-    """
-
-    @abstractmethod
-    async def broadcast_transaction(
-        self,
-        transaction: dict[str, Any],
-        *,
-        wait_for_receipt: bool = True,
-        timeout: int = DEFAULT_TRANSACTION_TIMEOUT,
-    ) -> tuple[bool, Any]:
-        """
-        Sign and broadcast a transaction dict.
-
-        Providers must handle gas estimation, gas pricing, nonce selection, signing
-        and submission internally so callers can simply pass the transaction data.
-
-        Args:
-            transaction: Dictionary describing the transaction (to, data, value, etc.)
-            wait_for_receipt: Whether to wait for the transaction receipt
-            timeout: Receipt timeout in seconds
-        """
-        pass
-
-    @abstractmethod
-    async def transaction_succeeded(
-        self, tx_hash: str, chain_id: int, timeout: int = 120
-    ) -> bool:
-        """
-        Check if a transaction hash succeeded on-chain.
-
-        Args:
-            tx_hash: Transaction hash to inspect
-            chain_id: Chain ID where the transaction was broadcast
-            timeout: Maximum seconds to wait for a receipt
-
-        Returns:
-            Boolean indicating whether the transaction completed successfully.
-        """
-        pass
-
-    @abstractmethod
-    def get_web3(self, chain_id: int) -> AsyncWeb3:
-        """
-        Return an AsyncWeb3 instance configured for the given chain.
-
-        Implementations may create new instances per call or pull from an internal
-        cache, but they must document whether the caller is responsible for closing
-        the underlying HTTP session.
-        """
-        pass
-
-
-class Web3Service(ABC):
-    """Facade that exposes low-level wallet access and higher-level EVM helpers."""
-
-    @property
-    @abstractmethod
-    def evm_transactions(self) -> EvmTxn:
-        """Return the wallet provider responsible for RPC, signing, and broadcasting."""
-
-    @property
-    @abstractmethod
-    def token_transactions(self) -> TokenTxn:
-        """Returns TokenTxn, for sends and swaps of any token"""
-
-    async def broadcast_transaction(
-        self,
-        transaction: dict[str, Any],
-        *,
-        wait_for_receipt: bool = True,
-        timeout: int = DEFAULT_TRANSACTION_TIMEOUT,
-    ) -> tuple[bool, Any]:
-        """Proxy convenience wrapper to underlying wallet provider."""
-        return await self.evm_transactions.broadcast_transaction(
-            transaction, wait_for_receipt=wait_for_receipt, timeout=timeout
-        )
-
-    def get_web3(self, chain_id: int):
-        """Expose underlying web3 provider for ABI encoding helpers."""
-        return self.evm_transactions.get_web3(chain_id)