promote-wayfinder-script
Promote a session scratch run script into the local Wayfinder library so it persists across sessions.
Full skill instructions
Use this skill when a one-off script created during an interactive session is worth keeping for future reuse.
This repo creates a per-session scratch directory (see $WAYFINDER_SCRATCH_DIR) and a persistent local library (see $WAYFINDER_LIBRARY_DIR).
Keep (promote) a script when it worked as intended and you expect it to be useful again in later sessions — the goal is to speed up future runs by reusing a known-good script instead of regenerating/re-reviewing new ad-hoc code.
Promote a script into the library:
poetry run python scripts/promote_wayfinder_script.py "$WAYFINDER_SCRATCH_DIR/my_script.py" my_script
Notes:
By default, scripts are organized under $WAYFINDER_LIBRARY_DIR/<protocol>/... when the tool can infer a protocol from the filename/content (otherwise it uses misc/).
You can force the folder with --protocol, e.g.:
poetry run python scripts/promote_wayfinder_script.py "$WAYFINDER_SCRATCH_DIR/my_script.py" my_script --protocol hyperliquid
The destination is $WAYFINDER_LIBRARY_DIR/<protocol>/<name>.py.
The promoted copy gets a short header block (source + timestamp + optional description).
A simple index is maintained at $WAYFINDER_LIBRARY_DIR/index.json.
How to use the Polymarket adapter in Wayfinder Paths for market discovery (Gamma), orderbooks/prices/history (CLOB), user positions/activity (Data API), and execution (buy/sell + redeem) using pUSD collateral on Polygon (including deposit / withdraw preparation flows).
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.
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).
How to read Hyperlend markets/time-series and execute lend/withdraw flows in Wayfinder Paths (inputs/outputs, unit handling, and safety).
How to use the Aave V3 adapter for lending/borrowing across supported chains (markets, APYs, rewards, collateral, and common gotchas).
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).
How to use the Uniswap V3 adapter for concentrated liquidity on Base/Arbitrum/Ethereum (LP provisioning, position management, tick math, and common gotchas).
How to use the CCXT adapter as a multi-exchange factory for CEX trading (Binance, Hyperliquid, Aster, etc.) — setup, credentials, and common operations.
How to use Hyperliquid adapter data (meta, funding, candles, orderbooks) and execution surfaces (orders/transfers) in Wayfinder Paths, including required executor wiring.
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.
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).
Run Wayfinder Paths setup - install dependencies, create wallets, configure API key
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience