agent-onboarding

Agent Onboarding

Complete first-time setup for the YEX autonomous trading system on Hyperliquid. Follow every step in order. Do not skip steps. Verify each step before proceeding to the next.

Agent Mandate

You are onboarding onto the YEX trading system. Your goal is to reach a state where you can autonomously trade on Hyperliquid (testnet or mainnet). Every step has a verification command — if verification fails, fix the issue before continuing.

RULES:

• Follow steps sequentially — each depends on the previous
• NEVER skip builder fee approval — all orders will fail without it
• ALWAYS validate with a mock trade before going live
• NEVER start on mainnet without completing testnet validation first
• Save all credentials (passwords, addresses) — they cannot be recovered

---

Step 1: Environment Bootstrap

Install Python dependencies and verify the CLI works.

Option A — Shell script (recommended):

cd ~/agent-cli
bash scripts/bootstrap.sh

Option B — Manual:

cd ~/agent-cli
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Verify:

hl setup check

Expected: All items show OK, no !! issues (except missing key — that's Step 2).

If fails:

Error	Fix
python3 not found	Install Python 3.10+ via brew install python or system package manager
pip install failed	Ensure you're in a venv: source .venv/bin/activate
ModuleNotFoundError: hyperliquid	Run pip install hyperliquid-python-sdk

---

Step 2: Wallet Setup

Create or import a Hyperliquid wallet.

Decision tree:

• Do you have a private key?
  • YES → Import it:

    hl wallet import --key 0x<your_key>
    

  • NO → Create a new one (non-interactive, with auto-saved credentials):

    hl wallet auto --save-env --json
    

    This creates the wallet, saves HL_KEYSTORE_PASSWORD to ~/.hl-agent/env (auto-detected by CLI), and outputs JSON: {"address": "...", "password": "...", "keystore": "...", "env_file": "..."}.