Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tangerine.exchange/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

After depositing, Tangerine needs a one-time setup to place trades on your behalf. This involves three steps:
  1. Approve an agent wallet on Hyperliquid
  2. Optionally approve the builder fee
  3. Encrypt your keys in the browser
The whole process takes 2–3 wallet signatures and under 2 minutes.

​
Step 1 — Approve Agent Wallet

Tangerine generates a fresh agent wallet (an Ed25519 key pair) locally in your browser. This key is what signs every trade order — it never touches Tangerine’s servers. You’ll be prompted to sign a transaction with your main wallet that registers this agent key on Hyperliquid. The agent name will appear as “Tangerine” in your Hyperliquid account. What the agent wallet can do:
  • Place, modify, and cancel orders
  • Adjust leverage and margin
What the agent wallet cannot do:
  • Withdraw funds
  • Transfer assets to other addresses
If you ever need to revoke the agent wallet, you can do so directly from Hyperliquid’s interface. The agent key itself will be invalidated immediately.

​
Step 2 — Approve Builder Fee (Optional)

Tangerine is registered as a builder on Hyperliquid. You can optionally approve a builder fee of up to 0.1% during setup. This fee enables Tangerine to route your orders and earn a small commission. It’s optional — you can skip this step and still trade normally. Approving the builder fee helps support Tangerine’s development.

​
Step 3 — Encrypt Your Keys

After the agent wallet is approved, Tangerine asks you to sign one more message with your main wallet. This signature is used to derive an encryption password that encrypts your agent key in the browser. The encrypted key is stored in your browser’s IndexedDB (permanent storage). Tangerine never sees the raw key or the encryption password. On every subsequent session, you sign the same message to re-derive the password and decrypt your keys. This is automatic and only takes a moment. See Key Management for technical details on the 3-layer storage architecture.

​
Re-running Setup

If you clear your browser storage, switch devices, or need to rotate your agent key:
  1. Go to Settings → Hyperliquid
  2. Click Reset Setup
  3. Run through the setup flow again — Tangerine will generate a new agent key and register it on Hyperliquid
The old agent key will still exist on Hyperliquid until you manually revoke it from Hyperliquid’s interface.