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.

​
Prerequisites

Before starting setup:
  • You must have completed at least one deposit to Lighter
  • Your Lighter account must exist (it’s created by the first deposit)

​
Overview

Lighter uses Schnorr signatures for its trading key scheme. The setup derives a Schnorr key pair from your wallet signature — this key pair is then registered on Lighter and used to sign all subsequent trade orders. The process involves 7 steps but only requires 3–4 wallet signatures. Tangerine walks you through each step automatically.

​
The 7-Step Flow

​
Step 1 — Verify Account Exists

Tangerine queries the Lighter API to confirm your account was created by the deposit. If the account doesn’t exist, setup will pause and ask you to deposit first.

​
Step 2 — Sign Access Message

You sign a structured message with your main wallet. This signature is the entropy source for deriving your Schnorr key — it proves you own the wallet without sending any transaction.

​
Step 3 — Derive Schnorr API Key

Tangerine uses your wallet signature to deterministically generate a Schnorr key pair (private + public key) in the browser. This key is unique to your wallet and never changes unless you explicitly reset it.

​
Step 4 — Register API Key on Lighter

Tangerine submits your Schnorr public key to Lighter via a signed registration transaction. You sign this transaction with your main wallet (one more signature).

​
Step 5 — Verify Registration

Tangerine queries Lighter to confirm the public key is registered and active on your account.

​
Step 6 — Encrypt and Store Keys

Your Schnorr private key is encrypted using your wallet signature as the encryption password and stored in IndexedDB. This uses the same 3-layer storage as Hyperliquid’s agent key.

​
Step 7 — Ready

Setup is complete. The Lighter platform shows as Ready in Tangerine’s platform list.

​
Re-running Setup

If you need to reset Lighter setup (new device, cleared browser storage, key rotation):
  1. Go to Settings → Lighter → Reset Setup
  2. The same 7-step flow runs again with a fresh key pair
  3. Tangerine registers the new public key on Lighter
Generating a new key pair means the old Schnorr key is no longer used. Any open orders signed by the old key may need to be re-submitted. Cancel all open orders on Lighter before resetting.