wayfinder-paths 0.1.9__py3-none-any.whl → 0.1.11__py3-none-any.whl

wayfinder_paths/config.example.json

@@ -1,22 +0,0 @@
-{
-    "user": {
-      "username": "your_username",
-      "password": "your_password",
-      "refresh_token": null,
-      "api_key": "sk_live_abc123..."
-    },
-    "system": {
-      "api_base_url": "https://wayfinder.ai/api/v1",
-      "api_key": "sk_live_abc123...",
-      "wallets_path": "wallets.json"
-    },
-    "strategy": {
-      "rpc_urls": {
-        "1": "https://eth.llamarpc.com",
-        "42161": "https://arb1.arbitrum.io/rpc",
-        "8453": "https://mainnet.base.org",
-        "solana": "https://api.mainnet-beta.solana.com",
-        "999": "https://rpc.hyperliquid.xyz/evm"
-      }
-    }
-  }

wayfinder_paths/core/engine/manifest.py

@@ -1,97 +0,0 @@
-from typing import Any
-
-import yaml
-from pydantic import BaseModel, Field, validator
-
-
-class AdapterRequirement(BaseModel):
-    name: str = Field(
-        ..., description="Adapter symbolic name (e.g., BALANCE, HYPERLIQUID)"
-    )
-    capabilities: list[str] = Field(default_factory=list)
-
-
-class AdapterManifest(BaseModel):
-    schema_version: str = Field(default="0.1")
-    entrypoint: str
-    capabilities: list[str] = Field(default_factory=list)
-    dependencies: list[str] = Field(default_factory=list)
-
-    @validator("entrypoint")
-    def validate_entrypoint(cls, v: str) -> str:
-        if "." not in v:
-            raise ValueError("entrypoint must be a full import path")
-        return v
-
-    @validator("capabilities")
-    def validate_capabilities(cls, v: list[str]) -> list[str]:
-        if not v:
-            raise ValueError("capabilities cannot be empty")
-        return v
-
-    @validator("dependencies")
-    def validate_dependencies(cls, v: list[str]) -> list[str]:
-        if not v:
-            raise ValueError("dependencies cannot be empty")
-        return v
-
-
-class StrategyManifest(BaseModel):
-    schema_version: str = Field(default="0.1")
-    entrypoint: str = Field(
-        ...,
-        description="Python path to class, e.g. strategies.funding_rate_strategy.FundingRateStrategy",
-    )
-    name: str | None = Field(
-        default=None,
-        description="Unique name identifier for this strategy instance. Used to look up dedicated wallet in wallets.json by label.",
-    )
-    permissions: dict[str, Any] = Field(default_factory=dict)
-    adapters: list[AdapterRequirement] = Field(default_factory=list)
-
-    @validator("entrypoint")
-    def validate_entrypoint(cls, v: str) -> str:
-        if "." not in v:
-            raise ValueError(
-                "entrypoint must be a full import path to a Strategy class"
-            )
-        return v
-
-    @validator("permissions")
-    def validate_permissions(cls, v: dict) -> dict:
-        if "policy" not in v:
-            raise ValueError("permissions.policy is required")
-        if not v["policy"]:
-            raise ValueError("permissions.policy cannot be empty")
-        return v
-
-    @validator("adapters")
-    def validate_adapters(cls, v: list) -> list:
-        if not v:
-            raise ValueError("adapters cannot be empty")
-        return v
-
-
-def load_adapter_manifest(path: str) -> AdapterManifest:
-    with open(path) as f:
-        data = yaml.safe_load(f)
-    return AdapterManifest(**data)
-
-
-def load_strategy_manifest(path: str) -> StrategyManifest:
-    with open(path) as f:
-        data = yaml.safe_load(f)
-    return StrategyManifest(**data)
-
-
-def load_manifest(path: str) -> StrategyManifest:
-    """Legacy function for backward compatibility."""
-    return load_strategy_manifest(path)
-
-
-def validate_manifest(manifest: StrategyManifest) -> None:
-    # Simple v0.1 rules: require at least one adapter and permissions.policy
-    if not manifest.adapters:
-        raise ValueError("Manifest must declare at least one adapter")
-    if "policy" not in manifest.permissions:
-        raise ValueError("Manifest.permissions must include 'policy'")

wayfinder_paths/scripts/validate_manifests.py

@@ -1,213 +0,0 @@
-#!/usr/bin/env python3
-"""
-Manifest Validator
-
-Validates all adapter and strategy manifests in the repository.
-"""
-
-import sys
-from pathlib import Path
-
-from loguru import logger
-
-# Add parent to path for imports
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
-from wayfinder_paths.core.adapters.BaseAdapter import BaseAdapter
-from wayfinder_paths.core.engine.manifest import (
-    load_adapter_manifest,
-    load_strategy_manifest,
-)
-from wayfinder_paths.core.strategies.Strategy import Strategy
-
-
-def verify_entrypoint(entrypoint: str) -> tuple[bool, str | None]:
-    """Verify entrypoint is importable. Returns (success, error_message)."""
-    try:
-        module_path, class_name = entrypoint.rsplit(".", 1)
-        module = __import__(module_path, fromlist=[class_name], level=0)
-        getattr(module, class_name)  # Verify class exists
-        return True, None
-    except ImportError as e:
-        return False, f"Import error: {str(e)}"
-    except AttributeError as e:
-        return False, f"Class not found: {str(e)}"
-    except Exception as e:
-        return False, f"Unexpected error: {str(e)}"
-
-
-def verify_adapter_class(entrypoint: str) -> tuple[bool, str | None]:
-    """Verify entrypoint is an adapter class."""
-    valid, error = verify_entrypoint(entrypoint)
-    if not valid:
-        return False, error
-
-    try:
-        module_path, class_name = entrypoint.rsplit(".", 1)
-        module = __import__(module_path, fromlist=[class_name], level=0)
-        adapter_class = getattr(module, class_name)
-
-        if not issubclass(adapter_class, BaseAdapter):
-            return False, f"{class_name} is not a BaseAdapter"
-        return True, None
-    except Exception as e:
-        return False, f"Error verifying adapter: {str(e)}"
-
-
-def verify_strategy_class(entrypoint: str) -> tuple[bool, str | None]:
-    """Verify entrypoint is a strategy class."""
-    valid, error = verify_entrypoint(entrypoint)
-    if not valid:
-        return False, error
-
-    try:
-        module_path, class_name = entrypoint.rsplit(".", 1)
-        module = __import__(module_path, fromlist=[class_name], level=0)
-        strategy_class = getattr(module, class_name)
-
-        if not issubclass(strategy_class, Strategy):
-            return False, f"{class_name} is not a Strategy"
-        return True, None
-    except Exception as e:
-        return False, f"Error verifying strategy: {str(e)}"
-
-
-# Capabilities are only declared in manifest - no code validation needed
-# Manifest is the single source of truth for capabilities
-
-
-def verify_dependencies(dependencies: list[str]) -> tuple[bool, list[str]]:
-    """Verify dependencies are importable. Returns (valid, error_messages)."""
-    errors = []
-
-    for dep in dependencies:
-        # Try to import from core.clients
-        try:
-            __import__(f"core.clients.{dep}", fromlist=[dep], level=0)
-        except ImportError:
-            errors.append(f"Dependency '{dep}' not found in core.clients")
-        except Exception as e:
-            errors.append(f"Error importing dependency '{dep}': {str(e)}")
-
-    return len(errors) == 0, errors
-
-
-def validate_adapter_manifest(manifest_path: str) -> tuple[bool, list[str]]:
-    """Validate adapter manifest. Returns (valid, error_messages)."""
-    errors = []
-
-    try:
-        manifest = load_adapter_manifest(manifest_path)
-    except Exception as e:
-        return False, [f"Schema error: {str(e)}"]
-
-    # Verify entrypoint
-    valid, error = verify_adapter_class(manifest.entrypoint)
-    if not valid:
-        errors.append(f"Entrypoint validation failed: {error}")
-        return False, errors
-
-    # Verify dependencies
-    valid, dep_errors = verify_dependencies(manifest.dependencies)
-    if not valid:
-        errors.extend(dep_errors)
-
-    return len(errors) == 0, errors
-
-
-def validate_strategy_manifest(manifest_path: str) -> tuple[bool, list[str]]:
-    """Validate strategy manifest. Returns (valid, error_messages)."""
-    errors = []
-
-    try:
-        manifest = load_strategy_manifest(manifest_path)
-    except Exception as e:
-        return False, [f"Schema error: {str(e)}"]
-
-    # Verify entrypoint
-    valid, error = verify_strategy_class(manifest.entrypoint)
-    if not valid:
-        errors.append(f"Entrypoint validation failed: {error}")
-        return False, errors
-
-    # Permissions are already validated by Pydantic model
-
-    return len(errors) == 0, errors
-
-
-def find_adapter_manifests() -> list[Path]:
-    """Find all adapter manifest files."""
-    manifests = []
-    adapter_dir = Path(__file__).parent.parent / "adapters"
-    if adapter_dir.exists():
-        for adapter_path in adapter_dir.iterdir():
-            manifest_path = adapter_path / "manifest.yaml"
-            if manifest_path.exists():
-                manifests.append(manifest_path)
-    return manifests
-
-
-def find_strategy_manifests() -> list[Path]:
-    """Find all strategy manifest files."""
-    manifests = []
-    strategy_dir = Path(__file__).parent.parent / "strategies"
-    if strategy_dir.exists():
-        for strategy_path in strategy_dir.iterdir():
-            manifest_path = strategy_path / "manifest.yaml"
-            if manifest_path.exists():
-                manifests.append(manifest_path)
-    return manifests
-
-
-def main() -> int:
-    """Main validation function. Returns 0 on success, 1 on failure."""
-    logger.info("Validating all manifests...")
-
-    all_valid = True
-    error_count = 0
-
-    # Validate adapter manifests
-    logger.info("\n=== Validating Adapter Manifests ===")
-    adapter_manifests = find_adapter_manifests()
-    for manifest_path in sorted(adapter_manifests):
-        logger.info(f"Validating {manifest_path}...")
-        valid, errors = validate_adapter_manifest(str(manifest_path))
-        if valid:
-            logger.success(f"✅ {manifest_path.name} - Valid")
-        else:
-            logger.error(f"❌ {manifest_path.name} - Invalid")
-            for error in errors:
-                logger.error(f"   {error}")
-            all_valid = False
-            error_count += len(errors)
-
-    # Validate strategy manifests
-    logger.info("\n=== Validating Strategy Manifests ===")
-    strategy_manifests = find_strategy_manifests()
-    for manifest_path in sorted(strategy_manifests):
-        logger.info(f"Validating {manifest_path}...")
-        valid, errors = validate_strategy_manifest(str(manifest_path))
-        if valid:
-            logger.success(f"✅ {manifest_path.name} - Valid")
-        else:
-            logger.error(f"❌ {manifest_path.name} - Invalid")
-            for error in errors:
-                logger.error(f"   {error}")
-            all_valid = False
-            error_count += len(errors)
-
-    # Summary
-    logger.info("\n=== Summary ===")
-    if all_valid:
-        logger.success(
-            f"✅ All manifests valid! ({len(adapter_manifests)} adapters, "
-            f"{len(strategy_manifests)} strategies)"
-        )
-        return 0
-    else:
-        logger.error(f"❌ Validation failed with {error_count} error(s)")
-        return 1
-
-
-if __name__ == "__main__":
-    sys.exit(main())

wayfinder_paths/strategies/basis_trading_strategy/manifest.yaml

@@ -1,23 +0,0 @@
-schema_version: "0.1"
-entrypoint: "wayfinder_paths.strategies.basis_trading_strategy.strategy.BasisTradingStrategy"
-permissions:
-  policy: |
-    (wallet.id == 'FORMAT_WALLET_ID') AND (
-      # Allow Hyperliquid EIP-712 order actions
-      (action.type == 'hyperliquid_order') OR
-      (action.type == 'hyperliquid_cancel') OR
-      (action.type == 'hyperliquid_transfer') OR
-      # Allow USDC transfers to Hyperliquid bridge
-      (action.type == 'erc20_transfer' AND action.to == '0x2Df1c51E09aECF9cacB7bc98cB1742757f163dF7') OR
-      # Allow USDC withdraw to main wallet
-      (action.type == 'erc20_transfer' AND action.to == main_wallet.address)
-    )
-adapters:
-  - name: "BALANCE"
-    capabilities: ["wallet_read", "wallet_transfer"]
-  - name: "LEDGER"
-    capabilities: ["ledger.read", "ledger.write", "strategy.transactions"]
-  - name: "TOKEN"
-    capabilities: ["token.read"]
-  - name: "HYPERLIQUID"
-    capabilities: ["market.read", "market.meta", "market.funding", "market.candles", "market.orderbook", "order.execute", "order.cancel", "position.manage", "transfer"]

wayfinder_paths/strategies/hyperlend_stable_yield_strategy/manifest.yaml

@@ -1,7 +0,0 @@
-schema_version: "0.1"
-entrypoint: "strategies.hyperlend_stable_yield_strategy.strategy.HyperlendStableYieldStrategy"
-permissions:
-  policy: "(wallet.id == 'FORMAT_WALLET_ID')"
-adapters:
-  - name: "BALANCE"
-    capabilities: ["wallet_read"]

wayfinder_paths/strategies/stablecoin_yield_strategy/manifest.yaml

@@ -1,17 +0,0 @@
-schema_version: "0.1"
-entrypoint: "strategies.stablecoin_yield_strategy.strategy.StablecoinYieldStrategy"
-permissions:
-  policy: "(wallet.id == 'FORMAT_WALLET_ID') && ((eth.tx.data[0..10] == '0x095ea7b3' && eth.tx.data[34..74] == 'f75584ef6673ad213a685a1b58cc0330b8ea22cf') || (eth.tx.to == '0xF75584eF6673aD213a685a1B58Cc0330B8eA22Cf'))"
-adapters:
-  - name: "BALANCE"
-    capabilities: ["wallet_read", "wallet_transfer"]
-  - name: "POOL"
-    capabilities: ["pool.read", "pool.analytics"]
-  - name: "BRAP"
-    capabilities: ["swap.quote", "swap.execute"]
-  - name: "TOKEN"
-    capabilities: ["token.read"]
-  - name: "LEDGER"
-    capabilities: ["ledger.read", "strategy.transactions"]
-  - name: "EVM_TRANSACTION"
-    capabilities: ["wallet_transfer"]

wayfinder_paths/templates/adapter/manifest.yaml

@@ -1,6 +0,0 @@
-schema_version: "0.1"
-entrypoint: "adapters.my_adapter.adapter.MyAdapter"
-capabilities:
-  - "example.op"
-dependencies:
-  - "MyClient"

wayfinder_paths/templates/strategy/manifest.yaml

@@ -1,8 +0,0 @@
-schema_version: "0.1"
-entrypoint: "strategies.my_strategy.strategy.MyStrategy"
-name: "my_strategy"  # Unique name for this strategy instance (used for wallet lookup)
-permissions:
-  policy: "(wallet.id == 'FORMAT_WALLET_ID')"
-adapters:
-  - name: "BALANCE"
-    capabilities: ["wallet_read"]