wayfinder-paths 0.1.1__tar.gz → 0.1.3__tar.gz

{wayfinder_paths-0.1.1 → wayfinder_paths-0.1.3}/PKG-INFO

@@ -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:

{wayfinder_paths-0.1.1 → wayfinder_paths-0.1.3}/README.md

@@ -625,55 +625,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:

{wayfinder_paths-0.1.1 → wayfinder_paths-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "wayfinder-paths"
-version = "0.1.1"
+version = "0.1.3"
 description = "Wayfinder Path: strategies and adapters"
 readme = "README.md"
 authors = ["Wayfinder <dev@wayfinder.ai>"]

wayfinder_paths-0.1.3/wayfinder_paths/abis/generic/erc20.json

@@ -0,0 +1,383 @@
+[
+    {
+        "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-0.1.1 → wayfinder_paths-0.1.3}/wayfinder_paths/core/strategies/Strategy.py

@@ -6,6 +6,7 @@ from typing import Any, TypedDict
 from loguru import logger
 
 from wayfinder_paths.core.services.base import Web3Service
+from wayfinder_paths.core.strategies.descriptors import StratDescriptor
 
 
 class StatusDict(TypedDict):
@@ -19,8 +20,7 @@ StatusTuple = tuple[bool, str]
 
 class Strategy(ABC):
     name: str = None
-    description: str = None
-    summary: str = None
+    INFO: StratDescriptor = None
 
     def __init__(
         self,
@@ -90,7 +90,7 @@ class Strategy(ABC):
         pass
 
     @staticmethod
-    def policies() -> list[str]:
+    async def policies() -> list[str]:
         """Return policy strings for this strategy (Django-compatible)."""
         raise NotImplementedError
 

wayfinder_paths-0.1.3/wayfinder_paths/core/strategies/descriptors.py

@@ -0,0 +1,80 @@
+from enum import Enum
+from typing import Any
+
+from pydantic import BaseModel
+
+
+class Volatility(Enum):
+    LOW = "low"
+    MEDIUM = "medium"
+    HIGH = "high"
+
+
+class Frequency(Enum):
+    LOW = "low"
+    MEDIUM = "medium"
+    HIGH = "high"
+
+
+class Directionality(Enum):
+    LONG = "Long"
+    SHORT = "Short"
+    MARKET_NEUTRAL = "market_neutral"
+    DELTA_NEUTRAL = "delta_neutral"
+
+
+class Complexity(Enum):
+    LOW = "low"
+    MEDIUM = "medium"
+    HIGH = "high"
+
+
+class TokenExposure(Enum):
+    STABLECOINS = "Stablecoins"
+    MAJORS = "Majors"
+    ALTS = "Alts"
+
+
+# Default token rewards for all strategies
+DEFAULT_TOKEN_REWARDS = [
+    {
+        "symbol": "B3",
+        "name": "B3",
+        "address": "0xB3B3B3B3B3B3B3B3B3B3B3B3B3B3B3B3B3B3B3B3",
+        "image_url": "https://storage.googleapis.com/prod-wayfinder-app-assets/asset-icons/B3.png",
+    },
+]
+
+
+class StratDescriptor(BaseModel):
+    description: str
+
+    summary: str
+
+    gas_token_symbol: str
+    gas_token_id: str
+    deposit_token_id: str
+    minimum_net_deposit: float
+    gas_maximum: float
+    gas_threshold: float
+
+    available_rewards: dict[str, Any] = {
+        "token_rewards": DEFAULT_TOKEN_REWARDS,
+        "point_rewards": None,
+    }
+
+    # risk indicators
+    volatility: Volatility
+    volatility_description_short: str
+    directionality: Directionality
+    directionality_description: str
+    complexity: Complexity
+    complexity_description: str
+    token_exposure: TokenExposure
+    token_exposure_description: str
+    frequency: Frequency
+    frequency_description: str
+
+    return_drivers: list[str]
+
+    config: dict[str, Any]

{wayfinder_paths-0.1.1 → wayfinder_paths-0.1.3}/wayfinder_paths/core/utils/evm_helpers.py

@@ -5,7 +5,9 @@ This module provides reusable functions for EVM-related operations that are shar
 across multiple adapters, extracted from evm_transaction_adapter.
 """
 
+import json
 import os
+from pathlib import Path
 from typing import Any
 
 from loguru import logger
@@ -163,3 +165,40 @@ def resolve_private_key_for_from_address(
 
     # Fallback to environment variables
     return os.getenv("PRIVATE_KEY_VAULT") or os.getenv("PRIVATE_KEY")
+
+
+async def _get_abi(chain_id: int, address: str) -> str | None:
+    os.makedirs(f"abis/{chain_id}/", exist_ok=True)
+
+    abi_file = f"abis/{chain_id}/{address}.json"
+    if not os.path.exists(abi_file):
+        raise ValueError(
+            f"There is no downloaded ABI for {address} on chain {chain_id} -- please download it to ({abi_file})  (make sure to get the implementation if this address is a proxy)"
+        )
+
+    with open(abi_file) as f:
+        abi = f.read()
+
+    return abi
+
+
+# We filter ABIs for Privy Policy since most of the abi is useless, and we don't wanna upload big ABIs for both size and readability reasons.
+async def get_abi_filtered(
+    chain_id: int, address: str, function_names: list[str]
+) -> list | None:
+    full_abi = await _get_abi(chain_id, address)
+    if full_abi is None:
+        raise Exception("Could not pull ABI, get_abi returned None")
+    abi_json = json.loads(full_abi)
+    filtered_abi = [
+        item
+        for item in abi_json
+        if item.get("type") == "function" and item.get("name") in function_names
+    ]
+    return filtered_abi
+
+
+with open(Path(__file__).parent.parent.parent.joinpath("abis/generic/erc20.json")) as f:
+    erc20_abi_raw = f.read()
+
+ERC20_ABI = json.loads(erc20_abi_raw)