grimoire-pendle

SKILL.md

Grimoire Pendle Skill

Use this skill to inspect Pendle metadata and preflight Pendle routing configuration before running spells.

Preferred invocations:

grimoire venue pendle ...

npx -y @grimoirelabs/cli venue pendle ... (no-install)

bun run packages/cli/src/index.ts venue pendle ... (repo-local)

grimoire-pendle ... (direct binary from @grimoirelabs/venues)

Recommended preflight:

grimoire venue doctor --adapter pendle --chain 1 --rpc-url <rpc> --json

Commands

grimoire venue pendle info [--base-url <url>] [--format <auto|json|table>]

grimoire venue pendle chains [--base-url <url>] [--format <auto|json|table>]

grimoire venue pendle supported-aggregators --chain <id> [--base-url <url>] [--format <auto|json|table>]

grimoire venue pendle markets [--chain <id>] [--active <true|false>] [--base-url <url>] [--format <auto|json|table>]

grimoire venue pendle assets [--chain <id>] [--type <PT|YT|LP|SY>] [--base-url <url>] [--format <auto|json|table>]

grimoire venue pendle market-tokens --chain <id> --market <address> [--base-url <url>] [--format <auto|json|table>]

Examples

grimoire venue pendle info --format table
grimoire venue pendle chains
grimoire venue pendle supported-aggregators --chain 1 --format json
grimoire venue pendle markets --chain 1 --active true --format table
grimoire venue pendle assets --chain 8453 --type PT --format table
grimoire venue pendle market-tokens --chain 8453 --market 0x... --format json

Authoring Workflow

Pendle requires a market-first approach. Do NOT write a Pendle spell without first querying available markets.

Query markets for the target chain and underlying:

grimoire venue pendle markets --chain 1 --active true --format json

Pick a market — note its address and expiry. Each market has specific PT/YT/SY tokens.

Query market tokens to get the exact token addresses:

grimoire venue pendle market-tokens --chain 1 --market 0x... --format json

Write the spell using token addresses from step 3:

pendle.add_liquidity(0x<SY_address>, params.amount) with (max_slippage=100)

Common mistakes

pendle.deposit(USDC, ...) — Pendle has no deposit action. Use add_liquidity, mint_py, mint_sy, or swap.

Using token symbols without addresses — PT/YT/SY tokens are auto-resolved via the Pendle API, but standard tokens like USDC need raw amounts in the token's smallest unit.

Missing enable_aggregator — Some routes require an aggregator. If no route is found, retry with enable_aggregator=true in the with() clause.

Supported actions

Action
Description
Input
Output

swap
Swap between any Pendle tokens
Single token
Single token

add_liquidity
Add single-sided liquidity
Underlying/SY
LP token

remove_liquidity
Remove single-sided liquidity
LP token
Underlying/SY

mint_py
Mint PT + YT from underlying
Underlying/SY
PT + YT

redeem_py
Redeem PT + YT to underlying
PT + YT
Underlying/SY

mint_sy
Wrap underlying into SY
Underlying
SY

redeem_sy
Unwrap SY to underlying
SY
Underlying

Metric Surface (Spell Comparisons)

Pendle exposes quote_out for route output comparisons:

pendle_out = metric("quote_out", pendle, USDC, "asset_out=DAI,amount=1000000,slippage_bps=1000")

Selector fields:

required: asset_out

optional: amount (defaults to 1 unit of input asset), slippage_bps, enable_aggregator

Spell Constraints

When writing Pendle actions in .spell files, use with clauses:

pendle.swap(PT_TOKEN, SY_TOKEN, params.amount) with (
  max_slippage=100,
  require_quote=true,
)

Constraint
Type
Description

max_slippage
integer (bps)
Maximum slippage, validated as integer in [0, 10000], converted to decimal for API

min_output
integer (wei)
Minimum output amount floor

require_quote
boolean
Fail if Pendle API quote fails

max_gas
integer (wei)
Gas estimate cap

Pendle swap only supports mode: exact_in. exact_out is not supported.

When the Pendle API returns multiple routes, the adapter selects the first (best) route and emits a warning via onWarning. This is logged in non-JSON CLI runs.

PT/YT/SY Token Resolution

Pendle PT, YT, and SY tokens (e.g. PT_FXSAVE, YT_EETH, SY_WSTETH) are automatically resolved via the Pendle API at build time. You can use these symbols directly in spells without providing explicit addresses:

pendle.swap(PT_FXSAVE, USDC, params.amount) with (max_slippage=100)

The adapter converts underscore-delimited names (e.g. PT_FXSAVE) to the Pendle API format and picks the best match. If multiple expiries exist, the first (nearest) is selected.

To target a specific expiry or disambiguate, use the full 0x address instead:

pendle.swap(0xb1e926428ebec4421cce1ec6d9ff65d27f4b4bb6, USDC, params.amount)

Use grimoire venue pendle assets --chain <id> --type PT to discover available tokens and addresses.

Notes

Default API base URL is https://api-v2.pendle.finance/core.

Override base URL with --base-url or PENDLE_API_BASE_URL.

Use --format json for automation and nested payloads.

Pendle swap currently supports mode: exact_in only.

Aggregators are disabled by default in adapter actions unless explicitly enabled.

For Pendle token outputs (assetOut, outputs), use bare address literals (0x...) and not quoted strings (\"0x...\").

Quoted address-like token values trigger validator code QUOTED_ADDRESS_LITERAL.

max_slippage is validated as integer bps in [0, 10000] and converted to decimal (bps / 10000) before API requests.