wayfinder-paths 0.1.22__py3-none-any.whl → 0.1.24__py3-none-any.whl

wayfinder_paths/templates/adapter/adapter.py

@@ -1,16 +0,0 @@
-from typing import Any
-
-from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
-
-
-class MyAdapter(BaseAdapter):
-    adapter_type: str = "MY_ADAPTER"
-
-    def __init__(self, config: dict[str, Any] | None = None):
-        super().__init__("my_adapter", config)
-
-    async def connect(self) -> bool:
-        return True
-
-    async def example_operation(self, **kwargs) -> tuple[bool, str]:
-        return (True, "example.op executed")

wayfinder_paths/templates/adapter/examples.json

@@ -1,8 +0,0 @@
-{
-  "connect": {},
-  "example_operation": {
-    "args": {"foo": "bar"}
-  }
-}
-
-

wayfinder_paths/templates/adapter/test_adapter.py

@@ -1,30 +0,0 @@
-import pytest
-
-# TODO: Replace MyAdapter with your actual adapter class name
-from .adapter import MyAdapter
-
-# For mocking clients, uncomment when needed:
-
-
-class TestMyAdapter:
-    @pytest.fixture
-    def adapter(self):
-        return MyAdapter(config={})
-
-    @pytest.mark.asyncio
-    async def test_health_check(self, adapter):
-        health = await adapter.health_check()
-        assert isinstance(health, dict)
-        assert health.get("status") in {"healthy", "unhealthy", "error"}
-
-    @pytest.mark.asyncio
-    async def test_connect(self, adapter):
-        ok = await adapter.connect()
-        assert isinstance(ok, bool)
-
-    def test_capabilities(self, adapter):
-        assert hasattr(adapter, "adapter_type")
-
-    @pytest.mark.asyncio
-    async def test_basic_functionality(self, adapter):
-        assert adapter is not None

wayfinder_paths/templates/strategy/README.md

@@ -1,186 +0,0 @@
-# Strategy Template
-
-This template provides scaffolding for a new strategy.
-
-## Quick Start
-
-1. Copy the template:
-   ```bash
-   cp -r wayfinder_paths/templates/strategy wayfinder_paths/strategies/my_strategy
-   ```
-   Or use the convenience command:
-   ```bash
-   just create-strategy "My Strategy Name"
-   ```
-2. Rename the class in `strategy.py` to match your strategy name.
-3. Implement the required methods (`deposit`, `update`, `exit`, `_status`).
-4. Add tests in `test_strategy.py`.
-5. Fill out `examples.json` with sample CLI invocations.
-
-## Directory Structure
-
-```
-my_strategy/
-├── strategy.py          # Strategy implementation
-├── examples.json        # Example CLI payloads
-├── test_strategy.py     # Pytest tests
-└── README.md            # Strategy documentation
-```
-
-## Required Methods
-
-```python
-async def deposit(self, main_token_amount: float, gas_token_amount: float) -> StatusTuple:
-    """Move funds from main wallet into strategy wallet and deploy capital."""
-
-async def update(self) -> StatusTuple:
-    """Periodic rebalance/optimization loop."""
-
-async def exit(self, **kwargs) -> StatusTuple:
-    """Transfer funds from strategy wallet back to main wallet."""
-
-async def _status(self) -> StatusDict:
-    """Return portfolio_value, net_deposit, and strategy_status."""
-```
-
-## Optional Methods
-
-```python
-async def withdraw(self, **kwargs) -> StatusTuple:
-    """Unwind positions. Default implementation unwinds ledger operations."""
-
-async def partial_liquidate(self, usd_value: float) -> tuple[bool, LiquidationResult]:
-    """Liquidate a portion of the position by USD value."""
-
-async def setup(self) -> None:
-    """Post-construction initialization."""
-
-async def health_check(self) -> dict:
-    """Check strategy and adapter health."""
-```
-
-## Strategy Structure
-
-```python
-from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
-from wayfinder_paths.adapters.balance_adapter.adapter import BalanceAdapter
-
-
-class MyStrategy(Strategy):
-    name = "My Strategy"
-
-    def __init__(self, config: dict | None = None, **kwargs):
-        super().__init__(config, **kwargs)
-        self.config = config or {}
-
-        # Initialize and register adapters
-        balance_adapter = BalanceAdapter(
-            self.config,
-            main_wallet_signing_callback=kwargs.get("main_wallet_signing_callback"),
-            strategy_wallet_signing_callback=kwargs.get("strategy_wallet_signing_callback"),
-        )
-        self.register_adapters([balance_adapter])
-        self.balance_adapter = balance_adapter
-
-    async def deposit(
-        self, main_token_amount: float = 0.0, gas_token_amount: float = 0.0
-    ) -> StatusTuple:
-        if main_token_amount <= 0:
-            return (False, "Nothing to deposit")
-
-        # Implement deposit logic
-        return (True, f"Deposited {main_token_amount} tokens")
-
-    async def update(self) -> StatusTuple:
-        # Implement rebalancing logic
-        return (True, "Update complete")
-
-    async def exit(self, **kwargs) -> StatusTuple:
-        # Implement exit logic
-        return (True, "Exit complete")
-
-    async def _status(self) -> StatusDict:
-        return {
-            "portfolio_value": 0.0,
-            "net_deposit": 0.0,
-            "strategy_status": {"message": "healthy"},
-            "gas_available": 0.0,
-            "gassed_up": True,
-        }
-```
-
-## Testing
-
-Create `test_strategy.py` using `examples.json`:
-
-```python
-import pytest
-from pathlib import Path
-from tests.test_utils import load_strategy_examples
-from .strategy import MyStrategy
-
-
-@pytest.mark.asyncio
-async def test_smoke():
-    """Basic strategy lifecycle test."""
-    examples = load_strategy_examples(Path(__file__))
-    smoke_example = examples["smoke"]
-
-    s = MyStrategy()
-
-    # Deposit
-    deposit_params = smoke_example.get("deposit", {})
-    ok, _ = await s.deposit(**deposit_params)
-    assert ok
-
-    # Update
-    ok, _ = await s.update()
-    assert ok
-
-    # Status
-    st = await s._status()
-    assert "portfolio_value" in st
-    assert "net_deposit" in st
-    assert "strategy_status" in st
-```
-
-Run tests:
-
-```bash
-poetry run pytest wayfinder_paths/strategies/my_strategy/ -v
-```
-
-## Running the Strategy
-
-```bash
-# Install dependencies
-poetry install
-
-# Generate wallets
-just create-wallets
-just create-wallet my_strategy
-
-# Configure API key in config.json
-
-# Check status
-poetry run python wayfinder_paths/run_strategy.py my_strategy --action status --config config.json
-
-# Deposit
-poetry run python wayfinder_paths/run_strategy.py my_strategy \
-    --action deposit --main-token-amount 100 --gas-token-amount 0.01 --config config.json
-
-# Run update
-poetry run python wayfinder_paths/run_strategy.py my_strategy --action update --config config.json
-
-# Withdraw
-poetry run python wayfinder_paths/run_strategy.py my_strategy --action withdraw --config config.json
-```
-
-## Best Practices
-
-- Return `(success: bool, message: str)` tuples from all action methods
-- Always populate `portfolio_value`, `net_deposit`, and `strategy_status` in `_status`
-- Register adapters via `register_adapters()` in `__init__`
-- Use adapters for external operations, not clients directly
-- Keep strategy logic clear and well-documented
-- Add error handling with informative messages

wayfinder_paths/templates/strategy/examples.json

@@ -1,11 +0,0 @@
-{
-  "deposit": {
-    "main_token_amount": 100,
-    "gas_token_amount": 0.001
-  },
-  "update": {},
-  "status": {},
-  "withdraw": {}
-}
-
-

wayfinder_paths/templates/strategy/strategy.py

@@ -1,35 +0,0 @@
-from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
-
-
-class MyStrategy(Strategy):
-    name = "My Strategy"
-    description = "Short description of what the strategy does."
-    summary = "One-line summary for discovery."
-
-    def __init__(self):
-        super().__init__()
-
-    async def setup(self):
-        return None
-
-    async def deposit(
-        self, main_token_amount: float, gas_token_amount: float
-    ) -> StatusTuple:
-        return (True, "Deposit successful")
-
-    async def withdraw(self, amount: float | None = None) -> StatusTuple:
-        return await super().withdraw(amount=amount)
-
-    async def update(self) -> StatusTuple:
-        return (True, "Update successful")
-
-    async def _status(self) -> StatusDict:
-        return {
-            "portfolio_value": 0.0,
-            "net_deposit": 0.0,
-            "strategy_status": {},
-        }
-
-    @staticmethod
-    def policies() -> list[str]:
-        return []

wayfinder_paths/tests/test_smoke_manifest.py

@@ -1,63 +0,0 @@
-import pytest
-
-from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
-from wayfinder_paths.core.strategies.Strategy import StatusDict, StatusTuple, Strategy
-
-
-class FakeAdapter(BaseAdapter):
-    adapter_type = "FAKE"
-
-    async def connect(self) -> bool:
-        return True
-
-    async def get_balance(self, asset: str):
-        return {"asset": asset, "amount": 100}
-
-
-class FakeLedgerAdapter(BaseAdapter):
-    adapter_type = "LEDGER"
-
-    async def connect(self) -> bool:
-        return True
-
-    async def record_strategy_snapshot(self, **kwargs):
-        pass
-
-
-class FakeStrategy(Strategy):
-    name = "Fake Strategy"
-
-    async def deposit(self, amount: float = 0) -> StatusTuple:
-        return (True, "deposited")
-
-    async def update(self) -> StatusTuple:
-        return (True, "updated")
-
-    async def withdraw(self, amount: float = 0) -> StatusTuple:
-        return (True, "withdrew")
-
-    async def _status(self) -> StatusDict:
-        return {"total_earned": 0.0, "strategy_status": {"ok": True}}
-
-    @staticmethod
-    def policy() -> str:
-        return "wallet.id == 'TEST'"
-
-
-@pytest.mark.asyncio
-async def test_smoke_deposit_update_withdraw_status():
-    s = FakeStrategy(
-        config={
-            "strategy_wallet": {"address": "0x1234567890123456789012345678901234567890"}
-        }
-    )
-    s.register_adapters([FakeAdapter("fake")])
-    s.ledger_adapter = FakeLedgerAdapter("ledger")
-    ok, msg = await s.deposit(amount=1)
-    assert ok
-    ok, msg = await s.update()
-    assert ok
-    ok, msg = await s.withdraw(amount=1)
-    assert ok
-    st = await s.status()
-    assert "total_earned" in st