Skip to content
developing-wayfinder-strategies logo

Developing Wayfinder Strategies

developing-wayfinder-strategies

Best practices for developing, testing, and iterating Wayfinder Paths strategies/adapters in this repo (data sources, manifests, safety rails).

SKILL.md

Full skill instructions

When to use

Use this skill when you are:

  • Designing a new strategy (or major refactor) in wayfinder_paths/​strategies/
  • Exploring adapter capabilities to build strategy logic
  • Adding tests, manifests, examples, or debugging strategy behavior

How to use

Follow the repo-specific workflow and patterns in these rule docs:

When designing a new strategy, start from the canonical reference for that style — see rules/​reference-strategies.md. It shows file layout, signal/​decide separation, snapshot conventions, and reconcile-friendly patterns the SDK expects.

On Shells Instance -- IMPORTANT

Only .wayfinder_runs/ persists across restarts, you can use just create-strategy — but this writes to wayfinder_paths/​strategies/ which won't survive. Move the strategy files under $WAYFINDER_RUNS_DIR/​strategies/<name>/:

core_run_strategy, core_get_adapters_and_strategies, and python -m wayfinder_paths.run_strategy <name> all auto-resolve runs-dir strategies via the shared loader — no invocation changes.

More skills from WayfinderFoundation

promote-wayfinder-script logo
WayfinderFoundation/wayfinder-paths-sdk

promote-wayfinder-script

Promote a session scratch run script into the local Wayfinder library so it persists across sessions.

23 0
View
using-pool-token-balance-data logo
WayfinderFoundation/wayfinder-paths-sdk

using-pool-token-balance-data

How to fetch and interpret pool/token/balance data in Wayfinder Paths (PoolClient/TokenClient + adapters + MCP balance tools), including common query patterns and I/O shapes.

23 0
View
using-morpho-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-morpho-adapter

How to use the Morpho adapter for Morpho Markets + Vaults (market discovery, positions, market collateral/borrow ops, vault deposit/withdraw ops, rewards, and common gotchas).

23 0
View
using-hyperlend-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-hyperlend-adapter

How to read Hyperlend markets/time-series and execute lend/withdraw flows in Wayfinder Paths (inputs/outputs, unit handling, and safety).

23 0
View
using-aave-v3-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-aave-v3-adapter

How to use the Aave V3 adapter for lending/borrowing across supported chains (markets, APYs, rewards, collateral, and common gotchas).

23 0
View
using-brap-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-brap-adapter

How to use the BRAP adapter/client in Wayfinder Paths for cross-chain quotes and swaps (data in/out, execution paths, approvals, and common gotchas).

23 0
View
using-uniswap-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-uniswap-adapter

How to use the Uniswap V3 adapter for concentrated liquidity on Base/Arbitrum/Ethereum (LP provisioning, position management, tick math, and common gotchas).

23 0
View
using-ccxt-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-ccxt-adapter

How to use the CCXT adapter as a multi-exchange factory for CEX trading (Binance, Hyperliquid, Aster, etc.) — setup, credentials, and common operations.

23 0
View
using-hyperliquid-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-hyperliquid-adapter

How to use Hyperliquid adapter data (meta, funding, candles, orderbooks) and execution surfaces (orders/transfers) in Wayfinder Paths, including required executor wiring.

23 0
View
using-moonwell-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-moonwell-adapter

How to use the Moonwell adapter for Moonwell Core lending/borrowing across Base, OP Mainnet, Moonbeam, and Moonriver, including market discovery, APYs, collateral, rewards, and common gotchas.

23 0
View
using-boros-adapter logo
WayfinderFoundation/wayfinder-paths-sdk

using-boros-adapter

How to use the Boros adapter for fixed-rate market data, margin flows, and vault execution in Wayfinder Paths (market discovery, vault screening, quoting, and transaction gotchas).

23 0
View
setup logo
WayfinderFoundation/wayfinder-paths-sdk

setup

Run Wayfinder Paths setup - install dependencies, create wallets, configure API key

23 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View