Three places
The work is split between three places, and no key crosses between them. Your wallet holds the account's key: Locker Vault, the safest, on an offline phone that signs by QR, or the browser extension or mobile wallet you chose. Your computer runs lpa and its guardian, which holds an agent key. Hyperliquid holds your account and its positions.
Reads of markets, quotes, positions and balances are public and need no signature. Everything else is signed in one of the first two places, never on a server of ours: there is none.
Two keys
The account key lives in your wallet, never with the agent: in Locker Vault, on an offline phone or tablet, or in your extension or mobile wallet. It can do everything: withdraw, send, approve an agent, sign a mandate.
The agent key is made on your computer by lpa init, sealed on disk under a password you choose, and approved once by your wallet. Hyperliquid lets it place, change and cancel orders and set leverage, and refuses it every withdrawal and every send. It expires on its own, after 180 days at most.
What an agent key can and cannot sign was tested on Hyperliquid mainnet on 28 September 2026, action by action. The full measure is on the agent wallet page.
Three ways to sign
lpa setup asks once how your account signs, and keeps the answer with the account. lpa signer use changes it later for the same address: the agent key and the mandate stay.
- Locker Vault, the safest, recommended. On a phone or tablet kept offline, with a webcam on the computer. The account's key never touches a device that is online, requests and answers travel as QR codes, and the vault shows each request in its own words.
- Your browser extension. MetaMask or Rabby signs on a page this computer serves at
127.0.0.1, in your browser. Nothing more leaves the computer. - Your mobile wallet. You scan a WalletConnect QR once, then approve each request on your phone. The requests go through WalletConnect's relay, encrypted end to end: it sees the computer's IP address and the time, not the content. The link lasts seven days, and
lpa signer forgetcloses it.
An extension or a mobile wallet is online, and shows a typed signature as raw fields. So the account is proven first, before any money, by a signature that moves nothing; an address that is a contract is refused; and the page of this computer says, field by field, what your wallet will show. Whatever signs, every signature is checked to come from the account before anything is sent.
The guardian
lpa unlock starts the guardian, a background process that holds the agent key in memory. Whoever asks for an order, you, a script or an AI assistant, never sees the key or the password.
The guardian checks every order a second time against your local policy and, once you signed one, against the mandate. It signs a closed list of trading actions only, and answers only the requests that carry the token it wrote when it started. lpa lock takes the key out of memory: from then on, nothing can be signed.
The mandate
The mandate is the agent's limits, signed once with your wallet: the markets, the largest order, the highest leverage, the orders and the notional per day, the service fee and its recipient, the uses allowed (trading, copies, the pilot), and its end, the agent key's own at the latest: 180 days.
Locker Vault decodes the request itself and shows every bound on its own row before you sign; with an extension or a mobile wallet, the page of this computer explains each raw field first. The guardian reads the mandate again before each opening, never lets it widen your local policy, and remembers the highest mandate signed and any revocation, so an older file put back opens nothing.
One order, end to end
- The quote. The order is priced on Hyperliquid's live book: entry, notional, margin, fees and a liquidation estimate.
- The local policy. The largest order, the leverage, the markets you allow. A refusal names the limit, with its figures.
- Your go. In a terminal you confirm. A script or an assistant needs your agreement, and through MCP a quote you saw, good for ten minutes and once.
- The guardian. The policy again, then the mandate, then the signature with the agent key.
- The journal. The order, its quote and the limits that judged it are written on your computer.
The daily pilot
The pilot decides once a day, at 00:30 UTC by default. The code first gathers and freezes a dossier: candles, funding, open interest, the week's economic calendar, the fear and greed index, and the headlines of the Fed, the ECB and CoinDesk.
A first voice reads the texts alone and gives the day's climate. The trader then reads the charter, the dossier, the climate and its own lessons, and proposes a trade or nothing: a side (longs only under the default charter), a market and a first entry. It never decides the size.
The code then judges the proposal: the market is allowed, the figures are figures, the entry sits in its zone, no high-impact release is within twelve hours, there is room for a position, the costs are counted. One no, and nothing opens. A yes places the first step of a ladder the code sizes itself.
If everything were stolen
A program that steals the sealed key file and your password can talk to Hyperliquid without lpa. It still cannot withdraw, and the key still expires. It can trade the account badly, or deposit it into someone else's Hyperliquid vault.
That is why the real bound is an account that holds only what you are ready to lose. Revoke the key with your wallet through lpa agent revoke, and stop every opening at once with lpa mandate revoke.