DeFi CLI

  ██████╗ ███████╗███████╗██╗     ██████╗██╗     ██╗
  ██╔══██╗██╔════╝██╔════╝██║    ██╔════╝██║     ██║
  ██║  ██║█████╗  █████╗  ██║    ██║     ██║     ██║
  ██║  ██║██╔══╝  ██╔══╝  ██║    ██║     ██║     ██║
  ██████╔╝███████╗██║     ██║    ╚██████╗███████╗██║
  ╚═════╝ ╚══════╝╚═╝     ╚═╝     ╚═════╝╚══════╝╚═╝

  5 chains · 39 protocols · 5 aggregators

Multi-chain DeFi toolkit with verified mainnet broadcast paths. Lending, LP farming, DEX swap, cross-chain bridge, yield comparison — all from your terminal. Built for humans and AI agents.

Install

git clone https://github.com/hypurrquant/defi-cli.git
cd defi-cli/ts
pnpm install
pnpm build

# Run CLI
node packages/defi-cli/dist/main.js

# Or link globally
pnpm -C packages/defi-cli link --global

Or from npm:

npm install -g @hypurrquant/defi-cli@latest
defi --version
# or one-shot
npx -y @hypurrquant/defi-cli@latest --json status

Requires Node.js >= 20 and pnpm (for the source build).

AI Agent Skill (Claude Code / SDK)

The npm package ships a Claude-compatible skill at skills/defi-cli/ that gives an agent inline guidance for every command, dry-run safety rules, and ready-to-run usage scripts. After npm install -g @hypurrquant/defi-cli@latest:

# Find the bundled skill folder
SKILL_SRC="$(npm root -g)/@hypurrquant/defi-cli/skills/defi-cli"

# Install for the current user (Claude Code, Claude Agent SDK, claude.ai)
mkdir -p ~/.claude/skills
ln -sfn "$SKILL_SRC" ~/.claude/skills/defi-cli

# Or per-project (overrides the global install for this repo only)
mkdir -p .claude/skills
ln -sfn "$SKILL_SRC" .claude/skills/defi-cli

Verify with ls ~/.claude/skills/defi-cli/SKILL.md. The skill auto-activates when the user prompt mentions any of the trigger keywords (chain names, protocol slugs, "swap", "lending", "bridge", "yield", etc.).

The skill bundles:

SKILL.md — agent-facing usage guide (rules, workflows, error recovery, recent-fix notes for v1.0.5–v1.0.11)
references/protocols.md — full slug catalog per chain
references/commands.md — every CLI command with flags and JSON envelope shapes
scripts/ — copy-paste runnable recipes:
- preflight.sh — install + wallet env check
- yield-scan.sh — best supply APY across all chains
- lp-emission-discover.sh — active emission pools sorted by APR
- swap-quote.sh — compare every supported aggregator (dry-run)
- bridge-quote.sh — compare LI.FI / deBridge / CCTP (dry-run)
- lending-supply-flow.sh — yield → rates → position → dry-run supply
- lp-claim-all.sh — list LP positions + print claim CLI hints
- portfolio-snapshot.sh — snapshot + PnL for a wallet
- wallet-status.sh — resolved wallet + native balance per chain

The MCP server (defi-mcp binary) is also bundled if you prefer tool-call integration over CLI invocation. See mcp-config.example.json for the JSON entry to drop into ~/.claude/settings.json or .mcp.json.

Supported Chains

Chain	ID	Status	Protocols	Native	Notes
HyperEVM	999	🟢 production	11	HYPE	All protocols mainnet-verified incl. emission token receipt
Mantle	5000	🟢 production	3	MNT	Aave V3 + Uniswap V3 + Merchant Moe LB (MOE emission verified)
Base	8453	🟢 production	5	ETH	Aerodrome V2/CL (AERO emission) + Uniswap V3 + Aave V3 + Compound V3
BNB	56	🟢 production	16	BNB	13/16 lifecycle-verified (Aave V3, Venus, Kinza, Pancakeswap V2/V3, Uniswap V3, Thena V1, Biswap, ApeSwap, BakerySwap, BSCSwap, BabyDogeSwap, FstSwap); `venus-flux-bnb` (no USDT in stablecoins pool), `thena-fusion`, `beefy-bnb` deferred for funding
Monad	143	🟡 staged	4	MON	Uniswap V3/V2 lifecycle-verified; `traderjoe-monad`, `morpho-blue-monad` await mainnet launch + funding
Arbitrum	42161	🟡 staged	3	ETH	Read-only + aggregator quotes verified
Ethereum	1	🟡 staged	6	ETH	Read-only + aggregator quotes verified

🟢 = full lifecycle broadcast (mint/supply → claim emission → withdraw/remove) 🟡 = configs + read-only paths verified, awaiting funded broadcast

Supported Protocols

HyperEVM (10)

Slug	Category	Interface	Notes
`hyperlend`	Lending	aave_v3	Aave V3 fork
`hypurrfi`	Lending	aave_v3	Aave V3 fork
`felix-morpho`	Lending	morpho_blue	MetaMorpho ERC-4626 vault routing
`project-x`	DEX	uniswap_v3	V3 fee-only
`hyperswap-v3`	DEX	uniswap_v3	V3 fee-only
`curve-hyperevm`	DEX	curve_stableswap	StableswapNG
`ramses-cl`	DEX	uniswap_v3 + cl_style="ramses"	x(3,3) auto-stake, NPM.getPeriodReward
`ramses-hl`	DEX	solidly_v2	ve(3,3) gauge, RAM emission
`kittenswap`	DEX	algebra_v3 + farming_center	Eternal farming, KITTEN/WHYPE rewards
`hybra`	DEX	hybra (V4 CL)	GaugeManager + 2-year veHYBR lock (default)
`nest-v1`	DEX	algebra_v3	NEST V1 — claim path verified live 2026-05-07 (off-chain ticket via `blaze.nest.aegas.it` / `usenest.xyz/api/blaze`). LP/farm read-paths still return zero (`gauge.rewardRate = 0`); only `lp claim` is functional.

Mantle (3)

Slug	Category	Interface	Notes
`aave-v3-mantle`	Lending	aave_v3
`uniswap-v3-mantle`	DEX	uniswap_v3
`merchantmoe-mantle`	DEX	uniswap_v2 + lb_factory + masterchef	LB hooks + MOE emission via veMOE-weighted MasterChef

Base (5)

Slug	Category	Interface	Notes
`aave-v3-base`	Lending	aave_v3
`compound-v3-base`	Lending	compound_v3	Comet
`uniswap-v3-base`	DEX	uniswap_v3	V3 fee-only
`aerodrome-base`	DEX	solidly_v2	ve(3,3) gauge, AERO emission
`aerodrome-cl`	DEX	uniswap_v3 + cl_style="slipstream"	Slipstream CL with NFT gauge, AERO emission

BNB (16)

Category	Slugs
Lending	`aave-v3-bnb`, `kinza-bnb`, `venus-bnb`, `venus-flux-bnb`
DEX	`pancakeswap-v3-bnb` (+ MasterChef CAKE), `pancakeswap-v2-bnb`, `uniswap-v3-bnb`, `thena-v1` (Solidly), `thena-fusion` (Algebra), `biswap-bnb`, `apeswap-bnb`, `bakeryswap-bnb`, `bscswap-bnb`, `babydogeswap-bnb`, `fstswap-bnb`
Vault	`beefy-bnb`

Monad (4)

Slug	Category	Interface
`uniswap-v2-monad`	DEX	uniswap_v2
`uniswap-v3-monad`	DEX	uniswap_v3
`traderjoe-monad`	DEX	uniswap_v2 + lb_factory
`morpho-blue-monad`	Lending	morpho_blue

DEX Aggregators (Live-verified)

Aggregator	HyperEVM	Mantle	Base	BNB	Monad
KyberSwap	✅	❌	✅	✅	—
OpenOcean	✅	✅	✅	✅	—
LiquidSwap	✅	—	—	—	—
LI.FI	✅	✅	✅	✅	—
Relay	✅	✅	✅	✅	—

Slug mapping per chain lives in chains.toml [chain.X.aggregators]. LI.FI/Relay route by numeric chain_id (slug "auto").

What Can It Do?

Yield comparison across chains

$ defi yield scan --asset USDC

 USDC Yield Scan — Best: HypurrFi Pooled on HyperEVM
┌──────────┬───────────────────┬────────────┬────────────┐
│ Chain    │ Protocol          │ Supply APY │ Borrow APY │
├──────────┼───────────────────┼────────────┼────────────┤
│ HyperEVM │ HypurrFi Pooled   │ 4.66%      │ 7.21%      │
│ Base     │ Aave V3 Base      │ 2.50%      │ 3.72%      │
│ Mantle   │ Aave V3 Mantle    │ 0.90%      │ 2.10%      │
└──────────┴───────────────────┴────────────┴────────────┘

Discover emission pools (sorted by APR)

$ defi --chain mantle lp discover --protocol merchantmoe-mantle --emission-only

# returns Merchant Moe LB pools where moePerDay > 0, sorted by APR descending
# top: COOK/WMNT 3433% · WMNT/WETH 1534% · WETH/USDT0 767% · WMNT/USDT0 294% · …

LB liquidity + auto-claim MOE

# Add LB liquidity centred ±3 bins around active
defi --chain mantle lp add --protocol merchantmoe-mantle \
  --token-a WMNT --token-b USDT0 --amount-a 1000000000000000000 --amount-b 600000 \
  --pool 0x03BeafC0d25BB553fCa274301832419C05269987 --num-bins 3 --broadcast

# Auto-scan all my LB positions + show pending MOE per bin
defi --chain mantle lp positions --protocol merchantmoe-mantle

# Claim — auto-detects user's actual bins (active±50 scan), not just rewarder.getRewardedRange
defi --chain mantle lp claim --protocol merchantmoe-mantle \
  --pool 0x03BeafC0d25BB553fCa274301832419C05269987 --broadcast

Aerodrome Slipstream CL with AERO emission

# Mint + auto-stake into CL gauge in one command
defi --chain base lp farm --protocol aerodrome-cl \
  --token-a WETH --token-b USDC --amount-a 50000000000000 --amount-b 110000 \
  --range 5 --pool 0xb2cc224c1c9feE385f8ad6a55b4d94E92359DC59 --broadcast

# Claim AERO; gauge.withdraw(tokenId) auto-claims pending on unstake too
defi --chain base lp claim --protocol aerodrome-cl \
  --gauge 0xF33a96b5932D9E9B9A0eDA447AbD8C9d48d2e0c8 --token-id <id> --broadcast

DEX aggregator swap (5 providers)

# Provider auto-detect via chains.toml aggregator slugs
defi --chain mantle swap --provider lifi --from MOE --to WMNT --amount <wei> --broadcast
defi --chain base swap --provider kyber --from WETH --to USDC --amount <wei> --broadcast
defi --chain bnb swap --provider relay --from WBNB --to USDT --amount <wei> --broadcast

Cross-chain bridge

defi --chain base bridge --token USDC --amount 100000000 --to-chain ethereum --provider lifi --broadcast
defi --chain base bridge --token 0x0000000000000000000000000000000000000000 --amount 1000000000000000 --to-chain bnb --provider relay --broadcast

Providers: lifi (default, broad coverage), relay (fast native-token routes, ~3s settle), debridge (DLN intent), cctp (Circle native USDC).

Command Reference

Command	Description
`lp discover`	Scan emission pools (gauge / LB hooks / MasterChef / Curve factory). `--emission-only` filters to active pools, sorted by APR desc.
`lp add`	Add liquidity. Routes to V3 NPM, Slipstream CL, or LB router based on protocol interface
`lp farm`	Add liquidity + auto-stake into gauge / LB hooks
`lp claim`	Claim emission/fees. Auto-detects user's actual bins for LB
`lp remove`	Auto-unstake (if staked) + remove liquidity. LB supports `--bins`/`--amounts`
`lp compound`	Auto-compound for V3 fee-only positions (collect → increaseLiquidity multicall)
`lp positions`	Show all active LP positions across protocols + pending rewards
`lp pipeline`	Print mint→stake→claim CLI sequence for a protocol's reward_strategy
`lp autopilot`	Whitelist-based budget allocation (`~/.defi/pools.toml`)
`lending`	rates / position / supply / borrow / repay / withdraw
`yield`	compare / scan (cross-chain) / optimize / execute
`swap`	DEX aggregator swap (kyber, openocean, liquid, lifi, relay)
`bridge`	Cross-chain transfer (lifi, relay, debridge, cctp)
`portfolio`	show / snapshot / pnl / history
`price`	Oracle + DEX prices
`wallet`	Address management
`token`	balance / approve / allowance / transfer
`ows`	Encrypted vault wallet (multi-chain HD derivation)
`setup`	Interactive RPC + wallet wizard
`status`	Chain + protocol overview
`schema`	JSON schema for agent introspection

Architecture

defi-cli/
├── ts/                              # TypeScript pnpm monorepo
│   ├── packages/
│   │   ├── defi-core/               # Registry, multicall, traits (13 trait interfaces)
│   │   ├── defi-protocols/          # Protocol adapters (Aave, Uniswap, Solidly, LB, …)
│   │   └── defi-cli/                # CLI commands (~20)
│   └── test/
└── ts/config/
    ├── chains.toml                  # 5 chain configs + per-chain aggregator slug map
    ├── tokens/<chain>.toml          # Per-chain token registries
    └── protocols/<category>/*.toml  # 39 protocol configs

Adapter abstraction (4-layer)

CLI (defi-cli)  →  Factory (createDex/createLending/createGauge/…)
  →  Trait interface (IDex / ILending / IGauge / IGaugeSystem / IVault / …)
  →  Adapter implementation (UniswapV3Adapter, AaveV3Adapter, SolidlyGaugeAdapter, …)
  ←  Registry (loads TOML configs at startup, dispatches by entry.interface)

Key design decisions:

Config-driven — adding a new chain = chains.toml row + tokens/<chain>.toml. Adding a new protocol = TOML drop (no code if the interface is supported)
Adapter polymorphism — UniswapV3Adapter handles standard V3 + Slipstream + Ramses CL via cl_style flag; SolidlyGaugeAdapter handles V2 + CL gauges via clNftMode
Aggregator chain mapping — chains.toml [chain.X.aggregators] declares which aggregators support each chain (slug per provider). Add a chain → add an aggregator entry, no code change
Dry-run by default — all transactions simulated unless --broadcast is set; auto-approve flow checks allowance and prepends approve tx
Agent-first — every command has --json / --ndjson / --fields, schema introspection via defi schema

Global Options

Flag	Description
`--chain <name>`	Target chain (hyperevm, mantle, base, bnb, monad)
`--json`	Structured JSON output
`--ndjson`	Newline-delimited JSON (streaming)
`--fields <a,b>`	Filter output to selected fields
`--dry-run`	Default — simulate only
`--broadcast`	Actually send the transaction

Environment Variables

Variable	Description
`{CHAIN}_RPC_URL`	Override RPC URL (e.g., `MANTLE_RPC_URL`, `BASE_RPC_URL`)
`DEFI_PRIVATE_KEY`	Private key for `--broadcast`
`DEFI_WALLET_ADDRESS`	Default wallet address (also accepts `ows:<name>` for OWS vault wallets)

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 214 Commits
.github/workflows		.github/workflows
config		config
docs		docs
skills/defi-cli		skills/defi-cli
ts		ts
.dockerignore		.dockerignore
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
SKILL.md		SKILL.md
mcp-config.example.json		mcp-config.example.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

DeFi CLI

Install

AI Agent Skill (Claude Code / SDK)

Supported Chains

Supported Protocols

HyperEVM (10)

Mantle (3)

Base (5)

BNB (16)

Monad (4)

DEX Aggregators (Live-verified)

What Can It Do?

Yield comparison across chains

Discover emission pools (sorted by APR)

LB liquidity + auto-claim MOE

Aerodrome Slipstream CL with AERO emission

DEX aggregator swap (5 providers)

Cross-chain bridge

Command Reference

Architecture

Adapter abstraction (4-layer)

Global Options

Environment Variables

License

About

Uh oh!

Releases 29

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

DeFi CLI

Install

AI Agent Skill (Claude Code / SDK)

Supported Chains

Supported Protocols

HyperEVM (10)

Mantle (3)

Base (5)

BNB (16)

Monad (4)

DEX Aggregators (Live-verified)

What Can It Do?

Yield comparison across chains

Discover emission pools (sorted by APR)

LB liquidity + auto-claim MOE

Aerodrome Slipstream CL with AERO emission

DEX aggregator swap (5 providers)

Cross-chain bridge

Command Reference

Architecture

Adapter abstraction (4-layer)

Global Options

Environment Variables

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 29

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages