Hyperliquid on Edith¶
Edith is the backend for onboarding new users to HyperEVM — and for everything they do once they're on. This page maps Edith's Hyperliquid surface. The focus is HyperEVM (the EVM inside Hyperliquid): Photon relays to it, Vector swaps on it, and Meadow earns on it — all gaslessly, behind one API key. Hyperliquid's non-EVM Core layer (order-book trading and Core-native yield) is available too, covered under Advanced below.
Edith also runs on any EVM chain and Solana; this page is the map for the Hyperliquid surface specifically. New here? Skim the networks and the capability map, then jump into the feature pages.
Build on HyperEVM¶
HyperEVM (chain 998 testnet / 999 mainnet) is a standard EVM, so Photon relays to it like any other chain — gas paid in HYPE, billed to your prepaid USD balance.
- Relay ordinary transactions — see Supported networks for the HyperEVM caveats (small-block gas cap, no EIP-7702).
- Gasless smart accounts — give a user an ERC-4337 account whose sponsored operations run gas-free. See Gasless smart accounts.
- Swap and earn — Vector routes swaps and Meadow routes deposits into yield, both on HyperEVM the same way they work on any EVM chain.
Try it: relay a transaction on HyperEVM¶
A HyperEVM relay is a normal EVM transaction — Edith signs it, pays the gas in HYPE, manages nonces and retries, and bills your prepaid balance:
curl -X POST https://photon.example.com/api/submit-tx \
-H "api-key: $EDITH_API_KEY" -H "Content-Type: application/json" \
-d '{
"chainId": 998,
"to": "0x…",
"callData": "0x…",
"label": "first-tx"
}'
From there, gasless smart accounts let a single sponsored signature batch several calls.
Advanced: Hyperliquid Core¶
Hyperliquid also has a non-EVM Core layer (chain 10200000 mainnet / 10200001 testnet) — the gasless order-book L1 where trading and Core-native yield live. Actions are EIP-712-signed JSON, there is no gas, and acceptance is synchronous; Edith forwards them with the same retries, webhooks, and WebSocket as everything else. Reach for it when your users want to trade or earn on Core.
- Relay signed Core actions (orders, transfers, vault deposits, staking) — HyperCore actions.
- Agent wallets — approve Edith's agent once, then place Core orders with no per-order signature — HyperCore agent wallets.
- Orders + builder codes — HyperCore orders.
- Core-spot swaps — quote against the Core order book and execute gaslessly — HyperCore spot swap.
- Core-native yield — HLP-style vault deposits and HYPE staking, gasless — Supported venues.
- Compose EVM + Core in one signature — a gasless ERC-4337 smart account on
HyperEVM can act on Core via
CoreWriter(0x3333333333333333333333333333333333333333), so one signed operation runs an EVM call and a Core action atomically (e.g. approve a token and supply into a Core vault). Packaged as the Meadow CoreWriter venue.
A Core action is a complete signed exchange request {action, nonce, signature},
base64-encoded in callData, submitted to the Core chain id — no gas, no to:
REQUEST='{"action":{"type":"spotSend","hyperliquidChain":"Testnet","signatureChainId":"0x66eee","destination":"0x…","token":"USDC","amount":"5","time":1753900000000},"nonce":1753900000000,"signature":{"r":"0x…","s":"0x…","v":27}}'
curl -X POST https://photon.example.com/api/submit-tx \
-H "api-key: $EDITH_API_KEY" -H "Content-Type: application/json" \
-d '{
"chainId": 10200001,
"to": "",
"callData": "'"$(printf '%s' "$REQUEST" | base64)"'",
"label": "core-spot-send"
}'
Reference¶
- Hyperliquid networks — the chains, defaults, and caveats.
- Capability map — every Hyperliquid capability, by service.