Lux Exchange

                          lux.exchange (frontend)
                                 |
                    +------------+------------+
                    |                         |
              exchange-api (:4000)    exchange-proxy (:8088)
              GraphQL proxy           CORS reverse proxy
                    |                         |
          +---------+---------+       +-------+-------+
          |         |         |       |       |       |
      Subgraph   Subgraph  Blockscout   Uniswap APIs (4 upstreams)
        V2         V3       Explorer    api / liquidity / gateway / conversion
          |         |         |
     Lux C-Chain (96369)
     V2 Factory   V3 Factory   DEX Precompiles (LP-9xxx)
          |
     exchange-sdk (CLOB engine)
     In-memory order book matching

~/work/lux/exchange/
+-- apps/
|   +-- web/              Next.js App Router (swap/, pool/, tokens/ pages)
|   +-- mobile/           React Native 0.79.5
|   +-- extension/        Browser extension
|   +-- market/           Market data app
|   +-- build/            Build tooling
|   +-- cli/              CLI tools
|   +-- api-self-serve/   Self-serve API
+-- packages/
|   +-- exchange/         Core DEX logic: tokens, hooks, stores, ABIs, bridge
|   +-- config/           Chain definitions, contract addresses, wagmi config
|   +-- ui/               Tamagui components (Button, Card, TokenLogo)
|   +-- api/              React Query client + data hooks
|   +-- lx/               Business logic (swap utils, G-Chain integration, i18n)
|   +-- wallet/           Wallet connection logic
|   +-- luxamm-sdk-core/  @luxamm/sdk-core (pre-built Uniswap SDK fork)
|   +-- luxamm-v2-sdk/    @luxamm/v2-sdk (pre-built)
|   +-- luxamm-v3-sdk/    @luxamm/v3-sdk (pre-built)
|   +-- luxamm-v4-sdk/    @luxamm/v4-sdk (pre-built)
|   +-- luxdex-sdk/       @luxdex/sdk (pre-built router SDK)
|   +-- luxdex-analytics/ Analytics package
|   +-- prices/           Price service
|   +-- sessions/         Session management
|   +-- notifications/    Push notifications
|   +-- gating/           Feature gating
|   +-- mycelium/         PubSub/messaging
|   +-- websocket/        WebSocket service
|   +-- utilities/        Shared utilities
|   +-- biome-config/     Code formatting config
|   +-- eslint-config/    Lint config
+-- contracts/
|   +-- LuxToken.sol      Mintable ERC20 for bridged assets (LETH, LBTC, LUSD)
|   +-- WLUX.sol          Wrapped LUX (WETH-style deposit/withdraw)
+-- config/               Build configuration

@luxfi/web (apps/web)
  +-- @luxfi/exchange (packages/exchange)
  |     +-- @luxfi/config
  |     +-- viem, wagmi
  +-- @luxfi/ui (packages/ui)
  |     +-- @luxfi/config
  +-- @luxfi/api (packages/api)
  +-- lx (packages/lx)
        +-- @apollo/client
        +-- @luxamm/sdk-core, v2-sdk, v3-sdk, v4-sdk
        +-- @luxdex/sdk

{
  "dexConfig": {
    "upgrade": { "blockTimestamp": 0 },
    "enableFlashLoans": true,
    "enableHooks": true,
    "maxPools": 10000
  }
}

POST /v1/quote          -- Get swap quote
POST /v1/quotes         -- Batch quotes
POST /v1/swap           -- Build swap transaction
GET  /v1/pools          -- List pools
GET  /v1/tokens         -- List tokens
GET  /v1/price          -- Token price

{
  "tokenIn": "0x0000000000000000000000000000000000000000",
  "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "amount": "1000000000000000000",
  "isExactIn": true,
  "chainId": 96369
}

interface PoolKey {
  currency0: Address   // Lower address token
  currency1: Address   // Higher address token
  fee: number          // Fee in hundredths of a bip
  tickSpacing: number  // Tick spacing for the fee tier
  hooks: Address       // Hook contract (0x0 = no hooks)
}

// Get swap quote from V3 QuoterV2
const { data: quote } = useSwapQuote({
  tokenIn: NATIVE_LUX,
  tokenOut: LETH,
  amountIn: parseUnits('1', 18),
  chainId: 96369,
})

// Execute swap via V3 SwapRouter02
const { swap, isPending } = useSwap()
await swap({
  tokenIn: NATIVE_LUX,
  tokenOut: LETH,
  amountIn: parseUnits('1', 18),
  amountOutMinimum: quote.amountOut * 995n / 1000n, // 0.5% slippage
  recipient: address,
  deadline: BigInt(Math.floor(Date.now() / 1000) + 1800),
  chainId: 96369,
})

// Zustand swap store (persisted slippage/deadline settings)
const { tokenIn, setTokenIn, slippageTolerance, switchTokens } = useSwapStore()

// Get all V3 pools for a pair (queries all 4 fee tiers)
const { pools, bestPool } = usePools(token0, token1, 96369)

// Get user positions
const { data: positions } = usePositions(userAddress, 96369)

const { mint } = useCrossChainMint()
await mint({
  sourceAsset: xvmAssetId,
  amount: 1000000n,
  recipient: cChainAddress,
  targetToken: tokenAddress,   // Optional swap on arrival
  minReceive: 990000n,
  deadline: Math.floor(Date.now() / 1000) + 3600,
})

const { teleport, executeSwap, exportToDestination } = usePrivateTeleport()

const teleportId = await teleport({
  sourceChain: LUX_CHAINS.xChain.chainId,
  destChain: LUX_CHAINS.cChain.chainId,
  sourceAsset: assetId,
  amount: 1000000n,         // Will be encrypted
  recipient: address,
  deadline: Math.floor(Date.now() / 1000) + 3600,
  privateSwap: true,
})
await executeSwap(teleportId, poolId, minOutput)
await exportToDestination(teleportId)

const book = new Book('LUX/USDC')
book.addOrder(new Order('ext-1', OrderSide.BID, OrderType.LIMIT, 100, '42.50'))
book.addOrder(new Order('ext-2', OrderSide.ASK, OrderType.LIMIT, 50, '42.50'))
const trades = book.settle()
// trades[0].fillPrice = 42.50, fillQuantity = 50

// Continuous execution loop (uses requestAnimationFrame)
const ctx = book.start((book, trades) => {
  console.log(`Trades: ${trades.length}, Spread: ${book.displaySpread}`)
})
ctx.stop()  // Stop execution

POST /:name/orders     -- Submit order { externalId, side, type, quantity, price }
PUT  /:name/orders     -- Same as POST
GET  /:name/orders     -- Get order book { bids: [[price, qty]], asks: [[price, qty]] }
GET  /:name/candles/:interval  -- Get candles (1m, 1h, 1d)

book.subscribe { name }     -- Subscribe to order book updates
book.data                   -- Order book broadcast (every 500ms)
trade.subscribe { name }    -- Subscribe to trade feed
trade.data                  -- Trade executions
order.create                -- Submit order via WebSocket
candles.get                 -- Request historical candles

# Required: Bun 1.3.1+, Node 22.13.1
bun --version   # Must be  >= 1.3.1
node --version  # Must be 22.13.1

cd ~/work/lux/exchange
bun install
bun run g:prepare          # Generate code
bun run web dev             # Start web dev server

# Build for production (Vite SPA)
cd apps/web && ../../node_modules/.bin/vite build

# Run tests
bun run g:test
bun run g:typecheck

# Docker build
docker build -f Dockerfile.k8s -t lux-exchange .

cd ~/work/lux/exchange-api
npm install
npm run dev               # tsx watch mode on :4000
npm run build && npm start  # Production

# Environment
BLOCKSCOUT_API=https://api-explore.lux.network
SUBGRAPH_URL=https://subgraph.lux.network/subgraphs/name/luxfi/uniswap-v2
SUBGRAPH_V3_URL=https://subgraph.lux.network/subgraphs/name/luxfi/uniswap-v3
UNISWAP_API=https://interface.gateway.uniswap.org/v1/graphql
PORT=4000

cd ~/work/lux/exchange-sdk
npm install
npm test             # Jest unit tests
npm run build        # Rollup build (CJS + ESM + UMD + types)
npm run serve        # Start CLOB server on :4000
npm run watch        # Dev mode with auto-rebuild

cd ~/work/lux/exchange-proxy
go build -o exchange-proxy .
./exchange-proxy -addr :8088
./exchange-proxy -addr :8088 -redis redis://localhost:6379  # With distributed cache

lux dev start              # Single-node, port 8545, chain ID 1337
# Pre-funded account: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266

# Build: bun install + vite build
# Run: serve -s public -l 3000

NEXT_PUBLIC_LXD_GATEWAY_URL=https://dex.lux.network
REACT_APP_AWS_API_ENDPOINT=https://api-exchange.lux.network/v1/graphql

lux.exchange       -> exchange frontend (:3000)
api-exchange.lux.network -> exchange-api (:4000)