HypurrFi Skill

DeFi lending for AI agents on Hyperliquid.

Deposit assets → Earn yield. Post collateral → Borrow. All on HyperEVM.

Quick Start (Git Clone → Deposit in 5 min)

# 1. Clone and install
git clone https://github.com/hypurrfi/hypurrfi-skill.git ~/.openclaw/workspace/skills/hypurrfi
cd ~/.openclaw/workspace/skills/hypurrfi && npm install

# 2. Setup wallet (if you don't have one)
node scripts/setup.js --json

# 3. Fund your wallet with HYPE or stablecoins
# Bridge via https://cctp.to or transfer from HyperCore L1

# 4. Deposit!
node scripts/deposit.js pooled usdt0 100 --json

Market Types

⚠️ Important: Assets in one market can't collateralize another. HYPE in Prime ≠ collateral for Pooled borrows.

Commands

Check Your Positions

# Overview of all positions across markets
node scripts/positions.js --json

# Detailed health factor and liquidation risk
node scripts/health.js --json

Deposit (Earn Yield)

# Deposit to specific market
node scripts/deposit.js <market> <token> <amount> [--yes] [--json]

# Examples
node scripts/deposit.js pooled usdt0 100 --json      # Pooled market
node scripts/deposit.js prime hype 10 --json         # Prime market (lower risk)
node scripts/deposit.js yield hype 10 --json         # Yield market (higher APY)
node scripts/deposit.js vault usdt0 100 --json       # ClearstarLabs vault

Withdraw

node scripts/withdraw.js <market> <token> <amount|max> [--yes] [--json]

# Examples
node scripts/withdraw.js pooled usdt0 50 --json
node scripts/withdraw.js pooled usdt0 max --json     # Withdraw everything

Borrow (Against Collateral)

# First deposit collateral, then borrow
node scripts/borrow.js <market> <token> <amount> [--yes] [--json]

# Example: Borrow USDT0 against HYPE collateral in Pooled
node scripts/deposit.js pooled hype 10 --yes --json
node scripts/borrow.js pooled usdt0 1000 --yes --json

Repay

node scripts/repay.js <market> <token> <amount|max> [--yes] [--json]

# Example
node scripts/repay.js pooled usdt0 500 --json
node scripts/repay.js pooled usdt0 max --json       # Repay full debt

Check APY Rates

node scripts/rates.js --json

Tokens Supported

Safety Rules

1. Always check health factor before borrowing more

   • Health > 1.5 = Safe
   • Health 1.0-1.5 = Caution
   • Health < 1.1 = Liquidation risk!

2. Confirm before transactions — use --yes only after reviewing

3. Start small — test with small amounts first

4. Monitor positions — run node scripts/health.js regularly

5. Keep gas reserves — need ~0.01 HYPE for transactions

Common Workflows

Earn Yield on Stablecoins

# Deposit USDT0 to Pooled for ~5-15% APY
node scripts/deposit.js pooled usdt0 1000 --yes --json

Leverage HYPE (Loop)

# 1. Deposit HYPE
node scripts/deposit.js pooled hype 100 --yes --json

# 2. Borrow stables against it
node scripts/borrow.js pooled usdt0 5000 --yes --json

# 3. (Optional) Buy more HYPE with borrowed stables
# ... then deposit that HYPE too (looping)

Conservative Treasury

# Use Vault for managed, lower-touch yield
node scripts/deposit.js vault usdt0 10000 --yes --json

Error Handling

Links

• App: https://app.hypurr.fi
• Docs: https://docs.hypurr.fi
• Explorer: https://explorer.hyperliquid.xyz
• Support: https://discord.gg/hypurrfi

Wallet Location

Private key stored at: ~/.hyperliquid-wallet.json

Never share this file. Same wallet works for HyperCore L1 and HyperEVM.