API Server

Overview

The API server is built with Hono, running on Bun runtime. It handles wallet data, transaction parsing, and serves the web application.

Tech Stack

Directory Structure

apps/api/
├── src/
│   ├── index.ts         # Entry point
│   ├── routes/          # API route handlers
│   │   ├── health.ts    # Health check
│   │   ├── wallets.ts   # Wallet endpoints
│   │   └── swaps.ts     # Swap endpoints
│   ├── middleware/      # Hono middleware
│   │   ├── auth.ts      # JWT verification
│   │   └── logging.ts   # Request logging
│   ├── services/        # Business logic
│   └── jobs/            # Background job handlers
└── tsconfig.json

Development

# Start API server
pnpm --filter @posit/api dev

# Run with watch mode
pnpm --filter @posit/api dev:watch

# Type check
pnpm --filter @posit/api typecheck

API Routes

Authentication

The API uses JWT tokens from Privy for authentication. The auth middleware verifies tokens and attaches user context:

import { authMiddleware } from './middleware/auth';

app.use('/api/*', authMiddleware);

app.get('/api/me', (c) => {
  const user = c.get('user');
  return c.json({ wallet: user.walletAddress });
});

Background Jobs

Long-running tasks use Graphile Worker:

• backfill: Fetch historical transactions for a wallet
• parse: Parse raw transactions into swaps
• price: Fetch USD prices for tokens