Getting started

Quickstart

Trade in a minute, or run everything locally.

Use the app#

  1. 1

    Open Trade

    The chart and order book are Hyperliquid's live ETH perp. The panel on the right shows what the Aven pool would charge you, and why.
  2. 2

    Connect wallet

    Connect your wallet (via Privy). The app asks you to switch to HyperEVM if needed.
  3. 3

    Go long or short

    Long buys aETH, short sells it, on the Aven pool. Demo tokens are open-mint, so the app mints what you need first.
  4. 4

    Check the fee

    Every trade links to its proof: the inputs the hook logged and the fee recomputed in your browser.

Run it locally#

bash
pnpm install
pnpm --filter @aven/scripts local:up     # anvil + mock precompiles, deploys everything
pnpm --filter @aven/arena start          # the Arena service (bot + API)
pnpm --filter @aven/web dev              # this app, http://localhost:3000
The frontend reads NEXT_PUBLIC_CHAIN_ID, NEXT_PUBLIC_RPC and NEXT_PUBLIC_ARENA_API from frontend/.env. Without an Arena it shows the last recorded run, labelled as such.
Aven · MIT · ETHGlobal MumbaiEdit on GitHub ↗