How to Use

What is hl-tools?

hl-tools lets you mine Hyperliquid testnet USDC by using the testnet faucet. Each faucet claim gives a generated wallet ~$1,000 testnet USDC, but each wallet needs $2 real mainnet USDC to activate it on Hyperliquid.

There are two modes: Auto (recommended — the app runs the entire chain for you) and Manual (you control each step).

Prerequisites

A Web3 wallet (e.g. MetaMask, Rabby, WalletConnect)

You need a wallet with some mainnet USDC deposited on Hyperliquid.

Mainnet USDC on Hyperliquid

Manual mode needs $2 per wallet you want to activate. Auto mode needs N + 1 USDC (where N is the number of wallets). The extra $1 is a gas buffer that gets returned.

Connect your wallet

Click the wallet button in the top-right corner of the page to connect. Once connected, your mainnet and testnet account stats will appear on the home page.

Auto Mode — Step by Step (Default)

Auto mode chains multiple wallets together in a single automated run. You specify how many wallets to use, and the app handles everything.

Enter the number of wallets (1–50)

This is the number of wallets the chain will create and process. Each wallet claims the faucet once, so more wallets = more testnet USDC.

Review the preview, then click "Start Chain"

The preview shows you exactly how much mainnet USDC will be sent and how much testnet USDC you'll receive. Confirm and start.

Seeding phase

The app sends N + 1 USDC from your wallet to the first generated wallet. The extra $1 is a gas buffer to cover transaction fees across the chain.

Chain loop (automated for each wallet)

For each wallet in the chain, the app automatically does three things:

4a.

Claim faucet — Gets ~$1,000 testnet USDC from the Hyperliquid testnet faucet.

4b.

Drain testnet — Sends all testnet USDC (minus $0.01 fee) back to your wallet.

4c.

Forward mainnet — Sends remaining mainnet USDC to the next wallet in the chain (or back to you if it's the last wallet).

Completion

Once all wallets are processed, all mainnet USDC is returned to your wallet and all testnet USDC has been collected. The chain is complete.

Auto Mode Math (example: N = 5 wallets)

Initial send to Wallet #1$6.00 (5 + 1)

Wallets generated5

Faucet claims5 × $1,000

Testnet USDC received$5,000

Mainnet returned to you~$5.00 (minus fees)

Net mainnet cost~$0.10 (gas fees)

Effective ratio~$0.10 → $5,000 testnet

General Formula

You sendN + 1 USDC

You get back (mainnet)~N + 1 − (N × 0.02)

You get (testnet)N × 1,000 USDC

Net mainnet cost~N × $0.02 (fees)

Per-wallet cost~$0.02

How USDC Flows in Auto Mode

Your Wallet
    │
    ├─ sends (N+1) USDC ──▶ Wallet #1
    │                          │
    │   ┌──────────────────────┘
    │   │
    │   ├─ claim faucet ──▶ +$1,000 testnet
    │   ├─ drain testnet ──▶ $1,000 → Your Wallet (testnet)
    │   └─ forward mainnet ──▶ Wallet #2
    │                             │
    │   ┌─────────────────────────┘
    │   │
    │   ├─ claim faucet ──▶ +$1,000 testnet
    │   ├─ drain testnet ──▶ $1,000 → Your Wallet (testnet)
    │   └─ forward mainnet ──▶ Wallet #3
    │                             │
    │           ... continues for all N wallets ...
    │                             │
    │   ┌─────────────────────────┘
    │   │
    │   ├─ claim faucet ──▶ +$1,000 testnet
    │   ├─ drain testnet ──▶ $1,000 → Your Wallet (testnet)
    │   └─ forward mainnet ──▶ Your Wallet (returned!)
    │
    ▼
Result: You spent ~$0.02×N in fees, got N×$1,000 testnet USDC

Manual Mode — Step by Step

Manual mode gives you full control. You create wallets one by one and trigger each action yourself.

Click "Add Wallet"

This generates a random Ethereum wallet (private key + address) stored in your browser's localStorage. You can add as many as you like.

Activate — Click "Receive $2"

This sends $2 mainnet USDC from your connected wallet to the generated wallet. This activates the wallet on Hyperliquid mainnet so it can send transactions.

Claim Faucet — Click "Claim"

Calls the Hyperliquid testnet faucet API for that wallet. The wallet receives ~$1,000 testnet USDC. This is the core mining action.

Drain Testnet — Click "Send"

Sends all testnet USDC (minus a $0.01 gas buffer) from the generated wallet back to your connected wallet.

Drain Mainnet — Click "Send"

Sends all mainnet USDC (minus $0.01 gas buffer) from the generated wallet back to your connected wallet. This recovers most of the $2 you sent.

Repeat

Create more wallets and repeat steps 2–5 for each one. Each wallet mines ~$1,000 testnet USDC.

Manual Mode Math (per wallet)

You send (activation)$2.00

You recover (drain mainnet)~$1.99

Net mainnet cost~$0.01

Testnet USDC mined~$1,000

Effective ratio~$0.01 → $1,000 testnet

Tips & Notes

Auto mode is the default and recommended for most users. It's faster and handles all the wallet-to-wallet forwarding for you.
Manual mode is available for testing, exploring, or when you want full control over individual wallet actions.
Wallets are stored in localStorage. They persist across page refreshes but will be lost if you clear browser data.
You can abort an auto chain mid-run by clicking the Abort button. Any mainnet USDC still in the chain wallets will need to be recovered manually.
The $0.01 gas buffer per transaction ensures that the send operation has enough room to complete. This is why the net cost per wallet is ~$0.02 (two sends: drain + forward).
Faucet limits: The Hyperliquid testnet faucet may rate-limit claims. If a claim fails, the auto chain will report an error for that wallet.