Description

DeFi lending on Hyperliquid. Deposit to earn yield, borrow against collateral. Supports Pooled (Aave v3), Prime/Yield (Euler), and Vault markets. Use when an...

README (SKILL.md)

HypurrFi Skill

Name: HypurrFi
Author: lastandy

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

Market	Risk	Style	Best For
Pooled	Shared	Aave v3	Deepest liquidity, cross-collateral borrowing
Prime	Lower	Euler	Safer assets, conservative strategies
Yield	Higher	Euler	Higher APY, riskier assets
Vault	Managed	Curated	Set-and-forget, ClearstarLabs managed

⚠️ 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 \x3Cmarket> \x3Ctoken> \x3Camount> [--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 \x3Cmarket> \x3Ctoken> \x3Camount|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 \x3Cmarket> \x3Ctoken> \x3Camount> [--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 \x3Cmarket> \x3Ctoken> \x3Camount|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

Token	Address	Markets
HYPE	Native	Pooled, Prime, Yield
USDT0	`0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb`	All
USDC	`0x211Cc4DD073734dA055fbF44a2b4667d5E5fE5d2`	Pooled
USDXL	`0xca79db4B49f608eF54a5CB813FbEd3a6387bC645`	Pooled
hwHYPE	`0x...`	Prime, Yield

Safety Rules

Always check health factor before borrowing more
- Health > 1.5 = Safe
- Health 1.0-1.5 = Caution
- Health \x3C 1.1 = Liquidation risk!
Confirm before transactions — use --yes only after reviewing
Start small — test with small amounts first
Monitor positions — run node scripts/health.js regularly
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

Error	Cause	Fix
"No wallet found"	Wallet not setup	Run `node scripts/setup.js`
"Insufficient balance"	Not enough tokens	Fund wallet first
"Health factor too low"	Over-leveraged	Repay debt or add collateral
"Amount exceeds available"	Trying to withdraw too much	Check positions, use `max`

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.

Usage Guidance

This skill appears to be what it says: a CLI wallet/DeFi client for HyperEVM. Before installing or running it, consider the following: 1) The setup script will generate and store your private key in plaintext at ~/.hyperliquid-wallet.json (file mode 600). Treat that file as extremely sensitive — do not use your main funds without testing first. 2) npm install will pull dependencies from the public registry (viem and others); only run npm install if you trust the source. 3) The scripts talk to the HyperEVM RPC (https://rpc.hyperliquid.xyz/evm). A malicious or compromised RPC could misreport state or censor transactions; verify the RPC endpoint is trustworthy if you use large amounts. 4) Inspect the GitHub repo (https://github.com/hypurrfi/hypurrfi-skill) and hosting/site links to confirm they match the distributed code and project. 5) When running commands, avoid using --yes until you have tested preview modes and are comfortable with the wallet and balances. If you need lower risk, run the scripts on an isolated machine or with a wallet that holds only test/faucet funds.

Capability Analysis

Type: OpenClaw Skill Name: hypurrfi Version: 1.0.0 The hypurrfi skill provides standard DeFi lending functionality on the Hyperliquid HyperEVM network. It manages a local wallet file (~/.hyperliquid-wallet.json) to sign transactions using the viem library, which is consistent with its stated purpose of allowing an AI agent to manage a DeFi treasury. Analysis of the scripts (deposit.js, borrow.js, setup.js, etc.) and the SKILL.md instructions reveals no evidence of data exfiltration, malicious execution, or harmful prompt injection.

Capability Assessment

✓ Purpose & Capability

Name/description match the code and scripts: all files implement deposit/withdraw/borrow/repay/position/health flows against HyperEVM markets. Required binary (node) is appropriate. No unrelated environment variables or cloud credentials are requested.

ℹ Instruction Scope

SKILL.md explicitly instructs cloning the repo and running npm install and the provided node scripts. The runtime instructions and scripts operate only against the blockchain RPC and local wallet file; they do not attempt to read unrelated system files or send data to unexpected external endpoints. They do, however, create and read a wallet private key file (~/.hyperliquid-wallet.json) and will sign/send transactions when run with the --yes flag.

ℹ Install Mechanism

There is no platform install spec, but SKILL.md requires git clone and npm install. Dependencies come from the public npm registry (viem and its deps). This is a reasonable and expected install method for a Node-based blockchain tool, but pulling npm packages is a moderate-risk action and should be done from a trustworthy network and registry.

ℹ Credentials

The skill requests no environment credentials. It does implicitly use process.env.HOME to build a wallet path and writes a plaintext private key JSON file (~/.hyperliquid-wallet.json) protected with chmod 600. Storing a private key on disk is expected for a CLI wallet but is high-sensitivity: anyone with file access or a malicious process could read it. The skill code itself does not contain logic that exfiltrates the private key to other hosts.

✓ Persistence & Privilege

The skill does not request always:true and does not alter other skills or system-wide settings. It creates a wallet file under the user's home directory and uses it to sign transactions — expected behavior for a wallet client.

Version History

v1.0.0

Initial publish — DeFi lending on Hyperliquid

Metadata

Slug hypurrfi

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is HypurrFi?

DeFi lending on Hyperliquid. Deposit to earn yield, borrow against collateral. Supports Pooled (Aave v3), Prime/Yield (Euler), and Vault markets. Use when an... It is an AI Agent Skill for Claude Code / OpenClaw, with 239 downloads so far.

How do I install HypurrFi?

Run "/install hypurrfi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is HypurrFi free?

Yes, HypurrFi is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does HypurrFi support?

HypurrFi is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created HypurrFi?

It is built and maintained by lastandy (@lastandy); the current version is v1.0.0.

More Skills

HypurrFi