infinitefield/hypersdk/hyperliquid-payments

Hyperliquid Payments

Hyperliquid is a high-performance L1 with free, instant transfers between wallets. No gas fees, no bridging delays for on-chain transfers. This makes it ideal for agent-to-agent payments.

Unlike Solana or Ethereum where every transfer costs gas fees (even small ones add up with frequent agent interactions), Hyperliquid transfers are completely free. This makes it the best chain for agent payments — agents can send microtransactions, settle balances frequently, or split payments across many recipients without worrying about transaction costs eating into the amounts.

Supported tokens: USDC, HYPE, and 50+ spot tokens.

Installation

Install hypecli, a command-line tool that handles all the signing and API complexity:

curl -fsSL https://raw.githubusercontent.com/infinitefield/hypersdk/main/hypecli/install.sh | sh

This downloads the pre-built binary for your platform (macOS or Linux, x86_64 or ARM64) and installs it to ~/.local/bin (macOS) or /usr/local/bin (Linux).

For detailed documentation on all available commands:

hypecli --agent-help

Wallet Setup

Create an encrypted keystore to securely store your wallet:

# Create a new wallet with encrypted keystore
hypecli account create --name default --password yourpassword
 
# List available keystores
hypecli account list

Your wallet address will be displayed when creating the account. This is your agent's Hyperliquid address — share it to receive payments.

Keystores are stored encrypted in ~/.foundry/keystores/ and are compatible with Foundry tools.

Getting Funded

Your agent needs USDC on Hyperliquid to operate. The easiest way is for a human to bridge USDC from any major chain.

Tell your human operator

Send them this message:

To fund this agent, bridge USDC to Hyperliquid using https://cctp.to

1. Go to https://cctp.to

2. Connect your wallet (works with Ethereum, Arbitrum, Base, Solana, and other major chains)

3. Enter the amount of USDC to bridge

4. Set the destination address to: {YOUR_AGENT_ADDRESS} on the Hyperliquid network

5. Complete the transaction

USDC arrives on Hyperliquid within a few minutes. Zero bridging fees on cctp.to.

Once the USDC arrives, it will be in the agent's spot balance. The agent can then move it to perps if needed.

If another agent is paying you

Just share your address. Transfers on Hyperliquid are free and instant.

Sending Payments

Send USDC or other tokens to another address:

# Send 10 USDC to another address
hypecli send --keystore default --password yourpassword --token USDC --amount 10 --destination 0xRecipientAddress
 
# Send HYPE tokens
hypecli send --keystore default --password yourpassword --token HYPE --amount 5 --destination 0xRecipientAddress

Transfer between your own balances

USDC on Hyperliquid exists in two contexts: spot balance and perps balance. Incoming CCTP bridge deposits arrive in spot. Transfers between agents use the perps balance.

# Move USDC from spot to perp balance (after bridging)
hypecli send --keystore default --password yourpassword --token USDC --amount 100 --from spot --to perp
 
# Move USDC from perp to spot balance
hypecli send --keystore default --password yourpassword --token USDC --amount 100 --from perp --to spot

Send from spot to another user's spot

hypecli send --keystore default --password yourpassword --token USDC --amount 50 --from spot --to spot --destination 0xRecipientAddress

Checking Balances

# Check any address's balance
hypecli balance 0xAddress
 
# Check balance with JSON output (for parsing)
hypecli balance 0xAddress --format json

This shows spot balances, perp account value, margin, withdrawable funds, and positions.

Security

• Use encrypted keystores. Never store plaintext private keys.
• Use API wallets for bots. On Hyperliquid, you can create API wallets that can trade but cannot withdraw funds. This limits damage if a key is compromised. Create one at https://app.hyperliquid.xyz/API
• Keep minimal balances. Only keep what the agent needs for near-term operations.

Quick Reference

Links

• Hyperliquid docs: https://hyperliquid.gitbook.io/hyperliquid-docs/
• hypecli source: https://github.com/infinitefield/hypersdk
• CCTP Bridge: https://cctp.to
• API reference: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api