What makes Wayfinder notable?

1K downloads. Trust evidence available

How should Wayfinder be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Wayfinder

DeFi trading, yield strategies, and portfolio management via the Wayfinder Paths CLI (`poetry run wayfinder`). Use when the user wants to check balances, swa... Skill: Wayfinder Owner: canuc Summary: DeFi trading, yield strategies, and portfolio management via the Wayfinder Paths CLI (poetry run wayfinder). Use when the user wants to check balances, swa... Tags: latest:0.0.4 Version history: v0.4.1 | 2026-02-13T22:20:27.670Z | user wayfinder 0.4.1 - Added CCTX -> so that binance can be used. - Added defaiut api RPCs for all ETH + PLASMA + BASE + EFC rpc urls - to avoid publi

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

0.4.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 0.4.1release · observed Feb 13, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s174zm9aaky0s4yesxeczv7pw1885ats:wayfinder

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-canuc-wayfinder/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

144,053 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: wayfinder
description: DeFi trading, yield strategies, and portfolio management via the Wayfinder Paths CLI (`poetry run wayfinder`). Use when the user wants to check balances, swap tokens, bridge assets, trade perps, trade prediction markets (Polymarket), run automated yield strategies (stablecoin yield, basis trading, Moonwell loops, HyperLend, Boros HYPE), manage wallets, discover DeFi pools, look up token metadata, manage LP positions (Uniswap V3 / ProjectX), or execute one-off DeFi scripts. Supports Ethereum, Base, Arbitrum, Polygon, BSC, Avalanche, Plasma, and HyperEVM via protocol adapters.
metadata: {"openclaw":{"emoji":"🧭","homepage":"https://github.com/WayfinderFoundation/wayfinder-paths-sdk","requires":{"bins":["poetry"]},"install":[{"id":"brew","kind":"brew","formula":"poetry","bins":["poetry"],"label":"Install poetry"}]}}
---

# Wayfinder

DeFi trading, yield strategies, and portfolio management powered by [poetry run wayfinder Paths](https://github.com/WayfinderFoundation/wayfinder-paths-sdk).

## Pre-Flight Check

Before running any commands, verify that poetry run wayfinder Paths is installed and reachable:

```bash
# SDK location (override by setting WAYFINDER_SDK_PATH)
export WAYFINDER_SDK_PATH="${WAYFINDER_SDK_PATH:-$HOME/wayfinder-paths-sdk}"

# Check if wayfinder-paths-sdk directory exists
if [ ! -d "$WAYFINDER_SDK_PATH" ]; then
  echo "ERROR: wayfinder-paths-sdk is not installed at: $WAYFINDER_SDK_PATH"
  echo "Set WAYFINDER_SDK_PATH or run the First-Time Setup below."
  exit 1
fi

# Config path (override by setting WAYFINDER_CONFIG_PATH)
export WAYFINDER_CONFIG_PATH="${WAYFINDER_CONFIG_PATH:-$WAYFINDER_SDK_PATH/config.json}"

# Check if the config exists
if [ ! -f "$WAYFINDER_CONFIG_PATH" ]; then
  echo "ERROR: config not found at $WAYFINDER_CONFIG_PATH. Run the First-Time Setup below."
  exit 1
fi

# Check if the CLI is functional
cd "$WAYFINDER_SDK_PATH"
if ! poetry run wayfinder --help > /dev/null 2>&1; then
  echo "ERROR: poetry run wayfinder CLI is not working. Run 'cd $WAYFINDER_SDK_PATH && poetry install' to fix."
  exit 1
fi

echo "poetry run wayfinder Paths is installed and ready."
```

If either check fails, follow the **First-Time Setup** instructions below before proceeding.

## Quick Start

### First-Time Setup

**Important:** The SDK must be installed from GitHub via `git clone`. Do NOT install from PyPI (`pip install wayfinder-paths` will not work).

**Before starting:** You need a Wayfinder API key (format: `wk_...`). Get one at **https://strategies.wayfinder.ai**. The guided setup will prompt you for this key.

```bash
# Clone wayfinder-paths-sdk from GitHub (required — do NOT pip install)
export WAYFINDER_SDK_PATH="${WAYFINDER_SDK_PATH:-$HOME/wayfinder-paths-sdk}"
if [ ! -d "$WAYFINDER_SDK_PATH" ]; then
  git clone https://github.com/WayfinderFoundation/wayfinder-paths-sdk.git "$WAYFINDER_SDK_PATH"
fi

cd "$WAYFINDER_SDK_PATH"
poetry install

# Run guided setup (creates/updates config.json + loc

_meta.json

{
  "ownerId": "kn70kfnzaghvt4fcq75v9wqa9h80epek",
  "slug": "wayfinder",
  "version": "0.4.1",
  "publishedAt": 1771021227670
}

references/adapters.md

# Adapters

## Overview

Adapters are protocol integrations that provide read and write capabilities. Strategies compose adapters to build trading logic.

## Discovering Adapters

```bash
# List all adapters with capabilities
poetry run wayfinder resource wayfinder://adapters

# Describe a specific adapter
poetry run wayfinder resource wayfinder://adapters/moonwell_adapter
```

## Adapter Reference

### Balance Adapter (`balance_adapter`)

- **Type**: `BALANCE`
- **Module**: `wayfinder_paths.adapters.balance_adapter.adapter.BalanceAdapter`
- **Protocol**: EVM wallets (Base, Arbitrum, Ethereum, HyperEVM)
- **Capabilities**: `balance.read`, `transfer.main_to_strategy`, `transfer.strategy_to_main`, `transfer.send`

Provides token balance queries for any wallet, cross-wallet transfers between main and strategy wallets, and automatic ledger recording for deposits/withdrawals.

```bash
poetry run wayfinder resource wayfinder://balances/main
poetry run wayfinder resource wayfinder://tokens/resolve/usd-coin-base
poetry run wayfinder resource wayfinder://activity/main
```

### BRAP Adapter (`brap_adapter`)

- **Type**: `BRAP`
- **Module**: `wayfinder_paths.adapters.brap_adapter.adapter.BRAPAdapter`
- **Protocol**: Cross-chain swap aggregator (Bridge/Router/Adapter Protocol)
- **Capabilities**: `swap.quote`, `swap.execute`, `swap.compare_routes`, `bridge.quote`, `gas.estimate`

Handles cross-chain swaps and bridges with quote fetching, route optimization, and execution.

```bash
poetry run wayfinder quote_swap --wallet_label main --from_token usd-coin-base --to_token ethereum-base --amount 100
poetry run wayfinder execute --kind swap --wallet_label main --from_token usd-coin-base --to_token ethereum-base --amount 100
```

**Key Methods:**
- `BRAPClient.get_quote(from_token, to_token, from_chain, to_chain, from_wallet, from_amount, slippage?)` — Low-level quote (amount in **raw base units** as string)
- `BRAPAdapter.best_quote(...)` — Returns single best route; supports `preferred_providers`
- `BRAPAdapter.swap_from_token_ids(from_token_id, to_token_id, from_address, amount, slippage, ...)` — Execute swap by token IDs
- `BRAPAdapter.swap_from_quote(from_token, to_token, from_address, quote, ...)` — Execute from a pre-fetched quote

**Recommended Quote Loop:**
1. Call `quote_swap` (does token lookup + human→raw conversion + returns preview)
2. Inspect `from_token`/`to_token` in response to verify correct asset + chain
3. Pass `suggested_execute_request` directly into `execute`

**BRAP Gotchas:**
- **Broadcast ≠ success**: A tx hash does not mean the swap succeeded. The SDK waits for receipt and raises `TransactionRevertedError` on `status=0`.
- **Units**: Quote input `from_amount` is **raw base units**. Resolve decimals via TokenClient first.
- **Slippage formats**: BRAP adapter uses **decimal fraction** (`0.005` = 0.5%). MCP may use bps (`50` = 0.5%). Don't mix.
- **Approvals**: Some tokens are "strict approve" and require setting allowance to 0 before incr

references/boros.md

# Boros

## Overview

Boros provides fixed-rate markets on Arbitrum. It allows locking in a fixed funding rate for delta-neutral strategies, removing variable rate risk.

- **Type**: `BOROS`
- **Module**: `wayfinder_paths.adapters.boros_adapter.adapter.BorosAdapter`
- **Capabilities**: `market.read`, `market.quote`, `position.open`, `position.close`, `collateral.deposit`, `collateral.withdraw`

## Market Data

```bash
# Describe Boros adapter
poetry run wayfinder resource wayfinder://adapters/boros_adapter

# Discover positions
poetry run wayfinder wallets --action discover_portfolio --wallet_label main --protocols '["boros"]'
```

## Execution

Boros operations are executed via one-off scripts:

```bash
# Run a Boros script (dry run)
poetry run wayfinder run_script --script_path .wayfinder_runs/boros_lock_rate.py --wallet_label main

# Run live
poetry run wayfinder run_script --script_path .wayfinder_runs/boros_lock_rate.py --wallet_label main --force
```

### Script Example

```python
from wayfinder_paths.mcp.scripting import get_adapter
from wayfinder_paths.adapters.boros_adapter import BorosAdapter

adapter = get_adapter(BorosAdapter, "main")
markets = await adapter.discover_markets()
```

## Key Concepts

- **Yield Units (YU)**: The core trading unit. 1 YU ≈ $1 for USDT collateral; 1 YU = 1 HYPE (at unit price) for HYPE collateral. YU sizing is determined by margin formula, not 1:1 with collateral.
- **Implied APR**: The orderbook price — what the market expects the rate to be.
- **Underlying APR**: The actual funding rate that settles (e.g., Hyperliquid hourly funding).
- **Settlement cadence**: Mirrors the underlying venue — hourly for Hyperliquid, 8-hour for Binance/OKX. Must sample funding and rates on the same cadence.
- **Margin types**: **Cross** (shared across all positions) vs **Isolated** (locked to a specific market).
- **Collateral types**: WBTC (1), WETH (2), USDT (3), BNB (4), HYPE (5).
- **Funding sign convention**: Negative = shorts pay longs (longs receive). Positive = longs pay shorts.

### Rate Locking Recipes

- **Short hedge** (you're short a perp with positive funding): Open a **SHORT YU** on Boros to lock fixed funding you're paying.
- **Long hedge** (you're long a perp with positive funding): Open a **LONG YU** on Boros to lock fixed funding payment.
- "Current rate" = `BorosMarketQuote.mid_apr` — always fetch fresh via adapter.

## High-Value Reads

All BorosAdapter methods return `tuple[bool, result]` — always unpack. All fields use **snake_case** (not camelCase).

| Method | Purpose | Best For |
|--------|---------|----------|
| `list_tenor_quotes(underlying_symbol, platform)` | Fast market+rate snapshot (no orderbooks) | Quick tenor-level APR scan |
| `quote_market(market)` / `quote_market_by_id(market_id)` | Detailed APR quote with orderbook data | Single market analysis |
| `quote_markets_for_underlying(underlying_symbol)` | Quotes across all tenors for an underlying | Tenor curve building |
| `list_markets()` /

references/ccxt.md

# CCXT (Centralized Exchanges)

## Overview

The SDK includes a `ccxt_adapter` that acts as a **multi-exchange factory** for centralized exchanges (CEXes). Each configured exchange becomes a property on the adapter (e.g. `adapter.aster`, `adapter.binance`), and you call the CCXT unified API on that exchange object.

- **Type**: `CCXT`
- **Module**: `wayfinder_paths.adapters.ccxt_adapter.adapter.CCXTAdapter`
- **Capabilities**: `exchange.factory`

## When to use (and when not to)

- Use for CEX workflows (Aster, Binance, etc.) **when the user has API credentials** and explicitly wants centralized exchange data or trading.
- Do **not** use CCXT for Hyperliquid by default. Prefer the native Wayfinder Hyperliquid surfaces (`hyperliquid` resources + `hyperliquid_execute`) unless the user explicitly asks for CCXT/Hyperliquid.

## Config (`config.json`)

Add a `ccxt` section with exchange IDs and credentials (exchange IDs must match CCXT exchange ids):

```json
{
  "ccxt": {
    "aster": { "apiKey": "…", "secret": "…" },
    "binance": { "apiKey": "…", "secret": "…", "enableRateLimit": true },
    "hyperliquid": { "walletAddress": "0x...", "privateKey": "0x..." }
  }
}
```

Notes:
- Credentials are passed straight through to each CCXT exchange constructor; exchange-specific params (e.g. `password`, `uid`, `options`) are supported.
- Exchange IDs must match CCXT’s exchange ids (e.g. `binance`, `bybit`, `aster`, `hyperliquid`).

### Credentials quick reference

| Exchange | Required params |
|----------|----------------|
| binance | `apiKey`, `secret` |
| hyperliquid | `walletAddress`, `privateKey` |
| aster | `apiKey`, `secret` |
| bybit | `apiKey`, `secret` |
| dydx | `apiKey`, `secret`, `password` |

## Init patterns

### Config-driven (recommended)

```python
import asyncio
from wayfinder_paths.mcp.scripting import get_adapter
from wayfinder_paths.adapters.ccxt_adapter import CCXTAdapter

async def main():
    adapter = get_adapter(CCXTAdapter)
    try:
        ticker = await adapter.binance.fetch_ticker("BTC/USDT")
        print(ticker.get("last"))
    finally:
        await adapter.close()

asyncio.run(main())
```

### Explicit exchanges kwarg (no `config.json` required)

```python
import asyncio
from wayfinder_paths.adapters.ccxt_adapter import CCXTAdapter

async def main():
    adapter = CCXTAdapter(exchanges={"aster": {}, "binance": {}})
    try:
        ticker = await adapter.aster.fetch_ticker("ETH/USDT")
        print(ticker.get("last"))
    finally:
        await adapter.close()

asyncio.run(main())
```

The `exchanges=` kwarg takes priority over `config["ccxt"]`.

## Running CCXT scripts

CCXT is not exposed as a top-level `poetry run wayfinder` command. Use a one-off script via `run_script`.

```python
import asyncio
from wayfinder_paths.mcp.scripting import get_adapter
from wayfinder_paths.adapters.ccxt_adapter import CCXTAdapter

async def main():
    adapter = get_adapter(CCXTAdapter)
    try:
        ticker = await adapter.aster.fetch_t

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.