mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2025-12-06 13:54:41 +08:00
67d69b132d
- Add supported exchanges table to EN, ZH-CN, JA, KO READMEs - CEX: Binance (supported), OKX (coming soon), Bybit (coming soon) - Perp-DEX: Hyperliquid (supported), Aster DEX (supported) - Include referral links with fee discounts for all exchanges - Remove What's New sections from all READMEs - Create Binance API setup guide - Create Hyperliquid agent wallet setup guide - Create Aster DEX API wallet setup guide
2.8 KiB
2.8 KiB
Hyperliquid Agent Wallet Setup Guide
This guide explains how to create and configure an Agent Wallet for secure trading on Hyperliquid.
Why Use Agent Wallet?
- ✅ More Secure: Never expose your main wallet private key
- ✅ Limited Access: Agent only has trading permissions
- ✅ Revocable: Can be disabled anytime from Hyperliquid interface
- ✅ Separate Funds: Keep main holdings safe
Prerequisites
- A wallet with funds on Hyperliquid
- Access to Hyperliquid
Step 1: Connect Your Main Wallet
- Visit Hyperliquid
- Click Connect Wallet (top right)
- Choose MetaMask, WalletConnect, or other Web3 wallet
- Approve the connection
Step 2: Create Agent Wallet
- Click on your wallet address (top right)
- Go to Settings → API & Agents
- Or visit directly: https://app.hyperliquid.xyz/agents
- Click Create Agent or Add Agent
- System generates a new agent wallet automatically
Step 3: Save Agent Credentials
After creation, save these immediately:
- Agent Wallet Address:
0x...(starts with 0x) - Agent Private Key: Shown only once!
⚠️ Important: The private key is only displayed once. Save it securely!
Step 4: Configure in NOFX
Add your agent wallet through the NOFX web interface:
- Open NOFX dashboard (http://localhost:3000)
- Go to Exchange Configuration
- Enable Hyperliquid
- Enter:
- Wallet Address: Your main wallet address (with
0x) - Private Key: Agent private key (remove
0xprefix)
- Wallet Address: Your main wallet address (with
- Save configuration
Agent Wallet Details
| Field | Description | Example |
|---|---|---|
| Main Wallet | Your connected wallet (holds funds) | 0xABC123... |
| Agent Wallet | Sub-wallet for trading | 0xDEF456... |
| Private Key | Only needed for NOFX | abc123... (no 0x) |
Managing Your Agent
Revoke Agent Access
- Go to Hyperliquid Agents
- Find your agent in the list
- Click Revoke or Delete
Create Multiple Agents
You can create multiple agents for different purposes:
- One for NOFX
- One for other trading bots
- One for manual API access
Security Best Practices
- Use agent wallet instead of main wallet private key
- Store agent private key securely
- Revoke unused agents
- Monitor agent activity regularly
- Keep main wallet funds separate from trading funds
Troubleshooting
| Issue | Solution |
|---|---|
| Agent not working | Check if agent is still active in Hyperliquid settings |
| Invalid signature | Ensure private key doesn't have 0x prefix |
| Insufficient funds | Transfer funds to your Hyperliquid account |
| Connection error | Check network (mainnet vs testnet) setting |