wayfinder-paths 0.1.7__py3-none-any.whl

wayfinder_paths/strategies/basis_trading_strategy/types.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+
+@dataclass
+class BasisCandidate:
+    """Represents a potential basis trading opportunity."""
+
+    coin: str
+    spot_pair: str
+    spot_asset_id: int
+    perp_asset_id: int
+    mark_price: float
+    target_leverage: int
+    ctx: dict[str, Any]
+    spot_book: dict[str, Any]
+    open_interest_base: float
+    open_interest_usd: float
+    day_notional_usd: float
+    order_usd: float
+    depth_checks: dict[str, dict[str, Any]]
+    margin_table_id: int | None = None
+
+
+@dataclass
+class BasisPosition:
+    """Tracks an active basis position."""
+
+    coin: str
+    spot_asset_id: int
+    perp_asset_id: int
+    spot_amount: float
+    perp_amount: float
+    entry_price: float
+    leverage: int
+    entry_timestamp: int
+    funding_collected: float = 0.0

wayfinder_paths/strategies/config.py

@@ -0,0 +1,85 @@
+"""
+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(), {})

wayfinder_paths/strategies/hyperlend_stable_yield_strategy/README.md

@@ -0,0 +1,100 @@
+# Hyperlend Stable Yield Strategy
+
+- Entrypoint: `strategies.hyperlend_stable_yield_strategy.strategy.HyperlendStableYieldStrategy`
+- Manifest: `manifest.yaml`
+- Examples: `examples.json`
+- Tests: `test_strategy.py`
+
+## What it does
+
+Allocates USDT0 on HyperEVM across HyperLend stablecoin markets. The strategy:
+
+1. Pulls USDT0 (plus a configurable HYPE gas buffer) from the main wallet into the strategy wallet.
+2. Samples HyperLend hourly rate history, applies a bootstrap tournament (horizon = 6h, blocks = 6h, 4,000 trials, 7-day half-life) to estimate which stablecoin should outperform.
+3. Tops up the small HYPE gas buffer if needed, swaps USDT0 into the target stablecoin, and supplies it to HyperLend.
+4. Enforces a hysteresis rotation policy so minor APY noise does not churn capital.
+
+## Policy
+
+The manifest policy simply locks transactions to the strategy wallet ID:
+
+```
+(wallet.id == 'FORMAT_WALLET_ID')
+```
+
+## Key parameters
+
+- `MIN_USDT0_DEPOSIT_AMOUNT = 1`
+- `GAS_MAXIMUM = 0.1` HYPE (max accepted per deposit)
+- `HORIZON_HOURS = 6`, `BLOCK_LEN = 6`, `TRIALS = 4000`
+- `HYSTERESIS_DWELL_HOURS = 168`, `HYSTERESIS_Z = 1.15`
+- `ROTATION_COOLDOWN = 168 hours`
+- `APY_REBALANCE_THRESHOLD = 0.0035` (35 bps edge required to rotate when not short-circuiting)
+- `MIN_STABLE_SWAP_TOKENS = 1e-3` → dust threshold when sweeping balances
+
+## Adapters used
+
+- `BalanceAdapter` for token/pool balances and orchestrating wallet transfers with ledger tracking.
+- `TokenAdapter` for metadata (USDT0, HYPE, wrapping info).
+- `LedgerAdapter` for net deposit + rotation history.
+- `BRAPAdapter` to source quotes/swap stablecoins.
+- `HyperlendAdapter` for asset views, lend/withdraw ops, supply caps.
+- `LocalTokenTxnService` via `DefaultWeb3Service` for low-level sends/approvals leveraged by the adapters.
+
+## Actions
+
+### Deposit
+
+- Validates USDT0 and HYPE balances in the main wallet.
+- Transfers HYPE into the strategy wallet when a top-up is required, ensuring the strategy maintains the configured buffer.
+- Moves USDT0 from the main wallet into the strategy wallet through `BalanceAdapter.move_from_main_wallet_to_strategy_wallet`.
+- Clears cached asset snapshots so the next update starts from on-chain reality.
+
+### Update
+
+- Refreshes HyperLend asset snapshots, calculates tournament winners, and filters markets that respect supply caps + buffer requirements.
+- Reads rotation history through `LedgerAdapter.get_strategy_latest_transactions` to enforce the cooldown (unless the short-circuit policy is triggered).
+- If a new asset wins the tournament and passes hysteresis checks, BRAP quotes are fetched and executed to rotate into the better performer.
+- Sweeps residual stable balances, lends via `HyperlendAdapter`, and records ledger operations.
+
+### Status
+
+`_status()` returns:
+
+- `portfolio_value`: active lend balance (converted to float),
+- `net_deposit`: fetched from `LedgerAdapter`,
+- `strategy_status`: includes current lent asset, APY, idle balances, and tournament projections.
+
+### Withdraw
+
+- Unwinds existing HyperLend positions, swaps back to USDT0 when necessary, returns USDT0 and residual HYPE to the main wallet via `BalanceAdapter`, and clears cached state.
+
+## Running locally
+
+```bash
+# Install dependencies
+poetry install
+
+# Generate main wallet (writes wallets.json)
+# Creates a main wallet (or use 'just create-strategy' which auto-creates wallets)
+poetry run python wayfinder_paths/scripts/make_wallets.py -n 1
+
+# Copy config and edit credentials (or rely on env vars)
+cp wayfinder_paths/config.example.json config.json
+
+# Check status / health
+poetry run python wayfinder_paths/run_strategy.py hyperlend_stable_yield_strategy --action status --config $(pwd)/config.json
+
+# Perform a deposit/update/withdraw cycle
+poetry run python wayfinder_paths/run_strategy.py hyperlend_stable_yield_strategy --action deposit --main-token-amount 25 --gas-token-amount 0.02 --config $(pwd)/config.json
+poetry run python wayfinder_paths/run_strategy.py hyperlend_stable_yield_strategy --action update --config $(pwd)/config.json
+poetry run python wayfinder_paths/run_strategy.py hyperlend_stable_yield_strategy --action withdraw --config $(pwd)/config.json
+```
+
+Use the manifest directly if you prefer:
+
+```bash
+poetry run python wayfinder_paths/run_strategy.py --manifest wayfinder_paths/strategies/hyperlend_stable_yield_strategy/manifest.yaml --action status --config $(pwd)/config.json
+```
+
+Wallet addresses/labels are auto-resolved from `wallets.json`. Set `NETWORK=testnet` in your config to run the orchestration without touching live HyperEVM endpoints.

wayfinder_paths/strategies/hyperlend_stable_yield_strategy/examples.json

@@ -0,0 +1,8 @@
+{
+  "smoke": {
+    "deposit": {},
+    "update": {},
+    "status": {},
+    "withdraw": {}
+  }
+}

wayfinder_paths/strategies/hyperlend_stable_yield_strategy/manifest.yaml

@@ -0,0 +1,7 @@
+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"]