Expand fxusd skill with fxSAVE, Hydrex, and Morpho flows

[huwangtao123]

Summary

• expand fxusd from a single fxSAVE shortcut skill into a broader fxUSD strategy skill on Base
• keep the public fxSAVE shortcut flow, but add Hydrex single-sided liquidity discovery and execution planning
• add Morpho planning for fxUSD supply, withdraw, borrow, and repay workflows
• add Bankr-oriented metadata and natural-language prompts so the skill is easier to use from Bankr agents
• update the root README entry to match the new scope

What the skill does now

This PR turns fxusd into a routing layer for Base-side fxUSD actions.

It now covers three modules:

• fxSAVE shortcut
• Hydrex single-sided liquidity
• Morpho lend / borrow planning

Execution model by module

• fxSAVE: executable today through the public app backend at https://fxsave.up.railway.app
• Hydrex: live discovery plus execution-ready planning, including Bankr-ready /agent/submit steps
• Morpho: planning and decision support, with explicit risk controls before any future execution work

New and updated files

• fxusd/SKILL.md
• fxusd/references/api.md
• fxusd/references/hydrex.md
• fxusd/references/morpho.md
• fxusd/scripts/fxusd_cli.py
• fxusd/scripts/fxusd_hydrex.py
• README.md

Highlights

fxSAVE

• keeps the one-step Base-side mental model for minting and redeeming fxSAVE
• documents the public bundle and approval endpoints
• keeps a small CLI helper for route preview and approval planning

Hydrex

• discovers live single-sided vaults from the Hydrex API
• distinguishes stablecoin-farming from crypto-farming
• ranks vaults with a conservative heuristic based on APR, TVL, and risk class
• builds execution-ready deposit and withdraw plans
• emits Bankr-ready submit steps for approval and main transactions
• prevents zero-share withdraw plans from being treated as executable

Morpho

• frames fxUSD supply and borrow as a separate module
• distinguishes conservative supply from higher-risk borrow workflows
• makes liquidation buffer and market availability explicit guardrails

Validation

I validated the updated skill contents and scripts locally.

Script validation

• python3 -m py_compile fxusd/scripts/fxusd_cli.py fxusd/scripts/fxusd_hydrex.py

fxSAVE validation

• python3 fxusd/scripts/fxusd_cli.py mint --from-address 0x241e25c9d15b5E7FB007B5E028C4ce8694893870 --amount 1 --source-token fxUSD
• python3 fxusd/scripts/fxusd_cli.py redeem --from-address 0x241e25c9d15b5E7FB007B5E028C4ce8694893870 --amount 1 --target-token USDC

These returned valid bundle and approval responses from the public app backend.

Hydrex validation

• live discover and recommend checks for fxUSD and BNKR
• live deposit-plan for fxUSD
• live withdraw-plan for Hydrex vault positions
• live cross-checks against Base RPC for balance, allowance, and LP share state

Why this is a better fit for Bankr

The old PR body described a narrow fxSAVE shortcut skill.

The updated skill is closer to how users actually think about fxUSD:

• put idle fxUSD to work
• compare yield routes
• choose simpler wrappers versus vaults versus lending
• hand off execution steps to Bankr when the plan is ready

[huwangtao123]

Adding a bit more context here:

This skill is intended to be the starting point for a broader collection of fxUSD-related shortcuts, not just a single mint/redeem wrapper.

The initial version focuses on the most obvious Base user flow:

• mint fxSAVE from Base assets
• redeem fxSAVE back into Base assets

But the direction is larger than that.

The goal is to make fxUSD yield and arbitrage workflows easier to access from Base by packaging the hidden cross-chain steps behind simpler agent-friendly actions. Over time, this can grow into a set of shortcuts around:

• stable yield routing
• fxUSD -> fxSAVE entry flows
• fxSAVE -> Base asset exit flows
• basis / arbitrage / rebalancing style flows built on top of the same pattern

In short: this PR adds the first public shortcut skill, but the broader vision is an fxUSD shortcut collection for yield and arbitrage-related actions.

[huwangtao123]

@sidrisov Do you get a chance to take a look