AXIS
from zip to your own perps terminal.
Everything you need to build, configure, brand and publish your own non-custodial perpetuals terminal on Hyperliquid. Read it top to bottom the first time. After that, press / and search.
01What you bought
AXIS is a non-custodial perpetuals terminal on Hyperliquid, written in Flutter. The wallet is created on the user's device, every order is signed locally, and the signed action goes straight to Hyperliquid. No server routes, batches or submits an order.
The operator — you — earns the Hyperliquid builder fee: your builder code rides on every order placed from your build, and Hyperliquid pays the fee to your address.
A fresh build is empty and inactive: no builder address, builder fee off, and perps trading off until you switch it on. There is no default vendor account anywhere in the source (DOCS/EARNING.md).
| Part | Where | What it is |
|---|---|---|
| Terminal app | lib/ | One Flutter app for web, iOS and Android: Markets, Trade, Earnings and Account. |
| Hyperliquid client | lib/core/hyperliquid/, lib/state/hyperliquid_provider.dart | Info and exchange APIs, WebSocket streams, local signing, order math. |
| Operator console | Account → Operator console, in a build you give an operator passcode | Network, surfaces, builder fee, branding, support, availability. No separate admin app, and no console at all in a build published without the passcode. |
| Earnings screen | The Earnings tab | Routing, on-chain approval, rate, builder balance, prerequisites. |
02Status of this version
AXIS 1.0.0 is a working Hyperliquid perps terminal: the Hyperliquid client and signing, the Markets, Trade and ticket screens, the builder-fee configuration, the Earnings screen, the operator console and the AXIS design. The build is healthy: flutter analyze reports no issues, all 962 tests pass and the web release build succeeds (checked for these docs).
AXIS grew out of a multi-chain wallet engine, and you should know which parts are still that engine:
- Settings, onboarding, security centre, notifications, WalletConnect and QR screens keep the layout of the wallet engine, in the AXIS theme. Markets, Trade and Earnings were recomposed as a terminal.
- The source still contains the engine's code for Bitcoin, Solana, Sui and Tron (about 4,500 lines in
lib/core/, plus models and use cases), and the wallet state class still has branches for them. The terminal trades on Hyperliquid with an EVM key and does not use that code on the trading path. - The app icon is a simple geometric mark. Replace it with your own (how).
03Pick your path
04Try it before you install
The live demo: axis-demo.mikodes.com. The screenshots in these docs come from the demo build (AXIS_DEMO=true), which uses fixture data and a sample address with no key — the balances, positions and builder address in them are samples, not real accounts. The onboarding screens, which the demo skips, come from a regular web build.
Perpetual futures use leverage and can lose the whole margin. AXIS shows a risk disclosure before the first order and marks the liquidation price as an estimate. Whether you may offer perps to your users depends on your jurisdiction and theirs.
05How to read these docs
- Dark boxes are commands. Press Copy in the corner and paste them into a terminal.
- Grey text after
#is an explanation. The Copy button leaves it out. - Text in angle brackets, like
<your-project>, is a placeholder. Replace it, brackets included. - Paths start at the unzipped project folder.
- Required marks steps you cannot skip.